[TechNote] Using the WebSphere Application Server documentation offline

Using the WebSphere Application Server documentation offline

Technote (FAQ)

Question

Is there an alternative method for accessing the documentation for IBM WebSphere Application Server offline? 

Answer

The online version of this product documentation is the supported version. However, the documentation is provided in a format for offline use for convenience.

Pre-requisites: 

• These steps require Internet access and a machine that is running on a Microsoft Windows XP or higher operating system.
• Before you can use the Eclipse application, you must have a compatible level of Java runtime environment for Eclipse installed on your machine and configured to run from the command-line. See the Eclipse website for details.
• 
  

Complete the following steps to create your own offline version of the WebSphere Application Server documentation:

1. Go to the Eclipse downloads site: http://www.eclipse.org/downloads
   
2. Download the most current version of the Eclipse Classic application.
   
3. Create a directory on your local system for the Eclipse Classic application.
   For example:
   C:\eclipse_offline
   
4. Install the contents of the zip file.
   1. Open the zip file.
   2. Extract the eclipse directory in the zip file to your c:\eclipse_offline directory. Your c:\eclipse_offline directory now has a c:\eclipse_offline\eclipse subdirectory.
      
5. Within the C:\eclipse_offline directory, create command files to start and stop the Eclipse application.
   
   
   1. Locate the org.eclipse.help.base_N.N.N.vNNN.jar file within the C:\eclipse_offline\eclipse\plugins folder where N.N.N.vNNN refers to the Eclipse Classic version that you downloaded.
      
   2. Use a text editor to create the file, ic_start.cmd.
      
      
      1. Add the following statements into the file:
         java -classpath eclipse\plugins\org.eclipse.help.base_N.N.N.vNNN.jar  org.eclipse.help.standalone.Infocenter -eclipsehome eclipse -port 8680 -command start -noexec -clean
         
      2. Ensure that you use the correct name of the org.eclipse.help.base jar file. You must also specify the listener port for Eclipse. In this example, the port number is 8680.
         
      3. Save the ic_start.cmd file.
         
   3. Use a text editor to create the file, ic_end.cmd.
      
      
      1. Add the following statements into the file:
         java -classpath eclipse\plugins\org.eclipse.help.base_N.N.N.vNNN.jar org.eclipse.help.standalone.Infocenter -eclipsehome eclipse -command shutdown
         
      2. Ensure that you use the correct name of the org.eclipse.help.base jar file.
         
      3. Save the ic_end.cmd file.
         
6. Go to the WebSphere Application Server library page at http://www.ibm.com/software/webservers/appserv/was/library
   
7. Select the WebSphere Application Server version and edition of the documentation plug-ins that you want to use.
   
   
   1. Click the tab on the library page to choose the version of the information center that you want to use in an offline mode.
      
   2. Click the view page link for the edition of the product documentation that you want to use.
      
   3. From the information centers subpage, download the downloadable information center documentation plug-in to the plugins subdirectory on your local system.
      
      
      
      Note: You can have multiple editions of the documentation plug-ins for a single Websphere Application Server version within a single instance of Eclipse. For example, you can have the Network Deployment - distributed platforms edition and the WebSphere Application Server Samples edition for WebSphere Application Version 8.5 in a single Eclipse instance. However, you must have a separate Eclipse instance for each different version of the information center.
      
8. Extract the documentation plug-ins within the plugins subdirectory.
   
9. Run the ic_start.cmd file by double-clicking the filename or run the command from the command-line. This results in a command window that stays open until you run the ic_end.cmd file.
   
10. When the ic_start.cmd file is running, point your browser to http://localhost:[port_number]/help/index.jsp to launch the offline WebSphere Application Server documentation on your local system. In this example, the URL is: http://localhost:8680/help/index.jsp
    
11. To stop the offline information center, run the the ic_end.cmd file.
    
12. (optional) You can update the Eclipse instance with additional documentation plug-ins for the same version of WebSphere Application server or create a new instance of Eclipse for a different version of the WebSphere Application Server documentation plug-ins.