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
- Create the ccm_root user.
- Create the ccm_root group.
- Make ccm_root a member of the ccm_root group.
- To the ccm_root group, add the names
of any users who have the build_mgr (build manager)
role.
- If you are running Rational® Synergy
on a Linux platform, link /etc/logingroup to
the /etc/group file.
- 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
- 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
- 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
- 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
- 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
- Extract the installer:
cd /tmp/synergy_image
cat download.tar.gz
| gzip -d | tar xf -
- Install the cache server:
- Log on to the installation computer as user root.
- Go to /tmp/synergy_image/ccm/unix/bin.
- 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 optionPlatform |
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.
- 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.
- 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.
- 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.
- 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