Project

General

Profile

1 878 berkley
<!--
2
  *   '$RCSfile$'
3
  *     Purpose: web page describing the installation of Metacat
4
  *   Copyright: 2000 Regents of the University of California and the
5
  *               National Center for Ecological Analysis and Synthesis
6
  *     Authors: Chad Berkley
7
  *
8
  *    '$Author$'
9
  *      '$Date$'
10
  *  '$Revision$'
11
  *
12
  *
13
  -->
14
15
<!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">
16
<html>
17
18
<head>
19
  <title>Metacat Installation Instructions</title>
20
  <link rel="stylesheet" type="text/css" href="@docrooturl@default.css">
21
</head>
22
23
<body>
24
25
<table class="tabledefault" width="100%">
26
<tr><td rowspan="2"><img src="@docrooturl@images/KNBLogo.gif"></td>
27
<td colspan="7">
28
<div class="title">Metacat UNIX Installation Instructions</div>
29
</td>
30
</tr>
31
<tr>
32
  <td><a href="@server@/" class="toollink"> KNB Home </a></td>
33
  <td><a href="@server@/data.html" class="toollink"> Data </a></td>
34
  <td><a href="@server@/people.html" class="toollink"> People </a></td>
35
  <td><a href="@server@/informatics" class="toollink"> Informatics </a></td>
36
  <td><a href="@server@/biodiversity" class="toollink"> Biocomplexity </a></td>
37
  <td><a href="@server@/education" class="toollink"> Education </a></td>
38
  <td><a href="@server@/software" class="toollink"> Software </a></td>
39
</tr>
40
</table>
41
<hr>
42
43
<table class="tabledefault" width="100%">
44
<td class="tablehead" colspan="2"><p class="emphasis">***Disclaimer***</p></td>
45
<tr>
46
<td>
47
  <p class="emphasis">
48 932 jones
   These installation instructions are meant for a systems administrator/DBA
49
   or someone who is an advanced computer user.  They are NOT meant for
50
   the average computer user.  Please realize that by executing these
51
   instructions, you may have to trouble shoot many advanced issues yourself.
52 878 berkley
</td>
53
</tr>
54
</table>
55
56
<table class="tabledefault" width="100%">
57
<td class="tablehead" colspan="2"><p>Pre-Installation</p></td>
58
<tr>
59
<td>
60
  <p class="header">Minimum Requirements</p>
61
  <p>
62
   Installing Metacat requires a server running an SQL92 compliant database
63
   (Oracle 8i recommended) with at least 128MB RAM, and a Pentium III class
64
   processor or higher.  The amount of disk space required depends on the
65
   size of your RDBMS tablespace (which should be at least 10 MB,
66
   however Metacat itself requires only about 1 MB of free space after
67
   installation.  These instructions assume a Linux environment but may
68
   work on other UNIX type environments, however this has not been tested.
69
  </p>
70
  <p class = "header">Additional Required Software</p>
71
  <p>
72
   The server on which you wish to install Metacat must have the following
73
   software installed and running correctly before attempting to install
74
   Metacat.
75
   <ul>
76
     <li><a href="http://www.oracle.com">Oracle 8i</a> (or another SQL92
77 932 jones
         compliant RDBMS like Postgres)</li>
78 878 berkley
     <li><a href="http://jakarta.apache.org/ant/index.html">Apache Jakarta-Ant</a>
79
     </li>
80
     <li><a href="http://jakarta.apache.org/tomcat/index.html">Apache Jakarta-Tomcat</a>
81 932 jones
       <p class="emphasis">Note: For a more robust web serving environment,
82
       Apache web server should
83 878 berkley
       be installed along with Tomcat and the two should be integrated
84
       as described on the Apache web site.</p>
85
     </li>
86
   </ul>
87
  </p>
88
</td>
89
</tr>
90
</table>
91
92
<table class="tabledefault" width="100%">
93
<td class="tablehead" colspan="2"><p>Aditional Software Setup</p></td>
94
<tr>
95
<td>
96 2182 jones
  <p class="header">Java</p>
97 2302 costa
  <p>You'll need a recent Java SDK; j2sdk1.4.2 or later is required.  We haven't
98 2182 jones
  tested with any of the 1.5.x versions yet, so probably best to stay with 1.4.x.
99
  Make sure that JAVA_HOME environment variable is properly set and that both
100
  java and javac are on your PATH.
101
  </p>
102
  <p class="header">Oracle 8i or Postgres</p>
103
  <p><i>Oracle:</i><br>
104 878 berkley
   The Oracle RDBMS must be installed and running as a daemon on the system.
105
   In addition the JDBC listener must be enabled.  You can enable it by
106
   logging in as your Oracle user and typing the following:
107
   <pre>lsnrctl start</pre>
108
   Your instance should have a table space of at least 5 MB (10 MB or higher
109
   recommended).  You should also have a username specific to Metacat
110
   created and enabled.  This user must have most normal permissions
111
   including CREATE SESSION, CREATE TABLE, CREATE INDEX, CREATE TRIGGER,
112
   EXECUTE PROCEDURE, EXECUTE TYPE, etc.  If an action is unexplainably
113
   rejected by Metacat it is probably because the user permissions are not
114
   correctly set.
115
  </p>
116 2182 jones
  <p><i>Postgres:</i><br>
117
  Postgres can be easily installed on most linux distributions and on
118
  Windows (using cygwin) and Mac OS X.  Using Fedora Core or RedHat Linux,
119
  you can install the rpms for postgres and then run
120
  <code>/etc/init.d/postgresql start</code> in order to start the database.
121
  This initializes the data files.  You need to do a bit of configuration
122
  to create a database and set up a user account and allow internet access
123
  via jdbc.  See the postgres documentation for this, but here is a quick
124
  start:
125
  <ul>
126
     <li>Switch to the "postgres" user account and edit "data/pg_hba.conf", adding the following line to the file:<br>
127
     <code>host   metacat  metacat      127.0.0.1         255.255.255.255   password</code></li>
128
     <li>Edit the "data/postgres.conf" file and uncomment and edit the line
129
     starting with "tcpip_socket" so that it reads
130
     <code>tcpip_socket = true</code></li>
131
     <li>Run <code>createdb metacat</code> to create a new database</li>
132
     <li>Run <code>psql metacat</code> to log in using the postgres account and create a new "metacat" user account
133
     <ul>
134
        <li>In postgres, run <code>CREATE USER metacat WITH UNENCRYPTED PASSWORD 'apasswordyoulike';</code></li>
135
        <li>This creates a new account called metacat on the database named metacat</li>
136
        <li>Note: there are many ways to do this, so others such as using
137
        ENCRYPTED passwords will work fine.</li>
138
     </ul>
139
     </li>
140
     <li>Exit the postgres account back to root and restart the postgres
141
     database with <code>/etc/init.d/postgresql restart</code></li>
142
     <li>Test logging into the postgres db using the metacat account with
143
     the following command:
144
     <code>psql -U metacat -W -h localhost metacat</code></li>
145
  </ul>
146
  </p>
147 878 berkley
  <p class="header">Ant</p>
148
  <p>
149
   Ant is a Java based build application similar to Make on UNIX systems.
150
   It takes in installation parameters from a file in the root installation
151
   directory named "build.xml".  The Metacat CVS module contains a default
152
   build.xml file that may require some modification upon installation.  Ant
153 932 jones
   should be installed on the system and the "ant" executable shell script
154 2182 jones
   should be available in the users path. We note that the current build is
155
   not working with Ant 1.6.x, so you'll need to use an earler version.  We have
156
   successfully used Ant 1.5.1, 1.5.2, and some earlier versions.
157 878 berkley
  </p>
158
  <p class="header">Tomcat</p>
159
  <p>
160 2302 costa
    Install Tomcat into the directory of your choice. The directory in which
161 1770 tao
    you install Tomcat itself will be referred to as the "$CATALINA_HOME".
162 2302 costa
    We recommend that you install Tomcat version 4.0.  More details about
163
    Tomcat installation is available <a href=" http://jakarta.apache.org/tomcat/index.html">here</a>.
164 878 berkley
  </p>
165 1770 tao
 </td>
166 878 berkley
</tr>
167
</table>
168
169
<table class="tabledefault" width="100%">
170 1770 tao
<td class="tablehead" colspan="2"></td>
171 878 berkley
<tr>
172
<td>
173
  <p>
174
   Once all of the prerequisite software is installed as described above,
175
   the installation of Metacat can begin.  First you must have a current
176
   version of the source distribution of Metacat.  You can get it two ways.
177
   Authorized users can check it out of the NCEAS
178
   <a href="http://www.nceas.ucsb.edu/cgi-bin/cvsweb.cgi/xmltodb/">CVS</a>
179 2183 jones
   system. You'll need both the "metacat" module and the "utilities" module to
180
   be checked out in sibling directories. The command is as follows:
181
   <pre>mkdir knb-software</pre>
182
   <pre>cd knb-software</pre>
183
   <pre>cvs checkout -P metacat</pre>
184
   <pre>cvs checkout -P utilities</pre>
185
   Or you can
186 878 berkley
   <a href="@server@/software/download.html">download</a> a gzipped tar file
187
   from this site.
188
  </p>
189 2302 costa
  <p><h2>Edit <code>build.properties</code> File</h2></p>
190 878 berkley
  <p>
191
   Once you have either checked out or unzipped and untarred the source
192
   distribution, you can begin the installation process.  Change into the
193 2302 costa
   metacat directory and edit the file called "<code>build.properties</code>".  You will need
194 932 jones
   to change a number of configuration properties to match the setup on
195 2302 costa
   your system.
196 878 berkley
  </p>
197
  <p>
198 2302 costa
  The properties that you will likely need to change will include
199
  <code>tomcat</code>, <code>tomcatversion</code>, <code>webapps</code>,
200
  <code>context</code>, <code>server</code>, <code>httpserver</code>,
201
  <code>database</code>, <code>jdbc-connect</code>, <code>jdbc-base</code>,
202
  <code>user</code>, <code>password</code>, <code>datafilepath</code>,
203
  <code>inlinedatafilepath</code>, <code>cvsroot</code>,
204
  <code>cvsroot-alternate</code>, and <code>default-style</code>.
205
  Each is described in detail in the table below.
206 878 berkley
  </p>
207 2302 costa
  Properties you will likely need to change:
208
  <br><br>
209
  <table border="1">
210
    <tr>
211
      <td><b>Property</b></td>
212
      <td><b>Description</b></td>
213
      <td><b>Default value and examples of other values</b></td>
214
    </tr>
215
    <tr>
216
      <td>tomcat</td>
217
      <td>The tomcat property is the location in which tomcat is installed.</td>
218
      <td>Default:&nbsp;&nbsp;
219
          <code>/usr/local/devtools/jakarta-tomcat</code>
220
      <br><br>Example:&nbsp;&nbsp;
221
          <code>C:/Tomcat4</code></td>
222
    </tr>
223
    <tr>
224
      <td>tomcatversion</td>
225
      <td>The tomcatversion property is the version of your Tomcat. You should
226
          put tomcat3 or tomcat4 here.</td>
227
      <td>Default:&nbsp;&nbsp;
228
          <code>tomcat4</code>
229
      <br><br>Example:&nbsp;&nbsp;
230
          <code>tomcat3</code>
231
      </td>
232
    </tr>
233
    <tr>
234
      <td>webapps</td>
235
      <td>The webapps property is the location in which your tomcat servlet
236
          contexts are installed. This is typically "TOMCAT_HOME/webapps",
237
          where TOMCAT_HOME is the same value that you entered for the 'tomcat'
238
          property above.
239
      </td>
240
      <td>Default:&nbsp;&nbsp;
241
          <code>/var/www/org.ecoinformatics.knb</code>
242
      <br><br>Example:&nbsp;&nbsp;
243
          <code>C:/Tomcat4/webapps</code>
244
      </td>
245
    </tr>
246
    <tr>
247
      <td>context</td>
248
      <td>The context property is the name of the servlet context in which you
249
          want Metacat to be installed. This will determine the installation
250
          directory for the servlet and many of the URLs that are used to access
251
          the installed Metacat server.</td>
252
      <td>Default:&nbsp;&nbsp;
253
          <code>knb</code>
254
      <br><br>Example:&nbsp;&nbsp;
255
          <code>mycontext</code>
256
      </td>
257
    </tr>
258
    <tr>
259
      <td>server</td>
260
      <td>The server property is the secure HTTPS address on which Metacat is
261
          running (note that you should not include the 'http://' in the server
262
          property). The server setting should include the SSL port number
263
          appended to the end if Tomcat is running stand-alone (see example).</td>
264
      <td>Default:&nbsp;&nbsp;
265
         <code>knb.ecoinformatics.org</code>
266
      <br><br>Example:&nbsp;&nbsp;
267
         <code>somehost.university.edu:8443</code>
268
      </td>
269
    </tr>
270
    <tr>
271
      <td>httpserver</td>
272
      <td>httpserver is the plain HTTP address on which Metacat is running
273
          (note that you should not include the 'http://' in the httpserver property).
274
          The httpserver setting should include the HTTP plain port number
275
          appended to the end if Tomcat is running stand-alone (see example).</td>
276
      <td>Default:&nbsp;&nbsp;
277
          <code>knb.ecoinformatics.org</code>
278
      <br><br>Example:&nbsp;&nbsp;
279
          <code>somehost.university.edu:8080</code>
280
      </td>
281
    </tr>
282
    <tr>
283
      <td>ldapUrl</td>
284
      <td>URL to the LDAP server</td>
285
      <td>Default:&nbsp;&nbsp;
286
          <code>ldap://ldap.ecoinformatics.org/dc=ecoinformatics,dc=org</code>
287
      </td>
288
    </tr>
289
    <tr>
290
      <td>database</td>
291
      <td>Select the database to use for metadata storage.
292
          Valid values are <code>oracle</code>, <code>postgresql</code>, or
293
          <code>sqlserver</code>.
294
      </td>
295
      <td>Default:&nbsp;&nbsp;
296
          <code>oracle</code>
297
      <br><br>Other possible values:&nbsp;&nbsp;
298
          <code>postgresql</code>&nbsp;&nbsp;
299
          <code>sqlserver</code>
300
      </td>
301
    </tr>
302
    <tr>
303
      <td>jdbc-connect</td>
304
      <td>The JDBC connection string used to connect to the database.</td>
305
      <td>Default:&nbsp;&nbsp;
306
          <code>jdbc:oracle:thin:@metacat.nceas.ucsb.edu:1521:knb</code>
307
      </td>
308
    <tr>
309
      <td>jdbc-base</td>
310
      <td>The base directory for locating JDBC jar files (not needed for postgresql).</td>
311
      <td>Default:&nbsp;&nbsp;
312
          <code>/usr/oracle/jdbc/lib</code>
313
      <br><br>Example:&nbsp;&nbsp;
314
          <code>C:/jdev10g/jdbc/lib</code><br>
315
      </td>
316
    </tr>
317
    <tr>
318
      <td>user</td>
319
      <td>The database user name that you set up to use Metacat. For example,
320
          an Oracle username.</td>
321
      <td>Default:&nbsp;&nbsp;
322
          <code>knb</code>
323
      <br><br>Example:&nbsp;&nbsp;
324
          <code>metacatdb</code>
325
      </td>
326
    </tr>
327
    <tr>
328
      <td>password</td>
329
      <td>The database password that you set up to use Metacat.</td>
330
      <td>Default:&nbsp;&nbsp;
331
          <code>yourPasswordHere</code>
332
      <br><br>Example:&nbsp;&nbsp;
333
          <code>metacat123</code>
334
      </td>
335
    </tr>
336
    <tr>
337
      <td>datafilepath</td>
338
      <td>The datafilepath is the directory to store the data file.</td>
339
      <td>Default:&nbsp;&nbsp;
340
          <code>/var/metacat/data</code>
341
      <br><br>Example:&nbsp;&nbsp;
342
          <code>C:/Tomcat4/data/knb/data</code>
343
      </td>
344
    </tr>
345
    <tr>
346
      <td>inlinedatafilepath</td>
347
      <td>The inlinedatafilepath is the directory to store inline data.</td>
348
      <td>Default:&nbsp;&nbsp;
349
          <code>/var/metacat/inline-data</code>
350
      <br><br>Example:&nbsp;&nbsp;
351
          <code>C:/Tomcat4/data/knb/inlinedata</code>
352
      </td>
353
    </tr>
354
    <tr>
355
      <td>cvsroot</td>
356
      <td>CVS access to retrieve latest EML.</td>
357
      <td>Default:&nbsp;&nbsp;
358
          <code><pre>:ext:${env.USER}@cvs.ecoinformatics.org:/cvs</pre></code>
359
          Example:&nbsp;&nbsp;
360
          <code><pre>:ext:myaccount@cvs.ecoinformatics.org:/cvs</pre></code>
361
      </td>
362
    </tr>
363
    <tr>
364
      <td>cvsroot-alternate</td>
365
      <td>CVS access to retrieve latest conversion styles.</td>
366
      <td>Default:&nbsp;&nbsp;
367
          <code><pre>:ext:${env.USER}@cvs.nceas.ucsb.edu:/cvs/pbi</pre></code>
368
          Example:&nbsp;&nbsp;
369
          <code><pre>:ext:myaccount@cvs.nceas.ucsb.edu:/cvs/pbi</pre></code>
370
      </td>
371
    </tr>
372
    <tr>
373
      <td>default-style</td>
374
      <td>The default-style parameter defines the "style-set" that is to be used
375
          by default when the qformat parameter is missing or set to "html"
376
          during a query. It is set to "knb", which is one of the styles that
377
          ships with the default metacat distribution. Other possible settings
378
          are shown in the examples to the right.</td>
379
      <td>Default:&nbsp;&nbsp;
380
          <code>knb</code>
381
      <br><br>Examples:&nbsp;&nbsp;
382
          <pre><code>default   esa   knb2   nceas   nrs   obfs   specnet</code></pre>
383
      </td>
384
    </tr>
385
  </table>
386
  <br>
387 989 berkley
  <p>
388
   Note that the build file is preconfigured to install Metacat either using
389 2302 costa
   Oracle, PostgreSQL, or Microsoft SQL Server as a backend database.
390
   To change the database system, simply change the value of the 'database'
391
   property to be the name of the database target that you wish to use
392
   (either 'oracle', 'postgresql', or 'sqlserver').
393 989 berkley
  </p>
394 2302 costa
  Other properties in <code>build.properties</code> that you can (but generally need not) change:<br />
395
  <br>
396
  <table border="1">
397
    <tr>
398
      <td><b>Property</b></td>
399
      <td><b>Description</b></td>
400
      <td><b>Default value and examples of other values</b></td>
401
    </tr>
402
    <tr>
403
      <td>inst.cgi.dir</td>
404
      <td>Installation directory for registry CGI scripts</td>
405
      <td>Default:&nbsp;&nbsp;
406
          <code>/var/www/cgi-knb</code>
407
      </td>
408
    </tr>
409
    <tr>
410
      <td>cgi-prefix</td>
411
      <td>&nbsp;</td>
412
      <td>Default:&nbsp;&nbsp;
413
          <code>http://knb.ecoinformatics.org/cgi-bin</code>
414
      </td>
415
    </tr>
416
    <tr>
417
      <td>knb-site-url</td>
418
      <td>This is the URL to the web context root for the knb site.
419
          It is used for the qformat=knb skin only.</td>
420
      <td>Default:&nbsp;&nbsp;
421
          <code>http://knb.ecoinformatics.org</code>
422
      </td>
423
    </tr>
424
    <tr>
425
      <td>forcereplicationwaitingtime</td>
426
      <td>The waiting time before replication is forced to begin after
427
          uploading a package. The default value should usually suffice.</td>
428
      <td>Default:&nbsp;&nbsp;
429
          <code>30000</code>
430
          <code>&nbsp;</code>
431
      </td>
432
    </tr>
433
  </table>
434
  <p>
435
  Metacat has a number of additional settable properties in file
436
  <code>metacat/lib/metacat.properties</code>. Under most circumstances,
437
  you will not need to modify this file because the properties of interest
438
  to you can be controlled by editing <code>build.properties</code> as
439
  described above. To learn more about Metacat's additional properties,
440
  see <a href="./properties.html">Metacat Properties File</a>.
441
  </p>
442 878 berkley
  <p class="emphasis">
443 2302 costa
   Note: When setting properties, DO NOT add a trailing slash [/] to the end of any paths that are specified.
444
   Metacat will not function correctly if you do so.
445 878 berkley
  </p>
446 1770 tao
  <p class="header"><h2>SQL Scripts</h2></p>
447 878 berkley
  <p>
448 1827 jones
   You now need to set up the table structure in your database.  You can do
449
   either do this using the ant build system, or by manually running the
450
   scripts using a sql utility.
451
  </p>
452 2182 jones
  <p><b>WARNING: Do NOT run this on an existing metacat installation as it
453
  will delete all of your data.  If you have an existing metacat installation,
454
  see the instructions for "Upgrading" below.</b></p>
455
456
  <p>To run the scripts using ant, type <code>ant installdb</code>.  This does
457
  not work for postgres, so you'll need to run the xmltables-postgres.sql script
458
  manually (see next paragraph).
459 1827 jones
  </p>
460
  <p>To run the scripts manually, change to the
461 2302 costa
   metacat/build/src directory.  Then run you RDBMS's SQL utility.  In Oracle it is
462 878 berkley
   SQLPlus.  This tutorial assumes an Oracle database so this example is for
463
   SQLPlus.  Login as the oracle user that was set up for use with Metacat.
464 1770 tao
   At the SQLPlus prompt type the following: <pre><b>@xmltables.sql;</b></pre>
465 2182 jones
   For postgres, use a command like:
466
   <code>psql -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat</code>
467 1827 jones
  </p>
468
  <p>Either way,
469
   you should see a bunch of output showing the creation of the Metacat table
470 878 berkley
   space. The first time you run this script you will get several errors at the
471
   beginning saying that you cannot drop a table/index/trigger because it
472
   does not exist.  This is normal.  Any other errors besides this need to be
473 1770 tao
   resolved before continuing. The script file name for PostgreSQL is
474 2302 costa
   xmltables-postgres.sql and for Microsoft SQL server is
475 1827 jones
   xmltables-sqlserver.sql.
476 878 berkley
  </p>
477
  <p>
478
   If the script has run correctly you should be able to type
479
   <pre>describe xml_documents</pre> and it should tell you
480
   <pre>
481
    Name            Null?         Type
482
    --------------  ------------  ----------------
483
     DOCID          NOT NULL      VARCHAR2(250)
484
     ROOTNODEID                   NUMBER(20)
485
     DOCNAME                      VARCHAR2(100)
486
     DOCTYPE                      VARCHAR2(100)
487
     DOCTITLE                     VARCHAR2(1000)
488
     USER_OWNER                   VARCHAR2(100)
489
     USER_UPDATED                 VARCHAR2(100)
490
     SERVER_LOCATION              NUMBER(20)
491
     REV                          NUMBER(10)
492
     DATE_CREATED                 DATE
493
     DATE_UPDATED                 DATE
494
     PUBLIC_ACCESS                NUMBER(1)
495
     UPDATED                      NUMBER(1)
496
   </pre>
497
  </p>
498 1827 jones
  <p class="header"><h2>Upgrading SQL Scripts</h2></p>
499
  <p>
500
    If you have an existing metacat installation, you should not run the install
501
    script because it will replace all of the older tables with new, empty
502
    copies of the tables.  Thus you would lose your data!  Instead, you can
503
    run some upgrade scripts that will change the table structure as needed for
504
    the new version.  If you are skipping versions, run each upgrade script
505
    for the intermediate versions as well.  Currently the upgrade scripts are:
506
   </p>
507
    <ul>
508
      <li>upgrade-db-to-1.2.sql</li>
509
      <li>upgrade-db-to-1.3.sql</li>
510 2182 jones
      <li>upgrade-db-to-1.4.sql</li>
511 1827 jones
    </ul>
512
   <p>
513
    So, if you had an existing metacat 1.0 installation and you were upgrading
514 2302 costa
    to 1.4, you would need to run all three scripts in sequence:
515
    upgrade-db-to-1.2.sql, upgrade-db-to-1.3.sql, and upgrade-db-to-1.4.sql.
516
    However, if you were starting from a Metacat 1.3.x
517
    installation, you would only need to run the upgrade-db-to-1.4.sql script.
518 1827 jones
   </p>
519
  </p>
520 878 berkley
</td>
521
</tr>
522
</table>
523
524
<table class="tabledefault" width="100%">
525 1770 tao
<td class="tablehead" colspan="2"><p><h2>Compilation and Installation</h2></p></td>
526 878 berkley
<tr>
527
<td>
528
  <a name="protocol"></a>
529
  <p>
530 1627 tao
   Ant allows compilation and installation to be done in one step.
531
   Change into the metacat directory and type:
532 2182 jones
   <pre><b>ant geteml install</b></pre>
533
   or, if you are upgrading an existing installation, type:
534 2302 costa
   <pre><b>ant clean geteml upgrade</b></pre>
535 1770 tao
   <p>
536 878 berkley
   You should see a bunch of messages telling you the progress of compilation
537 932 jones
   and installation.  When it is done you should see the message
538
   BUILD SUCCESSFUL
539 878 berkley
   and you should be returned to a UNIX command prompt.  If you do not see
540 932 jones
   the message BUILD SUCCESSFUL then there was an error that you need to
541
   resolve.
542 878 berkley
   This may come up if you are logged in as a user that does not have write
543
   access to one or more of the directories that are listed in the build.xml
544 932 jones
   file, or if any of the paths to files are not configured correctly in the
545
   "config" target.
546 878 berkley
  </p>
547 883 jones
  <p>Once metacat itself is installed, you should also register
548 1627 tao
  the Ecological Metadata Language (EML) DTDs and schemas. This process is done most
549 1770 tao
  easily by running:</p>
550
  <pre><b>ant dtdschemasql</b></pre>
551
  <p>This command registers the DTDs' and schemas' location in the
552 880 jones
  metacat server.  Your database username and password have to be set correctly
553
  for this to work.
554 990 tao
  </p>
555 878 berkley
  <p>
556 994 berkley
  Note: The 'data' directory in the installation directory must be writeable
557
  by whatever user is running Tomcat or you will not be able to upload data
558
  files to the system.
559 1770 tao
  <h2>Restart Tomcat</h2>
560 990 tao
  <p>
561 878 berkley
   Once you have successfully installed Metacat, there is one more step.  Tomcat
562
   (and Apache if you have Tomcat integrated with it) must be restarted.  To do
563 1770 tao
   this, login as the user that runs your tomcat server (often "tomcat"),
564
   go to $CATALINA_HOME/bin and type:
565 878 berkley
   <pre>
566 1770 tao
   ./shutdown.sh
567
   ./startup.sh
568 878 berkley
   </pre>
569 1770 tao
   In the Tomcat startup messages you should see something in log file like:
570 878 berkley
   <pre>
571
    MetacatServlet Initialize
572
    Context log path="/metadata" :Metacat: init
573
    MetacatServlet Initialize
574
   </pre>
575
   If you see that message Tomcat is successfully loading the Metacat servlet.
576
   Next, try to run your new servlet.  Go to a web browser and type:
577 932 jones
   <pre>http://yourserver.yourdomain.com/yourcontext/</pre>
578
   You should substitute your context name for "yourcontext" in the url above.
579 878 berkley
   If everything is working correctly, you should see a query page followed
580 880 jones
   by an empty result set.  Note that if you do not have Tomcat integrated with
581 878 berkley
   Apache you will probably have to type
582 932 jones
   <pre>http://yourserver.yourdomain.com:8080/yourcontext/</pre>
583 878 berkley
  </p>
584
</td>
585
</tr>
586
</table>
587
588
</body>
589
</html>