IBM Support

How to deploy help of various Rational products on intranet using Application Server

Question & Answer


Question

How do you configure and deploy help of various IBM Rational products independently on intranet using Application Server?

Cause

You want the procedure to deploy the Help of different Rational products without their contents overlapping with each other in a machine with no internet connection.

Answer

Prerequisites to be downloaded on a computer with Internet access

  1. Download a supported JRE version from the URL: http://java.sun.com/j2se

  2. Download Apache Tomcat 6.0.
    You can download the server application from http://tomcat.apache.org.

    Note: Apache Tomcat 6.0 requires the Java 2 Standard Edition (J2SE) Runtime Environment (JRE), version 5.0 or later.

  3. Obtain the compressed help-content file for your product from the Help download site at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/updatesites/.

    The file has this format: prod_coden.n_updateSite.zip, where prod_code is the product code and n.n is the version number.

  4. Download help.war from http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/war/help.war

  5. Paste all these files on the machine you want to configure Rational Products help on Intranet.


Instructions to set up the Apache Tomcat Application server and configure Help
  1. Install according to the included instructions in the J2SE JRE: http://java.sun.com/j2se

  2. Set an environment variable named JRE_HOME to the pathname of the directory into which you installed the JRE. For example, set one of these environment variables: c:\jre5.0 or /usr/local/java/jre5.0.

  3. Unpack the Apache Tomcat binary distribution files into a location where the distribution is located in its own directory. The directory is typically namedapache-tomcat-version. For this example, the name $CATALINA_HOME refers to the full path name of the release directory.

  4. Make 2 copies of help.war file, name it as say (help_rhp and help_DOORS) and then place it in the webapps folder: $CATALINA_HOME\webapps. The help.war is the Help System packaged as a WAR (Web Application Archive). You have to make as many copies of help.war file as many Rational Help Products you are configuring. ( If you are configuring 3 Rational products make 3 copies of help.war file.)

  5. Start Apache Tomcat by entering the Windows command: $CATALINA_HOME\bin\startup.bat. Apache Tomcat is running when the information message shows "Server Startup in x ms". Verify Apache Tomcat is running by opening this address: http://localhost:8080/. The default web applications that Apache Tomcat includes are listed.

  6. Navigate to the update window to obtain updated product help and follow the provided installation and update instructions:

    (i)For Rational Rhapsody open the following link:
    http://localhost:8080/help_rhp/updater/updatewar.jsp.

    (ii) For Rational DOORS open the following link: http://localhost:8080/help_DOORS/updater/updatewar.jsp.

  7. Click Add (+) in the Available Content pane, select Internal sites, enter the location of the prod_coden.n_updateSite.zip file and click OK.

  8. Select the site you added in step 7 from the Available Content list and click Install.
    The help content is installed. A progress bar tracks the status of the installation. (Do it for both the products)

  9. Access the help of the Rational product using different URLs when the installation finishes:

    (i)For Rational Rhapsody open the following link: http://localhost:8080/help_rhp/index.jsp.

    (ii) For Rational DOORS open the following link:
    http://localhost:8080/help_DOORS/index.jsp.

    Note: The above steps serve as an example of configuring Rational Products (Rhapsody and DOORS) Help on Intranet. These steps are generic for all the IBM Rational products which have updatesite:

    http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/updatesites/

[{"Product":{"code":"SSB2MU","label":"IBM Engineering Systems Design Rhapsody"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General Information","Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"}],"Version":"8.0;7.6.1.3;7.6.1.2;7.6.1.1;7.6.1;7.6.0.1;7.6;8.0.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Rhapsody

Document Information

Modified date:
27 May 2022

UID

swg21625598

Page Feedback