Procedure for making and installing ATCF updates.

-----------------------------------------
 
Make the atcf applications at NRL:

   Increment version #.
   Make sure atcfmapdsp.xrc reflects the correct version and date.
   Make sure files have been committed to svn recently.
   Checkout a copy of the code from svn.
   Do a 'make' to compile and link the code.
   Check the owners/groups and privileges on executables in atcffls directory.
   Remove all of the .svn directories.
   Move all the source code out of the atcf directory to source directory to
   reduce clutter for JTWC.
   Make a tar file and gzip it.
   ftp the gzipped & tarred file to target computer and send email.
   Send email to JTWC personnel notifying them of the installation file.
   Remind them to merge the $ATCFINC *_editme (both include dirs) and 
   $ATCFSCRIPTS *_editme files,
   Remind them to merge $ATCF/atcfEnvs_editme and $ATCFINC/atcfsite.nam_editme
   with theirs.

-------------------------------------------

Install the atcf application at target site (JTWC):

1. Before unzipping the new atcf installation
   first save existing executables, includes and scripts.
   Below are three different ways to save current files.

   a. # tar up executables (atcffls), include and scripts directories
      cd $ATCFFLS
      cp ../atcf30 .
      cp ../atcf30.uid .
      cp ../atcf30.csc .
      find . -type f -maxdepth 1 > executables.lst
      tar -cvf ../../atcfyyyymmddsave_exe.tar -T executables.lst 
      # Where yyymmdd is the yyyymmdd from the current atcf30. 
      cd $ATCF
      tar -cvf ../atcfyyyymmddsave_inc.tar include
      tar -cvf ../atcfyyyymmddsave_scripts.tar scripts

   b. Do a backup of the entire /users/atcfcm directory structure to the
      backup disk by running /usr/nrl/bin/backup_atcfcm (look on omar).
      However there is currently no /driveb on atcfp2.  06/08/2007  ajs

   c. Backup the entire /users/atcfcm/atcf directory structure to another 
      directory on the same disk.  Don't include the big directories like 
      images, aidmessages, storms, archives since our install will not be
      overwriting any files in these directories.
      cd /users/atcfcm
      mkdir atcf_backup
      If atcf_backup exists, remove the contents of the old atcf_backup dir.
      Specify which directories to exclude with the following command:
      tar -X exclude_p2 -cvf atcf_backup/atcfyyyymmdd_save.tar atcf/*
      where exclude_p2 is a file containing the directories to exclude
      and yyymmdd is the yyyymmdd of their current atcf30.
      Do "du" on atcfp2 $ATCF, use that to decide what to put in exclue_p2.
      cd atcf_backup
      tar -xvf atcfyyyymmdd_save.tar


2. # Untar (extract) the new version of ATCF:
   cd $ATCF
   cd ..
   /users/atcfcm% tar -zxvf atcfyyyymmdd_new.tar.gz


3. Check for new changes on target box that need to be merged in.
   This is the time consuming step.

      cd $ATCF
      find . -name "*_editme"
   Merge existing files on target computer with possible new changes from
   all of the *_editme files.


4. If atcfEnvs files has been changed make sure to have all users log out
   and log back in before starting up the newly installed version of ATCF.


5. Check the owners/groups and privileges on files in the atcffls, include 
   and scripts directories.