Performing post-installation steps

About this task

This section explains what you need to do after you have installed Rational Synergy Release 7.1.

Perform these post-installation steps:

Procedure

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

Setting up the Synergy environment

About this task

To set up the Rational Synergy environment:

Procedure

  1. Update the X application defaults files for Rational Synergy.

    On all machines that run interfaces (clients), you must copy the Ccm file to the X defaults directory (even if you have already done so for a previous Rational Synergy release):

    1. For Sun™ OpenWindows™ platforms:
                     root# cp $CCM_HOME/etc/Ccm /usr/openwin/lib/app-defaults
    2. For all other platforms:
                     root# cp $CCM_HOME/etc/Ccm /usr/lib/X11/app-defaults

      If your environment is mixed, copy the files for both OpenWindows and non-OpenWindows platforms.

  2. Update environment variables for user ccm_root.

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

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

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

  4. Start the Rational Synergy daemons (router, esd, help server, and object registrar). The following command runs all daemons on the same machine. If you do not want to run all daemons on one machine, or to run additional daemons on other machines, see the Rational Synergy Administration Guide for UNIX.
    ccm_root$ ccm_start_daemons
    ccm_root$ exit

Reinstalling PC integrations

About this task

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.1.

You do not need to reinstall PC Integrations types into any existing databases. The database upgrade process described in these Upgrade Instructions preserves the PC integration types.

Merging configuration files

About this task

If you have not already done so, merge the files identified in Configuration, platform values, and remote execution files.

Verifying the installation

About this task

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

To verify the installation:

Procedure

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

    When the Start Rational Synergy dialog box displays, type the path to the test database in the Database Path text box, and the name of this machine in the Engine Host text box. Click Start to start the session.

Results

The installation is complete when the sessions start. To stop the sessions, select Task > Exit.


Feedback