IBM Books

Administration Guide

dcem Command

Name

dcem - Provides a graphical user interface (GUI) that allows you to run a command or script on multiple distributed nodes on a network at the same time.

Synopsis

dcem [-h | --help] [-V | --version] [-v | --verbose] [-N | --groups [group,group,group,...]] [-n | --hosts [host_name,host_name,host_name,...]] [command_specification_name]

Description

Distributed Command Execution Manager (DCEM) provides a GUI that allows you to run a command or script on multiple distributed machines on a network at the same time. You can specify a collection of individual nodes, or you can create groups of nodes and save them to use again. DCEM provides real-time command execution status on the individual nodes that you specify, showing them in a waiting, working, successful, or failed state. It helps you to create, save, and edit command specifications, and it also creates a log of all distributed command activity. DCEM provides the capability of saving command specifications as PERL scripts. These saved command specifications can be executed at the command line. The command specifications are saved under the user's home directory /home/dcem/scripts.

The command_specification_name parameter initializes the input fields with the specified command. This is the name that is used when the command is saved in the DCEM GUI.

For the first release, the dsh command provides the underlying function.

Options

-h | --help
Writes the command's usage message to standard output.

-V | --version
Writes version information to standard output.

-v | --verbose
Runs in debug mode and writes the command's verbose messages to standard output.

-N | --groups [group, group,group,...]
Specifies the name of a group of hosts displayed in the Groups of hosts field in the DCEM dialog. If you use this option with the command specification name, the host names and groups that were saved with the command are ignored.

-n | --hosts [host_name,host_name,host_name,...]
Specifies the name of the hosts displayed in the Host names field of the DCEM dialog. If you use this option with the command specification name, the host names and groups that were saved with the command are ignored.

Examples

The following are examples for specifying hosts and groups together with the command_specification_name parameter on the command line. Assume the myCommand command 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 name and groups, type:
    dcem -N 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 name, groups, and hosts, type:
    dcem -N 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
    

Files

/home/dcem/scripts/script_filename.pl
Location of the DCEM command specification scripts

/home/dcem/logs/log_filename
Location of DCEM log files

See Also

The dsh man page.

Author

Sandy Amin - cluster@us.ibm.com


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]