infocenter
setup

installing infocenter web application on a server
You can enable users to access the help system over the Internet or an intranet, by installing the help system web application on a web server. Users open a URL in the web browser, which results in help system displayed. The infocenter help system can be also used for client applications and for web applications, that wish to have their help accessed remotely. All features except infopops and active help are supported.
 
The instructions provided go over installing and configuring the infocenter application.  Steps are provided for IBM WebSphere Application Server 4.0.3 Advanced Edition Single Server, and Apache Tomcat 4.0.4 on Windows.  Other servers should be similar.

1. Install Eclipse
Download Eclipse SDK or Platform Runtime Binary from http://www.eclipse.org/downloads/. Unzip Eclipse on a system. The directory called "eclipse" will be created. Documentation contributed by plugins in Eclipse installation will be made available for remote browsing.  Let us assume you unzipped Eclipse to "d:\".

2. Download Infocenter
Download Eclipse Infocenter from the same page you downloaded the eclipse driver in Step 1. Create a directory "infocenter" on your system and unzip the infocenter driver. Let us assume that this directory is "d:\infocenter\". The directory should contain a web module (.WAR file) and the legal documents.

3. Register URL handlers with the server
WebSphere Application Server
Log into the Administrative Console, expand Nodes -> HOSTNAME -> Application Servers -> Default Server -> Process Definition, select "JVM Settings" in the tree.  On JVM Settings form, type "D:\eclipse\plugins\org.eclipse.help.webapp_2.0.1\eclipseurl.jar" in the Classpath field.  Click OK button.
Tomcat
Edit TOMCAT_HOME\bin\setclasspath.bat file and after the line:
set CLASSPATH=%JAVA_HOME%\lib\tools.jar
insert the line:
set CLASSPATH=%CLASSPATH%;D:\eclipse\plugins\org.eclipse.help.webapp_2.0.1\eclipseurl.jar

4. Point Infocenter application to the Eclipse installation
WebSphere Application Server
Open the WAR file in d:\infocenter\" using Application Assembly Tool
Select Context Parameters in the tree
Set the value of ECLIPSE_HOME parameter to D:\eclipse
click Apply, and save the application archive.
Tomcat
Create a help subdirectory, d:\infocenter\help\
Unjar the WAR file from d:\infocenter into the "help" subdirectory. directory
In the file WEB-INF/web.xml replace lines
        <param-name>ECLIPSE_HOME</param-name>
        <param-value></param-value>

with
        <param-name>ECLIPSE_HOME</param-name>
        <param-value>D:/eclipse</param-value>


5. Deploy the application on the server
WebSphere Application Server
In WebSphere Administrative Console, expand Nodes -> HOST_NAME, select Enterprise Applications in the tree, click Install.
Browse the Path to select location of the downloaded WAR file
Edit the following two fields as follows:
Application Name : Eclipse Infocenter
Context Root : help
Leave the bottom section of the install from blank.
Click Next, Next, Finish.
Click Save in the Console header, click OK.
Expand Nodes -> HOST_NAME -> Application Servers, select Default Server.
Click Web Server Plug-In Configuration link, click Generate.
Restart the server.
Tomcat
Copy the directory created in step 4 (d:\infocenter\help) to D:\jakarta-tomcat-4.0.4\webapps.   If you use jdk1.4 to run Tomcat, you need to delete file D:\jakarta-tomcat-4.0.4\common\lib\xerces.jar
Restart the server.

6. Point a web browser to the path of the web application.
WebSphere
Open the following URL http://localhost/help/ or http://localhost:9080/help/.
Tomcat
Open the following URL http://localhost:8080/help/.