CIM can run in two basic forms. The standard way to run a CIM plugin is using a command line interface to make selections at each step. To run a CIM plugin with the standard interface, go to:
<ATG11dir>\home\bin
Then enter the command:
cim
The CIM main menu appears.
You can also run CIM in batch mode. This option is provided for users who must frequently perform identical installation processes, such as when setting up environments for testing. To use CIM in batch mode, do the following:
Start CIM using the
–record
flag.Note that by default CIM records batch files in an encrypted form to protect your passwords. If you need unencrypted access to your batch files, you can record with the
–noencryption
flag.Proceed with configuration.
Select Batch File Save from the Main Menu when finished.
Specify a password to use when running the batch file.
Specify a save location.
CIM records your selections in a batch file. To repeat the procedure with those selections, use the following command to start CIM:
cim -batchpath
/batch
_file
.cim
Enter the password when prompted.
Note: When you run a CIM batch file, if any of the data import steps fail, the script exits without continuing on to configuration steps. If this happens, the log file includes an Error Executing Batch File
error message with information about the failure.
If you are familiar with CIM, you can edit and run batch files without stepping through the UI. The following example shows a partial batch:
atg.cim.jboss.CreateJbossAppServerInstanceTask.antFile=C:\dev\work\CIM\cim\ ant\cim-ant.xml atg.cim.jboss.CreateJbossAppServerInstanceTask.jbossPath=C:/jboss/ atg.cim.jboss.CreateJbossAppServerInstanceTask.serverInstanceName= pub_commerce atg.cim.jboss.CreateJbossAppServerInstanceTask.execute() atg.cim.dynamo.CreateDynamoServerInstanceTask.antFile=C:\dev\work\CIM\cim\ ant\cim-ant.xml atg.cim.dynamo.CreateDynamoServerInstanceTask.atgPath=C:/ATG/ATG11/ atg.cim.dynamo.CreateDynamoServerInstanceTask.serverInstanceName= pub_commerce atg.cim.dynamo.CreateDynamoServerInstanceTask.execute()
When the script is finished, it notifies you that the script completed successfully.
Note: No validation is performed when using batch mode. CIM tasks are executed in order.