cdocutils.nodes document q)q}q(U nametypesq}q(Xmetacatui themesqNX&global properties (server, ports, etc)qNXskinsqNX%additional configuration for tomcat 7q NXlogging in to metacatq NXnew installationq NXcontentsq NXupgradeq NXthe metacat.properties fileqNXdatabase configurationqNXezid configurationqNXrequired configurationqNXskins configurationqNXreplication configurationqNX.propertiesqNXinitial configurationqNX<changing authentication configuration without authenticationqNXdataone configurationqNXauthentication configurationqNXadditional configurationqNXconfiguring metacatqNX,geoserver configuration (highly recommended)qNXback-up configurationqNuUsubstitution_defsq}qUparse_messagesq]q (cdocutils.nodes system_message q!)q"}q#(U rawsourceq$UUparentq%cdocutils.nodes section q&)q'}q((h$UU referencedq)Kh%h&)q*}q+(h$Uh%h&)q,}q-(h$Uh%hUsourceq.Xg/var/lib/jenkins/jobs/Metacat_stable/workspace/METACAT_2_8_3/docs/user/metacat/source/configuration.rstq/Utagnameq0Usectionq1U attributesq2}q3(Udupnamesq4]Uclassesq5]Ubackrefsq6]Uidsq7]q8Uconfiguring-metacatq9aUnamesq:]q;hauUlineq]q?(cdocutils.nodes title q@)qA}qB(h$XConfiguring MetacatqCh%h,h.h/h0UtitleqDh2}qE(h7]h6]h4]h5]h:]UrefidqFUid15qGuh]qHcdocutils.nodes Text qIXConfiguring MetacatqJqK}qL(h$hCh%hAubaubcdocutils.nodes topic qM)qN}qO(h$Uh%h,h.h/h0UtopicqPh2}qQ(h4]h5]qRUcontentsqSah6]h7]qTUcontentsqUah:]qVh auh]qW(h@)qX}qY(h$XContentsh2}qZ(h4]h5]h6]h7]h:]uh%hNh>]q[hIXContentsq\q]}q^(h$Uh%hXubah0hDubcdocutils.nodes bullet_list q_)q`}qa(h$Uh%hNh.Nh0U bullet_listqbh2}qc(h4]h5]h6]h7]h:]uh]qdcdocutils.nodes list_item qe)qf}qg(h$Uh2}qh(h4]h5]h6]h7]h:]uh%h`h>]qi(cdocutils.nodes paragraph qj)qk}ql(h$Uh2}qm(h4]h5]h6]h7]h:]uh%hfh>]qncdocutils.nodes reference qo)qp}qq(h$Uh2}qr(h7]qshGah6]h4]h5]h:]Urefidh9uh%hkh>]qthIXConfiguring Metacatquqv}qw(h$hCh%hpubah0U referenceqxubah0U paragraphqyubh_)qz}q{(h$Uh2}q|(h4]h5]h6]h7]h:]uh%hfh>]q}(he)q~}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hzh>]q(hj)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%h~h>]qho)q}q(h$Uh2}q(h7]qUid16qah6]h4]h5]h:]UrefidUinitial-configurationquh%hh>]qhIXInitial Configurationqq}q(h$XInitial Configurationqh%hubah0hxubah0hyubh_)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%h~h>]q(he)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qhj)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qho)q}q(h$Uh2}q(h7]qUid17qah6]h4]h5]h:]UrefidUback-up-configurationquh%hh>]qhIXBack-up Configurationqq}q(h$XBack-up Configurationqh%hubah0hxubah0hyubah0U list_itemqubhe)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qhj)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qho)q}q(h$Uh2}q(h7]qUid18qah6]h4]h5]h:]UrefidUauthentication-configurationquh%hh>]qhIXAuthentication Configurationqq}q(h$XAuthentication Configurationqh%hubah0hxubah0hyubah0hubhe)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qhj)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qho)q}q(h$Uh2}q(h7]qUid19qah6]h4]h5]h:]UrefidU]qhIX<Changing Authentication Configuration without Authenticationq˅q}q(h$X<Changing Authentication Configuration without Authenticationqh%hubah0hxubah0hyubah0hubeh0hbubeh0hubhe)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hzh>]qhj)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qho)q}q(h$Uh2}q(h7]qUid20qah6]h4]h5]h:]UrefidUlogging-in-to-metacatquh%hh>]qhIXLogging in to Metacatqޅq}q(h$XLogging in to Metacatqh%hubah0hxubah0hyubah0hubhe)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hzh>]q(hj)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qho)q}q(h$Uh2}q(h7]qUid21qah6]h4]h5]h:]UrefidUrequired-configurationquh%hh>]qhIXRequired Configurationqq}q(h$XRequired Configurationqh%hubah0hxubah0hyubh_)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]q(he)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]qhj)q}q(h$Uh2}q(h4]h5]h6]h7]h:]uh%hh>]rho)r}r(h$Uh2}r(h7]rUid22rah6]h4]h5]h:]UrefidU"global-properties-server-ports-etcruh%hh>]rhIX&Global Properties (server, ports, etc)rr }r (h$X&Global Properties (server, ports, etc)r h%jubah0hxubah0hyubah0hubhe)r }r (h$Uh2}r(h4]h5]h6]h7]h:]uh%hh>]rhj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%j h>]rho)r}r(h$Uh2}r(h7]rUid23rah6]h4]h5]h:]UrefidUid1ruh%jh>]rhIXAuthentication Configurationrr}r(h$XAuthentication Configurationrh%jubah0hxubah0hyubah0hubhe)r}r (h$Uh2}r!(h4]h5]h6]h7]h:]uh%hh>]r"(hj)r#}r$(h$Uh2}r%(h4]h5]h6]h7]h:]uh%jh>]r&ho)r'}r((h$Uh2}r)(h7]r*Uid24r+ah6]h4]h5]h:]UrefidUskins-configurationr,uh%j#h>]r-hIXSkins Configurationr.r/}r0(h$XSkins Configurationr1h%j'ubah0hxubah0hyubh_)r2}r3(h$Uh2}r4(h4]h5]h6]h7]h:]uh%jh>]r5(he)r6}r7(h$Uh2}r8(h4]h5]h6]h7]h:]uh%j2h>]r9hj)r:}r;(h$Uh2}r<(h4]h5]h6]h7]h:]uh%j6h>]r=ho)r>}r?(h$Uh2}r@(h7]rAUid25rBah6]h4]h5]h:]UrefidUmetacatui-themesrCuh%j:h>]rDhIXMetacatUI ThemesrErF}rG(h$XMetacatUI ThemesrHh%j>ubah0hxubah0hyubah0hubhe)rI}rJ(h$Uh2}rK(h4]h5]h6]h7]h:]uh%j2h>]rLhj)rM}rN(h$Uh2}rO(h4]h5]h6]h7]h:]uh%jIh>]rPho)rQ}rR(h$Uh2}rS(h7]rTUid26rUah6]h4]h5]h:]UrefidUskinsrVuh%jMh>]rWhIXSkinsrXrY}rZ(h$XSkinsr[h%jQubah0hxubah0hyubah0hubeh0hbubeh0hubhe)r\}r](h$Uh2}r^(h4]h5]h6]h7]h:]uh%hh>]r_(hj)r`}ra(h$Uh2}rb(h4]h5]h6]h7]h:]uh%j\h>]rcho)rd}re(h$Uh2}rf(h7]rgUid27rhah6]h4]h5]h:]UrefidUdatabase-configurationriuh%j`h>]rjhIXDatabase Configurationrkrl}rm(h$XDatabase Configurationrnh%jdubah0hxubah0hyubh_)ro}rp(h$Uh2}rq(h4]h5]h6]h7]h:]uh%j\h>]rr(he)rs}rt(h$Uh2}ru(h4]h5]h6]h7]h:]uh%joh>]rvhj)rw}rx(h$Uh2}ry(h4]h5]h6]h7]h:]uh%jsh>]rzho)r{}r|(h$Uh2}r}(h7]r~Uid28rah6]h4]h5]h:]UrefidUnew-installationruh%jwh>]rhIXNew Installationrr}r(h$XNew Installationrh%j{ubah0hxubah0hyubah0hubhe)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%joh>]rhj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rho)r}r(h$Uh2}r(h7]rUid29rah6]h4]h5]h:]UrefidUupgraderuh%jh>]rhIXUpgraderr}r(h$XUpgraderh%jubah0hxubah0hyubah0hubeh0hbubeh0hubhe)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%hh>]rhj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rho)r}r(h$Uh2}r(h7]rUid30rah6]h4]h5]h:]UrefidU*geoserver-configuration-highly-recommendedruh%jh>]rhIX,Geoserver Configuration (Highly Recommended)rr}r(h$X,Geoserver Configuration (Highly Recommended)rh%jubah0hxubah0hyubah0hubhe)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%hh>]rhj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rho)r}r(h$Uh2}r(h7]rUid31rah6]h4]h5]h:]UrefidUdataone-configurationruh%jh>]rhIXDataONE Configurationrr}r(h$XDataONE Configurationrh%jubah0hxubah0hyubah0hubhe)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%hh>]rhj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rho)r}r(h$Uh2}r(h7]rUid32rah6]h4]h5]h:]UrefidUreplication-configurationruh%jh>]rhIXReplication Configurationrr}r(h$XReplication Configurationrh%jubah0hxubah0hyubah0hubhe)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%hh>]rhj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rho)r}r(h$Uh2}r(h7]rUid33rah6]h4]h5]h:]UrefidUezid-configurationruh%jh>]rhIXEZID Configurationrr}r(h$XEZID Configurationrh%jubah0hxubah0hyubah0hubeh0hbubeh0hubhe)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%hzh>]r(hj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rho)r}r(h$Uh2}r(h7]rUid34rah6]h4]h5]h:]UrefidUadditional-configurationruh%jh>]rhIXAdditional Configurationrr}r(h$XAdditional Configurationrh%jubah0hxubah0hyubh_)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]r(he)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rho)r}r(h$Uh2}r(h7]rUid35rah6]h4]h5]h:]UrefidUthe-metacat-properties-filer uh%jh>]r (hIXThe r r }r (h$XThe rh%jubcdocutils.nodes literal r)r}r(h$X``metacat.properties``rh%jh.Nh0Uliteralrh2}r(h4]h5]h6]h7]h:]uh]rhIXmetacat.propertiesrr}r(h$Uh%jubaubhIX filerr}r(h$X filerh%jubeh0hxubah0hyubah0hubhe)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]r hj)r!}r"(h$Uh2}r#(h4]h5]h6]h7]h:]uh%jh>]r$ho)r%}r&(h$Uh2}r'(h7]r(Uid36r)ah6]h4]h5]h:]UrefidUskin-name-propertiesr*uh%j!h>]r+hIX.propertiesr,r-}r.(h$X.propertiesr/h%j%ubah0hxubah0hyubah0hubhe)r0}r1(h$Uh2}r2(h4]h5]h6]h7]h:]uh%jh>]r3hj)r4}r5(h$Uh2}r6(h4]h5]h6]h7]h:]uh%j0h>]r7ho)r8}r9(h$Uh2}r:(h7]r;Uid37r<ah6]h4]h5]h:]UrefidU%additional-configuration-for-tomcat-7r=uh%j4h>]r>hIX%Additional configuration for Tomcat 7r?r@}rA(h$X%Additional configuration for Tomcat 7rBh%j8ubah0hxubah0hyubah0hubeh0hbubeh0hubeh0hbubeh0hubaubeubhj)rC}rD(h$XWhen 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.rEh%h,h.h/h0hyh2}rF(h4]h5]h6]h7]h:]uh]rGhIXWhen 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.rHrI}rJ(h$jEh%jCubaubhj)rK}rL(h$X>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.rMh%h,h.h/h0hyh2}rN(h4]h5]h6]h7]h:]uh]rOhIX>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.rPrQ}rR(h$jMh%jKubaubhj)rS}rT(h$X5To access your Metacat, open a Web browser and type::rUh%h,h.h/h0hyh2}rV(h4]h5]h6]h7]h:]uh]rWhIX4To access your Metacat, open a Web browser and type:rXrY}rZ(h$X4To access your Metacat, open a Web browser and type:h%jSubaubcdocutils.nodes literal_block r[)r\}r](h$Xhttp://h%h,h.h/h0U literal_blockr^h2}r_(U xml:spacer`Upreserverah7]h6]h4]h5]h:]uh]rbhIXhttp://rcrd}re(h$Uh%j\ubaubhj)rf}rg(h$XWhere 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/knbh%h,h.h/h0hyh2}rh(h4]h5]h6]h7]h:]uh]ri(hIXWhere 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: rjrk}rl(h$XWhere 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%jfubho)rm}rn(h$X!http://knb.ecoinformatics.org/knbroh2}rp(Urefurijoh7]h6]h4]h5]h:]uh%jfh>]rqhIX!http://knb.ecoinformatics.org/knbrrrs}rt(h$Uh%jmubah0hxubeubhj)ru}rv(h$XLYou can always open the configuration screen from within Metacat by typing::rwh%h,h.h/h0hyh2}rx(h4]h5]h6]h7]h:]uh]ryhIXKYou can always open the configuration screen from within Metacat by typing:rzr{}r|(h$XKYou can always open the configuration screen from within Metacat by typing:h%juubaubj[)r}}r~(h$Xhttp:///adminh%h,h.h/h0j^h2}r(j`jah7]h6]h4]h5]h:]uh]rhIXhttp:///adminrr}r(h$Uh%j}ubaubh*h&)r}r(h$Uh%h,h.h/h0h1h2}r(h4]h5]h6]h7]rhah:]rh auh]r(h@)r}r(h$hh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFhuh]rhIXLogging in to Metacatrr}r(h$hh%jubaubhj)r}r(h$X!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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX!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.rr}r(h$jh%jubaubhj)r}r(h$XTIn the log-in screen enter your user name and password and click the "Login" button.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXTIn the log-in screen enter your user name and password and click the "Login" button.rr}r(h$jh%jubaubcdocutils.nodes figure r)r}r(h$Uh%jh.h/h0Ufigurerh2}r(UalignrXcenterh7]rUid5rah6]h4]h5]h:]uh]r(cdocutils.nodes image r)r}r(h$XX.. figure:: images/screenshots/image015.png :align: center Logging into Metacat. h%jh.h/h0Uimagerh2}r(UuriXimages/screenshots/image015.pngrh7]h6]h4]h5]U candidatesr}rU*jsh:]uh]ubcdocutils.nodes caption r)r}r(h$XLogging into Metacat.rh%jh.h/h0Ucaptionrh2}r(h4]h5]h6]h7]h:]uh]rhIXLogging into Metacat.rr}r(h$jh%jubaubeubeubh&)r}r(h$Uh%h,h.h/h0h1h2}r(h4]h5]h6]h7]rhah:]rhauh]r(h@)r}r(h$hh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFhuh]rhIXRequired Configurationrr}r(h$hh%jubaubhj)r}r(h$XAll 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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXAll 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.rr}r(h$jh%jubaubj)r}r(h$Uh%jh.h/h0jh2}r(jXcenterh7]rUid6rah6]h4]h5]h:]uh]r(j)r}r(h$X.. 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%jh.h/h0jh2}r(UuriXimages/screenshots/image017.pngrh7]h6]h4]h5]j}rU*jsh:]uh]ubj)r}r(h$XMetacat configuration menu, showing each configuration section. Once all sections are marked as green ``configured``, metacat can be accessed.h%jh.h/h0jh2}r(h4]h5]h6]h7]h:]uh]r(hIXgMetacat configuration menu, showing each configuration section. Once all sections are marked as green rr}r(h$XgMetacat configuration menu, showing each configuration section. Once all sections are marked as green h%jubj)r}r(h$X``configured``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIX configuredrr}r(h$Uh%jubah0jubhIX, metacat can be accessed.rr}r(h$X, metacat can be accessed.h%jubeubeubhj)r}r(h$XThe 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).rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXThe 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).rr}r(h$jh%jubaubcdocutils.nodes table r)r}r(h$Uh%jh.h/h0Utablerh2}r(h4]h5]h6]h7]h:]uh]rcdocutils.nodes tgroup r)r}r(h$Uh2}r(h7]h6]h4]h5]h:]UcolsKuh%jh>]r(cdocutils.nodes colspec r)r}r(h$Uh2}r(h7]h6]h4]h5]h:]UcolwidthKuh%jh>]h0Ucolspecrubj)r}r(h$Uh2}r(h7]h6]h4]h5]h:]UcolwidthK=uh%jh>]h0jubcdocutils.nodes thead r)r }r (h$Uh2}r (h4]h5]h6]h7]h:]uh%jh>]r cdocutils.nodes row r )r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%j h>]r(cdocutils.nodes entry r)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$XStatusrh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXStatusrr}r(h$jh%jubaubah0Uentryrubj)r }r!(h$Uh2}r"(h4]h5]h6]h7]h:]uh%jh>]r#hj)r$}r%(h$X Descriptionr&h%j h.h/h0hyh2}r'(h4]h5]h6]h7]h:]uh]r(hIX Descriptionr)r*}r+(h$j&h%j$ubaubah0jubeh0Urowr,ubah0Utheadr-ubcdocutils.nodes tbody r.)r/}r0(h$Uh2}r1(h4]h5]h6]h7]h:]uh%jh>]r2(j )r3}r4(h$Uh2}r5(h4]h5]h6]h7]h:]uh%j/h>]r6(j)r7}r8(h$Uh2}r9(h4]h5]h6]h7]h:]uh%j3h>]r:hj)r;}r<(h$X unconfiguredr=h%j7h.h/h0hyh2}r>(h4]h5]h6]h7]h:]uh]r?hIX unconfiguredr@rA}rB(h$j=h%j;ubaubah0jubj)rC}rD(h$Uh2}rE(h4]h5]h6]h7]h:]uh%j3h>]rFhj)rG}rH(h$X$The section has yet to be configuredrIh%jCh.h/h0hyh2}rJ(h4]h5]h6]h7]h:]uh]rKhIX$The section has yet to be configuredrLrM}rN(h$jIh%jGubaubah0jubeh0j,ubj )rO}rP(h$Uh2}rQ(h4]h5]h6]h7]h:]uh%j/h>]rR(j)rS}rT(h$Uh2}rU(h4]h5]h6]h7]h:]uh%jOh>]rVhj)rW}rX(h$X configuredrYh%jSh.h/h0hyh2}rZ(h4]h5]h6]h7]h:]uh]r[hIX configuredr\r]}r^(h$jYh%jWubaubah0jubj)r_}r`(h$Uh2}ra(h4]h5]h6]h7]h:]uh%jOh>]rbhj)rc}rd(h$X The section has been configured.reh%j_h.h/h0hyh2}rf(h4]h5]h6]h7]h:]uh]rghIX The section has been configured.rhri}rj(h$jeh%jcubaubah0jubeh0j,ubj )rk}rl(h$Uh2}rm(h4]h5]h6]h7]h:]uh%j/h>]rn(j)ro}rp(h$Uh2}rq(h4]h5]h6]h7]h:]uh%jkh>]rrhj)rs}rt(h$Xbypassedruh%joh.h/h0hyh2}rv(h4]h5]h6]h7]h:]uh]rwhIXbypassedrxry}rz(h$juh%jsubaubah0jubj)r{}r|(h$Uh2}r}(h4]h5]h6]h7]h:]uh%jkh>]r~hj)r}r(h$XBThe administrator can choose not to configure or skip the section.rh%j{h.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXBThe administrator can choose not to configure or skip the section.rr}r(h$jh%jubaubah0jubeh0j,ubeh0Utbodyrubeh0Utgrouprubaubhj)r}r(h$XTo 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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXTo 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.rr}r(h$jh%jubaubhj)r}r(h$XAll 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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXAll 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.rr}r(h$jh%jubaubj)r}r(h$Uh%jh.h/h0jh2}r(jXcenterh7]rUid7rah6]h4]h5]h:]uh]r(j)r}r(h$X.. figure:: images/screenshots/image019.png :align: center The Metacat settings as they appear after having been configured. h%jh.h/h0jh2}r(UuriXimages/screenshots/image019.pngrh7]h6]h4]h5]j}rU*jsh:]uh]ubj)r}r(h$XAThe Metacat settings as they appear after having been configured.rh%jh.h/h0jh2}r(h4]h5]h6]h7]h:]uh]rhIXAThe Metacat settings as they appear after having been configured.rr}r(h$jh%jubaubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rjah:]rhauh]r(h@)r}r(h$j h%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFjuh]rhIX&Global Properties (server, ports, etc)rr}r(h$j h%jubaubhj)r}r(h$XThe 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%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXThe 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 rr}r(h$XThe 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%jubcsphinx.addnodes pending_xref r)r}r(h$X:doc:`metacat-properties`rh%jh.h/h0U pending_xrefrh2}r(UreftypeXdocrUrefwarnrU reftargetrXmetacat-propertiesU refdomainUh7]h6]U refexplicith4]h5]h:]UrefdocrX configurationruh]rcdocutils.nodes inline r)r}r(h$jh2}r(h4]h5]r(Uxrefrjeh6]h7]h:]uh%jh>]rhIXmetacat-propertiesrr}r(h$Uh%jubah0UinlinerubaubhIX.r}r(h$X.h%jubeubj)r}r(h$Uh%jh.h/h0jh2}r(jXcenterh7]rUid8rah6]h4]h5]h:]uh]r(j)r}r(h$Xp.. figure:: images/screenshots/image021.png :align: center The Metacat Global Properties editing screen. h%jh.h/h0jh2}r(UuriXimages/screenshots/image021.pngrh7]h6]h4]h5]j}rU*jsh:]uh]ubj)r}r(h$X-The Metacat Global Properties editing screen.rh%jh.h/h0jh2}r(h4]h5]h6]h7]h:]uh]rhIX-The Metacat Global Properties editing screen.rr}r(h$jh%jubaubeubhj)r}r(h$X7When you save global properties, Metacat also saves a back-up file that is located in ``/var/metacat/.metacat`` (on Linux) or ``C:\Program Files\metacat\.metacat`` (on Windows). When you update Metacat, the system automatically locates the back-up file so you do not have to re-enter the configuration settings.h%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXVWhen you save global properties, Metacat also saves a back-up file that is located in rr}r(h$XVWhen you save global properties, Metacat also saves a back-up file that is located in h%jubj)r}r(h$X``/var/metacat/.metacat``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIX/var/metacat/.metacatrr}r(h$Uh%jubah0jubhIX (on Linux) or rr}r(h$X (on Linux) or h%jubj)r}r(h$X%``C:\Program Files\metacat\.metacat``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIX!C:\Program Files\metacat\.metacatrr}r(h$Uh%jubah0jubhIX (on Windows). When you update Metacat, the system automatically locates the back-up file so you do not have to re-enter the configuration settings.rr}r(h$X (on Windows). When you update Metacat, the system automatically locates the back-up file so you do not have to re-enter the configuration settings.h%jubeubhj)r}r(h$XThe 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.r h%jh.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r hIXThe 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.r r }r(h$j h%jubaubj)r}r(h$Uh%jh.h/h0jh2}r(h4]h5]h6]h7]h:]uh]rj)r}r(h$Uh2}r(h7]h6]h4]h5]h:]UcolsKuh%jh>]r(j)r}r(h$Uh2}r(h7]h6]h4]h5]h:]UcolwidthKuh%jh>]h0jubj)r}r(h$Uh2}r(h7]h6]h4]h5]h:]UcolwidthK]h0jubj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]r j )r!}r"(h$Uh2}r#(h4]h5]h6]h7]h:]uh%jh>]r$(j)r%}r&(h$Uh2}r'(h4]h5]h6]h7]h:]uh%j!h>]r(hj)r)}r*(h$XPropertyr+h%j%h.h/h0hyh2}r,(h4]h5]h6]h7]h:]uh]r-hIXPropertyr.r/}r0(h$j+h%j)ubaubah0jubj)r1}r2(h$Uh2}r3(h4]h5]h6]h7]h:]uh%j!h>]r4hj)r5}r6(h$X Descriptionr7h%j1h.h/h0hyh2}r8(h4]h5]h6]h7]h:]uh]r9hIX Descriptionr:r;}r<(h$j7h%j5ubaubah0jubeh0j,ubah0j-ubj.)r=}r>(h$Uh2}r?(h4]h5]h6]h7]h:]uh%jh>]r@(j )rA}rB(h$Uh2}rC(h4]h5]h6]h7]h:]uh%j=h>]rD(j)rE}rF(h$Uh2}rG(h4]h5]h6]h7]h:]uh%jAh>]rHhj)rI}rJ(h$XMetacat ContextrKh%jEh.h/h0hyh2}rL(h4]h5]h6]h7]h:]uh]rMhIXMetacat ContextrNrO}rP(h$jKh%jIubaubah0jubj)rQ}rR(h$Uh2}rS(h4]h5]h6]h7]h:]uh%jAh>]rThj)rU}rV(h$XUThe name of the deployed Metacat WAR file (minus the .war extension). E.g., "metacat"rWh%jQh.h/h0hyh2}rX(h4]h5]h6]h7]h:]uh]rYhIXUThe name of the deployed Metacat WAR file (minus the .war extension). E.g., "metacat"rZr[}r\(h$jWh%jUubaubah0jubeh0j,ubj )r]}r^(h$Uh2}r_(h4]h5]h6]h7]h:]uh%j=h>]r`(j)ra}rb(h$Uh2}rc(h4]h5]h6]h7]h:]uh%j]h>]rdhj)re}rf(h$X Server Namergh%jah.h/h0hyh2}rh(h4]h5]h6]h7]h:]uh]rihIX Server Namerjrk}rl(h$jgh%jeubaubah0jubj)rm}rn(h$Uh2}ro(h4]h5]h6]h7]h:]uh%j]h>]rphj)rq}rr(h$XcThe DNS name of the server hosting Metacat, not including port numbers or the protocol ("http://").h%jmh.h/h0hyh2}rs(h4]h5]h6]h7]h:]uh]rt(hIXYThe DNS name of the server hosting Metacat, not including port numbers or the protocol ("rurv}rw(h$XYThe DNS name of the server hosting Metacat, not including port numbers or the protocol ("h%jqubho)rx}ry(h$Xhttp://rzh2}r{(Urefurijzh7]h6]h4]h5]h:]uh%jqh>]r|hIXhttp://r}r~}r(h$Uh%jxubah0hxubhIX").rr}r(h$X").h%jqubeubah0jubeh0j,ubj )r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%j=h>]r(j)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$X HTTP Portrh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX HTTP Portrr}r(h$jh%jubaubah0jubj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$X4The non-secure port where Metacat will be available.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX4The non-secure port where Metacat will be available.rr}r(h$jh%jubaubah0jubeh0j,ubj )r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%j=h>]r(j)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$X HTTP SSL Portrh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX HTTP SSL Portrr}r(h$jh%jubaubah0jubj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$X0The secure port where Metacat will be available.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX0The secure port where Metacat will be available.rr}r(h$jh%jubaubah0jubeh0j,ubj )r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%j=h>]r(j)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$XDeploy Locationrh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXDeploy Locationrr}r(h$jh%jubaubah0jubj)r}r(h$Uh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$X0The directory where the application is deployed.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX0The directory where the application is deployed.rr}r(h$jh%jubaubah0jubeh0j,ubeh0jubeh0jubaubeubh&)r}r(h$Uh)Kh%jh.h/h0h1h2}r(h4]rXauthentication configurationrah5]h6]h7]rjah:]uh]r(h@)r}r(h$jh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFjuh]rhIXAuthentication Configurationrr}r(h$jh%jubaubhj)r}r(h$XBecause 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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXBecause 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.rr}r(h$jh%jubaubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rj,ah:]rhauh]r(h@)r}r(h$j1h%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFj+uh]rhIXSkins Configurationrr}r(h$j1h%jubaubhj)r}r(h$X*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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX*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.rr}r(h$jh%jubaubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rjCah:]rhauh]r(h@)r}r (h$jHh%jh.h/h0hDh2}r (h7]h6]h4]h5]h:]hFjBuh]r hIXMetacatUI Themesr r }r(h$jHh%jubaubhj)r}r(h$XThemes 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%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIX|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 rr}r(h$X|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%jubj)r}r(h$X ``metacatui``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIX metacatuirr}r(h$Uh%jubah0jubhIX default configuration.rr}r(h$X default configuration.h%jubeubhj)r }r!(h$XTo 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%jh.h/h0hyh2}r"(h4]h5]h6]h7]h:]uh]r#(hIX0To use the new MetacatUI theming system, select r$r%}r&(h$X0To use the new MetacatUI theming system, select h%j ubj)r'}r((h$X ``metacatui``h2}r)(h4]h5]h6]h7]h:]uh%j h>]r*hIX metacatuir+r,}r-(h$Uh%j'ubah0jubhIX and click the r.r/}r0(h$X and click the h%j ubj)r1}r2(h$X``Make metacatui default``h2}r3(h4]h5]h6]h7]h:]uh%j h>]r4hIXMake metacatui defaultr5r6}r7(h$Uh%j1ubah0jubhIX 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 r8r9}r:(h$X 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 ubj)r;}r<(h$X :doc:`themes`r=h%j h.h/h0jh2}r>(UreftypeXdocr?jjXthemesU refdomainUh7]h6]U refexplicith4]h5]h:]jjuh]r@j)rA}rB(h$j=h2}rC(h4]h5]rD(jj?eh6]h7]h:]uh%j;h>]rEhIXthemesrFrG}rH(h$Uh%jAubah0jubaubhIX.rI}rJ(h$X.h%j ubeubj)rK}rL(h$Uh%jh.h/h0jh2}rM(jXcenterh7]rNUid9rOah6]h4]h5]h:]uh]rP(j)rQ}rR(h$X^.. figure:: images/screenshots/image070.png :align: center Configuring Metacat themes. h%jKh.h/h0jh2}rS(UuriXimages/screenshots/image070.pngrTh7]h6]h4]h5]j}rUU*jTsh:]uh]ubj)rV}rW(h$XConfiguring Metacat themes.rXh%jKh.h/h0jh2}rY(h4]h5]h6]h7]h:]uh]rZhIXConfiguring Metacat themes.r[r\}r](h$jXh%jVubaubeubeubh&)r^}r_(h$Uh%jh.h/h0h1h2}r`(h4]h5]h6]h7]rajVah:]rbhauh]rc(h@)rd}re(h$j[h%j^h.h/h0hDh2}rf(h7]h6]h4]h5]h:]hFjUuh]rghIXSkinsrhri}rj(h$j[h%jdubaubcdocutils.nodes comment rk)rl}rm(h$X#deprecated:2.2.0 Use themes insteadh%j^h.h/h0Ucommentrnh2}ro(j`jah7]h6]h4]h5]h:]uh]rphIX#deprecated:2.2.0 Use themes insteadrqrr}rs(h$Uh%jlubaubhj)rt}ru(h$X)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 default`` radio button. If you do not have a custom skin, select the ``default`` skin.h%j^h.h/h0hyh2}rv(h4]h5]h6]h7]h:]uh]rw(hIXIf 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 rxry}rz(h$XIf 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%jtubj)r{}r|(h$X``Make default``h2}r}(h4]h5]h6]h7]h:]uh%jth>]r~hIXMake defaultrr}r(h$Uh%j{ubah0jubhIX< radio button. If you do not have a custom skin, select the rr}r(h$X< radio button. If you do not have a custom skin, select the h%jtubj)r}r(h$X ``default``h2}r(h4]h5]h6]h7]h:]uh%jth>]rhIXdefaultrr}r(h$Uh%jubah0jubhIX skin.rr}r(h$X skin.h%jtubeubhj)r}r(h$XOnce 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%j^h.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXOnce 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 rr}r(h$XOnce 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%jubj)r}r(h$X :doc:`themes`rh%jh.h/h0jh2}r(UreftypeXdocrjjXthemesU refdomainUh7]h6]U refexplicith4]h5]h:]jjuh]rj)r}r(h$jh2}r(h4]h5]r(jjeh6]h7]h:]uh%jh>]rhIXthemesrr}r(h$Uh%jubah0jubaubhIX.r}r(h$X.h%jubeubj)r}r(h$Uh%j^h.h/h0jh2}r(jXcenterh7]rUid10rah6]h4]h5]h:]uh]r(j)r}r(h$X].. figure:: images/screenshots/image023.png :align: center Configuring Metacat skins. h%jh.h/h0jh2}r(UuriXimages/screenshots/image023.pngrh7]h6]h4]h5]j}rU*jsh:]uh]ubj)r}r(h$XConfiguring Metacat skins.rh%jh.h/h0jh2}r(h4]h5]h6]h7]h:]uh]rhIXConfiguring Metacat skins.rr}r(h$jh%jubaubeubhj)r}r(h$XSelect 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%j^h.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXBSelect the checkbox next to your customized skin or and click the rr}r(h$XBSelect the checkbox next to your customized skin or and click the h%jubj)r}r(h$X``Make default``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIXMake defaultrr}r(h$Uh%jubah0jubhIX< radio button. If you do not have a custom skin, select the rr}r(h$X< radio button. If you do not have a custom skin, select the h%jubj)r}r(h$X ``default``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIXdefaultrr}r(h$Uh%jubah0jubhIXo skin. Once you have selected a skin, Metacat will open a list of options that apply to the Registry interface.rr}r(h$Xo skin. Once you have selected a skin, Metacat will open a list of options that apply to the Registry interface.h%jubeubhj)r}r(h$XSelect 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.rh%j^h.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXSelect 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.rr}r(h$jh%jubaubeubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rjiah:]rhauh]r(h@)r}r(h$jnh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFjhuh]rhIXDatabase Configurationrr}r(h$jnh%jubaubhj)r}r(h$XeBecause 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).rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXeBecause 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).rr}r(h$jh%jubaubh_)r}r(h$Uh%jh.h/h0hbh2}r(UbulletrX*h7]h6]h4]h5]h:]uh]r(he)r}r(h$XNew Installationrh%jh.h/h0hh2}r(h4]h5]h6]h7]h:]uh]rhj)r}r(h$jh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXNew Installationrr}r(h$jh%jubaubaubhe)r}r(h$XUpgrade h%jh.h/h0hh2}r(h4]h5]h6]h7]h:]uh]rhj)r}r(h$XUpgraderh%jh.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r hIXUpgrader r }r (h$jh%jubaubaubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rjah:]rh auh]r(h@)r}r(h$jh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFjuh]rhIXNew Installationrr}r(h$jh%jubaubhj)r}r(h$XIf 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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXIf 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.r r!}r"(h$jh%jubaubj)r#}r$(h$Uh%jh.h/h0jh2}r%(jXcenterh7]r&Uid11r'ah6]h4]h5]h:]uh]r((j)r)}r*(h$X{.. figure:: images/screenshots/image027.png :align: center Database installation creates tables needed for Metacat. h%j#h.h/h0jh2}r+(UuriXimages/screenshots/image027.pngr,h7]h6]h4]h5]j}r-U*j,sh:]uh]ubj)r.}r/(h$X8Database installation creates tables needed for Metacat.r0h%j#h.h/h0jh2}r1(h4]h5]h6]h7]h:]uh]r2hIX8Database installation creates tables needed for Metacat.r3r4}r5(h$j0h%j.ubaubeubhj)r6}r7(h$XIf 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%jh.h/h0hyh2}r8(h4]h5]h6]h7]h:]uh]r9(hIX~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 r:r;}r<(h$X~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%j6ubho)r=}r>(h$Xknb-help@nceas.ucsb.eduh2}r?(UrefuriXmailto:knb-help@nceas.ucsb.eduh7]h6]h4]h5]h:]uh%j6h>]r@hIXknb-help@nceas.ucsb.edurArB}rC(h$Uh%j=ubah0hxubhIX.rD}rE(h$X.h%j6ubeubhj)rF}rG(h$XZWhen you choose Continue, Metacat runs the listed scripts and creates the database schema.rHh%jh.h/h0hyh2}rI(h4]h5]h6]h7]h:]uh]rJhIXZWhen you choose Continue, Metacat runs the listed scripts and creates the database schema.rKrL}rM(h$jHh%jFubaubeubh&)rN}rO(h$Uh%jh.h/h0h1h2}rP(h4]h5]h6]h7]rQjah:]rRh auh]rS(h@)rT}rU(h$jh%jNh.h/h0hDh2}rV(h7]h6]h4]h5]h:]hFjuh]rWhIXUpgraderXrY}rZ(h$jh%jTubaubhj)r[}r\(h$XIf 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.r]h%jNh.h/h0hyh2}r^(h4]h5]h6]h7]h:]uh]r_hIXIf 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.r`ra}rb(h$j]h%j[ubaubhj)rc}rd(h$XIf 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%jNh.h/h0hyh2}re(h4]h5]h6]h7]h:]uh]rf(hIXIf 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 rgrh}ri(h$XIf 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%jcubho)rj}rk(h$Xknb-help@nceas.ucsb.edu.Whenh2}rl(UrefuriX#mailto:knb-help@nceas.ucsb.edu.Whenh7]h6]h4]h5]h:]uh%jch>]rmhIXknb-help@nceas.ucsb.edu.Whenrnro}rp(h$Uh%jjubah0hxubhIXY you choose to continue, Metacat runs the listed scripts and updates the database schema.rqrr}rs(h$XY you choose to continue, Metacat runs the listed scripts and updates the database schema.h%jcubeubj)rt}ru(h$Uh%jNh.h/h0jh2}rv(jXcenterh7]rwUid12rxah6]h4]h5]h:]uh]ry(j)rz}r{(h$Xb.. figure:: images/screenshots/image029.png :align: center Upgrading an existing database. h%jth.h/h0jh2}r|(UuriXimages/screenshots/image029.pngr}h7]h6]h4]h5]j}r~U*j}sh:]uh]ubj)r}r(h$XUpgrading an existing database.rh%jth.h/h0jh2}r(h4]h5]h6]h7]h:]uh]rhIXUpgrading an existing database.rr}r(h$jh%jubaubeubhj)r}r(h$XAdditional 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.rh%jNh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXAdditional 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.rr}r(h$jh%jubaubeubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rjah:]rhauh]r(h@)r}r(h$jh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFjuh]rhIX,Geoserver Configuration (Highly Recommended)rr}r(h$jh%jubaubcdocutils.nodes sidebar r)r}r(h$XAlternatively, 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:///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%jh.Nh0Usidebarrh2}r(h4]h5]h6]h7]h:]uh]r(h@)r}r(h$XManual Geoserver Updaterh2}r(h4]h5]h6]h7]h:]uh%jh>]rhIXManual Geoserver Updaterr}r(h$jh%jubah0hDubhj)r}r(h$XAlternatively, you can change the Geoserver username and password manually by directly logging in to the Geoserver. To configure the credentials manually:rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXAlternatively, you can change the Geoserver username and password manually by directly logging in to the Geoserver. To configure the credentials manually:rr}r(h$jh%jubaubcdocutils.nodes enumerated_list r)r}r(h$Uh2}r(UsuffixrU.h7]h6]h4]UprefixrUh5]h:]UenumtyperUarabicruh%jh>]r(he)r}r(h$XDGo to the Geoserver admin page: http:///geoserver/rh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$jh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIX Go to the Geoserver admin page: rr}r(h$X Go to the Geoserver admin page: h%jubho)r}r(h$Xhttp:/rh2}r(Urefurijh7]h6]h4]h5]h:]uh%jh>]rhIXhttp:/rr}r(h$Uh%jubah0hxubhIX//geoserver/rr}r(h$X//geoserver/h%jubeubah0hubhe)r}r(h$XDLog in using the default username and password ( admin / geoserver )rh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$jh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXDLog in using the default username and password ( admin / geoserver )rr}r(h$jh%jubaubah0hubhe)r}r(h$XVNavigate to the Password Change Page. Enter a new user and password and click Submit.rh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$jh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXVNavigate to the Password Change Page. Enter a new user and password and click Submit.rr}r(h$jh%jubaubah0hubhe)r}r(h$X0Click Apply then Save to save your new password.rh2}r(h4]h5]h6]h7]h:]uh%jh>]rhj)r}r(h$jh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX0Click Apply then Save to save your new password.rr}r(h$jh%jubaubah0hubeh0Uenumerated_listrubeubhj)r}r(h$XMetacat 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%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXMetacat 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. rr}r(h$XMetacat 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%jubcdocutils.nodes emphasis r)r}r(h$X*We highly recommend that you change the default credentials so that only local administrators can make changes to your Geoserver.*h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIXWe highly recommend that you change the default credentials so that only local administrators can make changes to your Geoserver.rr}r(h$Uh%jubah0UemphasisrubhIX+ For more information about Geoserver, see rr}r (h$X+ For more information about Geoserver, see h%jubj)r }r (h$X:doc:`geoserver`r h%jh.h/h0jh2}r (UreftypeXdocrjjX geoserverU refdomainUh7]h6]U refexplicith4]h5]h:]jjuh]rj)r}r(h$j h2}r(h4]h5]r(jjeh6]h7]h:]uh%j h>]rhIX geoserverrr}r(h$Uh%jubah0jubaubhIX.r}r(h$X.h%jubeubhj)r}r(h$XWhen 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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXWhen 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.rr }r!(h$jh%jubaubhj)r"}r#(h$XThe 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.r$h%jh.h/h0hyh2}r%(h4]h5]h6]h7]h:]uh]r&hIXThe 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.r'r(}r)(h$j$h%j"ubaubj)r*}r+(h$Uh%jh.h/h0jh2}r,(jXcenterh7]r-Uid13r.ah6]h4]h5]h:]uh]r/(j)r0}r1(h$XY.. figure:: images/screenshots/image031.png :align: center Configuring Geoserver. h%j*h.h/h0jh2}r2(UuriXimages/screenshots/image031.pngr3h7]h6]h4]h5]j}r4U*j3sh:]uh]ubj)r5}r6(h$XConfiguring Geoserver.r7h%j*h.h/h0jh2}r8(h4]h5]h6]h7]h:]uh]r9hIXConfiguring Geoserver.r:r;}r<(h$j7h%j5ubaubeubeubh&)r=}r>(h$Uh%jh.h/h0h1h2}r?(h4]h5]h6]h7]r@jah:]rAhauh]rB(h@)rC}rD(h$jh%j=h.h/h0hDh2}rE(h7]h6]h4]h5]h:]hFjuh]rFhIXDataONE ConfigurationrGrH}rI(h$jh%jCubaubhj)rJ}rK(h$XMetacat 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%j=h.h/h0hyh2}rL(h4]h5]h6]h7]h:]uh]rM(hIXoMetacat can be configured to operate as a Member Node within the DataONE federation of data repositories. See rNrO}rP(h$XoMetacat can be configured to operate as a Member Node within the DataONE federation of data repositories. See h%jJubj)rQ}rR(h$X:doc:`dataone`rSh%jJh.h/h0jh2}rT(UreftypeXdocrUjjXdataoneU refdomainUh7]h6]U refexplicith4]h5]h:]jjuh]rVj)rW}rX(h$jSh2}rY(h4]h5]rZ(jjUeh6]h7]h:]uh%jQh>]r[hIXdataoner\r]}r^(h$Uh%jWubah0jubaubhIXm for background and details on DataONE and details about configuring Metacat to act as a DataONE Member Node.r_r`}ra(h$Xm for background and details on DataONE and details about configuring Metacat to act as a DataONE Member Node.h%jJubeubeubh&)rb}rc(h$Uh%jh.h/h0h1h2}rd(h4]h5]h6]h7]rejah:]rfhauh]rg(h@)rh}ri(h$jh%jbh.h/h0hDh2}rj(h7]h6]h4]h5]h:]hFjuh]rkhIXReplication Configurationrlrm}rn(h$jh%jhubaubhj)ro}rp(h$XMetacat 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%jbh.h/h0hyh2}rq(h4]h5]h6]h7]h:]uh]rr(hIX$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 rsrt}ru(h$X$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%joubj)rv}rw(h$X:doc:`replication`rxh%joh.h/h0jh2}ry(UreftypeXdocrzjjX replicationU refdomainUh7]h6]U refexplicith4]h5]h:]jjuh]r{j)r|}r}(h$jxh2}r~(h4]h5]r(jjzeh6]h7]h:]uh%jvh>]rhIX replicationrr}r(h$Uh%j|ubah0jubaubhIXc for details on the replication system and how to configure Metacat to replicate with another node.rr}r(h$Xc for details on the replication system and how to configure Metacat to replicate with another node.h%joubeubcdocutils.nodes note r)r}r(h$XNote 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%jbh.h/h0Unoterh2}r(h4]h5]h6]h7]h:]uh]rhj)r}r(h$XNote 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.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXNote 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.rr}r(h$jh%jubaubaubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rjah:]rhauh]r(h@)r}r(h$jh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFjuh]rhIXEZID Configurationrr}r(h$jh%jubaubhj)r}r(h$XMetacat 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%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXMetacat 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 rr}r(h$XMetacat 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%jubj)r}r(h$X:doc:`metacat-properties`rh%jh.h/h0jh2}r(UreftypeXdocrjjXmetacat-propertiesU refdomainUh7]h6]U refexplicith4]h5]h:]jjuh]rj)r}r(h$jh2}r(h4]h5]r(jjeh6]h7]h:]uh%jh>]rhIXmetacat-propertiesrr}r(h$Uh%jubah0jubaubhIX.r}r(h$X.h%jubeubj)r}r(h$Uh%jh.h/h0jh2}r(jXcenterh7]rUid14rah6]h4]h5]h:]uh]r(j)r}r(h$X\.. figure:: images/screenshots/image072.png :align: center Configuring EZID service. h%jh.h/h0jh2}r(UuriXimages/screenshots/image072.pngrh7]h6]h4]h5]j}rU*jsh:]uh]ubj)r}r(h$XConfiguring EZID service.rh%jh.h/h0jh2}r(h4]h5]h6]h7]h:]uh]rhIXConfiguring EZID service.rr}r(h$jh%jubaubeubeubeubh&)r}r(h$Uh%h,h.h/h0h1h2}r(h4]h5]h6]h7]rjah:]rhauh]r(h@)r}r(h$jh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFjuh]rhIXAdditional Configurationrr}r(h$jh%jubaubhj)r}r(h$XThe 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 ``.properties`` (which contains skin-specific properties). Each of these property files is discussed in more depth in this section.h%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXThe 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: rr}r(h$XThe 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%jubj)r}r(h$X``metacat.properties``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIXmetacat.propertiesrr}r(h$Uh%jubah0jubhIXQ (which contains global properties, e.g., authorization and database values) and rr}r(h$XQ (which contains global properties, e.g., authorization and database values) and h%jubj)r}r(h$X``.properties``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIX.propertiesrr}r(h$Uh%jubah0jubhIXt (which contains skin-specific properties). Each of these property files is discussed in more depth in this section.rr}r(h$Xt (which contains skin-specific properties). Each of these property files is discussed in more depth in this section.h%jubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rj ah:]rhauh]r(h@)r}r(h$XThe ``metacat.properties`` filerh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFjuh]r(hIXThe rr}r(h$jh%jubj)r}r(h$jh2}r(h4]h5]h6]h7]h:]uh%jh>]rhIXmetacat.propertiesrr}r(h$Uh%jubah0jubhIX filer r }r (h$jh%jubeubhj)r }r (h$XMetacat'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%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIX Metacat's rr}r(h$X Metacat's h%j ubj)r}r(h$X``metacat.properties``h2}r(h4]h5]h6]h7]h:]uh%j h>]rhIXmetacat.propertiesrr}r(h$Uh%jubah0jubhIX 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 rr}r(h$X 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 ubj)r}r(h$X``metacat.properties``h2}r(h4]h5]h6]h7]h:]uh%j h>]r hIXmetacat.propertiesr!r"}r#(h$Uh%jubah0jubhIX file also contains optional properties that are only relevant when optional Metacat features (such as the harvester or replication) are enabled. The ` r$r%}r&(h$X file also contains optional properties that are only relevant when optional Metacat features (such as the harvester or replication) are enabled. The ` h%j ubcdocutils.nodes title_reference r')r(}r)(h$X`metacat.properties file``h2}r*(h4]h5]h6]h7]h:]uh%j h>]r+hIXmetacat.properties file`r,r-}r.(h$Uh%j(ubah0Utitle_referencer/ubhIX is found here:r0r1}r2(h$X is found here:h%j ubeubj[)r3}r4(h$X(/WEB_INF/metacat.propertiesh%jh.h/h0j^h2}r5(j`jah7]h6]h4]h5]h:]uh]r6hIX(/WEB_INF/metacat.propertiesr7r8}r9(h$Uh%j3ubaubhj)r:}r;(h$XbWhere ```` 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%jh.h/h0hyh2}r<(h4]h5]h6]h7]h:]uh]r=(hIXWhere r>r?}r@(h$XWhere h%j:ubj)rA}rB(h$X````h2}rC(h4]h5]h6]h7]h:]uh%j:h>]rDhIX rErF}rG(h$Uh%jAubah0jubhIXE is the directory in which the Metacat application code lives (e.g., rHrI}rJ(h$XE is the directory in which the Metacat application code lives (e.g., h%j:ubj)rK}rL(h$X$``/var/lib/tomcat7/webapps/metacat``h2}rM(h4]h5]h6]h7]h:]uh%j:h>]rNhIX /var/lib/tomcat7/webapps/metacatrOrP}rQ(h$Uh%jKubah0jubhIXE). The path is a combination of the Web application directory (e.g., rRrS}rT(h$XE). The path is a combination of the Web application directory (e.g., h%j:ubj)rU}rV(h$X``/var/lib/tomcat7/webapps/``h2}rW(h4]h5]h6]h7]h:]uh%j:h>]rXhIX/var/lib/tomcat7/webapps/rYrZ}r[(h$Uh%jUubah0jubhIX+) and the Metacat context directory (e.g., r\r]}r^(h$X+) and the Metacat context directory (e.g., h%j:ubj)r_}r`(h$X ``metacat``h2}ra(h4]h5]h6]h7]h:]uh%j:h>]rbhIXmetacatrcrd}re(h$Uh%j_ubah0jubhIXJ). Both values depend upon how your system was set up during installation.rfrg}rh(h$XJ). Both values depend upon how your system was set up during installation.h%j:ubeubhj)ri}rj(h$XFor 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%jh.h/h0hyh2}rk(h4]h5]h6]h7]h:]uh]rl(hIXTFor information about each property and default or example settings, please see the rmrn}ro(h$XTFor information about each property and default or example settings, please see the h%jiubj)rp}rq(h$X:doc:`metacat-properties`rrh%jih.h/h0jh2}rs(UreftypeXdocrtjjXmetacat-propertiesU refdomainUh7]h6]U refexplicith4]h5]h:]jjuh]ruj)rv}rw(h$jrh2}rx(h4]h5]ry(jjteh6]h7]h:]uh%jph>]rzhIXmetacat-propertiesr{r|}r}(h$Uh%jvubah0jubaubhIXm. Properties that can only be edited manually in the metacat.properties file are highlighted in the appendix.r~r}r(h$Xm. Properties that can only be edited manually in the metacat.properties file are highlighted in the appendix.h%jiubeubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rj*ah:]rhauh]r(h@)r}r(h$j/h%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFj)uh]rhIX.propertiesrr}r(h$j/h%jubaubhj)r}r(h$XThe ``.properties`` file contains skin-specific properties (e.g., template information). For each skin, the skin-specific properties are found here::h%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXThe rr}r(h$XThe h%jubj)r}r(h$X``.properties``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIX.propertiesrr}r(h$Uh%jubah0jubhIX file contains skin-specific properties (e.g., template information). For each skin, the skin-specific properties are found here:rr}r(h$X file contains skin-specific properties (e.g., template information). For each skin, the skin-specific properties are found here:h%jubeubj[)r}r(h$X</style/skins//.propertiesh%jh.h/h0j^h2}r(j`jah7]h6]h4]h5]h:]uh]rhIX</style/skins//.propertiesrr}r(h$Uh%jubaubhj)r}r(h$XWhere ```` 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%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]r(hIXWhere rr}r(h$XWhere h%jubj)r}r(h$X````h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIX rr}r(h$Uh%jubah0jubhIXT is the directory in which the Metacat application code lives (described above) and rr}r(h$XT is the directory in which the Metacat application code lives (described above) and h%jubj)r}r(h$X````h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIX rr}r(h$Uh%jubah0jubhIX is the name of the skin (e.g., rr}r(h$X is the name of the skin (e.g., h%jubj)r}r(h$X ``default``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIXdefaultrr}r(h$Uh%jubah0jubhIX or rr}r(h$X or h%jubj)r}r(h$X ``nceas``h2}r(h4]h5]h6]h7]h:]uh%jh>]rhIXnceasrr}r(h$Uh%jubah0jubhIX).rr}r(h$X).h%jubeubeubh&)r}r(h$Uh%jh.h/h0h1h2}r(h4]h5]h6]h7]rj=ah:]rh auh]r(h@)r}r(h$jBh%jh.h/h0hDh2}r(h7]h6]h4]h5]h:]hFj<uh]rhIX%Additional configuration for Tomcat 7rr}r(h$jBh%jubaubhj)r}r(h$X~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%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIX}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:rr}r(h$X}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%jubaubj[)r}r(h$Xh%jh.h/h0j^h2}r(j`jah7]h6]h4]h5]h:]uh]rhIXrr}r(h$Uh%jubaubhj)r}r(h$XThen restart Tomcat 7.rh%jh.h/h0hyh2}r(h4]h5]h6]h7]h:]uh]rhIXThen restart Tomcat 7.rr}r(h$jh%jubaubeubeubeubh.h/h0h1h2}r(h4]h5]h6]h7]rhah:]rhauh]r(h@)r}r(h$hh%h*h.h/h0hDh2}r(h7]h6]h4]h5]h:]hFhuh]rhIXInitial Configurationr r }r (h$hh%jubaubhj)r }r (h$XBefore 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%h*h.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r (hIX.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 r r }r (h$X.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 ubho)r }r (h$X?`Changing Authentication Configuration without Authentication`_Uresolvedr Kh%j h0hxh2}r (UnameX<Changing Authentication Configuration without Authenticationh7]h6]h4]h5]h:]hFhuh>]r hIX<Changing Authentication Configuration without Authenticationr r }r (h$Uh%j ubaubhIX) are included at the end of this section.r r }r (h$X) are included at the end of this section.h%j ubeubh&)r }r (h$Uh%h*h.h/h0h1h2}r (h4]h5]h6]h7]r hah:]r hauh]r (h@)r }r (h$hh%j h.h/h0hDh2}r (h7]h6]h4]h5]h:]hFhuh]r hIXBack-up Configurationr r }r! (h$hh%j ubaubhj)r" }r# (h$XuTo 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.r$ h%j h.h/h0hyh2}r% (h4]h5]h6]h7]h:]uh]r& hIXuTo 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.r' r( }r) (h$j$ h%j" ubaubj)r* }r+ (h$XIf 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%j h.h/h0jh2}r, (h4]h5]h6]h7]h:]uh]r- hj)r. }r/ (h$XIf 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.r0 h%j* h.h/h0hyh2}r1 (h4]h5]h6]h7]h:]uh]r2 hIXIf 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.r3 r4 }r5 (h$j0 h%j. ubaubaubj)r6 }r7 (h$Uh%j h.h/h0jh2}r8 (jXcenterh7]r9 Uid2r: ah6]h4]h5]h:]uh]r; (j)r< }r= (h$Xd.. figure:: images/screenshots/image011.png :align: center Configuring the Backup Directory. h%j6 h.h/h0jh2}r> (UuriXimages/screenshots/image011.pngr? h7]h6]h4]h5]j}r@ U*j? sh:]uh]ubj)rA }rB (h$X!Configuring the Backup Directory.rC h%j6 h.h/h0jh2}rD (h4]h5]h6]h7]h:]uh]rE hIX!Configuring the Backup Directory.rF rG }rH (h$jC h%jA ubaubeubeubh&)rI }rJ (h$Uh)Kh%h*h.h/h0h1h2}rK (h4]rL jah5]h6]h7]rM hah:]uh]rN (h@)rO }rP (h$hh%jI h.h/h0hDh2}rQ (h7]h6]h4]h5]h:]hFhuh]rR hIXAuthentication ConfigurationrS rT }rU (h$hh%jO ubaubhj)rV }rW (h$XWhether 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%jI h.h/h0hyh2}rX (h4]h5]h6]h7]h:]uh]rY hIXWhether 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:rZ r[ }r\ (h$XWhether 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%jV ubaubj[)r] }r^ (h$Xhttp:///adminh%jI h.h/h0j^h2}r_ (j`jah7]h6]h4]h5]h:]uh]r` hIXhttp:///adminra rb }rc (h$Uh%j] ubaubhj)rd }re (h$XMetacat 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%jI h.h/h0hyh2}rf (h4]h5]h6]h7]h:]uh]rg (hIXMetacat 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 rh ri }rj (h$XMetacat 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%jd ubj)rk }rl (h$X``AuthInterface``h2}rm (h4]h5]h6]h7]h:]uh%jd h>]rn hIX AuthInterfacero rp }rq (h$Uh%jk ubah0jubhIX.rr }rs (h$X.h%jd ubeubhj)rt }ru (h$XGRequired configuration values for the password file authentication are:rv h%jI h.h/h0hyh2}rw (h4]h5]h6]h7]h:]uh]rx hIXGRequired configuration values for the password file authentication are:ry rz }r{ (h$jv h%jt ubaubcdocutils.nodes block_quote r| )r} }r~ (h$Uh%jI h.h/h0U block_quoter h2}r (h4]h5]h6]h7]h:]uh]r j[)r }r (h$XTAuthentication Class Metacat Administrators Users Management URL Password File Path.h%j} h0j^h2}r (j`jah7]h6]h4]h5]h:]uh]r hIXTAuthentication Class Metacat Administrators Users Management URL Password File Path.r r }r (h$Uh%j ubaubaubhj)r }r (h$X:Required configuration values for LDAP authentication are:r h%jI h.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r hIX:Required configuration values for LDAP authentication are:r r }r (h$j h%j ubaubj| )r }r (h$Uh%jI h.h/h0j h2}r (h4]h5]h6]h7]h:]uh]r j[)r }r (h$XnAuthentication Class Metacat Administrators Users Management URL Authentication URL Authentication Secure URL.h%j h0j^h2}r (j`jah7]h6]h4]h5]h:]uh]r hIXnAuthentication Class Metacat Administrators Users Management URL Authentication URL Authentication Secure URL.r r }r (h$Uh%j ubaubaubhj)r }r (h$X%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.r h%jI h.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r hIX%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.r r }r (h$j h%j ubaubj)r }r (h$XTo 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%jI h.h/h0jh2}r (h4]h5]h6]h7]h:]uh]r hj)r }r (h$XTo 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%j h.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r (hIXITo create an account on the password file, please see the section called r r }r (h$XITo create an account on the password file, please see the section called h%j ubj)r }r (h$X:doc:`authinterface`r h%j h.h/h0jh2}r (UreftypeXdocr jjX authinterfaceU refdomainUh7]h6]U refexplicith4]h5]h:]jjuh]r j)r }r (h$j h2}r (h4]h5]r (jj eh6]h7]h:]uh%j h>]r hIX authinterfacer r }r (h$Uh%j ubah0jubaubhIXa. To create an LDAP account on the KNB LDAP server (specified as the default LDAP server), go to r r }r (h$Xa. To create an LDAP account on the KNB LDAP server (specified as the default LDAP server), go to h%j ubho)r }r (h$Xhttps://identity.nceas.ucsb.edur h2}r (Urefurij h7]h6]h4]h5]h:]uh%j h>]r hIXhttps://identity.nceas.ucsb.edur r }r (h$Uh%j ubah0hxubhIX1 and select the "create a new user account" link.r r }r (h$X1 and select the "create a new user account" link.h%j ubeubaubhj)r }r (h$XdIf you make changes to the authentication settings, you must restart Tomcat to put them into effect.r h%jI h.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r hIXdIf you make changes to the authentication settings, you must restart Tomcat to put them into effect.r r }r (h$j h%j ubaubj)r }r (h$Uh%jI h.h/h0jh2}r (jXcenterh7]r Uid3r ah6]h4]h5]h:]uh]r (j)r }r (h$Xs.. figure:: images/screenshots/image071.png :align: center Configuring Password File Authentication Values. h%j h.h/h0jh2}r (UuriXimages/screenshots/image071.pngr h7]h6]h4]h5]j}r U*j sh:]uh]ubj)r }r (h$X0Configuring Password File Authentication Values.r h%j h.h/h0jh2}r (h4]h5]h6]h7]h:]uh]r hIX0Configuring Password File Authentication Values.r r }r (h$j h%j ubaubeubj)r }r (h$Uh%jI h.h/h0jh2}r (jXcenterh7]r Uid4r ah6]h4]h5]h:]uh]r (j)r }r (h$Xj.. figure:: images/screenshots/image009.png :align: center Configuring LDAP Authentication Values. h%j h.h/h0jh2}r (UuriXimages/screenshots/image009.pngr h7]h6]h4]h5]j}r U*j sh:]uh]ubj)r }r (h$X'Configuring LDAP Authentication Values.r h%j h.h/h0jh2}r (h4]h5]h6]h7]h:]uh]r hIX'Configuring LDAP Authentication Values.r r }r (h$j h%j ubaubeubeubh'eubh.h/h0h1h2}r (h4]h5]h6]h7]r hah:]r hauh]r (h@)r }r (h$hh%h'h.h/h0hDh2}r (h7]h6]h4]h5]h:]hFhuh]r hIX<Changing Authentication Configuration without Authenticationr r }r (h$hh%j ubaubhj)r }r (h$XIf 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.r h%h'h.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r hIXIf 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.r r }r (h$j h%j ubaubhj)r }r (h$X.To edit the authentication configuration file:r h%h'h.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r hIX.To edit the authentication configuration file:r r }r (h$j h%j ubaubj)r }r (h$Uh%h'h.h/h0jh2}r (jU.h7]h6]h4]jUh5]h:]jjuh]r he)r }r (h$XStop 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%j h.h/h0hh2}r (h4]h5]h6]h7]h:]uh]r hj)r }r (h$XStop 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%j h.h/h0hyh2}r (h4]h5]h6]h7]h:]uh]r (hIX-Stop Tomcat and edit the Metacat properties (r r! }r" (h$X-Stop Tomcat and edit the Metacat properties (h%j ubj)r# }r$ (h$X``metacat.properties``h2}r% (h4]h5]h6]h7]h:]uh%j h>]r& hIXmetacat.propertiesr' r( }r) (h$Uh%j# ubah0jubhIX) file in the Metacat context directory inside the Tomcat application directory. The Metacat context directory is the name of the application (usually metacat):r* r+ }r, (h$X) 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 ubeubaubaubj| )r- }r. (h$Uh%h'h.h/h0j h2}r/ (h4]h5]h6]h7]h:]uh]r0 j[)r1 }r2 (h$X9//WEB-INF/metacat.propertiesh%j- h0j^h2}r3 (j`jah7]h6]h4]h5]h:]uh]r4 hIX9//WEB-INF/metacat.propertiesr5 r6 }r7 (h$Uh%j1 ubaubaubj)r8 }r9 (h$Uh%h'h.h/h0jh2}r: (jU.Ustartr; Kh7]h6]h4]jUh5]h:]jjuh]r< he)r= }r> (h$X/Change the following properties appropriately: h%j8 h.h/h0hh2}r? (h4]h5]h6]h7]h:]uh]r@ hj)rA }rB (h$X.Change the following properties appropriately:rC h%j= h.h/h0hyh2}rD (h4]h5]h6]h7]h:]uh]rE hIX.Change the following properties appropriately:rF rG }rH (h$jC h%jA ubaubaubaubj| )rI }rJ (h$Uh%h'h.h/h0j h2}rK (h4]h5]h6]h7]h:]uh]rL j[)rM }rN (h$Xauth.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 pathh%jI h0j^h2}rO (j`jah7]h6]h4]h5]h:]uh]rP hIXauth.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 pathrQ rR }rS (h$Uh%jM ubaubaubj)rT }rU (h$Uh%h'h.h/h0jh2}rV (jU.j; Kh7]h6]h4]jUh5]h:]jjuh]rW he)rX }rY (h$X8Save the ``metacat.properties`` file and start Tomcat. h%jT h.h/h0hh2}rZ (h4]h5]h6]h7]h:]uh]r[ hj)r\ }r] (h$X6Save the ``metacat.properties`` file and start Tomcat.h%jX h.h/h0hyh2}r^ (h4]h5]h6]h7]h:]uh]r_ (hIX Save the r` ra }rb (h$X Save the h%j\ ubj)rc }rd (h$X``metacat.properties``h2}re (h4]h5]h6]h7]h:]uh%j\ h>]rf hIXmetacat.propertiesrg rh }ri (h$Uh%jc ubah0jubhIX file and start Tomcat.rj rk }rl (h$X file and start Tomcat.h%j\ ubeubaubaubeubh.h/h0Usystem_messagerm h2}rn (h4]UlevelKh7]h6]Usourceh/h5]h:]UlineKUtypeUINFOro uh]rp hj)rq }rr (h$X:Enumerated list start value not ordinal-1: "2" (ordinal 2)h2}rs (h4]h5]h6]h7]h:]uh%h"h>]rt hIX:Enumerated list start value not ordinal-1: "2" (ordinal 2)ru rv }rw (h$Uh%jq ubah0hyubaubh!)rx }ry (h$Uh%h'h.h/h0jm h2}rz (h4]UlevelKh7]h6]Usourceh/h5]h:]UlineKUtypejo uh]r{ hj)r| }r} (h$X:Enumerated list start value not ordinal-1: "3" (ordinal 3)h2}r~ (h4]h5]h6]h7]h:]uh%jx h>]r hIX:Enumerated list start value not ordinal-1: "3" (ordinal 3)r r }r (h$Uh%j| ubah0hyubaubh!)r }r (h$Uh%jh.h/h0jm h2}r (h4]UlevelKh7]h6]r jaUsourceh/h5]h:]UlineKUtypejo uh]r hj)r }r (h$X?Duplicate implicit target name: "authentication configuration".h2}r (h4]h5]h6]h7]h:]uh%j h>]r hIX?Duplicate implicit target name: "authentication configuration".r r }r (h$Uh%j ubah0hyubaubeUcurrent_sourcer NU decorationr NUautofootnote_startr KUnameidsr }r (hjChjhjVh j=h hh jh hUh jhj hjihjhhhj,hjhj*hhhhhjhNhjhh9hjhhuh>]r h,ah$UU transformerr NU footnote_refsr }r Urefnamesr }r X<changing authentication configuration without authentication]r j asUsymbol_footnotesr ]r Uautofootnote_refsr ]r Usymbol_footnote_refsr ]r U citationsr ]r h=hU current_liner NUtransform_messagesr ]r Ureporterr NUid_startr K&U autofootnotesr ]r U citation_refsr }r Uindirect_targetsr ]r Usettingsr (cdocutils.frontend Values r or }r (Ufootnote_backlinksr KUrecord_dependenciesr NU rfc_base_urlr Uhttps://tools.ietf.org/html/r U tracebackr Upep_referencesr NUstrip_commentsr NU toc_backlinksr jU language_coder Uenr U datestampr NU report_levelr KU _destinationr NU halt_levelr KU strip_classesr NhDNUerror_encoding_error_handlerr Ubackslashreplacer Udebugr NUembed_stylesheetr Uoutput_encoding_error_handlerr Ustrictr U sectnum_xformr KUdump_transformsr NU docinfo_xformr KUwarning_streamr NUpep_file_url_templater Upep-%04dr Uexit_status_levelr KUconfigr NUstrict_visitorr NUcloak_email_addressesr Utrim_footnote_reference_spacer Uenvr NUdump_pseudo_xmlr NUexpose_internalsr NUsectsubtitle_xformr U source_linkr NUrfc_referencesr NUoutput_encodingr Uutf-8r U source_urlr NUinput_encodingr U utf-8-sigr U_disable_configr NU id_prefixr UU tab_widthr KUerror_encodingr UUTF-8r U_sourcer h/Ugettext_compactr U generatorr NUdump_internalsr NU smart_quotesr U pep_base_urlr U https://www.python.org/dev/peps/r Usyntax_highlightr Ulongr Uinput_encoding_error_handlerr j Uauto_id_prefixr Uidr Udoctitle_xformr Ustrip_elements_with_classesr NU _config_filesr ]Ufile_insertion_enabledr U raw_enabledr KU dump_settingsr NubUsymbol_footnote_startr KUidsr }r (j jjVj^hj hh*jCjjjj*jhUhNjjNh9h,jjjOjKjjjjhjjjj: j6 j j jjjjjjj'j#jxjtj.j*jjhGhphhhhhhhhjjjjjjjjjjjjj<j8jjj,jjjj=jjj=jjj)j%hhjjbjijhjhjI j+j'jjjj{hhhh'jjjjjBj>j j jhjdjUjQuUsubstitution_namesr }r h0h=h2}r (h4]h7]h6]Usourceh/h5]h:]uU footnotesr ]r Urefidsr }r ub.