€•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!hubah}”(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Œ.properties”…””}”(hŒ.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!jÞubah}”(h]”h]”h]”h]”h]”uhhVh!j€ubeh}”(h]”h]”h]”h]”h]”uhhQh!jcubeh}”(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.”…””}”(hj8h!j6hhh"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!jDhhh"Nh Nubah}”(h]”h]”h]”h]”h]”uhh[h"h#h Kh!h'hhubhŒ literal_block”“”)”}”(hŒhttp://”h]”h1Œhttp://”…””}”(hhh!jUubah}”(h]”h]”h]”h]”h]”Œ xml:space”Œpreserve”uhjSh Kh!h'hhh"h#ubh\)”}”(hŒöWhere 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 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 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!jehhh"Nh Nubha)”}”(hŒ!http://knb.ecoinformatics.org/knb”h]”h1Œ!http://knb.ecoinformatics.org/knb”…””}”(hhh!jnubah}”(h]”h]”h]”h]”h]”Œrefuri”jpuhh`h!jeubeh}”(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:///admin”h]”h1Œhttp:///admin”…””}”(hhh!j’ubah}”(h]”h]”h]”h]”h]”jcjduhjSh Kh!h'hhh"h#ubh&)”}”(hhh]”(h+)”}”(hh‡h]”h1ŒInitial Configuration”…””}”(hh‡h!j£hhh"Nh Nubah}”(h]”h]”h]”h]”h]”h/admin”h]”h1Œhttp:///admin”…””}”(hhh!jbubah}”(h]”h]”h]”h]”h]”jcjduhjSh KDh!jChhh"h#ubh\)”}”(hXMetacat 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]”(h1XMetacat 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 ”…””}”(hXMetacat 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!jphhh"Nh Nubj’)”}”(hŒ``AuthInterface``”h]”h1Œ AuthInterface”…””}”(hhh!jyubah}”(h]”h]”h]”h]”h]”uhj‘h!jpubh1Œ.”…””}”(hŒ.”h!jphhh"Nh Nubeh}”(h]”h]”h]”h]”h]”uhh[h"h#h KFh!jChhubh\)”}”(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!jChhubhŒ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]”jcjduhjSh KQh!j¢ubah}”(h]”h]”h]”h]”h]”uhj h!jChhh"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!jChhubj¡)”}”(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]”jcjduhjSh KZh!jÇubah}”(h]”h]”h]”h]”h]”uhj h!jChhh"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!jÞhhh"Nh Nubah}”(h]”h]”h]”h]”h]”uhh[h"h#h Kah!jChhubjô)”}”(hXTo 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\)”}”(hXTo 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!jubah}”(h]”h]”(Œxref”Œstd”Œstd-doc”eh]”h]”h]”uhjh!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!jChhh"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.”…””}”(hjHh!jFhhh"Nh Nubah}”(h]”h]”h]”h]”h]”uhh[h"h#h Klh!jChhubj)”}”(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"jbsuhjh!jTh"h#h Krubj$)”}”(hŒ0Configuring Password File Authentication Values.”h]”h1Œ0Configuring Password File Authentication Values.”…””}”(hjfh!jdubah}”(h]”h]”h]”h]”h]”uhj#h"h#h Krh!jTubeh}”(h]”Œid3”ah]”h]”h]”h]”j:Œcenter”uhj h Krh!jChhh"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ˆsuhjh!jzh"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!jzubeh}”(h]”Œid4”ah]”h]”h]”h]”j:Œcenter”uhj h Kwh!jChhh"h#ubeh}”(h]”hÓah]”h]”h]”Œauthentication configuration”ah]”uhh%h!j hhh"h#h K?h$Kubh&)”}”(hhh]”(h+)”}”(hhíh]”h1Œ//WEB-INF/metacat.properties”h]”h1Œ9//WEB-INF/metacat.properties”…””}”(hhh!jubah}”(h]”h]”h]”h]”h]”jcjduhjSh KŠh!jubah}”(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 jjhj 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!jJubah}”(h]”h]”h]”h]”h]”jcjduhjSh Kh!jGubah}”(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!jeubj’)”}”(hŒ``metacat.properties``”h]”h1Œmetacat.properties”…””}”(hhh!jnubah}”(h]”h]”h]”h]”h]”uhj‘h!jeubh1Œ file and start Tomcat.”…””}”(hŒ file and start Tomcat.”h!jeubeh}”(h]”h]”h]”h]”h]”uhh[h"h#h K•h!jaubah}”(h]”h]”h]”h]”h]”uhhVh!j^hhh"h#h Nubah}”(h]”h]”h]”h]”h]”j jjhj j‹jFKuhjÓh!j§hhh"h#h K•ubeh}”(h]”höah]”h]”Œ 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 default``”h]”h1ŒMake 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]”uhjh!j› ubah}”(h]”h]”h]”h]”h]”Œreftype”Œdoc”Œ refdomain”j© Œrefexplicit”‰jŒthemes”jjj ˆ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Ñ suhjh!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\)”}”(hXSelect the checkbox next to your customized skin or and click the ``Make 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 default``”h]”h1ŒMake 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!jubah}”(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!jhhh"Nh Nubah}”(h]”h]”h]”h]”h]”uhh[h"h#h M>h!j= hhubeh}”(h]”jñah]”h]”Œskins”ah]”h]”uhh%h!jihhh"h#h M'ubeh}”(h]”j®ah]”h]”Œskins configuration”ah]”h]”uhh%h!júhhh"h#h M ubh&)”}”(hhh]”(h+)”}”(hjh]”h1ŒDatabase Configuration”…””}”(hjh!j=hhh"Nh Nubah}”(h]”h]”h]”h]”h]”h.. figure:: images/screenshots/image073.png :align: center ”h]”h}”(h]”h]”h]”h]”h]”Œuri”Œimages/screenshots/image073.png”j }”j"j½suhjh!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 Mh!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/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”…””}”(hjkh!jiubah}”(h]”h]”h]”h]”h]”uhh*h!jeubh\)”}”(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:”…””}”(hjyh!jwubah}”(h]”h]”h]”h]”h]”uhh[h"h#h M”h!jeubjÔ)”}”(hhh]”(hW)”}”(hŒDGo to the Geoserver admin page: http:///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Œ//geoserver/”…””}”(hŒ//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 jjhj j‹uhjÓh!jeubeh}”(h]”h]”h]”h]”h]”uhjch!jShhh"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!jhhh"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!jubah}”(h]”h]”h]”h]”h]”uhjh!jubh1Œ+ For more information about Geoserver, see ”…””}”(hŒ+ For more information about Geoserver, see ”h!jhhh"Nh Nubjû)”}”(hŒ:doc:`geoserver`”h]”j)”}”(hj%h]”h1Œ geoserver”…””}”(hhh!j'ubah}”(h]”h]”(jŒstd”Œstd-doc”eh]”h]”h]”uhjh!j#ubah}”(h]”h]”h]”h]”h]”Œreftype”Œdoc”Œ refdomain”j1Œrefexplicit”‰jŒ geoserver”jjj ˆuhjúh"h#h Mœh!jubh1Œ.”…””}”(hj‹h!jhhh"Nh Nubeh}”(h]”h]”h]”h]”h]”uhh[h"h#h Mœh!jShhubh\)”}”(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.”…””}”(hjMh!jKhhh"Nh Nubah}”(h]”h]”h]”h]”h]”uhh[h"h#h M£h!jShhubh\)”}”(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!jYhhh"Nh Nubah}”(h]”h]”h]”h]”h]”uhh[h"h#h Mªh!jShhubj)”}”(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"jusuhjh!jgh"h#h M´ubj$)”}”(hŒConfiguring Geoserver.”h]”h1ŒConfiguring Geoserver.”…””}”(hjyh!jwubah}”(h]”h]”h]”h]”h]”uhj#h"h#h M´h!jgubeh}”(h]”Œid13”ah]”h]”h]”h]”j:Œcenter”uhj h M´h!jShhh"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]”hhhh"h#h MÎubh\)”}”(hXMetacat 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]”(h1XMetacat 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 ”…””}”(hXMetacat 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!jNhhh"Nh Nubjû)”}”(hŒ:doc:`metacat-properties`”h]”j)”}”(hjYh]”h1Œmetacat-properties”…””}”(hhh!j[ubah}”(h]”h]”(jŒstd”Œstd-doc”eh]”h]”h]”uhjh!jWubah}”(h]”h]”h]”h]”h]”Œreftype”Œdoc”Œ refdomain”jeŒrefexplicit”‰jŒmetacat-properties”jjj ˆuhjúh"h#h MÏh!jNubh1Œ.”…””}”(hj‹h!jNhhh"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"jsuhjh!jh"h#h MÖubj$)”}”(hŒConfiguring EZID service.”h]”h1ŒConfiguring EZID service.”…””}”(hj‘h!jubah}”(h]”h]”h]”h]”h]”uhj#h"h#h MÖh!jubeh}”(h]”Œid14”ah]”h]”h]”h]”j:Œcenter”uhj h MÖh!j>hhh"h#ubeh}”(h]”jJah]”h]”Œezid configuration”ah]”h]”uhh%h!júhhh"h#h MÎubeh}”(h]”jHah]”h]”Œrequired configuration”ah]”h]”uhh%h!h'hhh"h#h K¨ubh&)”}”(hhh]”(h+)”}”(hjph]”h1ŒAdditional Configuration”…””}”(hjph!j¶hhh"Nh Nubah}”(h]”h]”h]”h]”h]”h.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Œ``.properties``”h]”h1Œ.properties”…””}”(hhh!jß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 ”…””}”(hjh!jûhhh"Nh Nubj’)”}”(hj•h]”h1Œmetacat.properties”…””}”(hhh!jubah}”(h]”h]”h]”h]”h]”uhj‘h!jûubh1Œ file”…””}”(hj¥h!jûhhh"Nh Nubeh}”(h]”h]”h]”h]”h]”h/WEB_INF/metacat.properties”h]”h1Œ(/WEB_INF/metacat.properties”…””}”(hhh!jdubah}”(h]”h]”h]”h]”h]”jcjduhjSh Mìh!jøhhh"h#ubh\)”}”(hXbWhere ```` 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!jrhhh"Nh Nubj’)”}”(hŒ````”h]”h1Œ ”…””}”(hhh!j{ubah}”(h]”h]”h]”h]”h]”uhj‘h!jrubh1Œ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!jrhhh"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!jrubh1Œ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!jrhhh"Nh Nubj’)”}”(hŒ``/var/lib/tomcat7/webapps/``”h]”h1Œ/var/lib/tomcat7/webapps/”…””}”(hhh!j¡ubah}”(h]”h]”h]”h]”h]”uhj‘h!jrubh1Œ+) and the Metacat context directory (e.g., ”…””}”(hŒ+) and the Metacat context directory (e.g., ”h!jrhhh"Nh Nubj’)”}”(hŒ``metacat``”h]”h1Œmetacat”…””}”(hhh!j´ubah}”(h]”h]”h]”h]”h]”uhj‘h!jrubh1Œ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!jrhhh"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]”uhjh!jÖubah}”(h]”h]”h]”h]”h]”Œreftype”Œdoc”Œ refdomain”jäŒrefexplicit”‰jŒmetacat-properties”jjj ˆ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Œ.properties”…””}”(hjÈh!j hhh"Nh Nubah}”(h]”h]”h]”h]”h]”h.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!jhhh"Nh Nubj’)”}”(hŒ``.properties``”h]”h1Œ.properties”…””}”(hhh!jubah}”(h]”h]”h]”h]”h]”uhj‘h!jubh1Œ 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!jhhh"Nh Nubeh}”(h]”h]”h]”h]”h]”uhh[h"h#h Múh!jhhubjT)”}”(hŒ</style/skins//.properties”h]”h1Œ</style/skins//.properties”…””}”(hhh!j8ubah}”(h]”h]”h]”h]”h]”jcjduhjSh Mþh!jhhh"h#ubh\)”}”(hŒ´Where ```` is the directory in which the Metacat application code lives (described above) and ```` is the name of the skin (e.g., ``default`` or ``nceas``).”h]”(h1ŒWhere ”…””}”(hŒWhere ”h!jFhhh"Nh Nubj’)”}”(hŒ````”h]”h1Œ ”…””}”(hhh!jOubah}”(h]”h]”h]”h]”h]”uhj‘h!jFubh1Œ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!jFhhh"Nh Nubj’)”}”(hŒ````”h]”h1Œ”…””}”(hhh!jbubah}”(h]”h]”h]”h]”h]”uhj‘h!jFubh1Œ is the name of the skin (e.g., ”…””}”(hŒ is the name of the skin (e.g., ”h!jFhhh"Nh Nubj’)”}”(hŒ``default``”h]”h1Œdefault”…””}”(hhh!juubah}”(h]”h]”h]”h]”h]”uhj‘h!jFubh1Œ or ”…””}”(hŒ or ”h!jFhhh"Nh Nubj’)”}”(hŒ ``nceas``”h]”h1Œnceas”…””}”(hhh!jˆubah}”(h]”h]”h]”h]”h]”uhj‘h!jFubh1Œ).”…””}”(hŒ).”h!jFhhh"Nh Nubeh}”(h]”h]”h]”h]”h]”uhh[h"h#h Mh!jhhubeh}”(h]”jÑah]”h]”Œ.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/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 /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 /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Œ”h]”h1Œ”…””}”(hhh!jÇubah}”(h]”h]”h]”h]”h]”jcjduhjSh 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]”jyah]”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”}”(Œjyj³j®jøjÑjjôj¨j5jjtjTjšjzjíjÍjLjj¿ jŸ j& j j0 j jã jÃ jÏj¯jojOj‡jgjŸjh=hbhŠh€hªh hÍhÃhðhæjjjBj8jbjXj…j{j¨jžjÈj¾jëjájjj:j0j]jSjŒj‚j¬j¢jÛjÑjþjôj!jjDj:jsjij¨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!jxubah}”(h]”h]”h]”h]”h]”Œlevel”KŒtype”ŒINFO”Œsource”h#Œline”Kuhjvh!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”Kuhjvh!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”Muhjvh!jEhhh"h#h MubeŒtransform_messages”]”Œtransformer”NŒ decoration”Nhhub.