WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Installing different versions of documentation into an help system

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:
Procedure
  1. 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.
  2. Optional: To update information for a new version of the product, complete the following steps:
    1. Go to the plugins directory of your Eclipse-based help viewer.
    2. 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.
    3. In that plugin folder, open the file bookmarks.xml for editing.
    4. Add or change the values of the site element attributes:
      Table 1. Site element attributes
      name (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>
  3. Follow instructions in Starting the help system viewer to start the IBM WebSphere ESB help system.
  4. 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.
  5. Select the check box for the documentation that you want to install.
  6. 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.

task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tins_installingdocs_diffversions.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).