cdocutils.nodes document q)q}q(U nametypesq}q(X"downloading and installing metacatqNXsource install and upgradeqNXupgrade metacatqNXpostgresql databaseq NXinstalling on windowsq NXtroubleshootingq NX apache tomcatq X(to install the lsid server from a sourceq NXcontentsqNXupgradeqNX$apache ant (if building from source)qNXdownload metacatqNXinstalling metacatqNXdownload metacat source codeqNXsystem requirementsqNXinstalling on linuxqNXquick start overviewqNX,installing and configuring required softwareqNXmetacat download pageqX(apache httpd server (highly recommended)qNXdownloading metacatqNXubuntuqX new installqNXinstall required softwareqNX+optional installation options (lsid server)qNXdoiqX postgresqlq Xapache httpd serverq!X:install and configure the lsid server shipped with metacatq"NX apache antq#Xoracleq$X3download the metacat installer (highly recommended)q%NX:check out metacat source code from github (for developers)q&NXjava 8q'uUsubstitution_defsq(}q)Uparse_messagesq*]q+(cdocutils.nodes system_message q,)q-}q.(U rawsourceq/UUparentq0cdocutils.nodes section q1)q2}q3(h/Uh0h1)q4}q5(h/Uh0h1)q6}q7(h/Uh0h1)q8}q9(h/Uh0hUsourceq:XU/var/lib/jenkins/jobs/metacat-unstable/workspace/docs/user/metacat/source/install.rstq;Utagnameq}q?(Udupnamesq@]UclassesqA]UbackrefsqB]UidsqC]qDU"downloading-and-installing-metacatqEaUnamesqF]qGhauUlineqHKUdocumentqIhUchildrenqJ]qK(cdocutils.nodes title qL)qM}qN(h/X"Downloading and Installing MetacatqOh0h8h:h;h}qQ(hC]hB]h@]hA]hF]UrefidqRUid9qSuhHKhIhhJ]qTcdocutils.nodes Text qUX"Downloading and Installing MetacatqVqW}qX(h/hOh0hMubaubcdocutils.nodes paragraph qY)qZ}q[(h/XMInstructions for both Linux and Windows systems are included in this section.q\h0h8h:h;h}q^(h@]hA]hB]hC]hF]uhHKhIhhJ]q_hUXMInstructions for both Linux and Windows systems are included in this section.q`qa}qb(h/h\h0hZubaubcdocutils.nodes topic qc)qd}qe(h/Uh0h8h:h;h}qg(h@]hA]qhUcontentsqiahB]hC]qjUcontentsqkahF]qlhauhHKhIhhJ]qm(hL)qn}qo(h/XContentsh0hdh:h;h}qp(h@]hA]hB]hC]hF]uhHKhJ]qqhUXContentsqrqs}qt(h/Uh0hnubaubcdocutils.nodes bullet_list qu)qv}qw(h/Uh0hdh:Nh}qy(h@]hA]hB]hC]hF]uhHNhIhhJ]qzcdocutils.nodes list_item q{)q|}q}(h/Uh>}q~(h@]hA]hB]hC]hF]uh0hvhJ]q(hY)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0h|hJ]qcdocutils.nodes reference q)q}q(h/Uh>}q(hC]qhSahB]h@]hA]hF]UrefidhEuh0hhJ]qhUX"Downloading and Installing Metacatqq}q(h/hOh0hubah}q(h@]hA]hB]hC]hF]uh0h|hJ]q(h{)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0hhJ]qhY)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0hhJ]qh)q}q(h/Uh>}q(hC]qUid10qahB]h@]hA]hF]UrefidUsystem-requirementsquh0hhJ]qhUXSystem Requirementsqq}q(h/XSystem Requirementsqh0hubah}q(h@]hA]hB]hC]hF]uh0hhJ]q(hY)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0hhJ]qh)q}q(h/Uh>}q(hC]qUid11qahB]h@]hA]hF]UrefidUinstalling-on-linuxquh0hhJ]qhUXInstalling on Linuxqq}q(h/XInstalling on Linuxqh0hubah}q(h@]hA]hB]hC]hF]uh0hhJ]q(h{)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0hhJ]qhY)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0hhJ]qh)q}q(h/Uh>}q(hC]qUid12qahB]h@]hA]hF]UrefidUquick-start-overviewquh0hhJ]qhUXQuick Start Overviewq̅q}q(h/XQuick Start Overviewqh0hubah}q(h@]hA]hB]hC]hF]uh0hhJ]q(hY)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0hhJ]qh)q}q(h/Uh>}q(hC]qUid13qahB]h@]hA]hF]UrefidUdownloading-metacatquh0hhJ]qhUXDownloading Metacatq߅q}q(h/XDownloading Metacatqh0hubah}q(h@]hA]hB]hC]hF]uh0hhJ]q(h{)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0hhJ]qhY)q}q(h/Uh>}q(h@]hA]hB]hC]hF]uh0hhJ]qh)q}q(h/Uh>}q(hC]qUid14qahB]h@]hA]hF]UrefidU1download-the-metacat-installer-highly-recommendedquh0hhJ]qhUX3Download the Metacat Installer (Highly Recommended)qq}q(h/X3Download the Metacat Installer (Highly Recommended)qh0hubah}q(h@]hA]hB]hC]hF]uh0hhJ]qhY)q}q(h/Uh>}r(h@]hA]hB]hC]hF]uh0hhJ]rh)r}r(h/Uh>}r(hC]rUid15rahB]h@]hA]hF]UrefidUdownload-metacat-source-coderuh0hhJ]rhUXDownload Metacat Source Coder r }r (h/XDownload Metacat Source Coder h0jubah}r(h@]hA]hB]hC]hF]uh0hhJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0j hJ]rh)r}r(h/Uh>}r(hC]rUid16rahB]h@]hA]hF]UrefidU8check-out-metacat-source-code-from-github-for-developersruh0jhJ]rhUX:Check Out Metacat Source Code from GitHub (for Developers)rr}r(h/X:Check Out Metacat Source Code from GitHub (for Developers)rh0jubah}r"(h@]hA]hB]hC]hF]uh0hhJ]r#(hY)r$}r%(h/Uh>}r&(h@]hA]hB]hC]hF]uh0j hJ]r'h)r(}r)(h/Uh>}r*(hC]r+Uid17r,ahB]h@]hA]hF]UrefidU,installing-and-configuring-required-softwarer-uh0j$hJ]r.hUX,Installing and Configuring Required Softwarer/r0}r1(h/X,Installing and Configuring Required Softwarer2h0j(ubah}r5(h@]hA]hB]hC]hF]uh0j hJ]r6(h{)r7}r8(h/Uh>}r9(h@]hA]hB]hC]hF]uh0j3hJ]r:hY)r;}r<(h/Uh>}r=(h@]hA]hB]hC]hF]uh0j7hJ]r>h)r?}r@(h/Uh>}rA(hC]rBUid18rCahB]h@]hA]hF]UrefidUid1rDuh0j;hJ]rEhUXJava 8rFrG}rH(h/XJava 8rIh0j?ubah}rL(h@]hA]hB]hC]hF]uh0j3hJ]rMhY)rN}rO(h/Uh>}rP(h@]hA]hB]hC]hF]uh0jJhJ]rQh)rR}rS(h/Uh>}rT(hC]rUUid19rVahB]h@]hA]hF]UrefidUid2rWuh0jNhJ]rXhUX Apache TomcatrYrZ}r[(h/X Apache Tomcatr\h0jRubah}r_(h@]hA]hB]hC]hF]uh0j3hJ]r`hY)ra}rb(h/Uh>}rc(h@]hA]hB]hC]hF]uh0j]hJ]rdh)re}rf(h/Uh>}rg(hC]rhUid20riahB]h@]hA]hF]UrefidU&apache-httpd-server-highly-recommendedrjuh0jahJ]rkhUX(Apache HTTPD Server (Highly Recommended)rlrm}rn(h/X(Apache HTTPD Server (Highly Recommended)roh0jeubah}rr(h@]hA]hB]hC]hF]uh0j3hJ]rshY)rt}ru(h/Uh>}rv(h@]hA]hB]hC]hF]uh0jphJ]rwh)rx}ry(h/Uh>}rz(hC]r{Uid21r|ahB]h@]hA]hF]UrefidUpostgresql-databaser}uh0jthJ]r~hUXPostgreSQL Databaserr}r(h/XPostgreSQL Databaserh0jxubah}r(h@]hA]hB]hC]hF]uh0j3hJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid22rahB]h@]hA]hF]UrefidU"apache-ant-if-building-from-sourceruh0jhJ]rhUX$Apache Ant (if building from Source)rr}r(h/X$Apache Ant (if building from Source)rh0jubah}r(h@]hA]hB]hC]hF]uh0hhJ]r(hY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid23rahB]h@]hA]hF]UrefidUinstalling-metacatruh0jhJ]rhUXInstalling Metacatrr}r(h/XInstalling Metacatrh0jubah}r(h@]hA]hB]hC]hF]uh0jhJ]r(h{)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid24rahB]h@]hA]hF]UrefidU new-installruh0jhJ]rhUX New Installrr}r(h/X New Installrh0jubah}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid25rahB]h@]hA]hF]UrefidUupgrade-metacatruh0jhJ]rhUXUpgrade Metacatrr}r(h/XUpgrade Metacatrh0jubah}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid26rahB]h@]hA]hF]UrefidUsource-install-and-upgraderuh0jhJ]rhUXSource Install and Upgraderr}r(h/XSource Install and Upgraderh0jubah}r(h@]hA]hB]hC]hF]uh0hhJ]r(hY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid27rahB]h@]hA]hF]UrefidU)optional-installation-options-lsid-serverruh0jhJ]rhUX+Optional Installation Options (LSID Server)rr}r(h/X+Optional Installation Options (LSID Server)rh0jubah}r(h@]hA]hB]hC]hF]uh0jhJ]r(h{)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid28r ahB]h@]hA]hF]UrefidU:install-and-configure-the-lsid-server-shipped-with-metacatr uh0jhJ]r hUX:Install and configure the LSID Server shipped with Metacatr r }r(h/X:Install and configure the LSID Server shipped with Metacatrh0jubah}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid29rahB]h@]hA]hF]UrefidU(to-install-the-lsid-server-from-a-sourceruh0jhJ]rhUX(To install the LSID server from a sourcerr }r!(h/X(To install the LSID server from a sourcer"h0jubah}r%(h@]hA]hB]hC]hF]uh0hhJ]r&hY)r'}r((h/Uh>}r)(h@]hA]hB]hC]hF]uh0j#hJ]r*h)r+}r,(h/Uh>}r-(hC]r.Uid30r/ahB]h@]hA]hF]UrefidUtroubleshootingr0uh0j'hJ]r1hUXTroubleshootingr2r3}r4(h/XTroubleshootingr5h0j+ubah}r8(h@]hA]hB]hC]hF]uh0hhJ]r9(hY)r:}r;(h/Uh>}r<(h@]hA]hB]hC]hF]uh0j6hJ]r=h)r>}r?(h/Uh>}r@(hC]rAUid31rBahB]h@]hA]hF]UrefidUinstalling-on-windowsrCuh0j:hJ]rDhUXInstalling on WindowsrErF}rG(h/XInstalling on WindowsrHh0j>ubah}rK(h@]hA]hB]hC]hF]uh0j6hJ]rL(h{)rM}rN(h/Uh>}rO(h@]hA]hB]hC]hF]uh0jIhJ]rPhY)rQ}rR(h/Uh>}rS(h@]hA]hB]hC]hF]uh0jMhJ]rTh)rU}rV(h/Uh>}rW(hC]rXUid32rYahB]h@]hA]hF]UrefidUdownload-metacatrZuh0jQhJ]r[hUXDownload Metacatr\r]}r^(h/XDownload Metacatr_h0jUubah}rb(h@]hA]hB]hC]hF]uh0jIhJ]rc(hY)rd}re(h/Uh>}rf(h@]hA]hB]hC]hF]uh0j`hJ]rgh)rh}ri(h/Uh>}rj(hC]rkUid33rlahB]h@]hA]hF]UrefidUinstall-required-softwarermuh0jdhJ]rnhUXInstall Required Softwarerorp}rq(h/XInstall Required Softwarerrh0jhubah}ru(h@]hA]hB]hC]hF]uh0j`hJ]rv(h{)rw}rx(h/Uh>}ry(h@]hA]hB]hC]hF]uh0jshJ]rzhY)r{}r|(h/Uh>}r}(h@]hA]hB]hC]hF]uh0jwhJ]r~h)r}r(h/Uh>}r(hC]rUid34rahB]h@]hA]hF]UrefidUid3ruh0j{hJ]rhUXJava 8rr}r(h/XJava 8rh0jubah}r(h@]hA]hB]hC]hF]uh0jshJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid35rahB]h@]hA]hF]UrefidUid4ruh0jhJ]rhUX Apache Tomcatrr}r(h/X Apache Tomcatrh0jubah}r(h@]hA]hB]hC]hF]uh0jshJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid36rahB]h@]hA]hF]UrefidUid5ruh0jhJ]rhUXPostgreSQL Databaserr}r(h/XPostgreSQL Databaserh0jubah}r(h@]hA]hB]hC]hF]uh0jIhJ]r(hY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid37rahB]h@]hA]hF]UrefidUid6ruh0jhJ]rhUXInstalling Metacatrr}r(h/XInstalling Metacatrh0jubah}r(h@]hA]hB]hC]hF]uh0jhJ]r(h{)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid38rahB]h@]hA]hF]UrefidUid7ruh0jhJ]rhUX New Installrr}r(h/X New Installrh0jubah}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rh)r}r(h/Uh>}r(hC]rUid39rahB]h@]hA]hF]UrefidUupgraderuh0jhJ]rhUXUpgraderr}r(h/XUpgraderh0jubah}r(h@]hA]hB]hC]rhahF]rhauhHK hIhhJ]r(hL)r}r(h/hh0jh:h;h}r(hC]hB]h@]hA]hF]hRhuhHK hIhhJ]rhUXSystem Requirementsrr}r(h/hh0jubaubhY)r}r(h/XIn addition to meeting the recommended system requirements, the server on which you wish to install Metacat must have the following software installed and running correctly:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK hIhhJ]rhUXIn addition to meeting the recommended system requirements, the server on which you wish to install Metacat must have the following software installed and running correctly:rr}r(h/jh0jubaubhu)r}r(h/Uh0jh:h;h}r(UbulletrX*hC]hB]h@]hA]hF]uhHKhIhhJ]r(h{)r}r(h/X PostgreSQL_r h0jh:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/j h0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhJ]rh)r}r(h/X PostgreSQL_UresolvedrKh0j h}r(UnameX PostgreSQLUrefurirXhttp://www.postgresql.org/rhC]hB]h@]hA]hF]uhJ]rhUX PostgreSQLrr}r(h/Uh0jubaubaubaubh{)r}r(h/X'`Apache Ant`_ (if building from source)rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r (h/jh0jh:h;h}r!(h@]hA]hB]hC]hF]uhHKhJ]r"(h)r#}r$(h/X `Apache Ant`_jKh0jh}r%(UnameX Apache AntjXhttp://ant.apache.org/r&hC]hB]h@]hA]hF]uhJ]r'hUX Apache Antr(r)}r*(h/Uh0j#ubaubhUX (if building from source)r+r,}r-(h/X (if building from source)h0jubeubaubh{)r.}r/(h/X`Apache Tomcat`_r0h0jh:h;h}r1(h@]hA]hB]hC]hF]uhHNhIhhJ]r2hY)r3}r4(h/j0h0j.h:h;h}r5(h@]hA]hB]hC]hF]uhHKhJ]r6h)r7}r8(h/j0jKh0j3h}r9(UnameX Apache TomcatjXhttp://tomcat.apache.org/r:hC]hB]h@]hA]hF]uhJ]r;hUX Apache Tomcatr<r=}r>(h/Uh0j7ubaubaubaubh{)r?}r@(h/X`Apache HTTPD Server`_ (recommended) * In order to use the Metacat Registry (and for a more robust Web-serving environment in general), the Apache Web server should be installed with Tomcat and the two should be integrated. See the installing Apache for more information. h0jh:Nh}rA(h@]hA]hB]hC]hF]uhHNhIhhJ]rB(hY)rC}rD(h/X$`Apache HTTPD Server`_ (recommended)h0j?h:h;h}rE(h@]hA]hB]hC]hF]uhHKhJ]rF(h)rG}rH(h/X`Apache HTTPD Server`_jKh0jCh}rI(UnameXApache HTTPD ServerjXhttp://httpd.apache.org/rJhC]hB]h@]hA]hF]uhJ]rKhUXApache HTTPD ServerrLrM}rN(h/Uh0jGubaubhUX (recommended)rOrP}rQ(h/X (recommended)h0jCubeubhu)rR}rS(h/Uh>}rT(jX*hC]hB]h@]hA]hF]uh0j?hJ]rUh{)rV}rW(h/XIn order to use the Metacat Registry (and for a more robust Web-serving environment in general), the Apache Web server should be installed with Tomcat and the two should be integrated. See the installing Apache for more information. h>}rX(h@]hA]hB]hC]hF]uh0jRhJ]rYhY)rZ}r[(h/XIn order to use the Metacat Registry (and for a more robust Web-serving environment in general), the Apache Web server should be installed with Tomcat and the two should be integrated. See the installing Apache for more information.r\h0jVh:h;h}r](h@]hA]hB]hC]hF]uhHKhJ]r^hUXIn order to use the Metacat Registry (and for a more robust Web-serving environment in general), the Apache Web server should be installed with Tomcat and the two should be integrated. See the installing Apache for more information.r_r`}ra(h/j\h0jZubaubah}rd(h@]hA]hB]hC]hF]uhHNhIhhJ]rehY)rf}rg(h/X&`Java 8`_ (Note: Java 7 is deprecated)h0jbh:h;h}rh(h@]hA]hB]hC]hF]uhHKhJ]ri(h)rj}rk(h/X `Java 8`_jKh0jfh}rl(UnameXJava 8jXShttp://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.htmlrmhC]hB]h@]hA]hF]uhJ]rnhUXJava 8rorp}rq(h/Uh0jjubaubhUX (Note: Java 7 is deprecated)rrrs}rt(h/X (Note: Java 7 is deprecated)h0jfubeubaubeubcdocutils.nodes target ru)rv}rw(h/X*.. _PostgreSQL: http://www.postgresql.org/U referencedrxKh0jh:h;h}rz(jjhC]r{U postgresqlr|ahB]h@]hA]hF]r}h auhHKhIhhJ]ubju)r~}r(h/X".. _Oracle: http://www.oracle.com/jxKh0jh:h;h}r(jXhttp://www.oracle.com/rhC]rUoraclerahB]h@]hA]hF]rh$auhHKhIhhJ]ubju)r}r(h/X&.. _Apache Ant: http://ant.apache.org/jxKh0jh:h;h}r(jj&hC]rU apache-antrahB]h@]hA]hF]rh#auhHKhIhhJ]ubju)r}r(h/X,.. _Apache Tomcat: http://tomcat.apache.org/jxKh0jh:h;h}r(jj:hC]rU apache-tomcatrahB]h@]hA]hF]rh auhHKhIhhJ]ubju)r}r(h/X1.. _Apache HTTPD Server: http://httpd.apache.org/jxKh0jh:h;h}r(jjJhC]rUapache-httpd-serverrahB]h@]hA]hF]rh!auhHKhIhhJ]ubju)r}r(h/X_.. _Java 8: http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.htmljxKh0jh:h;h}r(jjmhC]rUjava-8rahB]h@]hA]hF]rh'auhHK!hIhhJ]ubhY)r}r(h/X(System requirements for running Metacat:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK#hIhhJ]rhUX(System requirements for running Metacat:rr}r(h/jh0jubaubhu)r}r(h/Uh0jh:h;h}r(jX*hC]hB]h@]hA]hF]uhHK%hIhhJ]r(h{)r}r(h/X%a server running PostgreSQL_ databaserh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK%hJ]r(hUXa server running rr}r(h/Xa server running h0jubh)r}r(h/X PostgreSQL_jKh0jh}r(UnameX PostgreSQLjjhC]hB]h@]hA]hF]uhJ]rhUX PostgreSQLrr}r(h/Uh0jubaubhUX databaserr}r(h/X databaseh0jubeubaubh{)r}r(h/Xat least 512MB RAMrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK&hJ]rhUXat least 512MB RAMrr}r(h/jh0jubaubaubh{)r}r(h/X200 MB disk space (Note: The amount of disk space required depends on the size of your RDBMS tablespace and the the size and number of documents stored. Metacat itself requires only about 140 MB of free space after installation). h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X200 MB disk space (Note: The amount of disk space required depends on the size of your RDBMS tablespace and the the size and number of documents stored. Metacat itself requires only about 140 MB of free space after installation).rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK'hJ]rhUX200 MB disk space (Note: The amount of disk space required depends on the size of your RDBMS tablespace and the the size and number of documents stored. Metacat itself requires only about 140 MB of free space after installation).rr}r(h/jh0jubaubaubeubeubh6h1)r}r(h/Uh0h8h:h;h}r(h@]hA]hB]hC]rjCahF]rh auhHM#hIhhJ]r(hL)r}r(h/jHh0jh:h;h}r(hC]hB]h@]hA]hF]hRjBuhHM#hIhhJ]rhUXInstalling on Windowsrr}r(h/jHh0jubaubhY)r}r(h/XMetacat can be installed on Windows. Please follow the instructions in this section for downloading Metacat, installing the required software, and installing Metacat. Note that Registry and Data Upload functionality has not been tested on Windows.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM$hIhhJ]rhUXMetacat can be installed on Windows. Please follow the instructions in this section for downloading Metacat, installing the required software, and installing Metacat. Note that Registry and Data Upload functionality has not been tested on Windows.rr}r(h/jh0jubaubh1)r}r(h/Uh0jh:h;h}r(h@]hA]hB]hC]rjZahF]rhauhHM*hIhhJ]r(hL)r}r(h/j_h0jh:h;h}r(hC]hB]h@]hA]hF]hRjYuhHM*hIhhJ]rhUXDownload Metacatrr}r(h/j_h0jubaubhY)r}r(h/XPTo obtain a Metacat WAR file, which is used when installing the Metacat servlet:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM+hIhhJ]rhUXPTo obtain a Metacat WAR file, which is used when installing the Metacat servlet:rr}r(h/jh0jubaubcdocutils.nodes enumerated_list r)r}r(h/Uh0jh:h;h}r(UsuffixrU.hC]hB]h@]UprefixrUhA]hF]UenumtyperUarabicr uhHM.hIhhJ]r (h{)r }r (h/XBrowse to the KNB Software Download Page. In the Metacat section, select the link that looks like: metacat-bin-X.X.X.zip, where X.X.X is the latest version of Metacat (e.g., 2.0.4). h0jh:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XBrowse to the KNB Software Download Page. In the Metacat section, select the link that looks like: metacat-bin-X.X.X.zip, where X.X.X is the latest version of Metacat (e.g., 2.0.4).rh0j h:h;h}r(h@]hA]hB]hC]hF]uhHM.hJ]rhUXBrowse to the KNB Software Download Page. In the Metacat section, select the link that looks like: metacat-bin-X.X.X.zip, where X.X.X is the latest version of Metacat (e.g., 2.0.4).rr}r(h/jh0jubaubaubh{)r}r(h/X.Choose to download and Save the file locally. h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X-Choose to download and Save the file locally.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM2hJ]rhUX-Choose to download and Save the file locally.r r!}r"(h/jh0jubaubaubh{)r#}r$(h/XExtract the Metacat package files using your Windows zip utility. You should see a WAR file and several supporting files (we will only use the WAR file when installing Metacat). h0jh:h;h}r%(h@]hA]hB]hC]hF]uhHNhIhhJ]r&hY)r'}r((h/XExtract the Metacat package files using your Windows zip utility. You should see a WAR file and several supporting files (we will only use the WAR file when installing Metacat).r)h0j#h:h;h}r*(h@]hA]hB]hC]hF]uhHM4hJ]r+hUXExtract the Metacat package files using your Windows zip utility. You should see a WAR file and several supporting files (we will only use the WAR file when installing Metacat).r,r-}r.(h/j)h0j'ubaubaubeubhY)r/}r0(h/XNote: The location where these files were extracted will be referred to as the ```` for the remainder of this documentation.h0jh:h;h}r1(h@]hA]hB]hC]hF]uhHM8hIhhJ]r2(hUXONote: The location where these files were extracted will be referred to as the r3r4}r5(h/XONote: The location where these files were extracted will be referred to as the h0j/ubcdocutils.nodes literal r6)r7}r8(h/X````h>}r9(h@]hA]hB]hC]hF]uh0j/hJ]r:hUXr;r<}r=(h/Uh0j7ubahubhUX) for the remainder of this documentation.r?r@}rA(h/X) for the remainder of this documentation.h0j/ubeubhY)rB}rC(h/XmNote: Before installing Metacat, please ensure that all required software is installed and running correctly.rDh0jh:h;h}rE(h@]hA]hB]hC]hF]uhHM;hIhhJ]rFhUXmNote: Before installing Metacat, please ensure that all required software is installed and running correctly.rGrH}rI(h/jDh0jBubaubeubh1)rJ}rK(h/Uh0jh:h;h}rL(h@]hA]hB]hC]rMjmahF]rNhauhHM@hIhhJ]rO(hL)rP}rQ(h/jrh0jJh:h;h}rR(hC]hB]h@]hA]hF]hRjluhHM@hIhhJ]rShUXInstall Required SoftwarerTrU}rV(h/jrh0jPubaubhY)rW}rX(h/XBefore you can install and run Metacat, you must ensure that a recent Java SDK, PostgreSQL and Tomcat are installed, configured, and running correctly.rYh0jJh:h;h}rZ(h@]hA]hB]hC]hF]uhHMAhIhhJ]r[hUXBefore you can install and run Metacat, you must ensure that a recent Java SDK, PostgreSQL and Tomcat are installed, configured, and running correctly.r\r]}r^(h/jYh0jWubaubhu)r_}r`(h/Uh0jJh:h;h}ra(jX*hC]hB]h@]hA]hF]uhHMDhIhhJ]rb(h{)rc}rd(h/X `Java 8`_reh0j_h:h;h}rf(h@]hA]hB]hC]hF]uhHNhIhhJ]rghY)rh}ri(h/jeh0jch:h;h}rj(h@]hA]hB]hC]hF]uhHMDhJ]rkh)rl}rm(h/jejKh0jhh}rn(UnameXJava 8jjmhC]hB]h@]hA]hF]uhJ]rohUXJava 8rprq}rr(h/Uh0jlubaubaubaubh{)rs}rt(h/X`Apache Tomcat`_ruh0j_h:h;h}rv(h@]hA]hB]hC]hF]uhHNhIhhJ]rwhY)rx}ry(h/juh0jsh:h;h}rz(h@]hA]hB]hC]hF]uhHMEhJ]r{h)r|}r}(h/jujKh0jxh}r~(UnameX Apache Tomcatjj:hC]hB]h@]hA]hF]uhJ]rhUX Apache Tomcatrr}r(h/Uh0j|ubaubaubaubh{)r}r(h/XPostgreSQL_ Database h0j_h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XPostgreSQL_ Databaseh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMFhJ]r(h)r}r(h/X PostgreSQL_jKh0jh}r(UnameX PostgreSQLjjhC]hB]h@]hA]hF]uhJ]rhUX PostgreSQLrr}r(h/Uh0jubaubhUX Databaserr}r(h/X Databaseh0jubeubaubeubh1)r}r(h/UjxKh0jJh:h;h}r(h@]rXjava 8rahA]hB]hC]rjahF]uhHMIhIhhJ]r(hL)r}r(h/jh0jh:h;h}r(hC]hB]h@]hA]hF]hRjuhHMIhIhhJ]rhUXJava 8rr}r(h/jh0jubaubhY)r}r(h/XTo run Metacat, you must have Java 8. Make sure that the JAVA_HOME environment variable is properly set and that both java and javac are on your PATH.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMJhIhhJ]rhUXTo run Metacat, you must have Java 8. Make sure that the JAVA_HOME environment variable is properly set and that both java and javac are on your PATH.rr}r(h/jh0jubaubhY)r}r(h/XTo download and install Java:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMNhIhhJ]rhUXTo download and install Java:rr}r(h/jh0jubaubj)r}r(h/Uh0jh:h;h}r(jU.hC]hB]h@]jUhA]hF]jj uhHMPhIhhJ]r(h{)r}r(h/XBrowse to: http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html and follow the instructions to download JDK 8. h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XBrowse to: http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html and follow the instructions to download JDK 8.h0jh:h;h}r(h@]hA]hB]hC]hF]uhHMPhJ]r(hUX Browse to: rr}r(h/X Browse to: h0jubh)r}r(h/XShttp://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.htmlrh>}r(UrefurijhC]hB]h@]hA]hF]uh0jhJ]rhUXShttp://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.htmlrr}r(h/Uh0jubah}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X-Run the downloaded installer to install Java.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMShJ]rhUX-Run the downloaded installer to install Java.rr}r(h/jh0jubaubaubh{)r}r(h/X}Set the JAVA_HOME environment variable: In "My Computer" properties, go to "advanced settings > environment variables". Add: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X|Set the JAVA_HOME environment variable: In "My Computer" properties, go to "advanced settings > environment variables". Add:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMUhJ]rhUX|Set the JAVA_HOME environment variable: In "My Computer" properties, go to "advanced settings > environment variables". Add:rr}r(h/jh0jubaubaubeubcdocutils.nodes block_quote r)r}r(h/Uh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rcdocutils.nodes literal_block r)r}r(h/XbSystem Variable: JAVA_HOME C:\Program Files\Java\jdk1.8.0_79 (or whichever version you downloaded)h0jh}r(U xml:spacerUpreserverhC]hB]h@]hA]hF]uhHMZhJ]rhUXbSystem Variable: JAVA_HOME C:\Program Files\Java\jdk1.8.0_79 (or whichever version you downloaded)rr}r(h/Uh0jubaubaubeubh1)r}r(h/UjxKh0jJh:h;h}r(h@]rX apache tomcatrahA]hB]hC]rjahF]uhHM^hIhhJ]r(hL)r}r(h/jh0jh:h;h}r(hC]hB]h@]hA]hF]hRjuhHM^hIhhJ]rhUX Apache Tomcatrr}r(h/jh0jubaubhY)r}r(h/XPWe recommend that you install Tomcat version 7. To download and install Tomcat:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM_hIhhJ]rhUXPWe recommend that you install Tomcat version 7. To download and install Tomcat:r r }r (h/jh0jubaubj)r }r (h/Uh0jh:h;h}r(jU.hC]hB]h@]jUhA]hF]jj uhHMahIhhJ]r(h{)r}r(h/X$Browse to: http://tomcat.apache.org/rh0j h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMahJ]r(hUX Browse to: rr}r(h/X Browse to: h0jubh)r}r(h/Xhttp://tomcat.apache.org/rh>}r(UrefurijhC]hB]h@]hA]hF]uh0jhJ]r hUXhttp://tomcat.apache.org/r!r"}r#(h/Uh0jubah}r'(h@]hA]hB]hC]hF]uhHNhIhhJ]r(hY)r)}r*(h/j&h0j$h:h;h}r+(h@]hA]hB]hC]hF]uhHMbhJ]r,hUX!Download the Tomcat core zip filer-r.}r/(h/j&h0j)ubaubaubh{)r0}r1(h/XOExtract Tomcat files to C:\Program Files\tomcat using the windows zip utility. h0j h:h;h}r2(h@]hA]hB]hC]hF]uhHNhIhhJ]r3hY)r4}r5(h/XNExtract Tomcat files to C:\Program Files\tomcat using the windows zip utility.h0j0h:h;h}r6(h@]hA]hB]hC]hF]uhHMchJ]r7hUXLExtract Tomcat files to C:Program Filestomcat using the windows zip utility.r8r9}r:(h/XNExtract Tomcat files to C:\Program Files\tomcat using the windows zip utility.h0j4ubaubaubeubeubh1)r;}r<(h/UjxKh0jJh:h;h}r=(h@]r>Xpostgresql databaser?ahA]hB]hC]r@jahF]uhHMghIhhJ]rA(hL)rB}rC(h/jh0j;h:h;h}rD(hC]hB]h@]hA]hF]hRjuhHMghIhhJ]rEhUXPostgreSQL DatabaserFrG}rH(h/jh0jBubaubhY)rI}rJ(h/XMetacat only can be run with PostgreSQL_. Instructions for installing and configuring PostgreSQL for use with Metacat are included in this section.h0j;h:h;h}rK(h@]hA]hB]hC]hF]uhHMhhIhhJ]rL(hUXMetacat only can be run with rMrN}rO(h/XMetacat only can be run with h0jIubh)rP}rQ(h/X PostgreSQL_jKh0jIh}rR(UnameX PostgreSQLjjhC]hB]h@]hA]hF]uhJ]rShUX PostgreSQLrTrU}rV(h/Uh0jPubaubhUXk. Instructions for installing and configuring PostgreSQL for use with Metacat are included in this section.rWrX}rY(h/Xk. Instructions for installing and configuring PostgreSQL for use with Metacat are included in this section.h0jIubeubhY)rZ}r[(h/X#To download and install PostgreSQL:r\h0j;h:h;h}r](h@]hA]hB]hC]hF]uhHMkhIhhJ]r^hUX#To download and install PostgreSQL:r_r`}ra(h/j\h0jZubaubj)rb}rc(h/Uh0j;h:h;h}rd(jU.hC]hB]h@]jUhA]hF]jj uhHMmhIhhJ]re(h{)rf}rg(h/XYBrowse to http://www.postgresql.org/download/windows and download the one-click installerh0jbh:h;h}rh(h@]hA]hB]hC]hF]uhHNhIhhJ]rihY)rj}rk(h/XYBrowse to http://www.postgresql.org/download/windows and download the one-click installerh0jfh:h;h}rl(h@]hA]hB]hC]hF]uhHMmhJ]rm(hUX Browse to rnro}rp(h/X Browse to h0jjubh)rq}rr(h/X*http://www.postgresql.org/download/windowsrsh>}rt(UrefurijshC]hB]h@]hA]hF]uh0jjhJ]ruhUX*http://www.postgresql.org/download/windowsrvrw}rx(h/Uh0jqubah}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/j~h0j|h:h;h}r(h@]hA]hB]hC]hF]uhHMohJ]rhUXRun the installerrr}r(h/j~h0jubaubaubh{)r}r(h/X3Edit C:\Program Files\PostgreSQL\8.3\data and add: h0jbh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X2Edit C:\Program Files\PostgreSQL\8.3\data and add:h0jh:h;h}r(h@]hA]hB]hC]hF]uhHMphJ]rhUX.Edit C:Program FilesPostgreSQL8.3data and add:rr}r(h/X2Edit C:\Program Files\PostgreSQL\8.3\data and add:h0jubaubaubeubj)r}r(h/Uh0j;h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X7host metacat metacat 127.0.0.1 255.255.255.255 passwordh0jh}r(jjhC]hB]h@]hA]hF]uhHMthJ]rhUX7host metacat metacat 127.0.0.1 255.255.255.255 passwordrr}r(h/Uh0jubaubaubj)r}r(h/Uh0j;h:h;h}r(jU.UstartrKhC]hB]h@]jUhA]hF]jj uhHMvhIhhJ]rh{)r}r(h/X1Create a super user. At the command line, enter: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X0Create a super user. At the command line, enter:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMvhJ]rhUX0Create a super user. At the command line, enter:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0j;h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X\C:\Program Files\PostgreSQL\8.3\bin createdb -U postgres metacat (enter super user password)h0jh}r(jjhC]hB]h@]hA]hF]uhHMzhJ]rhUX\C:\Program Files\PostgreSQL\8.3\bin createdb -U postgres metacat (enter super user password)rr}r(h/Uh0jubaubaubj)r}r(h/Uh0j;h:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHM}hIhhJ]rh{)r}r(h/XLog in to PostgreSQL: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XLog in to PostgreSQL:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM}hJ]rhUXLog in to PostgreSQL:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0j;h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X4psql -U postgres metacat (enter super user password)h0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUX4psql -U postgres metacat (enter super user password)rr}r(h/Uh0jubaubaubj)r}r(h/Uh0j;h:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/XCreate a Metacat user: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XCreate a Metacat user:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXCreate a Metacat user:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0j;h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X=CREATE USER metacat WITH UNENCRYPTED PASSWORD 'your_password'h0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUX=CREATE USER metacat WITH UNENCRYPTED PASSWORD 'your_password'rr}r(h/Uh0jubaubaubj)r}r(h/Uh0j;h:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/XExit PostgreSQL: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XExit PostgreSQL:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXExit PostgreSQL:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0j;h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X\qh0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUX\qrr }r (h/Uh0jubaubaubj)r }r (h/Uh0j;h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/X5Restart PostgreSQL from the start menu by selecting: h0j h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X4Restart PostgreSQL from the start menu by selecting:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUX4Restart PostgreSQL from the start menu by selecting:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0j;h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r (h/Xdrun start/All Programs/PostgreSQL 8.3/Stop Server run start/All Programs/PostgreSQL 8.3/Start Serverh0jh}r!(jjhC]hB]h@]hA]hF]uhHMhJ]r"hUXdrun start/All Programs/PostgreSQL 8.3/Stop Server run start/All Programs/PostgreSQL 8.3/Start Serverr#r$}r%(h/Uh0jubaubaubj)r&}r'(h/Uh0j;h:h;h}r((jU.jK hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r)h{)r*}r+(h/X9Test the installation by logging in as the metacat user: h0j&h:h;h}r,(h@]hA]hB]hC]hF]uhHNhIhhJ]r-hY)r.}r/(h/X8Test the installation by logging in as the metacat user:r0h0j*h:h;h}r1(h@]hA]hB]hC]hF]uhHMhJ]r2hUX8Test the installation by logging in as the metacat user:r3r4}r5(h/j0h0j.ubaubaubaubj)r6}r7(h/Uh0j;h:h;h}r8(h@]hA]hB]hC]hF]uhHNhIhhJ]r9j)r:}r;(h/X'psql -U metacat -W -h localhost metacath0j6h}r<(jjhC]hB]h@]hA]hF]uhHMhJ]r=hUX'psql -U metacat -W -h localhost metacatr>r?}r@(h/Uh0j:ubaubaubj)rA}rB(h/Uh0j;h:h;h}rC(jU.jK hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rDh{)rE}rF(h/XExit PostgreSQL: h0jAh:h;h}rG(h@]hA]hB]hC]hF]uhHNhIhhJ]rHhY)rI}rJ(h/XExit PostgreSQL:rKh0jEh:h;h}rL(h@]hA]hB]hC]hF]uhHMhJ]rMhUXExit PostgreSQL:rNrO}rP(h/jKh0jIubaubaubaubj)rQ}rR(h/Uh0j;h:h;h}rS(h@]hA]hB]hC]hF]uhHNhIhhJ]rTj)rU}rV(h/X\qh0jQh}rW(jjhC]hB]h@]hA]hF]uhHMhJ]rXhUX\qrYrZ}r[(h/Uh0jUubaubaubhY)r\}r](h/XThe Metacat servlet automatically creates the required database schema. For more information, please see Database Configuration.r^h0j;h:h;h}r_(h@]hA]hB]hC]hF]uhHMhIhhJ]r`hUXThe Metacat servlet automatically creates the required database schema. For more information, please see Database Configuration.rarb}rc(h/j^h0j\ubaubeubeubh1)rd}re(h/UjxKh0jh:h;h}rf(h@]rgXinstalling metacatrhahA]hB]hC]rijahF]uhHMhIhhJ]rj(hL)rk}rl(h/jh0jdh:h;h}rm(hC]hB]h@]hA]hF]hRjuhHMhIhhJ]rnhUXInstalling Metacatrorp}rq(h/jh0jkubaubhY)rr}rs(h/XEInstructions for a new install and for an upgrade are included below.rth0jdh:h;h}ru(h@]hA]hB]hC]hF]uhHMhIhhJ]rvhUXEInstructions for a new install and for an upgrade are included below.rwrx}ry(h/jth0jrubaubh1)rz}r{(h/UjxKh0jdh:h;h}r|(h@]r}X new installr~ahA]hB]hC]rjahF]uhHMhIhhJ]r(hL)r}r(h/jh0jzh:h;h}r(hC]hB]h@]hA]hF]hRjuhHMhIhhJ]rhUX New Installrr}r(h/jh0jubaubhY)r}r(h/XBefore installing Metacat, please ensure that all required applications are installed, configured to run with Metacat, and running correctly. If you are upgrading an existing Metacat servlet, please skip to Upgrade.rh0jzh:h;h}r(h@]hA]hB]hC]hF]uhHMhIhhJ]rhUXBefore installing Metacat, please ensure that all required applications are installed, configured to run with Metacat, and running correctly. If you are upgrading an existing Metacat servlet, please skip to Upgrade.rr}r(h/jh0jubaubhY)r}r(h/X!To install a new Metacat servlet:rh0jzh:h;h}r(h@]hA]hB]hC]hF]uhHMhIhhJ]rhUX!To install a new Metacat servlet:rr}r(h/jh0jubaubj)r}r(h/Uh0jzh:h;h}r(jU.hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/X&Create the Metacat base directory at: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X%Create the Metacat base directory at:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUX%Create the Metacat base directory at:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0jzh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/XC:/Program Files/metacath0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUXC:/Program Files/metacatrr}r(h/Uh0jubaubaubj)r}r(h/Uh0jzh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/XpCopy the Metacat WAR file to Tomcat (for information about obtaining a Metacat WAR file, see Download Metacat): h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XoCopy the Metacat WAR file to Tomcat (for information about obtaining a Metacat WAR file, see Download Metacat):rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXoCopy the Metacat WAR file to Tomcat (for information about obtaining a Metacat WAR file, see Download Metacat):rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0jzh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/XFcopy \metacat.war C:\Program Files\tomcat\webappsh0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUXFcopy \metacat.war C:\Program Files\tomcat\webappsrr}r(h/Uh0jubaubaubj)r}r(h/Uh0jzh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/XRestart Tomcat: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XRestart Tomcat:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXRestart Tomcat:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0jzh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/XHC:\Program Files\tomcat\shutdown.bat C:\Program Files\tomcat\startup.bath0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUXHC:\Program Files\tomcat\shutdown.bat C:\Program Files\tomcat\startup.batrr}r(h/Uh0jubaubaubhY)r}r(h/XsCongratulations! You are now ready to configure Metacat. Please see the Configuration Section for more information.rh0jzh:h;h}r(h@]hA]hB]hC]hF]uhHMhIhhJ]rhUXsCongratulations! You are now ready to configure Metacat. Please see the Configuration Section for more information.rr}r(h/jh0jubaubeubh1)r}r(h/Uh0jdh:h;h}r(h@]hA]hB]hC]rjahF]rhauhHMhIhhJ]r(hL)r}r(h/jh0jh:h;h}r(hC]hB]h@]hA]hF]hRjuhHMhIhhJ]rhUXUpgraderr}r(h/jh0jubaubhY)r}r(h/X,To upgrade an existing Metacat installation:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhIhhJ]rhUX,To upgrade an existing Metacat installation:rr}r(h/jh0jubaubj)r}r(h/Uh0jh:h;h}r(jU.hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r (h{)r }r (h/XDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Download Metacat. h0jh:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r}r(h/XDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Download Metacat.rh0j h:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Download Metacat.rr}r(h/jh0jubaubaubh{)r}r(h/XBack up the existing Metacat installation. Although not required, we highly recommend that you back up your existing Metacat to a backup directory () before installing a new version. You can do so by copying: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XBack up the existing Metacat installation. Although not required, we highly recommend that you back up your existing Metacat to a backup directory () before installing a new version. You can do so by copying:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXBack up the existing Metacat installation. Although not required, we highly recommend that you back up your existing Metacat to a backup directory () before installing a new version. You can do so by copying:rr }r!(h/jh0jubaubaubeubj)r"}r#(h/Uh0jh:h;h}r$(h@]hA]hB]hC]hF]uhHNhIhhJ]r%(j)r&}r'(h/Xy/metacat to /metacat. /metacat.war to /metacat.war.h0j"h}r((jjhC]hB]h@]hA]hF]uhHMhJ]r)hUXy/metacat to /metacat. /metacat.war to /metacat.war.r*r+}r,(h/Uh0j&ubaubhY)r-}r.(h/XWarning: Do not backup the metacat directory in the directory. Tomcat will try to run the backup copy as a service.r/h0j"h:h;h}r0(h@]hA]hB]hC]hF]uhHMhJ]r1hUXWarning: Do not backup the metacat directory in the directory. Tomcat will try to run the backup copy as a service.r2r3}r4(h/j/h0j-ubaubeubj)r5}r6(h/Uh0jh:h;h}r7(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r8h{)r9}r:(h/XCCopy the new Metacat WAR file in to Tomcat applications directory: h0j5h:h;h}r;(h@]hA]hB]hC]hF]uhHNhIhhJ]r<hY)r=}r>(h/XBCopy the new Metacat WAR file in to Tomcat applications directory:r?h0j9h:h;h}r@(h@]hA]hB]hC]hF]uhHMhJ]rAhUXBCopy the new Metacat WAR file in to Tomcat applications directory:rBrC}rD(h/j?h0j=ubaubaubaubj)rE}rF(h/Uh0jh:h;h}rG(h@]hA]hB]hC]hF]uhHNhIhhJ]rHj)rI}rJ(h/X0copy metacat.war C:\Program Files\tomcat\webappsh0jEh}rK(jjhC]hB]h@]hA]hF]uhHMhJ]rLhUX0copy metacat.war C:\Program Files\tomcat\webappsrMrN}rO(h/Uh0jIubaubaubj)rP}rQ(h/Uh0jh:h;h}rR(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rSh{)rT}rU(h/XRestart Tomcat: h0jPh:h;h}rV(h@]hA]hB]hC]hF]uhHNhIhhJ]rWhY)rX}rY(h/XRestart Tomcat:rZh0jTh:h;h}r[(h@]hA]hB]hC]hF]uhHMhJ]r\hUXRestart Tomcat:r]r^}r_(h/jZh0jXubaubaubaubj)r`}ra(h/Uh0jh:h;h}rb(h@]hA]hB]hC]hF]uhHNhIhhJ]rcj)rd}re(h/XHC:\Program Files\tomcat\shutdown.bat C:\Program Files\tomcat\startup.bath0j`h}rf(jjhC]hB]h@]hA]hF]uhHMhJ]rghUXHC:\Program Files\tomcat\shutdown.bat C:\Program Files\tomcat\startup.batrhri}rj(h/Uh0jdubaubaubhY)rk}rl(h/XmCongratulations! You are now ready to configure Metacat. Please see Configuring Metacat for more information.rmh0jh:h;h}rn(h@]hA]hB]hC]hF]uhHMhIhhJ]rohUXmCongratulations! You are now ready to configure Metacat. Please see Configuring Metacat for more information.rprq}rr(h/jmh0jkubaubeubeubeubeubh:h;h}rs(h@]hA]hB]hC]rthahF]ruhauhHK+hIhhJ]rv(hL)rw}rx(h/hh0h6h:h;h}ry(hC]hB]h@]hA]hF]hRhuhHK+hIhhJ]rzhUXInstalling on Linuxr{r|}r}(h/hh0jwubaubhY)r~}r(h/XOThis section contains instructions for downloading and installing Metacat on Linux systems. As Mac OS X is based on BSD Unix, these Linux instructions can be adapted to also work on Mac OS X (although the exact commands for downloading and installing packages will differ due to the different package management approaches on the Mac).rh0h6h:h;h}r(h@]hA]hB]hC]hF]uhHK,hIhhJ]rhUXOThis section contains instructions for downloading and installing Metacat on Linux systems. As Mac OS X is based on BSD Unix, these Linux instructions can be adapted to also work on Mac OS X (although the exact commands for downloading and installing packages will differ due to the different package management approaches on the Mac).rr}r(h/jh0j~ubaubh1)r}r(h/Uh0h6h:h;h}r(h@]hA]hB]hC]rhahF]rhauhHK3hIhhJ]r(hL)r}r(h/hh0jh:h;h}r(hC]hB]h@]hA]hF]hRhuhHK3hIhhJ]rhUXQuick Start Overviewrr}r(h/hh0jubaubhY)r}r(h/XFor the impatient or those who have already installed Metacat and know what they are doing, here are the steps needed to install Metacat. Detailed instructions for each step are in the next section.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK4hIhhJ]rhUXFor the impatient or those who have already installed Metacat and know what they are doing, here are the steps needed to install Metacat. Detailed instructions for each step are in the next section.rr}r(h/jh0jubaubj)r}r(h/Uh0jh:h;h}r(jU.hC]hB]h@]jUhA]hF]jj uhHK8hIhhJ]r(h{)r}r(h/XgDownload and install prerequisites (`Java 8`_, `Apache Tomcat`_ 7, PostgreSQL_, `Apache HTTPD Server`_)rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK8hJ]r(hUX$Download and install prerequisites (rr}r(h/X$Download and install prerequisites (h0jubh)r}r(h/X `Java 8`_jKh0jh}r(UnameXJava 8jjmhC]hB]h@]hA]hF]uhJ]rhUXJava 8rr}r(h/Uh0jubaubhUX, rr}r(h/X, h0jubh)r}r(h/X`Apache Tomcat`_jKh0jh}r(UnameX Apache Tomcatjj:hC]hB]h@]hA]hF]uhJ]rhUX Apache Tomcatrr}r(h/Uh0jubaubhUX 7, rr}r(h/X 7, h0jubh)r}r(h/X PostgreSQL_jKh0jh}r(UnameX PostgreSQLjjhC]hB]h@]hA]hF]uhJ]rhUX PostgreSQLrr}r(h/Uh0jubaubhUX, rr}r(h/X, h0jubh)r}r(h/X`Apache HTTPD Server`_jKh0jh}r(UnameXApache HTTPD ServerjjJhC]hB]h@]hA]hF]uhJ]rhUXApache HTTPD Serverrr}r(h/Uh0jubaubhUX)r}r(h/X)h0jubeubaubh{)r}r(h/XtCreate a database in PostgreSQL named 'metacat' and authorize access to it in ``pb_hba.conf`` for the user 'metacat'rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK9hJ]r(hUXNCreate a database in PostgreSQL named 'metacat' and authorize access to it in rr}r(h/XNCreate a database in PostgreSQL named 'metacat' and authorize access to it in h0jubj6)r}r(h/X``pb_hba.conf``h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX pb_hba.confrr}r(h/Uh0jubahubhUX for the user 'metacat'rr}r(h/X for the user 'metacat'h0jubeubaubh{)r}r(h/X2Log in to PostgreSQL and create the 'metacat' userrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK:hJ]rhUX2Log in to PostgreSQL and create the 'metacat' userrr}r(h/jh0jubaubaubh{)r}r(h/XJDownload Metacat from the `Metacat Download Page`_ and extract the archiverh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK;hJ]r(hUXDownload Metacat from the rr}r(h/XDownload Metacat from the h0jubh)r}r(h/X`Metacat Download Page`_jKh0jh}r(UnameXMetacat Download PagejX/http://knb.ecoinformatics.org/software/metacat/rhC]hB]h@]hA]hF]uhJ]rhUXMetacat Download Pagerr}r(h/Uh0jubaubhUX and extract the archiverr }r (h/X and extract the archiveh0jubeubaubh{)r }r (h/XE``sudo mkdir /var/metacat; sudo chown -R /var/metacat``r h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/j h0j h:h;h}r(h@]hA]hB]hC]hF]uhHK}r(h@]hA]hB]hC]hF]uh0jhJ]rhUXAsudo mkdir /var/metacat; sudo chown -R /var/metacatrr}r(h/Uh0jubahubaubaubh{)r}r(h/X>``sudo cp /metacat.war ``rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r }r!(h/jh0jh:h;h}r"(h@]hA]hB]hC]hF]uhHK=hJ]r#j6)r$}r%(h/jh>}r&(h@]hA]hB]hC]hF]uh0j hJ]r'hUX:sudo cp /metacat.war r(r)}r*(h/Uh0j$ubahubaubaubh{)r+}r,(h/XD``sudo cp /metacat-index.war ``r-h0jh:h;h}r.(h@]hA]hB]hC]hF]uhHNhIhhJ]r/hY)r0}r1(h/j-h0j+h:h;h}r2(h@]hA]hB]hC]hF]uhHK>hJ]r3j6)r4}r5(h/j-h>}r6(h@]hA]hB]hC]hF]uh0j0hJ]r7hUX@sudo cp /metacat-index.war r8r9}r:(h/Uh0j4ubahubaubaubh{)r;}r<(h/X@``sudo cp /metacatui.war ``r=h0jh:h;h}r>(h@]hA]hB]hC]hF]uhHNhIhhJ]r?hY)r@}rA(h/j=h0j;h:h;h}rB(h@]hA]hB]hC]hF]uhHK?hJ]rCj6)rD}rE(h/j=h>}rF(h@]hA]hB]hC]hF]uh0j@hJ]rGhUX<sudo cp /metacatui.war rHrI}rJ(h/Uh0jDubahubaubaubh{)rK}rL(h/X$``sudo /etc/init.d/tomcat7 restart``rMh0jh:h;h}rN(h@]hA]hB]hC]hF]uhHNhIhhJ]rOhY)rP}rQ(h/jMh0jKh:h;h}rR(h@]hA]hB]hC]hF]uhHK@hJ]rSj6)rT}rU(h/jMh>}rV(h@]hA]hB]hC]hF]uh0jPhJ]rWhUX sudo /etc/init.d/tomcat7 restartrXrY}rZ(h/Uh0jTubahubaubaubh{)r[}r\(h/X,Configure Metacat through the Web interface h0jh:h;h}r](h@]hA]hB]hC]hF]uhHNhIhhJ]r^hY)r_}r`(h/X+Configure Metacat through the Web interfacerah0j[h:h;h}rb(h@]hA]hB]hC]hF]uhHKAhJ]rchUX+Configure Metacat through the Web interfacerdre}rf(h/jah0j_ubaubaubeubju)rg}rh(h/XJ.. _Metacat Download Page: http://knb.ecoinformatics.org/software/metacat/jxKh0jh:h;h}ri(jjhC]rjUmetacat-download-pagerkahB]h@]hA]hF]rlhauhHKChIhhJ]ubeubh4h1)rm}rn(h/Uh0h6h:h;h}ro(h@]hA]hB]hC]rpj-ahF]rqhauhHKhIhhJ]rr(hL)rs}rt(h/j2h0jmh:h;h}ru(hC]hB]h@]hA]hF]hRj,uhHKhIhhJ]rvhUX,Installing and Configuring Required Softwarerwrx}ry(h/j2h0jsubaubhY)rz}r{(h/XMBefore you can install and run Metacat, you must ensure that a recent Java SDK, PostgreSQL, Ant (if installing from source), and Tomcat are installed and running correctly. We also highly recommend that you install Apache Web server, as it provides a more robust Web-serving environment and is required by some Metacat functionality.r|h0jmh:h;h}r}(h@]hA]hB]hC]hF]uhHKhIhhJ]r~hUXMBefore you can install and run Metacat, you must ensure that a recent Java SDK, PostgreSQL, Ant (if installing from source), and Tomcat are installed and running correctly. We also highly recommend that you install Apache Web server, as it provides a more robust Web-serving environment and is required by some Metacat functionality.rr}r(h/j|h0jzubaubhu)r}r(h/Uh0jmh:h;h}r(jX*hC]hB]h@]hA]hF]uhHKhIhhJ]r(h{)r}r(h/X `Java 8`_rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhJ]rh)r}r(h/jjKh0jh}r(UnameXJava 8jjmhC]hB]h@]hA]hF]uhJ]rhUXJava 8rr}r(h/Uh0jubaubaubaubh{)r}r(h/X`Apache Tomcat`_rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhJ]rh)r}r(h/jjKh0jh}r(UnameX Apache Tomcatjj:hC]hB]h@]hA]hF]uhJ]rhUX Apache Tomcatrr}r(h/Uh0jubaubaubaubh{)r}r(h/X+`Apache HTTPD Server`_ (Highly Recommended)rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhJ]r(h)r}r(h/X`Apache HTTPD Server`_jKh0jh}r(UnameXApache HTTPD ServerjjJhC]hB]h@]hA]hF]uhJ]rhUXApache HTTPD Serverrr}r(h/Uh0jubaubhUX (Highly Recommended)rr}r(h/X (Highly Recommended)h0jubeubaubh{)r}r(h/XPostgreSQL_ Databaserh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhJ]r(h)r}r(h/X PostgreSQL_jKh0jh}r(UnameX PostgreSQLjjhC]hB]h@]hA]hF]uhJ]rhUX PostgreSQLrr}r(h/Uh0jubaubhUX Databaserr}r(h/X Databaseh0jubeubaubh{)r}r(h/X(`Apache Ant`_ (if building from Source) h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X'`Apache Ant`_ (if building from Source)h0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhJ]r(h)r}r(h/X `Apache Ant`_jKh0jh}r(UnameX Apache Antjj&hC]hB]h@]hA]hF]uhJ]rhUX Apache Antrr}r(h/Uh0jubaubhUX (if building from Source)rr}r(h/X (if building from Source)h0jubeubaubeubh1)r}r(h/UjxKh0jmh:h;h}r(h@]rXjava 8rahA]hB]hC]rjDahF]uhHKhIhhJ]r(hL)r}r(h/jIh0jh:h;h}r(hC]hB]h@]hA]hF]hRjCuhHKhIhhJ]rhUXJava 8rr}r(h/jIh0jubaubhY)r}r(h/XTo run Metacat, you should use Java 8. Make sure that the JAVA_HOME environment variable is properly set and that both ``java`` and ``javac`` are on your PATH.h0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhIhhJ]r(hUXwTo run Metacat, you should use Java 8. Make sure that the JAVA_HOME environment variable is properly set and that both rr}r(h/XwTo run Metacat, you should use Java 8. Make sure that the JAVA_HOME environment variable is properly set and that both h0jubj6)r}r(h/X``java``h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUXjavarr}r(h/Uh0jubahubhUX and rr}r(h/X and h0jubj6)r}r(h/X ``javac``h>}r(h@]hA]hB]hC]hF]uh0jhJ]r hUXjavacr r }r (h/Uh0jubahubhUX are on your PATH.r r }r (h/X are on your PATH.h0jubeubhY)r }r (h/XRTo install Java if you are running Ubuntu_/Debian, you can install using apt-get::r h0jh:h;h}r (h@]hA]hB]hC]hF]uhHKhIhhJ]r (hUX#To install Java if you are running r r }r (h/X#To install Java if you are running h0j ubh)r }r (h/XUbuntu_jKh0j h}r (UnameXUbuntujXhttp://www.ubuntu.com/r hC]hB]h@]hA]hF]uhJ]r hUXUbuntur r }r (h/Uh0j ubaubhUX'/Debian, you can install using apt-get:r r }r (h/X'/Debian, you can install using apt-get:h0j ubeubj)r }r (h/X"sudo apt-get install openjdk-8-jdkh0jh:h;h}r (jjhC]hB]h@]hA]hF]uhHKhIhhJ]r hUX"sudo apt-get install openjdk-8-jdkr r }r (h/Uh0j ubaubhY)r! }r" (h/XIf you are not using Ubuntu_/Debian, you can get Java from the Oracle_ website and install using the RPM or other installer (Windows).r# h0jh:h;h}r$ (h@]hA]hB]hC]hF]uhHKhIhhJ]r% (hUXIf you are not using r& r' }r( (h/XIf you are not using h0j! ubh)r) }r* (h/XUbuntu_jKh0j! h}r+ (UnameXUbuntujj hC]hB]h@]hA]hF]uhJ]r, hUXUbuntur- r. }r/ (h/Uh0j) ubaubhUX#/Debian, you can get Java from the r0 r1 }r2 (h/X#/Debian, you can get Java from the h0j! ubh)r3 }r4 (h/XOracle_jKh0j! h}r5 (UnameXOraclejjhC]hB]h@]hA]hF]uhJ]r6 hUXOracler7 r8 }r9 (h/Uh0j3 ubaubhUX@ website and install using the RPM or other installer (Windows).r: r; }r< (h/X@ website and install using the RPM or other installer (Windows).h0j! ubeubju)r= }r> (h/X".. _Ubuntu: http://www.ubuntu.com/jxKh0jh:h;h}r? (jj hC]r@ UubunturA ahB]h@]hA]hF]rB hauhHKhIhhJ]ubeubh1)rC }rD (h/UjxKh0jmh:h;h}rE (h@]rF X apache tomcatrG ahA]hB]hC]rH jWahF]uhHKhIhhJ]rI (hL)rJ }rK (h/j\h0jC h:h;h}rL (hC]hB]h@]hA]hF]hRjVuhHKhIhhJ]rM hUX Apache TomcatrN rO }rP (h/j\h0jJ ubaubhY)rQ }rR (h/XWe recommend that you install Tomcat 6 or 7 or 8 into the directory of your choice. The newer versions are preferred. Included with the Metacat download is a Tomcat-friendly start-up script that should be installed as well.rS h0jC h:h;h}rT (h@]hA]hB]hC]hF]uhHKhIhhJ]rU hUXWe recommend that you install Tomcat 6 or 7 or 8 into the directory of your choice. The newer versions are preferred. Included with the Metacat download is a Tomcat-friendly start-up script that should be installed as well.rV rW }rX (h/jS h0jQ ubaubhY)rY }rZ (h/XuNote: we will refer to the Tomcat installation directory as ```` for the remainder of the documentation.h0jC h:h;h}r[ (h@]hA]hB]hC]hF]uhHKhIhhJ]r\ (hUX<Note: we will refer to the Tomcat installation directory as r] r^ }r_ (h/X<Note: we will refer to the Tomcat installation directory as h0jY ubj6)r` }ra (h/X````h>}rb (h@]hA]hB]hC]hF]uh0jY hJ]rc hUX rd re }rf (h/Uh0j` ubahubhUX( for the remainder of the documentation.rg rh }ri (h/X( for the remainder of the documentation.h0jY ubeubhY)rj }rk (h/X9If you are running Ubuntu_/Debian, get Tomcat by typing::rl h0jC h:h;h}rm (h@]hA]hB]hC]hF]uhHKhIhhJ]rn (hUXIf you are running ro rp }rq (h/XIf you are running h0jj ubh)rr }rs (h/XUbuntu_jKh0jj h}rt (UnameXUbuntujj hC]hB]h@]hA]hF]uhJ]ru hUXUbunturv rw }rx (h/Uh0jr ubaubhUX/Debian, get Tomcat by typing:ry rz }r{ (h/X/Debian, get Tomcat by typing:h0jj ubeubj)r| }r} (h/Xsudo apt-get install tomcat7h0jC h:h;h}r~ (jjhC]hB]h@]hA]hF]uhHKhIhhJ]r hUXsudo apt-get install tomcat7r r }r (h/Uh0j| ubaubhY)r }r (h/X5Otherwise, get Tomcat from the `Apache Tomcat`_ page.r h0jC h:h;h}r (h@]hA]hB]hC]hF]uhHKhIhhJ]r (hUXOtherwise, get Tomcat from the r r }r (h/XOtherwise, get Tomcat from the h0j ubh)r }r (h/X`Apache Tomcat`_jKh0j h}r (UnameX Apache Tomcatjj:hC]hB]h@]hA]hF]uhJ]r hUX Apache Tomcatr r }r (h/Uh0j ubaubhUX page.r r }r (h/X page.h0j ubeubhY)r }r (h/XGAfter installing Tomcat, you can switch back to the Sun JDK by typing::r h0jC h:h;h}r (h@]hA]hB]hC]hF]uhHKhIhhJ]r hUXFAfter installing Tomcat, you can switch back to the Sun JDK by typing:r r }r (h/XFAfter installing Tomcat, you can switch back to the Sun JDK by typing:h0j ubaubj)r }r (h/X&sudo update-alternatives --config javah0jC h:h;h}r (jjhC]hB]h@]hA]hF]uhHKhIhhJ]r hUX&sudo update-alternatives --config javar r }r (h/Uh0j ubaubhY)r }r (h/X,and selecting the correct Java installation.r h0jC h:h;h}r (h@]hA]hB]hC]hF]uhHKhIhhJ]r hUX,and selecting the correct Java installation.r r }r (h/j h0j ubaubhY)r }r (h/XkIf using Tomcat with Apache/mod_jk, enable the AJP connector on port 8009 by uncommenting that section in::r h0jC h:h;h}r (h@]hA]hB]hC]hF]uhHKhIhhJ]r hUXjIf using Tomcat with Apache/mod_jk, enable the AJP connector on port 8009 by uncommenting that section in:r r }r (h/XjIf using Tomcat with Apache/mod_jk, enable the AJP connector on port 8009 by uncommenting that section in:h0j ubaubj)r }r (h/X/conf/server.xmlh0jC h:h;h}r (jjhC]hB]h@]hA]hF]uhHKhIhhJ]r hUX/conf/server.xmlr r }r (h/Uh0j ubaubhY)r }r (h/XFor DataONE deployments edit::r h0jC h:h;h}r (h@]hA]hB]hC]hF]uhHKhIhhJ]r hUXFor DataONE deployments edit:r r }r (h/XFor DataONE deployments edit:h0j ubaubj)r }r (h/X /etc/tomcat7/catalina.propertiesh0jC h:h;h}r (jjhC]hB]h@]hA]hF]uhHKhIhhJ]r hUX /etc/tomcat7/catalina.propertiesr r }r (h/Uh0j ubaubhY)r }r (h/X to include::r h0jC h:h;h}r (h@]hA]hB]hC]hF]uhHKhIhhJ]r hUX to include:r r }r (h/X to include:h0j ubaubj)r }r (h/X}org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true org.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=trueh0jC h:h;h}r (jjhC]hB]h@]hA]hF]uhHKhIhhJ]r hUX}org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true org.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=truer r }r (h/Uh0j ubaubeubh1)r }r (h/Uh0jmh:h;h}r (h@]hA]hB]hC]r jjahF]r hauhHKhIhhJ]r (hL)r }r (h/joh0j h:h;h}r (hC]hB]h@]hA]hF]hRjiuhHKhIhhJ]r hUX(Apache HTTPD Server (Highly Recommended)r r }r (h/joh0j ubaubhY)r }r (h/XyAlthough you have the option of running Metacat with only the Tomcat server, we highly recommend that you run it behind the Apache Web server for several reasons; running Tomcat with the Apache server provides a more robust Web serving environment. The Apache Web server is required if you wish to install and run the Metacat Registry or to use the Metacat Replication feature.r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHKhIhhJ]r hUXyAlthough you have the option of running Metacat with only the Tomcat server, we highly recommend that you run it behind the Apache Web server for several reasons; running Tomcat with the Apache server provides a more robust Web serving environment. The Apache Web server is required if you wish to install and run the Metacat Registry or to use the Metacat Replication feature.r r }r (h/j h0j ubaubcdocutils.nodes sidebar r )r }r (h/X If you are running on an O/S other than Ubuntu/Debian (e.g., Fedora Core or RedHat Linux) or if you installed the Apache source or binary, you must manually edit the Apache configuration file, where is the directory in which Apache is installed: :: /conf/httpd.conf 1. Configure the log location and level for Mod JK. If your configuration file does not already have the following section, add it and set the log location to any place you'd like: :: JkLogFile "/var/log/tomcat/mod_jk.log" JkLogLevel info 2. Configure apache to route traffic to the Metacat application. ServerName should be set to the DNS name of the Metacat server. ScriptAlias and the following Directory section should both point to the cgi-bin directory inside your Metacat installation: :: DocumentRoot /var/www ServerName dev.nceas.ucsb.edu ## Allow CORS requests from all origins to use cookies #SetEnvIf Origin "^(.*)$" ORIGIN_DOMAIN=$1 #Header set Access-Control-Allow-Origin "%{ORIGIN_DOMAIN}e" env=ORIGIN_DOMAIN Header set Access-Control-Allow-Headers "Authorization, Content-Type, Origin, Cache-Control" Header set Access-Control-Allow-Methods "GET, POST, PUT, OPTIONS" Header set Access-Control-Allow-Credentials "true" ErrorLog /var/log/httpd/error_log CustomLog /var/log/httpd/access_log common ScriptAlias /cgi-bin/ "/var/www/cgi-bin/" AllowOverride None Options ExecCGI Order allow,deny Allow from all ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/" AllowOverride None Options ExecCGI Order allow,deny Allow from all JkMount /metacat ajp13 JkMount /metacat/* ajp13 JkMount /metacat/metacat ajp13 JkUnMount /metacat/cgi-bin/* ajp13 JkMount /metacatui ajp13 JkMount /metacatui/* ajp13 JkMount /*.jsp ajp13 3. Copy the "workers.properties" file provided by Metacat into your Apache configuration directory (/conf/). Depending on whether you are installing from binary distribution or source, the workers.properties file will be in one of two locations: * the directory in which you extracted the Metacat distribution (for binary distribution) * /src/scripts/workers.properties (for both the source distribution and source code checked out from SVN) 4. Edit the workers.properties file and make sure the following properties are set correctly: :: workers.tomcat_home - set to the Tomcat install directory. workers.java_home - set to the Java install directory. 5. Enable the Apache Mod HEADERS: :: sudo a2enmod headers 6. Restart Apache to bring in changes by typing: :: sudo /etc/init.d/apache2 restarth0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r (hL)r }r (h/X4Configuring Apache on an OS other than Ubuntu/Debianr h0j h:h;h}r (h@]hA]hB]hC]hF]uhHKhJ]r hUX4Configuring Apache on an OS other than Ubuntu/Debianr r }r (h/j h0j ubaubhY)r }r (h/X If you are running on an O/S other than Ubuntu/Debian (e.g., Fedora Core or RedHat Linux) or if you installed the Apache source or binary, you must manually edit the Apache configuration file, where is the directory in which Apache is installed:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHKhJ]r hUX If you are running on an O/S other than Ubuntu/Debian (e.g., Fedora Core or RedHat Linux) or if you installed the Apache source or binary, you must manually edit the Apache configuration file, where is the directory in which Apache is installed:r r }r (h/j h0j ubaubj)r }r (h/X$/conf/httpd.confh0j h}r (jjhC]hB]h@]hA]hF]uhHKhJ]r hUX$/conf/httpd.confr r }r (h/Uh0j ubaubj)r }r (h/Uh>}r (jU.hC]hB]h@]jUhA]hF]jj uh0j hJ]r h{)r }r (h/XConfigure the log location and level for Mod JK. If your configuration file does not already have the following section, add it and set the log location to any place you'd like: h>}r (h@]hA]hB]hC]hF]uh0j hJ]r hY)r }r (h/XConfigure the log location and level for Mod JK. If your configuration file does not already have the following section, add it and set the log location to any place you'd like:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHKhJ]r hUXConfigure the log location and level for Mod JK. If your configuration file does not already have the following section, add it and set the log location to any place you'd like:r r }r (h/j h0j ubaubah}r (h@]hA]hB]hC]hF]uh0j hJ]r j)r }r (h/XZ JkLogFile "/var/log/tomcat/mod_jk.log" JkLogLevel info h0j h}r! (jjhC]hB]h@]hA]hF]uhHKhJ]r" hUXZ JkLogFile "/var/log/tomcat/mod_jk.log" JkLogLevel info r# r$ }r% (h/Uh0j ubaubah}r( (jU.jKhC]hB]h@]jUhA]hF]jj uh0j hJ]r) h{)r* }r+ (h/XConfigure apache to route traffic to the Metacat application. ServerName should be set to the DNS name of the Metacat server. ScriptAlias and the following Directory section should both point to the cgi-bin directory inside your Metacat installation: h>}r, (h@]hA]hB]hC]hF]uh0j& hJ]r- hY)r. }r/ (h/XConfigure apache to route traffic to the Metacat application. ServerName should be set to the DNS name of the Metacat server. ScriptAlias and the following Directory section should both point to the cgi-bin directory inside your Metacat installation:r0 h0j* h:h;h}r1 (h@]hA]hB]hC]hF]uhHKhJ]r2 hUXConfigure apache to route traffic to the Metacat application. ServerName should be set to the DNS name of the Metacat server. ScriptAlias and the following Directory section should both point to the cgi-bin directory inside your Metacat installation:r3 r4 }r5 (h/j0 h0j. ubaubah}r8 (h@]hA]hB]hC]hF]uh0j hJ]r9 j)r: }r; (h/X DocumentRoot /var/www ServerName dev.nceas.ucsb.edu ## Allow CORS requests from all origins to use cookies #SetEnvIf Origin "^(.*)$" ORIGIN_DOMAIN=$1 #Header set Access-Control-Allow-Origin "%{ORIGIN_DOMAIN}e" env=ORIGIN_DOMAIN Header set Access-Control-Allow-Headers "Authorization, Content-Type, Origin, Cache-Control" Header set Access-Control-Allow-Methods "GET, POST, PUT, OPTIONS" Header set Access-Control-Allow-Credentials "true" ErrorLog /var/log/httpd/error_log CustomLog /var/log/httpd/access_log common ScriptAlias /cgi-bin/ "/var/www/cgi-bin/" AllowOverride None Options ExecCGI Order allow,deny Allow from all ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/" AllowOverride None Options ExecCGI Order allow,deny Allow from all JkMount /metacat ajp13 JkMount /metacat/* ajp13 JkMount /metacat/metacat ajp13 JkUnMount /metacat/cgi-bin/* ajp13 JkMount /metacatui ajp13 JkMount /metacatui/* ajp13 JkMount /*.jsp ajp13 h0j6 h}r< (jjhC]hB]h@]hA]hF]uhHKhJ]r= hUX DocumentRoot /var/www ServerName dev.nceas.ucsb.edu ## Allow CORS requests from all origins to use cookies #SetEnvIf Origin "^(.*)$" ORIGIN_DOMAIN=$1 #Header set Access-Control-Allow-Origin "%{ORIGIN_DOMAIN}e" env=ORIGIN_DOMAIN Header set Access-Control-Allow-Headers "Authorization, Content-Type, Origin, Cache-Control" Header set Access-Control-Allow-Methods "GET, POST, PUT, OPTIONS" Header set Access-Control-Allow-Credentials "true" ErrorLog /var/log/httpd/error_log CustomLog /var/log/httpd/access_log common ScriptAlias /cgi-bin/ "/var/www/cgi-bin/" AllowOverride None Options ExecCGI Order allow,deny Allow from all ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/" AllowOverride None Options ExecCGI Order allow,deny Allow from all JkMount /metacat ajp13 JkMount /metacat/* ajp13 JkMount /metacat/metacat ajp13 JkUnMount /metacat/cgi-bin/* ajp13 JkMount /metacatui ajp13 JkMount /metacatui/* ajp13 JkMount /*.jsp ajp13 r> r? }r@ (h/Uh0j: ubaubah}rC (jU.jKhC]hB]h@]jUhA]hF]jj uh0j hJ]rD h{)rE }rF (h/XCopy the "workers.properties" file provided by Metacat into your Apache configuration directory (/conf/). Depending on whether you are installing from binary distribution or source, the workers.properties file will be in one of two locations: h>}rG (h@]hA]hB]hC]hF]uh0jA hJ]rH hY)rI }rJ (h/XCopy the "workers.properties" file provided by Metacat into your Apache configuration directory (/conf/). Depending on whether you are installing from binary distribution or source, the workers.properties file will be in one of two locations:rK h0jE h:h;h}rL (h@]hA]hB]hC]hF]uhHMhJ]rM hUXCopy the "workers.properties" file provided by Metacat into your Apache configuration directory (/conf/). Depending on whether you are installing from binary distribution or source, the workers.properties file will be in one of two locations:rN rO }rP (h/jK h0jI ubaubah}rS (h@]hA]hB]hC]hF]uh0j hJ]rT hu)rU }rV (h/Uh>}rW (jX*hC]hB]h@]hA]hF]uh0jQ hJ]rX (h{)rY }rZ (h/XWthe directory in which you extracted the Metacat distribution (for binary distribution)r[ h>}r\ (h@]hA]hB]hC]hF]uh0jU hJ]r] hY)r^ }r_ (h/j[ h0jY h:h;h}r` (h@]hA]hB]hC]hF]uhHMhJ]ra hUXWthe directory in which you extracted the Metacat distribution (for binary distribution)rb rc }rd (h/j[ h0j^ ubaubah/src/scripts/workers.properties (for both the source distribution and source code checked out from SVN) h>}rg (h@]hA]hB]hC]hF]uh0jU hJ]rh hY)ri }rj (h/Xy/src/scripts/workers.properties (for both the source distribution and source code checked out from SVN)rk h0je h:h;h}rl (h@]hA]hB]hC]hF]uhHM hJ]rm hUXy/src/scripts/workers.properties (for both the source distribution and source code checked out from SVN)rn ro }rp (h/jk h0ji ubaubah}rs (jU.jKhC]hB]h@]jUhA]hF]jj uh0j hJ]rt h{)ru }rv (h/X[Edit the workers.properties file and make sure the following properties are set correctly: h>}rw (h@]hA]hB]hC]hF]uh0jq hJ]rx hY)ry }rz (h/XZEdit the workers.properties file and make sure the following properties are set correctly:r{ h0ju h:h;h}r| (h@]hA]hB]hC]hF]uhHM"hJ]r} hUXZEdit the workers.properties file and make sure the following properties are set correctly:r~ r }r (h/j{ h0jy ubaubah}r (h@]hA]hB]hC]hF]uh0j hJ]r j)r }r (h/Xrworkers.tomcat_home - set to the Tomcat install directory. workers.java_home - set to the Java install directory.h0j h}r (jjhC]hB]h@]hA]hF]uhHM&hJ]r hUXrworkers.tomcat_home - set to the Tomcat install directory. workers.java_home - set to the Java install directory.r r }r (h/Uh0j ubaubah}r (jU.jKhC]hB]h@]jUhA]hF]jj uh0j hJ]r h{)r }r (h/XEnable the Apache Mod HEADERS: h>}r (h@]hA]hB]hC]hF]uh0j hJ]r hY)r }r (h/XEnable the Apache Mod HEADERS:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHM)hJ]r hUXEnable the Apache Mod HEADERS:r r }r (h/j h0j ubaubah}r (h@]hA]hB]hC]hF]uh0j hJ]r j)r }r (h/Xsudo a2enmod headersh0j h}r (jjhC]hB]h@]hA]hF]uhHM-hJ]r hUXsudo a2enmod headersr r }r (h/Uh0j ubaubah}r (jU.jKhC]hB]h@]jUhA]hF]jj uh0j hJ]r h{)r }r (h/X.Restart Apache to bring in changes by typing: h>}r (h@]hA]hB]hC]hF]uh0j hJ]r hY)r }r (h/X-Restart Apache to bring in changes by typing:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHM/hJ]r hUX-Restart Apache to bring in changes by typing:r r }r (h/j h0j ubaubah}r (h@]hA]hB]hC]hF]uh0j hJ]r j)r }r (h/X sudo /etc/init.d/apache2 restarth0j h}r (jjhC]hB]h@]hA]hF]uhHM3hJ]r hUX sudo /etc/init.d/apache2 restartr r }r (h/Uh0j ubaubah}r (h@]hA]hB]hC]hF]uhHM5hIhhJ]r (hUXjThis section contains instructions for installing and configuring the Apache Web server for Metacat on an r r }r (h/XjThis section contains instructions for installing and configuring the Apache Web server for Metacat on an h0j ubh)r }r (h/XUbuntu_jKh0j h}r (UnameXUbuntujj hC]hB]h@]hA]hF]uhJ]r hUXUbuntur r }r (h/Uh0j ubaubhUXo/Debian system. Instructions for configuring Apache running on other Linux systems are included in the sidebar.r r }r (h/Xo/Debian system. Instructions for configuring Apache running on other Linux systems are included in the sidebar.h0j ubeubj)r }r (h/Uh0j h:h;h}r (jU.hC]hB]h@]jUhA]hF]jj uhHM9hIhhJ]r h{)r }r (h/XtInstall the Apache and Mod JK packages (Mod JK is the module Apache uses to talk to Tomcat applications) by typing: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/XsInstall the Apache and Mod JK packages (Mod JK is the module Apache uses to talk to Tomcat applications) by typing:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHM9hJ]r hUXsInstall the Apache and Mod JK packages (Mod JK is the module Apache uses to talk to Tomcat applications) by typing:r r }r (h/j h0j ubaubaubaubj)r }r (h/X.sudo apt-get install apache2 libapache2-mod-jkh0j h:h;h}r (jjhC]hB]h@]hA]hF]uhHM=hIhhJ]r hUX.sudo apt-get install apache2 libapache2-mod-jkr r }r (h/Uh0j ubaubhY)r }r (h/X`If you are installing the Apache server on an Ubuntu/Debian system, and you installed Apache using apt-get as described above, the Metacat code will have helper files that can be dropped into directories to configure Apache. Depending on whether you are installing from binary distribution or source, these helper files will be in one of two locations:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHM?hIhhJ]r hUX`If you are installing the Apache server on an Ubuntu/Debian system, and you installed Apache using apt-get as described above, the Metacat code will have helper files that can be dropped into directories to configure Apache. Depending on whether you are installing from binary distribution or source, these helper files will be in one of two locations:r r }r (h/j h0j ubaubhu)r }r (h/Uh0j h:h;h}r (jX*hC]hB]h@]hA]hF]uhHMEhIhhJ]r (h{)r }r (h/XOthe directory in which you extracted the distribution (for binary distribution)r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/j h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMEhJ]r hUXOthe directory in which you extracted the distribution (for binary distribution)r r }r (h/j h0j ubaubaubh{)r }r (h/X#``/src/scripts`` (for both the source distribution and source code checked out from SVN). We will refer to the directory with the helper scripts as ```` and the directory where Apache is installed (e.g., ``/etc/apache2/``) as ````. h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/X"``/src/scripts`` (for both the source distribution and source code checked out from SVN). We will refer to the directory with the helper scripts as ```` and the directory where Apache is installed (e.g., ``/etc/apache2/``) as ````.h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMFhJ]r (j6)r }r (h/X"``/src/scripts``h>}r (h@]hA]hB]hC]hF]uh0j hJ]r hUX/src/scriptsr r }r (h/Uh0j ubahubhUX (for both the source distribution and source code checked out from SVN). We will refer to the directory with the helper scripts as r r }r (h/X (for both the source distribution and source code checked out from SVN). We will refer to the directory with the helper scripts as h0j ubj6)r }r (h/X````h>}r (h@]hA]hB]hC]hF]uh0j hJ]r hUXr r }r (h/Uh0j ubahubhUX4 and the directory where Apache is installed (e.g., r r }r (h/X4 and the directory where Apache is installed (e.g., h0j ubj6)r }r (h/X``/etc/apache2/``h>}r (h@]hA]hB]hC]hF]uh0j hJ]r! hUX /etc/apache2/r" r# }r$ (h/Uh0j ubahubhUX) as r% r& }r' (h/X) as h0j ubj6)r( }r) (h/X````h>}r* (h@]hA]hB]hC]hF]uh0j hJ]r+ hUXr, r- }r. (h/Uh0j( ubahubhUX.r/ }r0 (h/X.h0j ubeubaubeubj)r1 }r2 (h/Uh0j h:h;h}r3 (jU.jKhC]hB]h@]jUhA]hF]jj uhHMHhIhhJ]r4 h{)r5 }r6 (h/X.Set up Mod JK apache configuration by typing: h0j1 h:h;h}r7 (h@]hA]hB]hC]hF]uhHNhIhhJ]r8 hY)r9 }r: (h/X-Set up Mod JK apache configuration by typing:r; h0j5 h:h;h}r< (h@]hA]hB]hC]hF]uhHMHhJ]r= hUX-Set up Mod JK apache configuration by typing:r> r? }r@ (h/j; h0j9 ubaubaubaubj)rA }rB (h/Xsudo cp /debian/jk.conf /mods-available sudo cp /debian/workers.properties h0j h:h;h}rC (jjhC]hB]h@]hA]hF]uhHMLhIhhJ]rD hUXsudo cp /debian/jk.conf /mods-available sudo cp /debian/workers.properties rE rF }rG (h/Uh0jA ubaubj)rH }rI (h/Uh0j h:h;h}rJ (jU.jKhC]hB]h@]jUhA]hF]jj uhHMOhIhhJ]rK h{)rL }rM (h/XKDisable and re-enable the Apache Mod JK module to pick up the new changes: h0jH h:h;h}rN (h@]hA]hB]hC]hF]uhHNhIhhJ]rO hY)rP }rQ (h/XJDisable and re-enable the Apache Mod JK module to pick up the new changes:rR h0jL h:h;h}rS (h@]hA]hB]hC]hF]uhHMOhJ]rT hUXJDisable and re-enable the Apache Mod JK module to pick up the new changes:rU rV }rW (h/jR h0jP ubaubaubaubj)rX }rY (h/X sudo a2dismod jk sudo a2enmod jkh0j h:h;h}rZ (jjhC]hB]h@]hA]hF]uhHMShIhhJ]r[ hUX sudo a2dismod jk sudo a2enmod jkr\ r] }r^ (h/Uh0jX ubaubj)r_ }r` (h/Uh0j h:h;h}ra (jU.jKhC]hB]h@]jUhA]hF]jj uhHMVhIhhJ]rb h{)rc }rd (h/XApache needs to know about the Metacat site. The helper file named "metacat-site.conf" has rules that tell Apache which traffic to route to Metacat. Set up Metacat site by dropping the metacat-site file into the sites-available directory and running a2ensite to enable the site: h0j_ h:h;h}re (h@]hA]hB]hC]hF]uhHNhIhhJ]rf hY)rg }rh (h/XApache needs to know about the Metacat site. The helper file named "metacat-site.conf" has rules that tell Apache which traffic to route to Metacat. Set up Metacat site by dropping the metacat-site file into the sites-available directory and running a2ensite to enable the site:ri h0jc h:h;h}rj (h@]hA]hB]hC]hF]uhHMVhJ]rk hUXApache needs to know about the Metacat site. The helper file named "metacat-site.conf" has rules that tell Apache which traffic to route to Metacat. Set up Metacat site by dropping the metacat-site file into the sites-available directory and running a2ensite to enable the site:rl rm }rn (h/ji h0jg ubaubaubaubj)ro }rp (h/Xssudo cp /metacat-site.conf /sites-available sudo a2ensite metacat-site.confh0j h:h;h}rq (jjhC]hB]h@]hA]hF]uhHMZhIhhJ]rr hUXssudo cp /metacat-site.conf /sites-available sudo a2ensite metacat-site.confrs rt }ru (h/Uh0jo ubaubj)rv }rw (h/Uh0j h:h;h}rx (jU.jKhC]hB]h@]jUhA]hF]jj uhHM]hIhhJ]ry h{)rz }r{ (h/X/Disable the default Apache site configuration: h0jv h:h;h}r| (h@]hA]hB]hC]hF]uhHNhIhhJ]r} hY)r~ }r (h/X.Disable the default Apache site configuration:r h0jz h:h;h}r (h@]hA]hB]hC]hF]uhHM]hJ]r hUX.Disable the default Apache site configuration:r r }r (h/j h0j~ ubaubaubaubj)r }r (h/Xsudo a2dissite 000-defaulth0j h:h;h}r (jjhC]hB]h@]hA]hF]uhHMahIhhJ]r hUXsudo a2dissite 000-defaultr r }r (h/Uh0j ubaubj)r }r (h/Uh0j h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHMchIhhJ]r h{)r }r (h/X.Restart Apache to bring in changes by typing: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/X-Restart Apache to bring in changes by typing:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMchJ]r hUX-Restart Apache to bring in changes by typing:r r }r (h/j h0j ubaubaubaubj)r }r (h/X sudo /etc/init.d/apache2 restarth0j h:h;h}r (jjhC]hB]h@]hA]hF]uhHMghIhhJ]r hUX sudo /etc/init.d/apache2 restartr r }r (h/Uh0j ubaubeubh1)r }r (h/UjxKh0jmh:h;h}r (h@]r j?ahA]hB]hC]r j}ahF]uhHMkhIhhJ]r (hL)r }r (h/jh0j h:h;h}r (hC]hB]h@]hA]hF]hRj|uhHMkhIhhJ]r hUXPostgreSQL Databaser r }r (h/jh0j ubaubhY)r }r (h/XCurrently Metacat only supports PostgreSQL_. You can choose the release versions of PostgreSQL 8, 9, 10 or 11. The newer versions are preferred. To install and configure PostgreSQL_:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMlhIhhJ]r (hUX Currently Metacat only supports r r }r (h/X Currently Metacat only supports h0j ubh)r }r (h/X PostgreSQL_jKh0j h}r (UnameX PostgreSQLjjhC]hB]h@]hA]hF]uhJ]r hUX PostgreSQLr r }r (h/Uh0j ubaubhUX. You can choose the release versions of PostgreSQL 8, 9, 10 or 11. The newer versions are preferred. To install and configure r r }r (h/X. You can choose the release versions of PostgreSQL 8, 9, 10 or 11. The newer versions are preferred. To install and configure h0j ubh)r }r (h/X PostgreSQL_jKh0j h}r (UnameX PostgreSQLjjhC]hB]h@]hA]hF]uhJ]r hUX PostgreSQLr r }r (h/Uh0j ubaubhUX:r }r (h/X:h0j ubeubj)r }r (h/Uh0j h:h;h}r (jU.hC]hB]h@]jUhA]hF]jj uhHMnhIhhJ]r h{)r }r (h/X=If you are running Ubuntu_/Debian, get PostgreSQL by typing: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/X<If you are running Ubuntu_/Debian, get PostgreSQL by typing:h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMnhJ]r (hUXIf you are running r r }r (h/XIf you are running h0j ubh)r }r (h/XUbuntu_jKh0j h}r (UnameXUbuntujj hC]hB]h@]hA]hF]uhJ]r hUXUbuntur r }r (h/Uh0j ubaubhUX"/Debian, get PostgreSQL by typing:r r }r (h/X"/Debian, get PostgreSQL by typing:h0j ubeubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r (j)r }r (h/Xsudo apt-get install postgresqlh0j h}r (jjhC]hB]h@]hA]hF]uhHMrhJ]r hUXsudo apt-get install postgresqlr r }r (h/Uh0j ubaubhY)r }r (h/X0On other systems, install the rpms for postgres.r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMthJ]r hUX0On other systems, install the rpms for postgres.r r }r (h/j h0j ubaubeubj)r }r (h/Uh0j h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHMvhIhhJ]r h{)r }r (h/XStart the database by running: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/XStart the database by running:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMvhJ]r hUXStart the database by running:r r }r (h/j h0j ubaubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r j)r }r (h/X%sudo /etc/init.d/postgresql-8.4 starth0j h}r (jjhC]hB]h@]hA]hF]uhHMzhJ]r hUX%sudo /etc/init.d/postgresql-8.4 startr r }r (h/Uh0j ubaubaubj)r }r (h/Uh0j h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHM|hIhhJ]r h{)r }r (h/XChange to postgres user: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/XChange to postgres user:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHM|hJ]r hUXChange to postgres user:r r! }r" (h/j h0j ubaubaubaubj)r# }r$ (h/Uh0j h:h;h}r% (h@]hA]hB]hC]hF]uhHNhIhhJ]r& j)r' }r( (h/Xsudo su - postgresh0j# h}r) (jjhC]hB]h@]hA]hF]uhHMhJ]r* hUXsudo su - postgresr+ r, }r- (h/Uh0j' ubaubaubj)r. }r/ (h/Uh0j h:h;h}r0 (jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r1 h{)r2 }r3 (h/XXSet up an empty Metacat database instance by editing the postgreSQL configuration file: h0j. h:h;h}r4 (h@]hA]hB]hC]hF]uhHNhIhhJ]r5 hY)r6 }r7 (h/XWSet up an empty Metacat database instance by editing the postgreSQL configuration file:r8 h0j2 h:h;h}r9 (h@]hA]hB]hC]hF]uhHMhJ]r: hUXWSet up an empty Metacat database instance by editing the postgreSQL configuration file:r; r< }r= (h/j8 h0j6 ubaubaubaubj)r> }r? (h/Uh0j h:h;h}r@ (h@]hA]hB]hC]hF]uhHNhIhhJ]rA (j)rB }rC (h/X*gedit /etc/postgresql/8.4/main/pg_hba.confh0j> h}rD (jjhC]hB]h@]hA]hF]uhHMhJ]rE hUX*gedit /etc/postgresql/8.4/main/pg_hba.confrF rG }rH (h/Uh0jB ubaubhY)rI }rJ (h/X1Add the following line to the configuration file:rK h0j> h:h;h}rL (h@]hA]hB]hC]hF]uhHMhJ]rM hUX1Add the following line to the configuration file:rN rO }rP (h/jK h0jI ubaubj)rQ }rR (h/X7host metacat metacat 127.0.0.1 255.255.255.255 passwordh0j> h}rS (jjhC]hB]h@]hA]hF]uhHMhJ]rT hUX7host metacat metacat 127.0.0.1 255.255.255.255 passwordrU rV }rW (h/Uh0jQ ubaubhY)rX }rY (h/X3Save the file and then create the Metacat instance:rZ h0j> h:h;h}r[ (h@]hA]hB]hC]hF]uhHMhJ]r\ hUX3Save the file and then create the Metacat instance:r] r^ }r_ (h/jZ h0jX ubaubj)r` }ra (h/Xcreatedb metacath0j> h}rb (jjhC]hB]h@]hA]hF]uhHMhJ]rc hUXcreatedb metacatrd re }rf (h/Uh0j` ubaubeubj)rg }rh (h/Uh0j h:h;h}ri (jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rj h{)rk }rl (h/X Log in to postgreSQL by typing: h0jg h:h;h}rm (h@]hA]hB]hC]hF]uhHNhIhhJ]rn hY)ro }rp (h/XLog in to postgreSQL by typing:rq h0jk h:h;h}rr (h@]hA]hB]hC]hF]uhHMhJ]rs hUXLog in to postgreSQL by typing:rt ru }rv (h/jq h0jo ubaubaubaubj)rw }rx (h/Uh0j h:h;h}ry (h@]hA]hB]hC]hF]uhHNhIhhJ]rz j)r{ }r| (h/X psql metacath0jw h}r} (jjhC]hB]h@]hA]hF]uhHMhJ]r~ hUX psql metacatr r }r (h/Uh0j{ ubaubaubj)r }r (h/Uh0j h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/X7At the psql prompt, create the Metacat user by typing: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/X6At the psql prompt, create the Metacat user by typing:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUX6At the psql prompt, create the Metacat user by typing:r r }r (h/j h0j ubaubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r (j)r }r (h/X2CREATE USER metacat WITH PASSWORD 'your_password';h0j h}r (jjhC]hB]h@]hA]hF]uhHMhJ]r hUX2CREATE USER metacat WITH PASSWORD 'your_password';r r }r (h/Uh0j ubaubhY)r }r (h/XOwhere 'your_password' is whatever password you would like for the Metacat user.r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUXOwhere 'your_password' is whatever password you would like for the Metacat user.r r }r (h/j h0j ubaubeubj)r }r (h/Uh0j h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/XExit PostgreSQL by typing h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/XExit PostgreSQL by typingr h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUXExit PostgreSQL by typingr r }r (h/j h0j ubaubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r j)r }r (h/X\qh0j h}r (jjhC]hB]h@]hA]hF]uhHMhJ]r hUX\qr r }r (h/Uh0j ubaubaubj)r }r (h/Uh0j h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/X5Restart the PostgreSQL database to bring in changes: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/X4Restart the PostgreSQL database to bring in changes:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUX4Restart the PostgreSQL database to bring in changes:r r }r (h/j h0j ubaubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r j)r }r (h/X"/etc/init.d/postgresql-8.4 restarth0j h}r (jjhC]hB]h@]hA]hF]uhHMhJ]r hUX"/etc/init.d/postgresql-8.4 restartr r }r (h/Uh0j ubaubaubj)r }r (h/Uh0j h:h;h}r (jU.jK hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/X0Log out of the postgres user account by typing: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/X/Log out of the postgres user account by typing:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUX/Log out of the postgres user account by typing:r r }r (h/j h0j ubaubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r j)r }r (h/Xlogouth0j h}r (jjhC]hB]h@]hA]hF]uhHMhJ]r hUXlogoutr r }r (h/Uh0j ubaubaubj)r }r (h/Uh0j h:h;h}r (jU.jK hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/X5Test the installation and Metacat account by typing: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/X4Test the installation and Metacat account by typing:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUX4Test the installation and Metacat account by typing:r r }r (h/j h0j ubaubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r j)r }r (h/X'psql -U metacat -W -h localhost metacath0j h}r (jjhC]hB]h@]hA]hF]uhHMhJ]r hUX'psql -U metacat -W -h localhost metacatr r }r (h/Uh0j ubaubaubj)r }r (h/Uh0j h:h;h}r (jU.jK hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/XLog out of postgreSQL: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/XLog out of postgreSQL:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUXLog out of postgreSQL:r r }r (h/j h0j ubaubaubaubj)r! }r" (h/Uh0j h:h;h}r# (h@]hA]hB]hC]hF]uhHNhIhhJ]r$ j)r% }r& (h/X\qh0j! h}r' (jjhC]hB]h@]hA]hF]uhHMhJ]r( hUX\qr) r* }r+ (h/Uh0j% ubaubaubhY)r, }r- (h/XThe Metacat servlet automatically creates the required database schema. For more information about configuring the database, please see Database Configuration.r. h0j h:h;h}r/ (h@]hA]hB]hC]hF]uhHMhIhhJ]r0 hUXThe Metacat servlet automatically creates the required database schema. For more information about configuring the database, please see Database Configuration.r1 r2 }r3 (h/j. h0j, ubaubeubh1)r4 }r5 (h/Uh0jmh:h;h}r6 (h@]hA]hB]hC]r7 jahF]r8 hauhHMhIhhJ]r9 (hL)r: }r; (h/jh0j4 h:h;h}r< (hC]hB]h@]hA]hF]hRjuhHMhIhhJ]r= hUX$Apache Ant (if building from Source)r> r? }r@ (h/jh0j: ubaubhY)rA }rB (h/XIf you are building Metacat from a source distribution or from source code checked out from SVN, Ant is required. (Users installing Metacat from the binary distribution do not require it.) Ant is a Java-based build application similar to Make on UNIX systems. It takes build instructions from a file named "build.xml", which is found in the root installation directory. Metacat source code comes with a default "build.xml" file that may require some modification upon installation.rC h0j4 h:h;h}rD (h@]hA]hB]hC]hF]uhHMhIhhJ]rE hUXIf you are building Metacat from a source distribution or from source code checked out from SVN, Ant is required. (Users installing Metacat from the binary distribution do not require it.) Ant is a Java-based build application similar to Make on UNIX systems. It takes build instructions from a file named "build.xml", which is found in the root installation directory. Metacat source code comes with a default "build.xml" file that may require some modification upon installation.rF rG }rH (h/jC h0jA ubaubhY)rI }rJ (h/X5If you are running Ubuntu/Debian, get Ant by typing::rK h0j4 h:h;h}rL (h@]hA]hB]hC]hF]uhHMhIhhJ]rM hUX4If you are running Ubuntu/Debian, get Ant by typing:rN rO }rP (h/X4If you are running Ubuntu/Debian, get Ant by typing:h0jI ubaubj)rQ }rR (h/Xsudo apt-get install anth0j4 h:h;h}rS (jjhC]hB]h@]hA]hF]uhHMhIhhJ]rT hUXsudo apt-get install antrU rV }rW (h/Uh0jQ ubaubhY)rX }rY (h/X3Otherwise, get Ant from the `Apache Ant`_ homepage.rZ h0j4 h:h;h}r[ (h@]hA]hB]hC]hF]uhHMhIhhJ]r\ (hUXOtherwise, get Ant from the r] r^ }r_ (h/XOtherwise, get Ant from the h0jX ubh)r` }ra (h/X `Apache Ant`_jKh0jX h}rb (UnameX Apache Antjj&hC]hB]h@]hA]hF]uhJ]rc hUX Apache Antrd re }rf (h/Uh0j` ubaubhUX homepage.rg rh }ri (h/X homepage.h0jX ubeubhY)rj }rk (h/XAnt should be installed on your system and the "ant" executable shell script should be available in the user's path. The latest Metacat release was tested with Ant 1.8.2.rl h0j4 h:h;h}rm (h@]hA]hB]hC]hF]uhHMhIhhJ]rn hUXAnt should be installed on your system and the "ant" executable shell script should be available in the user's path. The latest Metacat release was tested with Ant 1.8.2.ro rp }rq (h/jl h0jj ubaubeubeubh1)rr }rs (h/UjxKh0h6h:h;h}rt (h@]ru jhahA]hB]hC]rv jahF]uhHMhIhhJ]rw (hL)rx }ry (h/jh0jr h:h;h}rz (hC]hB]h@]hA]hF]hRjuhHMhIhhJ]r{ hUXInstalling Metacatr| r} }r~ (h/jh0jx ubaubhY)r }r (h/XTInstructions for a new install, an upgrade, and a source install are included below.r h0jr h:h;h}r (h@]hA]hB]hC]hF]uhHMhIhhJ]r hUXTInstructions for a new install, an upgrade, and a source install are included below.r r }r (h/j h0j ubaubh1)r }r (h/UjxKh0jr h:h;h}r (h@]r j~ahA]hB]hC]r jahF]uhHMhIhhJ]r (hL)r }r (h/jh0j h:h;h}r (hC]hB]h@]hA]hF]hRjuhHMhIhhJ]r hUX New Installr r }r (h/jh0j ubaubhY)r }r (h/X)Before installing Metacat, please ensure that all required applications are installed, configured to run with Metacat, and running correctly. If you are upgrading an existing Metacat servlet, please skip to Upgrade. For information about installing from source, skip to Source Install and Upgrade.r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhIhhJ]r hUX)Before installing Metacat, please ensure that all required applications are installed, configured to run with Metacat, and running correctly. If you are upgrading an existing Metacat servlet, please skip to Upgrade. For information about installing from source, skip to Source Install and Upgrade.r r }r (h/j h0j ubaubhY)r }r (h/X!To install a new Metacat servlet:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhIhhJ]r hUX!To install a new Metacat servlet:r r }r (h/j h0j ubaubj)r }r (h/Uh0j h:h;h}r (jU.hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/XCreate the Metacat directory. Metacat uses a base directory to store data, metadata, temporary files, and configuration backups. This directory should be outside of the Tomcat application directory so that it will not get wiped out during an upgrade. Typically, the directory is '/var/metacat', as shown in the instructions. If you choose a different location, remember it. You will be asked to configure Metacat to point to the base directory at startup. Create the Metacat directory by typing: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/XCreate the Metacat directory. Metacat uses a base directory to store data, metadata, temporary files, and configuration backups. This directory should be outside of the Tomcat application directory so that it will not get wiped out during an upgrade. Typically, the directory is '/var/metacat', as shown in the instructions. If you choose a different location, remember it. You will be asked to configure Metacat to point to the base directory at startup. Create the Metacat directory by typing:r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUXCreate the Metacat directory. Metacat uses a base directory to store data, metadata, temporary files, and configuration backups. This directory should be outside of the Tomcat application directory so that it will not get wiped out during an upgrade. Typically, the directory is '/var/metacat', as shown in the instructions. If you choose a different location, remember it. You will be asked to configure Metacat to point to the base directory at startup. Create the Metacat directory by typing:r r }r (h/j h0j ubaubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r j)r }r (h/Xsudo mkdir /var/metacath0j h}r (jjhC]hB]h@]hA]hF]uhHMhJ]r hUXsudo mkdir /var/metacatr r }r (h/Uh0j ubaubaubj)r }r (h/Uh0j h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/XChange the ownership of the directory to the user that will start Tomcat by typing (note: If you are starting Tomcat as the root user, you do not need to run the chown command): h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/XChange the ownership of the directory to the user that will start Tomcat by typing (note: If you are starting Tomcat as the root user, you do not need to run the chown command):r h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUXChange the ownership of the directory to the user that will start Tomcat by typing (note: If you are starting Tomcat as the root user, you do not need to run the chown command):r r }r (h/j h0j ubaubaubaubj)r }r (h/Uh0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r j)r }r (h/X(sudo chown -R /var/metacath0j h}r (jjhC]hB]h@]hA]hF]uhHMhJ]r hUX(sudo chown -R /var/metacatr r }r (h/Uh0j ubaubaubj)r }r (h/Uh0j h:h;h}r (jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r h{)r }r (h/XInstall the Metacat, Metacat-index and MetacatUI WAR in the Tomcat web-application directory. For instructions on downloading the Metacat WAR, please see Downloading Metacat. Typically, Tomcat will look for its application files (WAR files) in the /webapps directory (e.g., /usr/share/tomcat7/webapps). Your instance of Tomcat may be configured to look in a different directory. We will refer to the Tomcat application directory as . NOTE: The name of the WAR file (e.g., metacat.war) provides the application context, which appears in the URL of the Metacat (e.g., http://yourserver.com/metacat/). To change the context, simply change the name of the WAR file to the desired name before copying it. To install the Metacat WAR: h0j h:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r hY)r }r (h/XInstall the Metacat, Metacat-index and MetacatUI WAR in the Tomcat web-application directory. For instructions on downloading the Metacat WAR, please see Downloading Metacat. Typically, Tomcat will look for its application files (WAR files) in the /webapps directory (e.g., /usr/share/tomcat7/webapps). Your instance of Tomcat may be configured to look in a different directory. We will refer to the Tomcat application directory as . NOTE: The name of the WAR file (e.g., metacat.war) provides the application context, which appears in the URL of the Metacat (e.g., http://yourserver.com/metacat/). To change the context, simply change the name of the WAR file to the desired name before copying it. To install the Metacat WAR:h0j h:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r (hUXUInstall the Metacat, Metacat-index and MetacatUI WAR in the Tomcat web-application directory. For instructions on downloading the Metacat WAR, please see Downloading Metacat. Typically, Tomcat will look for its application files (WAR files) in the /webapps directory (e.g., /usr/share/tomcat7/webapps). Your instance of Tomcat may be configured to look in a different directory. We will refer to the Tomcat application directory as . NOTE: The name of the WAR file (e.g., metacat.war) provides the application context, which appears in the URL of the Metacat (e.g., r r }r (h/XUInstall the Metacat, Metacat-index and MetacatUI WAR in the Tomcat web-application directory. For instructions on downloading the Metacat WAR, please see Downloading Metacat. Typically, Tomcat will look for its application files (WAR files) in the /webapps directory (e.g., /usr/share/tomcat7/webapps). Your instance of Tomcat may be configured to look in a different directory. We will refer to the Tomcat application directory as . NOTE: The name of the WAR file (e.g., metacat.war) provides the application context, which appears in the URL of the Metacat (e.g., h0j ubh)r }r (h/Xhttp://yourserver.com/metacat/r h>}r (Urefurij hC]hB]h@]hA]hF]uh0j hJ]r hUXhttp://yourserver.com/metacat/r r }r (h/Uh0j ubah}r (h@]hA]hB]hC]hF]uhHNhIhhJ]r j)r }r (h/Xsudo cp /metacat.war sudo cp /metacat-index.war sudo cp /metacatui.war h0j h}r (jjhC]hB]h@]hA]hF]uhHMhJ]r hUXsudo cp /metacat.war sudo cp /metacat-index.war sudo cp /metacatui.war r r }r (h/Uh0j ubaubaubj)r }r(h/Uh0j h:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/X[Restart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type: h0j h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:r h0jh:h;h}r (h@]hA]hB]hC]hF]uhHMhJ]r hUXZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:r r }r(h/j h0jubaubaubaubj)r}r(h/Uh0j h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X sudo /etc/init.d/tomcat7 restarth0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUX sudo /etc/init.d/tomcat7 restartrr}r(h/Uh0jubaubaubhY)r}r(h/X[Congratulations! You have now installed Metacat. If everything is installed correctly, you should see the Authentication Configuration screen (Figure 2.1) when you type http://yourserver.com/yourcontext/ (e.g., http://knb.ecoinformatics.org/knb) into a browser. For more information about configuring Metacat, please see the Configuration Section.h0j h:h;h}r(h@]hA]hB]hC]hF]uhHMhIhhJ]r(hUXCongratulations! You have now installed Metacat. If everything is installed correctly, you should see the Authentication Configuration screen (Figure 2.1) when you type rr}r (h/XCongratulations! You have now installed Metacat. If everything is installed correctly, you should see the Authentication Configuration screen (Figure 2.1) when you type h0jubh)r!}r"(h/X"http://yourserver.com/yourcontext/r#h>}r$(Urefurij#hC]hB]h@]hA]hF]uh0jhJ]r%hUX"http://yourserver.com/yourcontext/r&r'}r((h/Uh0j!ubah}r/(Urefurij.hC]hB]h@]hA]hF]uh0jhJ]r0hUX!http://knb.ecoinformatics.org/knbr1r2}r3(h/Uh0j,ubah}r;(Ualignr<XcenterhC]r=Uid8r>ahB]h@]hA]hF]uhHNhIhhJ]r?(cdocutils.nodes image r@)rA}rB(h/X.. figure:: images/screenshots/image009.png :align: center The Authentication Configuration screen appears the first time you open a new installation of Metacat. h>}rC(UuriXimages/screenshots/image009.pngrDhC]hB]h@]hA]U candidatesrE}rFU*jDshF]uh0j8hJ]h}rM(h@]hA]hB]hC]hF]uhHMhJ]rNhUXfThe Authentication Configuration screen appears the first time you open a new installation of Metacat.rOrP}rQ(h/jKh0jIubaubeubeubh1)rR}rS(h/Uh0jr h:h;h}rT(h@]hA]hB]hC]rUjahF]rVhauhHMhIhhJ]rW(hL)rX}rY(h/jh0jRh:h;h}rZ(hC]hB]h@]hA]hF]hRjuhHMhIhhJ]r[hUXUpgrade Metacatr\r]}r^(h/jh0jXubaubhY)r_}r`(h/XTo upgrade an existing binary Metacat installation follow the steps in this section. The steps for upgrading Metacat from source are the same as the instructions for installing from source:rah0jRh:h;h}rb(h@]hA]hB]hC]hF]uhHMhIhhJ]rchUXTo upgrade an existing binary Metacat installation follow the steps in this section. The steps for upgrading Metacat from source are the same as the instructions for installing from source:rdre}rf(h/jah0j_ubaubj)rg}rh(h/Uh0jRh:h;h}ri(jU.hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rj(h{)rk}rl(h/XDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Downloading Metacat. h0jgh:h;h}rm(h@]hA]hB]hC]hF]uhHNhIhhJ]rnhY)ro}rp(h/XDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Downloading Metacat.rqh0jkh:h;h}rr(h@]hA]hB]hC]hF]uhHMhJ]rshUXDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Downloading Metacat.rtru}rv(h/jqh0joubaubaubh{)rw}rx(h/XrStop running Metacat. To stop Metacat, log in as the user that runs your Tomcat server (often "tomcat") and type: h0jgh:h;h}ry(h@]hA]hB]hC]hF]uhHNhIhhJ]rzhY)r{}r|(h/XqStop running Metacat. To stop Metacat, log in as the user that runs your Tomcat server (often "tomcat") and type:r}h0jwh:h;h}r~(h@]hA]hB]hC]hF]uhHMhJ]rhUXqStop running Metacat. To stop Metacat, log in as the user that runs your Tomcat server (often "tomcat") and type:rr}r(h/j}h0j{ubaubaubeubj)r}r(h/Uh0jRh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X/etc/init.d/tomcat7 stoph0jh}r(jjhC]hB]h@]hA]hF]uhHM hJ]rhUX/etc/init.d/tomcat7 stoprr}r(h/Uh0jubaubaubj)r}r(h/Uh0jRh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHM"hIhhJ]rh{)r}r(h/XBack up the existing Metacat installation. Although not required, we highly recommend that you back up your existing Metacat to a backup directory () before installing a new one. You can do so by typing: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XBack up the existing Metacat installation. Although not required, we highly recommend that you back up your existing Metacat to a backup directory () before installing a new one. You can do so by typing:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM"hJ]rhUXBack up the existing Metacat installation. Although not required, we highly recommend that you back up your existing Metacat to a backup directory () before installing a new one. You can do so by typing:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0jRh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]r(j)r}r(h/Xycp /metacat /metacat. cp /metacat.war /metacat.war.h0jh}r(jjhC]hB]h@]hA]hF]uhHM&hJ]rhUXycp /metacat /metacat. cp /metacat.war /metacat.war.rr}r(h/Uh0jubaubhY)r}r(h/XzWarning: Do not backup the files to the ```` directory. Tomcat will try to run the backup copy as a service.h0jh:h;h}r(h@]hA]hB]hC]hF]uhHM)hJ]r(hUX(Warning: Do not backup the files to the rr}r(h/X(Warning: Do not backup the files to the h0jubj6)r}r(h/X````h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX rr}r(h/Uh0jubahubhUXA directory. Tomcat will try to run the backup copy as a service.rr}r(h/XA directory. Tomcat will try to run the backup copy as a service.h0jubeubeubj)r}r(h/Uh0jRh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHM,hIhhJ]rh{)r}r(h/XGCopy the new Metacat WAR file in to the Tomcat applications directory: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XFCopy the new Metacat WAR file in to the Tomcat applications directory:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM,hJ]rhUXFCopy the new Metacat WAR file in to the Tomcat applications directory:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0jRh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]r(j)r}r(h/X:sudo cp /metacat.war h0jh}r(jjhC]hB]h@]hA]hF]uhHM0hJ]rhUX:sudo cp /metacat.war rr}r(h/Uh0jubaubhY)r}r(h/XNote: Typically, Tomcat will look for its application files (WAR files) in the ``/webapps`` directory. Your instance of Tomcat may be configured to look in a different directory.h0jh:h;h}r(h@]hA]hB]hC]hF]uhHM2hJ]r(hUXONote: Typically, Tomcat will look for its application files (WAR files) in the rr}r(h/XONote: Typically, Tomcat will look for its application files (WAR files) in the h0jubj6)r}r(h/X``/webapps``h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX/webappsrr}r(h/Uh0jubahubhUXW directory. Your instance of Tomcat may be configured to look in a different directory.rr}r(h/XW directory. Your instance of Tomcat may be configured to look in a different directory.h0jubeubeubj)r}r(h/Uh0jRh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHM6hIhhJ]rh{)r}r(h/XIf you have been (or would like to start) running an LSID server, copy the new authority.war file to the Tomcat applications directory. For more information about the LSID server, please see Optional Installation Options. h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XIf you have been (or would like to start) running an LSID server, copy the new authority.war file to the Tomcat applications directory. For more information about the LSID server, please see Optional Installation Options.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM6hJ]rhUXIf you have been (or would like to start) running an LSID server, copy the new authority.war file to the Tomcat applications directory. For more information about the LSID server, please see Optional Installation Options.rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0jRh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X<sudo cp /authority.war h0jh}r(jjhC]hB]h@]hA]hF]uhHM:hJ]rhUX<sudo cp /authority.war rr}r(h/Uh0jubaubaubj)r}r(h/Uh0jRh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHM<hIhhJ]rh{)r}r(h/XRestart Tomcat (and Apache if you have Tomcat integrated with it). Log in as the user that runs your Tomcat server (often "tomcat"), and type: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r }r (h/XRestart Tomcat (and Apache if you have Tomcat integrated with it). Log in as the user that runs your Tomcat server (often "tomcat"), and type:r h0jh:h;h}r (h@]hA]hB]hC]hF]uhHM<hJ]r hUXRestart Tomcat (and Apache if you have Tomcat integrated with it). Log in as the user that runs your Tomcat server (often "tomcat"), and type:rr}r(h/j h0j ubaubaubaubj)r}r(h/Uh0jRh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X/etc/init.d/tomcat7 restarth0jh}r(jjhC]hB]h@]hA]hF]uhHM@hJ]rhUX/etc/init.d/tomcat7 restartrr}r(h/Uh0jubaubaubhY)r}r(h/X{7. Run your new Metacat servlet. Go to a Web browser and visit your installed Metacat application, using a URL of the form:rh0jRh:h;h}r(h@]hA]hB]hC]hF]uhHMChIhhJ]r hUX{7. Run your new Metacat servlet. Go to a Web browser and visit your installed Metacat application, using a URL of the form:r!r"}r#(h/jh0jubaubj)r$}r%(h/Uh0jRh:h;h}r&(h@]hA]hB]hC]hF]uhHNhIhhJ]r'j)r(}r)(h/X-http://yourserver.yourdomain.com/yourcontext/h0j$h}r*(jjhC]hB]h@]hA]hF]uhHMHhJ]r+hUX-http://yourserver.yourdomain.com/yourcontext/r,r-}r.(h/Uh0j(ubaubaubhY)r/}r0(h/XYou should substitute your context name for "yourcontext" in the URL above (your context will be "metacat" unless you change the name of the metacat.war file to something else). If everything is working correctly, you should be presented with Metacat's Authorization Configuration screen. Note that if you do not have Tomcat integrated with Apache you will probably have to type http://yourserver.yourdomain.com:8080/yourcontext/h0jRh:h;h}r1(h@]hA]hB]hC]hF]uhHMJhIhhJ]r2(hUX{You should substitute your context name for "yourcontext" in the URL above (your context will be "metacat" unless you change the name of the metacat.war file to something else). If everything is working correctly, you should be presented with Metacat's Authorization Configuration screen. Note that if you do not have Tomcat integrated with Apache you will probably have to type r3r4}r5(h/X{You should substitute your context name for "yourcontext" in the URL above (your context will be "metacat" unless you change the name of the metacat.war file to something else). If everything is working correctly, you should be presented with Metacat's Authorization Configuration screen. Note that if you do not have Tomcat integrated with Apache you will probably have to type h0j/ubh)r6}r7(h/X2http://yourserver.yourdomain.com:8080/yourcontext/r8h>}r9(Urefurij8hC]hB]h@]hA]hF]uh0j/hJ]r:hUX2http://yourserver.yourdomain.com:8080/yourcontext/r;r<}r=(h/Uh0j6ubah}r?(h/Uh0jr h:h;h}r@(h@]hA]hB]hC]rAjahF]rBhauhHMRhIhhJ]rC(hL)rD}rE(h/jh0j>h:h;h}rF(hC]hB]h@]hA]hF]hRjuhHMRhIhhJ]rGhUXSource Install and UpgraderHrI}rJ(h/jh0jDubaubhY)rK}rL(h/XWhether you are building Metacat from the source distribution or source code checked out from SVN, you will need Apache Ant to do the build (see Installing and Configuring Required Software for more information about Ant).rMh0j>h:h;h}rN(h@]hA]hB]hC]hF]uhHMShIhhJ]rOhUXWhether you are building Metacat from the source distribution or source code checked out from SVN, you will need Apache Ant to do the build (see Installing and Configuring Required Software for more information about Ant).rPrQ}rR(h/jMh0jKubaubhY)rS}rT(h/XTo install Metacat from source:rUh0j>h:h;h}rV(h@]hA]hB]hC]hF]uhHMWhIhhJ]rWhUXTo install Metacat from source:rXrY}rZ(h/jUh0jSubaubj)r[}r\(h/Uh0j>h:h;h}r](jU.hC]hB]h@]jUhA]hF]jj uhHMYhIhhJ]r^h{)r_}r`(h/XEdit the build.properties file found in the directory in which you downloaded Metacat. Note: Throughout the instructions, we will refer to this directory as ````. h0j[h:h;h}ra(h@]hA]hB]hC]hF]uhHNhIhhJ]rbhY)rc}rd(h/XEdit the build.properties file found in the directory in which you downloaded Metacat. Note: Throughout the instructions, we will refer to this directory as ````.h0j_h:h;h}re(h@]hA]hB]hC]hF]uhHMYhJ]rf(hUXEdit the build.properties file found in the directory in which you downloaded Metacat. Note: Throughout the instructions, we will refer to this directory as rgrh}ri(h/XEdit the build.properties file found in the directory in which you downloaded Metacat. Note: Throughout the instructions, we will refer to this directory as h0jcubj6)rj}rk(h/X````h>}rl(h@]hA]hB]hC]hF]uh0jchJ]rmhUXrnro}rp(h/Uh0jjubahubhUX.rq}rr(h/X.h0jcubeubaubaubj)rs}rt(h/Uh0j>h:Nh}ru(h@]hA]hB]hC]hF]uhHNhIhhJ]rvhu)rw}rx(h/Uh>}ry(jX*hC]hB]h@]hA]hF]uh0jshJ]rz(h{)r{}r|(h/XSet the build.tomcat.dir property to your Tomcat installation directory. Metacat will use some of the native Tomcat libraries during the build. For instance: build.tomcat.dir=/usr/local/tomcath>}r}(h@]hA]hB]hC]hF]uh0jwhJ]r~hY)r}r(h/XSet the build.tomcat.dir property to your Tomcat installation directory. Metacat will use some of the native Tomcat libraries during the build. For instance: build.tomcat.dir=/usr/local/tomcatrh0j{h:h;h}r(h@]hA]hB]hC]hF]uhHM]hJ]rhUXSet the build.tomcat.dir property to your Tomcat installation directory. Metacat will use some of the native Tomcat libraries during the build. For instance: build.tomcat.dir=/usr/local/tomcatrr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jwhJ]rhY)r}r(h/XSet the app.deploy.dir property to your application deployment directory. For instance: app.deploy.dir=/usr/local/tomcat/webappsrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHM`hJ]rhUXSet the app.deploy.dir property to your application deployment directory. For instance: app.deploy.dir=/usr/local/tomcat/webappsrr}r(h/jh0jubaubahh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMchIhhJ]rh{)r}r(h/X#In the ````, run: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X"In the ````, run:h0jh:h;h}r(h@]hA]hB]hC]hF]uhHMchJ]r(hUXIn the rr}r(h/XIn the h0jubj6)r}r(h/X````h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUXrr}r(h/Uh0jubahubhUX, run:rr}r(h/X, run:h0jubeubaubaubj)r}r(h/Uh0j>h:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]r(j)r}r(h/Xsudo ant clean installh0jh}r(jjhC]hB]h@]hA]hF]uhHMghJ]rhUXsudo ant clean installrr}r(h/Uh0jubaubhY)r}r(h/XfYou will see the individual modules get built. You should see a "BUILD SUCCESSFUL" message at the end.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMihJ]rhUXfYou will see the individual modules get built. You should see a "BUILD SUCCESSFUL" message at the end.rr}r(h/jh0jubaubhY)r}r(h/XUYou should see a new file named metacat.war in your application deployment directory.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMlhJ]rhUXUYou should see a new file named metacat.war in your application deployment directory.rr}r(h/jh0jubaubeubhY)r}r(h/X>To run your new Metacat servlet, open a Web browser and type::rh0j>h:h;h}r(h@]hA]hB]hC]hF]uhHMohIhhJ]rhUX=To run your new Metacat servlet, open a Web browser and type:rr}r(h/X=To run your new Metacat servlet, open a Web browser and type:h0jubaubj)r}r(h/X\http://yourserver.yourdomain.com/yourcontext/ (e.g. http://knb.ecoinformatics.org/metacat/)h0j>h:h;h}r(jjhC]hB]h@]hA]hF]uhHMqhIhhJ]rhUX\http://yourserver.yourdomain.com/yourcontext/ (e.g. http://knb.ecoinformatics.org/metacat/)rr}r(h/Uh0jubaubhY)r}r(h/XYour context will be "metacat" unless you changed the name of the metacat.war file to something else. The servlet may require a few seconds to start up, but once it is running, you will be presented with the Authorization Configuration screen.rh0j>h:h;h}r(h@]hA]hB]hC]hF]uhHMthIhhJ]rhUXYour context will be "metacat" unless you changed the name of the metacat.war file to something else. The servlet may require a few seconds to start up, but once it is running, you will be presented with the Authorization Configuration screen.rr}r(h/jh0jubaubeubeubh1)r}r(h/Uh0h6h:h;h}r(h@]hA]hB]hC]rjahF]rhauhHMyhIhhJ]r(hL)r}r(h/jh0jh:h;h}r(hC]hB]h@]hA]hF]hRjuhHMyhIhhJ]rhUX+Optional Installation Options (LSID Server)rr}r(h/jh0jubaubcdocutils.nodes note r)r}r(h/XThe support for LSID identifiers is deprecated, and is being replaced with support for DOI_ identifiers in a future release. We are maintaining support for LSIDs on one particular site, but this support will be removed in a future version of Metacat.h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XThe support for LSID identifiers is deprecated, and is being replaced with support for DOI_ identifiers in a future release. We are maintaining support for LSIDs on one particular site, but this support will be removed in a future version of Metacat.h0jh:h;h}r(h@]hA]hB]hC]hF]uhHM}hJ]r(hUXWThe support for LSID identifiers is deprecated, and is being replaced with support for rr}r(h/XWThe support for LSID identifiers is deprecated, and is being replaced with support for h0jubh)r}r(h/XDOI_jKh0jh}r(UnameXDOIjXhttp://www.doi.org/rhC]hB]h@]hA]hF]uhJ]rhUXDOIrr}r(h/Uh0jubaubhUX identifiers in a future release. We are maintaining support for LSIDs on one particular site, but this support will be removed in a future version of Metacat.rr}r(h/X identifiers in a future release. We are maintaining support for LSIDs on one particular site, but this support will be removed in a future version of Metacat.h0jubeubaubju)r}r(h/X.. _DOI: http://www.doi.org/jxKh0jh:h;h}r(jjhC]rUdoirahB]h@]hA]hF]rhauhHMhIhhJ]ubhY)r }r (h/XMetacat's optional LSID server allows Metacat to use a standardized syntax for identifying data sets, in addition to Metacat's internal, custom scheme for identifiers. LSID's were designed to identify complex biological entities with short identifiers (much like DOIs in publishing) that are both computer and human readable. LSID identifiers are URIs and are therefore usable in many Internet applications, but they also cleanly separate the identity of a data set (i.e., its permenant identifier) from its current location (e.g., the list of URLs from which it might be retrieved). LSIDs accomplish this by using a level of indirection; the identifier represents simply a name without location, but an associated resolver service can be used to locate the current location of the data and medata for the data set. This is accomplished by establishing a well-known location for the resolution service for each authority using an infrequently used feature of the domain name system called SRV records. At its most basic, resolution of an identifier is performed when a client looks up the SRV record for an LSID by querying DNS, which returns the current host and port of the authority web service, which is in turn used to locate the data and metadata.r h0jh:h;h}r (h@]hA]hB]hC]hF]uhHMhIhhJ]r hUXMetacat's optional LSID server allows Metacat to use a standardized syntax for identifying data sets, in addition to Metacat's internal, custom scheme for identifiers. LSID's were designed to identify complex biological entities with short identifiers (much like DOIs in publishing) that are both computer and human readable. LSID identifiers are URIs and are therefore usable in many Internet applications, but they also cleanly separate the identity of a data set (i.e., its permenant identifier) from its current location (e.g., the list of URLs from which it might be retrieved). LSIDs accomplish this by using a level of indirection; the identifier represents simply a name without location, but an associated resolver service can be used to locate the current location of the data and medata for the data set. This is accomplished by establishing a well-known location for the resolution service for each authority using an infrequently used feature of the domain name system called SRV records. At its most basic, resolution of an identifier is performed when a client looks up the SRV record for an LSID by querying DNS, which returns the current host and port of the authority web service, which is in turn used to locate the data and metadata.rr}r(h/j h0j ubaubhY)r}r(h/XUsing LSIDs to identify data records is being debated among members of the Taxonomic Databases Working Group (TDWG). There are several alternate technologies that are under consideration (e.g., DOI_, plain http URIs), and so at this time the support for LSIDs in Metacat has been created on an experimental basis only. If the LSID approach is ratified by the broader community, we will expand support for LSIDs in Metacat, but until then it is an optional and experimental feature.h0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhIhhJ]r(hUXUsing LSIDs to identify data records is being debated among members of the Taxonomic Databases Working Group (TDWG). There are several alternate technologies that are under consideration (e.g., rr}r(h/XUsing LSIDs to identify data records is being debated among members of the Taxonomic Databases Working Group (TDWG). There are several alternate technologies that are under consideration (e.g., h0jubh)r}r(h/XDOI_jKh0jh}r(UnameXDOIjjhC]hB]h@]hA]hF]uhJ]rhUXDOIrr}r(h/Uh0jubaubhUX, plain http URIs), and so at this time the support for LSIDs in Metacat has been created on an experimental basis only. If the LSID approach is ratified by the broader community, we will expand support for LSIDs in Metacat, but until then it is an optional and experimental feature.rr }r!(h/X, plain http URIs), and so at this time the support for LSIDs in Metacat has been created on an experimental basis only. If the LSID approach is ratified by the broader community, we will expand support for LSIDs in Metacat, but until then it is an optional and experimental feature.h0jubeubhY)r"}r#(h/XThe format of an LSID is::r$h0jh:h;h}r%(h@]hA]hB]hC]hF]uhHMhIhhJ]r&hUXThe format of an LSID is:r'r(}r)(h/XThe format of an LSID is:h0j"ubaubj)r*}r+(h/Xeurn:lsid:::[:] e.g., urn:lsid:ecoinformatics.org:tao:12039:1h0jh:h;h}r,(jjhC]hB]h@]hA]hF]uhHMhIhhJ]r-hUXeurn:lsid:::[:] e.g., urn:lsid:ecoinformatics.org:tao:12039:1r.r/}r0(h/Uh0j*ubaubhY)r1}r2(h/XWhen you enable the Metacat LSID support, you can use LSID clients (such as LSID Launchpad) and LSID notation to query Metacat for data and metadata. LSID notation can be used directly in Metacat HTTP queries as well. For example, a data package with an ID tao.12039.1 that is stored in a Metacat available at: http://example.com:9999 can be accessed by the following HTTP Metacat queries::h0jh:h;h}r3(h@]hA]hB]hC]hF]uhHMhIhhJ]r4(hUX7When you enable the Metacat LSID support, you can use LSID clients (such as LSID Launchpad) and LSID notation to query Metacat for data and metadata. LSID notation can be used directly in Metacat HTTP queries as well. For example, a data package with an ID tao.12039.1 that is stored in a Metacat available at: r5r6}r7(h/X7When you enable the Metacat LSID support, you can use LSID clients (such as LSID Launchpad) and LSID notation to query Metacat for data and metadata. LSID notation can be used directly in Metacat HTTP queries as well. For example, a data package with an ID tao.12039.1 that is stored in a Metacat available at: h0j1ubh)r8}r9(h/Xhttp://example.com:9999r:h>}r;(Urefurij:hC]hB]h@]hA]hF]uh0j1hJ]r<hUXhttp://example.com:9999r=r>}r?(h/Uh0j8ubah}rE(jjhC]hB]h@]hA]hF]uhHMhIhhJ]rFhUXhttp://example.com:9999/authority/data?lsid=urn:lsid:ecoinformatics.org:tao:12039:1 (To return the data) http://example.com:9999/authority/metadata?lsid=urn:lsid:ecoinformatics.org:tao:12039:1 (To return the metadata)rGrH}rI(h/Uh0jCubaubhY)rJ}rK(h/XYNotice that in the HTTP query strings, the periods in the data package ID have been replaced with colons. The authority (ecoinformatics.org) must be properly configured by the Metacat administrator. Note: In order to configure the authority, you must have access to the DNS server for the Metacat domain. Further instructions are provided below.rLh0jh:h;h}rM(h@]hA]hB]hC]hF]uhHMhIhhJ]rNhUXYNotice that in the HTTP query strings, the periods in the data package ID have been replaced with colons. The authority (ecoinformatics.org) must be properly configured by the Metacat administrator. Note: In order to configure the authority, you must have access to the DNS server for the Metacat domain. Further instructions are provided below.rOrP}rQ(h/jLh0jJubaubh1)rR}rS(h/Uh0jh:h;h}rT(h@]hA]hB]hC]rUj ahF]rVh"auhHMhIhhJ]rW(hL)rX}rY(h/jh0jRh:h;h}rZ(hC]hB]h@]hA]hF]hRj uhHMhIhhJ]r[hUX:Install and configure the LSID Server shipped with Metacatr\r]}r^(h/jh0jXubaubhY)r_}r`(h/X9To install the LSID server using the binary installation:rah0jRh:h;h}rb(h@]hA]hB]hC]hF]uhHMhIhhJ]rchUX9To install the LSID server using the binary installation:rdre}rf(h/jah0j_ubaubj)rg}rh(h/Uh0jRh:h;h}ri(jU.hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rjh{)rk}rl(h/X'Copy the authority.war file to Tomcat: h0jgh:h;h}rm(h@]hA]hB]hC]hF]uhHNhIhhJ]rnhY)ro}rp(h/X&Copy the authority.war file to Tomcat:rqh0jkh:h;h}rr(h@]hA]hB]hC]hF]uhHMhJ]rshUX&Copy the authority.war file to Tomcat:rtru}rv(h/jqh0joubaubaubaubj)rw}rx(h/Uh0jRh:h;h}ry(h@]hA]hB]hC]hF]uhHNhIhhJ]rzj)r{}r|(h/XLsudo cp /authority.war /usr/share/tomcat7/webappsh0jwh}r}(jjhC]hB]h@]hA]hF]uhHMhJ]r~hUXLsudo cp /authority.war /usr/share/tomcat7/webappsrr}r(h/Uh0j{ubaubaubj)r}r(h/Uh0jRh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r(h{)r}r(h/XSet up the LSID server by dropping the authority file into Apache's sites-available directory and running a2ensite to enable the site: :: sudo cp /authority /etc/apache2/sites-available sudo a2ensite authority h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]r(hY)r}r(h/XSet up the LSID server by dropping the authority file into Apache's sites-available directory and running a2ensite to enable the site:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXSet up the LSID server by dropping the authority file into Apache's sites-available directory and running a2ensite to enable the site:rr}r(h/jh0jubaubj)r}r(h/X[sudo cp /authority /etc/apache2/sites-available sudo a2ensite authorityh0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUX[sudo cp /authority /etc/apache2/sites-available sudo a2ensite authorityrr}r(h/Uh0jubaubeubh{)r}r(h/XRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type: :: /etc/init.d/tomcat5.5 restart h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]r(hY)r}r(h/XZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:rr}r(h/jh0jubaubj)r}r(h/X/etc/init.d/tomcat5.5 restarth0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUX/etc/init.d/tomcat5.5 restartrr}r(h/Uh0jubaubeubh{)r}r(h/X.Restart Apache to bring in changes by typing: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X-Restart Apache to bring in changes by typing:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUX-Restart Apache to bring in changes by typing:rr}r(h/jh0jubaubaubeubj)r}r(h/Uh0jRh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/X sudo /etc/init.d/apache2 restarth0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUX sudo /etc/init.d/apache2 restartrr}r(h/Uh0jubaubaubj)r}r(h/Uh0jRh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/XcSee notes beneath LSID server source installation for instructions for modifying the SRV record(s) h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XbSee notes beneath LSID server source installation for instructions for modifying the SRV record(s)rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXbSee notes beneath LSID server source installation for instructions for modifying the SRV record(s)rr}r(h/jh0jubaubaubaubeubh1)r}r(h/Uh0jh:h;h}r(h@]hA]hB]hC]rjahF]rh auhHMhIhhJ]r(hL)r}r(h/j"h0jh:h;h}r(hC]hB]h@]hA]hF]hRjuhHMhIhhJ]rhUX(To install the LSID server from a sourcerr}r(h/j"h0jubaubj)r}r(h/Uh0jh:h;h}r(jU.hC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/XIn the build.properties file found in the directory into which you extracted the Metacat source code, set the authority and config.lsidauthority properties. For example: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XIn the build.properties file found in the directory into which you extracted the Metacat source code, set the authority and config.lsidauthority properties. For example:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXIn the build.properties file found in the directory into which you extracted the Metacat source code, set the authority and config.lsidauthority properties. For example:rr}r(h/jh0jubaubaubaubj)r}r(h/Uh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/XCauthority.context=authority config.lsidauthority=ecoinformatics.orgh0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUXCauthority.context=authority config.lsidauthority=ecoinformatics.orgrr}r(h/Uh0jubaubaubj)r}r(h/Uh0jh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/XCIn the create the authority.war by running: h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/XBIn the create the authority.war by running:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXBIn the create the authority.war by running:rr }r (h/jh0jubaubaubaubj)r }r (h/Uh0jh:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]rj)r}r(h/Xsudo ant war-lsidh0j h}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUXsudo ant war-lsidrr}r(h/Uh0jubaubaubj)r}r(h/Uh0jh:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rh{)r}r(h/X>Copy the LSID WAR file into the Tomcat application directory. h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X=Copy the LSID WAR file into the Tomcat application directory.r h0jh:h;h}r!(h@]hA]hB]hC]hF]uhHMhJ]r"hUX=Copy the LSID WAR file into the Tomcat application directory.r#r$}r%(h/j h0jubaubaubaubj)r&}r'(h/Uh0jh:h;h}r((h@]hA]hB]hC]hF]uhHNhIhhJ]r)j)r*}r+(h/XAsudo cp /dist/authority.war h0j&h}r,(jjhC]hB]h@]hA]hF]uhHMhJ]r-hUXAsudo cp /dist/authority.war r.r/}r0(h/Uh0j*ubaubaubj)r1}r2(h/Uh0jh:h;h}r3(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]r4h{)r5}r6(h/X[Restart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type: h0j1h:h;h}r7(h@]hA]hB]hC]hF]uhHNhIhhJ]r8hY)r9}r:(h/XZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:r;h0j5h:h;h}r<(h@]hA]hB]hC]hF]uhHMhJ]r=hUXZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:r>r?}r@(h/j;h0j9ubaubaubaubj)rA}rB(h/Uh0jh:h;h}rC(h@]hA]hB]hC]hF]uhHNhIhhJ]rDj)rE}rF(h/X/etc/init.d/tomcat7 restarth0jAh}rG(jjhC]hB]h@]hA]hF]uhHMhJ]rHhUX/etc/init.d/tomcat7 restartrIrJ}rK(h/Uh0jEubaubaubj)rL}rM(h/Uh0jh:h;h}rN(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rOh{)rP}rQ(h/XIf you are running Tomcat behind the Apache server (the recommended configuration), set up and enable the authority service site configurations by typing: h0jLh:h;h}rR(h@]hA]hB]hC]hF]uhHNhIhhJ]rShY)rT}rU(h/XIf you are running Tomcat behind the Apache server (the recommended configuration), set up and enable the authority service site configurations by typing:rVh0jPh:h;h}rW(h@]hA]hB]hC]hF]uhHMhJ]rXhUXIf you are running Tomcat behind the Apache server (the recommended configuration), set up and enable the authority service site configurations by typing:rYrZ}r[(h/jVh0jTubaubaubaubj)r\}r](h/Uh0jh:h;h}r^(h@]hA]hB]hC]hF]uhHNhIhhJ]r_(j)r`}ra(h/Xcsudo cp /authority /sites-available sudo a2ensite authorityh0j\h}rb(jjhC]hB]h@]hA]hF]uhHMhJ]rchUXcsudo cp /authority /sites-available sudo a2ensite authorityrdre}rf(h/Uh0j`ubaubhY)rg}rh(h/XIWhere can be found in /src/scriptsrih0j\h:h;h}rj(h@]hA]hB]hC]hF]uhHMhJ]rkhUXIWhere can be found in /src/scriptsrlrm}rn(h/jih0jgubaubeubj)ro}rp(h/Uh0jh:h;h}rq(jU.jKhC]hB]h@]jUhA]hF]jj uhHMhIhhJ]rrh{)rs}rt(h/X.Restart Apache to bring in changes by typing: h0joh:h;h}ru(h@]hA]hB]hC]hF]uhHNhIhhJ]rvhY)rw}rx(h/X-Restart Apache to bring in changes by typing:ryh0jsh:h;h}rz(h@]hA]hB]hC]hF]uhHMhJ]r{hUX-Restart Apache to bring in changes by typing:r|r}}r~(h/jyh0jwubaubaubaubj)r}r(h/Uh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]r(j)r}r(h/X sudo /etc/init.d/apache2 restarth0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUX sudo /etc/init.d/apache2 restartrr}r(h/Uh0jubaubhY)r}r(h/XOnce the authority.war is installed, you must also modify the SRV record(s) on the DNS server for the domain hosting the Metacat. The record should be added to the master zone file for the metacat's DNS server:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXOnce the authority.war is installed, you must also modify the SRV record(s) on the DNS server for the domain hosting the Metacat. The record should be added to the master zone file for the metacat's DNS server:rr}r(h/jh0jubaubj)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rj)r}r(h/XF_lsid._tcp IN SRV 1 0 8080 .h0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUXF_lsid._tcp IN SRV 1 0 8080 .rr}r(h/Uh0jubaubah is the name of the machine that will serve as the physical location of the AuthorityService.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXpWhere is the name of the machine that will serve as the physical location of the AuthorityService.rr}r(h/jh0jubaubhY)r}r(h/XWFor example, the value of for the below example URL would be example.com:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhJ]rhUXWFor example, the value of for the below example URL would be example.com:rr}r(h/jh0jubaubj)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rj)r}r(h/XShttp://example.com:9999/authority/data?lsid=urn:lsid:ecoinformatics.org:tao:12039:1h0jh}r(jjhC]hB]h@]hA]hF]uhHMhJ]rhUXShttp://example.com:9999/authority/data?lsid=urn:lsid:ecoinformatics.org:tao:12039:1rr}r(h/Uh0jubaubah}r(h@]hA]hB]hC]hF]uhHMhJ]r(hUX!For more information, please see rr}r(h/X!For more information, please see h0jubh)r}r(h/X=http://www.ibm.com/developerworks/opensource/library/os-lsid/rh>}r(UrefurijhC]hB]h@]hA]hF]uh0jhJ]rhUX=http://www.ibm.com/developerworks/opensource/library/os-lsid/rr}r(h/Uh0jubah}r(h@]hA]hB]hC]rj0ahF]rh auhHMhIhhJ]r(hL)r}r(h/j5h0jh:h;h}r(hC]hB]h@]hA]hF]hRj/uhHMhIhhJ]rhUXTroubleshootingrr}r(h/j5h0jubaubhY)r}r(h/XWe keep and update a list of common problems and their solutions on the KNB website. See http://knb.ecoinformatics.org/software/metacat/troubleshooting.html for more information.h0jh:h;h}r(h@]hA]hB]hC]hF]uhHMhIhhJ]r(hUXYWe keep and update a list of common problems and their solutions on the KNB website. See rr}r(h/XYWe keep and update a list of common problems and their solutions on the KNB website. See h0jubh)r}r(h/XChttp://knb.ecoinformatics.org/software/metacat/troubleshooting.htmlrh>}r(UrefurijhC]hB]h@]hA]hF]uh0jhJ]rhUXChttp://knb.ecoinformatics.org/software/metacat/troubleshooting.htmlrr}r(h/Uh0jubah}r(h@]hA]hB]hC]rhahF]rhauhHKFhIhhJ]r(hL)r}r(h/hh0h4h:h;h}r(hC]hB]h@]hA]hF]hRhuhHKFhIhhJ]rhUXDownloading Metacatrr}r(h/hh0jubaubhY)r}r(h/XBefore installing Metacat, please ensure that all required software is installed and running correctly. To obtain a Metacat WAR file, which is needed for installation, download one of the following:rh0h4h:h;h}r(h@]hA]hB]hC]hF]uhHKGhIhhJ]rhUXBefore installing Metacat, please ensure that all required software is installed and running correctly. To obtain a Metacat WAR file, which is needed for installation, download one of the following:rr}r(h/jh0jubaubhu)r}r(h/Uh0h4h:h;h}r(jX*hC]hB]h@]hA]hF]uhHKKhIhhJ]r(h{)r}r(h/X6the Metacat installer, which has a pre-built WAR file,rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKKhJ]rhUX6the Metacat installer, which has a pre-built WAR file,rr}r (h/jh0jubaubaubh{)r }r (h/XSthe Metacat source distribution, which must be built in order to create a WAR file,r h0jh:h;h}r (h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/j h0j h:h;h}r(h@]hA]hB]hC]hF]uhHKLhJ]rhUXSthe Metacat source distribution, which must be built in order to create a WAR file,rr}r(h/j h0jubaubaubh{)r}r(h/X`the Metacat source code from SVN. You must build the source code in order to create a WAR file. h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X_the Metacat source code from SVN. You must build the source code in order to create a WAR file.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKMhJ]rhUX_the Metacat source code from SVN. You must build the source code in order to create a WAR file.rr }r!(h/jh0jubaubaubeubhY)r"}r#(h/XInstructions for all three options are discussed below. Note that downloading the installer (described in the next section) is the simplest way to get started.r$h0h4h:h;h}r%(h@]hA]hB]hC]hF]uhHKOhIhhJ]r&hUXInstructions for all three options are discussed below. Note that downloading the installer (described in the next section) is the simplest way to get started.r'r(}r)(h/j$h0j"ubaubh2h1)r*}r+(h/Uh0h4h:h;h}r,(h@]hA]hB]hC]r-jahF]r.hauhHKshIhhJ]r/(hL)r0}r1(h/j h0j*h:h;h}r2(hC]hB]h@]hA]hF]hRjuhHKshIhhJ]r3hUXDownload Metacat Source Coder4r5}r6(h/j h0j0ubaubhY)r7}r8(h/X'To get the Metacat source distribution:r9h0j*h:h;h}r:(h@]hA]hB]hC]hF]uhHKthIhhJ]r;hUX'To get the Metacat source distribution:r<r=}r>(h/j9h0j7ubaubj)r?}r@(h/Uh0j*h:h;h}rA(jU.hC]hB]h@]jUhA]hF]jj uhHKvhIhhJ]rB(h{)rC}rD(h/XBrowse 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., |release|).rEh0j?h:h;h}rF(h@]hA]hB]hC]hF]uhHNhIhhJ]rGhY)rH}rI(h/jEh0jCh:h;h}rJ(h@]hA]hB]hC]hF]uhHKvhJ]rK(hUXBrowse to the rLrM}rN(h/XBrowse to the h0jHubh)rO}rP(h/X`Metacat Download Page`_jKh0jHh}rQ(UnameXMetacat Download PagejjhC]hB]h@]hA]hF]uhJ]rRhUXMetacat Download PagerSrT}rU(h/Uh0jOubaubhUX. 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., rVrW}rX(h/X. 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., h0jHubhUX2.10.4rYrZ}r[(h/U2.10.4r\h0jHubhUX).r]r^}r_(h/X).h0jHubeubaubh{)r`}ra(h/XSave the file locally.rbh0j?h:h;h}rc(h@]hA]hB]hC]hF]uhHNhIhhJ]rdhY)re}rf(h/jbh0j`h:h;h}rg(h@]hA]hB]hC]hF]uhHKwhJ]rhhUXSave the file locally.rirj}rk(h/jbh0jeubaubaubh{)rl}rm(h/X]Extract the Metacat package files by typing (replace X.X.X with the current version number): h0j?h:h;h}rn(h@]hA]hB]hC]hF]uhHNhIhhJ]rohY)rp}rq(h/X\Extract the Metacat package files by typing (replace X.X.X with the current version number):rrh0jlh:h;h}rs(h@]hA]hB]hC]hF]uhHKxhJ]rthUX\Extract the Metacat package files by typing (replace X.X.X with the current version number):rurv}rw(h/jrh0jpubaubaubeubj)rx}ry(h/X"tar -xvzf metacat-src-X.X.X.tar.gzh0j*h:h;h}rz(jjhC]hB]h@]hA]hF]uhHK|hIhhJ]r{hUX"tar -xvzf metacat-src-X.X.X.tar.gzr|r}}r~(h/Uh0jxubaubj)r}r(h/Uh0j*h:h;h}r(jU.jKhC]hB]h@]jUhA]hF]jj uhHK~hIhhJ]rh{)r}r(h/X/Rename the metacat-X.X.X directory to metacat. h0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/X.Rename the metacat-X.X.X directory to metacat.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHK~hJ]rhUX.Rename the metacat-X.X.X directory to metacat.rr}r(h/jh0jubaubaubaubhY)r}r(h/XNote that you do not need to create the WAR file directly because the Ant build-file has an "install" target that will build and deploy the WAR for you.rh0j*h:h;h}r(h@]hA]hB]hC]hF]uhHKhIhhJ]rhUXNote that you do not need to create the WAR file directly because the Ant build-file has an "install" target that will build and deploy the WAR for you.rr}r(h/jh0jubaubeubh1)r}r(h/Uh0h4h:h;h}r(h@]hA]hB]hC]rjahF]rh&auhHKhIhhJ]r(hL)r}r(h/jh0jh:h;h}r(hC]hB]h@]hA]hF]hRjuhHKhIhhJ]rhUX:Check Out Metacat Source Code from GitHub (for Developers)rr}r(h/jh0jubaubj )r}r(h/XIf you have not already installed Git and you are running Ubuntu/Debian, you can get the Git client by typing: :: sudo apt-get install gith0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]r(hL)r}r(h/XInstalling an Git Client:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhJ]rhUXInstalling an Git Client:rr}r(h/jh0jubaubhY)r}r(h/XnIf you have not already installed Git and you are running Ubuntu/Debian, you can get the Git client by typing:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhJ]rhUXnIf you have not already installed Git and you are running Ubuntu/Debian, you can get the Git client by typing:rr}r(h/jh0jubaubj)r}r(h/Xsudo apt-get install gith0jh}r(jjhC]hB]h@]hA]hF]uhHKhJ]rhUXsudo apt-get install gitrr}r(h/Uh0jubaubeubhY)r}r(h/XiTo clone the repository from GitHub, go to the directory where you would like the code to live and type::h0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhIhhJ]rhUXhTo clone the repository from GitHub, go to the directory where you would like the code to live and type:rr}r(h/XhTo clone the repository from GitHub, go to the directory where you would like the code to live and type:h0jubaubj)r}r(h/X2git clone https://github.com/nceas/metacat metacath0jh:h;h}r(jjhC]hB]h@]hA]hF]uhHKhIhhJ]rhUX2git clone https://github.com/nceas/metacat metacatrr}r(h/Uh0jubaubhY)r}r(h/XThe entire Metacat repository will be cloned to your local machine and the current branch is the master branch which is constantly maintained in a state ready for release. Detailed information about the code contribution please see:rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhIhhJ]rhUXThe entire Metacat repository will be cloned to your local machine and the current branch is the master branch which is constantly maintained in a state ready for release. Detailed information about the code contribution please see:rr}r(h/jh0jubaubhY)r}r(h/X<https://github.com/NCEAS/metacat/blob/master/CONTRIBUTING.mdrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhIhhJ]rh)r}r(h/jh>}r(UrefurijhC]hB]h@]hA]hF]uh0jhJ]rhUX<https://github.com/NCEAS/metacat/blob/master/CONTRIBUTING.mdrr}r(h/Uh0jubah}r(h@]hA]hB]hC]hF]uhHKhIhhJ]rhUXNote that you do not need to create the WAR file directly because the Ant build-file has an "install" target that will build and deploy the WAR for you.rr}r(h/jh0jubaubeubeubh:h;h}r(h@]hA]hB]hC]rhahF]rh%auhHKThIhhJ]r(hL)r}r(h/hh0h2h:h;h}r(hC]hB]h@]hA]hF]hRhuhHKThIhhJ]rhUX3Download the Metacat Installer (Highly Recommended)rr}r(h/hh0jubaubhY)r}r(h/XuDownloading the Metacat Installer is the simplest way to get started with the application. To download the installer:rh0h2h:h;h}r(h@]hA]hB]hC]hF]uhHKUhIhhJ]rhUXuDownloading the Metacat Installer is the simplest way to get started with the application. To download the installer:rr}r(h/jh0jubaubj)r}r(h/Uh0h2h:h;h}r(jU.hC]hB]h@]jUhA]hF]jj uhHKXhIhhJ]r(h{)r}r(h/XBrowse 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., |release|)rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r}r(h/jh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKXhJ]r(hUXBrowse to the r r }r (h/XBrowse to the h0jubh)r }r (h/X`Metacat Download Page`_jKh0jh}r(UnameXMetacat Download PagejjhC]hB]h@]hA]hF]uhJ]rhUXMetacat Download Pagerr}r(h/Uh0j ubaubhUX. 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., rr}r(h/X. 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., h0jubhUX2.10.4rr}r(h/j\h0jubhUX)r}r(h/X)h0jubeubaubh{)r}r(h/XSave the file locally.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHNhIhhJ]rhY)r }r!(h/jh0jh:h;h}r"(h@]hA]hB]hC]hF]uhHKYhJ]r#hUXSave the file locally.r$r%}r&(h/jh0j ubaubaubh{)r'}r((h/X-Extract the Metacat package files by typing: h0jh:h;h}r)(h@]hA]hB]hC]hF]uhHNhIhhJ]r*hY)r+}r,(h/X,Extract the Metacat package files by typing:r-h0j'h:h;h}r.(h@]hA]hB]hC]hF]uhHKZhJ]r/hUX,Extract the Metacat package files by typing:r0r1}r2(h/j-h0j+ubaubaubeubj)r3}r4(h/X"tar -xvzf metacat-bin-X.X.X.tar.gzh0h2h:h;h}r5(jjhC]hB]h@]hA]hF]uhHK^hIhhJ]r6hUX"tar -xvzf metacat-bin-X.X.X.tar.gzr7r8}r9(h/Uh0j3ubaubhY)r:}r;(h/XYou should see a WAR file and several sample supporting files (Table 2.1). The extraction location will be referred to as the ```` for the remainder of this documentation.h0h2h:h;h}r<(h@]hA]hB]hC]hF]uhHK`hIhhJ]r=(hUX~You should see a WAR file and several sample supporting files (Table 2.1). The extraction location will be referred to as the r>r?}r@(h/X~You should see a WAR file and several sample supporting files (Table 2.1). The extraction location will be referred to as the h0j:ubj6)rA}rB(h/X````h>}rC(h@]hA]hB]hC]hF]uh0j:hJ]rDhUXrErF}rG(h/Uh0jAubahubhUX) for the remainder of this documentation.rHrI}rJ(h/X) for the remainder of this documentation.h0j:ubeubcdocutils.nodes table rK)rL}rM(h/Uh0h2h:h;h}rO(h@]hA]hB]hC]hF]uhHNhIhhJ]rPcdocutils.nodes tgroup rQ)rR}rS(h/Uh>}rT(hC]hB]h@]hA]hF]UcolsKuh0jLhJ]rU(cdocutils.nodes colspec rV)rW}rX(h/Uh>}rY(hC]hB]h@]hA]hF]UcolwidthKuh0jRhJ]h}r](hC]hB]h@]hA]hF]UcolwidthKuh0jRhJ]h}ra(h@]hA]hB]hC]hF]uh0jRhJ]rbcdocutils.nodes row rc)rd}re(h/Uh>}rf(h@]hA]hB]hC]hF]uh0j_hJ]rg(cdocutils.nodes entry rh)ri}rj(h/Uh>}rk(h@]hA]hB]hC]hF]uh0jdhJ]rlhY)rm}rn(h/XFileroh0jih:h;h}rp(h@]hA]hB]hC]hF]uhHKehJ]rqhUXFilerrrs}rt(h/joh0jmubaubah}rx(h@]hA]hB]hC]hF]uh0jdhJ]ryhY)rz}r{(h/X Descriptionr|h0jvh:h;h}r}(h@]hA]hB]hC]hF]uhHKehJ]r~hUX Descriptionrr}r(h/j|h0jzubaubah}r(h@]hA]hB]hC]hF]uh0jRhJ]r(jc)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]r(jh)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/X metacat.warrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKghJ]rhUX metacat.warrr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/X"The Metacat Web archive file (WAR)rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKghJ]rhUX"The Metacat Web archive file (WAR)rr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]r(jh)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Xmetacat-site.confrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhhJ]rhUXmetacat-site.confrr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/XISample Web definition file used by Apache on Ubuntu/Debian Linux systems.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKhhJ]rhUXISample Web definition file used by Apache on Ubuntu/Debian Linux systems.rr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]r(jh)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Xmetacat-site-ssl.confrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKihJ]rhUXmetacat-site-ssl.confrr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/XISample SSL definition file used by Apache on Ubuntu/Debian Linux systems.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKihJ]rhUXISample SSL definition file used by Apache on Ubuntu/Debian Linux systems.rr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]r(jh)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Xjk.confrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKjhJ]rhUXjk.confrr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/XPSample JkMount configuration file used by Apache on Ubuntu/Debian Linux systems.rh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKjhJ]rhUXPSample JkMount configuration file used by Apache on Ubuntu/Debian Linux systems.rr}r(h/jh0jubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]r(jh)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Xworkers.propertiesrh0jh:h;h}r(h@]hA]hB]hC]hF]uhHKkhJ]rhUXworkers.propertiesrr}r(h/jh0jubaubah}r (h@]hA]hB]hC]hF]uh0jhJ]r hY)r }r(h/XMSample workers definition file used by Apache on Ubuntu/Debian Linux systems.rh0j h:h;h}r(h@]hA]hB]hC]hF]uhHKkhJ]rhUXMSample workers definition file used by Apache on Ubuntu/Debian Linux systems.rr}r(h/jh0j ubaubah}r(h@]hA]hB]hC]hF]uh0jhJ]r(jh)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhY)r}r(h/Xmetacat-index.warrh0jh:h;h}r (h@]hA]hB]hC]hF]uhHKlhJ]r!hUXmetacat-index.warr"r#}r$(h/jh0jubaubah}r'(h@]hA]hB]hC]hF]uh0jhJ]r(hY)r)}r*(h/XbThe Metacat Index WAR for supporting SOLR query features Optional unless Metacat UI is being used.r+h0j%h:h;h}r,(h@]hA]hB]hC]hF]uhHKlhJ]r-hUXbThe Metacat Index WAR for supporting SOLR query features Optional unless Metacat UI is being used.r.r/}r0(h/j+h0j)ubaubah}r3(h@]hA]hB]hC]hF]uh0jhJ]r4(jh)r5}r6(h/Uh>}r7(h@]hA]hB]hC]hF]uh0j1hJ]r8hY)r9}r:(h/X metacatui.warr;h0j5h:h;h}r<(h@]hA]hB]hC]hF]uhHKmhJ]r=hUX metacatui.warr>r?}r@(h/j;h0j9ubaubah}rC(h@]hA]hB]hC]hF]uh0j1hJ]rDhY)rE}rF(h/XThe Metacat UI - can be deployed as a webapp or directly in webserverMetacat UI requires metacat-index be deployed and configured.rGh0jAh:h;h}rH(h@]hA]hB]hC]hF]uhHKmhJ]rIhUXThe Metacat UI - can be deployed as a webapp or directly in webserverMetacat UI requires metacat-index be deployed and configured.rJrK}rL(h/jGh0jEubaubah}rO(h@]hA]hB]hC]hF]uh0jhJ]rP(jh)rQ}rR(h/Uh>}rS(h@]hA]hB]hC]hF]uh0jMhJ]rThY)rU}rV(h/X authority.warrWh0jQh:h;h}rX(h@]hA]hB]hC]hF]uhHKnhJ]rYhUX authority.warrZr[}r\(h/jWh0jUubaubah}r_(h@]hA]hB]hC]hF]uh0jMhJ]r`hY)ra}rb(h/X(The optional LSID Server application WARrch0j]h:h;h}rd(h@]hA]hB]hC]hF]uhHKnhJ]rehUX(The optional LSID Server application WARrfrg}rh(h/jch0jaubaubah}rl(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKTUtypeUWARNINGrmuhHKThIhhJ]rn(hY)ro}rp(h/XTitle underline too short.h>}rq(h@]hA]hB]hC]hF]uh0h-hJ]rrhUXTitle underline too short.rsrt}ru(h/Uh0joubah}rx(jjhC]hB]h@]hA]hF]uh0h-hJ]ryhUXRDownload the Metacat Installer (Highly Recommended) ..............................rzr{}r|(h/Uh0jvubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypeUINFOruhHK~hIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}r(h@]hA]hB]hC]hF]uh0j}hJ]rhUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejmuhJ]r(hY)r}r(h/Uh>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUXTitle underline too short.rr}r(h/Uh0jubah}r(jjhC]hB]h@]hA]hF]uh0jhJ]rhUXrCheck Out Metacat Source Code from GitHub (for Developers) .......................................................rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejmuhHKhIhhJ]r(hY)r}r(h/XTitle underline too short.h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUXTitle underline too short.rr}r(h/Uh0jubah}r(jjhC]hB]h@]hA]hF]uh0jhJ]rhUXrCheck Out Metacat Source Code from GitHub (for Developers) .......................................................rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]rjDaUsourceh;hA]hF]UlineKUtypejuhHKhIhhJ]rhY)r}r(h/X)Duplicate implicit target name: "java 8".h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX)Duplicate implicit target name: "java 8".rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]rjWaUsourceh;hA]hF]UlineKUtypejuhHKhIhhJ]rhY)r}r(h/X0Duplicate implicit target name: "apache tomcat".h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX0Duplicate implicit target name: "apache tomcat".rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuh0j hJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "2" (ordinal 2)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuh0j hJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "3" (ordinal 3)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuh0j hJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuh0j hJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "5" (ordinal 5)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "5" (ordinal 5)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuh0j hJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "6" (ordinal 6)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "6" (ordinal 6)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMHhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "2" (ordinal 2)rr}r(h/Uh0jubah}r (h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMOhIhhJ]r hY)r }r (h/X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h>}r (h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "3" (ordinal 3)rr}r(h/Uh0j ubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMVhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHM]hIhhJ]r hY)r!}r"(h/X:Enumerated list start value not ordinal-1: "5" (ordinal 5)h>}r#(h@]hA]hB]hC]hF]uh0jhJ]r$hUX:Enumerated list start value not ordinal-1: "5" (ordinal 5)r%r&}r'(h/Uh0j!ubah}r*(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMchIhhJ]r+hY)r,}r-(h/X:Enumerated list start value not ordinal-1: "6" (ordinal 6)h>}r.(h@]hA]hB]hC]hF]uh0j(hJ]r/hUX:Enumerated list start value not ordinal-1: "6" (ordinal 6)r0r1}r2(h/Uh0j,ubah}r5(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMvhIhhJ]r6hY)r7}r8(h/X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h>}r9(h@]hA]hB]hC]hF]uh0j3hJ]r:hUX:Enumerated list start value not ordinal-1: "2" (ordinal 2)r;r<}r=(h/Uh0j7ubah}r?(h/Uh0j h:h;h}r@(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHM|hIhhJ]rAhY)rB}rC(h/X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h>}rD(h@]hA]hB]hC]hF]uh0j>hJ]rEhUX:Enumerated list start value not ordinal-1: "3" (ordinal 3)rFrG}rH(h/Uh0jBubah}rK(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rLhY)rM}rN(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}rO(h@]hA]hB]hC]hF]uh0jIhJ]rPhUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)rQrR}rS(h/Uh0jMubah}rV(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rWhY)rX}rY(h/X:Enumerated list start value not ordinal-1: "5" (ordinal 5)h>}rZ(h@]hA]hB]hC]hF]uh0jThJ]r[hUX:Enumerated list start value not ordinal-1: "5" (ordinal 5)r\r]}r^(h/Uh0jXubah}ra(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rbhY)rc}rd(h/X:Enumerated list start value not ordinal-1: "6" (ordinal 6)h>}re(h@]hA]hB]hC]hF]uh0j_hJ]rfhUX:Enumerated list start value not ordinal-1: "6" (ordinal 6)rgrh}ri(h/Uh0jcubah}rl(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rmhY)rn}ro(h/X:Enumerated list start value not ordinal-1: "7" (ordinal 7)h>}rp(h@]hA]hB]hC]hF]uh0jjhJ]rqhUX:Enumerated list start value not ordinal-1: "7" (ordinal 7)rrrs}rt(h/Uh0jnubah}rw(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rxhY)ry}rz(h/X:Enumerated list start value not ordinal-1: "8" (ordinal 8)h>}r{(h@]hA]hB]hC]hF]uh0juhJ]r|hUX:Enumerated list start value not ordinal-1: "8" (ordinal 8)r}r~}r(h/Uh0jyubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "9" (ordinal 9)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "9" (ordinal 9)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X<Enumerated list start value not ordinal-1: "10" (ordinal 10)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX<Enumerated list start value not ordinal-1: "10" (ordinal 10)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X<Enumerated list start value not ordinal-1: "11" (ordinal 11)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX<Enumerated list start value not ordinal-1: "11" (ordinal 11)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "2" (ordinal 2)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "3" (ordinal 3)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHM"hIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "3" (ordinal 3)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHM,hIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHM6hIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "5" (ordinal 5)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "5" (ordinal 5)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHM<hIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "6" (ordinal 6)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "6" (ordinal 6)rr}r(h/Uh0jubahh:h;h}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMchIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "2" (ordinal 2)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "2" (ordinal 2)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r (h/X:Enumerated list start value not ordinal-1: "5" (ordinal 5)h>}r (h@]hA]hB]hC]hF]uh0jhJ]r hUX:Enumerated list start value not ordinal-1: "5" (ordinal 5)r r }r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "2" (ordinal 2)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h>}r (h@]hA]hB]hC]hF]uh0jhJ]r!hUX:Enumerated list start value not ordinal-1: "3" (ordinal 3)r"r#}r$(h/Uh0jubah}r'(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]r(hY)r)}r*(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}r+(h@]hA]hB]hC]hF]uh0j%hJ]r,hUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)r-r.}r/(h/Uh0j)ubah}r2(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]r3hY)r4}r5(h/X:Enumerated list start value not ordinal-1: "5" (ordinal 5)h>}r6(h@]hA]hB]hC]hF]uh0j0hJ]r7hUX:Enumerated list start value not ordinal-1: "5" (ordinal 5)r8r9}r:(h/Uh0j4ubah}r=(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]r>hY)r?}r@(h/X:Enumerated list start value not ordinal-1: "6" (ordinal 6)h>}rA(h@]hA]hB]hC]hF]uh0j;hJ]rBhUX:Enumerated list start value not ordinal-1: "6" (ordinal 6)rCrD}rE(h/Uh0j?ubah}rH(h@]UlevelKhC]hB]rIjaUsourceh;hA]hF]UlineMIUtypejuhHMIhIhhJ]rJhY)rK}rL(h/X)Duplicate implicit target name: "java 8".h>}rM(h@]hA]hB]hC]hF]uh0jFhJ]rNhUX)Duplicate implicit target name: "java 8".rOrP}rQ(h/Uh0jKubah}rT(h@]UlevelKhC]hB]rUjaUsourceh;hA]hF]UlineM^UtypejuhHM^hIhhJ]rVhY)rW}rX(h/X0Duplicate implicit target name: "apache tomcat".h>}rY(h@]hA]hB]hC]hF]uh0jRhJ]rZhUX0Duplicate implicit target name: "apache tomcat".r[r\}r](h/Uh0jWubah}r`(h@]UlevelKhC]hB]rajaUsourceh;hA]hF]UlineMgUtypejuhHMghIhhJ]rbhY)rc}rd(h/X6Duplicate implicit target name: "postgresql database".h>}re(h@]hA]hB]hC]hF]uh0j^hJ]rfhUX6Duplicate implicit target name: "postgresql database".rgrh}ri(h/Uh0jcubah}rl(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMvhIhhJ]rmhY)rn}ro(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}rp(h@]hA]hB]hC]hF]uh0jjhJ]rqhUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)rrrs}rt(h/Uh0jnubah}rw(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHM}hIhhJ]rxhY)ry}rz(h/X:Enumerated list start value not ordinal-1: "5" (ordinal 5)h>}r{(h@]hA]hB]hC]hF]uh0juhJ]r|hUX:Enumerated list start value not ordinal-1: "5" (ordinal 5)r}r~}r(h/Uh0jyubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "6" (ordinal 6)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "6" (ordinal 6)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "7" (ordinal 7)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "7" (ordinal 7)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "8" (ordinal 8)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "8" (ordinal 8)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "9" (ordinal 9)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "9" (ordinal 9)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X<Enumerated list start value not ordinal-1: "10" (ordinal 10)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX<Enumerated list start value not ordinal-1: "10" (ordinal 10)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]rjaUsourceh;hA]hF]UlineMUtypejuhHMhIhhJ]rhY)r}r(h/X5Duplicate implicit target name: "installing metacat".h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX5Duplicate implicit target name: "installing metacat".rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]rjaUsourceh;hA]hF]UlineMUtypejuhHMhIhhJ]rhY)r}r(h/X.Duplicate implicit target name: "new install".h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX.Duplicate implicit target name: "new install".rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "2" (ordinal 2)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "3" (ordinal 3)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "3" (ordinal 3)rr}r(h/Uh0jubah}r(h@]UlevelKhC]hB]Usourceh;hA]hF]UlineKUtypejuhHMhIhhJ]rhY)r}r(h/X:Enumerated list start value not ordinal-1: "4" (ordinal 4)h>}r(h@]hA]hB]hC]hF]uh0jhJ]rhUX:Enumerated list start value not ordinal-1: "4" (ordinal 4)rr}r(h/Uh0jubahNUpep_file_url_templater?Upep-%04dr@Uexit_status_levelrAKUconfigrBNUstrict_visitorrCNUcloak_email_addressesrDUtrim_footnote_reference_spacerEUenvrFNUdump_pseudo_xmlrGNUexpose_internalsrHNUsectsubtitle_xformrIU source_linkrJNUrfc_referencesrKNUoutput_encodingrLUutf-8rMU source_urlrNNUinput_encodingrOU utf-8-sigrPU_disable_configrQNU id_prefixrRUU tab_widthrSKUerror_encodingrTUUTF-8rUU_sourcerVh;Ugettext_compactrWU generatorrXNUdump_internalsrYNU smart_quotesrZU pep_base_urlr[U https://www.python.org/dev/peps/r\Usyntax_highlightr]Ulongr^Uinput_encoding_error_handlerr_j:Uauto_id_prefixr`UidraUdoctitle_xformrbUstrip_elements_with_classesrcNU _config_filesrd]Ufile_insertion_enabledreU raw_enabledrfKU dump_settingsrgNubUsymbol_footnote_startrhKhC}ri(j|jxj jRjCjjjjjjjj jjjjhjjkjgj-jmhEh8hShjjdjjzjj*jj;jWjC jjjDjhhhhhhhhj0jhkhdjjjjr jCj?hhjVjRj jjYjUjljhj/j+jjjjjBj>jj>j,j(jj4 jjjj hh4jjjjjjjjjA j= jjjjjjhh6hh2jjj|jvj>j8jjj}j jjjjjjjmjJjjjijejj~jjRjZjjjjjjjjjhjuUsubstitution_namesrj}rkh}rl(h@]hC]hB]Usourceh;hA]hF]uU footnotesrm]rnUrefidsro}rpub.