Installing Documentation

This file describes how to install the product documentation. The documentation has been packaged as Eclipse document plug-ins, which you install with the documentation viewer.

About the document plug-ins

The documentation is packaged as Eclipse document plug-ins and must be viewed using the IBM(R) WebSphere(R) Help System. The help system (or viewer) and document plug-in format are based on an open source approach developed by the Eclipse Project (www.eclipse.org). IBM product document plug-ins are contained in folders that follow a consistent naming convention (com.ibm.xxx.doc).

Installing the document plug-ins

To view IBM product documentation in the viewer, you must install new or updated document plug-ins into the eclipse\plugins folder of the IBM WebSphere Help System.  The help system works with any information that has been packaged as an Eclipse document plug-in, including IBM product document plug-ins.  IBM product plug-in folders are easily identified because they use a common naming convention (com.ibm.xxx.doc).

To install document plug-ins, complete the following steps:

  1. Ensure that you have already installed the IBM WebSphere Help System. For details, see downloading the IBM WebSphere Help System.
  2. Obtain the document plug-ins. For example, you might go to an IBM product Web page to download document plug-ins.
  3. Copy the document plug-in folders to the eclipse\plugins folder of the help system.  For example, if you installed the help system to c:\WebSphere Help System, you would copy the document plug-in folders to: c:\WebSphere Help System\eclipse\plugins. Keep in mind that this must be the eclipse\plugins folder of the IBM WebSphere Help system; you may have additional eclipse\plugins folders on your system.
  4. To see the newly added document plug-in, start the viewer (or shut it down and restart it if it was running).

Starting the viewer

To start the viewer:

  1. Open the WebSphere Help System folder.
  2. Double-click the WebSphere help start.bat file.

Note: It might take a few minutes for the system to start and the document plug-ins to be displayed the first time you start it.

Shutting down the viewer

When you close the viewer by simply closing its window, its processes are still running in the background. This enables a much faster launch during subsequent sessions. However, you must shut down these processes when you install document plug-ins or update the help system with new plug-ins.  Shutting down the viewer when not in use also frees up system memory.  When you shut down your machine, all help system processes shut down.

To shut down the viewer:

  1. Open the WebSphere Help System folder.
  2. Double-click the WebSphere help end.bat file.

(C) Copyright IBM Corporation 2003. All Rights Reserved.