Diagnosing session startup problems

The CCM server starts back-end command interface sessions to process user requests from Rational® Synergy clients. The CCM server manages the back-end sessions, starting new ones as needed, and shutting down old ones when they are no longer needed.

When a user starts a Rational Synergy session, the system performs several actions in sequential order. This table explains the actions that the system performs during the startup process and some possible reasons why the startup process can fail.

Table 1. Session startup troubleshooting
Progress status System action Possible startup failure causes

5%

GUI connects to the router to check for available patches

  • The installation router address file (*router.adr) for the Rational Synergy client is not configured correctly
  • The Rational Synergy server is not online, or the router process is not running

For more information, see Monitoring services for Windows or Managing daemons for UNIX.

25%

User authentication

  • Incorrect licenses
  • User not correctly defined in the users table for that database
  • Invalid role is specified in the ccm.ini file or in the start arguments

50%

Engine connects to the database server

  • Database host machine does not trust the engine host machine
  • Database server is offline
Note:

On an Informix® database, a session failure message displays and includes an Informix error code and ISAM number. Provide the code and number to IBM® Rational Software Support for help in determining the problem.

60%

Engine connects to the Objreg process and the router tells the engine where the Objreg processes are located

Note: Run the ccm monitor command to determine their location.

Faulty name resolution

70%

The current task loads preference data

Incorrect preference data

In the rare event that a startup failure occurs after the 70% status point, check your synergy.log file. If the messages in the log do not help you identify the problem, call Rational Software Support.


Feedback