Installing the cache server

This content applies to version 7.2.1 or later. Follow these steps to install the cache server on UNIX.

Before you begin

You must have user ccm_root defined. User ccm_root owns most of the files and directories. If you are not using NIS, set up ccm_root on each engine host. Use the same numeric user and group IDs on every computer.

Place the ccm_root home directories wherever they are appropriate for your site.

Do not install the software into the ccm_root home directory. Perform the user and group setup as user root.

Procedure

  1. Create the ccm_root user.
  2. Create the ccm_root group.
  3. Make ccm_root a member of the ccm_root group.
  4. To the ccm_root group, add the names of any users who have the build_mgr (build manager) role.
  5. If you are running Rational® Synergy on a Linux platform, link /etc/logingroup to the /etc/group file.
  6. Create the ccm_root home directories:

    This example includes /users/ccm_root:

    root# mkdir /users/ccm_root
    root# chown ccm_root /users/ccm_root
    root# chgrp ccm_root /users/ccm_root
    root# chmod 755 /users/ccm_root
  7. Log on to the installation computer as user root, and then create an installation directory:

    The installation directory can be anywhere, and can have any name.

    root# mkdir ccm_home
    root# chown ccm_root ccm_home
    root# chgrp ccm_root ccm_home
    root# chmod 755 ccm_home
  8. Create a temporary directory on a file system with at least 800 MB of disk space.

    This space is in addition to the space that is required for the installed software.

    mkdir /tmp/synergy_image

  9. Go to http://HostName:ccm_server_port_number/admin

    Where HostName:ccm_server_port_number is the server and port number on which the web administration interface is located.

    Example: http://hawk:8890/admin

  10. On the Download Cache Server tab, click the cache server installer download link for the platform on which you want to install the cache server and the path where the cache server installer must be copied on the system.

    Path example:

    /tmp/synergy_image

  11. Extract the installer:

    cd /tmp/synergy_image

    cat download.tar.gz | gzip -d | tar xf -

  12. Install the cache server:
    1. Log on to the installation computer as user root.
    2. Go to /tmp/synergy_image/ccm/unix/bin.
    3. Run the cacheserver_install program.

      When you run cacheserver_install, you must set the ccm_home environment variable.

      You must run cacheserver_install on the same computer type as the binary files you are installing, or on a different computer type using the -p[latform] flag to designate the type of binary file.

      Table 1. Arguments for the -p option
      Platform Attribute value
      Oracle Sun solaris
      AIX® ibm or aix
      Linux Linux

      The cacheserver_install program installs into either $CCM_HOME or the directory that is specified with the -d (destination directory) option. See Installing onto a remote file system.

      If you are using the Bourne shell, use these commands to set the environment variables and to run the installation command:
      root# CCM_HOME=ccm_home; export CCM_HOME
      root# PATH=$CCM_HOME/bin:$PATH; export PATH
      root# cd /tmp/synergy_image/ccm/unix/bin/
      root# cacheserver_install –x
      Attention: You must set $CCM_HOME to your cache server installation directory. Do not leave $CCM_HOME set to a previous installation. If you do, that installation might be overwritten by the cache server installation.
    4. When the cacheserver_install program prompts you for the router host name and the router port number, type the hostname and the router port number where the Rational Synergy main server is installed.

      A single cache server can be configured to register with a single router. However, it cannot register with multiple routers. All Rational Synergy servers that use the same router can be configured to use same cache server. Rational Synergy servers that use a different router than the one that is registered with the existing cache server should not be configured to use this cache server. This scenario is not supported. You must set up separate instances of the cache server for each router.

    5. When the cacheserver_install program prompts you for the ccm cache server port number, type one of the available port numbers that is on the machine where the cache server is installed.
    6. When the cacheserver_install program prompts you for the cache repository directory path, by default the repository directory is in the cache server runarea. Accept the default or type the new path.
  13. After you install the cache server, remove the temporary directory and its contents:

    rm -rf /tmp/synergy_image

Results

After you successfully run the cacheserver_install program, you see this message:

cacheserver_install: IBM Rational Synergy Cache Server installation succeeded

What to do next

.

Start the cache server service.


Feedback