NOHRSC Technology > NOHRSC GIS Applications

The following is documentation for the installation of NOHRSC's Integrated Hydrologic Automated Basin Boundary System (IHABBS) and Unit Hydrograph (UHG) on a system with no prior version present.

System Requirements

• Informix 7.23+ with Linux
• Informix runtime libraries located in /opt/informix
  If Informix is located elsewhere, such as /usr/informix, created a /opt/informix symbolic link to the appropriate location will alleviate this.
• The Informix database should have buffered logging turned ON if running on an AWIPS computer.
• The Linux kernel should have the most recent system patches.
• Standard Motif 1.2 runtime libraries
• Space needed for installation:  (size of Depression-filled DEM) * 20
  This space reflects the space needed for the executables and the larger raster data files.
• Total space needed: .................(size of Depression-filled DEM) * 40
  This assumes that the user will be altering and creating multiple new flow direction layers and multiple basin layers. The total is usually around 1 GB for a moderate-sized River Forecasting Center region.

Resources

In read/write color environments, such as using 8-bit color on HP-UX, NOHRSC programs require the Xserver and allocates most of the Xserver resources during execution. For this reason DISPLAY must be set to the workstation, and only NOHRSC graphic applications should be running from the same workstation on that display.

In a 24-bit read-only color setting, as is often in Linux, merely the DISPLAY should be set to the workstation.

IHABBS Version 3.12+ Complete Install

June 18, 2004

The following documentation is an aid for the installation of NOHRSC's Integrated Hydrologic Automated Basin Boundary System (IHABBS) and Unit Hydrograph (UHG). There are two issues to become familiar with prior to installation. These two issues are addressed in NOHRSC Applications Supported by AWIPS-Hosted Informix Servers followed by these step-by-step instructions for creating the database and IHABBS environment. When these steps are complete, data layers can be loaded into IHABBS using the NOHRSC Database Administration utility. Please contact Anders Nilsson at NOHRSC, (952) 368-2517 or email , after implementing this step-by-step process.

1. Download the following four files and put them into the same directory:

   1. nohrsc_docs.tar.gz
   2. nohrsc_executables.tar.gz
   3. nohrsc_static_layers.tar.gz
   4. and layers specific to your region from:
      
      • ABRFC
      • APRFC
      • CBRFC
      • CNRFC
      • LMRFC
      • MARFC
      • MBRFC
      • NCRFC
      • NERFC
      • NWRFC
      • OHRFC
      • SERFC
      • WGRFC

2. Uncompress the files by using the following:

      tar xvzf nohrsc_docs.tar.gz
      tar xvzf nohrsc_executables.tar.gz
      tar xvzf nohrsc_static_layers.tar.gz
      tar xvzf XXrfc_layers.tar.gz
   

   These will create an "install" directory, and fill it with files.

3. Next, some environment variables have to be set for the rest of the installation process. These variables will also need to be set in the shell before a NOHRSC application can be run. Some RFCs define these variables in the user's profiles (files such as .profile, .appsdefaults, or .bashrc), while others place these in a script which then calls the nohrsc launcher. The general PATH environment variable will also need to have the directory containing the executables in it (described below).

   File path info:

   export GISRS_HOME=

   a parent master directory into which IHABBS-related subdirectories will be placed.

   export GISRS_COMMON_DATA=

   a parent directory into which static "common" data (State outlines, county boundaries, etc...) will be placed. (This is often the same as $GISRS_HOME)

   export GISRS_BASIN_DATA=

   a parent directory into which IHABBS static data (flow accumulation grids) and more dynamic data (basin vectors) will be placed. (This is often the same as $GISRS_COMMON_DATA)

   export GISRS_ARCHIVE=

   a directory to contain archived and shared layers (and often installation packages) (This is often $GISRS_HOME/archive)

   export GISRS_SCRATCH_PATH=

   an already-created directory to contain scratch files. Preferably located on a local disk (akin to /tmp). This directory should have 1 GB free. If there are no available local disks, leave this environment variable undefined.

   export IHABBS=

   a directory to contain all the binary executables (This is often $GISRS_HOME/bin)

   export PATH=$PATH:$IHABBS
   

   Database info:

   export INFORMIXDIR=/opt/informix

   export INFORMIXSERVER=

   the name of the database server as listed in /opt/informix/etc/sqlhosts

   export GISRS_DATABASE=

   the name of the database that you wish to use (This is often gisrs)

   Misc. Preferences:

   export GISRS_DATABASE_WAIT_SECONDS=60

   (duration in seconds for an overly long database transaction)

   export GISRS_FILE_SIZE_PAUSE_SECONDS=1

   (duration after which, if a file size has not changed, it is assumedly finished copying)

   export GISRS_MINIMUM_RASTER_COMPRESSION_LEVEL=100

   (Maximum percentage size of a compressed raster. A value of 100 means that the programs will compress a raster file if the compressed file is smaller than the original file)

   GISRS_USER=`whoami`

   GISRS_MAIL=`whoami`

4. Database Setup

   Once these are set, the database needs to be created on the database server. The Informix administrator can create the Informix database used by NOHRSC applications. The following can be typed on the database server.

      dbaccess [enter]
      Database -> Create -> [name of database specified in $GISRS_DATABASE]
         (This is often "gisrs".)
      Dbspace -> [select dbspace]
      Log -> Buffered_log
      Exit -> Create-new-database
      Exit
      Query-language -> New
   
         grant connect to public;
         grant resource to public;
   
      [Escape]
      Run
      Exit
      Exit
   

5. Once the database has been created, run the following three scripts:

      ./make_directories.sh
   

   (This will create the directories specified by the environment variables.)

      ./copy_files.sh
   

   (This will move the executables and the documentation to their places. This will also update the nohrsc.cfg configuration file with the values specified in the environment variables.)

      ./install_script.sh
   

   (This will create tables within the newly created database, and then populate it with restored layers.)

Documents and Programs

This is a minimum listing of what should be in the <BIN> directory.

Obsolete executables for HP-UX can be foud in this directory.

National Weather Service National Operational Hydrologic Remote Sensing Center Office of Water Prediction 1735 Lake Drive W. Chanhassen, MN 55317
Contact NOHRSC Glossary Credits Information Quality Page last modified: Jun 02, 2014 - cloud	About Us Disclaimer Privacy Policy FOIA Career Opportunities