Installing the software for Windows

The software can be installed to run on Jetty, IBM® WebSphere® Application Server, IBM WebSphere Application Server Community Edition, or Tomcat. Follow these steps to install the software for Windows.

Before you begin

Obtain the required licenses (see Understanding licensing for Rational Change 5.3 and Obtaining a license for Rational Change v.5.3).

Print the work sheet and document information for all possible items.

About this task

For WebSphere Application Server, WebSphere Application Server Community Edition, and Tomcat, the web server and Rational Change must be installed by the same user.

Procedure

  1. Log on as a user with administrative privileges.
  2. Run the IBM Rational Change server installation command.

    If you are running the installation command in command-line mode, a 1.6 JRE must be in the system path. Type java -version at the command prompt. The expected returned value is java version "1.6.xxx". Use the JRE that was shipped with Rational Synergy.

    To start the installation in GUI mode, double-click the setup.exe program in the change\windows directory.

    To start the installation in command-line mode, run the following command from the change\windows directory:

    > %CCM_HOME%\jre\bin\java -jar csinst.jar -nogui

    When the script prompts you for values, type the values shown for the GUI steps.

    Note: If you receive a warning, your system might not meet the server requirements. Other reasons for a warning are that the installation program did not find the JRE or there was insufficient disk space. For additional information, contact IBM Rational Software Support.
  3. In the Software License Agreement dialog box, which follows the Welcome dialog box, read the license agreement information, and then click Accept.
  4. In the Install Info - Select Install Set dialog box, select the applicable application to install, and then click Next.
  5. In the Change Info - Server Type dialog box, select the applicable server type, and then click Next.

    Click Learn More to view details about the server types or see Installation considerations for more information.

  6. In the Web Server Info - Select a Web Server dialog box, select a web server, and then click Next.
    • For Jetty, accept the default.
    • For WebSphere Application Server, WebSphere Application Server Community Edition, or Tomcat, type the location of the existing web server installation.
  7. In the Web Server Info - Port and Context dialog box:
    1. Accept the default or type an unused port number for the Rational Change server.
    2. Type a unique context path for Rational Change.
    3. Type a unique context path for Help.

      Depending on the option you selected on the Install Info - Select Install Set dialog box, this path may or may not be required.

    4. Click Next.

    If you change the port number, context path, and Help path, update items 5, 6, and 7 on the work sheet.

  8. For WebSphere Application Server only, in the WebSphere Profile dialog box, select a WebSphere profile (item 8 on the work sheet) where you want to install Rational Change. Then click Next.

    At least one profile must exist to run the product.

  9. For WebSphere Application Server and WebSphere Application Server Community Edition only, in the Web Server Info - Admin User dialog box, type the WebSphere server admin ID (item 9 on the work sheet) and password, and then click Next.
  10. For WebSphere Application Server only, in the WebSphere Server Instance dialog box, select a WebSphere server (item 10 on the work sheet).
  11. In the Change Info - Install Directory dialog box, accept the default path, or type the appropriate installation path, and then click Next.

    If you change the installation directory, update item 1 on the work sheet.

  12. In the Change Info - Local Admin User dialog box, type the user name and password (item 2 on the work sheet), and then click Next.

    The local admin user, which replaces the ChangeAdmin user from previous releases, is a special Rational Change user account that is defined during installation. Unlike regular user accounts, the local admin user is authenticated by Rational Change directly, rather than by IBM Rational Directory Server. The user account is also used to perform certain background activities.

  13. In the Change Info - Host dialog box, accept the default or type the name of the machine to run Rational Synergy sessions (it must be a Windows machine). Then, click Next.

    If you change the host name, update item 3 on the work sheet. You can add more session hosts later.

  14. In the Change Info - License Information dialog box, select the applicable option (item 4 on the work sheet), and then click Next.

    If you will supply license information later, you are reminded to edit the license data in the license_data.txt file. See step 21 for specific details.

  15. In the Synergy Info - Directory dialog box, accept the default or type a path to the Rational Synergy installation (CCM_HOME, item 11 on the work sheet). Then click Next.

    If you change the path to the Rational Synergy installation, update your work sheet.

    If you receive a warning about the installation path, the existing CCM_HOME installation might not be the required release of Rational Synergy. Click No to specify a different path to CCM_HOME or Yes to proceed with the installation using the path you already specified.

  16. In the Synergy Info - Database dialog box, type the UNC path to the database, and then click Next.
    • Stand-alone server: Type a UNC path to a Rational Synergy database.
    • Central server: Type a UNC path to a DCM-initialized Rational Synergy central CR database.
    • Remote server: Type a UNC path to a DCM-initialized Rational Synergy development database.

      If you change the database path, update item 12 on the work sheet. You can add more databases later.

    If you receive a warning, the existing database might not be for the required release, or the path you specified might not be correct or visible. Click No to specify a different path to database_path or click Yes to proceed with the installation using the path you already specified.

    Note: When you type a UNIX path, you receive a warning message. For additional instructions after the installation has been completed, see Installing on Windows with a UNIX Rational Synergy database.
  17. In the Synergy Info - Session User dialog box, type the name of the session user and password (item 13 on the work sheet), and then click Next.

    The user name must be defined in the operating system and be a user in the Rational Synergy database.

  18. In the Help Info- Help Server URL dialog box, select the applicable option, and then click Next.
  19. In the Start Copying Files dialog box, click Install.

    The Rational Change files are copied to the installation directory. As the files are copied, a status screen shows the progress of the installation.

  20. In the Install Wizard Complete dialog box, click Finished to exit the installation process.
  21. On the Change Info - License Information dialog box, if you chose to specify license information later, you must specify that information before you can log on to Rational Change. Edit the license_data.txt file in the applicable directory (such as, CHANGE_APP_HOME\WEB-INF\wsconfig).

What to do next

Now you are ready to verify the installation.


Feedback