Äï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]hhùubah}î(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)îhj��ubah}î(h]îåid11îah!]îh#]îh%]îh']îårefidîå1download-the-metacat-installer-highly-recommendedîuh+h]hj���ubah}î(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)îhjI��ubah}î(h]îåid13îah!]îh#]îh%]îh']îårefidîå8check-out-metacat-source-code-from-github-for-developersîuh+h]hjF��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hjC��ubah}î(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îhjx��ubah}î(h]îåid14îah!]îh#]îh%]îh']îårefidîå,installing-and-configuring-required-softwareîuh+h]hju��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hjr��ubhQ)Åî}î(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+hUhjè��ubhV)Åî}î(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+hUhjè��ubhV)Åî}î(hhh]îh.)Åî}î(hhh]îh^)Åî}î(hhh]îhå(Apache HTTPD Server (Highly Recommended)îÖîÅî}î(hå(Apache HTTPD Server (Highly Recommended)îhjfi��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+hUhjè��ubhV)Åî}î(hhh]îh.)Åî}î(hhh]îh^)Åî}î(hhh]îhåPostgreSQL DatabaseîÖîÅî}î(håPostgreSQL Databaseîhj��ubah}î(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+hUhjè��ubhV)Åî}î(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-hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjè��ubhV)Åî}î(hhh]îh.)Åî}î(hhh]îh^)Åî}î(hhh]îhå$Apache Ant (if building from Source)îÖîÅî}î(hå$Apache Ant (if building from Source)îhjG��ubah}î(h]îåid20îah!]îh#]îh%]îh']îårefidîå"apache-ant-if-building-from-sourceîuh+h]hjD��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hjA��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjè��ubeh}î(h]îh!]îh#]îh%]îh']îuh+hPhjr��ubeh}î(h]îh!]îh#]îh%]îh']îuh+hUhh∑ubhV)Åî}î(hhh]î(h.)Åî}î(hhh]îh^)Åî}î(hhh]îhåInstalling MetacatîÖîÅî}î(håInstalling Metacatîhjv��ubah}î(h]îåid21îah!]îh#]îh%]îh']îårefidîåinstalling-metacatîuh+h]hjs��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hjp��ubhQ)Åî}î(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-hjê��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjç��ubhV)Åî}î(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+hUhjç��ubhV)Åî}î(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+hUhjç��ubeh}î(h]îh!]îh#]îh%]îh']îuh+hPhjp��ubeh}î(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)îhj��ubah}î(h]îåid25îah!]îh#]îh%]îh']îårefidîå)optional-installation-options-lsid-serverîuh+h]hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hj��ubhQ)Åî}î(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îhjN��ubah}î(h]îåid27îah!]îh#]îh%]îh']îårefidîå(to-install-the-lsid-server-from-a-sourceîuh+h]hjK��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hjH��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj"��ubeh}î(h]îh!]îh#]îh%]îh']îuh+hPhj��ubeh}î(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]hjz��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hjw��ubah}î(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,hKhj¡��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+hUhjfl��hhhh,hNubhV)Åî}î(hå'`Apache Ant`_ (if building from source)îh]îh.)Åî}î(hj
��h]î(h^)Åî}î(hå
`Apache Ant`_îh]îhå
Apache AntîÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
Apache Antîj˘��åhttp://ant.apache.org/îuh+h]hj��j˚��Kubhå (if building from source)îÖîÅî}î(hå (if building from source)îhj��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKhj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjfl��hhhh,hNubhV)Åî}î(hå`Apache Tomcat`_îh]îh.)Åî}î(hj3��h]îh^)Åî}î(hj3��h]îhå
Apache TomcatîÖîÅî}î(hhhj8��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
Apache Tomcatîj˘��åhttp://tomcat.apache.org/îuh+h]hj5��j˚��Kubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKhj1��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjfl��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]hjX��j˚��Kubhå (recommended)îÖîÅî}î(hå (recommended)îhjX��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKhjT��ubhQ)Åî}î(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.îÖîÅî}î(hjÅ��hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKhj{��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjx��ubah}î(h]îh!]îh#]îh%]îh']îåbulletîå*îuh+hPhh,hKhjT��ubeh}î(h]îh!]îh#]îh%]îh']îuh+hUhjfl��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+hUhjfl��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+hUhjfl��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,j��Kubjı��)Åî}î(hå&.. _Apache Ant: http://ant.apache.org/îh]îh}î(h]îå
apache-antîah!]îh#]îå
apache antîah%]îh']îj˘��j��uh+jÙ��hKhj¡��hhhh,j��Kubjı��)Åî}î(hå,.. _Apache Tomcat: http://tomcat.apache.org/îh]îh}î(h]îå
apache-tomcatîah!]îh#]îå
apache tomcatîah%]îh']îj˘��jG��uh+jÙ��hK hj¡��hhhh,j��Kubjı��)Åî}î(hå1.. _Apache HTTPD Server: http://httpd.apache.org/îh]îh}î(h]îåapache-httpd-serverîah!]îh#]îåapache httpd serverîah%]îh']îj˘��jl��uh+jÙ��hK"hj¡��hhhh,j��Kubjı��)Åî}î(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,j��Kubjı��)Åî}î(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,j��Kubh.)Åî}î(hå(System requirements for running Metacat:îh]îhå(System requirements for running Metacat:îÖîÅî}î(hjN��hjL��hhhNhNubah}î(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 îhja��ubh^)Åî}î(håPostgreSQL_îh]îhå
PostgreSQLîÖîÅî}î(hhhji��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
PostgreSQLîj˘��j˙��uh+h]hja��j˚��Kubhå	 databaseîÖîÅî}î(hå	 databaseîhja��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK+hj]��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjZ��hhhh,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+hUhjZ��hhhh,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+hUhjZ��hhhh,hNubeh}î(h]îh!]îh#]îh%]îh']îjô��jö��uh+hPhh,hK+hj¡��hhubeh}î(h]îhçah!]î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.)Åî}î(hXO��This 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]îhXO��This 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 (îhj��ubh^)Åî}î(hå	`Java 8`_îh]îhåJava 8îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îånameîåJava 8îj˘��j∏��uh+h]hj��j˚��Kubhå, îÖîÅî}î(hå, îhj��ubh^)Åî}î(hå`Apache Tomcat`_îh]îhå
Apache TomcatîÖîÅî}î(hhhj(��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
Apache Tomcatîj˘��jG��uh+h]hj��j˚��Kubhå 7, îÖîÅî}î(hå 7, îhj��ubh^)Åî}î(håPostgreSQL_îh]îhå
PostgreSQLîÖîÅî}î(hhhj=��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
PostgreSQLîj˘��j˙��uh+h]hj��j˚��Kubhå, îÖîÅî}î(hj'��hj��ubh^)Åî}î(hå`Apache HTTPD Server`_îh]îhåApache HTTPD ServerîÖîÅî}î(hhhjQ��ubah}î(h]îh!]îh#]îh%]îh']îånameîåApache HTTPD Serverîj˘��jl��uh+h]hj��j˚��Kubhå)îÖîÅî}î(hå)îhj��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK>hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj��hhhh,hNubhV)Åî}î(håtCreate a database in PostgreSQL named 'metacat' and authorize access to it in ``pb_hba.conf`` for the user 'metacat'îh]îh.)Åî}î(hjt��h]î(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 îhjv��ubh�åliteralîìî)Åî}î(hå``pb_hba.conf``îh]îhåpb_hba.confîÖîÅî}î(hhhjÄ��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hjv��ubhå for the user ‚Äòmetacat‚ÄôîÖîÅî}î(hå for the user 'metacat'îhjv��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK?hjr��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj��hhhh,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+hUhj��hhhh,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+hUhj��hhhh,hNubhV)Åî}î(håE``sudo mkdir /var/metacat; sudo chown -R <tomcat_user> /var/metacat``îh]îh.)Åî}î(hjÊ��h]îj��)Åî}î(hjÊ��h]îhåAsudo mkdir /var/metacat; sudo chown -R <tomcat_user> /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+hUhj��hhhh,hNubhV)Åî}î(hå>``sudo cp <metacat_package_dir>/metacat.war <tomcat_app_dir>``îh]îh.)Åî}î(hj��h]îj��)Åî}î(hj��h]îhå:sudo cp <metacat_package_dir>/metacat.war <tomcat_app_dir>îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKChj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj��hhhh,hNubhV)Åî}î(håD``sudo cp <metacat_package_dir>/metacat-index.war <tomcat_app_dir>``îh]îh.)Åî}î(hj&��h]îj��)Åî}î(hj&��h]îhå@sudo cp <metacat_package_dir>/metacat-index.war <tomcat_app_dir>îÖîÅî}î(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+hUhj��hhhh,hNubhV)Åî}î(hå@``sudo cp <metacat_package_dir>/metacatui.war <tomcat_app_dir>``îh]îh.)Åî}î(hjF��h]îj��)Åî}î(hjF��h]îhå<sudo cp <metacat_package_dir>/metacatui.war <tomcat_app_dir>îÖîÅî}î(hhhjK��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hjH��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKEhjD��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj��hhhh,hNubhV)Åî}î(hå$``sudo /etc/init.d/tomcat7 restart``îh]îh.)Åî}î(hjf��h]îj��)Åî}î(hjf��h]îhå sudo /etc/init.d/tomcat7 restartîÖîÅî}î(hhhjk��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hjh��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKFhjd��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj��hhhh,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+hUhj��hhhh,hNubeh}î(h]îh!]îh#]îh%]îh']îåenumtypeîåarabicîåprefixîhåsuffixîå.îuh+j��hj‰��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,j��Kubeh}î(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›��hjfl��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.îÖîÅî}î(hj��hj
��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
��hj8��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)j
��uh+hhj5��hhhh,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:îÖîÅî}î(hjG��hjE��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK[hj5��hhubj��)Åî}î(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.)Åî}î(hjX��h]î(håBrowse to the îÖîÅî}î(håBrowse to the îhjZ��ubh^)Åî}î(hå`Metacat Download Page`_îh]îhåMetacat Download PageîÖîÅî}î(hhhjb��ubah}î(h]îh!]îh#]îh%]îh']îånameîåMetacat Download Pageîj˘��j“��uh+h]hjZ��j˚��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., îhjZ��ubhå2.19.0îÖîÅî}î(hå2.19.0îhjZ��ubhå)îÖîÅî}î(hje��hjZ��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK^hjV��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjS��hhhh,hNubhV)Åî}î(håSave the file locally.îh]îh.)Åî}î(hjé��h]îhåSave the file locally.îÖîÅî}î(hjé��hjê��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK_hjå��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjS��hhhh,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+hUhjS��hhhh,hNubeh}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��uh+j��hj5��hhhh,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¡��hKdhj5��hhhh,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 ``<metacat_package_dir>`` 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å``<metacat_package_dir>``îh]îhå<metacat_package_dir>îÖîÅî}î(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,hKfhj5��hhubh�å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îÖîÅî}î(hj���hj˛
��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ı��hj5��hhhh,hNubeh}î(h]îj��ah!]îh#]îå3download the metacat installer (highly recommended)îah%]îh']îuh+h	hj∫��hhhh,hKZubh
)Åî}î(hhh]î(h)Åî}î(hj-��h]îhåDownload Metacat Source CodeîÖîÅî}î(hj-��hj5��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)j0��uh+hhj2��hhhh,hKyubh.)Åî}î(hå'To get the Metacat source distribution:îh]îhå'To get the Metacat source distribution:îÖîÅî}î(hjD��hjB��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKzhj2��hhubj��)Åî}î(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.)Åî}î(hjU��h]î(håBrowse to the îÖîÅî}î(håBrowse to the îhjW��ubh^)Åî}î(hå`Metacat Download Page`_îh]îhåMetacat Download PageîÖîÅî}î(hhhj_��ubah}î(h]îh!]îh#]îh%]îh']îånameîåMetacat Download Pageîj˘��j“��uh+h]hjW��j˚��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., îhjW��ubhå2.19.0îÖîÅî}î(hj{��hjW��ubhå).îÖîÅî}î(hå).îhjW��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK|hjS��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjP��hhhh,hNubhV)Åî}î(håSave the file locally.îh]îh.)Åî}î(hjã��h]îhåSave the file locally.îÖîÅî}î(hjã��hjç��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK}hjâ��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjP��hhhh,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+hUhjP��hhhh,hNubeh}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��uh+j��hj2��hhhh,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Çhj2��hhhh,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+j��hj2��hhhh,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Ühj2��hhubeh}î(h]îj6��ah!]îh#]îådownload metacat source codeîah%]îh']îuh+h	hj∫��hhhh,hKyubh
)Åî}î(hhh]î(h)Åî}î(hjP��h]îhå:Check Out Metacat Source Code from GitHub (for Developers)îÖîÅî}î(hjP��hj��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)jS��uh+hhj��hhhh,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:îÖîÅî}î(hj��hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hhj��ubh.)Åî}î(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,hKèhj��ubj¬��)Åî}î(håsudo apt-get install gitîh]îhåsudo apt-get install gitîÖîÅî}î(hhhj5��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hKîhj��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j��hj��hhhh,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:îhjI��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKñhj��hhubj¬��)Åî}î(hå2git clone https://github.com/nceas/metacat metacatîh]îhå2git clone https://github.com/nceas/metacat metacatîÖîÅî}î(hhhjX��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hKôhj��hhhh,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 îhjf��hhhNhNubh�åtitle_referenceîìî)Åî}î(hå`main`îh]îhåmainîÖîÅî}î(hhhjq��ubah}î(h]îh!]îh#]îh%]îh']îuh+jo��hjf��ubhåÅ 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:îhjf��hhhNhNubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKõhj��hhubh.)Åî}î(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,hKùhj��hhubh.)Åî}î(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ühj��hhubeh}î(h]îjY��ah!]î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)Åî}î(hj��h]îhå,Installing and Configuring Required SoftwareîÖîÅî}î(hj��hj¡��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)jÇ��uh+hhjæ��hhhh,hK§ubh.)Åî}î(hXM��Before 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]îhXM��Before 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´hjfl��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˘��jG��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 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˘��jl��uh+h]hj'
��j˚��Kubhå (Highly Recommended)îÖîÅî}î(hå (Highly Recommended)îhj'
��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK≠hj#
��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˘��j��uh+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)j4��uh+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îÖîÅî}î(hhhj��ubah}î(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îÖîÅî}î(hhhjE��ubah}î(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îÖîÅî}î(hhhjZ��ubah}î(h]îh!]îh#]îh%]îh']îånameîåOracleîj˘��j��uh+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,j��Kubeh}î(h]îj®��ah!]îh#]îh%]îåjava 8îah']îuh+h	hjæ��hhhh,hK≥j��Kubh
)Åî}î(hhh]î(h)Åî}î(hj¬��h]îhå
Apache TomcatîÖîÅî}î(hj¬��hjã��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)j≈��uh+hhjà��hhhh,hK¡ubh.)Åî}î(håflWe 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åflWe 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 ``<tomcat_home>`` for
the remainder of the documentation.îh]î(hå<Note: we will refer to the Tomcat installation directory as îÖîÅî}î(hå<Note: we will refer to the Tomcat installation directory as îhj¶��hhhNhNubj��)Åî}î(hå``<tomcat_home>``îh]îhå
<tomcat_home>îÖîÅî}î(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îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
Apache Tomcatîj˘��jG��uh+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:îhj��hhhNhNubah}î(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:îhjI��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hK’hjà��hhubj¬��)Åî}î(hå<tomcat_home>/conf/server.xmlîh]îhå<tomcat_home>/conf/server.xmlîÖîÅî}î(hhhjX��ubah}î(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:îhjf��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKŸhjà��hhubj¬��)Åî}î(hå /etc/tomcat7/catalina.propertiesîh]îhå /etc/tomcat7/catalina.propertiesîÖîÅî}î(hhhju��ubah}î(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¡��hKflhjà��hhhh,ubh.)Åî}î(hX��Note: 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]îhX��Note: 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¡j��Kubh
)Åî}î(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.)Åî}î(hXy��Although 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]îhXy��Although 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 <apache_install_dir> is the
directory in which Apache is installed:

::

  <apache_install_dir>/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:

  ::

    <IfModule mod_jk.c>
      JkLogFile "/var/log/tomcat/mod_jk.log"
      JkLogLevel info
    </IfModule>

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:

  ::

    <VirtualHost XXX.XXX.XXX.XXX:80>
      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/"
      <Directory /var/www/cgi-bin/>
        AllowOverride None
        Options ExecCGI
        Require all granted
      </Directory>
      ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/"
      <Directory "/var/www/webapps/metacat/cgi-bin/">
        AllowOverride None
        Options ExecCGI
        Require all granted
      </Directory>
      <Directory "/var/www/metacatui">
         AllowOverride All
         FallbackResource /metacatui/index.html
         Require all granted
      </Directory>
      JkMount /metacat ajp13
      JkMount /metacat/* ajp13
      JkMount /metacat/metacat ajp13
      JkUnMount /metacat/cgi-bin/* ajp13
      JkMount /metacatui ajp13
      JkMount /metacatui/* ajp13
      JkMount /*.jsp ajp13
    </VirtualHost>

3. Copy the "workers.properties" file provided by Metacat into your Apache configuration directory (<apache_install_dir>/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)
  * <metacat_code_dir>/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 <apache_install_dir> 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 <apache_install_dir> is the
directory in which Apache is installed:îÖîÅî}î(hjı��hjÛ��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKˆhj·��ubj¬��)Åî}î(hå$<apache_install_dir>/conf/httpd.confîh]îhå$<apache_install_dir>/conf/httpd.confîÖîÅî}î(hhhj��ubah}î(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:îÖîÅî}î(hj��hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hKˇhj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj��ubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��uh+j��hj·��ubh�åblock_quoteîìî)Åî}î(hhh]îj¬��)Åî}î(håZ<IfModule mod_jk.c>
  JkLogFile "/var/log/tomcat/mod_jk.log"
  JkLogLevel info
</IfModule>îh]îhåZ<IfModule mod_jk.c>
  JkLogFile "/var/log/tomcat/mod_jk.log"
  JkLogLevel info
</IfModule>îÖîÅî}î(hhhj5��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMhj2��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hj·��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:îÖîÅî}î(hjR��hjP��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMhjL��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjI��ubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj·��ubj1��)Åî}î(hhh]îj¬��)Åî}î(hX��<VirtualHost XXX.XXX.XXX.XXX:80>
  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/"
  <Directory /var/www/cgi-bin/>
    AllowOverride None
    Options ExecCGI
    Require all granted
  </Directory>
  ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/"
  <Directory "/var/www/webapps/metacat/cgi-bin/">
    AllowOverride None
    Options ExecCGI
    Require all granted
  </Directory>
  <Directory "/var/www/metacatui">
     AllowOverride All
     FallbackResource /metacatui/index.html
     Require all granted
  </Directory>
  JkMount /metacat ajp13
  JkMount /metacat/* ajp13
  JkMount /metacat/metacat ajp13
  JkUnMount /metacat/cgi-bin/* ajp13
  JkMount /metacatui ajp13
  JkMount /metacatui/* ajp13
  JkMount /*.jsp ajp13
</VirtualHost>îh]îhX��<VirtualHost XXX.XXX.XXX.XXX:80>
  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/"
  <Directory /var/www/cgi-bin/>
    AllowOverride None
    Options ExecCGI
    Require all granted
  </Directory>
  ScriptAlias /metacat/cgi-bin/ "/var/www/webapps/metacat/cgi-bin/"
  <Directory "/var/www/webapps/metacat/cgi-bin/">
    AllowOverride None
    Options ExecCGI
    Require all granted
  </Directory>
  <Directory "/var/www/metacatui">
     AllowOverride All
     FallbackResource /metacatui/index.html
     Require all granted
  </Directory>
  JkMount /metacat ajp13
  JkMount /metacat/* ajp13
  JkMount /metacat/metacat ajp13
  JkUnMount /metacat/cgi-bin/* ajp13
  JkMount /metacatui ajp13
  JkMount /metacatui/* ajp13
  JkMount /*.jsp ajp13
</VirtualHost>îÖîÅî}î(hhhjm��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMhjj��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hj·��ubj��)Åî}î(hhh]îhV)Åî}î(hX��Copy the "workers.properties" file provided by Metacat into your Apache configuration directory (<apache_install_dir>/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.)Åî}î(hX��Copy the "workers.properties" file provided by Metacat into your Apache configuration directory (<apache_install_dir>/conf/).  Depending on whether you are installing from binary distribution or source, the workers.properties file will be in one of two locations:îh]îhX��Copy the ‚Äúworkers.properties‚Äù file provided by Metacat into your Apache configuration directory (<apache_install_dir>/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+hUhjÅ��ubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj·��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<metacat_code_dir>/src/scripts/workers.properties (for both the source distribution and source code checked out from SVN)
îh]îh.)Åî}î(håy<metacat_code_dir>/src/scripts/workers.properties (for both the source distribution and source code checked out from SVN)îh]îhåy<metacat_code_dir>/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+j0��hj·��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+j��hj·��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.îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM:hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hj·��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=hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj��ubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj·��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+j0��hj·��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\��hjZ��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMChjV��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjS��ubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj·��ubj1��)Åî}î(hhh]îj¬��)Åî}î(hå sudo /etc/init.d/apache2 restartîh]îhå sudo /etc/init.d/apache2 restartîÖîÅî}î(hhhjw��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMGhjt��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hj·��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j��hj√��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+j��hj√��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#��``<metacat_code_dir>/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 ``<metacat_helper_dir>`` and the directory where Apache is installed (e.g., ``/etc/apache2/``) as ``<apache_install_dir>``.
îh]îh.)Åî}î(hX"��``<metacat_code_dir>/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 ``<metacat_helper_dir>`` and the directory where Apache is installed (e.g., ``/etc/apache2/``) as ``<apache_install_dir>``.îh]î(j��)Åî}î(hå"``<metacat_code_dir>/src/scripts``îh]îhå<metacat_code_dir>/src/scriptsîÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj��ubhåÖ (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 îhj��ubj��)Åî}î(hå``<metacat_helper_dir>``îh]îhå<metacat_helper_dir>îÖîÅî}î(hhhj'��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj��ubhå4 and the directory where Apache is installed (e.g., îÖîÅî}î(hå4 and the directory where Apache is installed (e.g., îhj��ubj��)Åî}î(hå``/etc/apache2/``îh]îhå
/etc/apache2/îÖîÅî}î(hhhj:��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj��ubhå) as îÖîÅî}î(hå) as îhj��ubj��)Åî}î(hå``<apache_install_dir>``îh]îhå<apache_install_dir>îÖîÅî}î(hhhjM��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj��ubhå.îÖîÅî}î(hj¶��hj��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMZhj��ubah}î(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:îÖîÅî}î(hjz��hjx��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM\hjt��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjq��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj√��hhhh,hM\ubj¬��)Åî}î(håõsudo cp <metacat_helper_dir>/debian/jk.conf <apache_install_dir>/mods-available
sudo cp <metacat_helper_dir>/debian/workers.properties <apache_install_dir>îh]îhåõsudo cp <metacat_helper_dir>/debian/jk.conf <apache_install_dir>/mods-available
sudo cp <metacat_helper_dir>/debian/workers.properties <apache_install_dir>îÖîÅî}î(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+j��hj√��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)Åî}î(hX��Apache 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.)Åî}î(hX��Apache 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]îhX��Apache 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+j��hj√��hhhh,hMjubj¬��)Åî}î(håssudo cp <metacat_helper_dir>/metacat-site.conf <apache_install_dir>/sites-available
sudo a2ensite metacat-site.confîh]îhåssudo cp <metacat_helper_dir>/metacat-site.conf <apache_install_dir>/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:îÖîÅî}î(hj��hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMqhj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj˛��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj√��hhhh,hMqubj¬��)Åî}î(håsudo a2dissite 000-defaultîh]îhåsudo a2dissite 000-defaultîÖîÅî}î(hhhj��ubah}î(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:îÖîÅî}î(hj6��hj4��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMwhj0��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj-��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj√��hhhh,hMwubj¬��)Åî}î(hå sudo /etc/init.d/apache2 restartîh]îhå sudo /etc/init.d/apache2 restartîÖîÅî}î(hhhjN��ubah}î(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)Åî}î(hj��h]îhåPostgreSQL DatabaseîÖîÅî}î(hj��hjf��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)j��uh+hhjc��hhhh,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 îhjs��hhhNhNubh^)Åî}î(håPostgreSQL_îh]îhå
PostgreSQLîÖîÅî}î(hhhj|��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
PostgreSQLîj˘��j˙��uh+h]hjs��j˚��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 îhjs��hhhNhNubh^)Åî}î(håPostgreSQL_îh]îhå
PostgreSQLîÖîÅî}î(hhhjë��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
PostgreSQLîj˘��j˙��uh+h]hjs��j˚��Kubhå:îÖîÅî}î(hå:îhjs��hhhNhNubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMÄhjc��hhubj��)Åî}î(hhh]îhV)Åî}î(hå=If you are running Ubuntu_/Debian, get PostgreSQL by typing:
îh]îh.)Åî}î(hå<If you are running Ubuntu_/Debian, get PostgreSQL by typing:îh]î(håIf you are running îÖîÅî}î(håIf you are running îhj≥��ubh^)Åî}î(håUbuntu_îh]îhåUbuntuîÖîÅî}î(hhhjº��ubah}î(h]îh!]îh#]îh%]îh']îånameîåUbuntuîj˘��j"��uh+h]hj≥��j˚��Kubhå"/Debian, get PostgreSQL by typing:îÖîÅî}î(hå"/Debian, get PostgreSQL by typing:î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¶��uh+j��hjc��hhhh,hMÇubj1��)Åî}î(hhh]î(j¬��)Åî}î(håsudo apt-get install postgresqlîh]îhåsudo apt-get install postgresqlîÖîÅî}î(hhhjÊ��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMÜhj„��ubh.)Åî}î(hå0On other systems, install the rpms for postgres.îh]îhå0On other systems, install the rpms for postgres.îÖîÅî}î(hjˆ��hjÙ��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMàhj„��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(håStart the database by running:
îh]îh.)Åî}î(håStart the database by running:îh]îhåStart the database 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+j��hjc��hhhh,hMäubj1��)Åî}î(hhh]îj¬��)Åî}î(hå%sudo /etc/init.d/postgresql-8.4 startîh]îhå%sudo /etc/init.d/postgresql-8.4 startîÖîÅî}î(hhhj,��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMéhj)��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(håChange to postgres user:
îh]îh.)Åî}î(håChange to postgres user:îh]îhåChange to postgres user:îÖîÅî}î(hjI��hjG��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMêhjC��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj@��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjc��hhhh,hMêubj1��)Åî}î(hhh]îj¬��)Åî}î(håsudo su - postgresîh]îhåsudo su - postgresîÖîÅî}î(hhhjd��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMîhja��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(håXSet up an empty Metacat database instance by editing the postgreSQL configuration file:
îh]îh.)Åî}î(håWSet up an empty Metacat database instance by editing the postgreSQL configuration file:îh]îhåWSet up an empty Metacat database instance by editing the postgreSQL configuration file:îÖîÅî}î(hjÅ��hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMóhj{��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjx��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjc��hhhh,hMóubj1��)Åî}î(hhh]î(j¬��)Åî}î(hå*gedit /etc/postgresql/8.4/main/pg_hba.confîh]îhå*gedit /etc/postgresql/8.4/main/pg_hba.confîÖîÅî}î(hhhjú��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMõhjô��ubh.)Åî}î(hå1Add the following line to the configuration file:îh]îhå1Add the following line to the configuration file:îÖîÅî}î(hj¨��hj™��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMûhjô��ubj¬��)Åî}î(hå7host metacat metacat 127.0.0.1 255.255.255.255 passwordîh]îhå7host metacat metacat 127.0.0.1 255.255.255.255 passwordîÖîÅî}î(hhhj∏��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM¢hjô��ubh.)Åî}î(hå3Save the file and then create the Metacat instance:îh]îhå3Save the file and then create the Metacat instance:îÖîÅî}î(hj»��hj∆��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM•hjô��ubj¬��)Åî}î(håcreatedb metacatîh]îhåcreatedb metacatîÖîÅî}î(hhhj‘��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM©hjô��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(hå Log in to postgreSQL by typing:
îh]îh.)Åî}î(håLog in to postgreSQL by typing:îh]îhåLog in to postgreSQL 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+j��hjc��hhhh,hM¨ubj1��)Åî}î(hhh]îj¬��)Åî}î(håpsql metacatîh]îhåpsql metacatîÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM∞hj	��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(hå7At the psql prompt, create the Metacat user by typing:
îh]îh.)Åî}î(hå6At the psql prompt, create the Metacat user by typing:îh]îhå6At the psql prompt, create the Metacat user 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+j��hjc��hhhh,hM≥ubj1��)Åî}î(hhh]î(j¬��)Åî}î(hå2CREATE USER metacat WITH PASSWORD 'your_password';îh]îhå2CREATE USER metacat WITH PASSWORD 'your_password';îÖîÅî}î(hhhjD��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM∑hjA��ubh.)Åî}î(håOwhere 'your_password' is whatever password you would like for the Metacat user.îh]îhåSwhere ‚Äòyour_password‚Äô is whatever password you would like for the Metacat user.îÖîÅî}î(hjT��hjR��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMπhjA��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(håExit PostgreSQL by typing
îh]îh.)Åî}î(håExit PostgreSQL by typingîh]îhåExit PostgreSQL by typingîÖîÅî}î(hjo��hjm��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMªhji��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjf��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjc��hhhh,hMªubj1��)Åî}î(hhh]îj¬��)Åî}î(hå\qîh]îhå\qîÖîÅî}î(hhhjä��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMøhjá��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(hå5Restart the PostgreSQL database to bring in changes:
îh]îh.)Åî}î(hå4Restart the PostgreSQL database to bring in changes:îh]îhå4Restart the PostgreSQL database to bring in changes:îÖîÅî}î(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+j��hjc��hhhh,hM¡ubj1��)Åî}î(hhh]îj¬��)Åî}î(hå"/etc/init.d/postgresql-8.4 restartîh]îhå"/etc/init.d/postgresql-8.4 restartîÖîÅî}î(hhhj¬��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM≈hjø��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(hå0Log out of the postgres user account by typing:
îh]îh.)Åî}î(hå/Log out of the postgres user account by typing:îh]îhå/Log out of the postgres user account by typing:îÖîÅî}î(hjfl��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Ì��K	uh+j��hjc��hhhh,hM«ubj1��)Åî}î(hhh]îj¬��)Åî}î(hålogoutîh]îhålogoutîÖîÅî}î(hhhj˙��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMÀhj˜��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(hå5Test the installation and Metacat account by typing:
îh]îh.)Åî}î(hå4Test the installation and Metacat account by typing:îh]îhå4Test the installation and Metacat account 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Ì��K
uh+j��hjc��hhhh,hMÕubj1��)Åî}î(hhh]îj¬��)Åî}î(hå'psql -U metacat -W -h localhost metacatîh]îhå'psql -U metacat -W -h localhost metacatîÖîÅî}î(hhhj2��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM—hj/��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(håLog out of postgreSQL:
îh]îh.)Åî}î(håLog out of postgreSQL:îh]îhåLog out of postgreSQL:îÖîÅî}î(hjO��hjM��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM”hjI��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjF��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjc��hhhh,hM”ubj1��)Åî}î(hhh]îj¬��)Åî}î(hå\qîh]îhå\qîÖîÅî}î(hhhjj��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM◊hjg��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjc��hhhh,hNubh.)Åî}î(håüThe Metacat servlet automatically creates the required database schema. For
more information about configuring the database, please see Database
Configuration.îh]îhåüThe Metacat servlet automatically creates the required database schema. For
more information about configuring the database, please see Database
Configuration.îÖîÅî}î(hjÄ��hj~��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM⁄hjc��hhubeh}î(h]îj��ah!]îh#]îåpostgresql databaseîah%]îh']îuh+h	hjæ��hhhh,hMubh
)Åî}î(hhh]î(h)Åî}î(hj+��h]îhåSolr ServerîÖîÅî}î(hj+��hjñ��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)j.��uh+hhjì��hhhh,hMflubh.)Åî}î(hXZ��From version 2.13.0, Metacat uses the external Solr HTTP server as the
search engine. Unfortunately the Solr Debian packages that come with the Ubuntu operating
system are obsoleted and you have to install the binary packages by yourself. This section
provides guidance on how to setup Solr to run in production on *nix platforms, such as Ubuntu.îh]î(hX;��From version 2.13.0, Metacat uses the external Solr HTTP server as the
search engine. Unfortunately the Solr Debian packages that come with the Ubuntu operating
system are obsoleted and you have to install the binary packages by yourself. This section
provides guidance on how to setup Solr to run in production on îÖîÅî}î(hX;��From version 2.13.0, Metacat uses the external Solr HTTP server as the
search engine. Unfortunately the Solr Debian packages that come with the Ubuntu operating
system are obsoleted and you have to install the binary packages by yourself. This section
provides guidance on how to setup Solr to run in production on îhj£��hhhNhNubh�åproblematicîìî)Åî}î(hjö��h]îhå*îÖîÅî}î(hhhjÆ��ubah}î(h]îåid4îah!]îh#]îh%]îh']îårefidîåid3îuh+j¨��hj£��ubhånix platforms, such as Ubuntu.îÖîÅî}î(hånix platforms, such as Ubuntu.îhj£��hhhNhNubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM‡hjì��hhubh.)Åî}î(hå[Metacat only supports ``Solr 8.*``, ``NOT 9.*``. You may download the binary releases from:îh]î(håMetacat only supports îÖîÅî}î(håMetacat only supports îhj…��hhhNhNubj��)Åî}î(hå``Solr 8.*``îh]îhåSolr 8.*îÖîÅî}î(hhhj“��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj…��ubhå, îÖîÅî}î(hå, îhj…��hhhNhNubj��)Åî}î(hå``NOT 9.*``îh]îhåNOT 9.*îÖîÅî}î(hhhjÂ��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj…��ubhå,. You may download the binary releases from:îÖîÅî}î(hå,. You may download the binary releases from:îhj…��hhhNhNubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMÂhjì��hhubh.)Åî}î(hå0https://solr.apache.org/downloads.html#solr-8112îh]îh^)Åî}î(hj���h]îhå0https://solr.apache.org/downloads.html#solr-8112îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îårefuriîj���uh+h]hj˛��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMÁhjì��hhubj��)Åî}î(hhh]îhV)Åî}î(håüGo to the directory which contains the Solr release file and extract the installation script file by typing (assuming the downloaded file is solr-8.11.2.tgz):
îh]îh.)Åî}î(håûGo to the directory which contains the Solr release file and extract the installation script file by typing (assuming the downloaded file is solr-8.11.2.tgz):îh]îhåûGo to the directory which contains the Solr release file and extract the installation script file by typing (assuming the downloaded file is solr-8.11.2.tgz):îÖîÅî}î(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¶��uh+j��hjì��hhhh,hMÈubj¬��)Åî}î(håTtar xzf solr-8.11.2.tgz solr-8.11.2/bin/install_solr_service.sh --strip-components=2îh]îhåTtar xzf solr-8.11.2.tgz solr-8.11.2/bin/install_solr_service.sh --strip-components=2îÖîÅî}î(hhhj7��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMÌhjì��hhhh,ubj��)Åî}î(hhh]îhV)Åî}î(håInstall Solr as the root user:
îh]îh.)Åî}î(håInstall Solr as the root user:îh]îhåInstall Solr as the root user:îÖîÅî}î(hjN��hjL��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMÔhjH��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjE��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjì��hhhh,hMÔubj¬��)Åî}î(hå3sudo bash ./install_solr_service.sh solr-8.11.2.tgzîh]îhå3sudo bash ./install_solr_service.sh solr-8.11.2.tgzîÖîÅî}î(hhhjf��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMÛhjì��hhhh,ubh.)Åî}î(håXIf you upgrade Solr from an old 8.* version to 8.11.2, you may run this command instead:îh]îhåXIf you upgrade Solr from an old 8.* version to 8.11.2, you may run this command instead:îÖîÅî}î(hjv��hjt��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMıhjì��hhubj¬��)Åî}î(hå6sudo bash ./install_solr_service.sh solr-8.11.2.tgz -fîh]îhå6sudo bash ./install_solr_service.sh solr-8.11.2.tgz -fîÖîÅî}î(hhhjÇ��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM˘hjì��hhhh,ubj��)Åî}î(hhh]îhV)Åî}î(hå1Ensure the Solr defaults file is group writable:
îh]îh.)Åî}î(hå0Ensure the Solr defaults file is group writable:îh]îhå0Ensure the Solr defaults file is group writable:îÖîÅî}î(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+j��hjì��hhhh,hM˚ubj¬��)Åî}î(hå&sudo chmod g+w /etc/default/solr.in.shîh]îhå&sudo chmod g+w /etc/default/solr.in.shîÖîÅî}î(hhhj±��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMˇhjì��hhhh,ubj��)Åî}î(hhh]îhV)Åî}î(hå&Check if the Solr service is running:
îh]îh.)Åî}î(hå%Check if the Solr service is running:îh]îhå%Check if the Solr service is running:îÖîÅî}î(hj»��hj∆��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMhj¬��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjø��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjì��hhhh,hMubj¬��)Åî}î(håsudo service solr statusîh]îhåsudo service solr statusîÖîÅî}î(hhhj‡��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMhjì��hhhh,ubj��)Åî}î(hhh]îhV)Åî}î(håqMake sure the firewall is running and the default port 8983 isn't exposed externally (assume you are using ufw):
îh]îh.)Åî}î(håpMake sure the firewall is running and the default port 8983 isn't exposed externally (assume you are using ufw):îh]îhårMake sure the firewall is running and the default port 8983 isn‚Äôt exposed externally (assume you are using ufw):îÖîÅî}î(hj˜��hjı��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMhjÒ��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjÓ��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjì��hhhh,hMubj¬��)Åî}î(håsudo ufw statusîh]îhåsudo ufw statusîÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMhjì��hhhh,ubj��)Åî}î(hhh]îhV)Åî}î(håAdd New Allowed Solr Paths
îh]îh.)Åî}î(håAdd New Allowed Solr Pathsîh]îhåAdd New Allowed Solr PathsîÖîÅî}î(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+j��hjì��hhhh,hM
ubh.)Åî}î(håÇAdd a new line for the ``SOLR_OPTS`` variable in the environment specific include file (e.g. ``/etc/default/solr.in.sh``) such as:îh]î(håAdd a new line for the îÖîÅî}î(håAdd a new line for the îhj>��hhhNhNubj��)Åî}î(hå
``SOLR_OPTS``îh]îhå	SOLR_OPTSîÖîÅî}î(hhhjG��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îÖîÅî}î(hhhjZ��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_OPTS="$SOLR_OPTS -Dsolr.allowPaths=*"îh]îhå*SOLR_OPTS="$SOLR_OPTS -Dsolr.allowPaths=*"îÖîÅî}î(hhhjs��ubah}î(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+hUhjÅ��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjì��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.)Åî}î(hXJ��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 ``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+j��hjì��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.îÖîÅî}î(hj��hj��hhhNhNubah}î(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îÖîÅî}î(hhhjQ��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj"��ubhå	 user to îÖîÅî}î(hå	 user to îhj"��hhhNhNubj��)Åî}î(hå``tomcat8``îh]îhåtomcat8îÖîÅî}î(hhhjd��ubah}î(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îÖîÅî}î(hhhjù��ubah}î(h]îh!]îånote2îah#]îh%]îh']îuh+jõ��hjí��ubhå)îÖîÅî}î(hje��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Ì��K	uh+j��hjì��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+j��hjì��hhhh,hM3ubj¬��)Åî}î(hå$sudo groups tomcat8
sudo groups solrîh]îhå$sudo groups tomcat8
sudo groups solrîÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM7hjì��hhhh,ubh.)Åî}î(hX��Note: 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]îhX��Note: 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îÖîÅî}î(hhhj4��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM@hjì��hhhh,ubeh}î(h]îj4��ah!]îh#]îåsolr serverîah%]îh']îuh+h	hjæ��hhhh,hMflj��Kubh
)Åî}î(hhh]î(h)Åî}î(hjN��h]îhå$Apache Ant (if building from Source)îÖîÅî}î(hjN��hjL��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)jQ��uh+hhjI��hhhh,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[��hjY��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMEhjI��hhubh.)Åî}î(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:îhjg��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMMhjI��hhubj¬��)Åî}î(håsudo apt-get install antîh]îhåsudo apt-get install antîÖîÅî}î(hhhjv��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMOhjI��hhhh,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îÖîÅî}î(hhhjç��ubah}î(h]îh!]îh#]îh%]îh']îånameîå
Apache Antîj˘��j��uh+h]hjÑ��j˚��Kubhå
 homepage.îÖîÅî}î(hå
 homepage.îhjÑ��hhhNhNubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMQhjI��hhubh.)Åî}î(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,hMShjI��hhubeh}î(h]îjW��ah!]î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)Åî}î(hjù��h]îhåNew InstallîÖîÅî}î(hjù��hjÂ��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:îÖîÅî}î(hj��hj���hhhNhNubah}î(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:îÖîÅî}î(hj��hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMehj��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��uh+j��hj‚��hhhh,hMeubj1��)Åî}î(hhh]îj¬��)Åî}î(håsudo mkdir /var/metacatîh]îhåsudo mkdir /var/metacatîÖîÅî}î(hhhj2��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMihj/��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hj‚��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):îÖîÅî}î(hjO��hjM��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMkhjI��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjF��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj‚��hhhh,hMkubj1��)Åî}î(hhh]îj¬��)Åî}î(hå(sudo chown -R <tomcat_user> /var/metacatîh]îhå(sudo chown -R <tomcat_user> /var/metacatîÖîÅî}î(hhhjj��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMohjg��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hj‚��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 <tomcat_home>/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 <tomcat_app_dir>.  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 <tomcat_home>/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 <tomcat_app_dir>.  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]î(hXU��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 <tomcat_home>/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 <tomcat_app_dir>.  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., îÖîÅî}î(hXU��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 <tomcat_home>/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 <tomcat_app_dir>.  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îjê��uh+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,hMrhjÅ��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhj~��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hj‚��hhhh,hMrubj1��)Åî}î(hhh]îj¬��)Åî}î(hå∏sudo cp <metacat_package_dir>/metacat.war <tomcat_app_dir>
sudo cp <metacat_package_dir>/metacat-index.war <tomcat_app_dir>
sudo cp <metacat_package_dir>/metacatui.war <tomcat_app_dir>îh]îhå∏sudo cp <metacat_package_dir>/metacat.war <tomcat_app_dir>
sudo cp <metacat_package_dir>/metacat-index.war <tomcat_app_dir>
sudo cp <metacat_package_dir>/metacatui.war <tomcat_app_dir>îÖîÅî}î(hhhj∑��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMvhj¥��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hj‚��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+j��hj‚��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+j0��hj‚��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 îhj��hhhNhNubh^)Åî}î(hå"http://yourserver.com/yourcontext/îh]îhå"http://yourserver.com/yourcontext/îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îårefuriîj��uh+h]hj��ubhå (e.g.,
îÖîÅî}î(hå (e.g.,
îhj��hhhNhNubh^)Åî}î(hå!http://knb.ecoinformatics.org/knbîh]îhå!http://knb.ecoinformatics.org/knbîÖîÅî}î(hhhj ��ubah}î(h]îh!]îh#]îh%]îh']îårefuriîj"��uh+h]hj��ubhå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.îhj��hhhNhNubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMÅhj‚��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ö��jL��suh+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.îÖîÅî}î(hjS��hjQ��ubah}î(h]îh!]îh#]îh%]îh']îuh+jO��hh,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¿��hjr��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)j√��uh+hhjo��hhhh,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:îÖîÅî}î(hjÅ��hj��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMèhjo��hhubj��)Åî}î(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ìhjê��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjç��hhhh,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+hUhjç��hhhh,hNubeh}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��uh+j��hjo��hhhh,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+j0��hjo��hhhh,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 (<backup_dir>) 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 (<backup_dir>) 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 (<backup_dir>) 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+j��hjo��hhhh,hMõubj1��)Åî}î(hhh]î(j¬��)Åî}î(håycp <web_app_dir>/metacat <backup_dir>/metacat.<yyyymmdd>
cp <web_app_dir>/metacat.war <backup_dir>/metacat.war.<yyyymmdd>îh]îhåycp <web_app_dir>/metacat <backup_dir>/metacat.<yyyymmdd>
cp <web_app_dir>/metacat.war <backup_dir>/metacat.war.<yyyymmdd>îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMühj˛��ubh.)Åî}î(håzWarning: Do not backup the files to the ``<web_app_dir>`` 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 îhj��ubj��)Åî}î(hå``<web_app_dir>``îh]îhå
<web_app_dir>îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj��ubhå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.îhj��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM¢hj˛��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j0��hjo��hhhh,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+hUhj7��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��jÌ��Kuh+j��hjo��hhhh,hM•ubj1��)Åî}î(hhh]î(j¬��)Åî}î(hå:sudo cp <metacat_package_dir>/metacat.war <tomcat_app_dir>îh]îhå:sudo cp <metacat_package_dir>/metacat.war <tomcat_app_dir>îÖîÅî}î(hhhj[��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM©hjX��ubh.)Åî}î(håøNote: Typically, Tomcat will look for its application files (WAR files) in the
``<tomcat_home>/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
îhji��ubj��)Åî}î(hå``<tomcat_home>/webapps``îh]îhå<tomcat_home>/webappsîÖîÅî}î(hhhjr��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hji��ubhå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.îhji��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM´hjX��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j0��hjo��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(håfiIf 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+j��hjo��hhhh,hMØubj1��)Åî}î(hhh]îj¬��)Åî}î(hå<sudo cp <metacat_package_dir>/authority.war <tomcat_app_dir>îh]îhå<sudo cp <metacat_package_dir>/authority.war <tomcat_app_dir>îÖîÅî}î(hhhjµ��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM≥hj≤��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjo��hhhh,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+j��hjo��hhhh,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+j0��hjo��hhhh,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:îÖîÅî}î(hj��hj��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMºhjo��hhubj1��)Åî}î(hhh]îj¬��)Åî}î(hå-http://yourserver.yourdomain.com/yourcontext/îh]îhå-http://yourserver.yourdomain.com/yourcontext/îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hM¡hj��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjo��hhhh,hNubh.)Åî}î(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
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îj1��uh+h]hj&��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM√hjo��hhubeh}î(h]îj…��ah!]îh#]îåupgrade metacatîah%]îh']îuh+h	hjƒ��hhhh,hMéubh
)Åî}î(hhh]î(h)Åî}î(hj„��h]îhåSource Install and UpgradeîÖîÅî}î(hj„��hjN��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)jÊ��uh+hhjK��hhhh,hMÀubh.)Åî}î(håfiWhether 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åfiWhether 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ÃhjK��hhubh.)Åî}î(håTo install Metacat from source:îh]îhåTo install Metacat from source:îÖîÅî}î(hjk��hji��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM–hjK��hhubj��)Åî}î(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 ``<metacat_src_dir>``.
î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 ``<metacat_src_dir>``.î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å``<metacat_src_dir>``îh]îhå<metacat_src_dir>îÖîÅî}î(hhhjá��ubah}î(h]îh!]îh#]îh%]îh']îuh+j~��hj~��ubhå.îÖîÅî}î(hj¶��hj~��ubeh}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hM“hjz��ubah}î(h]îh!]îh#]îh%]îh']îuh+hUhjw��hhhh,hNubah}î(h]îh!]îh#]îh%]îh']îj¢��j£��j§��hj•��j¶��uh+j��hjK��hhhh,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+j0��hjK��hhhNhNubj��)Åî}î(hhh]îhV)Åî}î(hå#In the ``<metacat_src_dir>``, run:
îh]îh.)Åî}î(hå"In the ``<metacat_src_dir>``, run:îh]î(håIn the îÖîÅî}î(håIn the îhjÙ��ubj��)Åî}î(hå``<metacat_src_dir>``îh]îhå<metacat_src_dir>îÖîÅî}î(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+j��hjK��hhhh,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.îÖîÅî}î(hj5��hj3��ubah}î(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.îÖîÅî}î(hjC��hjA��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMÂhj"��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j0��hjK��hhhh,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:îhjU��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMËhjK��hhubj¬��)Åî}î(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/)îÖîÅî}î(hhhjd��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMÍhjK��hhhh,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.îÖîÅî}î(hjt��hjr��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMÌhjK��hhubeh}î(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)Åî}î(hj��h]îhå+Optional Installation Options (LSID Server)îÖîÅî}î(hj��hjë��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)j��uh+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îÖîÅî}î(hhhj≠��ubah}î(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,j��Kubh.)Åî}î(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:<Authority>:<Namespace>:<ObjectID>[:<Version>]
e.g., urn:lsid:ecoinformatics.org:tao:12039:1îh]îhåeurn:lsid:<Authority>:<Namespace>:<ObjectID>[:<Version>]
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]î(hX7��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:
îÖîÅî}î(hX7��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:
î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.)Åî}î(hXY��Notice 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]îhXY��Notice 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)Åî}î(hj2��h]îhå:Install and configure the LSID Server shipped with MetacatîÖîÅî}î(hj2��hjl ��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)j5��uh+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+j��hji ��hhhh,hM3ubj1��)Åî}î(hhh]îj¬��)Åî}î(håLsudo cp <metacat_package_directory>/authority.war /usr/share/tomcat7/webappsîh]îhåLsudo cp <metacat_package_directory>/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+j0��hji ��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 <metacat_helper_dir>/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 <metacat_helper_dir>/authority /etc/apache2/sites-available
sudo a2ensite authorityîh]îhå[sudo cp <metacat_helper_dir>/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+j��hji ��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+j0��hji ��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+j��hji ��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)Åî}î(hjU��h]îhå(To install the LSID server from a sourceîÖîÅî}î(hjU��hjn!��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îh)jX��uh+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+j��hjk!��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+j0��hjk!��hhhh,hNubj��)Åî}î(hhh]îhV)Åî}î(håCIn the <metacat-src-dirctory> create the authority.war by running:
îh]îh.)Åî}î(håBIn the <metacat-src-dirctory> create the authority.war by running:îh]îhåBIn the <metacat-src-dirctory> 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+j��hjk!��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+j0��hjk!��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+j��hjk!��hhhh,hMcubj1��)Åî}î(hhh]îj¬��)Åî}î(håAsudo cp <metacat_package_dir>/dist/authority.war <tomcat_app_dir>îh]îhåAsudo cp <metacat_package_dir>/dist/authority.war <tomcat_app_dir>îÖîÅî}î(hhhj"��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMghj"��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hjk!��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+j��hjk!��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+j0��hjk!��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+j��hjk!��hhhh,hMpubj1��)Åî}î(hhh]î(j¬��)Åî}î(håcsudo cp <metacat_helper_dir>/authority <apache_install_dir>/sites-available
sudo a2ensite authorityîh]îhåcsudo cp <metacat_helper_dir>/authority <apache_install_dir>/sites-available
sudo a2ensite authorityîÖîÅî}î(hhhj"��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMvhj|"��ubh.)Åî}î(håIWhere <metacat_helper_dir> can be found in <metacat_code_dir>/src/scriptsîh]îhåIWhere <metacat_helper_dir> can be found in <metacat_code_dir>/src/scriptsîÖîÅî}î(hjè"��hjç"��ubah}î(h]îh!]îh#]îh%]îh']îuh+h-hh,hMyhj|"��ubeh}î(h]îh!]îh#]îh%]îh']îuh+j0��hjk!��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+j��hjk!��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,hMÅhj¬"��ubj1��)Åî}î(hhh]îj¬��)Åî}î(håF_lsid._tcp      IN      SRV     1       0       8080    <metacat.edu>.îh]îhåF_lsid._tcp      IN      SRV     1       0       8080    <metacat.edu>.îÖîÅî}î(hhhj‰"��ubah}î(h]îh!]îh#]îh%]îh']îj—��j“��uh+j¡��hMáhj·"��ubah}î(h]îh!]îh#]îh%]îh']îuh+j0��hj¬"��ubh.)Åî}î(håpWhere <metacat.edu> is the name of the machine that will serve as the
physical location of the AuthorityService.îh]îhåpWhere <metacat.edu> 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 <metacat.edu> for the below example URL would be
example.com:îh]îhåWFor example, the value of <metacat.edu> 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+j0��hj¬"��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+j0��hjk!��hhhh,hNubeh}î(h]îj^��ah!]îh#]îå(to install the lsid server from a sourceîah%]îh']îuh+h	hjé��hhhh,hMRubeh}î(h]îj��ah!]î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]îjç��ah!]î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È��ji��j=��jR
��j|��jë��eå
apache antî]î(j��jz
��jç��eå
apache tomcatî]î(j8��j(��j
��j��eåapache httpd serverî]î(j\��jQ��j*
��eåjava 8î]î(j®��j��jÊ��eå
solr 8.8.2î]îj“��aåmetacat download pageî]î(j¬��jb��j_��eåsolr serverî]îj£
��aåubuntuî]î(j��jE��j—��jö��jº��eåoracleî]îjZ��aådoiî]î(j≠��jÚ��euårefidsî}îånameidsî}î(j¢#��hmjæ��j∫��j√��hçjˇ��j¸��j��j	��j��j��j%��j"��j1��j.��j=��j:��jI��jF��jõ#��h∞j∑��h–j∞��j≠��jª��hÛj/��j��j���j6��j¥��jY��j¡��jà��j~��j{��j`��jÓ��jê��j��jF��j4��j∫��jW��jã��jÜ��jl��j¶��jH��j…��jÑ��jÏ��jZ#��j��jÿ��j’��jh!��j;��jS#��j^��jî#��jç��uå	nametypesî}î(j¢#��Njæ��Nj√��Njˇ��àj��àj��àj%��àj1��àj=��àjI��àjõ#��Nj∑��Nj∞��àjª��Nj/��Nj���Nj¥��Nj¡��Nj~��àj`��Njê��NjF��Nj∫��Njã��Njl��NjH��NjÑ��NjZ#��Njÿ��àjh!��NjS#��Njî#��Nuh}î(hmhj∫��h?hçj¡��j¸��jˆ��j	��j��j��j��j"��j��j.��j(��j:��j4��jF��j@��h∞j∆��h–j‰��j≠��jß��hÛj∫��j��j5��j6��j2��jY��j��jà��jæ��j®��jƒ
��j{��ju��jÀ��jà��jÓ��j√��j��jc��j4��jì��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Æ��jW��jI��jÜ��jƒ��j¶��j‚��j…��jo��jÏ��jK��j��jé��j’��jœ��j;��ji ��j^��jk!��jç��j]#��ja��j<��h*h_háh}h™h†h h¿hÌh„j
��j��j0��j&��jS��jI��jÇ��jx��j¢��jò��j≈��jª��jË��jfi��j��j��j.��j$��jQ��jG��jÄ��jv��j†��jñ��j√��jπ��jÊ��j‹��j��j��j5��j+��jX��jN��já��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$��hj5��hhhh,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$��hj2��hhhh,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$��hj��hhhh,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)îÖîÅî}î(hhhjfi%��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$��hjc��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)îÖîÅî}î(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$��hjc��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)îÖîÅî}î(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$��hjc��hhhh,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$��hjc��hhhh,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$��hjc��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$��hjc��hhhh,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$��hjc��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$��hjc��hhhh,hM«ubj $��)Åî}î(hhh]îh.)Åî}î(hå<Enumerated list start value not ordinal-1: "10" (ordinal 10)îh]îhå@Enumerated list start value not ordinal-1: ‚Äú10‚Äù (ordinal 10)îÖîÅî}î(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$��hjc��hhhh,hMÕubj $��)Åî}î(hhh]îh.)Åî}î(hå<Enumerated list start value not ordinal-1: "11" (ordinal 11)îh]îhå@Enumerated list start value not ordinal-1: ‚Äú11‚Äù (ordinal 11)îÖîÅî}î(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$��hjc��hhhh,hM”ubj!$��j $��)Åî}î(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)îÖîÅî}î(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)îÖîÅî}î(hhhjfl'��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: "10" (ordinal 10)îh]îhå@Enumerated list start value not ordinal-1: ‚Äú10‚Äù (ordinal 10)îÖîÅî}î(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,hM3ubj $��)Åî}î(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)îÖîÅî}î(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$��hjo��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)îÖîÅî}î(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$��hjo��hhhh,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$��hjo��hhhh,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$��hjo��hhhh,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$��hjK��hhhh,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.