Äcdocutils.nodes
document
q)Åq}q(U nametypesq}q(X(���harvester properties and their functionsqNX:���configuring a harvest site (instructions for site contact)qNX%���running harvester in a command windowqNX0���compose a harvest list (the harvest list editor)q NX���unregister with harvesterq
NX���review harvester reportsq NX���register with harvesterq NX���running harvesterq
NX���configuring harvesterqNX���reviewing harvest reportsqNX!���harvester and harvest list editorqNX ���running harvester as a servletqNX!���prepare eml documents for harvestqNuUsubstitution_defsq}qUparse_messagesq]qcdocutils.nodes
system_message
q)Åq}q(U rawsourceqU�Uparentqcdocutils.nodes
section
q )Åq }q (hU�hh )Åq }q (hU�hh )Åq!}q"(hU�hhUsourceq#Xc���/var/lib/jenkins/jobs/Metacat_stable/workspace/METACAT_2_7_2/docs/user/metacat/source/harvester.rstq$Utagnameq%Usectionq&U
attributesq'}q((Udupnamesq)]Uclassesq*]Ubackrefsq+]Uidsq,]q-U!harvester-and-harvest-list-editorq.aUnamesq/]q0hauUlineq1KUdocumentq2hUchildrenq3]q4(cdocutils.nodes
title
q5)Åq6}q7(hX!���Harvester and Harvest List Editorq8hh!h#h$h%Utitleq9h'}q:(h)]h*]h+]h,]h/]uh1Kh2hh3]q;cdocutils.nodes
Text
q<X!���Harvester and Harvest List Editorq=ÖÅq>}q?(hh8hh6ubaubcdocutils.nodes
paragraph
q@)ÅqA}qB(hXB��Metacat's Harvester is an optional feature that can be used to automatically
retrieve EML documents from one or more custom data management system (e.g.,
SRB or PostgreSQL) and to insert (or update) those documents to the home
repository. The local sites control when they are harvested, and which documents
are harvested.qChh!h#h$h%U paragraphqDh'}qE(h)]h*]h+]h,]h/]uh1Kh2hh3]qFh<XB��Metacat's Harvester is an optional feature that can be used to automatically
retrieve EML documents from one or more custom data management system (e.g.,
SRB or PostgreSQL) and to insert (or update) those documents to the home
repository. The local sites control when they are harvested, and which documents
are harvested.qGÖÅqH}qI(hhChhAubaubh@)ÅqJ}qK(hX¶��For example, the Long Term Ecological Research Network (LTER) uses the Metacat
Harvester to create a centralized repository of data stored on twenty-six
different sites that store EML metadata, but that use different data management
systems. Once the data have been harvested and placed into a centralized
repository, they are replicated to the KNB network, exposing the information
to an even larger scientific community.qLhh!h#h$h%hDh'}qM(h)]h*]h+]h,]h/]uh1K
h2hh3]qNh<X¶��For example, the Long Term Ecological Research Network (LTER) uses the Metacat
Harvester to create a centralized repository of data stored on twenty-six
different sites that store EML metadata, but that use different data management
systems. Once the data have been harvested and placed into a centralized
repository, they are replicated to the KNB network, exposing the information
to an even larger scientific community.qOÖÅqP}qQ(hhLhhJubaubh@)ÅqR}qS(hXM��Once the Harvester is properly configured, listed documents are retrieved and
uploaded on a regularly scheduled basis. You must configure both the home
Metacat and the remote sites (aka the "harvest sites") before using this
feature. Local sites must also provide the Metacat server with a list of
documents that should be harvested.qThh!h#h$h%hDh'}qU(h)]h*]h+]h,]h/]uh1Kh2hh3]qVh<XM��Once the Harvester is properly configured, listed documents are retrieved and
uploaded on a regularly scheduled basis. You must configure both the home
Metacat and the remote sites (aka the "harvest sites") before using this
feature. Local sites must also provide the Metacat server with a list of
documents that should be harvested.qWÖÅqX}qY(hhThhRubaubh )ÅqZ}q[(hU�hh!h#h$h%h&h'}q\(h)]h*]h+]h,]q]Uconfiguring-harvesterq^ah/]q_hauh1Kh2hh3]q`(h5)Åqa}qb(hX���Configuring HarvesterqchhZh#h$h%h9h'}qd(h)]h*]h+]h,]h/]uh1Kh2hh3]qeh<X���Configuring HarvesterqfÖÅqg}qh(hhchhaubaubh@)Åqi}qj(hX��Before you can use the Harvester to retrieve documents, you must configure the
feature using the settings in the metacat.properties file. Note that you must
also configure each site that the Harvester will connect to and retrieve
documents from (see section 7.2 for details).qkhhZh#h$h%hDh'}ql(h)]h*]h+]h,]h/]uh1Kh2hh3]qmh<X��Before you can use the Harvester to retrieve documents, you must configure the
feature using the settings in the metacat.properties file. Note that you must
also configure each site that the Harvester will connect to and retrieve
documents from (see section 7.2 for details).qnÖÅqo}qp(hhkhhiubaubh@)Åqq}qr(hXh���The Harvester configuration information is managed in the metacat.properties
file, which is located at::hhZh#h$h%hDh'}qs(h)]h*]h+]h,]h/]uh1K h2hh3]qth<Xg���The Harvester configuration information is managed in the metacat.properties
file, which is located at:quÖÅqv}qw(hXg���The Harvester configuration information is managed in the metacat.properties
file, which is located at:hhqubaubcdocutils.nodes
literal_block
qx)Åqy}qz(hX(���<CONTEXT_DIR>/WEB_INF/metacat.propertieshhZh#h$h%U
literal_blockq{h'}q|(U xml:spaceq}Upreserveq~h,]h+]h)]h*]h/]uh1K!h2hh3]qh<X(���<CONTEXT_DIR>/WEB_INF/metacat.propertiesqÄÖÅqÅ}qÇ(hU�hhyubaubh@)ÅqÉ}qÑ(hXP���The Harvester properties are grouped together and begin after the comment line::qÖhhZh#h$h%hDh'}qÜ(h)]h*]h+]h,]h/]uh1K#h2hh3]qáh<XO���The Harvester properties are grouped together and begin after the comment line:qàÖÅqâ}qä(hXO���The Harvester properties are grouped together and begin after the comment line:hhÉubaubhx)Åqã}qå(hX���# Harvester propertieshhZh#h$h%h{h'}qç(h}h~h,]h+]h)]h*]h/]uh1K%h2hh3]qéh<X���# Harvester propertiesqèÖÅqê}që(hU�hhãubaubh@)Åqí}qì(hXË���To configure Harvester, edit the metacat.properties and set appropriate values
for the harvesterAdministrator and smtpServer property. You may also wish to
customize the other Harvester paramaters, each discussed in the table below.qîhhZh#h$h%hDh'}qï(h)]h*]h+]h,]h/]uh1K'h2hh3]qñh<XË���To configure Harvester, edit the metacat.properties and set appropriate values
for the harvesterAdministrator and smtpServer property. You may also wish to
customize the other Harvester paramaters, each discussed in the table below.qóÖÅqò}qô(hhîhhíubaubeubh )Åqö}qõ(hU�hh!h#h$h%h&h'}qú(h)]h*]h+]h,]qùU(harvester-properties-and-their-functionsqûah/]qühauh1K,h2hh3]q†(h5)Åq°}q¢(hX(���Harvester Properties and their Functionsq£hhöh#h$h%h9h'}q§(h)]h*]h+]h,]h/]uh1K,h2hh3]q•h<X(���Harvester Properties and their Functionsq¶ÖÅqß}q®(hh£hh°ubaubcdocutils.nodes
table
q©)Åq™}q´(hU�hhöh#h$h%Utableq¨h'}q≠(h)]h*]h+]h,]h/]uh1Nh2hh3]qÆcdocutils.nodes
tgroup
qØ)Åq∞}q±(hU�h'}q≤(h,]h+]h)]h*]h/]UcolsKuhh™h3]q≥(cdocutils.nodes
colspec
q¥)Åqµ}q∂(hU�h'}q∑(h,]h+]h)]h*]h/]UcolwidthK$uhh∞h3]h%Ucolspecq∏ubh¥)Åqπ}q∫(hU�h'}qª(h,]h+]h)]h*]h/]UcolwidthKauhh∞h3]h%h∏ubh¥)Åqº}qΩ(hU�h'}qæ(h,]h+]h)]h*]h/]UcolwidthKuhh∞h3]h%h∏ubcdocutils.nodes
thead
qø)Åq¿}q¡(hU�h'}q¬(h)]h*]h+]h,]h/]uhh∞h3]q√cdocutils.nodes
row
qƒ)Åq≈}q∆(hU�h'}q«(h)]h*]h+]h,]h/]uhh¿h3]q»(cdocutils.nodes
entry
q…)Åq }qÀ(hU�h'}qÃ(h)]h*]h+]h,]h/]uhh≈h3]qÕh@)ÅqŒ}qœ(hX���Propertyq–hh h#h$h%hDh'}q—(h)]h*]h+]h,]h/]uh1K/h3]q“h<X���Propertyq”ÖÅq‘}q’(hh–hhŒubaubah%Uentryq÷ubh…)Åq◊}qÿ(hU�h'}qŸ(h)]h*]h+]h,]h/]uhh≈h3]q⁄h@)Åq€}q‹(hX���Description and Valuesq›hh◊h#h$h%hDh'}qfi(h)]h*]h+]h,]h/]uh1K/h3]qflh<X���Description and Valuesq‡ÖÅq·}q‚(hh›hh€ubaubah%h÷ubh…)Åq„}q‰(hU�h'}qÂ(h)]h*]h+]h,]h/]uhh≈h3]h%h÷ubeh%UrowqÊubah%UtheadqÁubcdocutils.nodes
tbody
qË)ÅqÈ}qÍ(hU�h'}qÎ(h)]h*]h+]h,]h/]uhh∞h3]qÏ(hƒ)ÅqÌ}qÓ(hU�h'}qÔ(h)]h*]h+]h,]h/]uhhÈh3]q(h…)ÅqÒ}qÚ(hU�h'}qÛ(h)]h*]h+]h,]h/]uhhÌh3]qÙh@)Åqı}qˆ(hX���connectToMetacatq˜hhÒh#h$h%hDh'}q¯(h)]h*]h+]h,]h/]uh1K1h3]q˘h<X���connectToMetacatq˙ÖÅq˚}q¸(hh˜hhıubaubah%h÷ubh…)Åq˝}q˛(hU�h'}qˇ(h)]h*]h+]h,]h/]uhhÌh3]r���(h@)År��}r��(hX ��Determine whether Harvester should connect to Metacat to upload retrieved documents.
Set to true (the default) under most circumstances. To test whether Harvester can
retrieve documents from a site without actually connecting to Metacat
to upload the documents, set the value to false.r��hh˝h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1K1h3]r��h<X ��Determine whether Harvester should connect to Metacat to upload retrieved documents.
Set to true (the default) under most circumstances. To test whether Harvester can
retrieve documents from a site without actually connecting to Metacat
to upload the documents, set the value to false.r��ÖÅr��}r��(hj��hj��ubaubh@)År ��}r
��(hX���Values: true/falser ��hh˝h#h$h%hDh'}r ��(h)]h*]h+]h,]h/]uh1K6h3]r
��h<X���Values: true/falser��ÖÅr��}r��(hj ��hj ��ubaubeh%h÷ubh…)År��}r��(hU�h'}r��(h)]h*]h+]h,]h/]uhhÌh3]h%h÷ubeh%hÊubhƒ)År��}r��(hU�h'}r��(h)]h*]h+]h,]h/]uhhÈh3]r��(h…)År��}r��(hU�h'}r��(h)]h*]h+]h,]h/]uhj��h3]r��h@)År ��}r ��(hX���delayr ��hj��h#h$h%hDh'}r ��(h)]h*]h+]h,]h/]uh1K8h3]r ��h<X���delayr!��ÖÅr"��}r#��(hj ��hj ��ubaubah%h÷ubh…)År$��}r%��(hU�h'}r&��(h)]h*]h+]h,]h/]uhj��h3]r'��(h@)År(��}r)��(hXœ���The number of hours that Harvester will wait before beginning its first harvest.
For example, if Harvester is run at 1:00 p.m., and the delay is set to 12,
Harvester will begin its first harvest at 1:00 a.m.r*��hj$��h#h$h%hDh'}r+��(h)]h*]h+]h,]h/]uh1K8h3]r,��h<Xœ���The number of hours that Harvester will wait before beginning its first harvest.
For example, if Harvester is run at 1:00 p.m., and the delay is set to 12,
Harvester will begin its first harvest at 1:00 a.m.r-��ÖÅr.��}r/��(hj*��hj(��ubaubh@)År0��}r1��(hX
���Default: 0r2��hj$��h#h$h%hDh'}r3��(h)]h*]h+]h,]h/]uh1K<h3]r4��h<X
���Default: 0r5��ÖÅr6��}r7��(hj2��hj0��ubaubeh%h÷ubh…)År8��}r9��(hU�h'}r:��(h)]h*]h+]h,]h/]uhj��h3]h%h÷ubeh%hÊubhƒ)År;��}r<��(hU�h'}r=��(h)]h*]h+]h,]h/]uhhÈh3]r>��(h…)År?��}r@��(hU�h'}rA��(h)]h*]h+]h,]h/]uhj;��h3]rB��h@)ÅrC��}rD��(hX���harvesterAdministratorrE��hj?��h#h$h%hDh'}rF��(h)]h*]h+]h,]h/]uh1K>h3]rG��h<X���harvesterAdministratorrH��ÖÅrI��}rJ��(hjE��hjC��ubaubah%h÷ubh…)ÅrK��}rL��(hU�h'}rM��(h)]h*]h+]h,]h/]uhj;��h3]rN��(h@)ÅrO��}rP��(hXÒ���The email address of the Harvester Administrator. Harvester will send
email reports to this address after every harvest. Enter multiple email addresses by separating
each address with a comma or semicolon (e.g., name1@abc.edu,name2@abc.edu).hjK��h#h$h%hDh'}rQ��(h)]h*]h+]h,]h/]uh1K>h3]rR��(h<X‘���The email address of the Harvester Administrator. Harvester will send
email reports to this address after every harvest. Enter multiple email addresses by separating
each address with a comma or semicolon (e.g., rS��ÖÅrT��}rU��(hX‘���The email address of the Harvester Administrator. Harvester will send
email reports to this address after every harvest. Enter multiple email addresses by separating
each address with a comma or semicolon (e.g., hjO��ubcdocutils.nodes
reference
rV��)ÅrW��}rX��(hX
���name1@abc.eduh'}rY��(UrefuriX���mailto:name1@abc.eduh,]h+]h)]h*]h/]uhjO��h3]rZ��h<X
���name1@abc.edur[��ÖÅr\��}r]��(hU�hjW��ubah%U referencer^��ubh<X���,name2@abc.edu).r_��ÖÅr`��}ra��(hX���,name2@abc.edu).hjO��ubeubh@)Årb��}rc��(hXX���Values: An email address, or multiple email addresses separated by commas or semi-colonsrd��hjK��h#h$h%hDh'}re��(h)]h*]h+]h,]h/]uh1KBh3]rf��h<XX���Values: An email address, or multiple email addresses separated by commas or semi-colonsrg��ÖÅrh��}ri��(hjd��hjb��ubaubeh%h÷ubh…)Årj��}rk��(hU�h'}rl��(h)]h*]h+]h,]h/]uhj;��h3]h%h÷ubeh%hÊubhƒ)Årm��}rn��(hU�h'}ro��(h)]h*]h+]h,]h/]uhhÈh3]rp��(h…)Årq��}rr��(hU�h'}rs��(h)]h*]h+]h,]h/]uhjm��h3]rt��h@)Åru��}rv��(hX ���logPeriodrw��hjq��h#h$h%hDh'}rx��(h)]h*]h+]h,]h/]uh1KDh3]ry��h<X ���logPeriodrz��ÖÅr{��}r|��(hjw��hju��ubaubah%h÷ubh…)År}��}r~��(hU�h'}r��(h)]h*]h+]h,]h/]uhjm��h3]rÄ��(h@)ÅrÅ��}rÇ��(hX;��The number of days to retain Harvester log entries. Harvester log entries
record information such as which documents were harvested, from which sites,
and whether any errors were encountered during the harvest. Log entries older
than logPeriod number of days are purged from the database at the end of each harvest.r��hj}��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1KDh3]r��h<X;��The number of days to retain Harvester log entries. Harvester log entries
record information such as which documents were harvested, from which sites,
and whether any errors were encountered during the harvest. Log entries older
than logPeriod number of days are purged from the database at the end of each harvest.rÜ��ÖÅrá��}rà��(hjÉ��hjÅ��ubaubh@)Årâ��}rä��(hX ���Default: 90rã��hj}��h#h$h%hDh'}rå��(h)]h*]h+]h,]h/]uh1KIh3]rç��h<X ���Default: 90ré��ÖÅrè��}rê��(hjã��hjâ��ubaubeh%h÷ubh…)Årë��}rí��(hU�h'}rì��(h)]h*]h+]h,]h/]uhjm��h3]h%h÷ubeh%hÊubhƒ)Årî��}rï��(hU�h'}rñ��(h)]h*]h+]h,]h/]uhhÈh3]ró��(h…)Årò��}rô��(hU�h'}rö��(h)]h*]h+]h,]h/]uhjî��h3]rõ��h@)Årú��}rù��(hX ���maxHarvestsrû��hjò��h#h$h%hDh'}rü��(h)]h*]h+]h,]h/]uh1KKh3]r†��h<X ���maxHarvestsr°��ÖÅr¢��}r£��(hjû��hjú��ubaubah%h÷ubh…)År§��}r•��(hU�h'}r¶��(h)]h*]h+]h,]h/]uhjî��h3]rß��(h@)År®��}r©��(hXµ���The maximum number of harvests that Harvester should execute before
shutting down. If the value of maxHarvests is set to 0 or a
negative number, Harvester will execute indefinitely.r™��hj§��h#h$h%hDh'}r´��(h)]h*]h+]h,]h/]uh1KKh3]r¨��h<Xµ���The maximum number of harvests that Harvester should execute before
shutting down. If the value of maxHarvests is set to 0 or a
negative number, Harvester will execute indefinitely.r≠��ÖÅrÆ��}rØ��(hj™��hj®��ubaubh@)År∞��}r±��(hX
���Default: 0r≤��hj§��h#h$h%hDh'}r≥��(h)]h*]h+]h,]h/]uh1KOh3]r¥��h<X
���Default: 0rµ��ÖÅr∂��}r∑��(hj≤��hj∞��ubaubeh%h÷ubh…)År∏��}rπ��(hU�h'}r∫��(h)]h*]h+]h,]h/]uhjî��h3]h%h÷ubeh%hÊubhƒ)Årª��}rº��(hU�h'}rΩ��(h)]h*]h+]h,]h/]uhhÈh3]ræ��(h…)Årø��}r¿��(hU�h'}r¡��(h)]h*]h+]h,]h/]uhjª��h3]r¬��h@)År√��}rƒ��(hX���periodr≈��hjø��h#h$h%hDh'}r∆��(h)]h*]h+]h,]h/]uh1KQh3]r«��h<X���periodr»��ÖÅr…��}r ��(hj≈��hj√��ubaubah%h÷ubh…)ÅrÀ��}rÃ��(hU�h'}rÕ��(h)]h*]h+]h,]h/]uhjª��h3]rŒ��(h@)Årœ��}r–��(hX’���The number of hours between harvests. Harvester will run a new harvest
every specified period of hours (either indefinitely or until the maximum
number of harvests have run, depending on the value of maxHarvests).r—��hjÀ��h#h$h%hDh'}r“��(h)]h*]h+]h,]h/]uh1KQh3]r”��h<X’���The number of hours between harvests. Harvester will run a new harvest
every specified period of hours (either indefinitely or until the maximum
number of harvests have run, depending on the value of maxHarvests).r‘��ÖÅr’��}r÷��(hj—��hjœ��ubaubh@)År◊��}rÿ��(hX ���Default: 24rŸ��hjÀ��h#h$h%hDh'}r⁄��(h)]h*]h+]h,]h/]uh1KUh3]r€��h<X ���Default: 24r‹��ÖÅr›��}rfi��(hjŸ��hj◊��ubaubeh%h÷ubh…)Årfl��}r‡��(hU�h'}r·��(h)]h*]h+]h,]h/]uhjª��h3]h%h÷ubeh%hÊubhƒ)År‚��}r„��(hU�h'}r‰��(h)]h*]h+]h,]h/]uhhÈh3]rÂ��(h…)ÅrÊ��}rÁ��(hU�h'}rË��(h)]h*]h+]h,]h/]uhj‚��h3]rÈ��h@)ÅrÍ��}rÎ��(hX
���smtpServerr��hj��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1KWh3]r��h<X
���smtpServerrÔ��ÖÅr��}rÒ��(hjÏ��hjÍ��ubaubah%h÷ubh…)ÅrÚ��}rÛ��(hU�h'}rÙ��(h)]h*]h+]h,]h/]uhj‚��h3]rı��(h@)Årˆ��}r˜��(hX˜���The SMTP server that Harvester uses for sending email messages to the
Harvester Administrator and Site Contacts.
(e.g., somehost.institution.edu). Note that the default value only works
if the Harvester host machine is configured as a SMTP server.r¯��hjÚ��h#h$h%hDh'}r˘��(h)]h*]h+]h,]h/]uh1KWh3]r˙��h<X˜���The SMTP server that Harvester uses for sending email messages to the
Harvester Administrator and Site Contacts.
(e.g., somehost.institution.edu). Note that the default value only works
if the Harvester host machine is configured as a SMTP server.r˚��ÖÅr¸��}r˝��(hj¯��hjˆ��ubaubh@)År˛��}rˇ��(hX���Default: localhostr���hjÚ��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1K\h3]r��h<X���Default: localhostr��ÖÅr��}r��(hj���hj˛��ubaubeh%h÷ubh…)År��}r��(hU�h'}r��(h)]h*]h+]h,]h/]uhj‚��h3]h%h÷ubeh%hÊubhƒ)År ��}r
��(hU�h'}r ��(h)]h*]h+]h,]h/]uhhÈh3]r ��(h…)År
��}r��(hU�h'}r��(h)]h*]h+]h,]h/]uhj ��h3]r��h@)År��}r��(hXA���Harvester Operation Properties
(GetDocError, GetDocSuccess, etc.)r��hj
��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1K^h3]r��h<XA���Harvester Operation Properties
(GetDocError, GetDocSuccess, etc.)r��ÖÅr��}r��(hj��hj��ubaubah%h÷ubh…)År��}r��(hU�h'}r��(h)]h*]h+]h,]h/]uhj ��h3]r ��h@)År ��}r ��(hXÍ���The Harvester Operation properties are used by Harvester to report information
about performed operations for inclusion in log entries and email messages.
Under most circumstances the values of these properties should not be modified.r ��hj��h#h$h%hDh'}r ��(h)]h*]h+]h,]h/]uh1K^h3]r!��h<X���The Harvester Operation properties are used by Harvester to report information
about performed operations for inclusion in log entries and email messages.
Under most circumstances the values of these properties should not be modified.r"��ÖÅr#��}r$��(hj ��hj ��ubaubah%h÷ubh…)År%��}r&��(hU�h'}r'��(h)]h*]h+]h,]h/]uhj ��h3]h%h÷ubeh%hÊubeh%Utbodyr(��ubeh%Utgroupr)��ubaubeubh h )År*��}r+��(hU�hh!h#h$h%h&h'}r,��(h)]h*]h+]h,]r-��Urunning-harvesterr.��ah/]r/��h
auh1M˝h2hh3]r0��(h5)År1��}r2��(hX���Running Harvesterr3��hj*��h#h$h%h9h'}r4��(h)]h*]h+]h,]h/]uh1M˝h2hh3]r5��h<X���Running Harvesterr6��ÖÅr7��}r8��(hj3��hj1��ubaubh@)År9��}r:��(hX:��The Harvester can be run as a servlet or in a command window. Under most
circumstances, Harvester is best run continuously as a background servlet
process. However, if you expect to use Harvester infrequently, or if wish only
to test that Harvester is functioning, it may desirable to run it from a
command window.r;��hj*��h#h$h%hDh'}r<��(h)]h*]h+]h,]h/]uh1M˛h2hh3]r=��h<X:��The Harvester can be run as a servlet or in a command window. Under most
circumstances, Harvester is best run continuously as a background servlet
process. However, if you expect to use Harvester infrequently, or if wish only
to test that Harvester is functioning, it may desirable to run it from a
command window.r>��ÖÅr?��}r@��(hj;��hj9��ubaubh )ÅrA��}rB��(hU�hj*��h#h$h%h&h'}rC��(h)]h*]h+]h,]rD��U running-harvester-as-a-servletrE��ah/]rF��hauh1Mh2hh3]rG��(h5)ÅrH��}rI��(hX ���Running Harvester as a ServletrJ��hjA��h#h$h%h9h'}rK��(h)]h*]h+]h,]h/]uh1Mh2hh3]rL��h<X ���Running Harvester as a ServletrM��ÖÅrN��}rO��(hjJ��hjH��ubaubh@)ÅrP��}rQ��(hX ���To run Harvester as a servlet:rR��hjA��h#h$h%hDh'}rS��(h)]h*]h+]h,]h/]uh1Mh2hh3]rT��h<X ���To run Harvester as a servlet:rU��ÖÅrV��}rW��(hjR��hjP��ubaubcdocutils.nodes
enumerated_list
rX��)ÅrY��}rZ��(hU�hjA��h#h$h%Uenumerated_listr[��h'}r\��(Usuffixr]��U.h,]h+]h)]Uprefixr^��U�h*]h/]Uenumtyper_��Uarabicr`��uh1Mh2hh3]ra��(cdocutils.nodes
list_item
rb��)Årc��}rd��(hXB��Remove the comment symbols around the HarvesterServlet entry in the
deployed Metacat web.xml ($TOMCAT_HOME/webapps/<context>/WEB-INF).
::
<!--
<servlet>
<servlet-name>HarvesterServlet</servlet-name>
<servlet-class>edu.ucsb.nceas.metacat.harvesterClient.HarvesterServlet</servlet-class>
<init-param>
<param-name>debug</param-name>
<param-value>1</param-value>
</init-param>
<init-param>
<param-name>listings</param-name>
<param-value>true</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
-->
hjY��h#h$h%U list_itemre��h'}rf��(h)]h*]h+]h,]h/]uh1Nh2hh3]rg��(cdocutils.nodes
definition_list
rh��)Åri��}rj��(hU�h'}rk��(h)]h*]h+]h,]h/]uhjc��h3]rl��cdocutils.nodes
definition_list_item
rm��)Årn��}ro��(hXá���Remove the comment symbols around the HarvesterServlet entry in the
deployed Metacat web.xml ($TOMCAT_HOME/webapps/<context>/WEB-INF).
hji��h#h$h%Udefinition_list_itemrp��h'}rq��(h)]h*]h+]h,]h/]uh1M h3]rr��(cdocutils.nodes
term
rs��)Årt��}ru��(hXC���Remove the comment symbols around the HarvesterServlet entry in therv��hjn��h#h$h%Utermrw��h'}rx��(h)]h*]h+]h,]h/]uh1M h3]ry��h<XC���Remove the comment symbols around the HarvesterServlet entry in therz��ÖÅr{��}r|��(hjv��hjt��ubaubcdocutils.nodes
definition
r}��)År~��}r��(hU�h'}rÄ��(h)]h*]h+]h,]h/]uhjn��h3]rÅ��h@)ÅrÇ��}rÉ��(hXB���deployed Metacat web.xml ($TOMCAT_HOME/webapps/<context>/WEB-INF).rÑ��hj~��h#h$h%hDh'}rÖ��(h)]h*]h+]h,]h/]uh1M h3]rÜ��h<XB���deployed Metacat web.xml ($TOMCAT_HOME/webapps/<context>/WEB-INF).rá��ÖÅrà��}râ��(hjÑ��hjÇ��ubaubah%U
definitionrä��ubeubah%Udefinition_listrã��ubhx)Årå��}rç��(hXë��<!--
<servlet>
<servlet-name>HarvesterServlet</servlet-name>
<servlet-class>edu.ucsb.nceas.metacat.harvesterClient.HarvesterServlet</servlet-class>
<init-param>
<param-name>debug</param-name>
<param-value>1</param-value>
</init-param>
<init-param>
<param-name>listings</param-name>
<param-value>true</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
-->hjc��h%h{h'}r�(h}h~h,]h+]h)]h*]h/]uh1M
h3]r�h<X�<!--
<servlet>
<servlet-name>HarvesterServlet</servlet-name>
<servlet-class>edu.ucsb.nceas.metacat.harvesterClient.HarvesterServlet</servlet-class>
<init-param>
<param-name>debug</param-name>
<param-value>1</param-value>
</init-param>
<init-param>
<param-name>listings</param-name>
<param-value>true</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
-->rê��ÖÅrë��}rí��(hU�hjå��ubaubeubjb��)Årì��}rî��(hX���Save the edited file.rï��hjY��h#h$h%je��h'}rñ��(h)]h*]h+]h,]h/]uh1Nh2hh3]ró��h@)Årò��}rô��(hjï��hjì��h#h$h%hDh'}rö��(h)]h*]h+]h,]h/]uh1M h3]rõ��h<X���Save the edited file.rú��ÖÅrù��}rû��(hjï��hjò��ubaubaubjb��)Årü��}r†��(hX���Restart Tomcat.
hjY��h#h$h%je��h'}r°��(h)]h*]h+]h,]h/]uh1Nh2hh3]r¢��h@)År£��}r§��(hX���Restart Tomcat.r•��hjü��h#h$h%hDh'}r¶��(h)]h*]h+]h,]h/]uh1M h3]rß��h<X���Restart Tomcat.r®��ÖÅr©��}r™��(hj•��hj£��ubaubaubeubh@)År´��}r¨��(hXú��About thirty seconds after you restart Tomcat, the Harvester servlet will
start executing. The first harvest will occur after the number of hours
specified in the metacat.properties file. The servlet will continue running
new harvests until the maximum number of harvests have been completed, or until
Tomcat shuts down (harvest frequency and maximum number of harvests are also
set in the Harvester properties).r≠��hjA��h#h$h%hDh'}rÆ��(h)]h*]h+]h,]h/]uh1M h2hh3]rØ��h<Xú��About thirty seconds after you restart Tomcat, the Harvester servlet will
start executing. The first harvest will occur after the number of hours
specified in the metacat.properties file. The servlet will continue running
new harvests until the maximum number of harvests have been completed, or until
Tomcat shuts down (harvest frequency and maximum number of harvests are also
set in the Harvester properties).r∞��ÖÅr±��}r≤��(hj≠��hj´��ubaubeubh )År≥��}r¥��(hU�hj*��h#h$h%h&h'}rµ��(h)]h*]h+]h,]r∂��U%running-harvester-in-a-command-windowr∑��ah/]r∏��hauh1M(h2hh3]rπ��(h5)År∫��}rª��(hX%���Running Harvester in a Command Windowrº��hj≥��h#h$h%h9h'}rΩ��(h)]h*]h+]h,]h/]uh1M(h2hh3]ræ��h<X%���Running Harvester in a Command Windowrø��ÖÅr¿��}r¡��(hjº��hj∫��ubaubh@)År¬��}r√��(hX%���To run Harvester in a Command Window:rƒ��hj≥��h#h$h%hDh'}r≈��(h)]h*]h+]h,]h/]uh1M*h2hh3]r∆��h<X%���To run Harvester in a Command Window:r«��ÖÅr»��}r…��(hjƒ��hj¬��ubaubjX��)År ��}rÀ��(hU�hj≥��h#h$h%j[��h'}rÃ��(j]��U.h,]h+]h)]j^��U�h*]h/]j_��j`��uh1M,h2hh3]rÕ��(jb��)ÅrŒ��}rœ��(hX0���Open a system command window or terminal window.r–��hj ��h#h$h%je��h'}r—��(h)]h*]h+]h,]h/]uh1Nh2hh3]r“��h@)År”��}r‘��(hj–��hjŒ��h#h$h%hDh'}r’��(h)]h*]h+]h,]h/]uh1M,h3]r÷��h<X0���Open a system command window or terminal window.r◊��ÖÅrÿ��}rŸ��(hj–��hj”��ubaubaubjb��)År⁄��}r€��(hXÔ���Set the ``METACAT_HOME`` environment variable to the value of the
Metacat webapp deployment directory.
On Windows:
::
set METACAT_HOME=C:\somePath\metacat
On Linux/Unix (bash shell):
::
export METACAT_HOME=/home/somePath/metacat
hj ��h#h$h%je��h'}r‹��(h)]h*]h+]h,]h/]uh1Nh2hh3]r›��(h@)Årfi��}rfl��(hXf���Set the ``METACAT_HOME`` environment variable to the value of the
Metacat webapp deployment directory.hj⁄��h#h$h%hDh'}r‡��(h)]h*]h+]h,]h/]uh1M-h3]r·��(h<X���Set the r‚��ÖÅr„��}r‰��(hX���Set the hjfi��ubcdocutils.nodes
literal
rÂ��)ÅrÊ��}rÁ��(hX���``METACAT_HOME``h'}rË��(h)]h*]h+]h,]h/]uhjfi��h3]rÈ��h<X ���METACAT_HOMErÍ��ÖÅrÎ��}rÏ��(hU�hjÊ��ubah%UliteralrÌ��ubh<XN��� environment variable to the value of the
Metacat webapp deployment directory.rÓ��ÖÅrÔ��}r��(hXN��� environment variable to the value of the
Metacat webapp deployment directory.hjfi��ubeubh@)ÅrÒ��}rÚ��(hX ���On Windows:rÛ��hj⁄��h#h$h%hDh'}rÙ��(h)]h*]h+]h,]h/]uh1M0h3]rı��h<X ���On Windows:rˆ��ÖÅr˜��}r¯��(hjÛ��hjÒ��ubaubhx)År˘��}r˙��(hX$���set METACAT_HOME=C:\somePath\metacathj⁄��h%h{h'}r˚��(h}h~h,]h+]h)]h*]h/]uh1M4h3]r¸��h<X$���set METACAT_HOME=C:\somePath\metacatr˝��ÖÅr˛��}rˇ��(hU�hj˘��ubaubh@)År���}r��(hX���On Linux/Unix (bash shell):r��hj⁄��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1M6h3]r��h<X���On Linux/Unix (bash shell):r��ÖÅr��}r��(hj��hj���ubaubhx)År��}r ��(hX*���export METACAT_HOME=/home/somePath/metacathj⁄��h%h{h'}r
��(h}h~h,]h+]h)]h*]h/]uh1M:h3]r ��h<X*���export METACAT_HOME=/home/somePath/metacatr ��ÖÅr
��}r��(hU�hj��ubaubeubjb��)År��}r��(hXâ���cd to the following directory:
On Windows:
::
cd %METACAT_HOME%\lib\harvester
On Linux/Unix:
::
cd $METACAT_HOME/lib/harvester
hj ��h#h$h%je��h'}r��(h)]h*]h+]h,]h/]uh1Nh2hh3]r��(h@)År��}r��(hX ���cd to the following directory:r��hj��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1M<h3]r��h<X ���cd to the following directory:r��ÖÅr��}r��(hj��hj��ubaubh@)År��}r ��(hX ���On Windows:r ��hj��h#h$h%hDh'}r ��(h)]h*]h+]h,]h/]uh1M>h3]r ��h<X ���On Windows:r ��ÖÅr!��}r"��(hj ��hj��ubaubhx)År#��}r$��(hX ���cd %METACAT_HOME%\lib\harvesterhj��h%h{h'}r%��(h}h~h,]h+]h)]h*]h/]uh1MBh3]r&��h<X ���cd %METACAT_HOME%\lib\harvesterr'��ÖÅr(��}r)��(hU�hj#��ubaubh@)År*��}r+��(hX���On Linux/Unix:r,��hj��h#h$h%hDh'}r-��(h)]h*]h+]h,]h/]uh1MDh3]r.��h<X���On Linux/Unix:r/��ÖÅr0��}r1��(hj,��hj*��ubaubhx)År2��}r3��(hX ���cd $METACAT_HOME/lib/harvesterhj��h%h{h'}r4��(h}h~h,]h+]h)]h*]h/]uh1MHh3]r5��h<X ���cd $METACAT_HOME/lib/harvesterr6��ÖÅr7��}r8��(hU�hj2��ubaubeubjb��)År9��}r:��(hXø���Run the appropriate Harvester shell script, as determined by the operating system:
On Windows:
::
runHarvester.bat %METACAT_HOME%
On Linux/Unix:
::
sh runHarvester.sh $METACAT_HOME
hj ��h#h$h%je��h'}r;��(h)]h*]h+]h,]h/]uh1Nh2hh3]r<��(h@)År=��}r>��(hXR���Run the appropriate Harvester shell script, as determined by the operating system:r?��hj9��h#h$h%hDh'}r@��(h)]h*]h+]h,]h/]uh1MJh3]rA��h<XR���Run the appropriate Harvester shell script, as determined by the operating system:rB��ÖÅrC��}rD��(hj?��hj=��ubaubh@)ÅrE��}rF��(hX ���On Windows:rG��hj9��h#h$h%hDh'}rH��(h)]h*]h+]h,]h/]uh1MLh3]rI��h<X ���On Windows:rJ��ÖÅrK��}rL��(hjG��hjE��ubaubhx)ÅrM��}rN��(hX ���runHarvester.bat %METACAT_HOME%hj9��h%h{h'}rO��(h}h~h,]h+]h)]h*]h/]uh1MPh3]rP��h<X ���runHarvester.bat %METACAT_HOME%rQ��ÖÅrR��}rS��(hU�hjM��ubaubh@)ÅrT��}rU��(hX���On Linux/Unix:rV��hj9��h#h$h%hDh'}rW��(h)]h*]h+]h,]h/]uh1MRh3]rX��h<X���On Linux/Unix:rY��ÖÅrZ��}r[��(hjV��hjT��ubaubhx)År\��}r]��(hX ���sh runHarvester.sh $METACAT_HOMEhj9��h%h{h'}r^��(h}h~h,]h+]h)]h*]h/]uh1MVh3]r_��h<X ���sh runHarvester.sh $METACAT_HOMEr`��ÖÅra��}rb��(hU�hj\��ubaubeubeubh@)Årc��}rd��(hX•��The Harvester application will start executing. The first harvest will occur
after the number of hours specified in the ``metacat.properties file``. The
servlet will continue running new harvests until the maximum number of harvests
have been completed, or until you interrupt the process by hitting CTRL/C in
the command window (harvest frequency and maximum number of harvests are also
set in the Harvester properties).hj≥��h#h$h%hDh'}re��(h)]h*]h+]h,]h/]uh1MXh2hh3]rf��(h<Xx���The Harvester application will start executing. The first harvest will occur
after the number of hours specified in the rg��ÖÅrh��}ri��(hXx���The Harvester application will start executing. The first harvest will occur
after the number of hours specified in the hjc��ubjÂ��)Årj��}rk��(hX���``metacat.properties file``h'}rl��(h)]h*]h+]h,]h/]uhjc��h3]rm��h<X���metacat.properties filern��ÖÅro��}rp��(hU�hjj��ubah%jÌ��ubh<X��. The
servlet will continue running new harvests until the maximum number of harvests
have been completed, or until you interrupt the process by hitting CTRL/C in
the command window (harvest frequency and maximum number of harvests are also
set in the Harvester properties).rq��ÖÅrr��}rs��(hX��. The
servlet will continue running new harvests until the maximum number of harvests
have been completed, or until you interrupt the process by hitting CTRL/C in
the command window (harvest frequency and maximum number of harvests are also
set in the Harvester properties).hjc��ubeubeubeubh )Årt��}ru��(hU�hh!h#h$h%h&h'}rv��(h)]h*]h+]h,]rw��Ureviewing-harvest-reportsrx��ah/]ry��hauh1M`h2hh3]rz��(h5)År{��}r|��(hX���Reviewing Harvest Reportsr}��hjt��h#h$h%h9h'}r~��(h)]h*]h+]h,]h/]uh1M`h2hh3]r��h<X���Reviewing Harvest ReportsrÄ��ÖÅrÅ��}rÇ��(hj}��hj{��ubaubh@)ÅrÉ��}rÑ��(hXõ��Harvester sends an email report to the Harvester Administrator after every
harvest. The report contains information about the performed operations, such
as which sites were harvested as well as which EML documents were harvested
and whether any errors were encountered. Errors are indicated by operations
that display a status value of 1; a status value of 0 indicates that the
operation completed successfully.rÖ��hjt��h#h$h%hDh'}rÜ��(h)]h*]h+]h,]h/]uh1Mah2hh3]rá��h<Xõ��Harvester sends an email report to the Harvester Administrator after every
harvest. The report contains information about the performed operations, such
as which sites were harvested as well as which EML documents were harvested
and whether any errors were encountered. Errors are indicated by operations
that display a status value of 1; a status value of 0 indicates that the
operation completed successfully.rà��ÖÅrâ��}rä��(hjÖ��hjÉ��ubaubh@)Årã��}rå��(hXV��The Harvester Administrator should review the report, paying particularly
close attention to any reported errors and accompanying error messages. When
errors are reported at a particular site, the Harvester Administrator should
contact the Site Contact to determine the source of the error and its
resolution. Common causes of errors include:r�hjt��h#h$h%hDh'}r�(h)]h*]h+]h,]h/]uh1Mhh2hh3]r�h<XV��The Harvester Administrator should review the report, paying particularly
close attention to any reported errors and accompanying error messages. When
errors are reported at a particular site, the Harvester Administrator should
contact the Site Contact to determine the source of the error and its
resolution. Common causes of errors include:rê��ÖÅrë��}rí��(hjç��hjã��ubaubcdocutils.nodes
bullet_list
rì��)Årî��}rï��(hU�hjt��h#h$h%U bullet_listrñ��h'}ró��(Ubulletrò��X���*h,]h+]h)]h*]h/]uh1Mnh2hh3]rô��(jb��)Årö��}rõ��(hXk���a document URL specified in the Harvest List does not match the location of the actual EML file on the diskrú��hjî��h#h$h%je��h'}rù��(h)]h*]h+]h,]h/]uh1Nh2hh3]rû��h@)Årü��}r†��(hjú��hjö��h#h$h%hDh'}r°��(h)]h*]h+]h,]h/]uh1Mnh3]r¢��h<Xk���a document URL specified in the Harvest List does not match the location of the actual EML file on the diskr£��ÖÅr§��}r•��(hjú��hjü��ubaubaubjb��)År¶��}rß��(hXV���the Harvest List does not contain valid XML as specified in the harvestList.xsd schemar®��hjî��h#h$h%je��h'}r©��(h)]h*]h+]h,]h/]uh1Nh2hh3]r™��h@)År´��}r¨��(hj®��hj¶��h#h$h%hDh'}r≠��(h)]h*]h+]h,]h/]uh1Moh3]rÆ��h<XV���the Harvest List does not contain valid XML as specified in the harvestList.xsd schemarØ��ÖÅr∞��}r±��(hj®��hj´��ubaubaubjb��)År≤��}r≥��(hX~���the URL to the Harvest List (specified during registration) does not match the actual location of the Harvest List on the diskr¥��hjî��h#h$h%je��h'}rµ��(h)]h*]h+]h,]h/]uh1Nh2hh3]r∂��h@)År∑��}r∏��(hj¥��hj≤��h#h$h%hDh'}rπ��(h)]h*]h+]h,]h/]uh1Mph3]r∫��h<X~���the URL to the Harvest List (specified during registration) does not match the actual location of the Harvest List on the diskrª��ÖÅrº��}rΩ��(hj¥��hj∑��ubaubaubjb��)Åræ��}rø��(hXY���an EML document that Harvester attempted to upload to Metacat does not contain valid EML
hjî��h#h$h%je��h'}r¿��(h)]h*]h+]h,]h/]uh1Nh2hh3]r¡��h@)År¬��}r√��(hXX���an EML document that Harvester attempted to upload to Metacat does not contain valid EMLrƒ��hjæ��h#h$h%hDh'}r≈��(h)]h*]h+]h,]h/]uh1Mqh3]r∆��h<XX���an EML document that Harvester attempted to upload to Metacat does not contain valid EMLr«��ÖÅr»��}r…��(hjƒ��hj¬��ubaubaubeubh@)År ��}rÀ��(hX◊���Errors that are independent of a particular site may indicate a problem with
Harvester itself, Metacat, or the database connection. Refer to the error
message to determine the source of the error and its resolution.rÃ��hjt��h#h$h%hDh'}rÕ��(h)]h*]h+]h,]h/]uh1Msh2hh3]rŒ��h<X◊���Errors that are independent of a particular site may indicate a problem with
Harvester itself, Metacat, or the database connection. Refer to the error
message to determine the source of the error and its resolution.rœ��ÖÅr–��}r—��(hjÃ��hj ��ubaubeubeubh#h$h%h&h'}r“��(h)]h*]h+]h,]r”��U8configuring-a-harvest-site-instructions-for-site-contactr‘��ah/]r’��hauh1Kdh2hh3]r÷��(h5)År◊��}rÿ��(hX:���Configuring a Harvest Site (Instructions for Site Contact)rŸ��hh h#h$h%h9h'}r⁄��(h)]h*]h+]h,]h/]uh1Kdh2hh3]r€��h<X:���Configuring a Harvest Site (Instructions for Site Contact)r‹��ÖÅr›��}rfi��(hjŸ��hj◊��ubaubh@)Årfl��}r‡��(hXè��After Metacat's Harvester has been configured, remote sites can register and
send information about which files should be retrieved. Each remote site must
have a site contact who is responsible for registering the site and creating a
list of EML files to harvest (the "Harvest List"), as well as for reviewing
harvest reports. The site contact can unregister the site from the Harvester
at any time.r·��hh h#h$h%hDh'}r‚��(h)]h*]h+]h,]h/]uh1Kfh2hh3]r„��h<Xè��After Metacat's Harvester has been configured, remote sites can register and
send information about which files should be retrieved. Each remote site must
have a site contact who is responsible for registering the site and creating a
list of EML files to harvest (the "Harvest List"), as well as for reviewing
harvest reports. The site contact can unregister the site from the Harvester
at any time.r‰��ÖÅrÂ��}rÊ��(hj·��hjfl��ubaubh@)ÅrÁ��}rË��(hX���To use Harvester:rÈ��hh h#h$h%hDh'}rÍ��(h)]h*]h+]h,]h/]uh1Kmh2hh3]rÎ��h<X���To use Harvester:rÏ��ÖÅrÌ��}rÓ��(hjÈ��hjÁ��ubaubjX��)ÅrÔ��}r��(hU�hh h#h$h%j[��h'}rÒ��(j]��U.h,]h+]h)]j^��U�h*]h/]j_��j`��uh1Koh2hh3]rÚ��(jb��)ÅrÛ��}rÙ��(hX���Register with Harvesterrı��hjÔ��h#h$h%je��h'}rˆ��(h)]h*]h+]h,]h/]uh1Nh2hh3]r˜��h@)År¯��}r˘��(hjı��hjÛ��h#h$h%hDh'}r˙��(h)]h*]h+]h,]h/]uh1Koh3]r˚��h<X���Register with Harvesterr¸��ÖÅr˝��}r˛��(hjı��hj¯��ubaubaubjb��)Årˇ��}r���(hXL���Compose a Harvest List (you will likely wish to use the Harvest List Editor)r��hjÔ��h#h$h%je��h'}r��(h)]h*]h+]h,]h/]uh1Nh2hh3]r��h@)År��}r��(hj��hjˇ��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1Kph3]r��h<XL���Compose a Harvest List (you will likely wish to use the Harvest List Editor)r��ÖÅr ��}r
��(hj��hj��ubaubaubjb��)År ��}r ��(hX&���Prepare your EML Documents for Harvestr
��hjÔ��h#h$h%je��h'}r��(h)]h*]h+]h,]h/]uh1Nh2hh3]r��h@)År��}r��(hj
��hj ��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1Kqh3]r��h<X&���Prepare your EML Documents for Harvestr��ÖÅr��}r��(hj
��hj��ubaubaubjb��)År��}r��(hX ���Review the Harvester Reports
hjÔ��h#h$h%je��h'}r��(h)]h*]h+]h,]h/]uh1Nh2hh3]r��h@)År��}r ��(hX ���Review the Harvester Reportsr ��hj��h#h$h%hDh'}r ��(h)]h*]h+]h,]h/]uh1Krh3]r ��h<X ���Review the Harvester Reportsr ��ÖÅr!��}r"��(hj ��hj��ubaubaubeubh h )År#��}r$��(hU�hh h#h$h%h&h'}r%��(h)]h*]h+]h,]r&��U.compose-a-harvest-list-the-harvest-list-editorr'��ah/]r(��h auh1K≠h2hh3]r)��(h5)År*��}r+��(hX0���Compose a Harvest List (The Harvest List Editor)r,��hj#��h#h$h%h9h'}r-��(h)]h*]h+]h,]h/]uh1K≠h2hh3]r.��h<X0���Compose a Harvest List (The Harvest List Editor)r/��ÖÅr0��}r1��(hj,��hj*��ubaubh@)År2��}r3��(hX‘��The Harvest List is an XML file that contains a list of documents to be harvested.
The list is created by the site contact and stored on the site contact's site
at the location specified during the Harvester registration process (see
previous section for details). The list can be generated by hand, or you can
use Metacat's Harvest List Editor to automatically generate and structure the
list to conform to the required XML schema (displayed in figure at the end of
this section). In this section we will look at what information is required when
building a Harvest List, and how to configure and use the Harvest List Editor.
Note that you must have a source distribution of Metacat in order to use the
Harvest List Editor.r4��hj#��h#h$h%hDh'}r5��(h)]h*]h+]h,]h/]uh1KÆh2hh3]r6��h<X‘��The Harvest List is an XML file that contains a list of documents to be harvested.
The list is created by the site contact and stored on the site contact's site
at the location specified during the Harvester registration process (see
previous section for details). The list can be generated by hand, or you can
use Metacat's Harvest List Editor to automatically generate and structure the
list to conform to the required XML schema (displayed in figure at the end of
this section). In this section we will look at what information is required when
building a Harvest List, and how to configure and use the Harvest List Editor.
Note that you must have a source distribution of Metacat in order to use the
Harvest List Editor.r7��ÖÅr8��}r9��(hj4��hj2��ubaubh@)År:��}r;��(hXÃ���The Harvest List contains information that helps Metacat identify and retrieve
each specified EML file. Each document in the list must be described with a
docid, documentType, and documentURL (see table).r<��hj#��h#h$h%hDh'}r=��(h)]h*]h+]h,]h/]uh1Kπh2hh3]r>��h<XÃ���The Harvest List contains information that helps Metacat identify and retrieve
each specified EML file. Each document in the list must be described with a
docid, documentType, and documentURL (see table).r?��ÖÅr@��}rA��(hj<��hj:��ubaubh@)ÅrB��}rC��(hXŸ��Table: Information that must be included in the Harvest List about each EML file
+--------------+-------------------------------------------------------------------------------------------------+
| Item | Description |
+==============+=================================================================================================+
| docid | The docid uniquely identifies each EML document. Each docid consists of three elements: |
| | |
| | ``scope`` The document group to which the document belongs |
| | ``identifier`` A number that uniquely identifies the document within the scope. |
| | ``revision`` Anumber that indicates the current revision. |
| | |
| | For example, a valid docid could be: demoDocument.1.5, where demoDocument represents |
| | the scope, 1 the identifier, and 5 the revision number. |
+--------------+-------------------------------------------------------------------------------------------------+
| documentType | The documentType identifies the type of document as EML |
| | e.g., "eml://ecoinformatics.org/eml-2.0.0". |
+--------------+-------------------------------------------------------------------------------------------------+
| documentURL | The documentURL specifies a place where Harvester can locate and retrieve the |
| | document via HTTP. The Metacat Harvester must be given read access to the contents at this URL. |
| | e.g. "http://www.lternet.edu/~dcosta/document1.xml". |
+--------------+-------------------------------------------------------------------------------------------------+hj#��h#h$h%hDh'}rD��(h)]h*]h+]h,]h/]uh1KΩh2hh3]rE��(h<X°��Table: Information that must be included in the Harvest List about each EML file
+--------------+-------------------------------------------------------------------------------------------------+
| Item | Description |
+==============+=================================================================================================+
| docid | The docid uniquely identifies each EML document. Each docid consists of three elements: |
| | |
| | rF��ÖÅrG��}rH��(hX°��Table: Information that must be included in the Harvest List about each EML file
+--------------+-------------------------------------------------------------------------------------------------+
| Item | Description |
+==============+=================================================================================================+
| docid | The docid uniquely identifies each EML document. Each docid consists of three elements: |
| | |
| | hjB��ubjÂ��)ÅrI��}rJ��(hX ���``scope``h'}rK��(h)]h*]h+]h,]h/]uhjB��h3]rL��h<X���scoperM��ÖÅrN��}rO��(hU�hjI��ubah%jÌ��ubh<Xj��� The document group to which the document belongs |
| | rP��ÖÅrQ��}rR��(hXj��� The document group to which the document belongs |
| | hjB��ubjÂ��)ÅrS��}rT��(hX���``identifier``h'}rU��(h)]h*]h+]h,]h/]uhjB��h3]rV��h<X
���identifierrW��ÖÅrX��}rY��(hU�hjS��ubah%jÌ��ubh<Xe��� A number that uniquely identifies the document within the scope. |
| | rZ��ÖÅr[��}r\��(hXe��� A number that uniquely identifies the document within the scope. |
| | hjB��ubjÂ��)År]��}r^��(hX ���``revision``h'}r_��(h)]h*]h+]h,]h/]uhjB��h3]r`��h<X���revisionra��ÖÅrb��}rc��(hU�hj]��ubah%jÌ��ubh<XF�� Anumber that indicates the current revision. |
| | |
| | For example, a valid docid could be: demoDocument.1.5, where demoDocument represents |
| | the scope, 1 the identifier, and 5 the revision number. |
+--------------+-------------------------------------------------------------------------------------------------+
| documentType | The documentType identifies the type of document as EML |
| | e.g., "eml://ecoinformatics.org/eml-2.0.0". |
+--------------+-------------------------------------------------------------------------------------------------+
| documentURL | The documentURL specifies a place where Harvester can locate and retrieve the |
| | document via HTTP. The Metacat Harvester must be given read access to the contents at this URL. |
| | e.g. "http://www.lternet.edu/~dcosta/document1.xml". |
+--------------+-------------------------------------------------------------------------------------------------+rd��ÖÅre��}rf��(hXF�� Anumber that indicates the current revision. |
| | |
| | For example, a valid docid could be: demoDocument.1.5, where demoDocument represents |
| | the scope, 1 the identifier, and 5 the revision number. |
+--------------+-------------------------------------------------------------------------------------------------+
| documentType | The documentType identifies the type of document as EML |
| | e.g., "eml://ecoinformatics.org/eml-2.0.0". |
+--------------+-------------------------------------------------------------------------------------------------+
| documentURL | The documentURL specifies a place where Harvester can locate and retrieve the |
| | document via HTTP. The Metacat Harvester must be given read access to the contents at this URL. |
| | e.g. "http://www.lternet.edu/~dcosta/document1.xml". |
+--------------+-------------------------------------------------------------------------------------------------+hjB��ubeubh@)Årg��}rh��(hX±���The example Harvest List below contains two <document> elements that specify the
information that Harvester needs to retrieve a pair of EML documents and
upload them to Metacat.ri��hj#��h#h$h%hDh'}rj��(h)]h*]h+]h,]h/]uh1K“h2hh3]rk��h<X±���The example Harvest List below contains two <document> elements that specify the
information that Harvester needs to retrieve a pair of EML documents and
upload them to Metacat.rl��ÖÅrm��}rn��(hji��hjg��ubaubhx)Åro��}rp��(hX ��<!-- Example Harvest List -->
<?xml version="1.0" encoding="UTF-8" ?>
<hrv:harvestList xmlns:hrv="eml://ecoinformatics.org/harvestList" >
<document>
<docid>
<scope>demoDocument</scope>
<identifier>1</identifier>
<revision>5</revision>
</docid>
<documentType>eml://ecoinformatics.org/eml-2.0.0</documentType>
<documentURL>http://www.lternet.edu/~dcosta/document1.xml</documentURL>
</document>
<document>
<docid>
<scope>demoDocument</scope>
<identifier>2</identifier>
<revision>1</revision>
</docid>
<documentType>eml://ecoinformatics.org/eml-2.0.0</documentType>
<documentURL>http://www.lternet.edu/~dcosta/document2.xml</documentURL>
</document>
</hrv:harvestList>hj#��h#h$h%h{h'}rq��(h}h~h,]h+]h)]h*]h/]uh1KŸh2hh3]rr��h<X ��<!-- Example Harvest List -->
<?xml version="1.0" encoding="UTF-8" ?>
<hrv:harvestList xmlns:hrv="eml://ecoinformatics.org/harvestList" >
<document>
<docid>
<scope>demoDocument</scope>
<identifier>1</identifier>
<revision>5</revision>
</docid>
<documentType>eml://ecoinformatics.org/eml-2.0.0</documentType>
<documentURL>http://www.lternet.edu/~dcosta/document1.xml</documentURL>
</document>
<document>
<docid>
<scope>demoDocument</scope>
<identifier>2</identifier>
<revision>1</revision>
</docid>
<documentType>eml://ecoinformatics.org/eml-2.0.0</documentType>
<documentURL>http://www.lternet.edu/~dcosta/document2.xml</documentURL>
</document>
</hrv:harvestList>rs��ÖÅrt��}ru��(hU�hjo��ubaubh@)Årv��}rw��(hXÖ��Rather than formatting the list by hand, you may wish to use Metacat's Harvest
List Editor to compose and edit it. The Harvest List Editor displays a Harvest
List as a table of rows and fields. Each table row corresponds to
a single <document> element in the corresponding Harvest List file (i.e., one
EML document). The row numbers are used only for visual reference and are
not editable.rx��hj#��h#h$h%hDh'}ry��(h)]h*]h+]h,]h/]uh1Kh2hh3]rz��h<X��Rather than formatting the list by hand, you may wish to use Metacat's Harvest
List Editor to compose and edit it. The Harvest List Editor displays a Harvest
List as a table of rows and fields. Each table row corresponds to
a single <document> element in the corresponding Harvest List file (i.e., one
EML document). The row numbers are used only for visual reference and are
not editable.r{��ÖÅr|��}r}��(hjx��hjv��ubaubh@)År~��}r��(hX”���To add a new document to the Harvest List, enter values for all five editable
fields (all fields except the "Row #" field). Partially filled-in rows will
cause errors that will result in an invalid Harvest List.rÄ��hj#��h#h$h%hDh'}rÅ��(h)]h*]h+]h,]h/]uh1K˜h2hh3]rÇ��h<X”���To add a new document to the Harvest List, enter values for all five editable
fields (all fields except the "Row #" field). Partially filled-in rows will
cause errors that will result in an invalid Harvest List.rÉ��ÖÅrÑ��}rÖ��(hjÄ��hj~��ubaubh@)ÅrÜ��}rá��(hXÍ��The buttons at the bottom of the Editor can be used to Cut, Copy, and Paste
rows from one location to another. Select a row and click the desired button,
or paste the default values (which are specified in the Editor's configuration
file, discussed later in this section) into the currently selected row by
clicking the Paste Defaults button. Note: Only one row can be selected at any
given time: all cut, copy, and paste operations work on only a single row
rather than on a range of rows.rà��hj#��h#h$h%hDh'}râ��(h)]h*]h+]h,]h/]uh1K˚h2hh3]rä��h<XÍ��The buttons at the bottom of the Editor can be used to Cut, Copy, and Paste
rows from one location to another. Select a row and click the desired button,
or paste the default values (which are specified in the Editor's configuration
file, discussed later in this section) into the currently selected row by
clicking the Paste Defaults button. Note: Only one row can be selected at any
given time: all cut, copy, and paste operations work on only a single row
rather than on a range of rows.rã��ÖÅrå��}rç��(hjà��hjÜ��ubaubh@)Åré��}rè��(hX`���To run the Harvest List Editor, from the terminal on which the Metacat
source code is installed:r�hj#��h#h$h%hDh'}r�(h)]h*]h+]h,]h/]uh1Mh2hh3]r�h<X`���To run the Harvest List Editor, from the terminal on which the Metacat
source code is installed:rì��ÖÅrî��}rï��(hjê��hjé��ubaubjX��)Årñ��}ró��(hU�hj#��h#h$h%j[��h'}rò��(j]��U.h,]h+]h)]j^��U�h*]h/]j_��j`��uh1Mh2hh3]rô��(jb��)Årö��}rõ��(hX0���Open a system command window or terminal window.rú��hjñ��h#h$h%je��h'}rù��(h)]h*]h+]h,]h/]uh1Nh2hh3]rû��h@)Årü��}r†��(hjú��hjö��h#h$h%hDh'}r°��(h)]h*]h+]h,]h/]uh1Mh3]r¢��h<X0���Open a system command window or terminal window.r£��ÖÅr§��}r•��(hjú��hjü��ubaubaubjb��)År¶��}rß��(hX¸���Set the METACAT_HOME environment variable to the value of the Metacat
installation directory. Some examples follow:
On Windows:
::
set METACAT_HOME=C:\somePath\metacat
On Linux/Unix (bash shell):
::
export METACAT_HOME=/home/somePath/metacat
hjñ��h#h$h%je��h'}r®��(h)]h*]h+]h,]h/]uh1Nh2hh3]r©��(h@)År™��}r´��(hXs���Set the METACAT_HOME environment variable to the value of the Metacat
installation directory. Some examples follow:r¨��hj¶��h#h$h%hDh'}r≠��(h)]h*]h+]h,]h/]uh1Mh3]rÆ��h<Xs���Set the METACAT_HOME environment variable to the value of the Metacat
installation directory. Some examples follow:rØ��ÖÅr∞��}r±��(hj¨��hj™��ubaubh@)År≤��}r≥��(hX ���On Windows:r¥��hj¶��h#h$h%hDh'}rµ��(h)]h*]h+]h,]h/]uh1M
h3]r∂��h<X ���On Windows:r∑��ÖÅr∏��}rπ��(hj¥��hj≤��ubaubhx)År∫��}rª��(hX$���set METACAT_HOME=C:\somePath\metacathj¶��h%h{h'}rº��(h}h~h,]h+]h)]h*]h/]uh1Mh3]rΩ��h<X$���set METACAT_HOME=C:\somePath\metacatræ��ÖÅrø��}r¿��(hU�hj∫��ubaubh@)År¡��}r¬��(hX���On Linux/Unix (bash shell):r√��hj¶��h#h$h%hDh'}rƒ��(h)]h*]h+]h,]h/]uh1Mh3]r≈��h<X���On Linux/Unix (bash shell):r∆��ÖÅr«��}r»��(hj√��hj¡��ubaubhx)År…��}r ��(hX*���export METACAT_HOME=/home/somePath/metacathj¶��h%h{h'}rÀ��(h}h~h,]h+]h)]h*]h/]uh1Mh3]rÃ��h<X*���export METACAT_HOME=/home/somePath/metacatrÕ��ÖÅrŒ��}rœ��(hU�hj…��ubaubeubjb��)År–��}r—��(hXâ���cd to the following directory:
On Windows:
::
cd %METACAT_HOME%\lib\harvester
On Linux/Unix:
::
cd $METACAT_HOME/lib/harvester
hjñ��h#h$h%je��h'}r“��(h)]h*]h+]h,]h/]uh1Nh2hh3]r”��(h@)År‘��}r’��(hX ���cd to the following directory:r÷��hj–��h#h$h%hDh'}r◊��(h)]h*]h+]h,]h/]uh1Mh3]rÿ��h<X ���cd to the following directory:rŸ��ÖÅr⁄��}r€��(hj÷��hj‘��ubaubh@)År‹��}r›��(hX ���On Windows:rfi��hj–��h#h$h%hDh'}rfl��(h)]h*]h+]h,]h/]uh1Mh3]r‡��h<X ���On Windows:r·��ÖÅr‚��}r„��(hjfi��hj‹��ubaubhx)År‰��}rÂ��(hX ���cd %METACAT_HOME%\lib\harvesterhj–��h%h{h'}rÊ��(h}h~h,]h+]h)]h*]h/]uh1M h3]rÁ��h<X ���cd %METACAT_HOME%\lib\harvesterrË��ÖÅrÈ��}rÍ��(hU�hj‰��ubaubh@)ÅrÎ��}rÏ��(hX���On Linux/Unix:rÌ��hj–��h#h$h%hDh'}rÓ��(h)]h*]h+]h,]h/]uh1M h3]rÔ��h<X���On Linux/Unix:r��ÖÅrÒ��}rÚ��(hjÌ��hjÎ��ubaubhx)ÅrÛ��}rÙ��(hX ���cd $METACAT_HOME/lib/harvesterhj–��h%h{h'}rı��(h}h~h,]h+]h)]h*]h/]uh1M"h3]rˆ��h<X ���cd $METACAT_HOME/lib/harvesterr˜��ÖÅr¯��}r˘��(hU�hjÛ��ubaubeubjb��)År˙��}r˚��(hX÷���Run the appropriate Harvester shell script, as determined by the operating system:
On Windows:
::
runHarvestListEditor.bat
On Linux/Unix:
::
sh runHarvestListEditor.sh
The Harvest List Editor will open.
hjñ��h#h$h%je��h'}r¸��(h)]h*]h+]h,]h/]uh1Nh2hh3]r˝��(h@)År˛��}rˇ��(hXR���Run the appropriate Harvester shell script, as determined by the operating system:r���hj˙��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1M$h3]r��h<XR���Run the appropriate Harvester shell script, as determined by the operating system:r��ÖÅr��}r��(hj���hj˛��ubaubh@)År��}r��(hX ���On Windows:r��hj˙��h#h$h%hDh'}r ��(h)]h*]h+]h,]h/]uh1M&h3]r
��h<X ���On Windows:r ��ÖÅr ��}r
��(hj��hj��ubaubhx)År��}r��(hX���runHarvestListEditor.bathj˙��h%h{h'}r��(h}h~h,]h+]h)]h*]h/]uh1M*h3]r��h<X���runHarvestListEditor.batr��ÖÅr��}r��(hU�hj��ubaubh@)År��}r��(hX���On Linux/Unix:r��hj˙��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1M,h3]r��h<X���On Linux/Unix:r��ÖÅr��}r ��(hj��hj��ubaubhx)År ��}r ��(hX���sh runHarvestListEditor.shhj˙��h%h{h'}r ��(h}h~h,]h+]h)]h*]h/]uh1M0h3]r ��h<X���sh runHarvestListEditor.shr!��ÖÅr"��}r#��(hU�hj ��ubaubh@)År$��}r%��(hX"���The Harvest List Editor will open.r&��hj˙��h#h$h%hDh'}r'��(h)]h*]h+]h,]h/]uh1M2h3]r(��h<X"���The Harvest List Editor will open.r)��ÖÅr*��}r+��(hj&��hj$��ubaubeubeubh@)År,��}r-��(hX∑��If you would like to customize the Harvest List Editor (e.g., specify a
default list to open automatically whenever the editor is opened and/or
default values), create a file called .harvestListEditor (note the leading
dot character). Use a plain text editor to create the file and place the file
in the Site Contact's home directory. To determine the home directory, open a
system command window or terminal window and type the following:r.��hj#��h#h$h%hDh'}r/��(h)]h*]h+]h,]h/]uh1M4h2hh3]r0��h<X∑��If you would like to customize the Harvest List Editor (e.g., specify a
default list to open automatically whenever the editor is opened and/or
default values), create a file called .harvestListEditor (note the leading
dot character). Use a plain text editor to create the file and place the file
in the Site Contact's home directory. To determine the home directory, open a
system command window or terminal window and type the following:r1��ÖÅr2��}r3��(hj.��hj,��ubaubh@)År4��}r5��(hX ���On Windows:r6��hj#��h#h$h%hDh'}r7��(h)]h*]h+]h,]h/]uh1M;h2hh3]r8��h<X ���On Windows:r9��ÖÅr:��}r;��(hj6��hj4��ubaubhx)År<��}r=��(hX���echo %USERPROFILE%hj#��h#h$h%h{h'}r>��(h}h~h,]h+]h)]h*]h/]uh1M?h2hh3]r?��h<X���echo %USERPROFILE%r@��ÖÅrA��}rB��(hU�hj<��ubaubh@)ÅrC��}rD��(hX���On Linux/Unix:rE��hj#��h#h$h%hDh'}rF��(h)]h*]h+]h,]h/]uh1MAh2hh3]rG��h<X���On Linux/Unix:rH��ÖÅrI��}rJ��(hjE��hjC��ubaubhx)ÅrK��}rL��(hX
���echo $HOMEhj#��h#h$h%h{h'}rM��(h}h~h,]h+]h)]h*]h/]uh1MEh2hh3]rN��h<X
���echo $HOMErO��ÖÅrP��}rQ��(hU�hjK��ubaubh@)ÅrR��}rS��(hXÌ���The configuration file contains a number of optional properties that can make
using the Editor more convenient. A sample configure file is displayed below, and
more information about each configuration property is contained in the table.rT��hj#��h#h$h%hDh'}rU��(h)]h*]h+]h,]h/]uh1MGh2hh3]rV��h<X���The configuration file contains a number of optional properties that can make
using the Editor more convenient. A sample configure file is displayed below, and
more information about each configuration property is contained in the table.rW��ÖÅrX��}rY��(hjT��hjR��ubaubh@)ÅrZ��}r[��(hX.���A sample .harvestListEditor configuration filer\��hj#��h#h$h%hDh'}r]��(h)]h*]h+]h,]h/]uh1MKh2hh3]r^��h<X.���A sample .harvestListEditor configuration filer_��ÖÅr`��}ra��(hj\��hjZ��ubaubhx)Årb��}rc��(hX’���defaultHarvestList=C:/temp/harvestList.xml
defaultScope=demo_document
defaultIdentifier=1
defaultRevision=1
defaultDocumentURL=http://www.lternet.edu/~dcosta/
defaultDocumentType=eml://ecoinformatics.org/eml-2.0.0hj#��h#h$h%h{h'}rd��(h}h~h,]h+]h)]h*]h/]uh1MOh2hh3]re��h<X’���defaultHarvestList=C:/temp/harvestList.xml
defaultScope=demo_document
defaultIdentifier=1
defaultRevision=1
defaultDocumentURL=http://www.lternet.edu/~dcosta/
defaultDocumentType=eml://ecoinformatics.org/eml-2.0.0rf��ÖÅrg��}rh��(hU�hjb��ubaubh@)Åri��}rj��(hX,���Harvest List Editor Configuration Propertiesrk��hj#��h#h$h%hDh'}rl��(h)]h*]h+]h,]h/]uh1MVh2hh3]rm��h<X,���Harvest List Editor Configuration Propertiesrn��ÖÅro��}rp��(hjk��hji��ubaubh©)Årq��}rr��(hU�hj#��h#h$h%h¨h'}rs��(h)]h*]h+]h,]h/]uh1Nh2hh3]rt��hØ)Åru��}rv��(hU�h'}rw��(h,]h+]h)]h*]h/]UcolsKuhjq��h3]rx��(h¥)Åry��}rz��(hU�h'}r{��(h,]h+]h)]h*]h/]UcolwidthKuhju��h3]h%h∏ubh¥)År|��}r}��(hU�h'}r~��(h,]h+]h)]h*]h/]UcolwidthK^uhju��h3]h%h∏ubhø)År��}rÄ��(hU�h'}rÅ��(h)]h*]h+]h,]h/]uhju��h3]rÇ��hƒ)ÅrÉ��}rÑ��(hU�h'}rÖ��(h)]h*]h+]h,]h/]uhj��h3]rÜ��(h…)Årá��}rà��(hU�h'}râ��(h)]h*]h+]h,]h/]uhjÉ��h3]rä��h@)Årã��}rå��(hX���Propertyrç��hjá��h#h$h%hDh'}ré��(h)]h*]h+]h,]h/]uh1MYh3]rè��h<X���Propertyrê��ÖÅrë��}rí��(hjç��hjã��ubaubah%h÷ubh…)Årì��}rî��(hU�h'}rï��(h)]h*]h+]h,]h/]uhjÉ��h3]rñ��h@)Åró��}rò��(hX ���Descriptionrô��hjì��h#h$h%hDh'}rö��(h)]h*]h+]h,]h/]uh1MYh3]rõ��h<X ���Descriptionrú��ÖÅrù��}rû��(hjô��hjó��ubaubah%h÷ubeh%hÊubah%hÁubhË)Årü��}r†��(hU�h'}r°��(h)]h*]h+]h,]h/]uhju��h3]r¢��(hƒ)År£��}r§��(hU�h'}r•��(h)]h*]h+]h,]h/]uhjü��h3]r¶��(h…)Årß��}r®��(hU�h'}r©��(h)]h*]h+]h,]h/]uhj£��h3]r™��h@)År´��}r¨��(hX���defaultHarvestListr≠��hjß��h#h$h%hDh'}rÆ��(h)]h*]h+]h,]h/]uh1M[h3]rØ��h<X���defaultHarvestListr∞��ÖÅr±��}r≤��(hj≠��hj´��ubaubah%h÷ubh…)År≥��}r¥��(hU�h'}rµ��(h)]h*]h+]h,]h/]uhj£��h3]r∂��(h@)År∑��}r∏��(hX√���The location of a Harvest List file that the Editor will
automatically open for editing on startup. Set this property
to the path to the Harvest List file that you expect to edit most frequently.rπ��hj≥��h#h$h%hDh'}r∫��(h)]h*]h+]h,]h/]uh1M[h3]rª��h<X√���The location of a Harvest List file that the Editor will
automatically open for editing on startup. Set this property
to the path to the Harvest List file that you expect to edit most frequently.rº��ÖÅrΩ��}ræ��(hjπ��hj∑��ubaubh@)Årø��}r¿��(hXP���Examples:
``/home/jdoe/public_html/harvestList.xml``
``C:/temp/harvestList.xml``hj≥��h#h$h%hDh'}r¡��(h)]h*]h+]h,]h/]uh1M_h3]r¬��(h<X
���Examples:
r√��ÖÅrƒ��}r≈��(hX
���Examples:
hjø��ubjÂ��)År∆��}r«��(hX*���``/home/jdoe/public_html/harvestList.xml``h'}r»��(h)]h*]h+]h,]h/]uhjø��h3]r…��h<X&���/home/jdoe/public_html/harvestList.xmlr ��ÖÅrÀ��}rÃ��(hU�hj∆��ubah%jÌ��ubh<X���
ÖÅrÕ��}rŒ��(hX���
hjø��ubjÂ��)Årœ��}r–��(hX���``C:/temp/harvestList.xml``h'}r—��(h)]h*]h+]h,]h/]uhjø��h3]r“��h<X���C:/temp/harvestList.xmlr”��ÖÅr‘��}r’��(hU�hjœ��ubah%jÌ��ubeubeh%h÷ubeh%hÊubhƒ)År÷��}r◊��(hU�h'}rÿ��(h)]h*]h+]h,]h/]uhjü��h3]rŸ��(h…)År⁄��}r€��(hU�h'}r‹��(h)]h*]h+]h,]h/]uhj÷��h3]r›��h@)Årfi��}rfl��(hX ���defaultScoper‡��hj⁄��h#h$h%hDh'}r·��(h)]h*]h+]h,]h/]uh1Mch3]r‚��h<X ���defaultScoper„��ÖÅr‰��}rÂ��(hj‡��hjfi��ubaubah%h÷ubh…)ÅrÊ��}rÁ��(hU�h'}rË��(h)]h*]h+]h,]h/]uhj÷��h3]rÈ��(h@)ÅrÍ��}rÎ��(hXÿ���The value pasted into the Editor's Scope field when the Paste
Defaults button is clicked. The Scope field should contain
a symbolic identifier that indicates the family of documents
to which the EML document belongs.rÏ��hjÊ��h#h$h%hDh'}rÌ��(h)]h*]h+]h,]h/]uh1Mch3]rÓ��h<Xÿ���The value pasted into the Editor's Scope field when the Paste
Defaults button is clicked. The Scope field should contain
a symbolic identifier that indicates the family of documents
to which the EML document belongs.rÔ��ÖÅr��}rÒ��(hjÏ��hjÍ��ubaubh@)ÅrÚ��}rÛ��(hX*���Example: xyz_dataset
Default: datasetrÙ��hjÊ��h#h$h%hDh'}rı��(h)]h*]h+]h,]h/]uh1Mhh3]rˆ��h<X*���Example: xyz_dataset
Default: datasetr˜��ÖÅr¯��}r˘��(hjÙ��hjÚ��ubaubeh%h÷ubeh%hÊubhƒ)År˙��}r˚��(hU�h'}r¸��(h)]h*]h+]h,]h/]uhjü��h3]r˝��(h…)År˛��}rˇ��(hU�h'}r���(h)]h*]h+]h,]h/]uhj˙��h3]r��h@)År��}r��(hX���defaultIdentiferr��hj˛��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1Mkh3]r��h<X���defaultIdentiferr��ÖÅr��}r ��(hj��hj��ubaubah%h÷ubh…)År
��}r ��(hU�h'}r ��(h)]h*]h+]h,]h/]uhj˙��h3]r
��h@)År��}r��(hX⁄���The value pasted into the Editor's Identifier field when the
Paste Defaults button is clicked. The Scope field should contain
a numeric value indicating the identifier for this particular EML document within the Scope.r��hj
��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1Mkh3]r��h<X⁄���The value pasted into the Editor's Identifier field when the
Paste Defaults button is clicked. The Scope field should contain
a numeric value indicating the identifier for this particular EML document within the Scope.r��ÖÅr��}r��(hj��hj��ubaubah%h÷ubeh%hÊubhƒ)År��}r��(hU�h'}r��(h)]h*]h+]h,]h/]uhjü��h3]r��(h…)År��}r��(hU�h'}r ��(h)]h*]h+]h,]h/]uhj��h3]r ��h@)År ��}r ��(hX���defaultRevisionr ��hj��h#h$h%hDh'}r!��(h)]h*]h+]h,]h/]uh1Moh3]r"��h<X���defaultRevisionr#��ÖÅr$��}r%��(hj ��hj ��ubaubah%h÷ubh…)År&��}r'��(hU�h'}r(��(h)]h*]h+]h,]h/]uhj��h3]r)��(h@)År*��}r+��(hX‡���The value pasted into the Editor's Revision field when the Paste Defaults button
is clicked. The Scope field should contain a numeric value indicating the
revision number of this EML document within the Scope and Identifier.r,��hj&��h#h$h%hDh'}r-��(h)]h*]h+]h,]h/]uh1Moh3]r.��h<X‡���The value pasted into the Editor's Revision field when the Paste Defaults button
is clicked. The Scope field should contain a numeric value indicating the
revision number of this EML document within the Scope and Identifier.r/��ÖÅr0��}r1��(hj,��hj*��ubaubh@)År2��}r3��(hX���Example: 2
Default: 1r4��hj&��h#h$h%hDh'}r5��(h)]h*]h+]h,]h/]uh1Msh3]r6��h<X���Example: 2
Default: 1r7��ÖÅr8��}r9��(hj4��hj2��ubaubeh%h÷ubeh%hÊubhƒ)År:��}r;��(hU�h'}r<��(h)]h*]h+]h,]h/]uhjü��h3]r=��(h…)År>��}r?��(hU�h'}r@��(h)]h*]h+]h,]h/]uhj:��h3]rA��h@)ÅrB��}rC��(hX���defaultDocumentTyperD��hj>��h#h$h%hDh'}rE��(h)]h*]h+]h,]h/]uh1Mvh3]rF��h<X���defaultDocumentTyperG��ÖÅrH��}rI��(hjD��hjB��ubaubah%h÷ubh…)ÅrJ��}rK��(hU�h'}rL��(h)]h*]h+]h,]h/]uhj:��h3]rM��(h@)ÅrN��}rO��(hXv���The document type specification pasted into the
Editor's DocumentType field when the Paste Defaults button is clicked.rP��hjJ��h#h$h%hDh'}rQ��(h)]h*]h+]h,]h/]uh1Mvh3]rR��h<Xv���The document type specification pasted into the
Editor's DocumentType field when the Paste Defaults button is clicked.rS��ÖÅrT��}rU��(hjP��hjN��ubaubh@)ÅrV��}rW��(hX/���Default: ``eml://ecoinformatics.org/eml-2.0.0``hjJ��h#h$h%hDh'}rX��(h)]h*]h+]h,]h/]uh1Myh3]rY��(h<X ���Default: rZ��ÖÅr[��}r\��(hX ���Default: hjV��ubjÂ��)År]��}r^��(hX&���``eml://ecoinformatics.org/eml-2.0.0``h'}r_��(h)]h*]h+]h,]h/]uhjV��h3]r`��h<X"���eml://ecoinformatics.org/eml-2.0.0ra��ÖÅrb��}rc��(hU�hj]��ubah%jÌ��ubeubeh%h÷ubeh%hÊubhƒ)Ård��}re��(hU�h'}rf��(h)]h*]h+]h,]h/]uhjü��h3]rg��(h…)Årh��}ri��(hU�h'}rj��(h)]h*]h+]h,]h/]uhjd��h3]rk��h@)Årl��}rm��(hX���defaultDocumentURLrn��hjh��h#h$h%hDh'}ro��(h)]h*]h+]h,]h/]uh1M{h3]rp��h<X���defaultDocumentURLrq��ÖÅrr��}rs��(hjn��hjl��ubaubah%h÷ubh…)Årt��}ru��(hU�h'}rv��(h)]h*]h+]h,]h/]uhjd��h3]rw��(h@)Årx��}ry��(hX¬���The URL or partial URL pasted into the Editor's URL field
when the Paste Defaults button is clicked. Typically, this
value is set to the portion of the URL shared by all harvested EML documents.rz��hjt��h#h$h%hDh'}r{��(h)]h*]h+]h,]h/]uh1M{h3]r|��h<X¬���The URL or partial URL pasted into the Editor's URL field
when the Paste Defaults button is clicked. Typically, this
value is set to the portion of the URL shared by all harvested EML documents.r}��ÖÅr~��}r��(hjz��hjx��ubaubh@)ÅrÄ��}rÅ��(hXK���Example:
``http://somehost.institution.edu/somepath/``
Default: ``http://``hjt��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1Mh3]r��(h<X ���Example:
rÑ��ÖÅrÖ��}rÜ��(hX ���Example:
hjÄ��ubjÂ��)Årá��}rà��(hX-���``http://somehost.institution.edu/somepath/``h'}râ��(h)]h*]h+]h,]h/]uhjÄ��h3]rä��h<X)���http://somehost.institution.edu/somepath/rã��ÖÅrå��}rç��(hU�hjá��ubah%jÌ��ubh<X
���
Default: ré��ÖÅrè��}rê��(hX
���
Default: hjÄ��ubjÂ��)Årë��}rí��(hX ���``http://``h'}rì��(h)]h*]h+]h,]h/]uhjÄ��h3]rî��h<X���http://rï��ÖÅrñ��}ró��(hU�hjë��ubah%jÌ��ubeubeh%h÷ubeh%hÊubeh%j(��ubeh%j)��ubaubh@)Årò��}rô��(hX ���XML Schema for Harvest Listsrö��hj#��h#h$h%hDh'}rõ��(h)]h*]h+]h,]h/]uh1MÖh2hh3]rú��h<X ���XML Schema for Harvest Listsrù��ÖÅrû��}rü��(hjö��hjò��ubaubhx)År†��}r°��(hXΩ��<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSPY v5 rel. 4 U (http://www.xmlspy.com) by Matt Jones (NCEAS) -->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:hrv="eml://ecoinformatics.org/harvestList" xmlns="eml://ecoinformatics.org/harvestList" targetNamespace="eml://ecoinformatics.org/harvestList" elementFormDefault="unqualified" attributeFormDefault="unqualified">
<xs:annotation>
<xs:documentation>This module defines the required information for the harvester to collect documents from the local site. The local system containing this document must give the Metacat Harvester read access to this document.</xs:documentation>
</xs:annotation>
<xs:annotation>
<xs:appinfo>
<tooltip/>
<summary/>
<description/>
</xs:appinfo>
</xs:annotation>
<xs:element name="harvestList">
<xs:annotation>
<xs:documentation>This represents the local document information that is used to inform the Harvester of the docid, document type, and location of the document to be harvested.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="document" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="docid">
<xs:annotation>
<xs:documentation>The complete document identifier to be used by metacat. The docid is a compound element that gives a scope for the identifier, an integer local identifer that is unique within that scope, and a revision. Each revision is assumed to specify a unique, non-changing document, so once a particular revision is harvested, there is no need for it to be harvested again. To trigger a harvest of a document that has been updated, increment the revision number for that identifier.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="scope" type="xs:string">
<xs:annotation>
<xs:documentation>The system prefix of a metacat docid that defines the scope within which the identifier is unique.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="identifier" type="xs:long">
<xs:annotation>
<xs:documentation>The local (site specific) portion of the identifier (docid) that is unique within the context of the scope.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="revision" type="xs:long">
<xs:annotation>
<xs:documentation>The revision identifier for this document, indicating a unique document version.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="documentType" type="xs:string">
<xs:annotation>
<xs:documentation>The type of document to be harvested, indicated by a namespace string, formal public identifier, mime type, or other type indicator. </xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="documentURL" type="xs:anyURI">
<xs:annotation>
<xs:documentation>The documentURL field contains the URL of the document to be harvested. The Metacat Harvester must be given read access to the contents at this URL.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>hj#��h#h$h%h{h'}r¢��(h}h~h,]h+]h)]h*]h/]uh1Mâh2hh3]r£��h<XΩ��<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSPY v5 rel. 4 U (http://www.xmlspy.com) by Matt Jones (NCEAS) -->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:hrv="eml://ecoinformatics.org/harvestList" xmlns="eml://ecoinformatics.org/harvestList" targetNamespace="eml://ecoinformatics.org/harvestList" elementFormDefault="unqualified" attributeFormDefault="unqualified">
<xs:annotation>
<xs:documentation>This module defines the required information for the harvester to collect documents from the local site. The local system containing this document must give the Metacat Harvester read access to this document.</xs:documentation>
</xs:annotation>
<xs:annotation>
<xs:appinfo>
<tooltip/>
<summary/>
<description/>
</xs:appinfo>
</xs:annotation>
<xs:element name="harvestList">
<xs:annotation>
<xs:documentation>This represents the local document information that is used to inform the Harvester of the docid, document type, and location of the document to be harvested.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="document" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="docid">
<xs:annotation>
<xs:documentation>The complete document identifier to be used by metacat. The docid is a compound element that gives a scope for the identifier, an integer local identifer that is unique within that scope, and a revision. Each revision is assumed to specify a unique, non-changing document, so once a particular revision is harvested, there is no need for it to be harvested again. To trigger a harvest of a document that has been updated, increment the revision number for that identifier.</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="scope" type="xs:string">
<xs:annotation>
<xs:documentation>The system prefix of a metacat docid that defines the scope within which the identifier is unique.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="identifier" type="xs:long">
<xs:annotation>
<xs:documentation>The local (site specific) portion of the identifier (docid) that is unique within the context of the scope.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="revision" type="xs:long">
<xs:annotation>
<xs:documentation>The revision identifier for this document, indicating a unique document version.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="documentType" type="xs:string">
<xs:annotation>
<xs:documentation>The type of document to be harvested, indicated by a namespace string, formal public identifier, mime type, or other type indicator. </xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="documentURL" type="xs:anyURI">
<xs:annotation>
<xs:documentation>The documentURL field contains the URL of the document to be harvested. The Metacat Harvester must be given read access to the contents at this URL.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>r§��ÖÅr•��}r¶��(hU�hj†��ubaubeubh )Årß��}r®��(hU�hh h#h$h%h&h'}r©��(h)]h*]h+]h,]r™��U!prepare-eml-documents-for-harvestr´��ah/]r¨��hauh1M h2hh3]r≠��(h5)ÅrÆ��}rØ��(hX!���Prepare EML Documents for Harvestr∞��hjß��h#h$h%h9h'}r±��(h)]h*]h+]h,]h/]uh1M h2hh3]r≤��h<X!���Prepare EML Documents for Harvestr≥��ÖÅr¥��}rµ��(hj∞��hjÆ��ubaubh@)År∂��}r∑��(hXc���To prepare a set of EML documents for harvest, ensure that the following is true for each document:r∏��hjß��h#h$h%hDh'}rπ��(h)]h*]h+]h,]h/]uh1MÀh2hh3]r∫��h<Xc���To prepare a set of EML documents for harvest, ensure that the following is true for each document:rª��ÖÅrº��}rΩ��(hj∏��hj∂��ubaubjì��)Åræ��}rø��(hU�hjß��h#h$h%jñ��h'}r¿��(jò��X���*h,]h+]h)]h*]h/]uh1MÕh2hh3]r¡��(jb��)År¬��}r√��(hX ���The document contains valid EMLrƒ��hjæ��h#h$h%je��h'}r≈��(h)]h*]h+]h,]h/]uh1Nh2hh3]r∆��h@)År«��}r»��(hjƒ��hj¬��h#h$h%hDh'}r…��(h)]h*]h+]h,]h/]uh1MÕh3]r ��h<X ���The document contains valid EMLrÀ��ÖÅrÃ��}rÕ��(hjƒ��hj«��ubaubaubjb��)ÅrŒ��}rœ��(hXP���The document is specified in a ``<document>`` element in the site's Harvest Listr–��hjæ��h#h$h%je��h'}r—��(h)]h*]h+]h,]h/]uh1Nh2hh3]r“��h@)År”��}r‘��(hj–��hjŒ��h#h$h%hDh'}r’��(h)]h*]h+]h,]h/]uh1MŒh3]r÷��(h<X ���The document is specified in a r◊��ÖÅrÿ��}rŸ��(hX ���The document is specified in a hj”��ubjÂ��)År⁄��}r€��(hX���``<document>``h'}r‹��(h)]h*]h+]h,]h/]uhj”��h3]r›��h<X
���<document>rfi��ÖÅrfl��}r‡��(hU�hj⁄��ubah%jÌ��ubh<X#��� element in the site's Harvest Listr·��ÖÅr‚��}r„��(hX#��� element in the site's Harvest Listhj”��ubeubaubjb��)År‰��}rÂ��(hXJ���The file resides at the location specified by its URL in the Harvest List
hjæ��h#h$h%je��h'}rÊ��(h)]h*]h+]h,]h/]uh1Nh2hh3]rÁ��h@)ÅrË��}rÈ��(hXI���The file resides at the location specified by its URL in the Harvest ListrÍ��hj‰��h#h$h%hDh'}rÎ��(h)]h*]h+]h,]h/]uh1Mœh3]rÏ��h<XI���The file resides at the location specified by its URL in the Harvest ListrÌ��ÖÅrÓ��}rÔ��(hjÍ��hjË��ubaubaubeubeubh )År��}rÒ��(hU�hh h#h$h%h&h'}rÚ��(h)]h*]h+]h,]rÛ��Ureview-harvester-reportsrÙ��ah/]rı��h auh1M“h2hh3]rˆ��(h5)År˜��}r¯��(hX���Review Harvester Reportsr˘��hj��h#h$h%h9h'}r˙��(h)]h*]h+]h,]h/]uh1M“h2hh3]r˚��h<X���Review Harvester Reportsr¸��ÖÅr˝��}r˛��(hj˘��hj˜��ubaubh@)Årˇ��}r���(hXy��Harvester sends an email report to the Site Contact after every scheduled site
harvest. The report contains information about the performed operations, such
as which EML documents were harvested and whether any errors were encountered.
Errors are indicated by operations that display a status value of 1; a status
value of 0 indicates that the operation completed successfully.r��hj��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1M”h2hh3]r��h<Xy��Harvester sends an email report to the Site Contact after every scheduled site
harvest. The report contains information about the performed operations, such
as which EML documents were harvested and whether any errors were encountered.
Errors are indicated by operations that display a status value of 1; a status
value of 0 indicates that the operation completed successfully.r��ÖÅr��}r��(hj��hjˇ��ubaubh@)År��}r��(hX≥���When errors are reported, the Site Contact should try to determine whether the
source of the error is something that can be corrected at the site. Common
causes of errors include:r ��hj��h#h$h%hDh'}r
��(h)]h*]h+]h,]h/]uh1MŸh2hh3]r ��h<X≥���When errors are reported, the Site Contact should try to determine whether the
source of the error is something that can be corrected at the site. Common
causes of errors include:r ��ÖÅr
��}r��(hj ��hj��ubaubjì��)År��}r��(hU�hj��h#h$h%jñ��h'}r��(jò��X���*h,]h+]h)]h*]h/]uh1M›h2hh3]r��(jb��)År��}r��(hXk���a document URL specified in the Harvest List does not match the location of the actual EML file on the diskr��hj��h#h$h%je��h'}r��(h)]h*]h+]h,]h/]uh1Nh2hh3]r��h@)År��}r��(hj��hj��h#h$h%hDh'}r��(h)]h*]h+]h,]h/]uh1M›h3]r��h<Xk���a document URL specified in the Harvest List does not match the location of the actual EML file on the diskr ��ÖÅr ��}r ��(hj��hj��ubaubaubjb��)År ��}r ��(hXV���the Harvest List does not contain valid XML as specified in the harvestList.xsd schemar!��hj��h#h$h%je��h'}r"��(h)]h*]h+]h,]h/]uh1Nh2hh3]r#��h@)År$��}r%��(hj!��hj ��h#h$h%hDh'}r&��(h)]h*]h+]h,]h/]uh1Mfih3]r'��h<XV���the Harvest List does not contain valid XML as specified in the harvestList.xsd schemar(��ÖÅr)��}r*��(hj!��hj$��ubaubaubjb��)År+��}r,��(hX~���the URL to the Harvest List (specified during registration) does not match the actual location of the Harvest List on the diskr-��hj��h#h$h%je��h'}r.��(h)]h*]h+]h,]h/]uh1Nh2hh3]r/��h@)År0��}r1��(hj-��hj+��h#h$h%hDh'}r2��(h)]h*]h+]h,]h/]uh1Mflh3]r3��h<X~���the URL to the Harvest List (specified during registration) does not match the actual location of the Harvest List on the diskr4��ÖÅr5��}r6��(hj-��hj0��ubaubaubjb��)År7��}r8��(hXY���an EML document that Harvester attempted to upload to Metacat does not contain valid EML
hj��h#h$h%je��h'}r9��(h)]h*]h+]h,]h/]uh1Nh2hh3]r:��h@)År;��}r<��(hXX���an EML document that Harvester attempted to upload to Metacat does not contain valid EMLr=��hj7��h#h$h%hDh'}r>��(h)]h*]h+]h,]h/]uh1M‡h3]r?��h<XX���an EML document that Harvester attempted to upload to Metacat does not contain valid EMLr@��ÖÅrA��}rB��(hj=��hj;��ubaubaubeubh@)ÅrC��}rD��(hXö���If the Site Contact is unable to determine the cause of the error and its
resolution, he or she should contact the Harvester Administrator for assistance.rE��hj��h#h$h%hDh'}rF��(h)]h*]h+]h,]h/]uh1M‚h2hh3]rG��h<Xö���If the Site Contact is unable to determine the cause of the error and its
resolution, he or she should contact the Harvester Administrator for assistance.rH��ÖÅrI��}rJ��(hjE��hjC��ubaubeubh )ÅrK��}rL��(hU�hh h#h$h%h&h'}rM��(h)]h*]h+]h,]rN��Uunregister-with-harvesterrO��ah/]rP��h
auh1MÊh2hh3]rQ��(h5)ÅrR��}rS��(hX���Unregister with HarvesterrT��hjK��h#h$h%h9h'}rU��(h)]h*]h+]h,]h/]uh1MÊh2hh3]rV��h<X���Unregister with HarvesterrW��ÖÅrX��}rY��(hjT��hjR��ubaubh@)ÅrZ��}r[��(hXX���To discontinue harvests, the Site Contact must unregister with Harvester.
To unregister:r\��hjK��h#h$h%hDh'}r]��(h)]h*]h+]h,]h/]uh1MÁh2hh3]r^��h<XX���To discontinue harvests, the Site Contact must unregister with Harvester.
To unregister:r_��ÖÅr`��}ra��(hj\��hjZ��ubaubjX��)Årb��}rc��(hU�hjK��h#h$h%j[��h'}rd��(j]��U.h,]h+]h)]j^��U�h*]h/]j_��j`��uh1MÍh2hh3]re��(jb��)Årf��}rg��(hX»��Using a Web browser, log in to Metacat's Harvester Registration page.
The Harvester Registration page is inside the skins directory. For example,
if the Metacat server that you wish to register with resides at the
following URL:
::
http://somehost.somelocation.edu:8080/metacat/index.jsp
then the Harvester Registration page would be accessed at:
::
http://somehost.somelocation.edu:8080/metacat/style/skins/default/harvesterRegistrationLogin.jsp
hjb��h#h$h%je��h'}rh��(h)]h*]h+]h,]h/]uh1Nh2hh3]ri��(h@)Årj��}rk��(hX‰���Using a Web browser, log in to Metacat's Harvester Registration page.
The Harvester Registration page is inside the skins directory. For example,
if the Metacat server that you wish to register with resides at the
following URL:rl��hjf��h#h$h%hDh'}rm��(h)]h*]h+]h,]h/]uh1MÍh3]rn��h<X‰���Using a Web browser, log in to Metacat's Harvester Registration page.
The Harvester Registration page is inside the skins directory. For example,
if the Metacat server that you wish to register with resides at the
following URL:ro��ÖÅrp��}rq��(hjl��hjj��ubaubhx)Årr��}rs��(hX7���http://somehost.somelocation.edu:8080/metacat/index.jsphjf��h%h{h'}rt��(h}h~h,]h+]h)]h*]h/]uh1MÒh3]ru��h<X7���http://somehost.somelocation.edu:8080/metacat/index.jsprv��ÖÅrw��}rx��(hU�hjr��ubaubh@)Åry��}rz��(hX:���then the Harvester Registration page would be accessed at:r{��hjf��h#h$h%hDh'}r|��(h)]h*]h+]h,]h/]uh1MÛh3]r}��h<X:���then the Harvester Registration page would be accessed at:r~��ÖÅr��}rÄ��(hj{��hjy��ubaubhx)ÅrÅ��}rÇ��(hX`���http://somehost.somelocation.edu:8080/metacat/style/skins/default/harvesterRegistrationLogin.jsphjf��h%h{h'}rÉ��(h}h~h,]h+]h)]h*]h/]uh1M˜h3]rÑ��h<X`���http://somehost.somelocation.edu:8080/metacat/style/skins/default/harvesterRegistrationLogin.jsprÖ��ÖÅrÜ��}rá��(hU�hjÅ��ubaubeubjb��)Årà��}râ��(hXå���Enter and submit your Metacat account information. On the subsequent screen,
click Unregister to remove your site and discontinue harvests.
hjb��h#h$h%je��h'}rä��(h)]h*]h+]h,]h/]uh1Nh2hh3]rã��h@)Årå��}rç��(hXã���Enter and submit your Metacat account information. On the subsequent screen,
click Unregister to remove your site and discontinue harvests.ré��hjà��h#h$h%hDh'}rè��(h)]h*]h+]h,]h/]uh1M˘h3]rê��h<Xã���Enter and submit your Metacat account information. On the subsequent screen,
click Unregister to remove your site and discontinue harvests.rë��ÖÅrí��}rì��(hjé��hjå��ubaubaubeubeubeubh#h$h%h&h'}rî��(h)]h*]h+]h,]rï��Uregister-with-harvesterrñ��ah/]ró��h auh1Kuh2hh3]rò��(h5)Årô��}rö��(hX���Register with Harvesterrõ��hh h#h$h%h9h'}rú��(h)]h*]h+]h,]h/]uh1Kuh2hh3]rù��h<X���Register with Harvesterrû��ÖÅrü��}r†��(hjõ��hjô��ubaubh@)År°��}r¢��(hX∂���To register a remote site with Harvester, the Site Contact should log in to
Metacat's Harvester Registration page and enter information about the site and
how it should be harvested.r£��hh h#h$h%hDh'}r§��(h)]h*]h+]h,]h/]uh1Kwh2hh3]r•��h<X∂���To register a remote site with Harvester, the Site Contact should log in to
Metacat's Harvester Registration page and enter information about the site and
how it should be harvested.r¶��ÖÅrß��}r®��(hj£��hj°��ubaubjX��)År©��}r™��(hU�hh h#h$h%j[��h'}r´��(j]��U.h,]h+]h)]j^��U�h*]h/]j_��j`��uh1K{h2hh3]r¨��jb��)År≠��}rÆ��(hX»��Using a Web browser, log in to Metacat's Harvester Registration page.
The Harvester Registration page is inside the skins directory. For example,
if the Metacat server that you wish to register with resides at the following URL:
::
http://somehost.somelocation.edu:8080/metacat/index.jsp
then the Harvester Registration page would be accessed at:
::
http://somehost.somelocation.edu:8080/metacat/style/skins/default/harvesterRegistrationLogin.jsp
hj©��h#h$h%je��h'}rØ��(h)]h*]h+]h,]h/]uh1Nh2hh3]r∞��(h@)År±��}r≤��(hX‰���Using a Web browser, log in to Metacat's Harvester Registration page.
The Harvester Registration page is inside the skins directory. For example,
if the Metacat server that you wish to register with resides at the following URL:r≥��hj≠��h#h$h%hDh'}r¥��(h)]h*]h+]h,]h/]uh1K{h3]rµ��h<X‰���Using a Web browser, log in to Metacat's Harvester Registration page.
The Harvester Registration page is inside the skins directory. For example,
if the Metacat server that you wish to register with resides at the following URL:r∂��ÖÅr∑��}r∏��(hj≥��hj±��ubaubhx)Årπ��}r∫��(hX7���http://somehost.somelocation.edu:8080/metacat/index.jsphj≠��h%h{h'}rª��(h}h~h,]h+]h)]h*]h/]uh1KÅh3]rº��h<X7���http://somehost.somelocation.edu:8080/metacat/index.jsprΩ��ÖÅræ��}rø��(hU�hjπ��ubaubh@)År¿��}r¡��(hX:���then the Harvester Registration page would be accessed at:r¬��hj≠��h#h$h%hDh'}r√��(h)]h*]h+]h,]h/]uh1KÉh3]rƒ��h<X:���then the Harvester Registration page would be accessed at:r≈��ÖÅr∆��}r«��(hj¬��hj¿��ubaubhx)År»��}r…��(hX`���http://somehost.somelocation.edu:8080/metacat/style/skins/default/harvesterRegistrationLogin.jsphj≠��h%h{h'}r ��(h}h~h,]h+]h)]h*]h/]uh1Káh3]rÀ��h<X`���http://somehost.somelocation.edu:8080/metacat/style/skins/default/harvesterRegistrationLogin.jsprÃ��ÖÅrÕ��}rŒ��(hU�hj»��ubaubeubaubcdocutils.nodes
figure
rœ��)År–��}r—��(hU�hh h#h$h%Ufigurer“��h'}r”��(Ualignr‘��X���centerh,]r’��Uid1r÷��ah+]h)]h*]h/]uh1Nh2hh3]r◊��(cdocutils.nodes
image
rÿ��)ÅrŸ��}r⁄��(hXi���.. figure:: images/screenshots/image065.jpg
:align: center
Metacat's Harvester Registration page.
h'}r€��(UuriX ���images/screenshots/image065.jpgr‹��h,]h+]h)]h*]U
candidatesr›��}rfi��U*j‹��sh/]uhj–��h3]h%Uimagerfl��ubcdocutils.nodes
caption
r‡��)År·��}r‚��(hX&���Metacat's Harvester Registration page.r„��hj–��h#h$h%Ucaptionr‰��h'}rÂ��(h)]h*]h+]h,]h/]uh1Kåh3]rÊ��h<X&���Metacat's Harvester Registration page.rÁ��ÖÅrË��}rÈ��(hj„��hj·��ubaubeubjX��)ÅrÍ��}rÎ��(hU�hh h#h$h%j[��h'}rÏ��(j]��U.UstartrÌ��Kh,]h+]h)]j^��U�h*]h/]j_��j`��uh1Kéh2hh3]rÓ��(jb��)ÅrÔ��}r��(hXÇ��Enter your Metacat account information and click Submit to log in to your
Metacat from the Harvester Registration page.
Note: In some cases, you may need to log in to an anonymous "site" account
rather than your personal account so that the registered data will not appear
to have been registered by a single user. For example, an information
manager (jones) who is registering data created by a team of scientists
(jones, smith, and barney) from the Georgia Coastal Ecosystems site might
log in to a dedicated account (named with the site's acronym, "GCE") to
indicate that the registered data is from the entire site rather than "jones".
hjÍ��h#h$h%je��h'}rÒ��(h)]h*]h+]h,]h/]uh1Nh2hh3]rÚ��(h@)ÅrÛ��}rÙ��(hXw���Enter your Metacat account information and click Submit to log in to your
Metacat from the Harvester Registration page.rı��hjÔ��h#h$h%hDh'}rˆ��(h)]h*]h+]h,]h/]uh1Kéh3]r˜��h<Xw���Enter your Metacat account information and click Submit to log in to your
Metacat from the Harvester Registration page.r¯��ÖÅr˘��}r˙��(hjı��hjÛ��ubaubh@)År˚��}r¸��(hX��Note: In some cases, you may need to log in to an anonymous "site" account
rather than your personal account so that the registered data will not appear
to have been registered by a single user. For example, an information
manager (jones) who is registering data created by a team of scientists
(jones, smith, and barney) from the Georgia Coastal Ecosystems site might
log in to a dedicated account (named with the site's acronym, "GCE") to
indicate that the registered data is from the entire site rather than "jones".r˝��hjÔ��h#h$h%hDh'}r˛��(h)]h*]h+]h,]h/]uh1Këh3]rˇ��h<X��Note: In some cases, you may need to log in to an anonymous "site" account
rather than your personal account so that the registered data will not appear
to have been registered by a single user. For example, an information
manager (jones) who is registering data created by a team of scientists
(jones, smith, and barney) from the Georgia Coastal Ecosystems site might
log in to a dedicated account (named with the site's acronym, "GCE") to
indicate that the registered data is from the entire site rather than "jones".r���ÖÅr��}r��(hj˝��hj˚��ubaubeubjb��)År��}r��(hXl��Enter information about your site and how often you want to schedule harvests
and then click the Register button (Figure 7.2). The Harvest List URL should
point to the location of the Harvest List, which is an XML file that lists
the documents to harvest. If you do not yet have a Harvest List, please see
the next section for more information about creating one.
hjÍ��h#h$h%je��h'}r��(h)]h*]h+]h,]h/]uh1Nh2hh3]r��h@)År��}r��(hXk��Enter information about your site and how often you want to schedule harvests
and then click the Register button (Figure 7.2). The Harvest List URL should
point to the location of the Harvest List, which is an XML file that lists
the documents to harvest. If you do not yet have a Harvest List, please see
the next section for more information about creating one.r ��hj��h#h$h%hDh'}r
��(h)]h*]h+]h,]h/]uh1Kôh3]r ��h<Xk��Enter information about your site and how often you want to schedule harvests
and then click the Register button (Figure 7.2). The Harvest List URL should
point to the location of the Harvest List, which is an XML file that lists
the documents to harvest. If you do not yet have a Harvest List, please see
the next section for more information about creating one.r ��ÖÅr
��}r��(hj ��hj��ubaubaubeubjœ��)År��}r��(hU�hh h#h$h%j“��h'}r��(j‘��X���centerh,]r��Uid2r��ah+]h)]h*]h/]uh1Nh2hh3]r��(jÿ��)År��}r��(hXë���.. figure:: images/screenshots/image067.jpg
:align: center
Enter information about your site and how often you want to schedule harvests.
h'}r��(UuriX ���images/screenshots/image067.jpgr��h,]h+]h)]h*]j›��}r��U*j��sh/]uhj��h3]h%jfl��ubj‡��)År��}r��(hXN���Enter information about your site and how often you want to schedule harvests.r ��hj��h#h$h%j‰��h'}r ��(h)]h*]h+]h,]h/]uh1K¢h3]r ��h<XN���Enter information about your site and how often you want to schedule harvests.r ��ÖÅr ��}r!��(hj ��hj��ubaubeubh@)År"��}r#��(hXÚ��The example settings in the previous figure instruct Harvester to harvest
documents from the site once every two weeks. The Harvester will access the
site's Harvest List at URL "http://somehost.institution.edu/~myname/harvestList.xml",
and will send email reports to the Site Contact at email address
"myname@institution.edu". Note that you can enter multiple email addresses by
separating each address with a comma or a semi-colon. For example,
"myname@institution.edu,anothername@institution.edu"hh h#h$h%hDh'}r$��(h)]h*]h+]h,]h/]uh1K§h2hh3]r%��(h<X≤���The example settings in the previous figure instruct Harvester to harvest
documents from the site once every two weeks. The Harvester will access the
site's Harvest List at URL "r&��ÖÅr'��}r(��(hX≤���The example settings in the previous figure instruct Harvester to harvest
documents from the site once every two weeks. The Harvester will access the
site's Harvest List at URL "hj"��ubjV��)År)��}r*��(hX7���http://somehost.institution.edu/~myname/harvestList.xmlr+��h'}r,��(Urefurij+��h,]h+]h)]h*]h/]uhj"��h3]r-��h<X7���http://somehost.institution.edu/~myname/harvestList.xmlr.��ÖÅr/��}r0��(hU�hj)��ubah%j^��ubh<XE���",
and will send email reports to the Site Contact at email address
"r1��ÖÅr2��}r3��(hXE���",
and will send email reports to the Site Contact at email address
"hj"��ubjV��)År4��}r5��(hX���myname@institution.eduh'}r6��(UrefuriX ���mailto:myname@institution.eduh,]h+]h)]h*]h/]uhj"��h3]r7��h<X���myname@institution.edur8��ÖÅr9��}r:��(hU�hj4��ubah%j^��ubh<X{���". Note that you can enter multiple email addresses by
separating each address with a comma or a semi-colon. For example,
"r;��ÖÅr<��}r=��(hX{���". Note that you can enter multiple email addresses by
separating each address with a comma or a semi-colon. For example,
"hj"��ubjV��)År>��}r?��(hX���myname@institution.eduh'}r@��(UrefuriX ���mailto:myname@institution.eduh,]h+]h)]h*]h/]uhj"��h3]rA��h<X���myname@institution.edurB��ÖÅrC��}rD��(hU�hj>��ubah%j^��ubh<X ���,anothername@institution.edu"rE��ÖÅrF��}rG��(hX ���,anothername@institution.edu"hj"��ubeubeubh#h$h%Usystem_messagerH��h'}rI��(h)]UlevelKh,]h+]Usourceh$h*]h/]UlineKUtypeUINFOrJ��uh1Kéh2hh3]rK��h@)ÅrL��}rM��(hU�h'}rN��(h)]h*]h+]h,]h/]uhhh3]rO��h<X:���Enumerated list start value not ordinal-1: "2" (ordinal 2)rP��ÖÅrQ��}rR��(hU�hjL��ubah%hDubaubaUcurrent_sourcerS��NU
decorationrT��NUautofootnote_startrU��KUnameidsrV��}rW��(hhûhj‘��hj∑��h j'��h
jO��h jÙ��h jñ��h
j.��hh^hjx��hh.hjE��hj´��uh3]rX��h!ahU�U transformerrY��NU
footnote_refsrZ��}r[��Urefnamesr\��}r]��Usymbol_footnotesr^��]r_��Uautofootnote_refsr`��]ra��Usymbol_footnote_refsrb��]rc��U citationsrd��]re��h2hU current_linerf��NUtransform_messagesrg��]rh��Ureporterri��NUid_startrj��KU
autofootnotesrk��]rl��U
citation_refsrm��}rn��Uindirect_targetsro��]rp��Usettingsrq��(cdocutils.frontend
Values
rr��ors��}rt��(Ufootnote_backlinksru��KUrecord_dependenciesrv��NU rfc_base_urlrw��U https://tools.ietf.org/html/rx��U tracebackry��àUpep_referencesrz��NUstrip_commentsr{��NU
toc_backlinksr|��h÷U
language_coder}��Uenr~��U datestampr��NU report_levelr��KU _destinationr��NU
halt_levelr��KU
strip_classesrÉ��Nh9NU error_encoding_error_handlerrÑ��UbackslashreplacerÖ��UdebugrÜ��NUembed_stylesheetrá��âU output_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ì��àU trim_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°��U�U 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≠��U input_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∑��K�Uidsr∏��}rπ��(jñ��h jx��jt��jE��jA��h.h!j��j��j´��jß��jÙ��j��h^hZj'��j#��jO��jK��j∑��j≥��j.��j*��hûhöj‘��h j÷��j–��uUsubstitution_namesr∫��}rª��h%h2h'}rº��(h)]h,]h+]Usourceh$h*]h/]uU footnotesrΩ��]ræ��Urefidsrø��}r¿��ub.