Installing the cache server

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

  1. Log on to the Windows domain as a user who is in the administrator group.
  2. 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

  3. Click the Download Cache Server tab, and then click the cacheserver_7.2.1-windows.exe file.
  4. Select File > Run.
  5. Click Next, review the software License Agreement, and accept the terms of the license agreement.
  6. Click Next and accept the default installation location, or click Browse to specify a different location.
  7. 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.

  8. 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.
  9. 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.

  10. Click Next to display the Ccm Cache Server Information dialog box.
  11. 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.

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

  13. Click Next to view the current settings in the Start Copying files dialog box.
  14. Click Next to start the installation.
  15. When the installation is completed, click Finish.
  16. 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:
    1. On the Windows machine where the cache server is installed, add the Rational Synergy admin user as the administrator user.
    2. Start the cache service.
  17. On the Windows taskbar, click Start and type user in the search box.
  18. Click Change User Account Control settings and set the setting to Never Notify.
  19. 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.

  20. 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:
    1. On the Windows taskbar, click Start > Run, and type services.msc.
    2. Click OK.
    3. Select ccm7.2.1_cacheserver service, right click, and select Properties.
    4. In the ccm7.2.1_cacheserver service properties dialog box, click Log On and select This account.
    5. Type the ccm_root user credentials, and click OK.
  21. 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.

What to do next

Configure user rights.


Feedback