CDT command-line arguments in text mode

There are multiple command line parameters as options when running the Configuration Deployment Tool.

When you run the Configuration Deployment Tool, you can optionally use any of the command parameters shown in Table 1:

Table 1. Java™ cdtshell script command-line arguments
Arguments Description
Source The logical identifier for the source database.
Target The logical identifier for the target database.
ColonyId Specifies the Colony ID that you want to compare or deploy. You can pass only one colony at a time.


Windows: cdtshell.cmd -ColonyId E1

Linux/UNIX: -ColonyId E1

IgnoreMissingTables Specifies that when you compare source and target databases, you want to ignore tables that might be missing in the target schema. When comparing databases in a sharded deployment, ensure that you specify the IgnoreMissingTables argument.

For example, when comparing a Test Configuration schema with a Production Configuration schema, some Master tables, such as YFS_CUSTOMER and YFS_USER, do not exist in either the source or target schema. In this case, the CDT throws "table not found" errors. However, you can enable the CDT to ignore missing tables by passing -IgnoreMissingTables as Y.


Windows: cdtshell.cmd -IgnoreMissingTables Y

Linux/UNIX: -IgnoreMissingTables Y

LabelId Specifies the Label Id value that is used to create labels such as BEGIN_<LabelId> and END_<LabelId>, before and after the deployment, respectively. If this argument is not passed, labels are not created.


Windows: cdtshell.cmd -LabelId OrgA1

Linux/UNIX: -LabelId OrgA1

CompareOrganizationCode Specifies the organizations you want to compare based on the organization codes passed, as defined in the config-db.xml. If you do not pass the CompareOrganizationCode argument, the corresponding filter is not used.

Use a comma-delineated format to specify organizations to compare, such as Org-1, Org-2. If you use the CompareOrganizationCode argument and specify no organizations, the CDT compares all organizations. It is recommended that all participating organizations are compared together. For example, if two organizations, Org-01 and Org-02, participate with two ship nodes, Node-01 and Node-02, you should specify Org-1,Org-2,Node-01,Node-02.


Windows: cdtshell.cmd -CompareOrganizationCode Org-1,Org-2,Node-01,Node-02

Linux/UNIX: -CompareOrganizationCode Org-01,Org-02,Node-01,Node-02

SkipEmptyTableExport Indicates if you do not want to generate files for empty table in source database while exporting to XML. By default, the files are generated with empty records. The argument options are Y or N.


Windows: cdtshell.cmd -SkipEmptyTableExport Y

Linux/UNIX: -SkipEmptyTableExport Y

TTMode Indicates the type of table mode to load. TTMode supports two modes, ConfigOnly which exclusively runs config-db CDT config xml files and MasterOnlywhich exclusively runs master-db CDT config xml files. Running only one type of table at a time, ensures that the CDT runs efficiently and smoothly.


Windows: cdtshell.cmd -TTMode ConfigOnly

Linux/UNIX: -TTMode ConfigOnly

Windows: cdtshell.cmd -TTMode MasterOnly

Linux/UNIX: -TTMode MasterOnly