sim2cmdb CLI command

File path

MCELL_HOME/etc

Description

Contains the sim2cmdb CLI command configuration properties

IASServers

Specifies the Impact Administration Server (usually by host name) against which the CLI commands authenticate CLI commands may be executed on a computer other than the computer on which Impact Administration Server is installed. If you specify a remote Impact Administration Server in the sim2cmdb.conf file, but do not provide user credentials, you must provide them as command line arguments when you run a CLI command. If the Impact Administration Server has a backup server, then you can specify the primary server and the secondary server. If the primary is not running, then the CLI will authenticate against the secondary server.

none

IASUserName

Specifies a valid Impact Administration Server user name to be presented as credentials to the specified Impact Administration Server

none

IASPassword

Specifies the valid Impact Administration Server password for the specified Impact Administration Server (IASUserName) to be presented as credentials for the specified Impact Administration Server Enter the IASPassword as plain text. Upon the first execution, it is encrypted. To set up remote automatic authentication of CLI commands, specify the user name (IASUserName), and password (IASPassword) to be used as valid credentials for the specified Impact Administration Server (IASServers) in the sim2cmdb.conf file.

none

ARSXLongTimeOut

Sets the time to stop waiting on a BMC Remedy AR System operation that occurs slowly

1800

ARSXLongTimeOutEstimate

Enables (T) or disables (F) the use of the estimate when the length of time exceeds the value that is calculated for committing bulk entry transactions

T (true)

ContinueOnSkip

Defines sim2cmdb behavior if one or more instances cannot be imported If ContinueOnSkip is set to T, true, instances that can be imported are imported and instances that cannot be imported are not imported. The output file contains the list of instances that could not be imported. If ContinueOnSkip is set to F, false (default), the occurrence of even one instance that cannot be imported results in no data being created in the BMC Atrium CMDB. In other words, if all instances can be imported, all data (with attributes) in BMC.SIM is exactly as it is in the cell. If even one instance cannot be imported, only previously existing data in BMC.SIM still exists. The output file indicates the results.

F (false)

ReverseCellAliases

Specifies which alias corresponds to which cell Format: cellName, cellAlias{, cellName, cellAlias} When several aliases point to the same cell, retrieving an alias from a cell name is not deterministic. With the ReverseCellAliases parameter, you can specify which alias corresponds to which cell. It must have only one cellAlias for a cell in ReverseCellAliases. The letters in cellAlias value are case sensitive. If this parameter is not set, makes an undefined, arbitrary choice.

none

ReconJobTimeout

Sets the length of time that sim2cmdb checks for the termination of the reconciliation job If the interval expires before the reconciliation job completes, the sim2cmdb output file does not indicate the results of the reconciliation job. It may or may not have completed successfully.

120 (seconds)

CommitRetryTimeOut

Defines the length of time, in seconds, thatsim2cmdb retries the bulk entry transaction If the transaction failed due to the data problem, sim2cmdb will drop the offending data and retry the transaction.sim2cmdb will successfully commit good data into CMDB within the time specified by the CommitRetryTimeOut parameter or terminates the transaction if it exceeds the time specified by theCommitRetryTimeOut parameter.

900 (seconds)

PublishingServerName

The name of the publishing server. This name is used in validating the published environment and for DirectPublish credentials.

None

See Common-command-options-for-Publishing-Server-CLIs.

Identifies the specific environments. If an environment is not specified, then Direct Feed data is upgraded. If you are upgrading Direct Feed data only, EnvID must be empty; do not use the -e option for Direct Feed data. For example, the following command displays all the Direct Feed data present in the cell to be upgraded:

Forces the command execution without prompting you to confirm the action. If you do not specify the -foption, you must confirm the action when prompted to allow the action to execute.

Specifies the specific cell or cells from which to retrieve the service model classes. On Windows platforms, you must enclose the cell list in quotation marks ("). If no cell name is specified and there is an-e option, all the cells involved in the EnvIds are included. If there is no -e option, all the cells in the Atrium CMDB PROD environment are included. If one of the cells fails during cell verification, the sim2cmdbrun terminates.

File that contains the report of sim2cmdb execution. In other words, the list of data that will be imported into BMC Atrium CMDB and a list of data that will not be imported into BMC Atrium CMDB, and a list of errors that have occurred BMC Software recommends, examining this report each time you run sim2cmdb. You might need to correct the SIM date before executing sim2cmdb again. If you omit this option,sim2cmdb generates a default report file name.

Specifies the password for each environment listed in the -e option, if a password is required for the environment, separate additional passwords with commas (,). For example: If three environments exist, and environment 2 has no password (is unsecured), the command might look like this: sim2cmdb -e "Env1, NoSecEnv,Env3" -n cell -p "Password=pw1, ,pw3"

Removes all the instances in the BMC.SIM dataset. Although you can force removal of all the data in the BMC.SIM dataset, if the dataset is not clean, you must first return to the CI identification stage to identify CIs. Forcing removal of unidentified CIs can cause unsynchronized data between SIM and CMDB.

Imports the SIM data into the CMDB BMC.SIM dataset. On a successful commit, sim2cmdbautomatically starts the reconciliation job to merge data into the BMC.ASSET dataset.

Assigns a ReconciliationIdentity value to the components in BMC.SIM that have not been identified. See CI identification for more information.

Indicates a syntax error on one or more command-line arguments or options

Verify the correct syntax for the command string.

Indicates that the home directory of the CLI is not defined

Perform the following tasks:

1. Verify that the MCELL_HOME environment variable is set for the application.
2. Verify that the CLI script (.bat or .sh) file correctly contains: -DhomeLocation= %MCELL_HOME%
3. Specify the home directory (-D HomeLocation ) path at the command line.

Indicates that the supplied configuration file could not be found

Verify that the value of the -c argument is an existing, readable file.

Indicates that an I/O error occurred when reading the configuration file

Verify that the user has read access to the configuration file.

Indicates that the Impact Administration Server (IAS) interface cannot be initialized

Check whether the Impact Administration Server (IAS) is up and running.

indicates a security problem (for example, write access) to the CLI home directory

Check whether the user has read and write access to theetc/ log/ directory and write access to the temp/ directory in the CLI home directory.

Indicates that the home directory of the CLI does not exist

Indicates that the CLI cannot find a file that it requires to run properly; for example, a FileNotFound exception

Verify that the file whose name appears as missing does exist.

Indicates that the CLI cannot resolve a host name

Repair the computer's network settings.

Indicates that the failure to authenticate with the BMC Portal server

Perform the following tasks:

• If you are running a CLI command, verify the credentials that you specified.
• If automatic authentication is set up in thesim2cmdb.conf file, verify that the credentials (IASUsername, IASPassword, and IASServers) are valid.

Indicates that an error with starting impact CLI

Perform the following task: Verify that the fileinstallationdirectory /pw/server/ etc/locale/sim2cmdb.loadexists on the Infrastructure Management server host computer.

Indicates that the UTF-8 character set is not supported by the host

The host computer must support the UTF-8 character set.

Indicates that verification of publish environment failed

Indicates that an error occurred when retrieving a cell directory from the BMC Atrium CMDB

Verify the access rights for the cell directory.

Indicates that an error occurred when communicating with a cell

Verify that the cell is running. Verify network connectivity.

Indicates that verification of the cell protocol version failed

Indicates that classes between CMDB and cell(s) are not synchronized

Indicates that an error occurred when communicating with BMC Atrium CMDB

Verify that BMC Remedy AR System is running. Verify network connectivity.

Indicates that an error occurred when executing a CMDB operation

Indicates that an error occurred when importing data into CMDB

Check standard out for more details regarding the error.