Project

General

Profile

« Previous | Next » 

Revision 989

Added by berkley over 22 years ago

updated for 1.1.0

View differences:

docs/user/metacatinstall.html
147 147 
   servlet context will depend on where you install the tomcat webapps
148 148 
   directory.</div>
149 149 
  </p>
150 
  <p>
151 
   After setting up Tomcat, you must make a slight modification to the startup
152 
   script.  Tomcat needs to know about special protocol handlers that Metacat
153 
   uses for its URLs.  Find the line in the tomcat.sh file that says
154 
   <pre>
155 
    if [ "$TOMCAT_OPTS" = "" ] ; then
156 
     TOMCAT_OPTS=""
157 
    fi
158 
   </pre>
159 
   It should be on about line 65.  You need to comment out the TOMCAT_OPTS
160 
   entry that is there and add the following:
161 
   <pre>
162 
    TOMCAT_OPTS="-Djava.protocol.handler.pkgs=edu.ucsb.nceas.protocols"
163 
   </pre>
164 
   When you are done the if statement should look like:
165 
   <pre>
166 
    if [ "$TOMCAT_OPTS" = "" ] ; then
167 
     #TOMCAT_OPTS=""
168 
     TOMCAT_OPTS="-Djava.protocol.handler.pkgs=edu.ucsb.nceas.protocols"
169 
    fi
170 
   </pre>
171 
   You must also complete the <a href="#protocol">protocol.jar</a> step below
172 
   for this to be completely
173 
   setup.  Also, make sure that this startup script is always used to start
174 
   tomcat or the parameter will not be set correctly and some features of
175 
   Metacat will not work.
176 
  </p>
177 
  <p>
178 
   Your servlet context should now be setup.  The next step is giving Tomcat
179 
   something to run in that context (i.e. Metacat).
180 
  </p>
181 150 
</td>
182 151 
</tr>
183 152 
</table>
......
204 173 
   to change a number of configuration properties to match the setup on
205 174 
   your system.  If you are using oracle, you'll need to customize the
206 175 
   properties in the "oracle" target.  If you are using Postgres, you'll
207 
   need to customize the properties inthe "postgres" target.  All users
176 
   need to customize the properties in the "postgres" target.  All users
208 177 
   will need to customize the properties in the "config" target.
209 178 
  </p>
210 179 
  <p>
211 180 
   The properties that you need to change will include jdbc-connect,
212 181 
   dbDriver, dbAdapter, oracle_home,
213 
   jdbc, tomcat, webapps, contex, user, server, systemidserver,
182 
   jdbc, tomcat, webapps, context, user, server, systemidserver,
214 183 
   web-base-url, and default-style. Each is described in detail below.
215 184 
   You should also verify that the jar file properties mentioned in the
216 185 
   remainder of the config target are accessible at the paths listed -- the
217 186 
   defaults will usually work.
218 187 
  </p>
188 
  <p>
189 
   Note that the build file is preconfigured to install Metacat either using
190 
   Oracle or PostgreSQL as a backend database.  To change the database
191 
   system, simply change the 'depends' attribute of the 'config' target to be
192 
   the name of the database target that you wish to use (either 'oracle' or
193 
   'postgresql').  If you wish to use a different database system, add a new
194 
   target for your database with the needed parameters and actions then add it
195 
   to the 'depends' attribute.
196 
  </p>
219 197 
  Properties you will likely need to change:<br />
220 198 
  <ul>
221 199 
  <li>
......
224 202 
  </li>
225 203 
  <li>
226 204 
   The dbDriver parameter is the name of the JDBC driver class to use for
227 
   connections to your database.  If you are not using Oracle, you will also
228 
   need to change the name of the database adapter class in the dbAdapter
229 
   property in the <a href="./properties.html"?>metacat.properties</a> file.
205 
   connections to your database.
230 206 
  </li>
231 207 
  <li>
232 208 
   The dbAdapter parameter is the name of the Metacat adapter class to be used
233 209 
   to communicate with a particular database.
234 
   If you are not using Oracle, you will need to change this.  There are
235 
   currently adapters for Oracle, Postgres, and MS SQL Server.
236 210 
  </li>
237 211 
  <li>
238 212 
   The oracle_home parameter is the location that oracle is installed on
......
259 233 
   or supplementary images.
260 234 
  </li>
261 235 
  <li>
262 
   The server is the http address on which Metacat is running.
236 
   Server is the http address on which Metacat is running (note that you should
237 
   not include the 'http://' in the server property.
263 238 
  </li>
264 239 
  </li>
265 240 
  <li>
266 241 
   The systemidserver is the protocol (http or https) and server location to get
267 
   DTD file.
242 
   any DTDs.
268 243 
  </li>
269 244 
  <li>
270 
   The user and password parmaters are the database user name that you set up
245 
   The user and password parameters are the database user name that you set up
271 246 
   to use Metacat, for example an Oracle username and password.
272 247 
  </li>
273 248 
  <li>
......
285 260 
  <ul>
286 261 
  <li>
287 262 
   The installdir
288 
   parameter is the directory that you want Ant to install the servlet to.
263 
   parameter is the directory in which Ant should install the servlet.
289 264 
   It is your "servlet context path" that was defined above.
290 265 
  </li>
291 266 
  <li>
292 267 
   Replication path is the relative path to the replication servlet.  This
293 
   should be the name of your servlet followed by "/servlet/replication".
268 
   should be the name of your servlet followed by "/servlet/replication".  For
269 
   example 'metacat/servlet/replication'.
294 270 
  </li>
295 271 
  <li>
296 272 
   The servlet path is the relative path to your servlet as viewed by the

Also available in: Unified diff