Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

#InstructionExpected Result
1

Select a collection natively in *.nc format.
In a chosen mode, execute this database query:

select DirectoryPath || OnlineFileName AS path from AmDataFile where onlinefilename like '%nc';

From the resulting list, choose a collection.
Make sure this collection has been exported using BMGT.

select DirectoryPath || OnlineFileName AS path from AmDataFile where onlinefilename like '%nc';
path 
-----------------------------------------------------------------------------
/NSIDC-0484.001/1996.01.01/antarctica_ice_velocity_900m.nc
/NSIDC-0530.001/1999.01.01/nhtsd25e2_19990101_v01r01.nc
/TL2O3LN.006/2004.09.01/TES-Aura_L2-O3-Nadir_2004-09_v006_Litev01.00.nc
/MIL3DAEN.004/2010.10.02/MISR_AM1_CGAS_0_5_DEG_OCT_02_2010_F08_0031.nc
/MIL3DAEN.004/2010.10.01/MISR_AM1_CGAS_0_5_DEG_OCT_01_2010_F08_0031.nc
2

Configure the OPENDAP_BES service.
Open the Data Access GUI; in the "Service Configuration" tab, click the "Add New Service" button.
Configure the new service as follows:

 Service Name: OPENDAP_BES
Description: Service that bypasses the OLFS to access the Back-End Server directly.
Request Type: Both
Max Async Jobs: 10
Max Sync Jobs: 10
Timeout (Sec): 3600
Host: <Host>:<Port>
URL/Srv Path: /usr/ecs/<MODE>/CUSTOM/bin/DPL/BesService
[_] Enable Spatial Subsetting
[_] Enable Temporal Subsetting
[X] Enable Band Subsetting

SELECT * FROM AmDaService WHERE name = 'OPENDAP_BES';
serviceid | name | description | allowtemporalflag | allowspatialflag | maxactiveasyncjobs | maxactivesyncjobs | allowbandflag 
-----------+-------------+-----------------------------------------------------------------------+-------------------+------------------+--------------------+-------------------+---------------
58 | OPENDAP_BES | Service that bypasses theOLFS to access the Back-End Server directly. | N | N | 10 | 10 | Y
(1 row)
3

Configure data_objects/parameters for the collection.
 

EcDlDaOpendapParmCfg.rb --mode <MODE> --host-fqdn <HOST> --esi-port <PORT> --collection <SNVI/ESDT> --output-dir <WRITABLE_DIR>
 

The output will be a URL; copy it; in a browser, log into the Data Access GUI; paste and visit the URL.
Use the query:

SELECT procdagetallobjflddimbands('<SHORTNAME>', <VERSIONID>, 'OPENDAP_BES');

to verify that at least two bands exist for the collection.

http://f5dpl01.edn.ecs.nasa.gov:22500/DataAccessGui_DEV02/config/import?configLevel=Dataset_Service&dataType=Data_Objects&serviceId=OPENDAP_BES&collectionId=AE_Rain.002&filePath=/home/mbrown/Data/Test/AE_Rain.002.json

 

{
status : "Success",
collections_processed : [ "AE_Rain.002" ],
results : "import DATASET_SERVICE DATA_OBJECTS to/from: /home/mbrown/Data/Test/AE_Rain.002.json",
messages : [ ]
}

 

select procdagetallobjflddimbands('NSIDC-0484', 1, 'OPENDAP_BES');
procdagetallobjflddimbands 
-------------------------------------------------------------
(58,199,/,UNKNOWN,2424,Data_citation,,,,,,,Y,N,N,,,,)
(58,199,/,UNKNOWN,2412,Ellipsoid,,,,,,,Y,N,N,,,,)
(58,199,/,UNKNOWN,2414,Latidude_of_origin,,,,,,,Y,N,N,,,,)
(58,199,/,UNKNOWN,2413,Longitude_of_origin,,,,,,,Y,N,N,,,,)
(58,199,/,UNKNOWN,2425,More_information,,,,,,,Y,N,N,,,,)

4Return to the "Collection Configuration" tab of the Data Access GUI.
Right-click on the chosen collection and Configure New Service for Collection (Choose OPENDAP_BES.)
(If GDAL is enabled for the collection, Unmap All Services, then remap the OPENDAP_BES service.)
SELECT esdt(shortname,versionid), s.name
FROM AmDaDatasetConfig dc
INNER JOIN AmDaService s ON s.serviceid = dc.serviceid
INNER JOIN AmCollection c ON c.collectionid = dc.collectionid
WHERE s.name = 'OPENDAP_BES';
esdt | name 
----------------+-------------
SPL2SMA.003 | OPENDAP_BES
NSIDC-0484.001 | OPENDAP_BES
VNP10.001 | OPENDAP_BES
AE_Ocean.002 | OPENDAP_BES
MOD10CM.005 | OPENDAP_BES
(5 rows)
5Perform an EGI request using the inventory drilldown.
Choose the OPENDAP_BES service.
Choose one or two of the available bands.
View the outputs to make sure only the selected bands have been included in the output.
http://f5eil01:22500/egi_DEV02/request?FILE_IDS=3000595354&SUBAGENT_ID=OPENDAP_BES&DATASET_ID=MODIS%2FTerra%20Snow%20Cover%20Monthly%20L3%20Global%200.05Deg%20CMG%20V005&FORMAT=ASCII&EMAIL=michael.a.brown-2@nasa.gov&CLIENT=ESI&REQUEST_MODE=sync&SUBSET_DATA_LAYERS=%2F%3ASnow_Cover_Monthly_CMG,%2F%3ASnow_Spatial_QA&
6

Upload forms for the new collection:
Use the GUI, or FormUpload.rb:

FormUpload.rb --mode <MODE> --host-fqdn <HOST> --esi-port <PORT> --output-dir <WRITABLE_DIR> --associate-service <PROVIDER> EOSDIS Service Implementation --collections <ESDT_LIST> --debug-level 2 --echo-domain <TB, PT, or OPS> --upload-form esi OR esi_<MODE> (if not OPS)

FormUpload.rb --mode DEV02 --host-fqdn f5dpl01.edn.ecs.nasa.gov --esi-port 22500 --use-token /home/mbrown/Data/Forms/brownm09_EDF_DEV02_token.xml --output-dir /home/mbrown/Data/Forms --associate-service EDF_DEV02 EOSDIS Service Implementation --collections AE_Rain.002 MOD10CM.005 --debug-level 2 --echo-domain TB --upload-form esi_dev02

# | ESDT | TYPE | DELETE_OK | FORM_SRC | ADD_OK | ASSIGN_OK | VIRTUAL_TAG | DURATION
---+--------------+---------+-----------+----------------------+--------+-----------+-------------+----------
0 | AE_Ocean.002 | ORDER | false | http://f5dpl01.ed... | true | true | N/A | 00:00:01
1 | AE_Ocean.002 | SERVICE | false | http://f5dpl01.ed... | true | true | ENABLED | 00:00:01
2 | MOD10CM.005 | ORDER | true | http://f5dpl01.ed... | true | true | N/A | 00:00:01
3 | MOD10CM.005 | SERVICE | true | http://f5dpl01.ed... | true | true | ENABLED | 00:00:03
7Perform a service request with the new collection.
Visit the Earthdata Search Client (using the correct provider).
Search for granules of the chosen collection and perform a service request.
Choose the OPENDAP_BES service.
Choose one or two of the available bands.
View the outputs to make sure only the selected bands have been included in the output.
 

...