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.
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:
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 list defines the environment variables that ccm_rem passes to the process running 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:
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
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
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:
$ su - ccm_root
Password: *****
If CCM_HOME and PATH are not set up for user ccm_root during installation, set these environment variables now.
$ cd $CCM_HOME/etc
$ vi remexec.cfg
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 list defines the environment variables that ccm_rsh pass to the process running the remote command. A list that starts with a dash means that all environment variables except the specified ones are passed by ccm_rsh. A list that does not start with a dash means that only the specified environment variables are passed by ccm_rsh. The keyword value ALL means pass all environment variables.
An environment variable can be in one of the following formats:
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_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
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