Installing the main Windows server

Use these instructions to install the main Windows server.

Before you begin

You must satisfy the following requirements before you install 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.
Other 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.

If you are installing on Windows 2008, you must enable the Windows Computer Browser service. If this service is not started, the server installation might fail.

Rational® Synergy is a 32-bit application. To run on a 64-bit operating system, you must enable the 32-bit operation mode.

About this task

The main Windows server includes the compact client, engine, database server, administrative tools, object registrar, ccm server, help server, and router. To install a Windows server, you must be licensed to use Rational Synergy on Informix®.

You must install the main Windows server before you install additional servers or clients. If you already installed the main server, but must 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 Understanding licensing for Rational Synergy.

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.

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 Start to open a menu. Click Explore to open Windows Explorer. Navigate to DVD_drive:\win_servers\synergy_server, and double-click setup.exe. The Welcome dialog box opens.
    • If you are installing from a download, double-click synergy72.exe. The Welcome dialog box opens.
  3. Click Next. The Software License Agreement dialog box opens. Review and accept the terms of the license agreement.
  4. Click Next. The Choose Destination Location dialog box opens. Accept the default installation location, or click Browse to specify a different location.
  5. Click Next. The Setup Type dialog box opens.

    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, and then proceed to step 6.

    Install only one main server on your network.

    If you are not a domain user or a member of the local Administrators group, the IBM Rational Synergy Router Information dialog box opens.

    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.
  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 you run the installation.

  7. Click Next. The Informix Password dialog box opens.
    • If you have a user Informix, enter the Informix user password. This password is verified by the installation program. Go to step 8.
    • If you do not have a user Informix, the installation 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.

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

  8. Click Next. The Install IBM Rational Synergy Router dialog box opens.
  9. If a router is not installed, select Install Router. The Rational Synergy server requires one router per site.

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

  10. Click Next. The IBM Rational Synergy Router Information dialog box opens.
    1. If you selected Install Router in the previous step, the IBM Rational Synergy Router Information dialog box prompts you only for port information.

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

    2. If you did not select Install Router the previous step, the IBM Rational Synergy Router Information dialog box prompts for router host and port information. By default, the Rational Synergy router uses port number 5412. The port number must be the same as the one specified on the router computer.

      To change the defaults, type the name of the router host and router port in the appropriate fields.

  11. Click Next to open the Ccm Server Information dialog box.
  12. If the default primary server port number (8400) is in use, change the port number in the Port Number field. If you are not certain whether port number 8400 is available, look in your Services file, which is in the %windir%\System32\drivers\etc\services directory.
  13. Click Next to display the Rational Synergy Help Server Information dialog box.

    The help server serves online help for all Rational Synergy products. Rational Synergy requires one help server for each installation, which, by default, runs on the router host system.

    By default, the help server port number is 8500.

    If the default help server port number is already in use, change the port number in the Port number field. If you are not certain that port number 8500 is available, look in your Services file, which is in the %windir%\System32 \drivers\etc\services directory.

    If the help server is already installed at a different location, select Use Remote Help Server. In the Host and the Port fields, type the host and port where the Rational Help Server is located.

  14. Click Next. The Rational Directory Server Information dialog box opens.
  15. 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 in the %windir%\System32\drivers\etc\services directory.
  16. Click Next. The Informix Information dialog box opens.
  17. 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 whether port number 1526 is available, look in your Services file, which is in the %windir%\System32\drivers\etc\services directory.
  18. Click Next. The Informix Database Server Information dialog box opens.

    If you are installing the main server on a 64-bit version of Windows, a message displays telling you to create the Informix server manually by running the ccmsrv create command, after you complete the installation and restart your system. Click OK to continue the installation.

  19. Create the Informix database server.

    The default settings in all Informix database server dialog boxes are only suggestions. Configure these dialog boxes that are 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 selected the Create database server check box, you can choose to have the installation program automatically create a training database. 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. If it does not exist, the installation program creates and shares the ccmdb directory.

  20. Click Next. The Create Database Server Information dialog box opens.

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

  21. If you installed the main server on a 64-bit version of Windows, (specified in step 18) create the Informix database server:
    1. Restart your system and start a command prompt (run as administrator).
    2. Run the ccmsrv create command to manually create the Informix server.

    If the environment variables are not properly expanded, these errors display:

    ERROR: There is no sysmaster database available.

    ERROR: ERROR: Database sysmaster not found.

    The user environment for the informix user did not expand %systemroot% in the PATH. Replace %systemroot% with C:\Windows to successfully create the instance.

  22. If you selected Place all chunk files in the same folder in step 19, follow the instructions in To store chunk files in the same folder. Otherwise, follow the instructions in To store chunk files in separate folders.

    If you are unsure of how to allocate space for the chunk files, see 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

Procedure

  1. In the Create Database Server Information dialog box, accept the default location of the Chunk file folder, 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. The Connect to UNIX IBM Rational Synergy Server dialog box opens. Proceed to step 12.

To store chunk files in separate folders

Procedure

  1. In the Root Chunk File Information dialog box, accept the default location of the Chunk file folder, drive:\ifmxdata\, or click Browse to specify a different location.
  2. If you must change the default, type a chunk file size in the Chunk file size field.
  3. Click Next. The Temp Chunk File Information dialog box opens.
    Note: If the specified directory contains chunk files, these files are overwritten.
  4. In the Temp Chunk File Information dialog box, accept the default location of the Chunk file folder, drive:\ifmxdata\, or click Browse to specify a different location.
  5. If you must change the default, type a chunk file size in the Chunk file size field.
  6. Click Next. The Log Chunk File Information dialog box opens.
  7. In the Log Chunk File Location dialog box, accept the default location of the Chunk file folder, drive:\ifmxdata\, or click Browse to specify a different location.
  8. If you must change the default, type a chunk file size in the Chunk file size field.
  9. Click Next. The Ccm Chunk File Information dialog box opens.
  10. In the Ccm Chunk File Location dialog box, accept the default location of the Chunk file folder, drive:\ifmxdata\,, or click Browse to specify a different location.
  11. If you must 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. If the License Information dialog box opens, choose to enter either the license server location or supply the information later.
  14. Click Next. The Start Copying Files dialog box opens.
    1. Scroll through the Current Settings list to view your setup. To change any settings, click Back until you arrive at the dialog box to 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.

      The installation program determines whether you must restart. If a dialog box instructs you to restart after the installation program has finished running, follow the instructions to complete your installation.

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

    All setup information is written to a log file.

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.2x 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