Revision 6925
Added by ben leinfelder almost 13 years ago
| docs/user/metacat/source/install.rst | ||
|---|---|---|
| 83 | 83 |
Downloading the Metacat Installer is the simplest way to get started with the |
| 84 | 84 |
application. To download the installer: |
| 85 | 85 |
|
| 86 |
1. Browse to the `Metacat Download Page`_. In the Metacat section, select the link to the "GZIP file" (the link should look like: metacat-bin-X.X.X.tar.gz, where X.X.X is the latest version of Metacat e.g., 1.9.0)
|
|
| 86 |
1. Browse to the `Metacat Download Page`_. In the Metacat section, select the link to the "GZIP file" (the link should look like: metacat-bin-X.X.X.tar.gz, where X.X.X is the latest version of Metacat e.g., 2.0.0)
|
|
| 87 | 87 |
2. Save the file locally. |
| 88 | 88 |
3. Extract the Metacat package files by typing: |
| 89 | 89 |
|
| ... | ... | |
| 91 | 91 |
|
| 92 | 92 |
tar -xvzf metacat-bin-X.X.X.tar.gz |
| 93 | 93 |
|
| 94 |
You should see a WAR file and several supporting files (Table 2.1). The |
|
| 94 |
You should see a WAR file and several sample supporting files (Table 2.1). The
|
|
| 95 | 95 |
extraction location will be referred to as the ``<metacat_package_dir>`` for the |
| 96 | 96 |
remainder of this documentation. |
| 97 | 97 |
|
| ... | ... | |
| 99 | 99 |
File Description |
| 100 | 100 |
================== =========================================================== |
| 101 | 101 |
knb.war The Metacat Web archive file (WAR) |
| 102 |
knb The Web definition file used by Apache on Ubuntu/Debian
|
|
| 102 |
knb Sample Web definition file used by Apache on Ubuntu/Debian
|
|
| 103 | 103 |
Linux systems. |
| 104 |
knb.ssl The SSL definition file used by Apache on Ubuntu/Debian
|
|
| 104 |
knb.ssl Sample SSL definition file used by Apache on Ubuntu/Debian
|
|
| 105 | 105 |
Linux systems. |
| 106 |
jk.conf The JkMount configuration file used by Apache on
|
|
| 106 |
jk.conf Sample JkMount configuration file used by Apache on
|
|
| 107 | 107 |
Ubuntu/Debian Linux systems. |
| 108 |
workers.properties The workers definition file used by Apache on Ubuntu/Debian
|
|
| 108 |
workers.properties Sample workers definition file used by Apache on Ubuntu/Debian
|
|
| 109 | 109 |
Linux systems. |
| 110 |
authority The optional LSID Server application WAR
|
|
| 110 |
authority.war The optional LSID Server application WAR
|
|
| 111 | 111 |
================== =========================================================== |
| 112 | 112 |
|
| 113 | 113 |
|
| ... | ... | |
| 115 | 115 |
............................ |
| 116 | 116 |
To get the Metacat source distribution: |
| 117 | 117 |
|
| 118 |
1. Browse to the `Metacat Download Page`_. In the Metacat section, select the link to the Metacat Source code (it will look something like this: metacat-src-X.X.X.tar.gz, where X.X.X is the latest version of Metacat, e.g., 1.9.0).
|
|
| 118 |
1. Browse to the `Metacat Download Page`_. In the Metacat section, select the link to the Metacat Source code (it will look something like this: metacat-src-X.X.X.tar.gz, where X.X.X is the latest version of Metacat, e.g., 2.0.0).
|
|
| 119 | 119 |
2. Save the file locally. |
| 120 | 120 |
3. Extract the Metacat package files by typing (replace X.X.X with the current version number): |
| 121 | 121 |
|
| ... | ... | |
| 154 | 154 |
|
| 155 | 155 |
svn co https://code.ecoinformatics.org/code/metacat/tags/METACAT_<rev> metacat |
| 156 | 156 |
|
| 157 |
Where ``<rev>`` is the version of the code you want to check out (like 1_9).
|
|
| 157 |
Where ``<rev>`` is the version of the code you want to check out (like 2_0_0).
|
|
| 158 | 158 |
|
| 159 | 159 |
To check out the head, type:: |
| 160 | 160 |
|
| ... | ... | |
| 169 | 169 |
Installing and Configuring Required Software |
| 170 | 170 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 171 | 171 |
Before you can install and run Metacat, you must ensure that a recent Java SDK, |
| 172 |
PostgreSQL (or another SQL92-compliant RDBMS like Oracle 8i), Ant (if
|
|
| 172 |
PostgreSQL (or another SQL92-compliant RDBMS like Oracle), Ant (if |
|
| 173 | 173 |
installing from source), and Tomcat are installed and running correctly. We |
| 174 | 174 |
also highly recommend that you install Apache Web server, as it provides a more |
| 175 | 175 |
robust Web-serving environment and is required by some Metacat functionality. |
| ... | ... | |
| 217 | 217 |
Although you have the option of running Metacat with only the Tomcat server, we |
| 218 | 218 |
highly recommend that you run it behind the Apache Web server for several |
| 219 | 219 |
reasons; running Tomcat with the Apache server provides a more robust Web |
| 220 |
serving environment, and the Apache Web server is required if you wish to
|
|
| 221 |
install and run the Metacat Registry. |
|
| 220 |
serving environment. The Apache Web server is required if you wish to
|
|
| 221 |
install and run the Metacat Registry or to use the Metacat Replication feature.
|
|
| 222 | 222 |
|
| 223 | 223 |
.. sidebar:: Configuring Apache on an OS other than Ubuntu/Debian |
| 224 | 224 |
|
Also available in: Unified diff
make it clear that the Apache config files are samples and may need to be modified for different servers
http://bugzilla.ecoinformatics.org/show_bug.cgi?id=5516