Executing CIM Plugins

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:

<ATG9dir>\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:

  1. Start CIM using the –record flag.

  2. Go through your normal configuration activities.

  3. Select Batch File Save from the Main Menu when finished.

  4. 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 -batch path/batch_file.cim

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/ATG9.3/
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.

 
loading table of contents...