Setting up for remote execution

If you want Rational® Synergy to run remote operations, such as running the remote DCM receive operation, you must specify the remote execution method to use. Because a different machine might use a different protocol, you must configure Rational Synergy for proper remote execution on your system.

Rational Synergy uses a configuration file, remexec.cfg, to determine the method to use for remote execution on a specific host.

Windows

You must be working as local administrator, and your PATH variable must contain CCM_HOME\bin to perform this procedure.

To set up for remote execution for Windows®:

  1. Log on as local administrator.
  2. Change to the directory where the remexec.cfg file resides.
  3. Launch your editor, and then edit the remexec.cfg file.

    Add the method for each host.

    Specify the source host, destination host, purpose, environment variables, and command using the following syntax:

    source_host   dest_host   [%purpose envvar]   command

    where source_host is the name of the source host machine.

    dest_host is the name of the destination host machine.

    purpose is an optional remote execution purpose, normally either DCM or DEFAULT. If specified, the purpose must include a leading percent symbol ( % ) so that ccm_remexec can determine that a purpose was specified.

    If the purpose is not specified, it is treated as a DEFAULT purpose. If both DEFAULT purpose and matching purpose exist between two machines, the entry with the matching purpose is used.

    envvar is a list of environment variables that starts with an optional leading dash ( - ), and is separated by commas and no extra spaces. This defines the environment variables that ccm_rem passes to the process executing the remote command. A list that starts with a dash means that all environment variables except the specified ones are passed by ccm_rem. A list that does not start with a dash means that only the specified environment variables are passed by ccm_rem. The keyword value ALL means pass all environment variables.

    An environment variable can be in one of the following formats:

    • NONE—None of the environment variables are passed to the remote machine.
    • ALL—All environments variables are passed to the remote machine.
    • Only the listed environment variable is passed to the remote machine (for example, env1, env2, ..., envn).
    • All the environment variables except the listed ones (-env1, env2, ... envn) are passed to the remote machine.
      Note: ccm_rsh only performs this environment processing when the remote execution host has a different IP address than the local host. In other words, if you use a ccm_remexec command that ultimately calls ccm_rsh to run a command on the local host, all environment variables are propagated, regardless of the settings defined in remexec.cfg.

      Both purpose and envvar are optional. However, if envvar is specified, then purpose must also be specified. If the purpose field is not specified, then all environment variables are passed when ccm_rem is used as the remote execution method.

      The remexec.cfg file is shipped with the following default:

            DEFAULT DEFAULT ccm_rem %hostname [%shell /C] %cmd_line
      Note: If you are using Rational Synergy Distributed, it only uses ccm_remexec for auto-receives on remote UNIX® systems. A Windows to Windows auto-receive is not affected by entries in remexec.cfg.

      The following are the search rules for remexec.cfg:

      source_host                  dest_host               matching_purpose                    Highest Priority
      ALL                          dest_host               matching_purpose
      source_host                  ALL                     matching_purpose
      DEFAULT                      DEFAULT                 matching_purpose
      source_host                  dest_host               DEFAULT 
      ALL                          dest_host               DEFAULT
      source_host                  ALL                     DEFAULT
      DEFAULT                      DEFAULT                 DEFAULT                         Lowest Priority
  4. Save, and then exit from this file.
  5. Log off from local administrator.

UNIX

For each DCM destination host, add an execution method to the $CCM_HOME/etc/remexec.cfg file. Each entry in this file contains the host name and its corresponding remote execution method.

To set up remote execution methods for UNIX:

  1. Set user to ccm_root.

    $ su - ccm_root
    Password: *****

    If CCM_HOME and PATH were not set up for user ccm_root during installation, set these environment variables now.

  2. Edit the remote execution configuration file.

    $ cd $CCM_HOME/etc
    $ vi remexec.cfg

  3. Add the method for each host.

    Specify the source host, destination host, purpose, environment variables, and command using the following syntax:

    source_host   dest_host   [%purpose envvar]   command

    where source_host is the name of the source host machine.

    dest_host is the name of the destination host machine.

    purpose is an optional remote execution purpose, normally either DCM or DEFAULT. If specified, the purpose must include a leading percent symbol ( % ) so that ccm_remexec can determine that a purpose was specified.

    If the purpose is not specified, it is treated as a DEFAULT purpose. If both DEFAULT purpose and matching purpose exist between two machines, the entry with the matching purpose is used.

    envvar is a list of environment variables that starts with an optional leading dash ( - ), and is separated by commas and no extra spaces. This defines the environment variables that ccm_rsh will pass to the process executing the remote command. A list that starts with a dash means that all environment variables except the specified ones will be passed by ccm_rsh. A list that does not start with a dash means that only the specified environment variables will be passed by ccm_rsh. The keyword value ALL means pass all environment variables.

    An environment variable can be in one of the following formats:

    • NONE—None of the environment variables are passed to the remote machine.
    • ALL—All environments variables are passed to the remote machine.
    • Only the listed environment variable is passed to the remote machine, for example, env1, env2, ..., envn.
    • All the environment variables except the ones listed (-env1, env2, ... envn) are passed to the remote machine.
      Note: ccm_rsh only performs this environment processing when the remote execution host has a different IP address than the local host. In other words, if you use a ccm_remexec command that ultimately calls ccm_rsh to execute a command on the local host, all environment variables are propagated, regardless of the settings defined in remexec.cfg.

      Both purpose and envvar are optional. However, if envvar is specified, then purpose must also be specified. If the purpose field is not specified, then all environment variables will be passed when ccm_rsh is used as the remote execution method.

      The remexec.cfg file is shipped with the following default:

         DEFAULT DEFAULT %DEFAULT ALL ccm_rsh -n [-s %shell] %hostname
      %cmd_line
      Note: If you are using Rational Synergy Distributed, it only uses ccm_remexec for auto-receives on remote UNIX systems. A Windows to Windows auto-receive is not affected by entries in remexec.cfg.

      The following are the search rules for remexec.cfg:

      source_host                  dest_host               matching_purpose                    Highest Priority
      ALL                          dest_host               matching_purpose
      source_host                  ALL                     matching_purpose
      DEFAULT                      DEFAULT                 matching_purpose
      source_host                  dest_host               DEFAULT 
      ALL                          dest_host               DEFAULT
      source_host                  ALL                     DEFAULT
      DEFAULT                      DEFAULT                 DEFAULT                         Lowest Priority
  4. Save the file, and then exit.

Feedback