Introduction

The online help in IBM ® WebSphere® Studio Application Developer V5 (hereafter called Application Developer) is a great resource for finding samples, tutorials, instructions for completing common tasks, conceptual information, and much more. The online help is extensible -- the WebSphere Studio support information plug-in enables you to add more resources to the help. For more information about the support information plug-in, see Adding self-help support to WebSphere Studio tools by extending their Eclipse help systems.

With so many help topics available, you might find it difficult to find the topic you're looking for. You can search the help by simply entering a search string in the Search field and clicking Go. To narrow the scope of your search, select Advanced Search and specify the scope of your search.

The first time you use the search function in a workspace, a couple of minutes are required to index the search topics. If you frequently use multiple workspaces, waiting for search to index the files each time can be an annoyance. The avoid this situation, you can install the help system as a standalone application, or if you have a spare application server, you can install the help as a Web application and access it from any browser on any computer. The help will then be available to you all the time and you won't have to wait for the help system to open each time you want to use help.

The help system is part of the Eclipse platform and can be run in three different ways:

1. Inside Application Developer: select Help => Help Contents from the menu bar.
2. As a standalone Java™ application: run it from a .bat file.
3. As a Web application: access it via a servlet if you install the help system on a J2EE application server such as WebSphere Application Server V5.

Back to top

Running help from within WebSphere Studio

After you open the help, you will see that the Application developer information book contains instructions on using the tools included in the product:

Back to top

Running help as a standalone Java application

To run the help as a standalone Java application:

1. Open a command line.
2. Change directory to X:\installdir\eclipse\plugins, where x:\installdir is the drive and directory where you installed Application Developer.
3. Set your classpath to include X:\installdir\eclipse\plugins\org.eclipse.help_version\help.jar where _version is the most recent version of the plug-in.
4. Type java org.eclipse.help.standalone.Help "X:\installdir\eclipse\plugins (do not include a backslash ( \ ) after the plugins directory).

The main method of org.eclipse.help.standalone.Help will create a small AWT window with two buttons: Context help and Help. Either button will open a window that lets you see the contents of the help in any browser:

By default, the help will start on a random available port. If you want the help to run on a specific port, change the port=0 line inside the org.eclipse.tomcat_version\preferences.ini file.

For more information about using the help system as a standalone application, see eclipse.org and the development resources at the Help platform Web site.

Back to top

Running help on WebSphere Application Server V5

To deploy the help system on WebSphere Application Server:

1. Download the ZIP file that contains the WAR file that you will install on WebSphere Application Server.
2. Unzip the file to a temporary directory, for example C:\temp.
3. Change the value of the location of the plug-ins that are part of the help system.
4. Start the Application Assembly Tool by selecting Start => Programs => IBM WebSphere => Application Server v5.0 => Application Assembly Tool:
   
5. Select the Existing tab and browse to C:\temp to select the WAR file.
6. When the file opens, select Context Parameters from the left-hand view.
7. From the right-hand view, edit the ECLIPSE_HOME parameter and enter the location of the parent plugins directory. Do note include a backslash ( \ ) at the end of the path.
8. Save the file.
9. Exit the Application Assembly Tool.

Back to top

Installing the WAR file

Install the WAR file by following these steps:

1. Start the Administrative Console by selecting Start => Program Files > IBM WebSphere => Application Server v5.0 => Administrative Console.
2. Enter your user ID and click OK.
3. Expand Applications => Install New Application from the menu on the left side of the page.
4. Browse to the temporary directory in which you downloaded the WAR file.
5. Choose a context root for your application.
6. Accept the defaults and click Next:
   
7. Select the Pre-compile JSP checkbox.
8. Accept the defaults on the next three dialogs by clicking Next on each page.
9. Click Finish to end the installation of the WAR file.
10. Save the configuration by selecting Save to Master Configuration => Save.

Back to top

Installing eclipseurl.jar

The eclipseurl.jar file contains classes that translate the URL requests that the help issues to the actual file on the file system. You will find the eclipseurl.jar file inside X:\installdir\eclipse\plugins\org.eclipse.help.webapp_version.

Follow these steps to add eclipseurl.jar to the classpath of the Application Server:

1. Expand Servers on the left side of the WebSphere Administrative Console.
2. Select the server you wish to use.
3. Scroll to and select Process Definition.
4. Click Java Virtual Machine.
5. Add eclipseurl.jar to the classpath text field. Make sure you include the entire path to the JAR file (for example, C:\WSADHelp\eclipseurl.jar).
   
6. Click Apply to apply the changes.
7. Restart the server in the Services menu in Windows.

Back to top

Starting the Administrative Console

1. In the Enterprise Application menu, select WSADInfocenter_war.
2. If the application has not started, click Start.
3. Regenerate your plug-in so that your HTTP server knows about the new Web application that you installed:
   

Back to top

Copying all of your .doc and .doc_ plugins

From Application Developer, go to the directory that you specified as ECLIPSE_HOME. In this example, it is C:\WSADHelp.

For your convenience, two files are provided containing the names of the plug-ins that you need to copy. Use these files in a batch file with the xcopy command to copy all of the plug-ins to your C:\WSADHelp directory.

1. eclipse_plugins.txt includes the plug-ins from the X:\installdir\eclipse\plugins\
2. wstools_plugins.txt includes the plug-ins from the X:\installdir\wstools\eclipse\plugins

If you installed the Rational Clear Case tools when you installed Application Developer, you will also need to copy this plug-in: X:\installdir\rational\eclipse\plugins\com.rational.clearcase.help_2.1.0.

Back to top

Accessing the help system

To access the help system, open your browser to http://websphere_server/ContextRoot/help.jsp.

For more information on running the help system as a Web project, go to eclipse.org and select the Download area.

Back to top

Conclusion

The WebSphere Studio help system is an excellent resource for finding information but is not always convenient to run inside the product. By making the help system available as a Java application, or as a Web application on an internal Web site, your team can access the help from a central location and avoid waiting for the help system to create an index each time you search it within a new workspace.

Back to top

Download

Name	Size	Download method
infocenter.zip	1.3 MB	FTP|HTTP

Information about download methods

About the author

Angel Vera graduated from Bond University in Australia and joined IBM Canada in 2000. Since then he has worked in IBM Support for Visual Age for Java and WebSphere Studio. He is also an expert on Eclipse. You can contact Angel at arvera@ca.ibm.com

Comments (Undergoing maintenance)

Back to top

Trademarks  |  My developerWorks terms and conditions

Table of contents

• Introduction
• Running help from within WebSphere Studio
• Running help as a standalone Java application
• Running help on WebSphere Application Server V5
• Installing the WAR file
• Installing eclipseurl.jar
• Starting the Administrative Console
• Copying all of your .doc and .doc_ plugins
• Accessing the help system
• Conclusion
• Download
• About the author
• Comments

Next steps from IBM

Spring, JRuby, and Ajax development is easier with WebSphere Application Server - a smart Java 5 and J2EE Web services-based application server.

---

• Try: The no-charge WebSphere Application Server Community Edition is a pre-integrated, lightweight Java 5 application server built on Apache Tomcat and other best-of-breed open source software such as OpenEJB, Apache Axis, and Apache Derby.
• Article: The article leverage the Spring Framework and the WebSphere Application Server to improve your J2EE project productivity.
• Tutorial: See how the free WebSphere Application Server and XML can improve the efficiency of your JRuby on Rails and Ajax development.
• Buy: WebSphere Application Server - Express

My developerWorks community

Dig deeper into WebSphere on developerWorks

Rate a product. Write a review.

Write a review for Rational products today!

Special offers