Title: 		Instructions for Ingesting (Regionalsat) SPoRT Products Using the Data Addons Manager (DAM)
Date: 		July 10, 2018
AWIPS II Ver.:	17.3
SPoRT Contacts:	Matt Smith (matthew.r.smith@nasa.gov)
		Kevin McGrath (kevin.m.mcgrath@nasa.gov)

######################
* DAM CONFIG
######################

1.) Retrieve your office's tarball (SPoRT-<siteID>.tgz) from the SPoRT web server https://geo.nsstc.nasa.gov/SPoRT/awips/DAMsites/<siteID>/. Place the file in /localapps/runtime/DAM-Config/SITE/.

2.) Untar/uncompress the tarball (e.g., "tar xvfz SPoRT-HUN.tgz"). It will create a small directory structure and an xml file (RegsatSources_sport_<siteID>.xml) & two LDM snippets in that directory.

3.) Modify your office's DAM SITE-level RegsatSources.xml file (/localapps/runtime/DAM-Config/SITE/RegsatSources.xml), if it exists. Insert the <source>...</source> attribute block from the downloaded RegsatSources_sport_<siteID>.xml. If your office does not have a RegsatSources.xml file, copy the newly downloaded XML file to that location. Check that your RegsatSources.xml file is well-formed XML (e.g., "xmllint RegsatSources.xml").

4.) Move the two SPoRT-specific LDM snippets (ldmd_sport.conf & pqact_sport.conf) to your LDM system. See LDM CONFIG section below.

5.) Run the DAM install script. You should see SPoRT-<siteID> as an installable option within the Regsat tab. The DAM will make backups of all important files and then add SPoRT-<siteID> entries as needed.

6.) If you wish to have custom regionalSat purge rules, edit /awips2/edex/data/utility/common_static/site/<siteID>/purge/regionalsatPurgeRules.xml. You can use /awips2/edex/data/utility/common_static/base/purge/satellitePurgeRules.xml as a basis. For your office's regionalSat needs, you may need to modify either of these files.

7.) Restart the ingest service on the EDEX servers.



######################
* LDM CONFIG

Perform the following changes on (all of) your 'ls' machines as user 'ldm'.
######################

1.) Insert the "SPoRT Entries" blocks from ldmd_sport.conf and pqact_sport.conf into your ldmd.conf and pqact.conf LDM configuration files, respectively - remembering to keep the tabs intact.
****** In the ldmd.conf file - Remember to replace the string "<NwsLdmServer>" with the IP address of your regional LDM server.

2.) Restart the LDM service.



######################
* LDAD CONFIG

Perform the following changes on (all of) your 'px' machines as user 'ldad'.
######################

1.) The DAM provides a generic preprocessor, so simply ensure that your ~ldad/data/LDADinfo.txt file has the following:

LDAD-REGIONALSAT| | | | | |A2-preProcess.py |

2.) If you made changes - restart LDAD.
The default locations for the required commands are:
  To stop: /awips/ldad/bin/stopLDAD.sh
  To start: /awips/ldad/bin/startLDAD.csh