NAWIPS.install.README P.Bruehl/NWS 10/96 R.Rozumalski/NWS 1/00 R.Rozumalski/NWS 11/00 --------------------------------------------------------------------- This file gives the steps for installing NAWIPS 5.6 on an HP UX or LINUX workstation. This file has three parts: Part I: Preparing your system for installing NAWIPS for the first time. Part II: Preparing your system for installing NAWIPS 5.6 when an earlier version of NAWIPS exists on your workstation. Part III: Installing NAWIPS 5.6. Depending on your situation, you will follow the steps in Part I OR Part II. Everyone must follow the steps in Part III. --------------------------------------------------------------------- PART I: Preparing your system for installing NAWIPS for the first time. (Note, if you have a previous version of NAWIPS installed on your system, please go to Part II.) 1) Create a "gempak" user account. This user will own the NAWIPS software. I suggest that you use the name "gempak" for this account. Use SAM to create user "gempak" and be sure to give it a good password. As part of the process of creating the user, SAM will ask you to choose a start up program. Be sure to choose the C-Shell (/bin/csh) as this is favored by the NAWIPS environment scripts. 2) Configure user "gempak"'s home directory. When you create the gempak user, it will be given a home directory. Most likely, it will be located in /users/gempak. Remember this, because you will need this information later. As root, cd to the gempak home directory, and check it's ownership:: % cd ~gempak % ls -lsa . Look for the entry with the "." in the far right column: 4 drwxr-xr-x 2 root bin 1048 Oct 18 14:53 . If the user name is "root" (as shown above), change it to "gempak": % chown gempak:users . If the user name is "gempak", you don't need to do anything. 3) Log into your workstation as user gempak. 4) Prepare for the NAWIPS installation. The NAWIPS software requires a lot of disk space (roughly 100 MB). In order to support this large distribution, I recommend that you install it on one of your external disk drives. For example, you might choose to install the NAWIPS software in /usr1/nawips. Even though user "gempak" will be doing the installation, we don't want to install NAWIPS in the gempak home directory (/users/gempak). This directory is probably located on your internal hard drive, and there is simply not enough space on that drive. So, create a directory on one of your external hard drives. You may call it anything you like, however I suggest calling it "nawips/". For the rest of the installation, I will assume that you've chosen to install the software in the "/usr1/nawips/" directory. You may need to be root to create the /usr1/nawips directory. Here's how: % su % mkdir /usr1/nawips % chown gempak:users /usr1/nawips % exit Note that we've changed the ownership of /usr1/nawips to user gempak. Make sure that you have at least 100 MB free on the disk /usr1. (Use the "bdf" command to see your available disk space.) 5) Start the Installation You are now ready to start the installation. Please skip to Part III. --------------------------------------------------------------------- PART II: Preparing your system for installing NAWIPS 5.6 when an earlier version of NAWIPS exists on your workstation. 1) Protect your changes (if any). If you already have an existing NAWIPS distribution on your SAC, you probably have a user named "gempak". In NAWIPS version 5.4, we will be using the "gempak" home directory to store some files that set up the NAWIPS environment. If you have made any changes to the following files in the gempak home directory, you MUST make copies of them before proceeding to Part III. If you do not, the new software will overwrite your existing files and your changes will be lost: .cshrc Common.cshrc Nawips.cshrc Common.aliases 2) Log in a user gempak. 3) Suspend NAWIPS data processing. Since we are installing a new version of NAWIPS, it would be a good idea to suspend any real-time NAWIPS data access, decoding, or processing script that you may be running. I suggest commenting out any NAWIPS-related cron jobs. As user gempak (and/or user LDM if applicable): % crontab -l > cronjobs.current Edit the file "cronjobs.current" and put a "#" in the first column of any NAWIPS-related jobs. % crontab cronjobs.current After the NAWIPS 5.6 installation is complete, uncomment the cron jobs: % crontab -l > cronjobs.current Edit the file "cronjobs.current" and remove the "#" in the first column of any NAWIPS-related jobs. % crontab cronjobs.current 4) Find your real time data tree. Use the $METDAT environment variable to locate the root of your real time directory tree. For many of you, this directory is located in /usr1/metdat. If that is the case on your system, you do not have to do anything. HOWEVER, if your $METDAT directory is underneath your existing (old) version of NAWIPS (i.e. /usr1/nawips/metdat) you MUST move it to another directory: % mv $METDAT /usr1/metdat 4) Take stock of any contributed software you are using. Determine if you have applied any contributed software (from the contrib/ directory of the SAC FTP server) to your NAWIPS distribution. You will have to RE-INSTALL all contributed software after you complete the NAWIPS 5.6 installation. This includes Keith Brill's MODSND package and GARP. For MODSND, you can simply re-install your current version. 5) Delete or move your current version of NAWIPS. You have a choice to make. Before you unpack NAWIPS 5.6, you must either: A) Completely delete the existing old NAWIPS distribution % rm -rf /usr1/nawips % su % mkdir /usr1/nawips % chown gempak:users /usr1/nawips % exit or B) Move the existing old NAWIPS distribution to a new location and install the new version in a parallel directory. % su % mv /usr1/nawips /usr1/nawips54 % mkdir /usr1/nawips56c % ln -s /usr1/nawips56c /usr1/nawips % chown gempak:users /usr1/nawips56c % exit There is an advantage to choosing option B. If the installation of NAWIPS 5.6c is not completed for some reason, you can easily switch back to the old version. Also, once the 5.6c installation is complete, you can verify that it is working properly before you delete the old version. However, the NAWIPS 5.6c distribution will require a minimum of 300 MB of disk space. If you don't have this much free disk space, then you must delete the old distribution before installing the new distribution. 6) Start the installation You are ready to start the NAWIPS 5.6c installation. Be sure that you have at least 100 MB free disk space left on the disk drive (use the "bdf" command). --------------------------------------------------------------------- PART III: Installing NAWIPS 5.6. There are three tar files that make up the NAWIPS 5.6 distribution. They are: nawips56c_soosac.tar.Z NAWIPS 5.6c core distribution nawips56ic_binary_{OS}.tar.Z NAWIPS 5.6c binary release gempakdir56.tar.Z Set Up files needed to run NAWIPS The {OS} above represents either HPUX or LINUX. You should make sure of the operating system that you are on before downloading the files. 1) Log in as user gempak. cd to the /usr1/nawips directory: % cd /usr1/nawips 2) FTP the distribution from the SAC FTP server. If you do not know, or do not remember, the address and account information for this server, please contact your National Sac Coordinator. Once connected to the SAC FTP server, cd to nawips and "get" the files: ...FTP to SAC FTP server... ftp> cd nawips ftp> get nawips56c_soosac.tar.Z ftp> get gempakdir56.tar.Z ftp> get nawips56c_binary_{OS}.tar.Z ftp> quit 3) Install the gempakdir56.tar.Z file Move the file to the gempak home directory and unpack it: % mv /usr1/nawips/gempakdir54.tar.Z ~gempak/ % zcat gempakdir56.tar.Z | tar xvf - This will unpack the set up files for NAWIPS 5.6c After unpacking the tar.Z file, you can delete it, if you want. 4) Configure the set up files for NAWIPS 5.6c These files are used to set up the environment needed by NAWIPS 5.6c. Other users who want to run NAWIPS should also use these files to set up their environment to run NAWIPS. The files are: .cshrc This is the file that is automatically "sourced" each time user gempak logs in. Each user that runs the C-shell (/bin/csh) start up program has one of these files in his home directory. This particular example simply "sources" Common.cshrc, described next. Common.cshrc This file contains all the UNIX settings that user gempak requires. It is "sourced" by user gempak's .cshrc file. In order to configure this file for your particular computer, you must edit this file, and read the comments. The comments will instruct you on what changes (if any) you need to make. Other users on your system can source this file too, if they want to mimic the NAWIPS environment. Simply add the following line to the user's .cshrc file: source ~gempak/Common.cshrc Common.aliases This file contains some common Unix "aliases". It is unlikely that you will need to change any definitions made here. If any user wants to make his or her own individual aliases, they should be defined in a file called ".aliases" in the user's home directory, not in this file. Just leave this file the way it is. Note that there have been some minot changes from previous versions to accomodate the LINUX support. Some additional aliases have been added. 5) Set up your environment. Run the following commands: % source ~gempak/.cshrc % rehash Next time you log in as user gempak, these commands will be run for you by your operating system. 6) Unpack the NAWIPS 5.6c distribution. cd back to /usr1/nawips and uncompress and untar the NAWIPS 5.6c distribution: % cd /usr1/nawips % zcat nawips56c_soosac.tar.Z | tar xvf - % zcat nawips56c_binary_{OS}.tar.Z | tar xvf - % rehash The zcat command will uncompress and untar all the NAWIPS files. This could take a considerable amount of time. When the command finishes, you can delete the nawips56c_soosac.tar.Z file. Here are a few final steps/comments: 1) If you have installed NAWIPS 5.6c in parallel with an older version of NAWIPS, don't forget to delete the old version once the new version is up and running. 2) Don't forget to reinstall any contributions (i.e. modsnd99_full.tar.Z and gribmaster2.1.tar.Z) that you have been using with your old version of NAWIPS. 3) Don't forget to turn your real time data processing back on. See Part II, Step 3 above. 4) Pdf files of the NAWIPS 5.6 Users Manual are included in the $NAWIPS/doc/User_guide/pdf directory. You must print out your own copy of the manual.