Monitoring product usage for Windows

There are various ways to monitor product usage.

The commands that actually do the monitoring are described later, starting in Administrative commands for Windows. The following are references to the pages where the command information is located.

Users

Use the ccm monitor command to monitor various Rational Synergy processes. The ccm monitor command provides a network-wide view of Rational Synergy users and processes. It provides a list of the user, process type, host name, process ID, port number, and the associated database path.

For a complete description of all command parameters, including usage examples, see ccm monitor.

Process status

The ccm ps command provides network-wide process status information of the various Rational Synergy users and processes. It is a maximum verbosity version of the ccm monitor command.

For a complete description of all command parameters, including usage examples, see ccm ps.

Database server usage

The ccmsrv status command shows the status of the database server. This information complements the data provided by the ccm monitor and ccm ps commands.

For a complete description of all command parameters, see ccmsrv status. For a usage example, see Displaying database server states.

ccm_ess

To use an engine process, you must have local log on permission. You must run one ccm_ess service process per engine machine. The ccm_ess service starts automatically upon installation and reboot. It registers with the router. When you start a Rational Synergy session, the interface process requests that ccm_ess start the engine.

This service runs as the Rational Synergy administrator.

ccm_router

You must run one router process per network installation. The router starts automatically upon installation and upon reboot. Also, when you install Rational Synergy, you must specify the same router host and port for each Rational Synergy installation that is located on the same local network. This information is located in CCM_HOME\log\setup.log.

The router is a central point for registering and requesting information about Rational Synergy processes. It does not explicitly route messages between processes. Rather, it supplies a process with the addresses of other processes so that the individual processes can independently communicate among themselves.

The log file for the router service is CCM_HOME\log\ccm_router.log.

This service runs as system user.

You can run the router on a UNIX server.

ccm_objreg

You must run one object registrar process per database host. The object registrar process forwards notifications from one session to another as modifications are made to Rational Synergy databases. Each user interface updates its views as other programs modify the data it displays. An object registrar must run at all times on each host with an active Rational Synergy database, as determined by the object registrar host name property of each database. The object registrar starts automatically upon installation and upon reboot.

The object registrar host name of a database defaults to the host on which the database server is located. Use the ccmdb info command to change the name.

The default log file for the object registrar is CCM_HOME\log\ccm_objreg.log.

This service runs as system user.

ccm_server

Rational Synergy uses a web server to serve Rational Synergy web-mode sessions and help requests from user sessions. The CCM server runs on the same system as the router.

Additionally, Rational Synergy uses this web server to provide client downloads and to distribute patches for Windows clients.


Feedback