€•lŒdocutils.nodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”hŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ"Downloading and Installing Metacat”h]”hŒText”“”Œ"Downloading and Installing Metacat”…””}”(hhŒparent”hhhŒsource”NŒline”NubaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œrefid”Œid6”uŒtagname”hhhhhhŒY/var/lib/jenkins/jobs/metacat_beta/workspace/metacat/docs/user/metacat/source/install.rst”hKubhŒ paragraph”“”)”}”(hŒ>Instructions for the Linux system is included in this section.”h]”hŒ>Instructions for the Linux system is included in this section.”…””}”(hh1hh/hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhhhhubhŒtopic”“”)”}”(hhh]”(h)”}”(hŒContents”h]”hŒContents”…””}”(hhhhBubah}”(h]”h!]”h#]”h%]”h']”uh+hhh?ubhŒbullet_list”“”)”}”(hhh]”hŒ list_item”“”)”}”(hhh]”(h.)”}”(hhh]”hŒ reference”“”)”}”(hhh]”hŒ"Downloading and Installing Metacat”…””}”(hhhh_ubah}”(h]”h*ah!]”h#]”h%]”h']”Œrefid”Œ"downloading-and-installing-metacat”uh+h]hhZubah}”(h]”h!]”h#]”h%]”h']”uh+h-hhWubhQ)”}”(hhh]”(hV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒSystem Requirements”…””}”(hŒSystem Requirements”hh}ubah}”(h]”Œid7”ah!]”h#]”h%]”h']”Œrefid”Œsystem-requirements”uh+h]hhzubah}”(h]”h!]”h#]”h%]”h']”uh+h-hhwubah}”(h]”h!]”h#]”h%]”h']”uh+hUhhtubhV)”}”(hhh]”(h.)”}”(hhh]”h^)”}”(hhh]”hŒInstalling on Linux”…””}”(hŒInstalling on Linux”hh ubah}”(h]”Œid8”ah!]”h#]”h%]”h']”Œrefid”Œinstalling-on-linux”uh+h]hhubah}”(h]”h!]”h#]”h%]”h']”uh+h-hhšubhQ)”}”(hhh]”(hV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒQuick Start Overview”…””}”(hŒQuick Start Overview”hhÀubah}”(h]”Œid9”ah!]”h#]”h%]”h']”Œrefid”Œquick-start-overview”uh+h]hh½ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hhºubah}”(h]”h!]”h#]”h%]”h']”uh+hUhh·ubhV)”}”(hhh]”(h.)”}”(hhh]”h^)”}”(hhh]”hŒDownloading Metacat”…””}”(hŒDownloading Metacat”hhãubah}”(h]”Œid10”ah!]”h#]”h%]”h']”Œrefid”Œdownloading-metacat”uh+h]hhàubah}”(h]”h!]”h#]”h%]”h']”uh+h-hhÝubhQ)”}”(hhh]”(hV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒ3Download the Metacat Installer (Highly Recommended)”…””}”(hŒ3Download the Metacat Installer (Highly Recommended)”hjubah}”(h]”Œid11”ah!]”h#]”h%]”h']”Œrefid”Œ1download-the-metacat-installer-highly-recommended”uh+h]hjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hhýubah}”(h]”h!]”h#]”h%]”h']”uh+hUhhúubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒDownload Metacat Source Code”…””}”(hŒDownload Metacat Source Code”hj&ubah}”(h]”Œid12”ah!]”h#]”h%]”h']”Œrefid”Œdownload-metacat-source-code”uh+h]hj#ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhhúubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒ:Check Out Metacat Source Code from GitHub (for Developers)”…””}”(hŒ:Check Out Metacat Source Code from GitHub (for Developers)”hjIubah}”(h]”Œid13”ah!]”h#]”h%]”h']”Œrefid”Œ8check-out-metacat-source-code-from-github-for-developers”uh+h]hjFubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjCubah}”(h]”h!]”h#]”h%]”h']”uh+hUhhúubeh}”(h]”h!]”h#]”h%]”h']”uh+hPhhÝubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhh·ubhV)”}”(hhh]”(h.)”}”(hhh]”h^)”}”(hhh]”hŒ,Installing and Configuring Required Software”…””}”(hŒ,Installing and Configuring Required Software”hjxubah}”(h]”Œid14”ah!]”h#]”h%]”h']”Œrefid”Œ,installing-and-configuring-required-software”uh+h]hjuubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjrubhQ)”}”(hhh]”(hV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒJava 8”…””}”(hŒJava 8”hj˜ubah}”(h]”Œid15”ah!]”h#]”h%]”h']”Œrefid”Œid1”uh+h]hj•ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj’ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒ Apache Tomcat”…””}”(hŒ Apache Tomcat”hj»ubah}”(h]”Œid16”ah!]”h#]”h%]”h']”Œrefid”Œid2”uh+h]hj¸ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjµubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒ(Apache HTTPD Server (Highly Recommended)”…””}”(hŒ(Apache HTTPD Server (Highly Recommended)”hjÞubah}”(h]”Œid17”ah!]”h#]”h%]”h']”Œrefid”Œ&apache-httpd-server-highly-recommended”uh+h]hjÛubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjØubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒPostgreSQL Database”…””}”(hŒPostgreSQL Database”hjubah}”(h]”Œid18”ah!]”h#]”h%]”h']”Œrefid”Œpostgresql-database”uh+h]hjþubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjûubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒSolr Server”…””}”(hŒSolr Server”hj$ubah}”(h]”Œid19”ah!]”h#]”h%]”h']”Œrefid”Œsolr-server”uh+h]hj!ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒ$Apache Ant (if building from Source)”…””}”(hŒ$Apache Ant (if building from Source)”hjGubah}”(h]”Œid20”ah!]”h#]”h%]”h']”Œrefid”Œ"apache-ant-if-building-from-source”uh+h]hjDubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjAubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubeh}”(h]”h!]”h#]”h%]”h']”uh+hPhjrubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhh·ubhV)”}”(hhh]”(h.)”}”(hhh]”h^)”}”(hhh]”hŒInstalling Metacat”…””}”(hŒInstalling Metacat”hjvubah}”(h]”Œid21”ah!]”h#]”h%]”h']”Œrefid”Œinstalling-metacat”uh+h]hjsubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjpubhQ)”}”(hhh]”(hV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒNew Install”…””}”(hŒNew Install”hj–ubah}”(h]”Œid22”ah!]”h#]”h%]”h']”Œrefid”Œnew-install”uh+h]hj“ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒUpgrade Metacat”…””}”(hŒUpgrade Metacat”hj¹ubah}”(h]”Œid23”ah!]”h#]”h%]”h']”Œrefid”Œupgrade-metacat”uh+h]hj¶ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj³ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒSource Install and Upgrade”…””}”(hŒSource Install and Upgrade”hjÜubah}”(h]”Œid24”ah!]”h#]”h%]”h']”Œrefid”Œsource-install-and-upgrade”uh+h]hjÙubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjÖubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubeh}”(h]”h!]”h#]”h%]”h']”uh+hPhjpubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhh·ubhV)”}”(hhh]”(h.)”}”(hhh]”h^)”}”(hhh]”hŒ+Optional Installation Options (LSID Server)”…””}”(hŒ+Optional Installation Options (LSID Server)”hjubah}”(h]”Œid25”ah!]”h#]”h%]”h']”Œrefid”Œ)optional-installation-options-lsid-server”uh+h]hjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjubhQ)”}”(hhh]”(hV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒ:Install and configure the LSID Server shipped with Metacat”…””}”(hŒ:Install and configure the LSID Server shipped with Metacat”hj+ubah}”(h]”Œid26”ah!]”h#]”h%]”h']”Œrefid”Œ:install-and-configure-the-lsid-server-shipped-with-metacat”uh+h]hj(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj%ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj"ubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒ(To install the LSID server from a source”…””}”(hŒ(To install the LSID server from a source”hjNubah}”(h]”Œid27”ah!]”h#]”h%]”h']”Œrefid”Œ(to-install-the-lsid-server-from-a-source”uh+h]hjKubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjHubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj"ubeh}”(h]”h!]”h#]”h%]”h']”uh+hPhjubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhh·ubhV)”}”(hhh]”h.)”}”(hhh]”h^)”}”(hhh]”hŒTroubleshooting”…””}”(hŒTroubleshooting”hj}ubah}”(h]”Œid28”ah!]”h#]”h%]”h']”Œrefid”Œtroubleshooting”uh+h]hjzubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjwubah}”(h]”h!]”h#]”h%]”h']”uh+hUhh·ubeh}”(h]”h!]”h#]”h%]”h']”uh+hPhhšubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhhtubeh}”(h]”h!]”h#]”h%]”h']”uh+hPhhWubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhhRubah}”(h]”h!]”h#]”h%]”h']”uh+hPhh?hhhNhNubeh}”(h]”Œcontents”ah!]”Œcontents”ah#]”Œcontents”ah%]”h']”uh+h=hh,hKhhhhubh )”}”(hhh]”(h)”}”(hh„h]”hŒSystem Requirements”…””}”(hh„hjÄhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)h‡uh+hhjÁhhhh,hKubh.)”}”(hŒIn 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:”h]”hŒIn 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:”…””}”(hjÓhjÑhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhjÁhhubhQ)”}”(hhh]”(hV)”}”(hŒPostgreSQL_”h]”h.)”}”(hjäh]”h^)”}”(hŒPostgreSQL_”h]”hŒ PostgreSQL”…””}”(hhhjéubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ PostgreSQL”Œrefuri”Œhttp://www.postgresql.org/”uh+h]hjæŒresolved”Kubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhjâubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjßhhhh,hNubhV)”}”(hŒ'`Apache Ant`_ (if building from source)”h]”h.)”}”(hj h]”(h^)”}”(hŒ `Apache Ant`_”h]”hŒ Apache Ant”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ Apache Ant”jùŒhttp://ant.apache.org/”uh+h]hjjûKubhŒ (if building from source)”…””}”(hŒ (if building from source)”hjubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjßhhhh,hNubhV)”}”(hŒ`Apache Tomcat`_”h]”h.)”}”(hj3h]”h^)”}”(hj3h]”hŒ Apache Tomcat”…””}”(hhhj8ubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ Apache Tomcat”jùŒhttp://tomcat.apache.org/”uh+h]hj5jûKubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhj1ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjßhhhh,hNubhV)”}”(hX`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. ”h]”(h.)”}”(hŒ$`Apache HTTPD Server`_ (recommended)”h]”(h^)”}”(hŒ`Apache HTTPD Server`_”h]”hŒApache HTTPD Server”…””}”(hhhj\ubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒApache HTTPD Server”jùŒhttp://httpd.apache.org/”uh+h]hjXjûKubhŒ (recommended)”…””}”(hŒ (recommended)”hjXubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhjTubhQ)”}”(hhh]”hV)”}”(hŒé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. ”h]”h.)”}”(hŒè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.”h]”hŒè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.”…””}”(hjhjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhj{ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjxubah}”(h]”h!]”h#]”h%]”h']”Œbullet”Œ*”uh+hPhh,hKhjTubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhjßhhhNhNubhV)”}”(hŒ&`Java 8`_ (Note: Java 7 is deprecated)”h]”h.)”}”(hj£h]”(h^)”}”(hŒ `Java 8`_”h]”hŒJava 8”…””}”(hhhj¨ubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒJava 8”jùŒShttp://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html”uh+h]hj¥jûKubhŒ (Note: Java 7 is deprecated)”…””}”(hŒ (Note: Java 7 is deprecated)”hj¥ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhj¡ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjßhhhh,hNubhV)”}”(hŒ`Solr 8.8.2`_ ”h]”h.)”}”(hŒ `Solr 8.8.2`_”h]”h^)”}”(hjÐh]”hŒ Solr 8.8.2”…””}”(hhhjÒubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ Solr 8.8.2”jùŒ=https://lucene.apache.org/solr/guide/8_8/getting-started.html”uh+h]hjÎjûKubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhjÊubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjßhhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j™jšuh+hPhh,hKhjÁhhubhŒtarget”“”)”}”(hŒ*.. _PostgreSQL: http://www.postgresql.org/”h]”h}”(h]”Œ postgresql”ah!]”h#]”Œ postgresql”ah%]”h']”jùjúuh+jôhKhjÁhhhh,Œ referenced”Kubjõ)”}”(hŒ".. _Oracle: http://www.oracle.com/”h]”h}”(h]”Œoracle”ah!]”h#]”Œoracle”ah%]”h']”jùŒhttp://www.oracle.com/”uh+jôhKhjÁhhhh,jKubjõ)”}”(hŒ&.. _Apache Ant: http://ant.apache.org/”h]”h}”(h]”Œ apache-ant”ah!]”h#]”Œ apache ant”ah%]”h']”jùjuh+jôhKhjÁhhhh,jKubjõ)”}”(hŒ,.. _Apache Tomcat: http://tomcat.apache.org/”h]”h}”(h]”Œ apache-tomcat”ah!]”h#]”Œ apache tomcat”ah%]”h']”jùjGuh+jôhK hjÁhhhh,jKubjõ)”}”(hŒ1.. _Apache HTTPD Server: http://httpd.apache.org/”h]”h}”(h]”Œapache-httpd-server”ah!]”h#]”Œapache httpd server”ah%]”h']”jùjluh+jôhK"hjÁhhhh,jKubjõ)”}”(hŒ_.. _Java 8: http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html”h]”h}”(h]”Œjava-8”ah!]”h#]”Œjava 8”ah%]”h']”jùj¸uh+jôhK$hjÁhhhh,jKubjõ)”}”(hŒM.. _Solr 8.8.2: https://lucene.apache.org/solr/guide/8_8/getting-started.html”h]”h}”(h]”Œ solr-8-8-2”ah!]”h#]”Œ solr 8.8.2”ah%]”h']”jùjáuh+jôhK&hjÁhhhh,jKubh.)”}”(hŒ(System requirements for running Metacat:”h]”hŒ(System requirements for running Metacat:”…””}”(hjNhjLhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK)hjÁhhubhQ)”}”(hhh]”(hV)”}”(hŒ%a server running PostgreSQL_ database”h]”h.)”}”(hj_h]”(hŒa server running ”…””}”(hŒa server running ”hjaubh^)”}”(hŒPostgreSQL_”h]”hŒ PostgreSQL”…””}”(hhhjiubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ PostgreSQL”jùjúuh+h]hjajûKubhŒ database”…””}”(hŒ database”hjaubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK+hj]ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjZhhhh,hNubhV)”}”(hŒat least 512MB RAM”h]”h.)”}”(hjŒh]”hŒat least 512MB RAM”…””}”(hjŒhjŽubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK,hjŠubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjZhhhh,hNubhV)”}”(hŒç200 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). ”h]”h.)”}”(hŒå200 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).”h]”hŒå200 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).”…””}”(hj§hj¥ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK-hj¡ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjZhhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j™jšuh+hPhh,hK+hjÁhhubeh}”(h]”hah!]”h#]”Œsystem requirements”ah%]”h']”uh+h hhhhhh,hKubh )”}”(hhh]”(h)”}”(hh§h]”hŒInstalling on Linux”…””}”(hh§hjÉhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)hªuh+hhjÆhhhh,hK1ubh.)”}”(hXOThis 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).”h]”hXOThis 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).”…””}”(hjØhjÖhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK2hjÆhhubh )”}”(hhh]”(h)”}”(hhÇh]”hŒQuick Start Overview”…””}”(hhÇhjçhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)hÊuh+hhjähhhh,hK9ubh.)”}”(hŒÆFor 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.”h]”hŒÆFor 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.”…””}”(hjöhjôhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK:hjähhubhŒenumerated_list”“”)”}”(hhh]”(hV)”}”(hŒgDownload and install prerequisites (`Java 8`_, `Apache Tomcat`_ 7, PostgreSQL_, `Apache HTTPD Server`_)”h]”h.)”}”(hj h]”(hŒ$Download and install prerequisites (”…””}”(hŒ$Download and install prerequisites (”hjubh^)”}”(hŒ `Java 8`_”h]”hŒJava 8”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒJava 8”jùj¸uh+h]hjjûKubhŒ, ”…””}”(hŒ, ”hjubh^)”}”(hŒ`Apache Tomcat`_”h]”hŒ Apache Tomcat”…””}”(hhhj(ubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ Apache Tomcat”jùjGuh+h]hjjûKubhŒ 7, ”…””}”(hŒ 7, ”hjubh^)”}”(hŒPostgreSQL_”h]”hŒ PostgreSQL”…””}”(hhhj=ubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ PostgreSQL”jùjúuh+h]hjjûKubhŒ, ”…””}”(hj'hjubh^)”}”(hŒ`Apache HTTPD Server`_”h]”hŒApache HTTPD Server”…””}”(hhhjQubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒApache HTTPD Server”jùjluh+h]hjjûKubhŒ)”…””}”(hŒ)”hjubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK>hjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒtCreate a database in PostgreSQL named 'metacat' and authorize access to it in ``pb_hba.conf`` for the user 'metacat'”h]”h.)”}”(hjth]”(hŒRCreate a database in PostgreSQL named â€˜metacatâ€™ and authorize access to it in ”…””}”(hŒNCreate a database in PostgreSQL named 'metacat' and authorize access to it in ”hjvubhŒliteral”“”)”}”(hŒ``pb_hba.conf``”h]”hŒpb_hba.conf”…””}”(hhhj€ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjvubhŒ for the user â€˜metacatâ€™”…””}”(hŒ for the user 'metacat'”hjvubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK?hjrubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒ2Log in to PostgreSQL and create the 'metacat' user”h]”h.)”}”(hj¡h]”hŒ6Log in to PostgreSQL and create the â€˜metacatâ€™ user”…””}”(hj¡hj£ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK@hjŸubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒJDownload Metacat from the `Metacat Download Page`_ and extract the archive”h]”h.)”}”(hj¸h]”(hŒDownload Metacat from the ”…””}”(hŒDownload Metacat from the ”hjºubh^)”}”(hŒ`Metacat Download Page`_”h]”hŒMetacat Download Page”…””}”(hhhjÂubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒMetacat Download Page”jùŒ/http://knb.ecoinformatics.org/software/metacat/”uh+h]hjºjûKubhŒ and extract the archive”…””}”(hŒ and extract the archive”hjºubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKAhj¶ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒE``sudo mkdir /var/metacat; sudo chown -R /var/metacat``”h]”h.)”}”(hjæh]”j)”}”(hjæh]”hŒAsudo mkdir /var/metacat; sudo chown -R /var/metacat”…””}”(hhhjëubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjèubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKBhjäubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒ>``sudo cp /metacat.war ``”h]”h.)”}”(hjh]”j)”}”(hjh]”hŒ:sudo cp /metacat.war ”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKChjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒD``sudo cp /metacat-index.war ``”h]”h.)”}”(hj&h]”j)”}”(hj&h]”hŒ@sudo cp /metacat-index.war ”…””}”(hhhj+ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKDhj$ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒ@``sudo cp /metacatui.war ``”h]”h.)”}”(hjFh]”j)”}”(hjFh]”hŒ/metacatui.war ”…””}”(hhhjKubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjHubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKEhjDubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒ$``sudo /etc/init.d/tomcat7 restart``”h]”h.)”}”(hjfh]”j)”}”(hjfh]”hŒ sudo /etc/init.d/tomcat7 restart”…””}”(hhhjkubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjhubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKFhjdubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒ,Configure Metacat through the Web interface ”h]”h.)”}”(hŒ+Configure Metacat through the Web interface”h]”hŒ+Configure Metacat through the Web interface”…””}”(hjŠhjˆubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKGhj„ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh+jhjähhhh,hK>ubjõ)”}”(hŒJ.. _Metacat Download Page: http://knb.ecoinformatics.org/software/metacat/”h]”h}”(h]”Œmetacat-download-page”ah!]”h#]”Œmetacat download page”ah%]”h']”jùjÒuh+jôhKIhjähhhh,jKubeh}”(h]”hÐah!]”h#]”Œquick start overview”ah%]”h']”uh+h hjÆhhhh,hK9ubh )”}”(hhh]”(h)”}”(hhêh]”hŒDownloading Metacat”…””}”(hhêhj½hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)híuh+hhjºhhhh,hKLubh.)”}”(hŒÆBefore 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:”h]”hŒÆBefore 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:”…””}”(hjÌhjÊhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKMhjºhhubhQ)”}”(hhh]”(hV)”}”(hŒ6the Metacat installer, which has a pre-built WAR file,”h]”h.)”}”(hjÝh]”hŒ6the Metacat installer, which has a pre-built WAR file,”…””}”(hjÝhjßubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKQhjÛubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjØhhhh,hNubhV)”}”(hŒSthe Metacat source distribution, which must be built in order to create a WAR file,”h]”h.)”}”(hjôh]”hŒSthe Metacat source distribution, which must be built in order to create a WAR file,”…””}”(hjôhjöubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKRhjòubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjØhhhh,hNubhV)”}”(hŒ`the Metacat source code from SVN. You must build the source code in order to create a WAR file. ”h]”h.)”}”(hŒ_the Metacat source code from SVN. You must build the source code in order to create a WAR file.”h]”hŒ_the Metacat source code from SVN. You must build the source code in order to create a WAR file.”…””}”(hjhj ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKShj ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjØhhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j™jšuh+hPhh,hKQhjºhhubh.)”}”(hŒŸInstructions for all three options are discussed below. Note that downloading the installer (described in the next section) is the simplest way to get started.”h]”hŒŸInstructions for all three options are discussed below. Note that downloading the installer (described in the next section) is the simplest way to get started.”…””}”(hj)hj'hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKUhjºhhubh )”}”(hhh]”(h)”}”(hj h]”hŒ3Download the Metacat Installer (Highly Recommended)”…””}”(hj hj8hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)j uh+hhj5hhhh,hKZubh.)”}”(hŒuDownloading the Metacat Installer is the simplest way to get started with the application. To download the installer:”h]”hŒuDownloading the Metacat Installer is the simplest way to get started with the application. To download the installer:”…””}”(hjGhjEhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK[hj5hhubj)”}”(hhh]”(hV)”}”(hŒÖBrowse to the `Metacat Download Page`_. In the Metacat section, select the link to the "GZIP file" (the link should look like: metacat-bin-X.X.X.tar.gz, where X.X.X is the latest version of Metacat e.g., |release|)”h]”h.)”}”(hjXh]”(hŒBrowse to the ”…””}”(hŒBrowse to the ”hjZubh^)”}”(hŒ`Metacat Download Page`_”h]”hŒMetacat Download Page”…””}”(hhhjbubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒMetacat Download Page”jùjÒuh+h]hjZjûKubhŒª. 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., ”…””}”(hŒ¦. 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., ”hjZubhŒ2.19.0”…””}”(hŒ2.19.0”hjZubhŒ)”…””}”(hjehjZubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK^hjVubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjShhhh,hNubhV)”}”(hŒSave the file locally.”h]”h.)”}”(hjŽh]”hŒSave the file locally.”…””}”(hjŽhjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK_hjŒubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjShhhh,hNubhV)”}”(hŒ-Extract the Metacat package files by typing: ”h]”h.)”}”(hŒ,Extract the Metacat package files by typing:”h]”hŒ,Extract the Metacat package files by typing:”…””}”(hj©hj§ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK`hj£ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjShhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhj5hhhh,hK^ubhŒ literal_block”“”)”}”(hŒ"tar -xvzf metacat-bin-X.X.X.tar.gz”h]”hŒ"tar -xvzf metacat-bin-X.X.X.tar.gz”…””}”(hhhjÃubah}”(h]”h!]”h#]”h%]”h']”Œ xml:space”Œpreserve”uh+jÁhKdhj5hhhh,ubh.)”}”(hŒÀYou 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.”h]”(hŒ~You should see a WAR file and several sample supporting files (Table 2.1). The extraction location will be referred to as the ”…””}”(hŒ~You should see a WAR file and several sample supporting files (Table 2.1). The extraction location will be referred to as the ”hjÓhhhNhNubj)”}”(hŒ````”h]”hŒ”…””}”(hhhjÜubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjÓubhŒ) for the remainder of this documentation.”…””}”(hŒ) for the remainder of this documentation.”hjÓhhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKfhj5hhubhŒtable”“”)”}”(hhh]”hŒtgroup”“”)”}”(hhh]”(hŒcolspec”“”)”}”(hhh]”h}”(h]”h!]”h#]”h%]”h']”Œcolwidth”Kuh+jÿhjüubj )”}”(hhh]”h}”(h]”h!]”h#]”h%]”h']”Œcolwidth”K‚uh+jÿhjüubhŒthead”“”)”}”(hhh]”hŒrow”“”)”}”(hhh]”(hŒentry”“”)”}”(hhh]”h.)”}”(hŒFile”h]”hŒFile”…””}”(hj& hj$ ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKkhj! ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj ubj )”}”(hhh]”h.)”}”(hŒDescription”h]”hŒDescription”…””}”(hj= hj; ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKkhj8 ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjüubhŒtbody”“”)”}”(hhh]”(j )”}”(hhh]”(j )”}”(hhh]”h.)”}”(hŒmetacat.war”h]”hŒmetacat.war”…””}”(hjh hjf ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKmhjc ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj` ubj )”}”(hhh]”h.)”}”(hŒ"The Metacat Web archive file (WAR)”h]”hŒ"The Metacat Web archive file (WAR)”…””}”(hj hj} ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKmhjz ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj` ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj] ubj )”}”(hhh]”(j )”}”(hhh]”h.)”}”(hŒmetacat-site.conf”h]”hŒmetacat-site.conf”…””}”(hjŸ hj ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKnhjš ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj— ubj )”}”(hhh]”h.)”}”(hŒISample Web definition file used by Apache on Ubuntu/Debian Linux systems.”h]”hŒISample Web definition file used by Apache on Ubuntu/Debian Linux systems.”…””}”(hj¶ hj´ ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKnhj± ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj— ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj] ubj )”}”(hhh]”(j )”}”(hhh]”h.)”}”(hŒmetacat-site-ssl.conf”h]”hŒmetacat-site-ssl.conf”…””}”(hjÖ hjÔ ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKohjÑ ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjÎ ubj )”}”(hhh]”h.)”}”(hŒISample SSL definition file used by Apache on Ubuntu/Debian Linux systems.”h]”hŒISample SSL definition file used by Apache on Ubuntu/Debian Linux systems.”…””}”(hjí hjë ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKohjè ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjÎ ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj] ubj )”}”(hhh]”(j )”}”(hhh]”h.)”}”(hŒjk.conf”h]”hŒjk.conf”…””}”(hj hj ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKphj ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj ubj )”}”(hhh]”h.)”}”(hŒPSample JkMount configuration file used by Apache on Ubuntu/Debian Linux systems.”h]”hŒPSample JkMount configuration file used by Apache on Ubuntu/Debian Linux systems.”…””}”(hj$ hj" ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKphj ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj] ubj )”}”(hhh]”(j )”}”(hhh]”h.)”}”(hŒworkers.properties”h]”hŒworkers.properties”…””}”(hjD hjB ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKqhj? ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj< ubj )”}”(hhh]”h.)”}”(hŒMSample workers definition file used by Apache on Ubuntu/Debian Linux systems.”h]”hŒMSample workers definition file used by Apache on Ubuntu/Debian Linux systems.”…””}”(hj[ hjY ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKqhjV ubah}”(h]”h!]”h#]”h%]”h']”uh+j hj< ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj] ubj )”}”(hhh]”(j )”}”(hhh]”h.)”}”(hŒmetacat-index.war”h]”hŒmetacat-index.war”…””}”(hj{ hjy ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKrhjv ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjs ubj )”}”(hhh]”h.)”}”(hŒbThe Metacat Index WAR for supporting SOLR query features Optional unless Metacat UI is being used.”h]”hŒbThe Metacat Index WAR for supporting SOLR query features Optional unless Metacat UI is being used.”…””}”(hj’ hj ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKrhj ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjs ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj] ubj )”}”(hhh]”(j )”}”(hhh]”h.)”}”(hŒ metacatui.war”h]”hŒ metacatui.war”…””}”(hj² hj° ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKshj ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjª ubj )”}”(hhh]”h.)”}”(hŒ‚The Metacat UI - can be deployed as a webapp or directly in webserverMetacat UI requires metacat-index be deployed and configured.”h]”hŒ‚The Metacat UI - can be deployed as a webapp or directly in webserverMetacat UI requires metacat-index be deployed and configured.”…””}”(hjÉ hjÇ ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKshjÄ ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjª ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj] ubj )”}”(hhh]”(j )”}”(hhh]”h.)”}”(hŒ authority.war”h]”hŒ authority.war”…””}”(hjé hjç ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKthjä ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjá ubj )”}”(hhh]”h.)”}”(hŒ(The optional LSID Server application WAR”h]”hŒ(The optional LSID Server application WAR”…””}”(hjhjþ ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKthjû ubah}”(h]”h!]”h#]”h%]”h']”uh+j hjá ubeh}”(h]”h!]”h#]”h%]”h']”uh+j hj] ubeh}”(h]”h!]”h#]”h%]”h']”uh+j[ hjüubeh}”(h]”h!]”h#]”h%]”h']”Œcols”Kuh+júhj÷ubah}”(h]”h!]”h#]”h%]”h']”uh+jõhj5hhhh,hNubeh}”(h]”jah!]”h#]”Œ3download the metacat installer (highly recommended)”ah%]”h']”uh+h hjºhhhh,hKZubh )”}”(hhh]”(h)”}”(hj-h]”hŒDownload Metacat Source Code”…””}”(hj-hj5hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)j0uh+hhj2hhhh,hKyubh.)”}”(hŒ'To get the Metacat source distribution:”h]”hŒ'To get the Metacat source distribution:”…””}”(hjDhjBhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKzhj2hhubj)”}”(hhh]”(hV)”}”(hŒçBrowse to the `Metacat Download Page`_. In the Metacat section, select the link to the Metacat Source code (it will look something like this: metacat-src-X.X.X.tar.gz, where X.X.X is the latest version of Metacat, e.g., |release|).”h]”h.)”}”(hjUh]”(hŒBrowse to the ”…””}”(hŒBrowse to the ”hjWubh^)”}”(hŒ`Metacat Download Page`_”h]”hŒMetacat Download Page”…””}”(hhhj_ubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒMetacat Download Page”jùjÒuh+h]hjWjûKubhŒ¶. 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., ”…””}”(hŒ¶. 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., ”hjWubhŒ2.19.0”…””}”(hj{hjWubhŒ).”…””}”(hŒ).”hjWubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK|hjSubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjPhhhh,hNubhV)”}”(hŒSave the file locally.”h]”h.)”}”(hj‹h]”hŒSave the file locally.”…””}”(hj‹hjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK}hj‰ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjPhhhh,hNubhV)”}”(hŒ]Extract the Metacat package files by typing (replace X.X.X with the current version number): ”h]”h.)”}”(hŒ\Extract the Metacat package files by typing (replace X.X.X with the current version number):”h]”hŒ\Extract the Metacat package files by typing (replace X.X.X with the current version number):”…””}”(hj¦hj¤ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK~hj ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjPhhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhj2hhhh,hK|ubjÂ)”}”(hŒ"tar -xvzf metacat-src-X.X.X.tar.gz”h]”hŒ"tar -xvzf metacat-src-X.X.X.tar.gz”…””}”(hhhj¾ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhK‚hj2hhhh,ubj)”}”(hhh]”hV)”}”(hŒ/Rename the metacat-X.X.X directory to metacat. ”h]”h.)”}”(hŒ.Rename the metacat-X.X.X directory to metacat.”h]”hŒ.Rename the metacat-X.X.X directory to metacat.”…””}”(hjÕhjÓubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK„hjÏubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÌhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦Œstart”Kuh+jhj2hhhh,hK„ubh.)”}”(hŒ˜Note 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.”h]”hŒœNote 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.”…””}”(hjðhjîhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK†hj2hhubeh}”(h]”j6ah!]”h#]”Œdownload metacat source code”ah%]”h']”uh+h hjºhhhh,hKyubh )”}”(hhh]”(h)”}”(hjPh]”hŒ:Check Out Metacat Source Code from GitHub (for Developers)”…””}”(hjPhjhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)jSuh+hhjhhhh,hK‹ubhŒsidebar”“”)”}”(hŒIf you have not already installed Git and you are running Ubuntu/Debian, you can get the Git client by typing: :: sudo apt-get install git”h]”(h)”}”(hŒInstalling an Git Client:”h]”hŒInstalling an Git Client:”…””}”(hjhjubah}”(h]”h!]”h#]”h%]”h']”uh+hhjubh.)”}”(hŒnIf you have not already installed Git and you are running Ubuntu/Debian, you can get the Git client by typing:”h]”hŒnIf you have not already installed Git and you are running Ubuntu/Debian, you can get the Git client by typing:”…””}”(hj)hj'ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhjubjÂ)”}”(hŒsudo apt-get install git”h]”hŒsudo apt-get install git”…””}”(hhhj5ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhK”hjubeh}”(h]”h!]”h#]”h%]”h']”uh+jhjhhhh,hNubh.)”}”(hŒiTo clone the repository from GitHub, go to the directory where you would like the code to live and type::”h]”hŒhTo clone the repository from GitHub, go to the directory where you would like the code to live and type:”…””}”(hŒhTo clone the repository from GitHub, go to the directory where you would like the code to live and type:”hjIhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK–hjhhubjÂ)”}”(hŒ2git clone https://github.com/nceas/metacat metacat”h]”hŒ2git clone https://github.com/nceas/metacat metacat”…””}”(hhhjXubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhK™hjhhhh,ubh.)”}”(hŒèThe entire Metacat repository will be cloned to your local machine and the current branch is the `main` branch which is constantly maintained in a state ready for release. Detailed information about the code contribution please see:”h]”(hŒaThe entire Metacat repository will be cloned to your local machine and the current branch is the ”…””}”(hŒaThe entire Metacat repository will be cloned to your local machine and the current branch is the ”hjfhhhNhNubhŒtitle_reference”“”)”}”(hŒ`main`”h]”hŒmain”…””}”(hhhjqubah}”(h]”h!]”h#]”h%]”h']”uh+johjfubhŒ branch which is constantly maintained in a state ready for release. Detailed information about the code contribution please see:”…””}”(hŒ branch which is constantly maintained in a state ready for release. Detailed information about the code contribution please see:”hjfhhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK›hjhhubh.)”}”(hŒ:https://github.com/NCEAS/metacat/blob/main/CONTRIBUTING.md”h]”h^)”}”(hjŒh]”hŒ:https://github.com/NCEAS/metacat/blob/main/CONTRIBUTING.md”…””}”(hhhjŽubah}”(h]”h!]”h#]”h%]”h']”Œrefuri”jŒuh+h]hjŠubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhjhhubh.)”}”(hŒ˜Note 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.”h]”hŒœNote 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.”…””}”(hj¤hj¢hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKŸhjhhubeh}”(h]”jYah!]”h#]”Œ:check out metacat source code from github (for developers)”ah%]”h']”uh+h hjºhhhh,hK‹ubeh}”(h]”hóah!]”h#]”Œdownloading metacat”ah%]”h']”uh+h hjÆhhhh,hKLubh )”}”(hhh]”(h)”}”(hjh]”hŒ,Installing and Configuring Required Software”…””}”(hjhjÁhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)j‚uh+hhj¾hhhh,hK¤ubh.)”}”(hXMBefore 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.”h]”hXMBefore 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.”…””}”(hjÐhjÎhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK¥hj¾hhubhQ)”}”(hhh]”(hV)”}”(hŒ `Java 8`_”h]”h.)”}”(hjáh]”h^)”}”(hjáh]”hŒJava 8”…””}”(hhhjæubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒJava 8”jùj¸uh+h]hjãjûKubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK«hjßubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÜhhhh,hNubhV)”}”(hŒ`Apache Tomcat`_”h]”h.)”}”(hj h]”h^)”}”(hj h]”hŒ Apache Tomcat”…””}”(hhhj ubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ Apache Tomcat”jùjGuh+h]hj jûKubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK¬hj ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÜhhhh,hNubhV)”}”(hŒ+`Apache HTTPD Server`_ (Highly Recommended)”h]”h.)”}”(hj% h]”(h^)”}”(hŒ`Apache HTTPD Server`_”h]”hŒApache HTTPD Server”…””}”(hhhj* ubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒApache HTTPD Server”jùjluh+h]hj' jûKubhŒ (Highly Recommended)”…””}”(hŒ (Highly Recommended)”hj' ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKhj# ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÜhhhh,hNubhV)”}”(hŒPostgreSQL_ Database”h]”h.)”}”(hjM h]”(h^)”}”(hŒPostgreSQL_”h]”hŒ PostgreSQL”…””}”(hhhjR ubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ PostgreSQL”jùjúuh+h]hjO jûKubhŒ Database”…””}”(hŒ Database”hjO ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK®hjK ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÜhhhh,hNubhV)”}”(hŒ'`Apache Ant`_ (if building from Source)”h]”h.)”}”(hju h]”(h^)”}”(hŒ `Apache Ant`_”h]”hŒ Apache Ant”…””}”(hhhjz ubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ Apache Ant”jùjuh+h]hjw jûKubhŒ (if building from Source)”…””}”(hŒ (if building from Source)”hjw ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK¯hjs ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÜhhhh,hNubhV)”}”(hŒ`Solr Server`_ ”h]”h.)”}”(hŒ`Solr Server`_”h]”h^)”}”(hj¡ h]”hŒSolr Server”…””}”(hhhj£ ubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒSolr Server”h)j4uh+h]hjŸ jûKubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK°hj› ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÜhhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j™jšuh+hPhh,hK«hj¾hhubh )”}”(hhh]”(h)”}”(hjŸh]”hŒJava 8”…””}”(hjŸhjÇ hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)j¢uh+hhjÄ hhhh,hK³ubh.)”}”(hŒŸTo 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.”h]”(hŒwTo run Metacat, you should use Java 8. Make sure that the JAVA_HOME environment variable is properly set and that both ”…””}”(hŒwTo run Metacat, you should use Java 8. Make sure that the JAVA_HOME environment variable is properly set and that both ”hjÔ hhhNhNubj)”}”(hŒ``java``”h]”hŒjava”…””}”(hhhjÝ ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjÔ ubhŒ and ”…””}”(hŒ and ”hjÔ hhhNhNubj)”}”(hŒ ``javac``”h]”hŒjavac”…””}”(hhhjð ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjÔ ubhŒ are on your PATH.”…””}”(hŒ are on your PATH.”hjÔ hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK´hjÄ hhubh.)”}”(hŒRTo install Java if you are running Ubuntu_/Debian, you can install using apt-get::”h]”(hŒ#To install Java if you are running ”…””}”(hŒ#To install Java if you are running ”hj hhhNhNubh^)”}”(hŒUbuntu_”h]”hŒUbuntu”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒUbuntu”jùŒhttp://www.ubuntu.com/”uh+h]hj jûKubhŒ'/Debian, you can install using apt-get:”…””}”(hŒ'/Debian, you can install using apt-get:”hj hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK¸hjÄ hhubjÂ)”}”(hŒ"sudo apt-get install openjdk-8-jdk”h]”hŒ"sudo apt-get install openjdk-8-jdk”…””}”(hhhj.ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhKºhjÄ hhhh,ubh.)”}”(hŒsIf you are not using Ubuntu_/Debian, you can get Java from the Oracle_ website and install using the RPM installer.”h]”(hŒIf you are not using ”…””}”(hŒIf you are not using ”hj<hhhNhNubh^)”}”(hŒUbuntu_”h]”hŒUbuntu”…””}”(hhhjEubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒUbuntu”jùj"uh+h]hj<jûKubhŒ#/Debian, you can get Java from the ”…””}”(hŒ#/Debian, you can get Java from the ”hj<hhhNhNubh^)”}”(hŒOracle_”h]”hŒOracle”…””}”(hhhjZubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒOracle”jùjuh+h]hj<jûKubhŒ- website and install using the RPM installer.”…””}”(hŒ- website and install using the RPM installer.”hj<hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hK¼hjÄ hhubjõ)”}”(hŒ".. _Ubuntu: http://www.ubuntu.com/”h]”h}”(h]”Œubuntu”ah!]”h#]”Œubuntu”ah%]”h']”jùj"uh+jôhK¾hjÄ hhhh,jKubeh}”(h]”j¨ah!]”h#]”h%]”Œjava 8”ah']”uh+h hj¾hhhh,hK³jKubh )”}”(hhh]”(h)”}”(hjÂh]”hŒ Apache Tomcat”…””}”(hjÂhj‹hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)jÅuh+hhjˆhhhh,hKÁubh.)”}”(hŒßWe 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.”h]”hŒßWe 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.”…””}”(hjšhj˜hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÂhjˆhhubh.)”}”(hŒuNote: we will refer to the Tomcat installation directory as ```` for the remainder of the documentation.”h]”(hŒ``”h]”hŒ ”…””}”(hhhj¯ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj¦ubhŒ( for the remainder of the documentation.”…””}”(hŒ( for the remainder of the documentation.”hj¦hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÆhjˆhhubh.)”}”(hŒ9If you are running Ubuntu_/Debian, get Tomcat by typing::”h]”(hŒIf you are running ”…””}”(hŒIf you are running ”hjÈhhhNhNubh^)”}”(hŒUbuntu_”h]”hŒUbuntu”…””}”(hhhjÑubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒUbuntu”jùj"uh+h]hjÈjûKubhŒ/Debian, get Tomcat by typing:”…””}”(hŒ/Debian, get Tomcat by typing:”hjÈhhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÉhjˆhhubjÂ)”}”(hŒsudo apt-get install tomcat7”h]”hŒsudo apt-get install tomcat7”…””}”(hhhjìubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhKËhjˆhhhh,ubh.)”}”(hŒ5Otherwise, get Tomcat from the `Apache Tomcat`_ page.”h]”(hŒOtherwise, get Tomcat from the ”…””}”(hŒOtherwise, get Tomcat from the ”hjúhhhNhNubh^)”}”(hŒ`Apache Tomcat`_”h]”hŒ Apache Tomcat”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ Apache Tomcat”jùjGuh+h]hjújûKubhŒ page.”…””}”(hŒ page.”hjúhhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÍhjˆhhubh.)”}”(hŒGAfter installing Tomcat, you can switch back to the Sun JDK by typing::”h]”hŒFAfter installing Tomcat, you can switch back to the Sun JDK by typing:”…””}”(hŒFAfter installing Tomcat, you can switch back to the Sun JDK by typing:”hjhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÏhjˆhhubjÂ)”}”(hŒ&sudo update-alternatives --config java”h]”hŒ&sudo update-alternatives --config java”…””}”(hhhj-ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhKÑhjˆhhhh,ubh.)”}”(hŒ,and selecting the correct Java installation.”h]”hŒ,and selecting the correct Java installation.”…””}”(hj=hj;hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÓhjˆhhubh.)”}”(hŒkIf using Tomcat with Apache/mod_jk, enable the AJP connector on port 8009 by uncommenting that section in::”h]”hŒjIf using Tomcat with Apache/mod_jk, enable the AJP connector on port 8009 by uncommenting that section in:”…””}”(hŒjIf using Tomcat with Apache/mod_jk, enable the AJP connector on port 8009 by uncommenting that section in:”hjIhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÕhjˆhhubjÂ)”}”(hŒ/conf/server.xml”h]”hŒ/conf/server.xml”…””}”(hhhjXubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhK×hjˆhhhh,ubh.)”}”(hŒFor DataONE deployments edit::”h]”hŒFor DataONE deployments edit:”…””}”(hŒFor DataONE deployments edit:”hjfhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÙhjˆhhubjÂ)”}”(hŒ /etc/tomcat7/catalina.properties”h]”hŒ /etc/tomcat7/catalina.properties”…””}”(hhhjuubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhKÛhjˆhhhh,ubh.)”}”(hŒto include::”h]”hŒto include:”…””}”(hŒto include:”hjƒhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÝhjˆhhubjÂ)”}”(hŒ}org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true org.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=true”h]”hŒ}org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true org.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=true”…””}”(hhhj’ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhKßhjˆhhhh,ubh.)”}”(hXNote: If you're running Tomcat using systemd, systemd sandboxes Tomcat limiting the directories it can write to and prevents Metacat from operating correctly. Ensure the following lines exist in the service file for Tomcat (paths may vary depending on your configuration):”h]”hXNote: If youâ€™re running Tomcat using systemd, systemd sandboxes Tomcat limiting the directories it can write to and prevents Metacat from operating correctly. Ensure the following lines exist in the service file for Tomcat (paths may vary depending on your configuration):”…””}”(hj¢hj hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKãhjˆhhubjÂ)”}”(hŒBReadWritePaths=/var/metacat ReadWritePaths=/etc/default/solr.in.sh”h]”hŒBReadWritePaths=/var/metacat ReadWritePaths=/etc/default/solr.in.sh”…””}”(hhhj®ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhKéhjˆhhhh,ubeh}”(h]”jËah!]”h#]”h%]”Œ apache tomcat”ah']”uh+h hj¾hhhh,hKÁjKubh )”}”(hhh]”(h)”}”(hjåh]”hŒ(Apache HTTPD Server (Highly Recommended)”…””}”(hjåhjÆhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)jèuh+hhjÃhhhh,hKíubh.)”}”(hXyAlthough 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.”h]”hXyAlthough 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.”…””}”(hjÕhjÓhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKîhjÃhhubj)”}”(hX^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 Require all granted ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/" AllowOverride None Options ExecCGI Require all granted AllowOverride All FallbackResource /metacatui/index.html Require all granted 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 restart”h]”(h)”}”(hŒ4Configuring Apache on an OS other than Ubuntu/Debian”h]”hŒ4Configuring Apache on an OS other than Ubuntu/Debian”…””}”(hjçhjåubah}”(h]”h!]”h#]”h%]”h']”uh+hhjáubh.)”}”(hX 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:”h]”hX 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:”…””}”(hjõhjóubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKöhjáubjÂ)”}”(hŒ$/conf/httpd.conf”h]”hŒ$/conf/httpd.conf”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhKýhjáubj)”}”(hhh]”hV)”}”(hŒ²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: ”h]”h.)”}”(hŒ±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:”h]”hŒ³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:”…””}”(hjhjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hKÿhjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhjáubhŒblock_quote”“”)”}”(hhh]”jÂ)”}”(hŒZ JkLogFile "/var/log/tomcat/mod_jk.log" JkLogLevel info ”h]”hŒZ JkLogFile "/var/log/tomcat/mod_jk.log" JkLogLevel info ”…””}”(hhhj5ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMhj2ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjáubj)”}”(hhh]”hV)”}”(hŒû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: ”h]”h.)”}”(hŒú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:”h]”hŒú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:”…””}”(hjRhjPubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhjLubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjIubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjáubj1)”}”(hhh]”jÂ)”}”(hX 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 Require all granted ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/" AllowOverride None Options ExecCGI Require all granted AllowOverride All FallbackResource /metacatui/index.html Require all granted JkMount /metacat ajp13 JkMount /metacat/* ajp13 JkMount /metacat/metacat ajp13 JkUnMount /metacat/cgi-bin/* ajp13 JkMount /metacatui ajp13 JkMount /metacatui/* ajp13 JkMount /*.jsp ajp13 ”h]”hX 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 Require all granted ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/" AllowOverride None Options ExecCGI Require all granted AllowOverride All FallbackResource /metacatui/index.html Require all granted JkMount /metacat ajp13 JkMount /metacat/* ajp13 JkMount /metacat/metacat ajp13 JkUnMount /metacat/cgi-bin/* ajp13 JkMount /metacatui ajp13 JkMount /metacatui/* ajp13 JkMount /*.jsp ajp13 ”…””}”(hhhjmubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMhjjubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjáubj)”}”(hhh]”hV)”}”(hXCopy 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]”h.)”}”(hXCopy 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]”hXCopy 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:”…””}”(hjŠhjˆubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM1hj„ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjáubj1)”}”(hhh]”hQ)”}”(hhh]”(hV)”}”(hŒWthe directory in which you extracted the Metacat distribution (for binary distribution)”h]”h.)”}”(hjªh]”hŒWthe directory in which you extracted the Metacat distribution (for binary distribution)”…””}”(hjªhj¬ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM3hj¨ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj¥ubhV)”}”(hŒz/src/scripts/workers.properties (for both the source distribution and source code checked out from SVN) ”h]”h.)”}”(hŒy/src/scripts/workers.properties (for both the source distribution and source code checked out from SVN)”h]”hŒy/src/scripts/workers.properties (for both the source distribution and source code checked out from SVN)”…””}”(hjÅhjÃubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM4hj¿ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj¥ubeh}”(h]”h!]”h#]”h%]”h']”j™jšuh+hPhh,hM3hj¢ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjáubj)”}”(hhh]”hV)”}”(hŒ[Edit the workers.properties file and make sure the following properties are set correctly: ”h]”h.)”}”(hŒZEdit the workers.properties file and make sure the following properties are set correctly:”h]”hŒZEdit the workers.properties file and make sure the following properties are set correctly:”…””}”(hjìhjêubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM6hjæubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjãubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjáubj1)”}”(hhh]”jÂ)”}”(hŒrworkers.tomcat_home - set to the Tomcat install directory. workers.java_home - set to the Java install directory.”h]”hŒrworkers.tomcat_home - set to the Tomcat install directory. workers.java_home - set to the Java install directory.”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM:hjubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjáubj)”}”(hhh]”hV)”}”(hŒEnable the Apache Mod HEADERS: ”h]”h.)”}”(hŒEnable the Apache Mod HEADERS:”h]”hŒEnable the Apache Mod HEADERS:”…””}”(hj$hj"ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM=hjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjáubj1)”}”(hhh]”jÂ)”}”(hŒsudo a2enmod headers”h]”hŒsudo a2enmod headers”…””}”(hhhj?ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMAhj<ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjáubj)”}”(hhh]”hV)”}”(hŒ.Restart Apache to bring in changes by typing: ”h]”h.)”}”(hŒ-Restart Apache to bring in changes by typing:”h]”hŒ-Restart Apache to bring in changes by typing:”…””}”(hj\hjZubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMChjVubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjSubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjáubj1)”}”(hhh]”jÂ)”}”(hŒ sudo /etc/init.d/apache2 restart”h]”hŒ sudo /etc/init.d/apache2 restart”…””}”(hhhjwubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMGhjtubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjáubeh}”(h]”h!]”h#]”h%]”h']”uh+jhjÃhhhh,hNubh.)”}”(hŒàThis section contains instructions for installing and configuring the Apache Web server for Metacat on an Ubuntu_/Debian system. Instructions for configuring Apache running on other Linux systems are included in the sidebar.”h]”(hŒjThis section contains instructions for installing and configuring the Apache Web server for Metacat on an ”…””}”(hŒjThis section contains instructions for installing and configuring the Apache Web server for Metacat on an ”hj‘hhhNhNubh^)”}”(hŒUbuntu_”h]”hŒUbuntu”…””}”(hhhjšubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒUbuntu”jùj"uh+h]hj‘jûKubhŒo/Debian system. Instructions for configuring Apache running on other Linux systems are included in the sidebar.”…””}”(hŒo/Debian system. Instructions for configuring Apache running on other Linux systems are included in the sidebar.”hj‘hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMIhjÃhhubj)”}”(hhh]”hV)”}”(hŒtInstall the Apache and Mod JK packages (Mod JK is the module Apache uses to talk to Tomcat applications) by typing: ”•h]”h.)”}”(hŒsInstall the Apache and Mod JK packages (Mod JK is the module Apache uses to talk to Tomcat applications) by typing:”h]”hŒsInstall the Apache and Mod JK packages (Mod JK is the module Apache uses to talk to Tomcat applications) by typing:”…””}”(hj¾hj¼ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMMhj¸ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjµhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhjÃhhhh,hMMubjÂ)”}”(hŒ.sudo apt-get install apache2 libapache2-mod-jk”h]”hŒ.sudo apt-get install apache2 libapache2-mod-jk”…””}”(hhhjÖubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMQhjÃhhhh,ubh.)”}”(hX`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:”h]”hX`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:”…””}”(hjæhjähhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMShjÃhhubhQ)”}”(hhh]”(hV)”}”(hŒOthe directory in which you extracted the distribution (for binary distribution)”h]”h.)”}”(hj÷h]”hŒOthe directory in which you extracted the distribution (for binary distribution)”…””}”(hj÷hjùubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMYhjõubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjòhhhh,hNubhV)”}”(hX#``/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 ````. ”h]”h.)”}”(hX"``/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 ````.”h]”(j)”}”(hŒ"``/src/scripts``”h]”hŒ/src/scripts”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjubhŒ… (for both the source distribution and source code checked out from SVN). We will refer to the directory with the helper scripts as ”…””}”(hŒ… (for both the source distribution and source code checked out from SVN). We will refer to the directory with the helper scripts as ”hjubj)”}”(hŒ````”h]”hŒ”…””}”(hhhj'ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjubhŒ4 and the directory where Apache is installed (e.g., ”…””}”(hŒ4 and the directory where Apache is installed (e.g., ”hjubj)”}”(hŒ``/etc/apache2/``”h]”hŒ /etc/apache2/”…””}”(hhhj:ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjubhŒ) as ”…””}”(hŒ) as ”hjubj)”}”(hŒ````”h]”hŒ”…””}”(hhhjMubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjubhŒ.”…””}”(hj¦hjubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMZhjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjòhhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j™jšuh+hPhh,hMYhjÃhhubj)”}”(hhh]”hV)”}”(hŒ.Set up Mod JK apache configuration by typing: ”h]”h.)”}”(hŒ-Set up Mod JK apache configuration by typing:”h]”hŒ-Set up Mod JK apache configuration by typing:”…””}”(hjzhjxubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM\hjtubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjqhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjÃhhhh,hM\ubjÂ)”}”(hŒ›sudo cp /debian/jk.conf /mods-available sudo cp /debian/workers.properties ”h]”hŒ›sudo cp /debian/jk.conf /mods-available sudo cp /debian/workers.properties ”…””}”(hhhj’ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM`hjÃhhhh,ubj)”}”(hhh]”hV)”}”(hŒKDisable and re-enable the Apache Mod JK module to pick up the new changes: ”h]”h.)”}”(hŒJDisable and re-enable the Apache Mod JK module to pick up the new changes:”h]”hŒJDisable and re-enable the Apache Mod JK module to pick up the new changes:”…””}”(hj©hj§ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMchj£ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjÃhhhh,hMcubjÂ)”}”(hŒ sudo a2dismod jk sudo a2enmod jk”h]”hŒ sudo a2dismod jk sudo a2enmod jk”…””}”(hhhjÁubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMghjÃhhhh,ubj)”}”(hhh]”hV)”}”(hXApache 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: ”h]”h.)”}”(hXApache 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:”h]”hXApache 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:”…””}”(hjØhjÖubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMjhjÒubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÏhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjÃhhhh,hMjubjÂ)”}”(hŒssudo cp /metacat-site.conf /sites-available sudo a2ensite metacat-site.conf”h]”hŒssudo cp /metacat-site.conf /sites-available sudo a2ensite metacat-site.conf”…””}”(hhhjðubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMnhjÃhhhh,ubj)”}”(hhh]”hV)”}”(hŒ/Disable the default Apache site configuration: ”h]”h.)”}”(hŒ.Disable the default Apache site configuration:”h]”hŒ.Disable the default Apache site configuration:”…””}”(hjhjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMqhjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjþhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjÃhhhh,hMqubjÂ)”}”(hŒsudo a2dissite 000-default”h]”hŒsudo a2dissite 000-default”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMuhjÃhhhh,ubj)”}”(hhh]”hV)”}”(hŒ.Restart Apache to bring in changes by typing: ”h]”h.)”}”(hŒ-Restart Apache to bring in changes by typing:”h]”hŒ-Restart Apache to bring in changes by typing:”…””}”(hj6hj4ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMwhj0ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj-hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjÃhhhh,hMwubjÂ)”}”(hŒ sudo /etc/init.d/apache2 restart”h]”hŒ sudo /etc/init.d/apache2 restart”…””}”(hhhjNubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM{hjÃhhhh,ubeh}”(h]”jîah!]”h#]”Œ(apache httpd server (highly recommended)”ah%]”h']”uh+h hj¾hhhh,hKíubh )”}”(hhh]”(h)”}”(hjh]”hŒPostgreSQL Database”…””}”(hjhjfhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)juh+hhjchhhh,hMubh.)”}”(hŒ¶Currently 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_:”h]”(hŒ Currently Metacat only supports ”…””}”(hŒ Currently Metacat only supports ”hjshhhNhNubh^)”}”(hŒPostgreSQL_”h]”hŒ PostgreSQL”…””}”(hhhj|ubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ PostgreSQL”jùjúuh+h]hjsjûKubhŒ. You can choose the release versions of PostgreSQL 8, 9, 10 or 11. The newer versions are preferred. To install and configure ”…””}”(hŒ. You can choose the release versions of PostgreSQL 8, 9, 10 or 11. The newer versions are preferred. To install and configure ”hjshhhNhNubh^)”}”(hŒPostgreSQL_”h]”hŒ PostgreSQL”…””}”(hhhj‘ubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ PostgreSQL”jùjúuh+h]hjsjûKubhŒ:”…””}”(hŒ:”hjshhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM€hjchhubj)”}”(hhh]”hV)”}”(hŒ=If you are running Ubuntu_/Debian, get PostgreSQL by typing: ”h]”h.)”}”(hŒhhhNhNubj)”}”(hŒ ``SOLR_OPTS``”h]”hŒ SOLR_OPTS”…””}”(hhhjGubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj>ubhŒ9 variable in the environment specific include file (e.g. ”…””}”(hŒ9 variable in the environment specific include file (e.g. ”hj>hhhNhNubj)”}”(hŒ``/etc/default/solr.in.sh``”h]”hŒ/etc/default/solr.in.sh”…””}”(hhhjZubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj>ubhŒ ) such as:”…””}”(hŒ ) such as:”hj>hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhj“hhubjÂ)”}”(hŒ*SOLR_OPTS="$SOLR_OPTS -Dsolr.allowPaths=*"”h]”hŒ*SOLR_OPTS="$SOLR_OPTS -Dsolr.allowPaths=*"”…””}”(hhhjsubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMhj“hhhh,ubj)”}”(hhh]”hV)”}”(hŒIncrease Memory ”h]”h.)”}”(hŒIncrease Memory”h]”hŒIncrease Memory”…””}”(hjŠhjˆubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhj„ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhj“hhhh,hMubh.)”}”(hŒ‹Note: If you are upgrading the Solr server and you might already run this command during the previous installation, you may skip this step.”h]”hŒ‹Note: If you are upgrading the Solr server and you might already run this command during the previous installation, you may skip this step.”…””}”(hj¤hj¢hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhj“hhubh.)”}”(hXJBy default, Solr sets the maximum Java heap size to 512M (-Xmx512m). Values between 10 and 20 gigabytes are not uncommon for production servers. When you need to change the memory settings for your Solr server, use the ``SOLR_JAVA_MEM`` variable in the environment specific include file (e.g. ``/etc/default/solr.in.sh``) such as:”h]”(hŒÛBy default, Solr sets the maximum Java heap size to 512M (-Xmx512m). Values between 10 and 20 gigabytes are not uncommon for production servers. When you need to change the memory settings for your Solr server, use the ”…””}”(hŒÛBy default, Solr sets the maximum Java heap size to 512M (-Xmx512m). Values between 10 and 20 gigabytes are not uncommon for production servers. When you need to change the memory settings for your Solr server, use the ”hj°hhhNhNubj)”}”(hŒ``SOLR_JAVA_MEM``”h]”hŒ SOLR_JAVA_MEM”…””}”(hhhj¹ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj°ubhŒ9 variable in the environment specific include file (e.g. ”…””}”(hŒ9 variable in the environment specific include file (e.g. ”hj°hhhNhNubj)”}”(hŒ``/etc/default/solr.in.sh``”h]”hŒ/etc/default/solr.in.sh”…””}”(hhhjÌubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj°ubhŒ ) such as:”…””}”(hŒ ) such as:”hj°hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhj“hhubjÂ)”}”(hŒSOLR_JAVA_MEM="-Xms2g -Xmx2g"”h]”hŒSOLR_JAVA_MEM="-Xms2g -Xmx2g"”…””}”(hhhjåubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMhj“hhhh,ubj)”}”(hhh]”hV)”}”(hŒ Tomcat and Solr User Management ”h]”h.)”}”(hŒTomcat and Solr User Management”h]”hŒTomcat and Solr User Management”…””}”(hjühjúubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM hjöubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjóhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhj“hhhh,hM ubh.)”}”(hŒŠNote: If you are upgrading the Solr server and you have already run this command during the previous installation, you may skip this step.”h]”hŒŠNote: If you are upgrading the Solr server and you have already run this command during the previous installation, you may skip this step.”…””}”(hjhjhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM"hj“hhubh.)”}”(hŒÃThe interaction of the Tomcat and Solr services can cause the file permission issues. Add the ``tomcat8`` user to the ``solr`` group and the ``solr`` user to ``tomcat8`` group to fix the problem:”h]”(hŒ^The interaction of the Tomcat and Solr services can cause the file permission issues. Add the ”…””}”(hŒ^The interaction of the Tomcat and Solr services can cause the file permission issues. Add the ”hj"hhhNhNubj)”}”(hŒ``tomcat8``”h]”hŒtomcat8”…””}”(hhhj+ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj"ubhŒ user to the ”…””}”(hŒ user to the ”hj"hhhNhNubj)”}”(hŒ``solr``”h]”hŒsolr”…””}”(hhhj>ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj"ubhŒ group and the ”…””}”(hŒ group and the ”hj"hhhNhNubj)”}”(hŒ``solr``”h]”hŒsolr”…””}”(hhhjQubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj"ubhŒ user to ”…””}”(hŒ user to ”hj"hhhNhNubj)”}”(hŒ``tomcat8``”h]”hŒtomcat8”…””}”(hhhjdubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj"ubhŒ group to fix the problem:”…””}”(hŒ group to fix the problem:”hj"hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM$hj“hhubjÂ)”}”(hŒ?sudo usermod -a -G solr tomcat8 sudo usermod -a -G tomcat8 solr”h]”hŒ?sudo usermod -a -G solr tomcat8 sudo usermod -a -G tomcat8 solr”…””}”(hhhj}ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM)hj“hhhh,ubj)”}”(hhh]”hV)”}”(hŒURestart the Solr server to make the new group setting effective (:note2:`Important`) ”h]”h.)”}”(hŒTRestart the Solr server to make the new group setting effective (:note2:`Important`)”h]”(hŒARestart the Solr server to make the new group setting effective (”…””}”(hŒARestart the Solr server to make the new group setting effective (”hj’ubhŒinline”“”)”}”(hŒ:note2:`Important`”h]”hŒ Important”…””}”(hhhjubah}”(h]”h!]”Œnote2”ah#]”h%]”h']”uh+j›hj’ubhŒ)”…””}”(hjehj’ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM,hjŽubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj‹hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíK uh+jhj“hhhh,hM,ubjÂ)”}”(hŒ.sudo service solr stop sudo service solr start”h]”hŒ.sudo service solr stop sudo service solr start”…””}”(hhhjÂubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM0hj“hhhh,ubj)”}”(hhh]”hV)”}”(hŒ^Check that the ``tomcat8`` user and ``solr`` user are members of the appropriate groups with: ”h]”h.)”}”(hŒ]Check that the ``tomcat8`` user and ``solr`` user are members of the appropriate groups with:”h]”(hŒCheck that the ”…””}”(hŒCheck that the ”hj×ubj)”}”(hŒ``tomcat8``”h]”hŒtomcat8”…””}”(hhhjàubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj×ubhŒ user and ”…””}”(hŒ user and ”hj×ubj)”}”(hŒ``solr``”h]”hŒsolr”…””}”(hhhjóubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj×ubhŒ1 user are members of the appropriate groups with:”…””}”(hŒ1 user are members of the appropriate groups with:”hj×ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM3hjÓubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÐhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíK uh+jhj“hhhh,hM3ubjÂ)”}”(hŒ$sudo groups tomcat8 sudo groups solr”h]”hŒ$sudo groups tomcat8 sudo groups solr”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM7hj“hhhh,ubh.)”}”(hXNote: If you're running Tomcat using systemd, systemd sandboxes Tomcat limiting the directories it can write to and prevents Metacat from operating correctly. Ensure the following lines exist in the service file for Tomcat (paths may vary depending on your configuration):”h]”hXNote: If youâ€™re running Tomcat using systemd, systemd sandboxes Tomcat limiting the directories it can write to and prevents Metacat from operating correctly. Ensure the following lines exist in the service file for Tomcat (paths may vary depending on your configuration):”…””}”(hj(hj&hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM:hj“hhubjÂ)”}”(hŒBReadWritePaths=/var/metacat ReadWritePaths=/etc/default/solr.in.sh”h]”hŒBReadWritePaths=/var/metacat ReadWritePaths=/etc/default/solr.in.sh”…””}”(hhhj4ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM@hj“hhhh,ubeh}”(h]”j4ah!]”h#]”Œsolr server”ah%]”h']”uh+h hj¾hhhh,hMßjKubh )”}”(hhh]”(h)”}”(hjNh]”hŒ$Apache Ant (if building from Source)”…””}”(hjNhjLhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)jQuh+hhjIhhhh,hMDubh.)”}”(hXáIf 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.”h]”hXéIf 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.”…””}”(hj[hjYhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMEhjIhhubh.)”}”(hŒ5If you are running Ubuntu/Debian, get Ant by typing::”h]”hŒ4If you are running Ubuntu/Debian, get Ant by typing:”…””}”(hŒ4If you are running Ubuntu/Debian, get Ant by typing:”hjghhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMMhjIhhubjÂ)”}”(hŒsudo apt-get install ant”h]”hŒsudo apt-get install ant”…””}”(hhhjvubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMOhjIhhhh,ubh.)”}”(hŒ3Otherwise, get Ant from the `Apache Ant`_ homepage.”h]”(hŒOtherwise, get Ant from the ”…””}”(hŒOtherwise, get Ant from the ”hj„hhhNhNubh^)”}”(hŒ `Apache Ant`_”h]”hŒ Apache Ant”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”Œname”Œ Apache Ant”jùjuh+h]hj„jûKubhŒ homepage.”…””}”(hŒ homepage.”hj„hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMQhjIhhubh.)”}”(hŒªAnt 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.”h]”hŒ°Ant 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.”…””}”(hjªhj¨hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMShjIhhubeh}”(h]”jWah!]”h#]”Œ$apache ant (if building from source)”ah%]”h']”uh+h hj¾hhhh,hMDubeh}”(h]”jˆah!]”h#]”Œ,installing and configuring required software”ah%]”h']”uh+h hjÆhhhh,hK¤ubh )”}”(hhh]”(h)”}”(hj}h]”hŒInstalling Metacat”…””}”(hj}hjÇhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)j€uh+hhjÄhhhh,hMXubh.)”}”(hŒTInstructions for a new install, an upgrade, and a source install are included below.”h]”hŒTInstructions for a new install, an upgrade, and a source install are included below.”…””}”(hjÖhjÔhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMYhjÄhhubh )”}”(hhh]”(h)”}”(hjh]”hŒNew Install”…””}”(hjhjåhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)j uh+hhjâhhhh,hM]ubh.)”}”(hX)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.”h]”hX)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.”…””}”(hjôhjòhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM^hjâhhubh.)”}”(hŒ!To install a new Metacat servlet:”h]”hŒ!To install a new Metacat servlet:”…””}”(hjhjhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMchjâhhubj)”}”(hhh]”hV)”}”(hXñCreate 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: ”h]”h.)”}”(hXðCreate 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:”h]”hXôCreate 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:”…””}”(hjhjubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMehjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhjâhhhh,hMeubj1)”}”(hhh]”jÂ)”}”(hŒsudo mkdir /var/metacat”h]”hŒsudo mkdir /var/metacat”…””}”(hhhj2ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMihj/ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjâhhhh,hNubj)”}”(hhh]”hV)”}”(hŒ²Change 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): ”h]”h.)”}”(hŒ±Change 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):”h]”hŒ±Change 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):”…””}”(hjOhjMubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMkhjIubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjFhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjâhhhh,hMkubj1)”}”(hhh]”jÂ)”}”(hŒ(sudo chown -R /var/metacat”h]”hŒ(sudo chown -R /var/metacat”…””}”(hhhjjubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMohjgubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjâhhhh,hNubj)”}”(hhh]”hV)”}”(hXøInstall 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: ”h]”h.)”}”(hX÷Install 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:”h]”(hXUInstall 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., ”…””}”(hXUInstall 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., ”hj…ubh^)”}”(hŒhttp://yourserver.com/metacat/”h]”hŒhttp://yourserver.com/metacat/”…””}”(hhhjŽubah}”(h]”h!]”h#]”h%]”h']”Œrefuri”juh+h]hj…ubhŒ„). To change the context, simply change the name of the WAR file to the desired name before copying it. To install the Metacat WAR:”…””}”(hŒ„). To change the context, simply change the name of the WAR file to the desired name before copying it. To install the Metacat WAR:”hj…ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMrhjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj~hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjâhhhh,hMrubj1)”}”(hhh]”jÂ)”}”(hŒ¸sudo cp /metacat.war sudo cp /metacat-index.war sudo cp /metacatui.war ”h]”hŒ¸sudo cp /metacat.war sudo cp /metacat-index.war sudo cp /metacatui.war ”…””}”(hhhj·ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMvhj´ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjâhhhh,hNubj)”}”(hhh]”hV)”}”(hŒ[Restart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type: ”h]”h.)”}”(hŒZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:”h]”hŒ^Restart Tomcat. Log in as the user that runs your Tomcat server (often â€œtomcatâ€) and type:”…””}”(hjÔhjÒubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM{hjÎubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjËhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjâhhhh,hM{ubj1)”}”(hhh]”jÂ)”}”(hŒ sudo /etc/init.d/tomcat7 restart”h]”hŒ sudo /etc/init.d/tomcat7 restart”…””}”(hhhjïubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMhjìubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjâhhhh,hNubh.)”}”(hX[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.”h]”(hŒ©Congratulations! You have now installed Metacat. If everything is installed correctly, you should see the Authentication Configuration screen (Figure 2.1) when you type ”…””}”(hŒ©Congratulations! You have now installed Metacat. If everything is installed correctly, you should see the Authentication Configuration screen (Figure 2.1) when you type ”hjhhhNhNubh^)”}”(hŒ"http://yourserver.com/yourcontext/”h]”hŒ"http://yourserver.com/yourcontext/”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”Œrefuri”juh+h]hjubhŒ (e.g., ”…””}”(hŒ (e.g., ”hjhhhNhNubh^)”}”(hŒ!http://knb.ecoinformatics.org/knb”h]”hŒ!http://knb.ecoinformatics.org/knb”…””}”(hhhj ubah}”(h]”h!]”h#]”h%]”h']”Œrefuri”j"uh+h]hjubhŒg) into a browser. For more information about configuring Metacat, please see the Configuration Section.”…””}”(hŒg) into a browser. For more information about configuring Metacat, please see the Configuration Section.”hjhhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhjâhhubhŒfigure”“”)”}”(hhh]”(hŒimage”“”)”}”(hŒ¬.. figure:: images/screenshots/image009.png :align: center The Authentication Configuration screen appears the first time you open a new installation of Metacat. ”h]”h}”(h]”h!]”h#]”h%]”h']”Œuri”Œimages/screenshots/image009.png”Œ candidates”}”jšjLsuh+j?hj<hh,hMŠubhŒcaption”“”)”}”(hŒfThe Authentication Configuration screen appears the first time you open a new installation of Metacat.”h]”hŒfThe Authentication Configuration screen appears the first time you open a new installation of Metacat.”…””}”(hjShjQubah}”(h]”h!]”h#]”h%]”h']”uh+jOhh,hMŠhj<ubeh}”(h]”Œid5”ah!]”h#]”h%]”h']”Œalign”Œcenter”uh+j:hMŠhjâhhhh,ubeh}”(h]”j¦ah!]”h#]”Œnew install”ah%]”h']”uh+h hjÄhhhh,hM]ubh )”}”(hhh]”(h)”}”(hjÀh]”hŒUpgrade Metacat”…””}”(hjÀhjrhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)jÃuh+hhjohhhh,hMŽubh.)”}”(hŒ½To 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:”h]”hŒ½To 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:”…””}”(hjhjhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhjohhubj)”}”(hhh]”(hV)”}”(hŒDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Downloading Metacat. ”h]”h.)”}”(hŒDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Downloading Metacat.”h]”hŒDownload and extract the new version of Metacat. For more information about downloading and extracting Metacat, please see Downloading Metacat.”…””}”(hj–hj”ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM“hjubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubhV)”}”(hŒrStop running Metacat. To stop Metacat, log in as the user that runs your Tomcat server (often "tomcat") and type: ”h]”h.)”}”(hŒqStop running Metacat. To stop Metacat, log in as the user that runs your Tomcat server (often "tomcat") and type:”h]”hŒuStop running Metacat. To stop Metacat, log in as the user that runs your Tomcat server (often â€œtomcatâ€) and type:”…””}”(hj®hj¬ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM•hj¨ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjhhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhjohhhh,hM“ubj1)”}”(hhh]”jÂ)”}”(hŒ/etc/init.d/tomcat7 stop”h]”hŒ/etc/init.d/tomcat7 stop”…””}”(hhhjÉubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM™hjÆubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjohhhh,hNubj)”}”(hhh]”hV)”}”(hŒØBack 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: ”h]”h.)”}”(hŒ×Back 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:”h]”hŒ×Back 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:”…””}”(hjæhjäubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM›hjàubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÝhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjohhhh,hM›ubj1)”}”(hhh]”(jÂ)”}”(hŒycp /metacat /metacat. cp /metacat.war /metacat.war.”h]”hŒycp /metacat /metacat. cp /metacat.war /metacat.war.”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMŸhjþubh.)”}”(hŒzWarning: Do not backup the files to the ```` directory. Tomcat will try to run the backup copy as a service.”h]”(hŒ(Warning: Do not backup the files to the ”…””}”(hŒ(Warning: Do not backup the files to the ”hjubj)”}”(hŒ````”h]”hŒ ”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjubhŒA directory. Tomcat will try to run the backup copy as a service.”…””}”(hŒA directory. Tomcat will try to run the backup copy as a service.”hjubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM¢hjþubeh}”(h]”h!]”h#]”h%]”h']”uh+j0hjohhhh,hNubj)”}”(hhh]”hV)”}”(hŒGCopy the new Metacat WAR file in to the Tomcat applications directory: ”h]”h.)”}”(hŒFCopy the new Metacat WAR file in to the Tomcat applications directory:”h]”hŒFCopy the new Metacat WAR file in to the Tomcat applications directory:”…””}”(hj@hj>ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM¥hj:ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj7hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjohhhh,hM¥ubj1)”}”(hhh]”(jÂ)”}”(hŒ:sudo cp /metacat.war ”h]”hŒ:sudo cp /metacat.war ”…””}”(hhhj[ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM©hjXubh.)”}”(hŒ¿Note: 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.”h]”(hŒONote: Typically, Tomcat will look for its application files (WAR files) in the ”…””}”(hŒONote: Typically, Tomcat will look for its application files (WAR files) in the ”hjiubj)”}”(hŒ``/webapps``”h]”hŒ/webapps”…””}”(hhhjrubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjiubhŒW directory. Your instance of Tomcat may be configured to look in a different directory.”…””}”(hŒW directory. Your instance of Tomcat may be configured to look in a different directory.”hjiubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM«hjXubeh}”(h]”h!]”h#]”h%]”h']”uh+j0hjohhhh,hNubj)”}”(hhh]”hV)”}”(hŒÞIf 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. ”h]”h.)”}”(hŒÝIf 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.”h]”hŒÝIf 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.”…””}”(hjšhj˜ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM¯hj”ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj‘hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjohhhh,hM¯ubj1)”}”(hhh]”jÂ)”}”(hŒ/authority.war ”h]”hŒ/authority.war ”…””}”(hhhjµubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM³hj²ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjohhhh,hNubj)”}”(hhh]”hV)”}”(hŒRestart Tomcat (and Apache if you have Tomcat integrated with it). Log in as the user that runs your Tomcat server (often "tomcat"), and type: ”h]”h.)”}”(hŒŽRestart Tomcat (and Apache if you have Tomcat integrated with it). Log in as the user that runs your Tomcat server (often "tomcat"), and type:”h]”hŒ’Restart Tomcat (and Apache if you have Tomcat integrated with it). Log in as the user that runs your Tomcat server (often â€œtomcatâ€), and type:”…””}”(hjÒhjÐubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMµhjÌubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjÉhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjohhhh,hMµubj1)”}”(hhh]”jÂ)”}”(hŒ/etc/init.d/tomcat7 restart”h]”hŒ/etc/init.d/tomcat7 restart”…””}”(hhhjíubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM¹hjêubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjohhhh,hNubh.)”}”(hŒ{7. Run your new Metacat servlet. Go to a Web browser and visit your installed Metacat application, using a URL of the form:”h]”hŒ{7. Run your new Metacat servlet. Go to a Web browser and visit your installed Metacat application, using a URL of the form:”…””}”(hjhjhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM¼hjohhubj1)”}”(hhh]”jÂ)”}”(hŒ-http://yourserver.yourdomain.com/yourcontext/”h]”hŒ-http://yourserver.yourdomain.com/yourcontext/”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMÁhjubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjohhhh,hNubh.)”}”(hXYou 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/”h]”(hX…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 ”…””}”(hX{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 ”hj&hhhNhNubh^)”}”(hŒ2http://yourserver.yourdomain.com:8080/yourcontext/”h]”hŒ2http://yourserver.yourdomain.com:8080/yourcontext/”…””}”(hhhj/ubah}”(h]”h!]”h#]”h%]”h']”Œrefuri”j1uh+h]hj&ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMÃhjohhubeh}”(h]”jÉah!]”h#]”Œupgrade metacat”ah%]”h']”uh+h hjÄhhhh,hMŽubh )”}”(hhh]”(h)”}”(hjãh]”hŒSource Install and Upgrade”…””}”(hjãhjNhhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)jæuh+hhjKhhhh,hMËubh.)”}”(hŒÞWhether 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).”h]”hŒÞWhether 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).”…””}”(hj]hj[hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMÌhjKhhubh.)”}”(hŒTo install Metacat from source:”h]”hŒTo install Metacat from source:”…””}”(hjkhjihhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMÐhjKhhubj)”}”(hhh]”hV)”}”(hŒ´Edit the build.properties file found in the directory in which you downloaded Metacat. Note: Throughout the instructions, we will refer to this directory as ````. ”h]”h.)”}”(hŒ³Edit the build.properties file found in the directory in which you downloaded Metacat. Note: Throughout the instructions, we will refer to this directory as ````.”h]”(hŒEdit the build.properties file found in the directory in which you downloaded Metacat. Note: Throughout the instructions, we will refer to this directory as ”…””}”(hŒEdit the build.properties file found in the directory in which you downloaded Metacat. Note: Throughout the instructions, we will refer to this directory as ”hj~ubj)”}”(hŒ````”h]”hŒ”…””}”(hhhj‡ubah}”(h]”h!]”h#]”h%]”h']”uh+j~hj~ubhŒ.”…””}”(hj¦hj~ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMÒhjzubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjwhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhjKhhhh,hMÒubj1)”}”(hhh]”hQ)”}”(hhh]”(hV)”}”(hŒÀSet 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/tomcat”h]”h.)”}”(hŒÀSet 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/tomcat”h]”hŒÀSet 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/tomcat”…””}”(hj·hjµubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMÖhj±ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj®ubhV)”}”(hŒSet the app.deploy.dir property to your application deployment directory. For instance: app.deploy.dir=/usr/local/tomcat/webapps ”h]”h.)”}”(hŒ€Set the app.deploy.dir property to your application deployment directory. For instance: app.deploy.dir=/usr/local/tomcat/webapps”h]”hŒ€Set the app.deploy.dir property to your application deployment directory. For instance: app.deploy.dir=/usr/local/tomcat/webapps”…””}”(hjÏhjÍubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMÙhjÉubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj®ubeh}”(h]”h!]”h#]”h%]”h']”j™jšuh+hPhh,hMÖhj«ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjKhhhNhNubj)”}”(hhh]”hV)”}”(hŒ#In the ````, run: ”h]”h.)”}”(hŒ"In the ````, run:”h]”(hŒIn the ”…””}”(hŒIn the ”hjôubj)”}”(hŒ````”h]”hŒ”…””}”(hhhjýubah}”(h]”h!]”h#]”h%]”h']”uh+j~hjôubhŒ, run:”…””}”(hŒ, run:”hjôubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMÜhjðubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjíhhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjKhhhh,hMÜubj1)”}”(hhh]”(jÂ)”}”(hŒsudo ant clean install”h]”hŒsudo ant clean install”…””}”(hhhj%ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMàhj"ubh.)”}”(hŒfYou will see the individual modules get built. You should see a "BUILD SUCCESSFUL" message at the end.”h]”hŒjYou will see the individual modules get built. You should see a â€œBUILD SUCCESSFULâ€ message at the end.”…””}”(hj5hj3ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMâhj"ubh.)”}”(hŒUYou should see a new file named metacat.war in your application deployment directory.”h]”hŒUYou should see a new file named metacat.war in your application deployment directory.”…””}”(hjChjAubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMåhj"ubeh}”(h]”h!]”h#]”h%]”h']”uh+j0hjKhhhh,hNubh.)”}”(hŒ>To run your new Metacat servlet, open a Web browser and type::”h]”hŒ=To run your new Metacat servlet, open a Web browser and type:”…””}”(hŒ=To run your new Metacat servlet, open a Web browser and type:”hjUhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMèhjKhhubjÂ)”}”(hŒ\http://yourserver.yourdomain.com/yourcontext/ (e.g. http://knb.ecoinformatics.org/metacat/)”h]”hŒ\http://yourserver.yourdomain.com/yourcontext/ (e.g. http://knb.ecoinformatics.org/metacat/)”…””}”(hhhjdubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMêhjKhhhh,ubh.)”}”(hŒóYour 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.”h]”hŒ÷Your 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.”…””}”(hjthjrhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMíhjKhhubeh}”(h]”jìah!]”h#]”Œsource install and upgrade”ah%]”h']”uh+h hjÄhhhh,hMËubeh}”(h]”j†ah!]”h#]”Œinstalling metacat”ah%]”h']”uh+h hjÆhhhh,hMXubh )”}”(hhh]”(h)”}”(hjh]”hŒ+Optional Installation Options (LSID Server)”…””}”(hjhj‘hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)juh+hhjŽhhhh,hMòubhŒnote”“”)”}”(hŒúThe 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.”h]”h.)”}”(hŒúThe 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.”h]”(hŒWThe support for LSID identifiers is deprecated, and is being replaced with support for ”…””}”(hŒWThe support for LSID identifiers is deprecated, and is being replaced with support for ”hj¤ubh^)”}”(hŒDOI_”h]”hŒDOI”…””}”(hhhjubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒDOI”jùŒhttp://www.doi.org/”uh+h]hj¤jûKubhŒŸ 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.”…””}”(hŒŸ 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.”hj¤ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMöhj ubah}”(h]”h!]”h#]”h%]”h']”uh+jžhjŽhhhh,hNubjõ)”}”(hŒ.. _DOI: http://www.doi.org/”h]”h}”(h]”Œdoi”ah!]”h#]”Œdoi”ah%]”h']”jùj½uh+jôhMûhjŽhhhh,jKubh.)”}”(hXèMetacat'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.”•-šh]”hXîMetacatâ€™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.”…””}”(hjÝhjÛhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMýhjŽhhubh.)”}”(hXãUsing 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.”h]”(hŒÃUsing 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., ”…””}”(hŒÃUsing 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., ”hjéhhhNhNubh^)”}”(hŒDOI_”h]”hŒDOI”…””}”(hhhjòubah}”(h]”h!]”h#]”h%]”h']”Œname”ŒDOI”jùj½uh+h]hjéjûKubhX, 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.”…””}”(hX, 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.”hjéhhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhjŽhhubh.)”}”(hŒThe format of an LSID is::”h]”hŒThe format of an LSID is:”…””}”(hŒThe format of an LSID is:”hj hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhjŽhhubjÂ)”}”(hŒeurn:lsid:::[:] e.g., urn:lsid:ecoinformatics.org:tao:12039:1”h]”hŒeurn:lsid:::[:] e.g., urn:lsid:ecoinformatics.org:tao:12039:1”…””}”(hhhj ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMhjŽhhhh,ubh.)”}”(hX†When 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::”h]”(hX7When 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: ”…””}”(hX7When 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: ”hj* hhhNhNubh^)”}”(hŒhttp://example.com:9999”h]”hŒhttp://example.com:9999”…””}”(hhhj3 ubah}”(h]”h!]”h#]”h%]”h']”Œrefuri”j5 uh+h]hj* ubhŒ7 can be accessed by the following HTTP Metacat queries:”…””}”(hŒ7 can be accessed by the following HTTP Metacat queries:”hj* hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhjŽhhubjÂ)”}”(hŒÚhttp://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)”h]”hŒÚhttp://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)”…””}”(hhhjM ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM"hjŽhhhh,ubh.)”}”(hXYNotice 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.”h]”hXYNotice 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.”…””}”(hj] hj[ hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM(hjŽhhubh )”}”(hhh]”(h)”}”(hj2h]”hŒ:Install and configure the LSID Server shipped with Metacat”…””}”(hj2hjl hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)j5uh+hhji hhhh,hM/ubh.)”}”(hŒ9To install the LSID server using the binary installation:”h]”hŒ9To install the LSID server using the binary installation:”…””}”(hj{ hjy hhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM1hji hhubj)”}”(hhh]”hV)”}”(hŒ'Copy the authority.war file to Tomcat: ”h]”h.)”}”(hŒ&Copy the authority.war file to Tomcat:”h]”hŒ&Copy the authority.war file to Tomcat:”…””}”(hj hjŽ ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM3hjŠ ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj‡ hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhji hhhh,hM3ubj1)”}”(hhh]”jÂ)”}”(hŒLsudo cp /authority.war /usr/share/tomcat7/webapps”h]”hŒLsudo cp /authority.war /usr/share/tomcat7/webapps”…””}”(hhhj« ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM7hj¨ ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hji hhhh,hNubj)”}”(hhh]”(hV)”}”(hŒìSet 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 ”h]”(h.)”}”(hŒ†Set up the LSID server by dropping the authority file into Apache's sites-available directory and running a2ensite to enable the site:”h]”hŒˆSet up the LSID server by dropping the authority file into Apacheâ€™s sites-available directory and running a2ensite to enable the site:”…””}”(hjÈ hjÆ ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM9hjÂ ubjÂ)”}”(hŒ[sudo cp /authority /etc/apache2/sites-available sudo a2ensite authority”h]”hŒ[sudo cp /authority /etc/apache2/sites-available sudo a2ensite authority”…””}”(hhhjÔ ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM>hjÂ ubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhj¿ hhhh,hNubhV)”}”(hŒ€Restart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type: :: /etc/init.d/tomcat5.5 restart ”h]”(h.)”}”(hŒZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:”h]”hŒ^Restart Tomcat. Log in as the user that runs your Tomcat server (often â€œtomcatâ€) and type:”…””}”(hjî hjì ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMAhjè ubjÂ)”}”(hŒ/etc/init.d/tomcat5.5 restart”h]”hŒ/etc/init.d/tomcat5.5 restart”…””}”(hhhjú ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMFhjè ubeh}”(h]”h!]”h#]”h%]”h']”uh+hUhj¿ hhhh,hNubhV)”}”(hŒ.Restart Apache to bring in changes by typing: ”h]”h.)”}”(hŒ-Restart Apache to bring in changes by typing:”h]”hŒ-Restart Apache to bring in changes by typing:”…””}”(hj!hj!ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMHhj!ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj¿ hhhh,hNubeh}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhji hhhh,hM9ubj1)”}”(hhh]”jÂ)”}”(hŒ sudo /etc/init.d/apache2 restart”h]”hŒ sudo /etc/init.d/apache2 restart”…””}”(hhhj/!ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMLhj,!ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hji hhhh,hNubj)”}”(hhh]”hV)”}”(hŒcSee notes beneath LSID server source installation for instructions for modifying the SRV record(s) ”h]”h.)”}”(hŒbSee notes beneath LSID server source installation for instructions for modifying the SRV record(s)”h]”hŒbSee notes beneath LSID server source installation for instructions for modifying the SRV record(s)”…””}”(hjL!hjJ!ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMNhjF!ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjC!hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhji hhhh,hMNubeh}”(h]”j;ah!]”h#]”Œ:install and configure the lsid server shipped with metacat”ah%]”h']”uh+h hjŽhhhh,hM/ubh )”}”(hhh]”(h)”}”(hjUh]”hŒ(To install the LSID server from a source”…””}”(hjUhjn!hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)jXuh+hhjk!hhhh,hMRubj)”}”(hhh]”hV)”}”(hŒªIn 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: ”h]”h.)”}”(hŒ©In 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:”h]”hŒ©In 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:”…””}”(hj„!hj‚!ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMThj~!ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj{!hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦uh+jhjk!hhhh,hMTubj1)”}”(hhh]”jÂ)”}”(hŒCauthority.context=authority config.lsidauthority=ecoinformatics.org”h]”hŒCauthority.context=authority config.lsidauthority=ecoinformatics.org”…””}”(hhhjŸ!ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMZhjœ!ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjk!hhhh,hNubj)”}”(hhh]”hV)”}”(hŒCIn the create the authority.war by running: ”h]”h.)”}”(hŒBIn the create the authority.war by running:”h]”hŒBIn the create the authority.war by running:”…””}”(hj¼!hjº!ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM]hj¶!ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj³!hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjk!hhhh,hM]ubj1)”}”(hhh]”jÂ)”}”(hŒsudo ant war-lsid”h]”hŒsudo ant war-lsid”…””}”(hhhj×!ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMahjÔ!ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjk!hhhh,hNubj)”}”(hhh]”hV)”}”(hŒ>Copy the LSID WAR file into the Tomcat application directory. ”h]”h.)”}”(hŒ=Copy the LSID WAR file into the Tomcat application directory.”h]”hŒ=Copy the LSID WAR file into the Tomcat application directory.”…””}”(hjô!hjò!ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMchjî!ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhjë!hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjk!hhhh,hMcubj1)”}”(hhh]”jÂ)”}”(hŒAsudo cp /dist/authority.war ”h]”hŒAsudo cp /dist/authority.war ”…””}”(hhhj"ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMghj"ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjk!hhhh,hNubj)”}”(hhh]”hV)”}”(hŒ[Restart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type: ”h]”h.)”}”(hŒZRestart Tomcat. Log in as the user that runs your Tomcat server (often "tomcat") and type:”h]”hŒ^Restart Tomcat. Log in as the user that runs your Tomcat server (often â€œtomcatâ€) and type:”…””}”(hj,"hj*"ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMihj&"ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj#"hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjk!hhhh,hMiubj1)”}”(hhh]”jÂ)”}”(hŒ/etc/init.d/tomcat7 restart”h]”hŒ/etc/init.d/tomcat7 restart”…””}”(hhhjG"ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMnhjD"ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjk!hhhh,hNubj)”}”(hhh]”hV)”}”(hŒ›If you are running Tomcat behind the Apache server (the recommended configuration), set up and enable the authority service site configurations by typing: ”h]”h.)”}”(hŒšIf you are running Tomcat behind the Apache server (the recommended configuration), set up and enable the authority service site configurations by typing:”h]”hŒšIf you are running Tomcat behind the Apache server (the recommended configuration), set up and enable the authority service site configurations by typing:”…””}”(hjd"hjb"ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMphj^"ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj["hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjk!hhhh,hMpubj1)”}”(hhh]”(jÂ)”}”(hŒcsudo cp /authority /sites-available sudo a2ensite authority”h]”hŒcsudo cp /authority /sites-available sudo a2ensite authority”…””}”(hhhj"ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMvhj|"ubh.)”}”(hŒIWhere can be found in /src/scripts”h]”hŒIWhere can be found in /src/scripts”…””}”(hj"hj"ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMyhj|"ubeh}”(h]”h!]”h#]”h%]”h']”uh+j0hjk!hhhh,hNubj)”}”(hhh]”hV)”}”(hŒ.Restart Apache to bring in changes by typing: ”h]”h.)”}”(hŒ-Restart Apache to bring in changes by typing:”h]”hŒ-Restart Apache to bring in changes by typing:”…””}”(hjª"hj¨"ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM{hj¤"ubah}”(h]”h!]”h#]”h%]”h']”uh+hUhj¡"hhhh,hNubah}”(h]”h!]”h#]”h%]”h']”j¢j£j¤hj¥j¦jíKuh+jhjk!hhhh,hM{ubj1)”}”(hhh]”(jÂ)”}”(hŒ sudo /etc/init.d/apache2 restart”h]”hŒ sudo /etc/init.d/apache2 restart”…””}”(hhhjÅ"ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhMhjÂ"ubh.)”}”(hŒÒOnce 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:”h]”hŒÔOnce 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:”…””}”(hjÕ"hjÓ"ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMhjÂ"ubj1)”}”(hhh]”jÂ)”}”(hŒF_lsid._tcp IN SRV 1 0 8080 .”h]”hŒF_lsid._tcp IN SRV 1 0 8080 .”…””}”(hhhjä"ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM‡hjá"ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjÂ"ubh.)”}”(hŒpWhere is the name of the machine that will serve as the physical location of the AuthorityService.”h]”hŒpWhere is the name of the machine that will serve as the physical location of the AuthorityService.”…””}”(hjú"hjø"ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM‰hjÂ"ubh.)”}”(hŒWFor example, the value of for the below example URL would be example.com:”h]”hŒWFor example, the value of for the below example URL would be example.com:”…””}”(hj#hj#ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hMŒhjÂ"ubj1)”}”(hhh]”jÂ)”}”(hŒShttp://example.com:9999/authority/data?lsid=urn:lsid:ecoinformatics.org:tao:12039:1”h]”hŒShttp://example.com:9999/authority/data?lsid=urn:lsid:ecoinformatics.org:tao:12039:1”…””}”(hhhj#ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhM‘hj#ubah}”(h]”h!]”h#]”h%]”h']”uh+j0hjÂ"ubh.)”}”(hŒ^For more information, please see http://www.ibm.com/developerworks/opensource/library/os-lsid/”h]”(hŒ!For more information, please see ”…””}”(hŒ!For more information, please see ”hj+#ubh^)”}”(hŒ=http://www.ibm.com/developerworks/opensource/library/os-lsid/”h]”hŒ=http://www.ibm.com/developerworks/opensource/library/os-lsid/”…””}”(hhhj4#ubah}”(h]”h!]”h#]”h%]”h']”Œrefuri”j6#uh+h]hj+#ubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM“hjÂ"ubeh}”(h]”h!]”h#]”h%]”h']”uh+j0hjk!hhhh,hNubeh}”(h]”j^ah!]”h#]”Œ(to install the lsid server from a source”ah%]”h']”uh+h hjŽhhhh,hMRubeh}”(h]”jah!]”h#]”Œ+optional installation options (lsid server)”ah%]”h']”uh+h hjÆhhhh,hMòubh )”}”(hhh]”(h)”}”(hj„h]”hŒTroubleshooting”…””}”(hj„hj`#hhhNhNubah}”(h]”h!]”h#]”h%]”h']”h)j‡uh+hhj]#hhhh,hM–ubh.)”}”(hŒ²We 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.”h]”(hŒYWe keep and update a list of common problems and their solutions on the KNB website. See ”…””}”(hŒYWe keep and update a list of common problems and their solutions on the KNB website. See ”hjm#hhhNhNubh^)”}”(hŒChttp://knb.ecoinformatics.org/software/metacat/troubleshooting.html”h]”hŒChttp://knb.ecoinformatics.org/software/metacat/troubleshooting.html”…””}”(hhhjv#ubah}”(h]”h!]”h#]”h%]”h']”Œrefuri”jx#uh+h]hjm#ubhŒ for more information.”…””}”(hŒ for more information.”hjm#hhhNhNubeh}”(h]”h!]”h#]”h%]”h']”uh+h-hh,hM—hj]#hhubeh}”(h]”jah!]”h#]”Œtroubleshooting”ah%]”h']”uh+h hjÆhhhh,hM–ubeh}”(h]”h°ah!]”h#]”Œinstalling on linux”ah%]”h']”uh+h hhhhhh,hK1ubeh}”(h]”hmah!]”h#]”Œ"downloading and installing metacat”ah%]”h']”uh+h hhhhhh,hKubah}”(h]”h!]”h#]”h%]”h']”Œsource”h,uh+hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hNŒ generator”NŒ datestamp”NŒsource_link”NŒ source_url”NŒ toc_backlinks”j Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒreport_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jÇ#Œerror_encoding”ŒUTF-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h,Œ_destination”NŒ _config_files”]”Œpep_references”NŒpep_base_url”Œ https://www.python.org/dev/peps/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œhttps://tools.ietf.org/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œfile_insertion_enabled”ˆŒraw_enabled”KŒsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”NŒcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒenv”NŒgettext_compact”ˆubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”(Œ postgresql”]”(jéjij=jR j|j‘eŒ apache ant”]”(jjz jeŒ apache tomcat”]”(j8j(j jeŒapache httpd server”]”(j\jQj* eŒjava 8”]”(j¨jjæeŒ solr 8.8.2”]”jÒaŒmetacat download page”]”(jÂjbj_eŒsolr server”]”j£ aŒubuntu”]”(jjEjÑjšj¼eŒoracle”]”jZaŒdoi”]”(jjòeuŒrefids”}”Œnameids”}”(j¢#hmj¾jºjÃhjÿjüjj jjj%j"j1j.j=j:jIjFj›#h°j·hÐj°jj»hój/jjj6j´jYjÁjˆj~j{j`jîjjjFj4jºjWj‹j†jlj¦jHjÉj„jìjZ#jjØjÕjh!j;jS#j^j”#juŒ nametypes”}”(j¢#Nj¾NjÃNjÿˆjˆjˆj%ˆj1ˆj=ˆjIˆj›#Nj·Nj°ˆj»Nj/NjNj´NjÁNj~ˆj`NjNjFNjºNj‹NjlNjHNj„NjZ#NjØˆjh!NjS#Nj”#Nuh}”(hmhjºh?hjÁjüjöj jjjj"jj.j(j:j4jFj@h°jÆhÐjäjj§hójºjj5j6j2jYjjˆj¾j¨jÄ j{jujËjˆjîjÃjjcj4j“j½hŒsystem_message”“”)”}”(hhh]”h.)”}”(hŒ0Inline emphasis start-string without end-string.”h]”hŒ0Inline emphasis start-string without end-string.”…””}”(hhhj$$ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj!$ubah}”(h]”j½ah!]”h#]”h%]”h']”j·aŒlevel”KŒtype”ŒWARNING”Œline”MàŒsource”h,uh+j$hj“hhhh,hMãubj·j®jWjIj†jÄj¦jâjÉjojìjKjjŽjÕjÏj;ji j^jk!jj]#jaj<h*h_h‡h}hªh hÊhÀhíhãj jj0j&jSjIj‚jxj¢j˜jÅj»jèjÞjjj.j$jQjGj€jvj j–jÃj¹jæjÜjjj5j+jXjNj‡j}uŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒid_start”KŒparse_messages”]”(j $)”}”(hhh]”(h.)”}”(hŒTitle underline too short.”h]”hŒTitle underline too short.”…””}”(hhhjU$ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjR$ubjÂ)”}”(hŒRDownload the Metacat Installer (Highly Recommended) ..............................”h]”hŒRDownload the Metacat Installer (Highly Recommended) ..............................”…””}”(hhhjc$ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhjR$ubeh}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j:$Œline”KZŒsource”h,uh+j$hj5hhhh,hKZubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ4â€ (ordinal 4)”…””}”(hhhj~$ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj{$ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”ŒINFO”Œsource”h,Œline”Kuh+j$hj2hhhh,hK„ubj $)”}”(hhh]”(h.)”}”(hhh]”hŒTitle underline too short.”…””}”(hhhjš$ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj—$ubjÂ)”}”(hŒrCheck Out Metacat Source Code from GitHub (for Developers) .......................................................”h]”hŒrCheck Out Metacat Source Code from GitHub (for Developers) .......................................................”…””}”(hhhj§$ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhj—$ubeh}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j:$Œline”K‹Œsource”h,uh+j$ubj $)”}”(hhh]”(h.)”}”(hŒTitle underline too short.”h]”hŒTitle underline too short.”…””}”(hhhjÂ$ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj¿$ubjÂ)”}”(hŒrCheck Out Metacat Source Code from GitHub (for Developers) .......................................................”h]”hŒrCheck Out Metacat Source Code from GitHub (for Developers) .......................................................”…””}”(hhhjÐ$ubah}”(h]”h!]”h#]”h%]”h']”jÑjÒuh+jÁhj¿$ubeh}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j:$Œline”K‹Œsource”h,uh+j$hjhhhh,hK‹ubj $)”}”(hhh]”h.)”}”(hŒ)Duplicate implicit target name: "java 8".”h]”hŒ-Duplicate implicit target name: â€œjava 8â€.”…””}”(hhhjë$ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjè$ubah}”(h]”h!]”h#]”h%]”h']”j¨aŒlevel”KŒtype”j”$Œsource”h,Œline”K³uh+j$hjÄ hhhh,hK³ubj $)”}”(hhh]”h.)”}”(hŒ0Duplicate implicit target name: "apache tomcat".”h]”hŒ4Duplicate implicit target name: â€œapache tomcatâ€.”…””}”(hhhj%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj%ubah}”(h]”h!]”h#]”h%]”h']”jËaŒlevel”KŒtype”j”$Œsource”h,Œline”KÁuh+j$hjˆhhhh,hKÁubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hhhj!%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjáubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ3â€ (ordinal 3)”…””}”(hhhj<%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj9%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjáubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ4â€ (ordinal 4)”…””}”(hhhjW%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjT%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjáubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "5" (ordinal 5)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ5â€ (ordinal 5)”…””}”(hhhjr%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjo%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjáubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "6" (ordinal 6)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ6â€ (ordinal 6)”…””}”(hhhj%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjŠ%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjáubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hhhj¨%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj¥%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjÃhhhh,hM\ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ3â€ (ordinal 3)”…””}”(hhhjÃ%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjÀ%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjÃhhhh,hMcubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ4â€ (ordinal 4)”…””}”(hhhjÞ%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjÛ%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjÃhhhh,hMjubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "5" (ordinal 5)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ5â€ (ordinal 5)”…””}”(hhhjù%ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjö%ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjÃhhhh,hMqubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "6" (ordinal 6)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ6â€ (ordinal 6)”…””}”(hhhj&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjÃhhhh,hMwubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hhhj/&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj,&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjchhhh,hMŠubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ3â€ (ordinal 3)”…””}”(hhhjJ&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjG&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjchhhh,hMubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ4â€ (ordinal 4)”…””}”(hhhje&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjb&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjchhhh,hM—ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "5" (ordinal 5)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ5â€ (ordinal 5)”…””}”(hhhj€&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj}&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjchhhh,hM¬ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "6" (ordinal 6)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ6â€ (ordinal 6)”…””}”(hhhj›&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj˜&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjchhhh,hM³ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "7" (ordinal 7)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ7â€ (ordinal 7)”…””}”(hhhj¶&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj³&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjchhhh,hM»ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "8" (ordinal 8)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ8â€ (ordinal 8)”…””}”(hhhjÑ&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjÎ&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjchhhh,hMÁubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "9" (ordinal 9)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ9â€ (ordinal 9)”…””}”(hhhjì&ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjé&ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjchhhh,hMÇubj $)”}”(hhh]”h.)”}”(hŒEnumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hhhj='ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj:'ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hj“hhhh,hMïubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ3â€ (ordinal 3)”…””}”(hhhjX'ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjU'ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hj“hhhh,hMûubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ4â€ (ordinal 4)”…””}”(hhhjs'ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjp'ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hj“hhhh,hMubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "5" (ordinal 5)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ5â€ (ordinal 5)”…””}”(hhhjŽ'ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj‹'ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hj“hhhh,hMubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "6" (ordinal 6)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ6â€ (ordinal 6)”…””}”(hhhj©'ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj¦'ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hj“hhhh,hM ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "7" (ordinal 7)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ7â€ (ordinal 7)”…””}”(hhhjÄ'ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjÁ'ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hj“hhhh,hMubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "8" (ordinal 8)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ8â€ (ordinal 8)”…””}”(hhhjß'ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjÜ'ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hj“hhhh,hM ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "9" (ordinal 9)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ9â€ (ordinal 9)”…””}”(hhhjú'ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj÷'ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hj“hhhh,hM,ubj $)”}”(hhh]”h.)”}”(hŒEnumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hhhj0(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj-(ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjâhhhh,hMkubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ3â€ (ordinal 3)”…””}”(hhhjK(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjH(ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjâhhhh,hMrubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ4â€ (ordinal 4)”…””}”(hhhjf(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjc(ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjâhhhh,hM{ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ3â€ (ordinal 3)”…””}”(hhhj(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj~(ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjohhhh,hM›ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ4â€ (ordinal 4)”…””}”(hhhjœ(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj™(ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjohhhh,hM¥ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "5" (ordinal 5)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ5â€ (ordinal 5)”…””}”(hhhj·(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj´(ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjohhhh,hM¯ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "6" (ordinal 6)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ6â€ (ordinal 6)”…””}”(hhhjÒ(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjÏ(ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjohhhh,hMµubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hhhjí(ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjê(ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjKhhhh,hMÜubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hhhj)ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj)ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hji hhhh,hM9ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "5" (ordinal 5)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ5â€ (ordinal 5)”…””}”(hhhj#)ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj )ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hji hhhh,hMNubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ2â€ (ordinal 2)”…””}”(hhhj>)ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj;)ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjk!hhhh,hM]ubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ3â€ (ordinal 3)”…””}”(hhhjY)ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjV)ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjk!hhhh,hMcubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ4â€ (ordinal 4)”…””}”(hhhjt)ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjq)ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjk!hhhh,hMiubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "5" (ordinal 5)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ5â€ (ordinal 5)”…””}”(hhhj)ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hjŒ)ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjk!hhhh,hMpubj $)”}”(hhh]”h.)”}”(hŒ:Enumerated list start value not ordinal-1: "6" (ordinal 6)”h]”hŒ>Enumerated list start value not ordinal-1: â€œ6â€ (ordinal 6)”…””}”(hhhjª)ubah}”(h]”h!]”h#]”h%]”h']”uh+h-hj§)ubah}”(h]”h!]”h#]”h%]”h']”Œlevel”KŒtype”j”$Œsource”h,Œline”Kuh+j$hjk!hhhh,hM{ubeŒtransform_messages”]”Œtransformer”NŒ decoration”Nhhub.