S4PA MACHINE REQUEST INTERFACE (MRI)

1.1 MRI Capabilities

• MRI allows a user to search for granules and request distribution of files via subscription for user-specified data type and time range.
• The users can use MRI to request the data only for which they have subscriptions (active or inactive)
• MR requires user IP authentication andI is also password protected with unique login/password pair for each requester team

1.2 MRI Execution

• MRI can be executed either from the web browser or from command line using 'wget'.
• When executed from a browser, the format of request is:
  • http://aurapar2u.ecs.nasa.gov/search-aura/s4pa_m2m_cgi.pl?dataset=DATATYPE&startTime=YYYY-MM-DD HH:MM:SS&endTime=YYYY-MM-DD HH:MM:SS
  • Example: http://aurapar2u.ecs.nasa.gov/search-aura/s4pa_m2m_cgi.pl?dataset=HIR0ENG&startTime=2006-01-01 00:00:00&endTime=2006-01-02 00:00:00
  • A GUI version of MRI is also available. To launch the GUI, use the same URL without any parameters as follows: http://aurapar2u.ecs.nasa.gov/search-aura/s4pa_m2m_cgi.pl
  • The browser will prompt user for user name and password.
• When executed from command line, the format of request is:
  • wget -O - --user=USER --password=PASSWORD 'URL'
  • URL is has the same format as one used in the browser, USER and PASSWORD are requester's username and password.

1.3 MRI Execution Results

• After MRI is executed, user will receive either a web page in the browser or output in command line, which, in case of success, will look like:
  

  <result status="success">
      <message>Request, P2808T458aflec, accepted</message>
  </result>

• For GUI version, specify Dataset, Version, startTime, and endTime, select 'Order' action, and then click the 'Submit' button to submit the ordering request.
• In case of error, <message> will contain the error message.
• If MRI execution was a success, the result of it will be distribution of DN and/or data to the requester in exactly same way as regular distribution for that subscriber.
• The delay between successful execution of MRI and actual DN and/or data arrival to the requester is approximately half an hour.

1.4 MRI Search

• Simple Listing of Granule Locators

Before ordering granules via MRI, users can get listing of granules for a given time range. The format of the listing request is:

http://aurapar2u.ecs.nasa.gov/search-aura/s4pa_m2m_cgi.pl?dataset=DATATYPE&startTime=YYYY-MM-DD HH:MM:SS&endTime=YYYY-MM-DD HH:MM:SS&action=list

Example:

http://aurapar2u.ecs.nasa.gov/aurapar1/aura-bin/s4pa_m2m_cgi.pl?dataset=OMTDOPF&version=001&startTime=2007-09-20%2000:00:00&endTime=2007-10-17%2000:00:00&action=list

For GUI, select 'List Granule(s)' action, then click the 'Submit' button.

The result of execution of the above command is:

OMTDOPF.001:OMI-Aura_OMTDOPF_x1301-o17049_v001-2007m1002t062500.h4.xml,
OMTDOPF.001:OMI-Aura_OMTDOPF_x1301-o17064_v001-2007m1002t062500.h4.xml,

Each line is a granule locator with the format of <Dataset>.<VersionID>:<Granule Metadata Filename>. The granule locator can be used to order specific granules via MRI.

• Long Listing of Granule Information

To get the detailed information about each granule, specify the long list format as follows:

http://aurapar2u.ecs.nasa.gov/aurapar1/aura-bin/s4pa_m2m_cgi.pl?dataset=OMTDOPF&version=001&startTime=2007-09-20%2000:00:00&endTime=2007-10-17%2000:00:00&action=list:long

For GUI, select 'List Granule Info'' action, then click the 'Submit' button.

The result of execution of the above command is:

<GranuleList>
  <Granule LOCATOR="OMTDOPF.001:OMI-Aura_OMTDOPF_x1301-o17049_v001-2007m1002t062500.h4.xml">
    <ShortName>OMTDOPF</ShortName>
    <VersionID>001</VersionID>
    <GranuleID>OMI-Aura_OMTDOPF_x1301-o17049_v001-2007m1002t062500.h4</GranuleID>
    <RangeBeginningDateTime>2007-09-29 00:23:57.000000</RangeBeginningDateTime>
    <RangeEndingDateTime>2007-09-30 01:07:05.000000</RangeEndingDateTime>
    <ProductionDateTime>2007-10-02T06:25:28.000Z</ProductionDateTime>
    <InsertDateTime>2007-11-20 15:12:32</InsertDateTime>
    <File>
      <FileName>OMI-Aura_OMTDOPF_x1301-o17049_v001-2007m1002t062500.h4</FileName>
      <FileSize>46884121</FileSize>
      <CheckSumType>CRC32</CheckSumType>
      <CheckSumValue>1701576529</CheckSumValue>
    </File>
  </Granule>
  <Granule LOCATOR="OMTDOPF.001:OMI-Aura_OMTDOPF_x1301-o17064_v001-2007m1002t062500.h4.xml">
    <ShortName>OMTDOPF</ShortName>
    <VersionID>001</VersionID>
    <GranuleID>OMI-Aura_OMTDOPF_x1301-o17064_v001-2007m1002t062500.h4</GranuleID>
    <RangeBeginningDateTime>2007-09-30 01:07:05.000000</RangeBeginningDateTime>
    <RangeEndingDateTime>2007-10-01 00:11:21.000000</RangeEndingDateTime>
    <ProductionDateTime>2007-10-02T06:25:21.000Z</ProductionDateTime>
    <InsertDateTime>2007-11-20 15:12:32</InsertDateTime>
    <File>
      <FileName>OMI-Aura_OMTDOPF_x1301-o17064_v001-2007m1002t062500.h4</FileName>
      <FileSize>46882933</FileSize>
      <CheckSumType>CRC32</CheckSumType>
      <CheckSumValue>2167247648</CheckSumValue>
    </File>
  </Granule>
</GranuleList>

 1.5 MRI Order with Granule Locator

Users can order specific granules by uploading a file with list of granule locators via 'wget --post-file' command.

To order specific granules via MRI, users need to use MRI search to get a list of granule locatos, copy and paste the target granule locators into a file on the local machine, then issue a 'wget --post-file' command to place the order.

Example: (with granule locators listed in a file called 'upload.txt')

• wget -O - --user=USER --password=PASSWORD --post-file=upload.txt 'http://aurapar2u.ecs.nasa.gov/aurapar1/aura-bin/s4pa_m2m_cgi.pl'

Currently, user can't mix different datasets in the same upload file and there is no GUI support for this action.