platform-help-home/infocenter202.html

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.2 - (view) (download) (as text)

1 : dbirsan 1.1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 :     <html>
3 :     <head>
4 :     <title>Infocenter</title>
5 :    
6 :    
7 :    
8 :    
9 :     <meta http-equiv="Content-Type"
10 :     content="text/html; charset=iso-8859-1">
11 :    
12 :    
13 :     <meta content="eclipse.org" name="Author">
14 :    
15 :    
16 :     <meta content="MSHTML 5.50.4916.2300" name="GENERATOR">
17 :    
18 :    
19 :     <link href="/default_style.css" type="text/css" rel="stylesheet">
20 :     </head>
21 :     <body>
22 :    
23 :     <table border="0" cellspacing="5" cellpadding="2" width="100%">
24 :     <tbody>
25 :     <tr>
26 :     <td align="left" width="60%"><font class="indextop">infocenter<br>
27 :     setup</font><br>
28 :     <font class="indexsub">installing infocenter web application
29 :     on a server</font></td>
30 :     <td width="40%"><img src="images/Idea.jpg" hspace="50"
31 :     height="86" width="120" align="middle">
32 :     </td>
33 :     </tr>
34 :    
35 :     </tbody>
36 :     </table>
37 :    
38 :     <table border="0" cellspacing="5" cellpadding="2" width="100%">
39 :     <tbody>
40 :     <tr>
41 :     <td>You can enable users to access the help system over
42 :     the Internet or an intranet, by installing the help system web application
43 :     on a web server. Users open a URL in the web browser, which results in
44 :     help system displayed. The infocenter help system can be also used for client
45 :     applications and for web applications, that wish to have their help accessed
46 :     remotely. All features except infopops and active help are supported.<br>
47 :     &nbsp;<br>
48 :     The instructions provided go over installing and configuring the
49 :     infocenter application. &nbsp;Steps are provided for IBM WebSphere
50 :     Application Server 4.0.3 Advanced Edition Single Server, and Apache
51 :     Tomcat 4.0.4 on Windows. &nbsp;Other servers should be similar.<br>
52 :     <br>
53 :     </td>
54 :     </tr>
55 :     <tr>
56 :     <td align="left" valign="top" colspan="2"
57 :     bgcolor="#0080c0"><b><font color="#ffffff" face="Arial,Helvetica">1. Install
58 :     Eclipse</font></b></td>
59 :     </tr>
60 :     <tr>
61 :     <td> Download Eclipse SDK or Platform
62 :     Runtime Binary from <a
63 :     href="http://www.eclipse.org/downloads/">http://www.eclipse.org/downloads/</a>.
64 :     Unzip Eclipse on a system. The directory called "<tt>eclipse</tt>"
65 :     will be created. Documentation contributed by plugins in Eclipse
66 :     installation will be made available for remote browsing. &nbsp;Let us assume
67 :     you unzipped Eclipse to "<tt>d:\</tt>".<br>
68 :     <br>
69 :     </td>
70 :     </tr>
71 :     <tr>
72 :     <td align="left" valign="top" colspan="2"
73 :     bgcolor="#0080c0"><b><font color="#ffffff" face="Arial,Helvetica">2. Download
74 :     Infocenter</font></b></td>
75 :     </tr>
76 :     <tr>
77 :     <td> 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
78 :     infocenter driver. Let us assume that this directory is "<tt>d:\infocenter\</tt>". The directory should contain a web module (.WAR file) and the legal documents.<br>
79 :     <br>
80 :     </td>
81 :     </tr>
82 :     <tr>
83 :     <td align="left" valign="top" colspan="2"
84 :     bgcolor="#0080c0"><b><font color="#ffffff" face="Arial,Helvetica">3. Register
85 :     URL handlers with the server</font></b></td>
86 :     </tr>
87 :     <tr>
88 :     <td>
89 :     <b>WebSphere Application Server</b>
90 :    
91 :     <blockquote>Log into the Administrative Console, expand Nodes -&gt;
92 :     HOSTNAME -&gt; Application Servers -&gt; Default Server -&gt; Process Definition,
93 :     select "JVM Settings" in the tree. &nbsp;On JVM Settings form, type "<tt>D:\eclipse\plugins\org.eclipse.help.webapp_2.0.2\eclipseurl.jar</tt>"
94 :     in the Classpath field. &nbsp;Click OK button.</blockquote>
95 :    
96 :     <b>Tomcat</b>
97 :    
98 :    
99 :     <blockquote> Edit TOMCAT_HOME\bin\setclasspath.bat file and after the
100 :     line:<br>
101 :     <tt>set CLASSPATH=%JAVA_HOME%\lib\tools.jar</tt><br>
102 :     insert the line:<br>
103 :     <tt>set CLASSPATH=%CLASSPATH%;D:\eclipse\plugins\org.eclipse.help.webapp_2.0.2\eclipseurl.jar<br>
104 :     <br>
105 :     </tt> </blockquote>
106 :     </td>
107 :     </tr>
108 :     <tr>
109 :     <td align="left" valign="top" colspan="2"
110 :     bgcolor="#0080c0"><b><font color="#ffffff" face="Arial,Helvetica">4. Point
111 :     Infocenter application to the Eclipse installation</font></b></td>
112 :     </tr>
113 :     <tr>
114 :     <td>
115 :     <b>WebSphere Application Server</b>
116 :    
117 :    
118 :     <blockquote>Open the WAR file in <tt>d:\infocenter\" using Application Assembly Tool<br>
119 :     Select Context Parameters in the tree<br>
120 :     Set the value of ECLIPSE_HOME parameter to <tt>D:\eclipse</tt><br>
121 :     click Apply, and save the application archive.</blockquote>
122 :    
123 :     <b>Tomcat</b>
124 :    
125 :     <blockquote>Create a <tt>help</tt> subdirectory, <tt>d:\infocenter\help\</tt><br>
126 :     Unjar&nbsp;the WAR file from <tt>d:\infocenter</tt> into the "help" subdirectory.
127 :     directory<br>
128 :     In the file WEB-INF/web.xml replace lines<br>
129 :     <tt> &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
130 :     &lt;param-name&gt;ECLIPSE_HOME&lt;/param-name&gt;<br>
131 :     &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &lt;param-value&gt;&lt;/param-value&gt;</tt><br>
132 :     with<br>
133 :     <tt> &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
134 :     &lt;param-name&gt;ECLIPSE_HOME&lt;/param-name&gt;<br>
135 :     &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &lt;param-value&gt;D:/eclipse&lt;/param-value&gt;</tt><br>
136 :     <br>
137 :     </blockquote>
138 :     </td>
139 :     </tr>
140 :     <tr>
141 :     <td align="left" valign="top" colspan="2"
142 :     bgcolor="#0080c0"><b><font color="#ffffff" face="Arial,Helvetica">5. Deploy
143 :     the application on the server</font></b></td>
144 :     </tr>
145 :     <tr>
146 :     <td>
147 :     <b>WebSphere Application Server</b>
148 :    
149 :    
150 :     <blockquote>In WebSphere Administrative Console, expand Nodes -&gt;
151 :     HOST_NAME, select Enterprise Applications in the tree, click Install.<br>
152 :     Browse the Path to select location of the downloaded
153 :     WAR file<br>
154 :     Edit the following two fields as follows:<br>
155 :     Application Name : <tt>Eclipse Infocenter</tt><br>
156 :     Context Root : <tt>help</tt><br>
157 :     Leave the bottom section of the install from blank.<br>
158 :     Click Next, Next, Finish.<br>
159 :     Click Save in the Console header, click OK.<br>
160 :     Expand Nodes -&gt; HOST_NAME -&gt; Application Servers,
161 :     select Default Server.<br>
162 :     Click Web Server Plug-In Configuration link, click
163 :     Generate.<br>
164 :     Restart the server.<br>
165 :     </blockquote>
166 :    
167 :     <b>Tomcat</b>
168 :    
169 :     <blockquote>Copy the directory created in step 4 (<tt>d:\infocenter\help</tt>) to
170 :     <tt>D:\jakarta-tomcat-4.0.4\webapps</tt>. &nbsp;
171 :     If you use jdk1.4 to run Tomcat, you need to delete file <tt>D:\jakarta-tomcat-4.0.4\common\lib\xerces.jar </tt>
172 :     <br>
173 :     Restart the server.<br>
174 :     <br>
175 :     </blockquote>
176 :     </td>
177 :     </tr>
178 : dbirsan 1.2 <tr>
179 : dbirsan 1.1 <td align="left" valign="top" colspan="2"
180 : dbirsan 1.2 bgcolor="#0080c0"><b><font color="#ffffff" face="Arial,Helvetica">[Optional] Installing a minimal set of plugins</font></b></td>
181 : dbirsan 1.1 </tr>
182 :     <tr>
183 :     <td>
184 : dbirsan 1.2 <p>The infocenter does not require the entire &nbsp;Eclipse Platform package.
185 :     It is possible to run the infocenter with the following plugins (located
186 :     in the&nbsp; eclipse\plugins directory):<br>
187 :     </p>
188 :     <p> org.apache.lucene<br>
189 :     org.apache.xerces<br>
190 :     org.eclipse.core.boot<br>
191 :     org.eclipse.core.resources<br>
192 :     org.eclipse.core.runtime<br>
193 :     org.eclipse.help<br>
194 :     org.eclipse.help.webapp<br>
195 :     org.eclipse.update.core<br>
196 :     </p>
197 :     <p>In addition to these plugins, depending on the operating system or machine
198 :     architecture, you may need to also need to install the corresponding fragments
199 :     for the above plugins (when they exist). For example, on Windows, you need
200 :     to add the following fragments (also located in the eclipse\plugins directory):<br>
201 :     </p>
202 :     <p>org.eclipse.core.resources.win32<br>
203 :     org.eclipse.update.core.win32<br>
204 :     </p>
205 : dbirsan 1.1 </td>
206 :     </tr>
207 :    
208 :     </tbody>
209 :     </table>
210 :     <br>
211 :     <br>
212 :     <br>
213 : dbirsan 1.2
214 : dbirsan 1.1 </body>
215 :     </html>