IBM Enterprise Records, Version 5.1.+              

execute command

The execute command applies the settings from a configuration XML file for the specified configuration profile or individual task. The command name is not case sensitive.

If you need to run the configuration XML files for a profile that was created or edited in the Configuration Manager graphical user interface, verify that the XML files contain values for the required passwords before you attempt to run the files. To run the configuration XML files:
  1. Start or stop the application server.
    Table 1. Required application server state
    Application server type Description
    WebSphere® Application Server Start the application server if it is not running.
    JBoss Application Server Stop the application server.
    Oracle WebLogic Server Start the application server if it is not running.
  2. Run the configuration XML files all at the same time or one file at a time as shown in the syntax below.

execute command syntax

The following syntax includes line breaks to format the command for reading. Enter the command and options on a single line, without any line breaks.

configmgr_cl.exe execute -profile profile_path 
[-task task_type | -taskfile 
task_file_name] [-silent] [-force] [-debug] [-help]

execute command parameters

-profile profile_path
The -profile profile_path parameter specifies the full directory path to the profile being created such as
C:\Program Files\IBM\EnterpriseRecords\configure
\profiles\WASWebApplicationDeploymentProile
or the relative path to the ..\profiles folder.
-task task_type
The -task task_type parameter indicates which task to run. You can omit the -task task_type parameter if you want to run all of the tasks or if you specify the -taskfile task_file_name parameter.
-taskfile task_file_name
The -taskfile task_file_name parameter specifies the configuration XML file to use. The task_file_name value is not case sensitive. Task file names are reported by the listTasks command.
You use either -task or -taskfile to specify which task in this profile will run. If neither -task or -taskfile is specified, all tasks in the profile will run. You do not need to specify both -task and -taskfile. If you specify both and they do not match, the command will throw an error.
-silent
The -silent parameter means there is no output when the command is running.
-debug
The -debug parameter enables logging for the command.
Restriction: This parameter is not supported on HP-UX installations.
-help
The -help displays the command help.

execute command examples

The following examples include line breaks to format the command for reading. Enter the command and options on a single line, without any line breaks.

Run all the tasks in a profile.
The following command runs all the tasks in the WSWebApplicationDeploymentProfile profile, which is located in the C:\Program Files\IBM\EnterpriseRecords\configure\profiles\WSWebApplicationDeploymentProfile directory.
 configmgr_cl.exe execute -profile "C:\Program Files\IBM\EnterpriseRecords
\configure\profiles\WSWebApplicationDeploymentProfile"
Run one task in the profile.
The following command runs the deployWebApplication task in the C:\Program Files\IBM\EnterpriseRecords\configure\profiles\WSWebApplicationDeploymentProfile directory:
configmgr_cl.exe execute -profile "C:\Program Files\IBM
\EnterpriseRecords\configure\profiles
\WSWebApplicationDeploymentProfile" -task deployWebApplication 
Run one task specified by -taskfile
The following command runs the redeployWebApplication.xml configuration XML file in the C:\Program Files\IBM\EnterpriseRecords\configure\profiles\WSWebApplicationDeploymentProfile directory:
 configmgr_cl.exe execute -profile "C:\Program Files\IBM
\EnterpriseRecords\configure\profiles
\WSWebApplicationDeploymentProfile" 
-taskfile redeployWebApplication.xml 
Run -silent, one task in the profile, no output shown.
The following command runs the deployIER task in the C:\Program Files\IBM\EnterpriseRecords\configure\profiles\WSWebApplicationDeploymentProfile directory with -silent, no ouput shown:
 configmgr_cl.exe execute -profile "C:\Program Files\IBM
\EnterpriseRecords\configure\profiles
\WSWebApplicationDeploymentProfile" -task deployIER -silent 
Display the help for the execute command.
The following command displays the help for the execute command:
configmgr_cl.exe execute -help
Run -silent, no output shown for this command.
The following command runs the deployWebApplication task in the C:\Program Files\IBM\EnterpriseRecords\configure\profiles\WSWebApplicationDeploymentProfile directory with -silent, no ouput shown:
 configmgr_cl.exe execute -profile "C:\Program Files
\IBM\EnterpriseRecords\configure\profiles
\WSWebApplicationDeploymentProfile"
 -task deployWebApplication -silent 


Feedback

Last updated: August 2011


© Copyright IBM Corporation 2011.
This information center is powered by Eclipse technology. (http://www.eclipse.org)