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 information center 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