DCEM allows you to create, save, and edit command specifications, which reduces your time and effort when you repeatedly run the same command.
A command specification consists of the following parts:
home/dcem/scripts/script file name.plhome is the home directory of the user under whose name the distributed command is run. script file name.pl is the name of a Perl script file containing a saved command specification.
/opt/csm/dcem/bin/dcemThe following usage message specifies DCEM command line options:
Using the dcem command with the command_specification_name option causes DCEM to initialize the input fields in the main window with specified command data. The command_specification_name refers to the name used to save a command specification in the DCEM dialog. The command defined in the command specification is sent to the specified hosts or groups by clicking the Run button in the dialog. The Execution Progress dialog shows the progress of the executed commands./opt/csm/dcem/bin/dcem [-h | --help] [-V | --version] [-v | --verbose] [-N | --groups group,group,group,...>] [-n | --hosts <host_name,host_name,host_name,...>] [command_specification_name]
The following flags are also available:
The -h | --help option writes the usage message for the dcem command to standard output.Examples
The -V | --version option writes version information to standard output.
The -v | --verbose option runs the dcem command in debug mode and writes the command's verbose messages to standard output.
The -N | --groups <group,group,group,...> option specifies the groups displayed in the Groups of hosts field of the DCEM dialog at startup. If this option is used with a command specification name, the host names and groups that are stored as part of the command specification are ignored.
The -n | --hosts <host_name,host_name,host_name,...> option specifies the hosts displayed in Host names field of the DCEM dialog at startup. If this option is used with a command specification name, the host names and groups that are stored as part of the command specification are ignored.
The following are examples for specifying hosts and groups together with the command_specification_name parameter on the command line. Assume the myCommand command specification was saved with the following host names: h1, h2, h3 and groups of hosts: g1, g2, g3.
1. To run DCEM, type:
dcem
2. To initialize the input fields with specified command specification name and groups, type:
dcem --groups g4,g5 myCommand
This results in the following output in the following GUI fields:
Host names:{empty}
Groups of hosts:
g4,g5
3. To initialize the input fields with specified command specification name, groups, and hosts, type:
dcem --groups g4,g5 --hosts h4 myCommand
This results in the following output in the following GUI fields:
Host names: h4
Groups of hosts:
g4,g5
4. To display the version of DCEM that is running, type:
dcem -V
Note: When running DCEM from a remote host, run the xhost + command on that host from the machine you are using. On the machine running DCEM, make sure you run the export command as follows:
export DISPLAY=<IP address of the machine you are using>
home/dcem/scripts/script file name.plhome is the home directory of the user under whose name the distributed command is run. The script file name.pl is the name of a Perl script file containing a saved command specification.
home/dcem/log/log file namehome is the home directory of the user under whose name the distributed command is run. log file name is the name of the log file containing the dcem command activity. All DCEM command activity of failures and successes are saved in this log file.
The default log file name is dcem1.log. The default maximum size for a log file is 10M. When dcem1.log is full, it is renamed to dcem2.log. New log entries are always written to dcem1.log.
DCEM provides the following tabs to help you define command specifications:
You can find more detailed help on the following elements of this window:
Run the command specification script directly on the command line as follows:
<user_home_directory>/dcem/scripts/commandSpecificationName.pl [-debug] [-non_interactive]
commandSpecificationName - is the name used to save a command specification using the DCEM dialog.
debug - Verbose mode. Determines the actual execution string specified, for example, /opt/csm/bin/dsh -f 11 -s -l root -N sysmgt-testbed "date".
non_interactive - Does not prompt on the command line to run the command. This option is useful when invoking the command script from another script.