Installing the main Windows server

About this task

These instructions describe how to install the main Windows server. The main Windows server includes the compact client, engine, database server, administrative tools, object registrar, license manager, and router.

Note: In order to install a Windows Server, you must be licensed to use Rational Synergy on Informix.

You must install the main Windows server before installing additional servers or clients. If you have already installed the main server, but need to install more servers, see Installing an additional Windows server.

There can be only one main Windows server per Rational Synergy license file. For more information, see Setting up your server license.

You must satisfy the following requirements before installing the main Windows server.

User Requirements:
Member of local Administrators group

Permission to write to a local NTFS file system partition

Active Directory user

OS Requirements:
See the readme file or Rational Synergy Support website
Prerequisites:
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.
Note: You must install the main server and any additional servers in a domain environment. To install additional servers, see Installing an additional Windows server.

To install the main Windows server:

Procedure

  1. Log on to the Windows domain.
  2. Start the Rational Synergy installer.
    • If you are installing from a DVD, insert the DVD that contains the Rational Synergy Windows Server in the DVD drive. On the Windows taskbar, right-click the Start button to display a menu. Click Explore to open Windows Explorer. Navigate to DVD_drive:\win_servers\synergy_server, and double-click setup.exe to display the Welcome dialog box.
    • If you are installing from a download, double-click synergy71.exe to display the Welcome dialog box.
  3. Click Next to display the Software License Agreement dialog box. Review and accept the terms of the license agreement.
  4. Click Next to display the Choose Destination Location dialog box. You can accept the default installation location, or click Browse to specify a different location.
  5. Click Next to display the Setup Type dialog box.

    If you are a domain user and a member of the local Administrators group, the Setup Type dialog box opens. Select Main Server and click Next, then proceed to 6.

    Install only one main server on your network.

    If you are not a domain user and a member of the local Administrators group, the installation program displays the IBM Rational Synergy Router Information dialog box to install a compact client.

    1. Click Cancel to exit the setup program.
    2. Log on as a domain user who is a member of the local Administrators group.
    3. Start the main Windows server installation (see Installing the main Windows server).
  6. In the IBM Rational Synergy Administrator dialog box, type your domain name in the User domain field, if necessary.

    Type the Admin user name and Password in the appropriate fields.

    The domain and Admin user must exist before running the installation.

  7. Click Next to display the Informix Password dialog box.
    • If you already have a user Informix, enter the Informix user password. The password you enter is verified by the installation program. Skip to 8.
    • If you do not have a user Informix, the install program creates the Informix user for you. The Informix user is a member of the Informix-Admin group, and has the privilege to run the database server commands. In this case, you are prompted for the password, and asked to confirm the password, as shown in the following dialog box.

      Type the password for the Informix user in the Password and Confirm password fields.

  8. Click Next to display the Install IBM Rational Synergy Router dialog box.
  9. If you do not have a router installed, select Install Router. The Rational Synergy server requires one router per site.

    If you already have a router running on UNIX, do not install one on your Rational Synergy Windows server. You can share these services running on UNIX.

  10. Click Next to display the IBM Rational Synergy Router Information dialog box. If you selected Install Router in 9, perform step 10.a. Otherwise, perform step 10.b.
    1. If you are installing the router and license manager, the IBM Rational Synergy Router Information dialog box prompts you only for port information.

      By default, the port number that the Rational Synergy router uses is 5412. If this port number is already in use, change the port number in the Router port field. If you are not certain that port number 5412 is available, look in your Services file, which is located in the %windir%\System32\drivers\etc\services directory. For more information, see Services file.

    2. If you are not installing the router and license manager, the IBM Rational Synergy Router Information dialog box prompts for router host and port information. By default, the port number that the Rational Synergy router uses is 5412. The port number must be the same as the one specified on the router computer.

      If you need to change the defaults, type the name of the router host and router port in the appropriate fields.

  11. Click Next to display the Ccm Server Information dialog box. The CCM server is a Web server that serves online help for all Rational Synergy GUI sessions, both Web mode and traditional mode. Rational Synergy requires one primary server, which runs on the router host system.
  12. If the default primary server port number (8400) is already in use, change the port number in the Port Number field. If you are not certain that port number 8400 is available, look in your Services file, which is located in the %windir%\System32\drivers\etc\services directory.
  13. Click Next to display the Rational Directory Server Information dialog box.
  14. In the Server Host and Server Port fields, type the host and port where Rational Directory Server is installed. The default primary server port number is 1389. To find the port number where Rational Directory Server is installed, look in your Services file, which is located in the %windir%\System32\drivers\etc\services directory.
  15. Click Next to display the Informix Information dialog box.
  16. If the default Informix port number (1526) is already in use, change the port number in the Informix port field. If you are not certain that port number 1526 is available, look in your Services file, which is located in the %windir%\System32\drivers\etc\services directory.
  17. Click Next to display the Informix Database Server Information dialog box.
  18. Create the Informix database server.

    The default settings in all Informix database server dialog boxes are only suggestions. Configure these dialog boxes based on your planning estimates in Main and additional Windows server space requirements.

    • If you are upgrading from a previous Rational Synergy release on the same computer, do not select Create database server. In all other cases, select this check box.

      If you do not select Create database server, you install the new Informix software, but you do not create a database server.

      Note: If you are upgrading from a previous Rational Synergy release on the same computer and you select Create database server, your old chunk files can be overwritten. Overwriting chunk files can result in loss of data. For more information, see the upgrade instructions relevant to your current installation.
    • If you are creating a database server, type its name in the Server name field. Alternatively, use the default, which is the computer name.
    • Based on your planning estimates, type the appropriate number in the Number of users field.
    • By default, Place all chunk files in the same folder is selected. Keep this setting if you want all chunk files to be stored in the same directory. Otherwise, clear this check box.
    • If you are running the installation program as the CM Administrator, and you have selected the Create database server check box, you can choose to have the installation program automatically create a training database for you. Select Unpack Training database if you want a training database.

      The training database is created in the path \\computername\ccmdb\training, where computername is the name of the computer on which you are installing. The installation program creates and shares the ccmdb directory if it does not exist.

  19. Click Next to display the Create Database Server Information dialog box.

    If you are creating a database server (specified in step 18), a message appears telling you that server creation overwrites the existing onconfig file, SQLHOSTS registry entry, or Informix database chunk files. Click Yes to display the Create Database Server Information dialog box.

  20. If you selected Place all chunk files in the same folder in step 18, follow the instructions in #wp150998/wp135912. Otherwise, follow the instructions in To store chunk files in separate folders.

    If you are unsure how to allocate space for the chunk files, refer to Disk space considerations.

    Note: After you create a chunk file in a database server, do not move it. If you do, the database server will no longer work, and you can lose data.

    To store chunk files in the same folder

    1. In the Create Database Server Information dialog box, accept the default location of drive:\ifmxdata\ or click Browse to specify a different location.
    2. Type the sizes of the dbspaces in the following fields: Root size, Temp size, Log size, and Ccm size.
    3. Click Next to display the Connect to UNIX IBM Rational Synergy Server dialog box. Proceed to 13.

To store chunk files in separate folders

Procedure

  1. In the Root Chunk File Information dialog box, accept the default location of drive:\ifmxdata\, or click Browse to specify a different location.
  2. If you need to change the default, type a chunk file size in the Chunk file size field.
  3. Click Next to display the Temp Chunk File Information dialog box.
    Note: If a specified directory contains chunk files already, these files are overwritten.
  4. In the Temp Chunk File Information field, accept the default location of drive:\ifmxdata\, or click Browse to specify a different location.
  5. If you need to change the default, type a chunk file size in the Chunk file size field.
  6. Click Next to display the Log Chunk File Information dialog box.
  7. In the Log Chunk File Location dialog box, accept the default location of drive:\ifmxdata\, or click Browse to specify a different location.
  8. If you need to change the default, type a chunk file size in the Chunk file size field.
  9. Click Next to display the Ccm Chunk File Information dialog box.
  10. In the Ccm Chunk File Location dialog box, accept the default location of drive:\ifmxdata\, or click Browse to specify a different location.
  11. If you need to change the default, type a chunk file size in the Chunk file size field.
  12. You are now finished configuring the chunk files to be stored in separate directories.
  13. Click Next to open the Connect to UNIX IBM Rational Synergy Server dialog box.
    1. If you plan to connect the client to a UNIX server, select Connect to UNIX IBM Rational Synergy Server. Otherwise, clear this check box.
    2. If you selected Connect to UNIX IBM Rational Synergy server, specify whether a secure connection is to be used.
    3. If you selected Connect to UNIX IBM Rational Synergy server, type the UNIX installation path in the CCM_HOME field.
  14. If the License Information dialog box opens, select the appropriate license option:
  15. Click Next to display the Start Copying Files dialog box.
    1. Scroll through the Current Settings list to view your setup. If you need to change any settings, click Back until you arrive at the dialog box where you need to make the change. After you make the change, click Next until you return to the Start Copying Files dialog box.
    2. When all of your settings are correct, click Next.

      A progress indicator window opens in the middle of the screen while the files are being loaded onto your system.

      If you see a dialog box instructing you to restart after the installation program has finished running, follow the instructions in the dialog box to complete your installation. The installation program determines whether you need to restart.

  16. Click Finish. The Rational Synergy main Windows server installation is complete.

    All setup information is written to a log file. For example,
    C:\Documents and Settings\user\Application Data\IBM Rational\Synergy 7.1 install.log.

Results

You can unpack a database, then start a Rational Synergy session as the CM administrator. However, until you add users, including yourself, to the Rational Synergy database, you cannot use the database.

If you selected the option to create a training database, you can use the desktop shortcut Training for IBM Rational Synergy 7.1 to start a session on that database. You (the CM Administrator) are a user of the training database, but if you would like another user to use it, you must add that user to the database.


Feedback