You can deploy the help system on the existing installation of WebSphere® Application Server.
Before you begin
Verify that these requirements are met:
- The server that you are configuring help content on is available to your users behind the firewall.
- A help.war file is on your server.
- If you the product that you are configuring the help for is installed on the server, a help.war file might be installed already.
- Look in the installation_directory/help directory for the help.war file.
- Look for a version of the file that includes the product abbreviation, such as clmhelp.war or ramhelp.war
- Search your installation directory for *help.war.
- If the product is not installed on the server or the product did not include a help.war file, download the help.war file at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/documentation/war.
- Install a Java™ Runtime Environment (JRE) or Java developer kit. You can install one of the IBM® developer kits.
- WebSphere Application Server is installed and configured. For more information about installing and configuring WebSphere Application Server for your environment, see your product documentation or the documentation for WebSphere Application Server.
- An environment variable with the path to the JRE or JDK is set:
- If you installed a JRE, verify that the JRE_HOME environment variable value is set to the path of the directory where you installed the JRE, for example,
- Windows: C:\Program Files\Java70\jre
- Linux: /usr/local/java70/jre
- If you installed the JDK, verify that the JAVA_HOME environment variable value is set to the path of the directory where you installed the JDK, for example,
- Windows: C:\Program Files\Java70
- Linux: /usr/local/java70/
- WebSphere Application Server is started.
Procedure
To deploy the help.war file:
- Open the WebSphere Application Server administrative console.
- Click .
- Select Local file system.
- Click Browse and select the help.war file that you chose to use.
- Click Next to accept all of the default options until you reach the "Map context roots for web modules" page.
- On the "Map context roots for web modules" page, set context root to /help, click Next, and then click Finish.
- Verify that the application was installed correctly and then click Save directly to the master configuration.
- Click .
- Select the check box next to the help.war application and then click Start.
Note: The help system starts and stops when you manually start or stop the application.
- Verify that you can access the help system by adding context_root/index.jsp to the end of your server application URL; for example, http://server:port/help/index.jsp.
Note: The help system might not contain help content yet. You might be required to install the documentation into the help system next.
What to do next
- Install the help content on the server by completing one of the following tasks:
- Provide the help URL to the team members in your organization. They can enter the
URL in their Rational®
DOORS® client help preferences to
redirect their help access to the intranet server, as described in Changing the help content selection. Ensure that the URL that you provide does not include
localhost as the server name; for example,
http://server.ibm.com:8080/help/index.jsp