WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Installing the documentation

You can install a local copy of the WebSphere ESB Information Center on your computer.

Before you begin

About the document plug-ins

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

Why and when to perform this task

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. Install the IBM WebSphere Help System, which can be found on the CD labeled WebSphere ESB CD 2. This component is in the \IEHS directory.
  2. Obtain the document plug-ins from the IBM product Web page http://www.ibm.com/software/integration/wsesb/infocenter/.
  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 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 might have additional eclipse\plugins folders on your system.
  4. To see the newly added document plug-in, start the viewer by following the instructions in the section below. Or, if it is running, shut it down following the instructions below, and then restart it.

    Detailed information about how to set up a local information center is contained in the WebSphere Help System/installing_and_managing.htm file.

Starting the viewer

To start the viewer:
  1. Open the WebSphere Help System folder.
  2. Double-click the 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 help_end.bat file.

Task topic

Terms of Use | Rate this page

Timestamp iconLast updated: 13 Dec 2005
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc\doc\tins_installingthedocumentation.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)