{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"CLI Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"The MettleCI Command Line Interface comprises a ","type":"text"},{"text":"Command Shell","type":"text","marks":[{"type":"strong"}]},{"text":" which provides a command line interface into a set of ","type":"text"},{"text":"MettleCI CLI Plugins","type":"text","marks":[{"type":"strong"}]},{"text":" (delivered as a set of ","type":"text"},{"text":".jar","type":"text","marks":[{"type":"code"}]},{"text":" files) which provide the various ","type":"text"},{"text":"MettleCI CLI capabilities","type":"text","marks":[{"type":"link","attrs":{"href":"https://datamigrators.atlassian.net/wiki/spaces/MCIDOC/pages/458850547"}}]},{"text":". Some of those plugins rely on using third party capabilities, such as DataStage client tools (like ","type":"text"},{"text":"istool","type":"text","marks":[{"type":"code"}]},{"text":"), for example. ","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"gliffy","parameters":{"macroParams":{"imageAttachmentId":{"value":"att2126446597"},"macroId":{"value":"99905eed-47bf-410c-a36f-16df29d68e9f"},"baseUrl":{"value":"https://datamigrators.atlassian.net/wiki"},"displayName":{"value":"MettleCI Command Shell"},"name":{"value":"MettleCI Command Shell"},"diagramAttachmentId":{"value":"att2125856773"},"containerId":{"value":"2125725711"},"timestamp":{"value":"1642721489783"}},"macroMetadata":{"macroId":{"value":"757b5a01-36ec-4c88-b659-491c0bb417fc"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://confluence-connect.gliffy.net/diagram/image/placeHolder.png?imageAttachmentId=att2126446597¯oId=99905eed-47bf-410c-a36f-16df29d68e9f&baseUrl=https%3A%2F%2Fdatamigrators.atlassian.net%2Fwiki&displayName=MettleCI+Command+Shell&name=MettleCI+Command+Shell&diagramAttachmentId=att2125856773&containerId=2125725711×tamp=1642721489783"}}],"title":"Gliffy Diagram"}},"localId":"c2cfdf4a-ac25-4106-ba99-079e49925e10"}},{"type":"paragraph","content":[{"text":"The MettleCI Command Shell (accessed with the command ","type":"text"},{"text":"mettleci","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"status","attrs":{"color":"yellow","style":"bold","text":"UNIX","localId":"59d39bb4-6ac3-4738-9e1c-69ca146c0ad7"}},{"text":" or ","type":"text"},{"text":"mettleci.cmd","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"status","attrs":{"color":"blue","style":"bold","text":"Windows","localId":"c95d7aec-2b96-4622-958a-7193bc2db018"}},{"text":") is used to execute the commands made available by the installed CLI plugins. Each command exists within a ","type":"text"},{"text":"Namespace","type":"text","marks":[{"type":"strong"}]},{"text":" which is required to fully qualify the required command. The ","type":"text"},{"text":"compliance","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"unittest","type":"text","marks":[{"type":"code"}]},{"text":" namespaces, for example, both feature a ","type":"text"},{"text":"test","type":"text","marks":[{"type":"code"}]},{"text":" command, each of which perform unrelated functions. The Command Shell is used like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# Windows\nC:\\> mettleci.cmd {namespace} {command} {parameters} \n\n# UNIX\n$> mettleci {namespace} {command} {parameters}\n\n# e.g.\n$> mettleci datastage deploy \\\n -domain services-tier.myorg.com:59445 -server engine-tier.myorg.com \\\n -project dstage1 \\\n -username isadmin -password isadminpwd \\\n -assets assets_dir\n -project-cache project_cache_dir\n -include-job-in-test-name","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Directory Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"The MettleCI CLI directory structure looks like this. Plugins are supplied as ","type":"text"},{"text":".jar","type":"text","marks":[{"type":"code"}]},{"text":" files which are installed in the ","type":"text"},{"text":"plugins","type":"text","marks":[{"type":"code"}]},{"text":" directory. ","type":"text"}]},{"type":"codeBlock","content":[{"text":".\n├── bin\n│ └── .jar\n├── config.properties\n├── docs\n│ ├── namespace1\n│ │ ├── \n│ │ ├── \n│ │ ├── \n│ │ └── \n│ ├── namespace2\n│ │ ├── \n│ │ └── \n│ ├── namespace3\n│ │ ├── \n│ │ ├── \n│ │ └── \n├── lib\n│ └── .jar\n├── log\n├── mettleci\n├── mettleci.cmd\n└── plugins\n ├── -plugin--.jar\n ├── -plugin--.jar\n ├── -plugin--.jar\n └── -plugin--.jar","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Available Commands","type":"text"}]},{"type":"paragraph","content":[{"text":"Details about the namespaces and commands currently available in MettleCI are available ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://datamigrators.atlassian.net/wiki/spaces/MCIDOC/pages/458850547"}}]},{"text":".","type":"text"}]}],"version":1}

Browser not supported