Import option (-i)

The import option uses the following syntax:

cbt -i <content_dir> [<options>]

 

Short Option

long option

description

-i <content_dir>

--import <content_dir>

Import SA data from the given content directory.

-p
overwrite|duplicate|skip

--policy
overwrite|duplicate|skip

Import policy. Default is “overwrite.”

“overwrite” means to override objects in the same name space on the target Server Automation without affecting its object IDs.

“duplicate” means to create a duplicate copy of an object with a synthetic name when a duplicate is detected on the target Server Automation.

“skip” is the most conservative policy. It aborts the import of an object if the same object is detected in the target Server Automation.

For more information on import policies for the specific content types, see Policy on importing content .

-del

--delete

Delete objects marked deleted by the export. (In other words, this option will only work if the -del option was given during export. If this option is not given, the objects will be renamed.

-fa

--folderacls

Associate imported folders with existing user groups.

If this option is not specified, import the folders with the ACLs inherited from the parent folder in the destination mesh.

If this option is specified, the DET will attempt to import the ACLs when importing the folder. An ACL will import only if a user group with the same name as in the source mesh already exists or has been imported as part of the current DET run. The ACLs will become associated with the existing user group of the same name. When inserting a folder, the imported ACLs with replace any inherited from a parent folder in the destination mesh. When updating a folder, the ACLs will overlay existing ACLs.

-n

--noop

Run the import in a “dry run” mode. In other words, don't modify any data. Instead, output a summary of what changes would be made if run normally.

-cf <file>

--config <file>

Read configuration from the given file.

-d

--debug

Show more detailed debug information.

-np

--noprogress

Don't show the progress on the console.

-nu

--noupload

Don't upload unchanged packages to the Software Repository (the word).

The utility reports that the package is overwritten, but the package is untouched. Only its unit record is updated.

-lx

--logxml

Create log file in XML format.

-em <addrs>

--email <addrs>

Email a summary of the import to this comma-separated list of addresses. In order for this option to work, you must have added the email notification parameters to the DET configuration file.

(none)

--emaillog

Include the entire log file in the email.