Performing post-installation steps

This section explains what you must do after you have installed Rational® Synergy Release 7.2 or later.

About this task

  1. Setting up the Rational Synergy environment
  2. Reinstalling PC integrations, if applicable
  3. Merging configuration files, if applicable
  4. Verifying the installation

Setting up the Rational Synergy environment

Set up the Rational Synergy environment.

Procedure

  1. Update environment variables for user ccm_root.

    To make Rational Synergy Release 7.2 or later the default installation, update the settings for CCM_HOME and PATH in the appropriate login scripts: .profile, .kshrc, .login and .cshrc files. If you do not want to change your defaults yet, explicitly set the environment while completing and testing the upgrade.

  2. Update environment variables for user informix. This information does not apply to users running on Oracle.

    To make Rational Synergy Release 7.2 or later the default installation, update the settings for CCM_HOME and PATH in the appropriate login scripts: .profile, .kshrc, .login and .cshrc files. If you do not want to change your defaults yet, explicitly set the environment while completing and testing the upgrade.

  3. Start the Rational Synergy daemons (router, esd, help server, and object registrar). The following command runs all daemons on the same computers. If you do not want to run all daemons on one computer, or to run additional daemons on other computers, see the administration documentation.
    ccm_root$ ccm_start_daemons
  4. Start the object registrar on other database servers.

    If the database server was not the computer where you ran the ccm_start_daemons command, you must run an object registrar on the database server. Log on as ccm_root, set the required environment if you have not yet changed the startup scripts for ccm_root, and then run the ccm_objreg command:

    root# su - ccm_root
    ccm_root$ CCM_HOME=/usr/local/ccm72x; export CCM_HOME
    ccm_root$ PATH=$CCM_HOME/bin:$PATH:/usr/ucb; export PATH
    ccm_root$ ccm_objreg
    ccm_root$ exit

Reinstalling PC integrations

If you used a PC integrations product with your previous Rational Synergy Release, you must install the appropriate integrations release on top of Release 7.2 or later.

Procedure

You are not required to reinstall PC Integrations types into any existing databases. The database upgrade process described in these instructions preserves the PC integration types.

Merging configuration files

If your previous installation is not visible from this computer, you must merge the configuration files manually with those files you saved.

Procedure

If you have not already done so, merge the files identified in Creating a database server.

Verifying the installation

Verify correct installation by unpacking a test database into the directory for Rational Synergy databases, on the database server. If any of the following steps fail, contact IBM Rational Software Support.

Procedure

  1. Unpack a test database.
    $ su - ccm_root
    ccm_root$ CCM_HOME=/usr/local/ccm72x; export CCM_HOME
    ccm_root$ PATH=$CCM_HOME/bin:$PATH; export PATH
    ccm_root$ ccmdb unpack $CCM_HOME/packfiles/training.cpk -t
    ccm_databases/testdb [-s servername]
  2. Start a Rational Synergy session on the test database.
    ccm_root$ cmsynergy -d ccm_databases/testdb

    If the Start Rational Synergy window opens, type the server URL in the Server field. Click Start to start the session.

Results

The installation is complete when the session starts.

What to do next

To stop the sessions, click the Close icon in the Rational Synergy client window, or click Task > Exit.

Feedback