Installing Synergy

About this task

Note: Do not install Rational Synergy Release 7.1 over a previous installation. Use a separate installation directory for each release, or uninstall the older release first, as described earlier in this checklist.

Download the appropriate installation image from the Rational Synergy Support website, and extract it. The following examples assume that you have extracted the image to /synergy_image.

Follow the instructions for running ccm_install in the Rational Synergy Installation Guide for UNIX, up to but excluding "Set up the Rational Synergy Environment", except: If the installation directory for the previous release of Synergy is visible from this machine, use the -u option in addition to the -x option.

For example, if you are using the Bourne shell, the commands for running the upgrade installation procedure might be as follows:

root# mkdir /usr/local/ccm71
root# chown ccm_root:ccm_root /usr/local/ccm71
root# chmod 755 /usr/local/ccm71
root# CCM_HOME=/usr/local/ccm71; export CCM_HOME
root# PATH=$CCM_HOME/bin:$PATH; export PATH
root# cd /usr/local/ccm71
root# /synergy_image/ccm/unix/bin/ccm_install -x -u

where:

-x extracts the software from the installation image.

-u automatically copies configuration files from a previous installation, as explained in Configuration, platform values, and remote execution files. The ccm_install program prompts you to type the path of the Rational Synergy 6.4, 6.5, or 7.0 installation. If you type an invalid directory, an error message is displayed, and you exit the ccm_install program.

Note: For more details about the ccm_install command, see the Rational Synergy Administration Guide for UNIX.

Configuration, platform values, and remote execution files

About this task

If your previous installation is not visible from this machine, you cannot use the -u option. Instead, you must merge the configuration files manually with those files you saved. See Saving the previous installation and 2.

If your previous installation is visible from this machine, when you install the software using the procedures previously described, the Rational Synergy installation program checks the configuration files in your previous installation directory. The following actions are taken as a result of this check:

  • Rational Synergy Release 7.1 is installed to a separate directory.
  • If a previous installation directory is visible, and the ccm_install -u option is used, the installer copies commonly modified files (such as ccm.ini) from the previous installation to the new one.
  • The installer tells you which files must be merged:
    • If a given configuration file in your previous installation directory is still valid for Release 7.1, it is automatically used in the Release 7.1 installation directory.
    • If a given configuration file in your previous installation directory is no longer valid for Release 7.1, it is copied to the Release 7.1 installation directory. However, it is given a different name. This new name is descriptive and is displayed by the installation program when you install Rational Synergy. If you modified any of these files in your old release and you want to keep the changes, merge your changed files with the new Release 7.1 configuration files.

Following is the list of configuration files that are handled as previously described (paths are relative to the Rational Synergy installation directory):

etc/Ccm
etc/ccminit
etc/ccm.ini
etc/remexec.cfg

Creating a database server

About this task

Except where noted, you must perform the following steps on each machine that will host a database server for Release 7.1.

Oracle users must read "Prepare the Oracle Database" in the Rational Synergy Installation Guide for UNIX on Oracle. They must also verify that the items listed in that section have been performed before proceeding.

Procedure

  1. Create database server shared library links.

    The database server requires symbolic links set up to point from /usr/lib to its shared libraries. The ccm_install command you ran while installing the new release creates these links only if the command is running on the same machine type as the binary files you are installing (and even then it only creates links on the installation machine). You must physically run ccm_install -l on each database server and engine server machine.

    $ su -
    root# CCM_HOME=/usr/local/ccm71; export CCM_HOME
    root# PATH=$CCM_HOME/bin:$PATH:/usr/ucb; export PATH
    root# cd $CCM_HOME
    root# $CCM_HOME/bin/ccm_install -l
  2. Create the database server. This information does not apply to users running on Oracle.

    Create your server using newly allocated disk space. Or, if you deleted your previous Informix database server, you can reuse its allocated space.

    Create a database server by following the instructions in the Rational Synergy Installation Guide for UNIX. Additionally, read the appropriate Rational Synergy Administration Guide for UNIX before creating a database server.


Feedback