Configuring Rational Requirements Composer 2.0 Server

Configure the Rational® Requirements Composer 2.0 Server. Once configuration is complete, you will be able to access the server with both the Rational Requirements Composer 2.0 Client and the Web client.

Before you begin

Prerequisite: Before configuring the server, you must install Rational Requirements Composer 2.0 Server.
Note: If you intend to run the Tomcat application server on a 64-bit platform, see the related technote: http://www.ibm.com/support/docview.wss?rs=3488&&uid=swg21404257

Procedure

  1. Click Start > All Programs > IBM Rational Requirements Composer Server 2.0 > Start IBM Rational Requirements Composer 2.0 Server. The Tomcat command window appears. Wait for the message "INFO: Server startup in # ms". This step should take about 1 minute to complete.
  2. Open your Web browser and disable pop-up blockers.
    • Internet Explorer: Click Tools > Pop-up Blocker > Turn Off Pop-up Blocker
    • Firefox: Click Tools > Options. In the Content tab, uncheck the box next to Block pop-up windows. Click OK.
  3. After disabling pop-up blockers, point your Web browser to the following URL: https://[hostname or IP]:9443/rdm/setup
    What is [hostname or IP]?:
    • If you installed the server on a local machine that you will not share with others:[hostname or IP] will be localhost and the URL will be https://localhost:9443/rdm/setup
    • If you installed the server on a machine that you will share with others: [hostname or IP] will be the IP address or host name of the machine. Remember to use the fully qualified domain name in this case.
    • The hostname for a server that hosts a Jazz Team Server for C/ALM integrations must not include an underscore (_). If hostnames contain underscores, they must be changed to successfully implement the integration.
  4. The Jazz Rational Requirements Server Setup page is displayed at step 1, Set up Jazz Server. The Jazz Foundation Server URL and the Rational Requirements Server URL fields are pre-populated with default URLs. Click Next if you do not wish to change these default URLs.
    Important:
    • Modify the pre-populated URLs ONLY if you are using [hostname or IP] other than localhost.
    • If you are using a port other than the default one, replace 9443 in the pre-populated URLs with the port number you are using.
    • The [hostname or IP] portion of the URLs is case-sensitive, and it must match the one you used in the Web browser.
  5. The Jazz Team Server login page appears. Enter ADMIN (case-sensitive) in both the User ID and Password fields. Click Log In.
  6. The Jazz Team Server Setup page appears at step 1, Introduction. Select Fast Path Setup (ONLY for default Tomcat/Derby configuration) or Custom Setup (Recommended).
    • Fast Path Setup (ONLY for default Tomcat/Derby configuration)
      1. The configuration wizard will skip to step 5.
      2. In step 5, Setup User Registry, provide the following information.
        1. In step 5.1, select the Tomcat User Database user registry.
        2. In step 5.2, enter the User ID, Name, Password, and E-mail Address of the individual who will have administrator privileges for the server.
        3. In step 5.3, check the box to disable default ADMIN access.
        4. In step 5.4, check the box next to Rational Requirements Composer - Author to assign an author license to the administrator. Click Next.
      3. You should now have returned to step 2, Set up RRS, on the Jazz Rational Requirements Server Setup page. Click Configure.
      4. Wait until you see the message "Congratulations! The setup has completed successfully." Then, click Next.
      5. Step 3, Migrate Existing Server, appears. Click on the link below for instructions to migrate data from Rational Requirements Composer 1.0 Server. If you do not wish to migrate data, click Finish to access the Jazz Team Server Admin Web UI, where you have the option of creating users and assigning licenses.

        Click here for Instructions for data migration in Rational Requirements Composer 2.0.

      6. If you wish to access the Web client later, point your Web browser to the following URL: https://[hostname or IP]:9443/rdm/web/rrc
        Note: No projects or artifacts will be displayed in the Web client until you create them using the Rational Requirements Composer 2.0 Client.
      7. Return to the installation road map.
    • Custom Setup (Recommended)
      1. In step 2, Configure Database, enter the information that will be used to configure your database.
        1. Enter the following information in Step 2.1: Configure Database Vendor and Connection Type
          • In step 2.1, select your database vendor: (1) DB2 or (2) Oracle or (3) SQL Server.
          • In step 2.2, select JDBC as the Connection Type
        2. Enter the following information in Step 2.2: Configure Database Connection Properties
          • JDBC Password: Enter the password for the JDBC database.
          • JDBC location:
            Use the following syntax
            //servername:db2port/dbname:user=db2user;password={password};
            replace servername:db2port, dbname, and db2user with information relevant to your DB2 setup. Retain all other values as is, including {password} for the JDBC password (unless you have specific reasons for making other changes).
            Use the following syntax
            thin:dbuser/{password}@//servername:1521/ORCL
            replace dbuser and servername with information relevant to your Oracle setup. Retain all other values as is, including {password} for the JDBC password (unless you have specific reasons for making other changes).
            Use the following syntax
            //servername:1433;databaseName=dbname;user=rrcDBuser;password={password}
            replace servername , rrcDBuser, and dbname with information relevant to your SQL Server setup. Retain all other values as is, including {password} for the JDBC password (unless you have specific reasons for making other changes).
        3. Click Test Connection; when this is successful, click Next.
      2. In step 3, Enable E-mail Notification, set the e-mail configuration properties. Click Test Connection; when this is successful, click Next.
      3. Step 4, Configure Repository's Public URL, is essential when the server hosting Rational Requirements Composer 2.0 Server is known by multiple hostnames or domains on your network. If you choose to enter a URL in this field, ensure that it is in the format https://[hostname or IP]:9443/jazz and click Next.
      4. In step 5, Setup User Registry, provide the following information.
        1. In step 5.1, select the type of user registry you will use: (1) LDAP or (2) Non-LDAP External Registry.
        2. In step 5.2, enter the properties you used to configure your LDAP server to set up communication between the Jazz server and the LDAP server.
        3. Click Test Connection; when this is successful, click Next.
      5. You should now have returned to step 2, Set up RRS, on the Jazz Rational Requirements Server Setup page. Click Configure.
      6. Wait until you see the message "Congratulations! The setup has completed successfully." Then, click Next.
      7. Step 3, Migrate Existing Server, appears. Click on the link below for instructions to migrate data from Rational Requirements Composer 1.0 Server. If you do not wish to migrate data, click Finish to access the Jazz Team Server Admin Web UI, where you have the option of creating users and assigning licenses.

        Click here for Instructions for data migration in Rational Requirements Composer 2.0.

      8. If you wish to access the Web client later, point your Web browser to the following URL: https://[hostname or IP]:9443/rdm/web/rrc
        Note: No projects or artifacts will be displayed in the Web client until you create them using the Rational Requirements Composer 2.0 Client.

    Return to the installation road map


Feedback