Title: Instructions for Ingesting SPoRT Data Using the RegionalSat EDEX Plugin Date: May 18, 2016 AWIPS II Ver.: 16.1 SPoRT Contacts: Kevin McGrath (kevin.m.mcgrath@nasa.gov) Matt Smith (matthew.r.smith@nasa.gov) ###################### * EDEX CONFIG Perform the following changes on your EDEX servers (dx3 and dx4) as user awips. ###################### 1.) Allow ingest of the data files by modifying the regionalSat distribution file (/awips2/edex/data/utility/edex_static/site//distribution/regionalsat.xml). If this file doesn't exist, first copy it from base (/awips2/edex/data/utility/edex_static/base/distribution/regionalsat.xml). See the included edex/regionalsat.xml.snippet file for example entries. Include only lines pertaining to datasets you wish to ingest. These entries should be encapsulated by the tags. 2.) Modify /awips2/edex/data/utility/edex_static/site//satellite/regionalsat/creatingEntities.xml to include the pertinent entries found in the provided edex/creatingEntities.xml.snippet file. If the site copy of this file doesn't exist, first copy it from base (/awips2/edex/data/utility/edex_static/base/satellite/regionalsat/creatingEntities.xml). These entries should be encapsulated by the tags. 3.) Modify /awips2/edex/data/utility/edex_static/site//satellite/regionalsat/physicalElements.xml to include the pertinent entries found in the provided edex/creatingEntities.xml.snippet file. If the site copy of this file doesn't exist, first copy it from base (/awips2/edex/data/utility/edex_static/base/satellite/regionalsat/physicalElements.xml). These entries should be encapsulated by the tags. 4.) Modify /awips2/edex/data/utility/edex_static/site//satellite/regionalsat/source.xml to include the "NASA SPoRT" line found in the provided edex/source.xml file. If the site copy of this file doesn't exist, first copy it from base (/awips2/edex/data/utility/edex_static/base/satellite/regionalsat/source.xml). This entry should be encapsulated by the tags. 5.) Modify /awips2/edex/data/utility/cave_static/site//satellite/customLegends.xml to include the pertinent entries found in the provided edex/customLegends.xml file. If the site copy of this file doesn't exist, use the provided edex/customLegends.xml file. Any entries added to an existing file must be encapsulated by the tags. 6.) If you wish to have custom regionalSat purge rules, edit /awips2/edex/data/utility/common_static/site//purge/regionalsatPurgeRules.xml. You can use /awips2/edex/data/utility/common_static/base/purge/satellitePurgeRules.xml as a basis. By default, 24 versions of each product are retained. 7.) Restart the ingest service on the EDEX servers. ###################### * LDAD CONFIG Perform the following changes on all of your px machines as user ldad. ###################### 1.) You'll need two scripts to receive and unzip the SPoRT data: preldadsport.pl and ldadsport.pl. Copy the two provided scripts (found in the provided ldad/ directory) to ~ldad/bin and make sure that they're executable (chmod u+x *.pl). If copying from DOS - ensure that you remove DOS newline characters with the "dos2unix" program or another comparable method. 2.) Append the applicable contents of the provided ldad/LDADinfo.txt.snippet file to the end of your ~ldad/data/LDADinfo.txt file. 3.) Restart LDAD ingest on your px machines. ###################### * LDM CONFIG Perform the following changes on all of your ls machines as user ldm. ###################### 1.) Modify REQUEST entries in ldm/ldmd.conf.snippet file (see notes in the snippet file) before adding to ~ldm/etc/ldmd.conf. Replace with the IP/address of your regional LDM server. Be sure to use tabs instead of blank spaces. 2.) Add the applicable entries to ~ldm/etc/pqact.conf from the provided ldm/pqact.conf.snippet file. Note that some of the product sets have multiple domains, which are detailed in the comment lines. Add additional entries for EACH domain that you wish to receive. 3.) Restart the LDM service. ###################### * SPoRT CAVE FILES Perform the following on one of your EDEX servers (dx3 or dx4) as user awips. This will add SPoRT configurations to CAVE and provide requisite bundles, color maps, and styleRules files. ###################### *** To Uninstall Previous Files: Perform the following if you've previously installed the SPoRT CAVE files: 1.) Browse to the legacy workingDirectory/ directory created by untarring the sportCaveConfigInstaller tarball. Run uninstall.sh. This will remove the old files and directories. 2.) Or just remove the SPoRT-specific directories with the following commands: cd /awips2/edex/data/utility/common_static/site// rm -rf styleRules/SPoRT/ colormaps/SPoRT/ derivedParameters/definitions/sport* rm derivedParameters/functions/sport* cd /awips2/edex/data/utility/cave_static/site// rm -rf menus/SPoRT/ bundles/SPoRT/ *** To Install New Files: 1.) If present, remove the old workingDirectory/ directory (via `rm -rf workingDirectory`) that was created last time you untarred the sportCaveConfigInstaller tarball. 2.) Untar the new sportCaveConfigInstaller tarball (example: `tar xzvf sportCaveConfigInstaller_hun.tgz`). This will create a new workingDirectory/ directory. 3.) Run workingDirectory/installer.pl. a.) You'll be asked whether you want to install the files to the site or user level. i.) If site level, you'll be prompted to enter your site ID, which is case-sensitive. Be sure to use all-caps (example: HUN). ii.) If user level, you'll be prompted to enter your user ID, which is case-sensitive. b.) You'll be asked to confirm the base install directory for the files. Enter y if correct. 4.) If installer.pl complains about not being able to overwrite legacy files, run it with the "force" option (`workingDirectory/installer.pl -f`). 5.) installer.pl will create a new uninstall script (workingDirectory/uninstall.sh), which you can use to remove the files that you just installed.