Infocenter

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/`.