This content applies to version 7.2.1 or later. Follow
these steps to install the cache server on Windows.
Before you begin
You must satisfy the following requirements before you
can install the cache server:
- Follow the guidelines in Security considerations.
- Be a member of the local Administrators group.
- Have permission to write to a local NTFS file system partition.
- Be an Active Directory user
Also, the %windir%\System32\drivers\etc\services file
must be writable and you must be logged on to a domain. %windir% is
the Windows installation
directory.
Procedure
- Log on to the Windows domain
as a user who is in the administrator group.
- 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
- Click the Download Cache Server tab,
and then click the cacheserver_7.2.1-windows.exe file.
- Select .
- Click Next, review the software
License Agreement, and accept the terms of the license agreement.
- Click Next and accept the default
installation location, or click Browse to specify
a different location.
- Click Next to display the Router
Information dialog box, which prompts you for the router
host and port information.
By default, the router uses
port number 5412.
- If the port number is incorrect, in the Router
port field, change the port number to the Rational® Synergy 7.2.1 main server router
port number.
- Type the host name of the Rational Synergy router machine.
If
the main server is running on a UNIX platform,
click Connect to UNIX IBM Rational Synergy Router and
provide the corresponding router host name and router port number.
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.
- Click Next to display the Ccm
Cache Server Information dialog box.
- If the default primary server port number 8400 is
in use, in the Port Number field, change the
port number.
If you cannot determine whether port number
8400 is in use, open the Services file, in the %windir%\System32\drivers\etc\services directory.
- Accept the default location for the cache repository, or
click Browse to specify a different location.
The location cannot be set to UAC protected folders (Program
Files or Windows System folders)
on User Access Control enabled Windows operating
systems.
- Click Next to view the current settings
in the Start Copying files dialog box.
- Click Next to start the installation.
- When the installation is completed, click Finish.
- If the user who installed the cache server is not the Rational Synergy admin user,
complete these steps so that the cache service can be started:
- On the Windows machine
where the cache server is installed, add the Rational Synergy admin user as the administrator
user.
- Start the cache service.
- On the Windows taskbar,
click Start and type user in
the search box.
- Click Change User Account Control settings and
set the setting to Never Notify.
- Restart the system.
By default, the cache
server starts as a system service. The cache server service runs normally
like the other Rational Synergy
services when the router is on Windows.
- If the cache server is deployed on a Windows 2003 platform and the router is installed
on UNIX/Linux, the administrator must run the cache server service
from Windows services console
as the ccm_root user, not as a default system user.
Complete these steps:
- On the Windows taskbar,
click , and type services.msc.
- Click OK.
- Select ccm7.2.1_cacheserver service,
right click, and select Properties.
- In the ccm7.2.1_cacheserver service
properties dialog box, click Log On and select This
account.
- Type the ccm_root user credentials,
and click OK.
- If the cache server is deployed on a Windows 2008 platform and the router is installed
on UNIX/Linux, the cache server service runs for the Windows 2008 platform as a system service
and displays an extra command window. Do not close this command window
when the cache server is running.
A cache server that
is installed on UNIX/Linux connecting to a router installed on Windows is not a supported combination
for the cache server to run correctly.