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 when the server is running inside a firewall and when the client is running outside the firewall. ESD is only applicable if you are using it for Rational Change.

The log file for the Rational Synergy engine startup daemon is in $CCM_HOME/log/ccm_esd_hostname.log. You must run this command on the machine where you run Rational Synergy engines, as user ccm_root.

Note: Web-mode users do not need the engine startup daemon to start engines inside the firewall. Run ESD only when users outside the firewall do not connect using traditional mode sessions, or when you have a Rational Change server running outside the firewall.

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. Using the default configuration, you can 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). 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=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: john: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.
Only user ccm_root can use this option, which 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/etc/esd.adr

$CCM_HOME/etc/ccm.ini

$CCM_HOME/log/ccm_esd_hostname.log

$CCM_HOME/log/ccm_router.log


Feedback