If you have already installed an IBM® WebSphere® ESB Help
System from an earlier version of the product (for example, WebSphere Process Server Version
6.1.2), you can add documentation for the newer product version into
that help system by changing the bookmarks.xml file to point to the
documentation update site for the new product version.
Before you begin
Installing documentation into the IBM WebSphere ESB Help
System requires a working Internet connection to download documentation.
Also, the IBM WebSphere ESB Help
System installation wizard must have found a compatible help system
on your system. See Installing the documentation in other Eclipse-based
help viewers for information about installing documentation
in help viewers that are not the WebSphere ESB Help
System.
Only previously installed copies of the IBM WebSphere Process
Server or WebSphere Enterprise
Service Bus Help System can be used. The WebSphere Process Server and WebSphere Enterprise Service Bus Help Systems
are equivalent - for the same version - and can be used interchangeably.
If you plan to use the update function to bring your documentation
up-to-date with the latest available for your version of the product,
earlier versions of the IBM User
Interface Help System Built on Eclipse and Eclipse-based help viewers
cannot be used. They do not have the update function that initiates
installation of the product documentation and will not be found by
the installation wizard in its search.
About this task
To install documentation for any of the following combinations,
complete the following steps:
- Add 6.2 documentation to version 6.1.2 of IBM WebSphere ESB Help
System
- Add 6.1.2 documentation to version 6.2 of IBM WebSphere ESB Help
System
- Add non-WebSphere Business Process Management product's documentation
to version 6.2 of IBM WebSphere ESB Help
System
Procedure
- Cancel the IBM WebSphere ESB Help
System installation wizard if you haven't already and follow the instructions
here to install product documentation from within the help system
itself.
- Optional: To update information
for a new version of the product, complete the following steps:
- Go to the plugins directory of your Eclipse-based help
viewer.
- Within that plugins directory, find the Eclipse "webapp"
plugin directory, which is typically named org.eclipse.help.webapp_<version>. For example, the 3.1.1 version of the Eclipse webapp plugin
folder is named org.eclipse.help.webapp_3.1.1.
- In that plugin folder, open the file bookmarks.xml for
editing.
- Add or change the values of the site element attributes:
Table 1. Site element attributesname (optional) |
IBM Help
System server |
url |
- For version 6.2 of the documentation - http://publib.boulder.ibm.com/dmndhelp/downloads/v6r2mx
- For version 6.1.2 of the documentation - http://publib.boulder.ibm.com/dmndhelp/downloads/
|
<?xml version="1.0" encoding="UTF-8"?>
<bookmarks>
<site name="IBM Help System server"
url="http://publib.boulder.ibm.com/dmndhelp/downloads/v6r2mx" />
</bookmarks>
- Follow instructions in Starting the help system
viewer to start the IBM WebSphere ESB help
system.
- Click the Update icon in the help
system toolbar and click Find Updates at the
bottom of the Installed documentation list. The help
system goes to the IBM Help
System server and returns a list of documentation sets to install.
These sets include product documentation in different languages and
can also include documentation sets for different products.
- Select the check box for the documentation that you want
to install.
- Click Install Updates to confirm
the documentation to be installed. The IBM WebSphere ESB Help
System installs the selected documentation.
What to do next
You can view the newly installed documentation by stopping
and then restarting the help system.