ccm_esd

This topic contains information about the ccm_esd command.

Synopsis

ccm_esd [port_number]

Description and uses

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.

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 will 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 files 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