1. AWIPS Localization Issues COMET Basin Customization Course Michael Mercer March 2003

2. AWIPS Localization Issues Installing basin shapefiles on AWIPS using NSSL CD Installing basin shapefiles on AWIPS using NOAA1 Installing locally edited basin shapefiles Installing other GIS spatial data on AWIPS

3. AWIPS Localization Issues DHR product must be on all operational RPS lists in order to run FFMP. –For each dedicated radar –Other offices may be dedicated to “your” radar Basin shapefiles (only.shp) include “.gz” (.shp.gz) extension. Do NOT uncompress these files for use in AWIPS. (You will need to uncompress to use in ArcView) To compress/uncompress the shapefiles on a PC you must have software such as WinZip. On AWIPS use the gzip command to compress, and the gunzip command to uncompress.

4. Installing Basin Files on AWIPS Using Basin CD 1. Mount the compact disk (titled by radar) on the DS1 as follows. Insert the compact disk into the CD-ROM drive on the DS1 and run the following command as root: For K class server: mount /dev/dsk/c3t2d0 /cdrom For D class server: mount /dev/dsk/c1t2d0 /cdrom 2. Go to the nationalData directory and copy the necessary files from the compact disk. Note: use lower case radar ID for kxxx. Also note, there will be two.gz files. These files will be left as.gz on AWIPS (do NOT uncompress). cd /data/fxa/nationalData cp /cdrom/kxxx/kxxx_aggr*./ cp /cdrom/kxxx/kxxx_bins*./

5. 3. Change the ownership and permissions for the shapefiles in the /data/fxa/nationalData directory chown fxa:fxalpha kxxx_aggr* kxxx_bins* chmod 775 kxxx_aggr* kxxx_bins* 4. Unmount the compact disk cd / fuser -k /cdrom umount /cdrom Installing Basin Files on AWIPS Using Basin CD

6. 5. If localizing on Linux, please manually link directories before localization. On Linux, go into the /awips/fxa/data/localization/nationalData/ directory and look for links to the kxxx_aggr_basins* and kxxx_bins* files (where xxx is the 3-letter, lower-case radar identifier). If you find no such symbolic links, then add them manually in the above- mentioned local Linux directory (the links you create will point to FFMP shapefiles in /data/fxa/nationalData/ ): cd /awips/fxa/data/localization/nationalData ln -s /data/fxa/nationalData/kxxx_aggr_basins.dbf kxxx_aggr_basins.dbf ln -s /data/fxa/nationalData/kxxx_aggr_basins.shp.gz kxxx_aggr_basins.shp.gz ln -s /data/fxa/nationalData/kxxx_aggr_basins.shx kxxx_aggr_basins.shx ln -s /data/fxa/nationalData/kxxx_bins.dbf kxxx_bins.dbf ln -s /data/fxa/nationalData/kxxx_bins.shp.gz kxxx_bins.shp.gz ln -s /data/fxa/nationalData/kxxx_bin.shx kxxx_bins.shx Installing Basin Files on AWIPS Using Basin CD

7. 6.Change to the scripts directory. cd /awips/fxa/data/localization/scripts 7. Localize for radar (forced) and scan (not forced) on all workstations one at a time, including any LINUX workstations. It will not be necessary to localize on the application servers or the data servers. Note that the first of these localizations will likely take more time (more than 30 minutes) as it is creating data that is shared. Once this data gets created, subsequent localizations will just skip over the execution of the creation of that data and thus take less time (less than 10 min). Also note that while performing localizations, SCAN/FFMP should not be in use on any of the workstations. su - fxa rlogin ws1 cd /awips/fxa/data/localization/scripts mainScript.csh f -radar mainScript.csh -scan exit rlogin ws2...(perform for each HP and Linux workstation) 8.Stop and restart FFMPprocessor using the stopFFMPprocessor command on AS1 as user "fxa", and restart afterwards using startFFMPprocessor. Note the "cd" command will have to be performed for each login (there's no command path to the scripts directory). Installing Basin Files on AWIPS Using Basin CD

8. Installing Basin Files on AWIPS NOAA1 Directory Structure

9. Installing Basin Files on AWIPS Using NOAA1- Back Up Procedures 1. Log on DS1 as user “fxa”. FTP NOAA1 from DS1 ftp 165.92.25.15 Name: ffmp Password: m023a 2. Go to original_basin or updated_basin directory (which ever contains the latest operational version), then go to the directory which contains the radar files you’re requesting (kxxx). [If your files are in the original_basin directory, you will then go directly to the radar directory. If your files are in the updated_basin directory, you will then go to your WFO directory, then the radar directory.] You need to do this for all dedicated radars. cd original_basin cd kxxx Note: Please allow between 60 & 75 minutes for ftp download

10. 3. Change you local directory to /data/fxa/nationalData. Then retrieve all files (kxxx_aggr_basins* and kxxx_bins*) in radar directory (in binary mode) and close out of ftp. lcd /data/fxa/nationalData mget * bye 4. Change the permissions for the shapefiles in the /data/fxa/nationalData directory chmod 775 kxxx_aggr* kxxx_bins* Installing Basin Files on AWIPS Using NOAA1- Back Up Procedures

11. 5. If localizing on Linux, please manually link directories before localization. On Linux, go into the /awips/fxa/data/localization/nationalData/ directory and look for links to the kxxx_aggr_basins* and kxxx_bins* files (where xxx is the 3-letter, lower-case radar identifier). If you find no such symbolic links, then add them manually in the above- mentioned local Linux directory (the links you create will point to FFMP shapefiles in /data/fxa/nationalData/ ): cd /awips/fxa/data/localization/nationalData ln -s /data/fxa/nationalData/kxxx_aggr_basins.dbf kxxx_aggr_basins.dbf ln -s /data/fxa/nationalData/kxxx_aggr_basins.shp.gz kxxx_aggr_basins.shp.gz ln -s /data/fxa/nationalData/kxxx_aggr_basins.shx kxxx_aggr_basins.shx ln -s /data/fxa/nationalData/kxxx_bins.dbf kxxx_bins.dbf ln -s /data/fxa/nationalData/kxxx_bins.shp.gz kxxx_bins.shp.gz ln -s /data/fxa/nationalData/kxxx_bin.shx kxxx_bins.shx Installing Basin Files on AWIPS Using NOAA1- Back Up Procedures

12. 6. Change to the scripts directory. cd /awips/fxa/data/localization/scripts 7. Localize for radar (forced) and scan (not forced) on all workstations one at a time, including any LINUX workstations. It will not be necessary to localize on the application servers or the data servers. Note that the first of these localizations will likely take more time (more than 30 minutes) as it is creating data that is shared. Once this data gets created, subsequent localizations will just skip over the execution of the creation of that data and thus take less time (less than 10 min). Also note that while performing localizations, SCAN/FFMP should not be in use on any of the workstations. su - fxa rlogin ws1 cd /awips/fxa/data/localization/scripts mainScript.csh f -radar mainScript.csh -scan exit rlogin ws2...(perform for each HP and Linux workstation) 8.Stop and restart FFMPprocessor using the stopFFMPprocessor command on AS1 as user "fxa", and restart afterwards using startFFMPprocessor. Note the "cd" command will have to be performed for each login (there's no command path to the scripts directory). Installing Basin Files on AWIPS Using NOAA1- Back Up Procedures

13. Installing locally edited Basin Shapefiles on AWIPS Things to remember –Must load two files (filenames in lower case) kxxx_aggr_basins.* kxxx_bins.* –Must compress the.shp file in both files (.shp.gz) This can either be done on a PC using software such as WinZip, or on AWIPS using the gzip command –Must upload all edited, operationally used shapefiles to NOAA1 –Ask for assistance from AWIPS focal point, ITO, etc

14. Installing locally edited Basin Shapefiles on AWIPS Method A –The easiest way is to perform edits on a PC which contains both ArcView and a CD burner. Then just follow the instructions titled, “Installing Basin Files on AWIPS using Basin CD”. Finally, once files are installed on AWIPS, upload the edited files to NOAA1 (updated_basin directory). NOTE: When going from a Windows platform to AWIPS, files names and formats may change (character length only 8, only in upper case, and file name appended with “;1”). AWIPS (FFMP) will NOT accept these changes. You may want to use a Linux machine to upload files from a CD created by Windows.

15. Installing locally edited Basin Shapefiles on AWIPS Method B –If your PC (where ArcView resides) does not have a burner, try loading and saving the shapefiles on the LAN, and then from a different PC (which has a burner and is connected to the LAN) burn the new shapefiles. Then just follow the instructions titled, “Installing Basin Files on AWIPS using Basin CD”. Finally, once files are installed on AWIPS, upload the edited files to NOAA1 (updated_basin directory). NOTE: When going from a Windows platform to AWIPS, files names and formats may change (character length only 8, only in upper case, and file name appended with “;1”). AWIPS (FFMP) will NOT accept these changes. You may want to use a Linux machine to upload files from a CD created by Windows.

16. Installing locally edited Basin Shapefiles on AWIPS Method C (FTP) –A: If LAN is running on ftp server, then ftp files to AWIPS. Use binary mode. OR –B: From the PC where ArcView is installed, open DOS window and ftp LDAD (server IP address). Use binary mode. Go to directory where you will store the files (different for each WFO). Use the “put” command to transfer files. Exit ftp (bye). Go to DS or workstation and open telnet window and log on as AWIPS user. Change directory to /data/fxa/nationalData. Ftp to LDAD. Use binary mode. Use the “get” command to transfer files. Continue with step 3 using instructions titled, “Installing Basin Files on AWIPS using Basin CD”. Finally, once files are installed on AWIPS, upload the edited files to NOAA1 (updated_basin directory).

17. Installing locally edited Basin Shapefiles on AWIPS Upload locally edited files to NOAA1 (updated_basin directory) 1. Log on DS1 as user “fxa”. Change your local directory to /data/fxa/nationalData. FTP NOAA1 from DS1 ftp 165.92.25.15 Name: ffmp Password: m023a 2. Change directory to updated_basin directory, then your WFO directory, then the radar directory. Using binary mode, use the “put” command to transfer files (kxxx_aggr_basins* and kxxx_bins*) to NOAA1.

18. Installing locally edited Basin Shapefiles on AWIPS For AWIPS Operational Build 1 (OB1) Operational Build 1 (OB1) Deployment Date: Feb 03 –FFMP Enhancements: Display county/state names in Basin Table (instead of FIPS codes) Change wording in Basin Trend legend (add threshold values/numbers) Plot FFG in Basin Trend from 1 hour straight to y-axis Highlight “refresh” button when something has changed which needs refreshing Add time frame to FFTI pop-up text

19. Installing locally edited Basin Shapefiles on AWIPS For AWIPS Operational Build 2 (OB2) Operational Build 2 (OB2) Deployment Date: Summer 03 –FFMP Enhancements: Virtual Basin (gage) Implementation Use of QPF as a precipitation source (for display) Forced FFG Mosaic New VCP #77 (4.1 min)

20. Installing other GIS spatial data on AWIPS The National Atlas http://nationalatlas.gov/natlas/natlasstart.asp The National Map http://nationalmap.usgs.gov/ Census Bureau Tiger Data http://tiger.census.gov/cgi-bin/mapbrowse-tbl Geography Network (ESRI) http://www.geographynetwork.com/ AWIPS Map Database http://www.awips.noaa.gov/mapdata/newcat/

21. Installing other GIS spatial data on AWIPS http://www.awips.noaa.gov/mapdata/newcat/papers/agmgfaq.htm#Question_5

27. FFMP Information Michael Mercer NWS National Flash Flood Project Coordinator NWS/OCWWS/Hydrologic Services Division (301)713-0006 x162 FFMP List Server http://infolist.nws.noaa.gov/scripts/lyris.pl?enter=awips-ffmp&text_mode=0&lang=english FFMP website (MDL): FFMP Users Guide, Tutorial, DRT Instructions, and Forced FFG Utility Users Guide: http://www.nws.noaa.gov/mdl/ffmp/index.htm NOAA Coastal Service Center (GIS Training) http://www.csc.noaa.gov