Migration tool options
You can run the AuthTool by using the following command:
The following table describes the command line elements.
Use of the JRE embedded in the target AO server installation directory is recommended –
Specifies the options for the Java virtual machine such as those used to set the size of the heap or set Java system properties.
The file pathname of the diagnostic log file (default:
Specifies zero or more of the options.
If no option is specified,
For example, if you want to specify the BMC Atrium Single Sign-On password along with the command, you can use the following sample.
Migration tool options
The following table describes the options that you can use with the AuthTool command.
|Displays the help text|
Indicates that verbose output is produced; maybe repeated to produce more verbose output.
When you use
Performs a roughly formatted dump of the authentication and authorization information available in the BMC Atrium Orchestrator server.
This output is not suitable for import operations and is intended mainly as a diagnostic aid.
This operation may display sensitive data in the clear.
Exports the authentication and authorization information available in the AO server to an XML file suitable for use in an import operation.
Export the authentication and authorization information available in the AO server as a serialized object graph.
This format is not suitable for import operations but may be used as input the the
Imports the authentication and/or authorization information from
If a value is provided for the
Specifies the raw export file to be used as input to the
When specified, the AO server environment must match the original source of the data. For example, if dumped from an AO 7.6.03 CDP, it must be processed in an AO 7.6.03 CDP. This enables processing the raw data using the correct Java class files. A relative path is relative to the current directory.
Specifies the password used to encrypt sensitive data in the export data file.
The value of this option is a password designator. See Password Designator.
Sensitive data is encrypted for
The password supplied is not validated; using a different password for an
The default password is
Specifies the password used for the administrative connection to BMC Atrium single Sign-On used to add users and groups or update group membership.
The value of this option is a password designator. If a value for this option is omitted, users and groups are not imported into BMC Atrium single Sign-On.
Specifies the Java properties file providing the role names to substituting for built-in and user-defined roles found in the
Enables replacement of existing authorization data (a rule set) in the target CDP or Repository environment.
This option must be used with extreme caution -- it will overwrite any existing rules in the environment.
This option may be used in circumstances where the target server requires configuration or content transfer that results in loss of imported rules. In cases like this, performing import with
Password options accept the following values:
Provides a password in the command line argument.
Use of this method is not recommended for environments where the command line may be recorded or otherwise observed.
Identifies a file containing, as the first/only line, the password to use.
It is recommended that the file be readable only to the user of the command. A relative path is relative to the current directory.
Indicates that a console prompt is issued for the password.
This option requires that a console device be connected.