BDT Command Syntax
The CipherTrust Batch Data Transformation utility runs at the command line with the following syntax:
Command Options
Option | Description |
---|---|
-c,--configfile <configfilepath> | Location of the BDT configuration file. Replace <configfilepath> with the path to bdt.config . If omitted, the default file bdt/conf/bdt.config is used. |
-e,–-encryptPassword | Sets the CADP-JCE library password and CT-VL password, encrypt them, and store in bdt.config . Use this option the first time you run BDT. You can also use it whenever you want to change the passwords. BDT prompts you to enter the passwords at the console. |
-f,--populatePropertyFile | Populates the bdt.properties file. Use this option to configure the minimum required parameters of the default crypto library. It also allows you to configure log file path and log level. |
-h,--help | Displays the BDT command syntax and information about how to use it. |
-ld <type> | Lists destination objects. Object types [tables, columns] |
-ls <type> | Lists source objects. Object types [tables, columns] |
-p,--policyfile <policyfilepath> | Location of the BDT policy file. Replace <policyfilepath> with the path to bdt.policy . |
-central <centralized_policyfile> | This configuration is applicable if the BDT policy is configured in CM. Provides name of the BDT Policy in CM. |
-sv,–-skipvalidation | Runs BDT without first checking the bdt.config and bdt.policy files for correctness. It is advisable to run transformation with skip validation option only when policy and configuration are validated beforehand.Caution: Use only for testing. Do not use it in a production environment. |
-t,–-transform [<transformation_id>] | Validates bdt.config and bdt.policy , then transform the input file and store the results in the output directory. If this option is omitted, BDT does not perform the data transformation. Running without -t is useful when you only want to set passwords or validate configuration files.You can optionally include the transformation ID here. When provided as a value to this option the specified ID overrides the ID field value that is set in the policy file. |
-v,–-validate | Validates bdt.config and (optionally) bdt.policy . Use this option when you want to check the files without actually transforming the data. The policy file is validated if the -p option is included in the command. If you are running with -t , you do not need to include -v . The -t option includes an implicit -v . |
--table <tableName> | Lists columns for this table. This option must be accompanied by -ls or -ld option. General syntax: bdt.bat -ls (or -ld ) columns --table <tableName> -p <policyfile> |
-r <transaction_id> | Restarts a transformation run at the point of a failed transaction. Only uncommitted records are transformed. |
-rb , --rollback<transaction_id> | Rolls back a failed row during in-place transformation. |