ccm_esd

The ccm_esd command starts the Rational® Synergy engine startup daemon.

Synopsis

ccm_esd [port_number]

Uses

Note: ESD is applicable only if you are using it for Rational Change.

Use the ccm_esd command to start the engine startup daemon. (Rational Synergy clients use the engine startup daemon to start sessions.) The log file for the Rational Synergy engine startup daemon is in $CCM_HOME/log/ccm_esd_hostname.log. ESD is only applicable if you are using it for Rational Change.

You must run this command on the machine where you will run Rational Synergy engines, as user ccm_root.

A Windows client automatically uses an ESD server if one exists on the engine host. However, Rational Synergy uses r* protocols to verify that the user name, password, and UNIX installation path are correct. The default configuration makes it possible to use a Windows client for multiple databases where some are using ESD and others are not.

If all UNIX engine servers are using ESD, then the client can rely exclusively on ESD services (r* protocols are not used). Do so by adding the following option to the Options section of the system (not personal) ccm.ini file at $CCM_HOME/etc/ccm.ini:

[Options]

engine_daemon=TRUE

If you do not want the Rational Synergy Windows client to use ESD, even when it is available on the engine host, add the following option to the Options section of the system (not personal) ccm.ini file at $CCM_HOME/etc/ccm.ini:

[Options]

engine_daemon=FALSE

Note: Use of ESD is not automatically detected for UNIX clients. Such clients must specify the engine_daemon option to use ESD.

During installation, the installer creates a single entry containing the installation machine name and port number in a port file called esd.adr. This file is located in the $CCM_HOME/etc directory. The ccm_esd command starts the engine startup daemon. The ESD needs to know which port to listen on for requests from clients. This information is in the port file.

If your site will run engines on machines other than the installation machine, add the host (machine) name and port number for each machine. You must edit the port file before you run the ccm_esd command or the command fails.

Use the following information to determine which machines require an entry in the esd.adr port file.

For each machine that will run an ESD:

  1. Edit the port file, esd.adr.

    $ vi $CCM_HOME/etc/esd.adr

  2. Type the host name and port number in the following form:

    hostname:port_number

    For example, type: lobo:8828

  3. Save, and then exit the port file.

For more information, see Starting and stopping the engine startup daemon (esd).

Options and arguments

port_number
Overrides the port number in the esd.adr port file.
This option can be used only by user ccm_root and must be run on each machine where an ESD run.

Example

Start the engine startup daemon and specify a port.

$ ccm_esd 5418

Files

$CCM_HOME/log/ccm_esd_hostname.log

$CCM_HOME/etc/esd.adr

$CCM_HOME/log/ccm_router.log


Feedback