ÄïC������ådocutils.nodesîådocumentîìî)Åî}î(å	rawsourceîå�îåchildrenî]î(h�åtargetîìî)Åî}î(hå6.. _Solr installation page: ./install.html#solr-serverîh]îå
attributesî}î(åidsî]îåsolr-installation-pageîaåclassesî]îånamesî]îåsolr installation pageîaådupnamesî]îåbackrefsî]îårefuriîå./install.html#solr-serverîuåtagnameîh	ålineîKåparentîhhhåsourceîå_/var/lib/jenkins/jobs/metacat_beta/workspace/metacat/docs/user/metacat/source/configuration.rstîå
referencedîKubh�åsectionîìî)Åî}î(hhh]î(h�åtitleîìî)Åî}î(håConfiguring Metacatîh]îh�åTextîìîåConfiguring MetacatîÖîÅî}î(hh.h!h,hhh"Nh Nubah}î(h]îh]îh]îh]îh]îårefidîåid15îuhh*h!h'hhh"h#h Kubh�åtopicîìî)Åî}î(hhh]î(h+)Åî}î(håContentsîh]îh1åContentsîÖîÅî}î(hhh!hCubah}î(h]îh]îh]îh]îh]îuhh*h!h@ubh�åbullet_listîìî)Åî}î(hhh]îh�å	list_itemîìî)Åî}î(hhh]î(h�å	paragraphîìî)Åî}î(hhh]îh�å	referenceîìî)Åî}î(hhh]îh1åConfiguring MetacatîÖîÅî}î(hh.h!hbubah}î(h]îh=ah]îh]îh]îh]îårefidîåconfiguring-metacatîuhh`h!h]ubah}î(h]îh]îh]îh]îh]îuhh[h!hXubhR)Åî}î(hhh]î(hW)Åî}î(hhh]î(h\)Åî}î(hhh]îha)Åî}î(hhh]îh1åInitial ConfigurationîÖîÅî}î(håInitial Configurationîh!hÄubah}î(h]îåid16îah]îh]îh]îh]îårefidîåinitial-configurationîuhh`h!h}ubah}î(h]îh]îh]îh]îh]îuhh[h!hzubhR)Åî}î(hhh]î(hW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åBack-up ConfigurationîÖîÅî}î(håBack-up Configurationîh!h†ubah}î(h]îåid17îah]îh]îh]îh]îårefidîåback-up-configurationîuhh`h!hùubah}î(h]îh]îh]îh]îh]îuhh[h!höubah}î(h]îh]îh]îh]îh]îuhhVh!hóubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åAuthentication ConfigurationîÖîÅî}î(håAuthentication Configurationîh!h√ubah}î(h]îåid18îah]îh]îh]îh]îårefidîåauthentication-configurationîuhh`h!h¿ubah}î(h]îh]îh]îh]îh]îuhh[h!hΩubah}î(h]îh]îh]îh]îh]îuhhVh!hóubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1å<Changing Authentication Configuration without AuthenticationîÖîÅî}î(hå<Changing Authentication Configuration without Authenticationîh!hÊubah}î(h]îåid19îah]îh]îh]îh]îårefidîå<changing-authentication-configuration-without-authenticationîuhh`h!h„ubah}î(h]îh]îh]îh]îh]îuhh[h!h‡ubah}î(h]îh]îh]îh]îh]îuhhVh!hóubeh}î(h]îh]îh]îh]îh]îuhhQh!hzubeh}î(h]îh]îh]îh]îh]îuhhVh!hwubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åLogging in to MetacatîÖîÅî}î(håLogging in to Metacatîh!j��ubah}î(h]îåid20îah]îh]îh]îh]îårefidîålogging-in-to-metacatîuhh`h!j��ubah}î(h]îh]îh]îh]îh]îuhh[h!j��ubah}î(h]îh]îh]îh]îh]îuhhVh!hwubhW)Åî}î(hhh]î(h\)Åî}î(hhh]îha)Åî}î(hhh]îh1åRequired ConfigurationîÖîÅî}î(håRequired Configurationîh!j8��ubah}î(h]îåid21îah]îh]îh]îh]îårefidîårequired-configurationîuhh`h!j5��ubah}î(h]îh]îh]îh]îh]îuhh[h!j2��ubhR)Åî}î(hhh]î(hW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1å&Global Properties (server, ports, etc)îÖîÅî}î(hå&Global Properties (server, ports, etc)îh!jX��ubah}î(h]îåid22îah]îh]îh]îh]îårefidîå"global-properties-server-ports-etcîuhh`h!jU��ubah}î(h]îh]îh]îh]îh]îuhh[h!jR��ubah}î(h]îh]îh]îh]îh]îuhhVh!jO��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åAuthentication ConfigurationîÖîÅî}î(håAuthentication Configurationîh!j{��ubah}î(h]îåid23îah]îh]îh]îh]îårefidîåid1îuhh`h!jx��ubah}î(h]îh]îh]îh]îh]îuhh[h!ju��ubah}î(h]îh]îh]îh]îh]îuhhVh!jO��ubhW)Åî}î(hhh]î(h\)Åî}î(hhh]îha)Åî}î(hhh]îh1åSkins ConfigurationîÖîÅî}î(håSkins Configurationîh!jû��ubah}î(h]îåid24îah]îh]îh]îh]îårefidîåskins-configurationîuhh`h!jõ��ubah}î(h]îh]îh]îh]îh]îuhh[h!jò��ubhR)Åî}î(hhh]î(hW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åMetacatUI ThemesîÖîÅî}î(håMetacatUI Themesîh!jæ��ubah}î(h]îåid25îah]îh]îh]îh]îårefidîåmetacatui-themesîuhh`h!jª��ubah}î(h]îh]îh]îh]îh]îuhh[h!j∏��ubah}î(h]îh]îh]îh]îh]îuhhVh!jµ��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åSkinsîÖîÅî}î(håSkinsîh!j·��ubah}î(h]îåid26îah]îh]îh]îh]îårefidîåskinsîuhh`h!jfi��ubah}î(h]îh]îh]îh]îh]îuhh[h!j€��ubah}î(h]îh]îh]îh]îh]îuhhVh!jµ��ubeh}î(h]îh]îh]îh]îh]îuhhQh!jò��ubeh}î(h]îh]îh]îh]îh]îuhhVh!jO��ubhW)Åî}î(hhh]î(h\)Åî}î(hhh]îha)Åî}î(hhh]îh1åDatabase ConfigurationîÖîÅî}î(håDatabase Configurationîh!j��ubah}î(h]îåid27îah]îh]îh]îh]îårefidîådatabase-configurationîuhh`h!j
��ubah}î(h]îh]îh]îh]îh]îuhh[h!j
��ubhR)Åî}î(hhh]î(hW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åNew InstallationîÖîÅî}î(håNew Installationîh!j0��ubah}î(h]îåid28îah]îh]îh]îh]îårefidîånew-installationîuhh`h!j-��ubah}î(h]îh]îh]îh]îh]îuhh[h!j*��ubah}î(h]îh]îh]îh]îh]îuhhVh!j'��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åUpgradeîÖîÅî}î(håUpgradeîh!jS��ubah}î(h]îåid29îah]îh]îh]îh]îårefidîåupgradeîuhh`h!jP��ubah}î(h]îh]îh]îh]îh]îuhh[h!jM��ubah}î(h]îh]îh]îh]îh]îuhhVh!j'��ubeh}î(h]îh]îh]îh]îh]îuhhQh!j
��ubeh}î(h]îh]îh]îh]îh]îuhhVh!jO��ubhW)Åî}î(hhh]î(h\)Åî}î(hhh]îha)Åî}î(hhh]îh1åSolr Server ConfigurationîÖîÅî}î(håSolr Server Configurationîh!jÇ��ubah}î(h]îåid30îah]îh]îh]îh]îårefidîåsolr-server-configurationîuhh`h!j��ubah}î(h]îh]îh]îh]îh]îuhh[h!j|��ubhR)Åî}î(hhh]îhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åTroubleshootingîÖîÅî}î(håTroubleshootingîh!j¢��ubah}î(h]îåid31îah]îh]îh]îh]îårefidîåtroubleshootingîuhh`h!jü��ubah}î(h]îh]îh]îh]îh]îuhh[h!jú��ubah}î(h]îh]îh]îh]îh]îuhhVh!jô��ubah}î(h]îh]îh]îh]îh]îuhhQh!j|��ubeh}î(h]îh]îh]îh]îh]îuhhVh!jO��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åGeoserver ConfigurationîÖîÅî}î(håGeoserver Configurationîh!j—��ubah}î(h]îåid32îah]îh]îh]îh]îårefidîågeoserver-configurationîuhh`h!jŒ��ubah}î(h]îh]îh]îh]îh]îuhh[h!jÀ��ubah}î(h]îh]îh]îh]îh]îuhhVh!jO��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åDataONE ConfigurationîÖîÅî}î(håDataONE Configurationîh!jÙ��ubah}î(h]îåid33îah]îh]îh]îh]îårefidîådataone-configurationîuhh`h!jÒ��ubah}î(h]îh]îh]îh]îh]îuhh[h!jÓ��ubah}î(h]îh]îh]îh]îh]îuhhVh!jO��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åReplication ConfigurationîÖîÅî}î(håReplication Configurationîh!j��ubah}î(h]îåid34îah]îh]îh]îh]îårefidîåreplication-configurationîuhh`h!j��ubah}î(h]îh]îh]îh]îh]îuhh[h!j��ubah}î(h]îh]îh]îh]îh]îuhhVh!jO��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1åEZID ConfigurationîÖîÅî}î(håEZID Configurationîh!j:��ubah}î(h]îåid35îah]îh]îh]îh]îårefidîåezid-configurationîuhh`h!j7��ubah}î(h]îh]îh]îh]îh]îuhh[h!j4��ubah}î(h]îh]îh]îh]îh]îuhhVh!jO��ubeh}î(h]îh]îh]îh]îh]îuhhQh!j2��ubeh}î(h]îh]îh]îh]îh]îuhhVh!hwubhW)Åî}î(hhh]î(h\)Åî}î(hhh]îha)Åî}î(hhh]îh1åAdditional ConfigurationîÖîÅî}î(håAdditional Configurationîh!ji��ubah}î(h]îåid36îah]îh]îh]îh]îårefidîåadditional-configurationîuhh`h!jf��ubah}î(h]îh]îh]îh]îh]îuhh[h!jc��ubhR)Åî}î(hhh]î(hW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]î(h1åThe îÖîÅî}î(håThe îh!jâ��ubh�åliteralîìî)Åî}î(hå``metacat.properties``îh]îh1åmetacat.propertiesîÖîÅî}î(hhh!jì��ubah}î(h]îh]îh]îh]îh]îuhjë��h"Nh Nh!jâ��ubh1å fileîÖîÅî}î(hå fileîh!jâ��ubeh}î(h]îåid37îah]îh]îh]îh]îårefidîåthe-metacat-properties-fileîuhh`h!jÜ��ubah}î(h]îh]îh]îh]îh]îuhh[h!jÉ��ubah}î(h]îh]îh]îh]îh]îuhhVh!jÄ��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1å<SKIN_NAME>.propertiesîÖîÅî}î(hå<SKIN_NAME>.propertiesîh!j¡��ubah}î(h]îåid38îah]îh]îh]îh]îårefidîåskin-name-propertiesîuhh`h!jæ��ubah}î(h]îh]îh]îh]îh]îuhh[h!jª��ubah}î(h]îh]îh]îh]îh]îuhhVh!jÄ��ubhW)Åî}î(hhh]îh\)Åî}î(hhh]îha)Åî}î(hhh]îh1å%Additional configuration for Tomcat 7îÖîÅî}î(hå%Additional configuration for Tomcat 7îh!j‰��ubah}î(h]îåid39îah]îh]îh]îh]îårefidîå%additional-configuration-for-tomcat-7îuhh`h!j·��ubah}î(h]îh]îh]îh]îh]îuhh[h!jfi��ubah}î(h]îh]îh]îh]îh]îuhhVh!jÄ��ubeh}î(h]îh]îh]îh]îh]îuhhQh!jc��ubeh}î(h]îh]îh]îh]îh]îuhhVh!hwubeh}î(h]îh]îh]îh]îh]îuhhQh!hXubeh}î(h]îh]îh]îh]îh]îuhhVh!hSubah}î(h]îh]îh]îh]îh]îuhhQh!h@hhh"Nh Nubeh}î(h]îåcontentsîah]îåcontentsîah]îåcontentsîah]îh]îuhh>h"h#h Kh!h'hhubh\)Åî}î(hå†When Metacat (Tomcat) is started, the Metacat servlet checks to see if it is
configured. If not, Metacat will automatically send you to the configuration
pages.îh]îh1å†When Metacat (Tomcat) is started, the Metacat servlet checks to see if it is
configured. If not, Metacat will automatically send you to the configuration
pages.îÖîÅî}î(hj*��h!j(��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K	h!h'hhubh\)Åî}î(hX>��If the installation is new, or the previous version is before 1.9.0, pay close
attention to the configuration values. If you have upgraded Metacat, and the
previous version is 1.9.0 or later, Metacat will pull existing configuration
settings from a backup location. You should still verify that the values are
correct.îh]îh1X>��If the installation is new, or the previous version is before 1.9.0, pay close
attention to the configuration values. If you have upgraded Metacat, and the
previous version is 1.9.0 or later, Metacat will pull existing configuration
settings from a backup location. You should still verify that the values are
correct.îÖîÅî}î(hj8��h!j6��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K
h!h'hhubh\)Åî}î(hå5To access your Metacat, open a Web browser and type::îh]îh1å4To access your Metacat, open a Web browser and type:îÖîÅî}î(hå4To access your Metacat, open a Web browser and type:îh!jD��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kh!h'hhubh�å
literal_blockîìî)Åî}î(håhttp://<your_context_url>îh]îh1åhttp://<your_context_url>îÖîÅî}î(hhh!jU��ubah}î(h]îh]îh]îh]îh]îå	xml:spaceîåpreserveîuhjS��h Kh!h'hhh"h#ubh\)Åî}î(håˆWhere <your_context_url> is the URL of the server hosting the Metacat followed
by the name of the WAR file (i.e., the application context) that you installed.
For instance, the context URL for the KNB Metacat is: http://knb.ecoinformatics.org/knbîh]î(h1å’Where <your_context_url> is the URL of the server hosting the Metacat followed
by the name of the WAR file (i.e., the application context) that you installed.
For instance, the context URL for the KNB Metacat is: îÖîÅî}î(hå’Where <your_context_url> is the URL of the server hosting the Metacat followed
by the name of the WAR file (i.e., the application context) that you installed.
For instance, the context URL for the KNB Metacat is: îh!je��hhh"Nh Nubha)Åî}î(hå!http://knb.ecoinformatics.org/knbîh]îh1å!http://knb.ecoinformatics.org/knbîÖîÅî}î(hhh!jn��ubah}î(h]îh]îh]îh]îh]îårefuriîjp��uhh`h!je��ubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Kh!h'hhubh\)Åî}î(håLYou can always open the configuration screen from within Metacat by typing::îh]îh1åKYou can always open the configuration screen from within Metacat by typing:îÖîÅî}î(håKYou can always open the configuration screen from within Metacat by typing:îh!jÉ��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kh!h'hhubjT��)Åî}î(håhttp://<your_context_url>/adminîh]îh1åhttp://<your_context_url>/adminîÖîÅî}î(hhh!jí��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h Kh!h'hhh"h#ubh&)Åî}î(hhh]î(h+)Åî}î(hháh]îh1åInitial ConfigurationîÖîÅî}î(hháh!j£��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<häuhh*h!j†��hhh"h#h K ubh\)Åî}î(hXñ��Before you can log in to the Metacat and configure it, you are required to
confirm Metacat's back-up location and authentication configuration (if not
already configured). Metacat will automatically attempt to locate an existing
back-up directory, but you may need to correct the value or specify a directory
(if the installation is new, or if Metacat was unable to determine the location
of an existing back-up directory). The authentication configuration is required
for logging in to the Metacat and for defining administrative accounts.
Instructions for `Changing Authentication Configuration without Authentication`_
are included at the end of this section.îh]î(h1X0��Before you can log in to the Metacat and configure it, you are required to
confirm Metacat’s back-up location and authentication configuration (if not
already configured). Metacat will automatically attempt to locate an existing
back-up directory, but you may need to correct the value or specify a directory
(if the installation is new, or if Metacat was unable to determine the location
of an existing back-up directory). The authentication configuration is required
for logging in to the Metacat and for defining administrative accounts.
Instructions for îÖîÅî}î(hX.��Before you can log in to the Metacat and configure it, you are required to
confirm Metacat's back-up location and authentication configuration (if not
already configured). Metacat will automatically attempt to locate an existing
back-up directory, but you may need to correct the value or specify a directory
(if the installation is new, or if Metacat was unable to determine the location
of an existing back-up directory). The authentication configuration is required
for logging in to the Metacat and for defining administrative accounts.
Instructions for îh!j∞��hhh"Nh Nubha)Åî}î(hå?`Changing Authentication Configuration without Authentication`_îh]îh1å<Changing Authentication Configuration without AuthenticationîÖîÅî}î(hhh!jπ��ubah}î(h]îh]îh]îh]îh]îånameîå<Changing Authentication Configuration without Authenticationîh<hˆuhh`h!j∞��åresolvedîKubh1å)
are included at the end of this section.îÖîÅî}î(hå)
are included at the end of this section.îh!j∞��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h K!h!j†��hhubh&)Åî}î(hhh]î(h+)Åî}î(hhßh]îh1åBack-up ConfigurationîÖîÅî}î(hhßh!jÿ��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<h™uhh*h!j’��hhh"h#h K,ubh\)Åî}î(hXu��To preserve its configuration settings, Metacat backs up crucial configuration details to
a directory outside the application directories. Because a new installation/upgrade
does not know where this external directory is, Metacat uses a discovery
algorithm to locate it. If Metacat cannot identify a backup directory, you will
see the Backup Directory Configuration screen.îh]îh1Xu��To preserve its configuration settings, Metacat backs up crucial configuration details to
a directory outside the application directories. Because a new installation/upgrade
does not know where this external directory is, Metacat uses a discovery
algorithm to locate it. If Metacat cannot identify a backup directory, you will
see the Backup Directory Configuration screen.îÖîÅî}î(hjÁ��h!jÂ��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K-h!j’��hhubh�ånoteîìî)Åî}î(håπIf the metacat.properties file has many custom settings, it should be manually
backed up before any Metacat upgrade as deploying a new Metacat war file will overwrite
the existing file.îh]îh\)Åî}î(håπIf the metacat.properties file has many custom settings, it should be manually
backed up before any Metacat upgrade as deploying a new Metacat war file will overwrite
the existing file.îh]îh1åπIf the metacat.properties file has many custom settings, it should be manually
backed up before any Metacat upgrade as deploying a new Metacat war file will overwrite
the existing file.îÖîÅî}î(hj˚��h!j˘��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K5h!jı��ubah}î(h]îh]îh]îh]îh]îuhjÛ��h!j’��hhh"h#h Nubh�åfigureîìî)Åî}î(hhh]î(h�åimageîìî)Åî}î(håd.. figure:: images/screenshots/image011.png
   :align: center

   Configuring the Backup Directory.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image011.pngîå
candidatesî}îå*îj��suhj��h!j��h"h#h K<ubh�åcaptionîìî)Åî}î(hå!Configuring the Backup Directory.îh]îh1å!Configuring the Backup Directory.îÖîÅî}î(hj'��h!j%��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h K<h!j��ubeh}î(h]îåid2îah]îh]îh]îh]îåalignîåcenterîuhj
��h K<h!j’��hhh"h#ubeh}î(h]îh∞ah]îh]îåback-up configurationîah]îh]îuhh%h!j†��hhh"h#h K,ubh&)Åî}î(hhh]î(h+)Åî}î(hh h]îh1åAuthentication ConfigurationîÖîÅî}î(hh h!jF��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<hÕuhh*h!jC��hhh"h#h K?ubh\)Åî}î(hå·Whether you are installing or upgrading the Metacat servlet, you will
automatically be sent to the Authentication Configuration page. You can also
reach the Authentication Configuration page from a running Metacat by typing::îh]îh1å‡Whether you are installing or upgrading the Metacat servlet, you will
automatically be sent to the Authentication Configuration page. You can also
reach the Authentication Configuration page from a running Metacat by typing:îÖîÅî}î(hå‡Whether you are installing or upgrading the Metacat servlet, you will
automatically be sent to the Authentication Configuration page. You can also
reach the Authentication Configuration page from a running Metacat by typing:îh!jS��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K@h!jC��hhubjT��)Åî}î(håhttp://<your_context_url>/adminîh]îh1åhttp://<your_context_url>/adminîÖîÅî}î(hhh!jb��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h KDh!jC��hhh"h#ubh\)Åî}î(hX��Metacat uses either an internal password file or LDAP as its authentication mechanism.
You can choose the authentication mechanism by selecting either AuthFile or AuthLdap class.
We will only allow trusted partners to access the NCEAS LDAP server to ensure the security of our user base.
If you are not in the trusted partner list, you may choose the internal password file authentication
or set up your own LDAP server. You also can define your own authentication mechanism by creating a Java
class that implements ``AuthInterface``.îh]î(h1X��Metacat uses either an internal password file or LDAP as its authentication mechanism.
You can choose the authentication mechanism by selecting either AuthFile or AuthLdap class.
We will only allow trusted partners to access the NCEAS LDAP server to ensure the security of our user base.
If you are not in the trusted partner list, you may choose the internal password file authentication
or set up your own LDAP server. You also can define your own authentication mechanism by creating a Java
class that implements îÖîÅî}î(hX��Metacat uses either an internal password file or LDAP as its authentication mechanism.
You can choose the authentication mechanism by selecting either AuthFile or AuthLdap class.
We will only allow trusted partners to access the NCEAS LDAP server to ensure the security of our user base.
If you are not in the trusted partner list, you may choose the internal password file authentication
or set up your own LDAP server. You also can define your own authentication mechanism by creating a Java
class that implements îh!jp��hhh"Nh Nubjí��)Åî}î(hå``AuthInterface``îh]îh1å
AuthInterfaceîÖîÅî}î(hhh!jy��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jp��ubh1å.îÖîÅî}î(hå.îh!jp��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h KFh!jC��hhubh\)Åî}î(håGRequired configuration values for the password file authentication are:îh]îh1åGRequired configuration values for the password file authentication are:îÖîÅî}î(hjî��h!jí��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KMh!jC��hhubh�åblock_quoteîìî)Åî}î(hhh]îjT��)Åî}î(håTAuthentication Class
Metacat Administrators
Users Management URL
Password File Path.îh]îh1åTAuthentication Class
Metacat Administrators
Users Management URL
Password File Path.îÖîÅî}î(hhh!j•��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h KQh!j¢��ubah}î(h]îh]îh]îh]îh]îuhj†��h!jC��hhh"h#h Nubh\)Åî}î(hå:Required configuration values for LDAP authentication are:îh]îh1å:Required configuration values for LDAP authentication are:îÖîÅî}î(hjª��h!jπ��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KVh!jC��hhubj°��)Åî}î(hhh]îjT��)Åî}î(hånAuthentication Class
Metacat Administrators
Users Management URL
Authentication URL
Authentication Secure URL.îh]îh1ånAuthentication Class
Metacat Administrators
Users Management URL
Authentication URL
Authentication Secure URL.îÖîÅî}î(hhh!j ��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h KZh!j«��ubah}î(h]îh]îh]îh]îh]îuhj†��h!jC��hhh"h#h Nubh\)Åî}î(hX%��Make sure that your user account information is entered into the Metacat
Administrators field (e.g., uid=daigle,o=nceas,dc=ecoinformatics,dc=org). You
will not be allowed to continue with configuration if this is missing. Multiple
accounts can be entered, separated by the colon (:) character.îh]îh1X%��Make sure that your user account information is entered into the Metacat
Administrators field (e.g., uid=daigle,o=nceas,dc=ecoinformatics,dc=org). You
will not be allowed to continue with configuration if this is missing. Multiple
accounts can be entered, separated by the colon (:) character.îÖîÅî}î(hj‡��h!jfi��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kah!jC��hhubjÙ��)Åî}î(hX��To create an account on the password file, please see the section called :doc:`authinterface`.
To create an LDAP account on the KNB LDAP server (specified as the default LDAP server),
go to https://identity.nceas.ucsb.edu and select the "create a new user account" link.îh]îh\)Åî}î(hX��To create an account on the password file, please see the section called :doc:`authinterface`.
To create an LDAP account on the KNB LDAP server (specified as the default LDAP server),
go to https://identity.nceas.ucsb.edu and select the "create a new user account" link.îh]î(h1åITo create an account on the password file, please see the section called îÖîÅî}î(håITo create an account on the password file, please see the section called îh!j��ubåsphinx.addnodesîåpending_xrefîìî)Åî}î(hå:doc:`authinterface`îh]îh�åinlineîìî)Åî}î(hj˛��h]îh1å
authinterfaceîÖîÅî}î(hhh!j��ubah}î(h]îh]î(åxrefîåstdîåstd-docîeh]îh]îh]îuhj���h!j¸��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîj
��årefexplicitîâå	reftargetîå
authinterfaceîårefdocîå
configurationîårefwarnîàuhj˙��h"h#h Khh!j��ubh1åa.
To create an LDAP account on the KNB LDAP server (specified as the default LDAP server),
go to îÖîÅî}î(håa.
To create an LDAP account on the KNB LDAP server (specified as the default LDAP server),
go to îh!j��ubha)Åî}î(håhttps://identity.nceas.ucsb.eduîh]îh1åhttps://identity.nceas.ucsb.eduîÖîÅî}î(hhh!j&��ubah}î(h]îh]îh]îh]îh]îårefuriîj(��uhh`h!j��ubh1å5 and select the ‚Äúcreate a new user account‚Äù link.îÖîÅî}î(hå1 and select the "create a new user account" link.îh!j��ubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Khh!jÏ��ubah}î(h]îh]îh]îh]îh]îuhjÛ��h!jC��hhh"h#h Nubh\)Åî}î(hådIf you make changes to the authentication settings, you must restart Tomcat to
put them into effect.îh]îh1ådIf you make changes to the authentication settings, you must restart Tomcat to
put them into effect.îÖîÅî}î(hjH��h!jF��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Klh!jC��hhubj��)Åî}î(hhh]î(j��)Åî}î(hås.. figure:: images/screenshots/image071.png
   :align: center

   Configuring Password File Authentication Values.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image071.pngîj ��}îj"��jb��suhj��h!jT��h"h#h Krubj$��)Åî}î(hå0Configuring Password File Authentication Values.îh]îh1å0Configuring Password File Authentication Values.îÖîÅî}î(hjf��h!jd��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h Krh!jT��ubeh}î(h]îåid3îah]îh]îh]îh]îj:��åcenterîuhj
��h Krh!jC��hhh"h#ubj��)Åî}î(hhh]î(j��)Åî}î(håj.. figure:: images/screenshots/image009.png
   :align: center

   Configuring LDAP Authentication Values.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image009.pngîj ��}îj"��jà��suhj��h!jz��h"h#h Kwubj$��)Åî}î(hå'Configuring LDAP Authentication Values.îh]îh1å'Configuring LDAP Authentication Values.îÖîÅî}î(hjå��h!jä��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h Kwh!jz��ubeh}î(h]îåid4îah]îh]îh]îh]îj:��åcenterîuhj
��h Kwh!jC��hhh"h#ubeh}î(h]îh”ah]îh]îh]îåauthentication configurationîah]îuhh%h!j†��hhh"h#h K?h$Kubh&)Åî}î(hhh]î(h+)Åî}î(hhÌh]îh1å<Changing Authentication Configuration without AuthenticationîÖîÅî}î(hhÌh!j™��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<huhh*h!jß��hhh"h#h Kzubh\)Åî}î(hXø��If you need to change or add authentication information and cannot authenticate
using the existing authentication settings (e.g., the existing Metacat
administrator is no longer available or you forgot the administrator password),
you must edit the Metacat configuration file by hand. This ensures that only a
person who has access to the Metacat server and the configuration files on that
server will be able to change the administrator accounts.îh]îh1Xø��If you need to change or add authentication information and cannot authenticate
using the existing authentication settings (e.g., the existing Metacat
administrator is no longer available or you forgot the administrator password),
you must edit the Metacat configuration file by hand. This ensures that only a
person who has access to the Metacat server and the configuration files on that
server will be able to change the administrator accounts.îÖîÅî}î(hjπ��h!j∑��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K{h!jß��hhubh\)Åî}î(hå.To edit the authentication configuration file:îh]îh1å.To edit the authentication configuration file:îÖîÅî}î(hj«��h!j≈��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KÇh!jß��hhubh�åenumerated_listîìî)Åî}î(hhh]îhW)Åî}î(hå‰Stop Tomcat and edit the Metacat properties (``metacat.properties``) file in the
Metacat context directory inside the Tomcat application directory. The
Metacat context directory is the name of the application (usually metacat):
îh]îh\)Åî}î(hå„Stop Tomcat and edit the Metacat properties (``metacat.properties``) file in the
Metacat context directory inside the Tomcat application directory. The
Metacat context directory is the name of the application (usually metacat):îh]î(h1å-Stop Tomcat and edit the Metacat properties (îÖîÅî}î(hå-Stop Tomcat and edit the Metacat properties (îh!j‹��ubjí��)Åî}î(hå``metacat.properties``îh]îh1åmetacat.propertiesîÖîÅî}î(hhh!jÂ��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j‹��ubh1å†) file in the
Metacat context directory inside the Tomcat application directory. The
Metacat context directory is the name of the application (usually metacat):îÖîÅî}î(hå†) file in the
Metacat context directory inside the Tomcat application directory. The
Metacat context directory is the name of the application (usually metacat):îh!j‹��ubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h KÑh!jÿ��ubah}î(h]îh]îh]îh]îh]îuhhVh!j’��hhh"h#h Nubah}î(h]îh]îh]îh]îh]îåenumtypeîåarabicîåprefixîhåsuffixîjã��uhj”��h!jß��hhh"h#h KÑubj°��)Åî}î(hhh]îjT��)Åî}î(hå9<tomcat_app_dir>/<context_dir>/WEB-INF/metacat.propertiesîh]îh1å9<tomcat_app_dir>/<context_dir>/WEB-INF/metacat.propertiesîÖîÅî}î(hhh!j��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h Käh!j��ubah}î(h]îh]îh]îh]îh]îuhj†��h!jß��hhh"h#h Nubj‘��)Åî}î(hhh]îhW)Åî}î(hå/Change the following properties appropriately:
îh]îh\)Åî}î(hå.Change the following properties appropriately:îh]îh1å.Change the following properties appropriately:îÖîÅî}î(hj.��h!j,��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kåh!j(��ubah}î(h]îh]îh]îh]îh]îuhhVh!j%��hhh"h#h Nubah}î(h]îh]îh]îh]îh]îj
��j��j��hj
��jã��åstartîKuhj”��h!jß��hhh"h#h Kåubj°��)Åî}î(hhh]îjT��)Åî}î(hå–auth.administrators - a colon separated list of administrators
auth.url - the authentication server URL
auth.surl - the authentication secure server URL
auth.file.path  - the authentication password file pathîh]îh1å–auth.administrators - a colon separated list of administrators
auth.url - the authentication server URL
auth.surl - the authentication secure server URL
auth.file.path  - the authentication password file pathîÖîÅî}î(hhh!jJ��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h Kêh!jG��ubah}î(h]îh]îh]îh]îh]îuhj†��h!jß��hhh"h#h Nubj‘��)Åî}î(hhh]îhW)Åî}î(hå8Save the ``metacat.properties`` file and start Tomcat.

îh]îh\)Åî}î(hå6Save the ``metacat.properties`` file and start Tomcat.îh]î(h1å	Save the îÖîÅî}î(hå	Save the îh!je��ubjí��)Åî}î(hå``metacat.properties``îh]îh1åmetacat.propertiesîÖîÅî}î(hhh!jn��ubah}î(h]îh]îh]îh]îh]îuhjë��h!je��ubh1å file and start Tomcat.îÖîÅî}î(hå file and start Tomcat.îh!je��ubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Kïh!ja��ubah}î(h]îh]îh]îh]îh]îuhhVh!j^��hhh"h#h Nubah}î(h]îh]îh]îh]îh]îj
��j��j��hj
��jã��jF��Kuhj”��h!jß��hhh"h#h Kïubeh}î(h]îhˆah]îh]îå<changing authentication configuration without authenticationîah]îh]îuhh%h!j†��hhh"h#h Kzh$Kubeh}î(h]îhêah]îh]îåinitial configurationîah]îh]îuhh%h!h'hhh"h#h K ubh&)Åî}î(hhh]î(h+)Åî}î(hj��h]îh1åLogging in to MetacatîÖîÅî}î(hj��h!j§��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j��uhh*h!j°��hhh"h#h Kôubh\)Åî}î(hX!��In order to configure Metacat, you must log in with an administrative account
that has been configured in the Authentication Configuration settings. If you
did not set up the correct administrative user there, you must change the
authentication configuration by hand before you can log in.îh]îh1X!��In order to configure Metacat, you must log in with an administrative account
that has been configured in the Authentication Configuration settings. If you
did not set up the correct administrative user there, you must change the
authentication configuration by hand before you can log in.îÖîÅî}î(hj≥��h!j±��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Köh!j°��hhubh\)Åî}î(håTIn the log-in screen enter your user name and password and click
the "Login" button.îh]îh1åXIn the log-in screen enter your user name and password and click
the ‚ÄúLogin‚Äù button.îÖîÅî}î(hj¡��h!jø��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Küh!j°��hhubj��)Åî}î(hhh]î(j��)Åî}î(håX.. figure:: images/screenshots/image015.png
   :align: center

   Logging into Metacat.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image015.pngîj ��}îj"��j€��suhj��h!jÕ��h"h#h K•ubj$��)Åî}î(håLogging into Metacat.îh]îh1åLogging into Metacat.îÖîÅî}î(hjfl��h!j›��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h K•h!jÕ��ubeh}î(h]îåid5îah]îh]îh]îh]îj:��åcenterîuhj
��h K•h!j°��hhh"h#ubeh}î(h]îj%��ah]îh]îålogging in to metacatîah]îh]îuhh%h!h'hhh"h#h Kôubh&)Åî}î(hhh]î(h+)Åî}î(hj?��h]îh1åRequired ConfigurationîÖîÅî}î(hj?��h!j˝��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<jB��uhh*h!j˙��hhh"h#h K®ubh\)Åî}î(håÀAll required Metacat settings can be accessed from the Metacat Configuration
utility, which becomes available after the initial configurations
have been specified and an authorized administrator logs in.îh]îh1åÀAll required Metacat settings can be accessed from the Metacat Configuration
utility, which becomes available after the initial configurations
have been specified and an authorized administrator logs in.îÖîÅî}î(hj��h!j
��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K©h!j˙��hhubj��)Åî}î(hhh]î(j��)Åî}î(hå’.. figure:: images/screenshots/image017.png
   :align: center

   Metacat configuration menu, showing each configuration section.  Once all
   sections are marked as green ``configured``, metacat can be accessed.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image017.pngîj ��}îj"��j&��suhj��h!j��h"h#h K∞ubj$��)Åî}î(håèMetacat configuration menu, showing each configuration section.  Once all
sections are marked as green ``configured``, metacat can be accessed.îh]î(h1ågMetacat configuration menu, showing each configuration section.  Once all
sections are marked as green îÖîÅî}î(hågMetacat configuration menu, showing each configuration section.  Once all
sections are marked as green îh!j(��ubjí��)Åî}î(hå``configured``îh]îh1å
configuredîÖîÅî}î(hhh!j1��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j(��ubh1å, metacat can be accessed.îÖîÅî}î(hå, metacat can be accessed.îh!j(��ubeh}î(h]îh]îh]îh]îh]îuhj#��h"h#h K∞h!j��ubeh}î(h]îåid6îah]îh]îh]îh]îj:��åcenterîuhj
��h K∞h!j˙��hhh"h#ubh\)Åî}î(hX��The configuration settings are grouped into five sections (Metacat Global
Properties, Authentication Configuration, Skins Specific Properties, Database
Installation/Upgrade, Geoserver, DataONE, and Replication Configuration),
each of which is listed with its current status (see table).îh]îh1X��The configuration settings are grouped into five sections (Metacat Global
Properties, Authentication Configuration, Skins Specific Properties, Database
Installation/Upgrade, Geoserver, DataONE, and Replication Configuration),
each of which is listed with its current status (see table).îÖîÅî}î(hjT��h!jR��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K≥h!j˙��hhubh�åtableîìî)Åî}î(hhh]îh�åtgroupîìî)Åî}î(hhh]î(h�åcolspecîìî)Åî}î(hhh]îh}î(h]îh]îh]îh]îh]îåcolwidthîKuhjj��h!jg��ubjk��)Åî}î(hhh]îh}î(h]îh]îh]îh]îh]îåcolwidthîK=uhjj��h!jg��ubh�åtheadîìî)Åî}î(hhh]îh�årowîìî)Åî}î(hhh]î(h�åentryîìî)Åî}î(hhh]îh\)Åî}î(håStatusîh]îh1åStatusîÖîÅî}î(hjë��h!jè��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kπh!jå��ubah}î(h]îh]îh]îh]îh]îuhjä��h!já��ubjã��)Åî}î(hhh]îh\)Åî}î(håDescriptionîh]îh1åDescriptionîÖîÅî}î(hj®��h!j¶��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kπh!j£��ubah}î(h]îh]îh]îh]îh]îuhjä��h!já��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!jÇ��ubah}î(h]îh]îh]îh]îh]îuhjÄ��h!jg��ubh�åtbodyîìî)Åî}î(hhh]î(jÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(håunconfiguredîh]îh1åunconfiguredîÖîÅî}î(hj”��h!j—��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kªh!jŒ��ubah}î(h]îh]îh]îh]îh]îuhjä��h!jÀ��ubjã��)Åî}î(hhh]îh\)Åî}î(hå$The section has yet to be configuredîh]îh1å$The section has yet to be configuredîÖîÅî}î(hjÍ��h!jË��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kªh!jÂ��ubah}î(h]îh]îh]îh]îh]îuhjä��h!jÀ��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!j»��ubjÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(hå
configuredîh]îh1å
configuredîÖîÅî}î(hj
	��h!j	��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kºh!j	��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j	��ubjã��)Åî}î(hhh]îh\)Åî}î(hå The section has been configured.îh]îh1å The section has been configured.îÖîÅî}î(hj!	��h!j	��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kºh!j	��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j	��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!j»��ubjÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(håbypassedîh]îh1åbypassedîÖîÅî}î(hjA	��h!j?	��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KΩh!j<	��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j9	��ubjã��)Åî}î(hhh]îh\)Åî}î(håBThe administrator
can choose not to configure or skip the section.îh]îh1åBThe administrator
can choose not to configure or skip the section.îÖîÅî}î(hjX	��h!jV	��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KΩh!jS	��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j9	��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!j»��ubeh}î(h]îh]îh]îh]îh]îuhj∆��h!jg��ubeh}î(h]îh]îh]îh]îh]îåcolsîKuhje��h!jb��ubah}î(h]îh]îh]îh]îh]îuhj`��h!j˙��hhh"h#h Nubh\)Åî}î(hX��To the right of each configuration section is one of the following options:
Configure Now, Reconfigure Now, Configure Global Properties First, or
Version:X.X.X. If the option is linked (e.g., Configure Now or Reconfigure Now),
you can select the link to open the associated configuration settings and edit them.
If the option is not linked (e.g., Configure Global
Properties First), the settings cannot be specified until the global properties
are set. Once the global properties are configured, the option to configure this
section becomes available. The Version:X.X.X option is used only for the
Database Installation/Upgrade section. If the database schema version detected
by Metacat matches the application version (eg, 1.9.0), then no further database
configuration is required.îh]îh1X��To the right of each configuration section is one of the following options:
Configure Now, Reconfigure Now, Configure Global Properties First, or
Version:X.X.X. If the option is linked (e.g., Configure Now or Reconfigure Now),
you can select the link to open the associated configuration settings and edit them.
If the option is not linked (e.g., Configure Global
Properties First), the settings cannot be specified until the global properties
are set. Once the global properties are configured, the option to configure this
section becomes available. The Version:X.X.X option is used only for the
Database Installation/Upgrade section. If the database schema version detected
by Metacat matches the application version (eg, 1.9.0), then no further database
configuration is required.îÖîÅî}î(hjÖ	��h!jÉ	��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K¡h!j˙��hhubh\)Åî}î(hX��All settings must be in a configured or bypassed state in order to run Metacat.
For new installations or upgrades, click the "go to metacat" link that appears
after configuration is complete to go directly to Metacat. Note that Metacat
indexes at start-up time, so the initial start-up may take some time depending
on the amount of data in your database and wheter or not you have opted to regenerate the spatial cache.
If you are reconfiguring a running
version of Metacat, you must restart the Tomcat server for the changes to
take effect.îh]îh1X!��All settings must be in a configured or bypassed state in order to run Metacat.
For new installations or upgrades, click the “go to metacat” link that appears
after configuration is complete to go directly to Metacat. Note that Metacat
indexes at start-up time, so the initial start-up may take some time depending
on the amount of data in your database and wheter or not you have opted to regenerate the spatial cache.
If you are reconfiguring a running
version of Metacat, you must restart the Tomcat server for the changes to
take effect.îÖîÅî}î(hjì	��h!jë	��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KÕh!j˙��hhubj��)Åî}î(hhh]î(j��)Åî}î(håÑ.. figure:: images/screenshots/image019.png
   :align: center

   The Metacat settings as they appear after having been configured.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image019.pngîj ��}îj"��j≠	��suhj��h!jü	��h"h#h KŸubj$��)Åî}î(håAThe Metacat settings as they appear after having been configured.îh]îh1åAThe Metacat settings as they appear after having been configured.îÖîÅî}î(hj±	��h!jØ	��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h KŸh!jü	��ubeh}î(h]îåid7îah]îh]îh]îh]îj:��åcenterîuhj
��h KŸh!j˙��hhh"h#ubh&)Åî}î(hhh]î(h+)Åî}î(hj_��h]îh1å&Global Properties (server, ports, etc)îÖîÅî}î(hj_��h!j»	��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<jb��uhh*h!j≈	��hhh"h#h K‹ubh\)Åî}î(hX��The Metacat configurations included under Global Properties represent the bulk
of the settings required to run Metacat. Click a blue question-mark
icon beside any setting for detailed instructions. More information about each
property is also included in the :doc:`metacat-properties`.îh]î(h1X��The Metacat configurations included under Global Properties represent the bulk
of the settings required to run Metacat. Click a blue question-mark
icon beside any setting for detailed instructions. More information about each
property is also included in the îÖîÅî}î(hX��The Metacat configurations included under Global Properties represent the bulk
of the settings required to run Metacat. Click a blue question-mark
icon beside any setting for detailed instructions. More information about each
property is also included in the îh!j’	��hhh"Nh Nubj˚��)Åî}î(hå:doc:`metacat-properties`îh]îj��)Åî}î(hj‡	��h]îh1åmetacat-propertiesîÖîÅî}î(hhh!j‚	��ubah}î(h]îh]î(j��åstdîåstd-docîeh]îh]îh]îuhj���h!jfi	��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîjÏ	��årefexplicitîâj��åmetacat-propertiesîj��j��j ��àuhj˙��h"h#h K›h!j’	��ubh1å.îÖîÅî}î(hjã��h!j’	��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h K›h!j≈	��hhubj��)Åî}î(hhh]î(j��)Åî}î(håp.. figure:: images/screenshots/image021.png
   :align: center

   The Metacat Global Properties editing screen.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image021.pngîj ��}îj"��j
��suhj��h!j
��h"h#h KÂubj$��)Åî}î(hå-The Metacat Global Properties editing screen.îh]îh1å-The Metacat Global Properties editing screen.îÖîÅî}î(hj
��h!j
��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h KÂh!j
��ubeh}î(h]îåid8îah]îh]îh]îh]îj:��åcenterîuhj
��h KÂh!j≈	��hhh"h#ubh\)Åî}î(hX��When you save global properties, Metacat also saves a back-up file that is
located in ``/var/metacat/.metacat`` (on Linux). When you update Metacat,
the system automatically locates the back-up file so you do not have to re-enter
the configuration settings.îh]î(h1åVWhen you save global properties, Metacat also saves a back-up file that is
located in îÖîÅî}î(håVWhen you save global properties, Metacat also saves a back-up file that is
located in îh!j,
��hhh"Nh Nubjí��)Åî}î(hå``/var/metacat/.metacat``îh]îh1å/var/metacat/.metacatîÖîÅî}î(hhh!j5
��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j,
��ubh1åí (on Linux). When you update Metacat,
the system automatically locates the back-up file so you do not have to re-enter
the configuration settings.îÖîÅî}î(håí (on Linux). When you update Metacat,
the system automatically locates the back-up file so you do not have to re-enter
the configuration settings.îh!j,
��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h KÁh!j≈	��hhubh\)Åî}î(håπThe first time you install Metacat, the system attempts to automatically detect
the values for a number of settings (see table). It is important to ensure that
these values are correct.îh]îh1åπThe first time you install Metacat, the system attempts to automatically detect
the values for a number of settings (see table). It is important to ensure that
these values are correct.îÖîÅî}î(hjP
��h!jN
��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KÏh!j≈	��hhubja��)Åî}î(hhh]îjf��)Åî}î(hhh]î(jk��)Åî}î(hhh]îh}î(h]îh]îh]îh]îh]îåcolwidthîKuhjj��h!j_
��ubjk��)Åî}î(hhh]îh}î(h]îh]îh]îh]îh]îåcolwidthîK<uhjj��h!j_
��ubjÅ��)Åî}î(hhh]îjÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(håPropertyîh]îh1åPropertyîÖîÅî}î(hjÅ
��h!j
��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KÒh!j|
��ubah}î(h]îh]îh]îh]îh]îuhjä��h!jy
��ubjã��)Åî}î(hhh]îh\)Åî}î(håDescriptionîh]îh1åDescriptionîÖîÅî}î(hjò
��h!jñ
��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KÒh!jì
��ubah}î(h]îh]îh]îh]îh]îuhjä��h!jy
��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!jv
��ubah}î(h]îh]îh]îh]îh]îuhjÄ��h!j_
��ubj«��)Åî}î(hhh]î(jÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(håMetacat Contextîh]îh1åMetacat ContextîÖîÅî}î(hj¡
��h!jø
��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KÛh!jº
��ubah}î(h]îh]îh]îh]îh]îuhjä��h!jπ
��ubjã��)Åî}î(hhh]îh\)Åî}î(håUThe name of the deployed Metacat WAR file (minus the .war
extension). E.g., "metacat"îh]îh1åYThe name of the deployed Metacat WAR file (minus the .war
extension). E.g., ‚Äúmetacat‚ÄùîÖîÅî}î(hjÿ
��h!j÷
��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h KÛh!j”
��ubah}î(h]îh]îh]îh]îh]îuhjä��h!jπ
��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!j∂
��ubjÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(håServer Nameîh]îh1åServer NameîÖîÅî}î(hj¯
��h!jˆ
��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Kıh!jÛ
��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j
��ubjã��)Åî}î(hhh]îh\)Åî}î(håcThe DNS name of the server hosting Metacat, not including
port numbers or the protocol ("http://").îh]î(h1å[The DNS name of the server hosting Metacat, not including
port numbers or the protocol (‚ÄúîÖîÅî}î(håYThe DNS name of the server hosting Metacat, not including
port numbers or the protocol ("îh!j
��ubha)Åî}î(håhttp://îh]îh1åhttp://îÖîÅî}î(hhh!j��ubah}î(h]îh]îh]îh]îh]îårefuriîj��uhh`h!j
��ubh1å‚Äù).îÖîÅî}î(hå").îh!j
��ubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Kıh!j
��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j
��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!j∂
��ubjÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(hå	HTTP Portîh]îh1å	HTTP PortîÖîÅî}î(hjD��h!jB��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K˜h!j?��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j<��ubjã��)Åî}î(hhh]îh\)Åî}î(hå4The non-secure port where Metacat will be available.îh]îh1å4The non-secure port where Metacat will be available.îÖîÅî}î(hj[��h!jY��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K˜h!jV��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j<��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!j∂
��ubjÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(hå
HTTP SSL Portîh]îh1å
HTTP SSL PortîÖîÅî}î(hj{��h!jy��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K¯h!jv��ubah}î(h]îh]îh]îh]îh]îuhjä��h!js��ubjã��)Åî}î(hhh]îh\)Åî}î(hå0The secure port where Metacat will be available.îh]îh1å0The secure port where Metacat will be available.îÖîÅî}î(hjí��h!jê��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K¯h!jç��ubah}î(h]îh]îh]îh]îh]îuhjä��h!js��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!j∂
��ubjÜ��)Åî}î(hhh]î(jã��)Åî}î(hhh]îh\)Åî}î(håDeploy Locationîh]îh1åDeploy LocationîÖîÅî}î(hj≤��h!j∞��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K˘h!j≠��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j™��ubjã��)Åî}î(hhh]îh\)Åî}î(hå0The directory where the application is deployed.îh]îh1å0The directory where the application is deployed.îÖîÅî}î(hj…��h!j«��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K˘h!jƒ��ubah}î(h]îh]îh]îh]îh]îuhjä��h!j™��ubeh}î(h]îh]îh]îh]îh]îuhjÖ��h!j∂
��ubeh}î(h]îh]îh]îh]îh]îuhj∆��h!j_
��ubeh}î(h]îh]îh]îh]îh]îåcolsîKuhje��h!j\
��ubah}î(h]îh]îh]îh]îh]îuhj`��h!j≈	��hhh"h#h NubjÙ��)Åî}î(hX��The Solr Home directory you choose should be writable/readable by the user solr.

The Environment Overwrites File should be writable/readable by the user tomcat8.

The section of Tomcat And Solr User Management on the `Solr installation page`_ will resolve this issue.îh]î(h\)Åî}î(håPThe Solr Home directory you choose should be writable/readable by the user solr.îh]îh1åPThe Solr Home directory you choose should be writable/readable by the user solr.îÖîÅî}î(hj˙��h!j¯��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h K˛h!jÙ��ubh\)Åî}î(håPThe Environment Overwrites File should be writable/readable by the user tomcat8.îh]îh1åPThe Environment Overwrites File should be writable/readable by the user tomcat8.îÖîÅî}î(hj��h!j��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h M�h!jÙ��ubh\)Åî}î(håhThe section of Tomcat And Solr User Management on the `Solr installation page`_ will resolve this issue.îh]î(h1å6The section of Tomcat And Solr User Management on the îÖîÅî}î(hå6The section of Tomcat And Solr User Management on the îh!j��ubha)Åî}î(hå`Solr installation page`_îh]îh1åSolr installation pageîÖîÅî}î(hhh!j��ubah}î(h]îh]îh]îh]îh]îånameîåSolr installation pageîhhuhh`h!j��j…��Kubh1å will resolve this issue.îÖîÅî}î(hå will resolve this issue.îh!j��ubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Mh!jÙ��ubeh}î(h]îh]îh]îh]îh]îuhjÛ��h!j≈	��hhh"h#h Nubeh}î(h]îjh��ah]îh]îå&global properties (server, ports, etc)îah]îh]îuhh%h!j˙��hhh"h#h K‹ubh&)Åî}î(hhh]î(h+)Åî}î(hjÇ��h]îh1åAuthentication ConfigurationîÖîÅî}î(hjÇ��h!jH��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<jÖ��uhh*h!jE��hhh"h#h Mubh\)Åî}î(hXÜ��Because you must specify the Authentication settings before you can access the
main configuration page, the settings will always be configured when you view
them in the admin interface. If you wish to change the authentication settings,
you must restart Metacat to put the changes into effect. For more information
about the Authentication configurations, please see Initial Configurations.îh]îh1XÜ��Because you must specify the Authentication settings before you can access the
main configuration page, the settings will always be configured when you view
them in the admin interface. If you wish to change the authentication settings,
you must restart Metacat to put the changes into effect. For more information
about the Authentication configurations, please see Initial Configurations.îÖîÅî}î(hjW��h!jU��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Mh!jE��hhubeh}î(h]îjã��ah]îh]îh]îj•��ah]îuhh%h!j˙��hhh"h#h Mh$Kubh&)Åî}î(hhh]î(h+)Åî}î(hj•��h]îh1åSkins ConfigurationîÖîÅî}î(hj•��h!jl��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j®��uhh*h!ji��hhh"h#h M
ubh\)Åî}î(hX*��Customizing the look and feel of Metacat's web interface is done via skins or
MetacatUI themes, however as of Version 2.2.0, skins have been deprecated.
Use MetacatUI themes instead. Themes can be deployed separately from the
Metacat server allowing easier independent user interface customization.îh]îh1X,��Customizing the look and feel of Metacat‚Äôs web interface is done via skins or
MetacatUI themes, however as of Version 2.2.0, skins have been deprecated.
Use MetacatUI themes instead. Themes can be deployed separately from the
Metacat server allowing easier independent user interface customization.îÖîÅî}î(hj{��h!jy��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Mh!ji��hhubh&)Åî}î(hhh]î(h+)Åî}î(hj≈��h]îh1åMetacatUI ThemesîÖîÅî}î(hj≈��h!jä��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j»��uhh*h!já��hhh"h#h Mubh\)Åî}î(hX†��Themes are applied in the Skins Configuration section. If you have installed
the optional Registry, which provides a web interface for creating, editing,
and submitting content to Metacat, you can also choose which form fields
appear in that interface and which are required. Note that if you do not have
a custom theme AND you are not using the Registry, you can simply save the
``metacatui`` default configuration.îh]î(h1X|��Themes are applied in the Skins Configuration section. If you have installed
the optional Registry, which provides a web interface for creating, editing,
and submitting content to Metacat, you can also choose which form fields
appear in that interface and which are required. Note that if you do not have
a custom theme AND you are not using the Registry, you can simply save the
îÖîÅî}î(hX|��Themes are applied in the Skins Configuration section. If you have installed
the optional Registry, which provides a web interface for creating, editing,
and submitting content to Metacat, you can also choose which form fields
appear in that interface and which are required. Note that if you do not have
a custom theme AND you are not using the Registry, you can simply save the
îh!jó��hhh"Nh Nubjí��)Åî}î(hå
``metacatui``îh]îh1å	metacatuiîÖîÅî}î(hhh!j†��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jó��ubh1å default configuration.îÖîÅî}î(hå default configuration.îh!jó��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Mh!já��hhubh\)Åî}î(hX��To use the new MetacatUI theming system, select ``metacatui`` and click the
``Make metacatui default`` radio button. Metacat will open a list of options
that apply to the Registry interface. For more information about creating
custom themes, see the section called :doc:`themes`.îh]î(h1å0To use the new MetacatUI theming system, select îÖîÅî}î(hå0To use the new MetacatUI theming system, select îh!jπ��hhh"Nh Nubjí��)Åî}î(hå
``metacatui``îh]îh1å	metacatuiîÖîÅî}î(hhh!j¬��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jπ��ubh1å and click the
îÖîÅî}î(hå and click the
îh!jπ��hhh"Nh Nubjí��)Åî}î(hå``Make metacatui default``îh]îh1åMake metacatui defaultîÖîÅî}î(hhh!j’��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jπ��ubh1å£ radio button. Metacat will open a list of options
that apply to the Registry interface. For more information about creating
custom themes, see the section called îÖîÅî}î(hå£ radio button. Metacat will open a list of options
that apply to the Registry interface. For more information about creating
custom themes, see the section called îh!jπ��hhh"Nh Nubj˚��)Åî}î(hå
:doc:`themes`îh]îj��)Åî}î(hjÍ��h]îh1åthemesîÖîÅî}î(hhh!jÏ��ubah}î(h]îh]î(j��åstdîåstd-docîeh]îh]îh]îuhj���h!jË��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîjˆ��årefexplicitîâj��åthemesîj��j��j ��àuhj˙��h"h#h Mh!jπ��ubh1å.îÖîÅî}î(hjã��h!jπ��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Mh!já��hhubj��)Åî}î(hhh]î(j��)Åî}î(hå^.. figure:: images/screenshots/image070.png
   :align: center

   Configuring Metacat themes.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image070.pngîj ��}îj"��j
��suhj��h!j
��h"h#h M$ubj$��)Åî}î(håConfiguring Metacat themes.îh]îh1åConfiguring Metacat themes.îÖîÅî}î(hj"
��h!j 
��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h M$h!j
��ubeh}î(h]îåid9îah]îh]îh]îh]îj:��åcenterîuhj
��h M$h!já��hhh"h#ubeh}î(h]îjŒ��ah]îh]îåmetacatui themesîah]îh]îuhh%h!ji��hhh"h#h Mubh&)Åî}î(hhh]î(h+)Åî}î(hjË��h]îh1åSkinsîÖîÅî}î(hjË��h!j@
��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<jÎ��uhh*h!j=
��hhh"h#h M'ubh�åcommentîìî)Åî}î(hå#deprecated:2.2.0
Use themes insteadîh]îh1å#deprecated:2.2.0
Use themes insteadîÖîÅî}î(hhh!jO
��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjM
��h!j=
��hhh"h#h M*ubh\)Åî}î(hX)��If your Metacat has a customized skin, it will appear as a choice in the
Skins Configuration settings (see below screenshot). Select the checkbox next
to your customized skin or and click the ``Make <skin_name> default`` radio button.
If you do not have a custom skin, select the ``default`` skin.îh]î(h1å¿If your Metacat has a customized skin, it will appear as a choice in the
Skins Configuration settings (see below screenshot). Select the checkbox next
to your customized skin or and click the îÖîÅî}î(hå¿If your Metacat has a customized skin, it will appear as a choice in the
Skins Configuration settings (see below screenshot). Select the checkbox next
to your customized skin or and click the îh!j]
��hhh"Nh Nubjí��)Åî}î(hå``Make <skin_name> default``îh]îh1åMake <skin_name> defaultîÖîÅî}î(hhh!jf
��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j]
��ubh1å< radio button.
If you do not have a custom skin, select the îÖîÅî}î(hå< radio button.
If you do not have a custom skin, select the îh!j]
��hhh"Nh Nubjí��)Åî}î(hå``default``îh]îh1ådefaultîÖîÅî}î(hhh!jy
��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j]
��ubh1å skin.îÖîÅî}î(hå skin.îh!j]
��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h M+h!j=
��hhubh\)Åî}î(håÃOnce you have selected a skin, Metacat will open a list of options that apply to the Registry
interface. For more information about creating skins, see the Creating a Custom Skin
section in :doc:`themes`.îh]î(h1åæOnce you have selected a skin, Metacat will open a list of options that apply to the Registry
interface. For more information about creating skins, see the Creating a Custom Skin
section in îÖîÅî}î(håæOnce you have selected a skin, Metacat will open a list of options that apply to the Registry
interface. For more information about creating skins, see the Creating a Custom Skin
section in îh!jí
��hhh"Nh Nubj˚��)Åî}î(hå
:doc:`themes`îh]îj��)Åî}î(hjù
��h]îh1åthemesîÖîÅî}î(hhh!jü
��ubah}î(h]îh]î(j��åstdîåstd-docîeh]îh]îh]îuhj���h!jõ
��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîj©
��årefexplicitîâj��åthemesîj��j��j ��àuhj˙��h"h#h M0h!jí
��ubh1å.îÖîÅî}î(hjã��h!jí
��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h M0h!j=
��hhubj��)Åî}î(hhh]î(j��)Åî}î(hå].. figure:: images/screenshots/image023.png
   :align: center

   Configuring Metacat skins.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image023.pngîj ��}îj"��j—
��suhj��h!j√
��h"h#h M7ubj$��)Åî}î(håConfiguring Metacat skins.îh]îh1åConfiguring Metacat skins.îÖîÅî}î(hj’
��h!j”
��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h M7h!j√
��ubeh}î(h]îåid10îah]îh]îh]îh]îj:��åcenterîuhj
��h M7h!j=
��hhh"h#ubh\)Åî}î(hX��Select the checkbox next to your customized skin or and click the
``Make <skin_name> default`` radio button. If you do not have a custom skin,
select the ``default`` skin. Once you have selected a skin, Metacat will open
a list of options that apply to the Registry interface.îh]î(h1åBSelect the checkbox next to your customized skin or and click the
îÖîÅî}î(håBSelect the checkbox next to your customized skin or and click the
îh!jÈ
��hhh"Nh Nubjí��)Åî}î(hå``Make <skin_name> default``îh]îh1åMake <skin_name> defaultîÖîÅî}î(hhh!jÚ
��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jÈ
��ubh1å< radio button. If you do not have a custom skin,
select the îÖîÅî}î(hå< radio button. If you do not have a custom skin,
select the îh!jÈ
��hhh"Nh Nubjí��)Åî}î(hå``default``îh]îh1ådefaultîÖîÅî}î(hhh!j��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jÈ
��ubh1åo skin. Once you have selected a skin, Metacat will open
a list of options that apply to the Registry interface.îÖîÅî}î(håo skin. Once you have selected a skin, Metacat will open
a list of options that apply to the Registry interface.îh!jÈ
��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h M9h!j=
��hhubh\)Åî}î(hå“Select the lists and modules that you would like to appear in the Registry
form-interface by checking the box beside each. When you save the configuration,
the customized interface will appear to site visitors.îh]îh1å“Select the lists and modules that you would like to appear in the Registry
form-interface by checking the box beside each. When you save the configuration,
the customized interface will appear to site visitors.îÖîÅî}î(hj ��h!j��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h M>h!j=
��hhubeh}î(h]îjÒ��ah]îh]îåskinsîah]îh]îuhh%h!ji��hhh"h#h M'ubeh}î(h]îjÆ��ah]îh]îåskins configurationîah]îh]îuhh%h!j˙��hhh"h#h M
ubh&)Åî}î(hhh]î(h+)Åî}î(hj��h]îh1åDatabase ConfigurationîÖîÅî}î(hj��h!j=��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j��uhh*h!j:��hhh"h#h MCubh\)Åî}î(hXe��Because the Database Configuration is dependent on values specified in the
Global Properties section, the link to these settings does not become active
until after the global settings have been saved. Once the global settings have
been saved, Metacat automatically detects the database schema version and
upgrades it if necessary (and with your permission).îh]îh1Xe��Because the Database Configuration is dependent on values specified in the
Global Properties section, the link to these settings does not become active
until after the global settings have been saved. Once the global settings have
been saved, Metacat automatically detects the database schema version and
upgrades it if necessary (and with your permission).îÖîÅî}î(hjL��h!jJ��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h MDh!j:��hhubhR)Åî}î(hhh]î(hW)Åî}î(håNew Installationîh]îh\)Åî}î(hj]��h]îh1åNew InstallationîÖîÅî}î(hj]��h!j_��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h MJh!j[��ubah}î(h]îh]îh]îh]îh]îuhhVh!jX��hhh"h#h NubhW)Åî}î(håUpgrade
îh]îh\)Åî}î(håUpgradeîh]îh1åUpgradeîÖîÅî}î(hjx��h!jv��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h MKh!jr��ubah}î(h]îh]îh]îh]îh]îuhhVh!jX��hhh"h#h Nubeh}î(h]îh]îh]îh]îh]îåbulletîj"��uhhQh"h#h MJh!j:��hhubh&)Åî}î(hhh]î(h+)Åî}î(hj7��h]îh1åNew InstallationîÖîÅî}î(hj7��h!jî��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j:��uhh*h!jë��hhh"h#h MNubh\)Åî}î(håæIf Metacat determines that your database is new, the Database Install/Upgrade
utility lists the SQL scripts that will run in order to create a database
schema for the new version of Metacat.îh]îh1åæIf Metacat determines that your database is new, the Database Install/Upgrade
utility lists the SQL scripts that will run in order to create a database
schema for the new version of Metacat.îÖîÅî}î(hj£��h!j°��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h MOh!jë��hhubj��)Åî}î(hhh]î(j��)Åî}î(hå{.. figure:: images/screenshots/image027.png
   :align: center

   Database installation creates tables needed for Metacat.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image027.pngîj ��}îj"��jΩ��suhj��h!jØ��h"h#h MVubj$��)Åî}î(hå8Database installation creates tables needed for Metacat.îh]îh1å8Database installation creates tables needed for Metacat.îÖîÅî}î(hj¡��h!jø��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h MVh!jØ��ubeh}î(h]îåid11îah]îh]îh]îh]îj:��åcenterîuhj
��h MVh!jë��hhh"h#ubh\)Åî}î(håñIf the database is not new, or if you have any questions about whether it is
new or not, choose Cancel and contact support at knb-help@nceas.ucsb.edu.îh]î(h1å~If the database is not new, or if you have any questions about whether it is
new or not, choose Cancel and contact support at îÖîÅî}î(hå~If the database is not new, or if you have any questions about whether it is
new or not, choose Cancel and contact support at îh!j’��hhh"Nh Nubha)Åî}î(håknb-help@nceas.ucsb.eduîh]îh1åknb-help@nceas.ucsb.eduîÖîÅî}î(hhh!jfi��ubah}î(h]îh]îh]îh]îh]îårefuriîåmailto:knb-help@nceas.ucsb.eduîuhh`h!j’��ubh1å.îÖîÅî}î(hjã��h!j’��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h MXh!jë��hhubh\)Åî}î(håZWhen you choose Continue, Metacat runs the listed scripts and creates the
database schema.îh]îh1åZWhen you choose Continue, Metacat runs the listed scripts and creates the
database schema.îÖîÅî}î(hj˙��h!j¯��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h M[h!jë��hhubeh}î(h]îj@��ah]îh]îånew installationîah]îh]îuhh%h!j:��hhh"h#h MNubh&)Åî}î(hhh]î(h+)Åî}î(hjZ��h]îh1åUpgradeîÖîÅî}î(hjZ��h!j��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j]��uhh*h!j
��hhh"h#h M_ubh\)Åî}î(hå◊If Metacat identifies a previous database schema, the Database Install/Upgrade
utility notes the existing version and lists the SQL scripts that will run in
order to update the schema for the new version of Metacat.îh]îh1å◊If Metacat identifies a previous database schema, the Database Install/Upgrade
utility notes the existing version and lists the SQL scripts that will run in
order to update the schema for the new version of Metacat.îÖîÅî}î(hj��h!j��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h M`h!j
��hhubh\)Åî}î(hX��If the detected schema version is incorrect, or if you have any questions about
whether it is correct or not, click the Cancel button and contact support at
knb-help@nceas.ucsb.edu.When you choose to continue, Metacat runs the listed
scripts and updates the database schema.îh]î(h1åùIf the detected schema version is incorrect, or if you have any questions about
whether it is correct or not, click the Cancel button and contact support at
îÖîÅî}î(håùIf the detected schema version is incorrect, or if you have any questions about
whether it is correct or not, click the Cancel button and contact support at
îh!j+��hhh"Nh Nubha)Åî}î(håknb-help@nceas.ucsb.edu.Whenîh]îh1åknb-help@nceas.ucsb.edu.WhenîÖîÅî}î(hhh!j4��ubah}î(h]îh]îh]îh]îh]îårefuriîå#mailto:knb-help@nceas.ucsb.edu.Whenîuhh`h!j+��ubh1åY you choose to continue, Metacat runs the listed
scripts and updates the database schema.îÖîÅî}î(håY you choose to continue, Metacat runs the listed
scripts and updates the database schema.îh!j+��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Mdh!j
��hhubj��)Åî}î(hhh]î(j��)Åî}î(håb.. figure:: images/screenshots/image029.png
   :align: center

   Upgrading an existing database.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image029.pngîj ��}îj"��j]��suhj��h!jO��h"h#h Mlubj$��)Åî}î(håUpgrading an existing database.îh]îh1åUpgrading an existing database.îÖîÅî}î(hja��h!j_��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h Mlh!jO��ubeh}î(h]îåid12îah]îh]îh]îh]îj:��åcenterîuhj
��h Mlh!j
��hhh"h#ubh\)Åî}î(hX��Additional upgrade tasks may also run after the database upgrade is complete.
For systems hosting large amounts of data, these upgrade routines can take time to complete.
It is important to let the process complete before using Metacat otherwise your deployment may become unstable.îh]îh1X��Additional upgrade tasks may also run after the database upgrade is complete.
For systems hosting large amounts of data, these upgrade routines can take time to complete.
It is important to let the process complete before using Metacat otherwise your deployment may become unstable.îÖîÅî}î(hjw��h!ju��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Mnh!j
��hhubeh}î(h]îjc��ah]îh]îåupgradeîah]îh]îuhh%h!j:��hhh"h#h M_ubeh}î(h]îj ��ah]îh]îådatabase configurationîah]îh]îuhh%h!j˙��hhh"h#h MCubh&)Åî}î(hhh]î(h+)Åî}î(hjâ��h]îh1åSolr Server ConfigurationîÖîÅî}î(hjâ��h!jî��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<jå��uhh*h!jë��hhh"h#h Mtubh\)Åî}î(hXs��Because the Solr Server Configuration is dependent on values specified in the
Global Properties section, the link to these settings does not become active
until after the global settings have been saved. Once the global settings have
been saved, Metacat automatically detects the status of the Solr Core and creates
or upgrades it if necessary (and with your permission).îï—Å������h]îh1Xs��Because the Solr Server Configuration is dependent on values specified in the
Global Properties section, the link to these settings does not become active
until after the global settings have been saved. Once the global settings have
been saved, Metacat automatically detects the status of the Solr Core and creates
or upgrades it if necessary (and with your permission).îÖîÅî}î(hj£��h!j°��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Muh!jë��hhubj��)Åî}î(hhh]îj��)Åî}î(hå>.. figure:: images/screenshots/image073.png
   :align: center
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image073.pngîj ��}îj"��jΩ��suhj��h!jØ��h"h#h Nubah}î(h]îh]îh]îh]îh]îj:��åcenterîuhj
��h!jë��hhh"h#h NubjÙ��)Åî}î(hå9Solr server should be running when you configure Metacat.îh]îh\)Åî}î(hj»��h]îh1å9Solr server should be running when you configure Metacat.îÖîÅî}î(hj»��h!j ��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h MÅh!j∆��ubah}î(h]îh]îh]îh]îh]îuhjÛ��h!jë��hhh"h#h Nubh&)Åî}î(hhh]î(h+)Åî}î(hj©��h]îh1åTroubleshootingîÖîÅî}î(hj©��h!j‡��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j¨��uhh*h!j›��hhh"h#h MÑubh\)Åî}î(håÀIf you click the Solr Configuration button and get the error message like
``Server refused connection at: http://localhost:8983/solr``, this means the
Solr server is not running and you need to start it.îh]î(h1åJIf you click the Solr Configuration button and get the error message like
îÖîÅî}î(håJIf you click the Solr Configuration button and get the error message like
îh!jÌ��hhh"Nh Nubjí��)Åî}î(hå<``Server refused connection at: http://localhost:8983/solr``îh]îh1å8Server refused connection at: http://localhost:8983/solrîÖîÅî}î(hhh!jˆ��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jÌ��ubh1åE, this means the
Solr server is not running and you need to start it.îÖîÅî}î(håE, this means the
Solr server is not running and you need to start it.îh!jÌ��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h MÖh!j›��hhubh\)Åî}î(hX˜��If you click the Create button to create the Solr core and get an error message
like ``Couldn't persist core properties to /var/metacat/solr-home2/``, this means
the solr user doesn't have the write permission to the Solr Home directory. You need
to add the solr user to the tomcat group, restart Solr server and Tomcat, log in again
and continue to configure Metacat. The instructions for adding users to groups can be found in the
Tomcat And Solr User Management part of the `Solr installation page`_.îh]î(h1åUIf you click the Create button to create the Solr core and get an error message
like îÖîÅî}î(håUIf you click the Create button to create the Solr core and get an error message
like îh!j��hhh"Nh Nubjí��)Åî}î(hå@``Couldn't persist core properties to /var/metacat/solr-home2/``îh]îh1å<Couldn't persist core properties to /var/metacat/solr-home2/îÖîÅî}î(hhh!j��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j��ubh1XJ��, this means
the solr user doesn’t have the write permission to the Solr Home directory. You need
to add the solr user to the tomcat group, restart Solr server and Tomcat, log in again
and continue to configure Metacat. The instructions for adding users to groups can be found in the
Tomcat And Solr User Management part of the îÖîÅî}î(hXH��, this means
the solr user doesn't have the write permission to the Solr Home directory. You need
to add the solr user to the tomcat group, restart Solr server and Tomcat, log in again
and continue to configure Metacat. The instructions for adding users to groups can be found in the
Tomcat And Solr User Management part of the îh!j��hhh"Nh Nubha)Åî}î(hå`Solr installation page`_îh]îh1åSolr installation pageîÖîÅî}î(hhh!j+��ubah}î(h]îh]îh]îh]îh]îånameîåSolr installation pageîhhuhh`h!j��j…��Kubh1å.îÖîÅî}î(hjã��h!j��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Mâh!j›��hhubeh}î(h]îj≤��ah]îh]îåtroubleshootingîah]îh]îuhh%h!jë��hhh"h#h MÑubeh}î(h]îjí��ah]îh]îåsolr server configurationîah]îh]îuhh%h!j˙��hhh"h#h Mtubh&)Åî}î(hhh]î(h+)Åî}î(hjÿ��h]îh1åGeoserver ConfigurationîÖîÅî}î(hjÿ��h!jV��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j€��uhh*h!jS��hhh"h#h Mëubh�åsidebarîìî)Åî}î(hXπ��Alternatively, you can change the Geoserver username and password manually by
directly logging in to the Geoserver. To configure the credentials manually:

1. Go to the Geoserver admin page: http://<your_context_url>/geoserver/
2. Log in using the default username and password ( admin / geoserver )
3. Navigate to the Password Change Page.  Enter a new user and password and click Submit.
4. Click Apply then Save to save your new password.îh]î(h+)Åî}î(håManual Geoserver Updateîh]îh1åManual Geoserver UpdateîÖîÅî}î(hjk��h!ji��ubah}î(h]îh]îh]îh]îh]îuhh*h!je��ubh\)Åî}î(håöAlternatively, you can change the Geoserver username and password manually by
directly logging in to the Geoserver. To configure the credentials manually:îh]îh1åöAlternatively, you can change the Geoserver username and password manually by
directly logging in to the Geoserver. To configure the credentials manually:îÖîÅî}î(hjy��h!jw��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Mîh!je��ubj‘��)Åî}î(hhh]î(hW)Åî}î(håDGo to the Geoserver admin page: http://<your_context_url>/geoserver/îh]îh\)Åî}î(hjä��h]î(h1å Go to the Geoserver admin page: îÖîÅî}î(hå Go to the Geoserver admin page: îh!jå��ubha)Åî}î(håhttp:/îh]îh1åhttp:/îÖîÅî}î(hhh!jî��ubah}î(h]îh]îh]îh]îh]îårefuriîjñ��uhh`h!jå��ubh1å/<your_context_url>/geoserver/îÖîÅî}î(hå/<your_context_url>/geoserver/îh!jå��ubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Móh!jà��ubah}î(h]îh]îh]îh]îh]îuhhVh!jÖ��ubhW)Åî}î(håDLog in using the default username and password ( admin / geoserver )îh]îh\)Åî}î(hj∂��h]îh1åDLog in using the default username and password ( admin / geoserver )îÖîÅî}î(hj∂��h!j∏��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Mòh!j¥��ubah}î(h]îh]îh]îh]îh]îuhhVh!jÖ��ubhW)Åî}î(håVNavigate to the Password Change Page.  Enter a new user and password and click Submit.îh]îh\)Åî}î(hjÕ��h]îh1åVNavigate to the Password Change Page.  Enter a new user and password and click Submit.îÖîÅî}î(hjÕ��h!jœ��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Môh!jÀ��ubah}î(h]îh]îh]îh]îh]îuhhVh!jÖ��ubhW)Åî}î(hå0Click Apply then Save to save your new password.îh]îh\)Åî}î(hj‰��h]îh1å0Click Apply then Save to save your new password.îÖîÅî}î(hj‰��h!jÊ��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Möh!j‚��ubah}î(h]îh]îh]îh]îh]îuhhVh!jÖ��ubeh}î(h]îh]îh]îh]îh]îj
��j��j��hj
��jã��uhj”��h!je��ubeh}î(h]îh]îh]îh]îh]îuhjc��h!jS��hhh"Nh Nubh\)Åî}î(hXá��Metacat comes bundled with a Web Mapping Service called Geoserver, which
converts spatial data into Web-deliverable map images. Geoserver installs with
a default administrative username and password. *We highly recommend that you
change the default credentials so that only local administrators can make
changes to your Geoserver.* For more information about Geoserver,
see :doc:`geoserver`.îh]î(h1å»Metacat comes bundled with a Web Mapping Service called Geoserver, which
converts spatial data into Web-deliverable map images. Geoserver installs with
a default administrative username and password. îÖîÅî}î(hå»Metacat comes bundled with a Web Mapping Service called Geoserver, which
converts spatial data into Web-deliverable map images. Geoserver installs with
a default administrative username and password. îh!j��hhh"Nh Nubh�åemphasisîìî)Åî}î(håÉ*We highly recommend that you
change the default credentials so that only local administrators can make
changes to your Geoserver.*îh]îh1åÅWe highly recommend that you
change the default credentials so that only local administrators can make
changes to your Geoserver.îÖîÅî}î(hhh!j��ubah}î(h]îh]îh]îh]îh]îuhj��h!j��ubh1å+ For more information about Geoserver,
see îÖîÅî}î(hå+ For more information about Geoserver,
see îh!j��hhh"Nh Nubj˚��)Åî}î(hå:doc:`geoserver`îh]îj��)Åî}î(hj%��h]îh1å	geoserverîÖîÅî}î(hhh!j'��ubah}î(h]îh]î(j��åstdîåstd-docîeh]îh]îh]îuhj���h!j#��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîj1��årefexplicitîâj��å	geoserverîj��j��j ��àuhj˙��h"h#h Múh!j��ubh1å.îÖîÅî}î(hjã��h!j��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Múh!jS��hhubh\)Åî}î(hX’��When you choose the Geoserver Configuration link from the main configuration
screen, Metacat will prompt you for a few important details about your Geoserver
installation. The data directory and context settings allow Geoserver and
Metacat to share the same spatial data store and render maps within Metacat skins.
The security configuration prompts for a new admin password. After you enter
the new settings, Metacat writes the information to the Geoserver deployment.îh]îh1X’��When you choose the Geoserver Configuration link from the main configuration
screen, Metacat will prompt you for a few important details about your Geoserver
installation. The data directory and context settings allow Geoserver and
Metacat to share the same spatial data store and render maps within Metacat skins.
The security configuration prompts for a new admin password. After you enter
the new settings, Metacat writes the information to the Geoserver deployment.îÖîÅî}î(hjM��h!jK��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h M£h!jS��hhubh\)Åî}î(hXá��The default settings are typically appropriate for most Metacat deployments,
but if you wish to skip the Geoserver configuration, click the Bypass button.
Geoserver (if deployed) will remain with a default configuration and the main
Metacat configuration screen will display the "bypassed" status beside the
Geoserver settings. You will be able to run Metacat, but maps will not be
rendered.îh]îh1Xã��The default settings are typically appropriate for most Metacat deployments,
but if you wish to skip the Geoserver configuration, click the Bypass button.
Geoserver (if deployed) will remain with a default configuration and the main
Metacat configuration screen will display the “bypassed” status beside the
Geoserver settings. You will be able to run Metacat, but maps will not be
rendered.îÖîÅî}î(hj[��h!jY��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h M™h!jS��hhubj��)Åî}î(hhh]î(j��)Åî}î(håY.. figure:: images/screenshots/image031.png
   :align: center

   Configuring Geoserver.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image031.pngîj ��}îj"��ju��suhj��h!jg��h"h#h M¥ubj$��)Åî}î(håConfiguring Geoserver.îh]îh1åConfiguring Geoserver.îÖîÅî}î(hjy��h!jw��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h M¥h!jg��ubeh}î(h]îåid13îah]îh]îh]îh]îj:��åcenterîuhj
��h M¥h!jS��hhh"h#ubeh}î(h]îj·��ah]îh]îågeoserver configurationîah]îh]îuhh%h!j˙��hhh"h#h Mëubh&)Åî}î(hhh]î(h+)Åî}î(hj˚��h]îh1åDataONE ConfigurationîÖîÅî}î(hj˚��h!jó��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j˛��uhh*h!jî��hhh"h#h M∑ubh\)Åî}î(håÍMetacat can be configured to operate as a Member Node within the DataONE
federation of data repositories.  See :doc:`dataone` for background and details
on DataONE and details about configuring Metacat to act as a DataONE Member Node.îh]î(h1åoMetacat can be configured to operate as a Member Node within the DataONE
federation of data repositories.  See îÖîÅî}î(håoMetacat can be configured to operate as a Member Node within the DataONE
federation of data repositories.  See îh!j§��hhh"Nh Nubj˚��)Åî}î(hå:doc:`dataone`îh]îj��)Åî}î(hjØ��h]îh1ådataoneîÖîÅî}î(hhh!j±��ubah}î(h]îh]î(j��åstdîåstd-docîeh]îh]îh]îuhj���h!j≠��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîjª��årefexplicitîâj��ådataoneîj��j��j ��àuhj˙��h"h#h M∏h!j§��ubh1åm for background and details
on DataONE and details about configuring Metacat to act as a DataONE Member Node.îÖîÅî}î(håm for background and details
on DataONE and details about configuring Metacat to act as a DataONE Member Node.îh!j§��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h M∏h!jî��hhubeh}î(h]îj��ah]îh]îådataone configurationîah]îh]îuhh%h!j˙��hhh"h#h M∑ubh&)Åî}î(hhh]î(h+)Åî}î(hj��h]îh1åReplication ConfigurationîÖîÅî}î(hj��h!j‡��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<j!��uhh*h!j›��hhh"h#h MΩubh\)Åî}î(hXô��Metacat can be configured to replicate its metadata and/or data content to another
Metacat instance for backup and redundancy purposes, as well as to share data across
sites.  This feature has been used to create the Knowledge Network for Biocomplexity
(KNB), as well as other networks.  See :doc:`replication` for details on
the replication system and how to configure Metacat to replicate with another node.îh]î(h1X$��Metacat can be configured to replicate its metadata and/or data content to another
Metacat instance for backup and redundancy purposes, as well as to share data across
sites.  This feature has been used to create the Knowledge Network for Biocomplexity
(KNB), as well as other networks.  See îÖîÅî}î(hX$��Metacat can be configured to replicate its metadata and/or data content to another
Metacat instance for backup and redundancy purposes, as well as to share data across
sites.  This feature has been used to create the Knowledge Network for Biocomplexity
(KNB), as well as other networks.  See îh!jÌ��hhh"Nh Nubj˚��)Åî}î(hå:doc:`replication`îh]îj��)Åî}î(hj¯��h]îh1åreplicationîÖîÅî}î(hhh!j˙��ubah}î(h]îh]î(j��åstdîåstd-docîeh]îh]îh]îuhj���h!jˆ��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîj��årefexplicitîâj��åreplicationîj��j��j ��àuhj˙��h"h#h Mæh!jÌ��ubh1åc for details on
the replication system and how to configure Metacat to replicate with another node.îÖîÅî}î(håc for details on
the replication system and how to configure Metacat to replicate with another node.îh!jÌ��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Mæh!j›��hhubjÙ��)Åî}î(hX“��Note that much of the functionality provided by the replication subsystem in Metacat
has now been generalized and standardized by DataONE, so consider utilizing the
DataONE services for replication as it is a more general and standardized approach
than this Metacat-specific replication system.  The Metacat replication system
will be supported for a while longer, but will likely be deprecated in a future
release in favor of using the DataONE replication approach.îh]îh\)Åî}î(hX“��Note that much of the functionality provided by the replication subsystem in Metacat
has now been generalized and standardized by DataONE, so consider utilizing the
DataONE services for replication as it is a more general and standardized approach
than this Metacat-specific replication system.  The Metacat replication system
will be supported for a while longer, but will likely be deprecated in a future
release in favor of using the DataONE replication approach.îh]îh1X“��Note that much of the functionality provided by the replication subsystem in Metacat
has now been generalized and standardized by DataONE, so consider utilizing the
DataONE services for replication as it is a more general and standardized approach
than this Metacat-specific replication system.  The Metacat replication system
will be supported for a while longer, but will likely be deprecated in a future
release in favor of using the DataONE replication approach.îÖîÅî}î(hj%��h!j#��ubah}î(h]îh]îh]îh]îh]îuhh[h"h#h M∆h!j��ubah}î(h]îh]îh]îh]îh]îuhjÛ��h!j›��hhh"h#h Nubeh}î(h]îj'��ah]îh]îåreplication configurationîah]îh]îuhh%h!j˙��hhh"h#h MΩubh&)Åî}î(hhh]î(h+)Åî}î(hjA��h]îh1åEZID ConfigurationîÖîÅî}î(hjA��h!jA��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<jD��uhh*h!j>��hhh"h#h MŒubh\)Åî}î(hX��Metacat can be configured to assign Digital Object Identifiers (DOIs) to metadata/data objects
through a EZID service. Click a blue question-mark icon beside any setting for detailed instructions.
More information about each property is also included in the :doc:`metacat-properties`.îh]î(h1X��Metacat can be configured to assign Digital Object Identifiers (DOIs) to metadata/data objects
through a EZID service. Click a blue question-mark icon beside any setting for detailed instructions.
More information about each property is also included in the îÖîÅî}î(hX��Metacat can be configured to assign Digital Object Identifiers (DOIs) to metadata/data objects
through a EZID service. Click a blue question-mark icon beside any setting for detailed instructions.
More information about each property is also included in the îh!jN��hhh"Nh Nubj˚��)Åî}î(hå:doc:`metacat-properties`îh]îj��)Åî}î(hjY��h]îh1åmetacat-propertiesîÖîÅî}î(hhh!j[��ubah}î(h]îh]î(j��åstdîåstd-docîeh]îh]îh]îuhj���h!jW��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîje��årefexplicitîâj��åmetacat-propertiesîj��j��j ��àuhj˙��h"h#h Mœh!jN��ubh1å.îÖîÅî}î(hjã��h!jN��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h Mœh!j>��hhubj��)Åî}î(hhh]î(j��)Åî}î(hå\.. figure:: images/screenshots/image072.png
   :align: center

   Configuring EZID service.
îh]îh}î(h]îh]îh]îh]îh]îåuriîåimages/screenshots/image072.pngîj ��}îj"��jç��suhj��h!j��h"h#h M÷ubj$��)Åî}î(håConfiguring EZID service.îh]îh1åConfiguring EZID service.îÖîÅî}î(hjë��h!jè��ubah}î(h]îh]îh]îh]îh]îuhj#��h"h#h M÷h!j��ubeh}î(h]îåid14îah]îh]îh]îh]îj:��åcenterîuhj
��h M÷h!j>��hhh"h#ubeh}î(h]îjJ��ah]îh]îåezid configurationîah]îh]îuhh%h!j˙��hhh"h#h MŒubeh}î(h]îjH��ah]îh]îårequired configurationîah]îh]îuhh%h!h'hhh"h#h K®ubh&)Åî}î(hhh]î(h+)Åî}î(hjp��h]îh1åAdditional ConfigurationîÖîÅî}î(hjp��h!j∂��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<js��uhh*h!j≥��hhh"h#h MŸubh\)Åî}î(hXÍ��The most dynamic Metacat properties are managed and modified with the
form-based Metacat Configuration utility. These configuration properties can
also be accessed directly (along with additional static properties) via
Metacat's property files: ``metacat.properties`` (which contains global
properties, e.g., authorization and database values) and
``<SKIN_NAME>.properties`` (which contains skin-specific properties). Each of
these property files is discussed in more depth in this section.îh]î(h1å˜The most dynamic Metacat properties are managed and modified with the
form-based Metacat Configuration utility. These configuration properties can
also be accessed directly (along with additional static properties) via
Metacat‚Äôs property files: îÖîÅî}î(håıThe most dynamic Metacat properties are managed and modified with the
form-based Metacat Configuration utility. These configuration properties can
also be accessed directly (along with additional static properties) via
Metacat's property files: îh!j√��hhh"Nh Nubjí��)Åî}î(hå``metacat.properties``îh]îh1åmetacat.propertiesîÖîÅî}î(hhh!jÃ��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j√��ubh1åQ (which contains global
properties, e.g., authorization and database values) and
îÖîÅî}î(håQ (which contains global
properties, e.g., authorization and database values) and
îh!j√��hhh"Nh Nubjí��)Åî}î(hå``<SKIN_NAME>.properties``îh]îh1å<SKIN_NAME>.propertiesîÖîÅî}î(hhh!jfl��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j√��ubh1åt (which contains skin-specific properties). Each of
these property files is discussed in more depth in this section.îÖîÅî}î(håt (which contains skin-specific properties). Each of
these property files is discussed in more depth in this section.îh!j√��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h M⁄h!j≥��hhubh&)Åî}î(hhh]î(h+)Åî}î(håThe ``metacat.properties`` fileîh]î(h1åThe îÖîÅî}î(hjê��h!j˚��hhh"Nh Nubjí��)Åî}î(hjï��h]îh1åmetacat.propertiesîÖîÅî}î(hhh!j��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j˚��ubh1å fileîÖîÅî}î(hj•��h!j˚��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îh<j®��uhh*h!j¯��hhh"h#h M„ubh\)Åî}î(hX◊��Metacat's ``metacat.properties`` file contains all of Metacat's global
properties, both the dynamic properties, which are managed with the
Configuration utility, as well as the more static properties, which can only
be modified manually in this file. The ``metacat.properties`` file also contains
optional properties that are only relevant when optional Metacat features
(such as the harvester or replication) are enabled. The `
`metacat.properties file`` is found here::îh]î(h1åMetacat‚Äôs îÖîÅî}î(hå
Metacat's îh!j��hhh"Nh Nubjí��)Åî}î(hå``metacat.properties``îh]îh1åmetacat.propertiesîÖîÅî}î(hhh!j#��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j��ubh1å· file contains all of Metacat‚Äôs global
properties, both the dynamic properties, which are managed with the
Configuration utility, as well as the more static properties, which can only
be modified manually in this file. The îÖîÅî}î(håfl file contains all of Metacat's global
properties, both the dynamic properties, which are managed with the
Configuration utility, as well as the more static properties, which can only
be modified manually in this file. The îh!j��hhh"Nh Nubjí��)Åî}î(hå``metacat.properties``îh]îh1åmetacat.propertiesîÖîÅî}î(hhh!j6��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j��ubh1åò file also contains
optional properties that are only relevant when optional Metacat features
(such as the harvester or replication) are enabled. The `
îÖîÅî}î(håò file also contains
optional properties that are only relevant when optional Metacat features
(such as the harvester or replication) are enabled. The `
îh!j��hhh"Nh Nubh�åtitle_referenceîìî)Åî}î(hå`metacat.properties file``îh]îh1åmetacat.properties file`îÖîÅî}î(hhh!jK��ubah}î(h]îh]îh]îh]îh]îuhjI��h!j��ubh1å is found here:îÖîÅî}î(hå is found here:îh!j��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h M‰h!j¯��hhubjT��)Åî}î(hå(<CONTEXT_DIR>/WEB_INF/metacat.propertiesîh]îh1å(<CONTEXT_DIR>/WEB_INF/metacat.propertiesîÖîÅî}î(hhh!jd��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h MÏh!j¯��hhh"h#ubh\)Åî}î(hXb��Where ``<CONTEXT_DIR>`` is the directory in which the Metacat application code
lives (e.g., ``/var/lib/tomcat7/webapps/metacat``). The path is a combination
of the Web application directory (e.g., ``/var/lib/tomcat7/webapps/``) and
the Metacat context directory (e.g., ``metacat``). Both values depend upon how your
system was set up during installation.îh]î(h1åWhere îÖîÅî}î(håWhere îh!jr��hhh"Nh Nubjí��)Åî}î(hå``<CONTEXT_DIR>``îh]îh1å
<CONTEXT_DIR>îÖîÅî}î(hhh!j{��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jr��ubh1åE is the directory in which the Metacat application code
lives (e.g., îÖîÅî}î(håE is the directory in which the Metacat application code
lives (e.g., îh!jr��hhh"Nh Nubjí��)Åî}î(hå$``/var/lib/tomcat7/webapps/metacat``îh]îh1å /var/lib/tomcat7/webapps/metacatîÖîÅî}î(hhh!jé��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jr��ubh1åE). The path is a combination
of the Web application directory (e.g., îÖîÅî}î(håE). The path is a combination
of the Web application directory (e.g., îh!jr��hhh"Nh Nubjí��)Åî}î(hå``/var/lib/tomcat7/webapps/``îh]îh1å/var/lib/tomcat7/webapps/îÖîÅî}î(hhh!j°��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jr��ubh1å+) and
the Metacat context directory (e.g., îÖîÅî}î(hå+) and
the Metacat context directory (e.g., îh!jr��hhh"Nh Nubjí��)Åî}î(hå``metacat``îh]îh1åmetacatîÖîÅî}î(hhh!j¥��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jr��ubh1åJ). Both values depend upon how your
system was set up during installation.îÖîÅî}î(håJ). Both values depend upon how your
system was set up during installation.îh!jr��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h MÓh!j¯��hhubh\)Åî}î(hå⁄For information about each property and default or example settings, please
see the :doc:`metacat-properties`. Properties that can only be edited manually
in the metacat.properties file are highlighted in the appendix.îh]î(h1åTFor information about each property and default or example settings, please
see the îÖîÅî}î(håTFor information about each property and default or example settings, please
see the îh!jÕ��hhh"Nh Nubj˚��)Åî}î(hå:doc:`metacat-properties`îh]îj��)Åî}î(hjÿ��h]îh1åmetacat-propertiesîÖîÅî}î(hhh!j⁄��ubah}î(h]îh]î(j��åstdîåstd-docîeh]îh]îh]îuhj���h!j÷��ubah}î(h]îh]îh]îh]îh]îåreftypeîådocîå	refdomainîj‰��årefexplicitîâj��åmetacat-propertiesîj��j��j ��àuhj˙��h"h#h MÙh!jÕ��ubh1åm. Properties that can only be edited manually
in the metacat.properties file are highlighted in the appendix.îÖîÅî}î(håm. Properties that can only be edited manually
in the metacat.properties file are highlighted in the appendix.îh!jÕ��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h MÙh!j¯��hhubeh}î(h]îjÆ��ah]îh]îåthe metacat.properties fileîah]îh]îuhh%h!j≥��hhh"h#h M„ubh&)Åî}î(hhh]î(h+)Åî}î(hj»��h]îh1å<SKIN_NAME>.propertiesîÖîÅî}î(hj»��h!j	��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<jÀ��uhh*h!j��hhh"h#h M˘ubh\)Åî}î(hå†The ``<SKIN_NAME>.properties`` file contains skin-specific properties
(e.g., template information). For each skin, the skin-specific properties are
found here::îh]î(h1åThe îÖîÅî}î(håThe îh!j��hhh"Nh Nubjí��)Åî}î(hå``<SKIN_NAME>.properties``îh]îh1å<SKIN_NAME>.propertiesîÖîÅî}î(hhh!j��ubah}î(h]îh]îh]îh]îh]îuhjë��h!j��ubh1åÅ file contains skin-specific properties
(e.g., template information). For each skin, the skin-specific properties are
found here:îÖîÅî}î(håÅ file contains skin-specific properties
(e.g., template information). For each skin, the skin-specific properties are
found here:îh!j��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h M˙h!j��hhubjT��)Åî}î(hå<<CONTEXT_DIR>/style/skins/<SKIN_NAME>/<SKIN_NAME>.propertiesîh]îh1å<<CONTEXT_DIR>/style/skins/<SKIN_NAME>/<SKIN_NAME>.propertiesîÖîÅî}î(hhh!j8��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h M˛h!j��hhh"h#ubh\)Åî}î(hå¥Where ``<CONTEXT_DIR>`` is the directory in which the Metacat application code
lives (described above) and ``<SKIN_NAME>`` is the name of the skin
(e.g., ``default`` or ``nceas``).îh]î(h1åWhere îÖîÅî}î(håWhere îh!jF��hhh"Nh Nubjí��)Åî}î(hå``<CONTEXT_DIR>``îh]îh1å
<CONTEXT_DIR>îÖîÅî}î(hhh!jO��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jF��ubh1åT is the directory in which the Metacat application code
lives (described above) and îÖîÅî}î(håT is the directory in which the Metacat application code
lives (described above) and îh!jF��hhh"Nh Nubjí��)Åî}î(hå``<SKIN_NAME>``îh]îh1å<SKIN_NAME>îÖîÅî}î(hhh!jb��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jF��ubh1å  is the name of the skin
(e.g., îÖîÅî}î(hå  is the name of the skin
(e.g., îh!jF��hhh"Nh Nubjí��)Åî}î(hå``default``îh]îh1ådefaultîÖîÅî}î(hhh!ju��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jF��ubh1å or îÖîÅî}î(hå or îh!jF��hhh"Nh Nubjí��)Åî}î(hå	``nceas``îh]îh1ånceasîÖîÅî}î(hhh!jà��ubah}î(h]îh]îh]îh]îh]îuhjë��h!jF��ubh1å).îÖîÅî}î(hå).îh!jF��hhh"Nh Nubeh}î(h]îh]îh]îh]îh]îuhh[h"h#h M�h!j��hhubeh}î(h]îj—��ah]îh]îå<skin_name>.propertiesîah]îh]îuhh%h!j≥��hhh"h#h M˘ubh&)Åî}î(hhh]î(h+)Åî}î(hjÎ��h]îh1å%Additional configuration for Tomcat 7îÖîÅî}î(hjÎ��h!j´��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îh<jÓ��uhh*h!j®��hhh"h#h Mubh\)Åî}î(hX~��When running Metacat on Tomcat 7, you may get the following
error logging in via the Morpho application: "Fatal error sending data to Metacat: Bad Set_Cookie header:JSESSIONID=...".
In order to fix the issue, modify <Catalina_HOME>/conf/context.xml
(e.g., /var/lib/tomcat7/conf/context.xml) by adding a new attribute - "useHttpOnly" - and set it to false for the "Context" element::îh]îh1Xâ��When running Metacat on Tomcat 7, you may get the following
error logging in via the Morpho application: “Fatal error sending data to Metacat: Bad Set_Cookie header:JSESSIONID=…”.
In order to fix the issue, modify <Catalina_HOME>/conf/context.xml
(e.g., /var/lib/tomcat7/conf/context.xml) by adding a new attribute - ‚ÄúuseHttpOnly‚Äù - and set it to false for the ‚ÄúContext‚Äù element:îÖîÅî}î(hX}��When running Metacat on Tomcat 7, you may get the following
error logging in via the Morpho application: "Fatal error sending data to Metacat: Bad Set_Cookie header:JSESSIONID=...".
In order to fix the issue, modify <Catalina_HOME>/conf/context.xml
(e.g., /var/lib/tomcat7/conf/context.xml) by adding a new attribute - "useHttpOnly" - and set it to false for the "Context" element:îh!j∏��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h Mh!j®��hhubjT��)Åî}î(hå<Context useHttpOnly="false">îh]îh1å<Context useHttpOnly="false">îÖîÅî}î(hhh!j«��ubah}î(h]îh]îh]îh]îh]îjc��jd��uhjS��h Mh!j®��hhh"h#ubh\)Åî}î(håThen restart Tomcat 7.îh]îh1åThen restart Tomcat 7.îÖîÅî}î(hj◊��h!j’��hhh"Nh Nubah}î(h]îh]îh]îh]îh]îuhh[h"h#h M
h!j®��hhubeh}î(h]îjÙ��ah]îh]îå%additional configuration for tomcat 7îah]îh]îuhh%h!j≥��hhh"h#h Mubeh}î(h]îjy��ah]îh]îåadditional configurationîah]îh]îuhh%h!h'hhh"h#h MŸubeh}î(h]îhpah]îh]îåconfiguring metacatîah]îh]îuhh%h!hhhh"h#h Kubeh}î(h]îh]îh]îh]îh]îåsourceîh#uhhåcurrent_sourceîNåcurrent_lineîNåsettingsîådocutils.frontendîåValuesîìî)Åî}î(h*Nå	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î}î(å<changing authentication configuration without authenticationî]îjπ��aåsolr installation pageî]î(j��j+��euårefidsî}îånameidsî}î(hhjı��hpj%��j!��jû��hêj@��h∞åauthentication configurationîNjó��hˆj˜��j%��j∞��jH��jB��jh��j7��jÆ��j:
��jŒ��j0��jÒ��jé��j ��j
��j@��já��jc��jP��jí��jI��j≤��jë��j·��j⁄��j��j;��j'��j©��jJ��jÓ��jy��j��jÆ��j•��j—��jÁ��jÙ��uå	nametypesî}î(hàjı��Nj%��Njû��Nj@��Nj]��Njó��Nj˜��Nj∞��NjB��Nj7��Nj:
��Nj0��Nj�Nj
��Njá��NjP��NjI��Një��Nj⁄��Nj;��Nj©��NjÓ��Nj��Nj•��NjÁ��Nuh}î(hhhph'j!��h@hêj†��h∞j’��h”jC��hˆjß��j%��j°��jH��j˙��jh��j≈	��jã��jE��jÆ��ji��jŒ��já��jÒ��j=
��j ��j:��j@��j�jc��j
��jí��jë��j≤��j›��j·��jS��j��jî��j'��j›��jJ��j>��jy��j≥��jÆ��j¯��j—��j��jÙ��j®��j5��j��jt��jT��jö��jz��jÌ��jÕ��jL��j��jø	��jü	��j&
��j
��j0
��j
��j„
��j√
��jœ��jØ��jo��jO��já��jg��jü��j��h=hbhähÄh™h†hÕh√hhÊj��j��jB��j8��jb��jX��jÖ��j{��j®��jû��j»��jæ��jÎ��j·��j��j��j:��j0��j]��jS��jå��jÇ��j¨��j¢��j€��j—��j˛��jÙ��j!��j��jD��j:��js��ji��j®��jâ��jÀ��j¡��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î]î(h�åsystem_messageîìî)Åî}î(hhh]îh\)Åî}î(hå:Enumerated list start value not ordinal-1: "2" (ordinal 2)îh]îh1å>Enumerated list start value not ordinal-1: ‚Äú2‚Äù (ordinal 2)îÖîÅî}î(hhh!j{��ubah}î(h]îh]îh]îh]îh]îuhh[h!jx��ubah}î(h]îh]îh]îh]îh]îålevelîKåtypeîåINFOîåsourceîh#ålineîKuhjv��h!jß��hhh"h#h Kåubjw��)Åî}î(hhh]îh\)Åî}î(hå:Enumerated list start value not ordinal-1: "3" (ordinal 3)îh]îh1å>Enumerated list start value not ordinal-1: ‚Äú3‚Äù (ordinal 3)îÖîÅî}î(hhh!jó��ubah}î(h]îh]îh]îh]îh]îuhh[h!jî��ubah}î(h]îh]îh]îh]îh]îålevelîKåtypeîjë��åsourceîh#ålineîKuhjv��h!jß��hhh"h#h Kïubjw��)Åî}î(hhh]îh\)Åî}î(hå?Duplicate implicit target name: "authentication configuration".îh]îh1åCDuplicate implicit target name: ‚Äúauthentication configuration‚Äù.îÖîÅî}î(hhh!j≤��ubah}î(h]îh]îh]îh]îh]îuhh[h!jØ��ubah}î(h]îh]îh]îh]îh]îjã��aålevelîKåtypeîjë��åsourceîh#ålineîMuhjv��h!jE��hhh"h#h Mubeåtransform_messagesî]îåtransformerîNå
decorationîNhhub.