Installing McIDAS-XCD 2009

To begin this procedure, you must be logged on as user mcidas, and you must have already built McIDAS-X.

1. First, if you want to use the ADDE GRIB server (highly recommended) for NOAAPORT model data, make sure that the environment variable MySQL_ROOT is defined in your shell-appropriate configuration file. Please refer to Preparing the mcidas Account to see how to set MySQL_ROOT.

   After completing the steps outlined in Preparing the mcidas Account, logoff and then log back on to force the settings to take effect.

2. Next, if you have not already done so, build the XCD executables:
   Type: cd ~mcidas/mcidas2009/src
   Type: make xcd

   When make is finished, you will be ready to install Unidata McIDAS-XCD.

3. If this is the first installation of McIDAS-XCD on this workstation, proceed to step 6.

4. If McIDAS-XCD routines are running, you must force them to exit until the installation of the new distribution is complete.

   First, become the user running the LDM (assumed here to be the user ldm):

   Type: su - ldm

   Next, go to the etc directory:

   Type: cd ~ldm/etc

   and use your favorite text editor to modify the appropriate pqact.conf file:

   Change:

   # Entries for XCD decoders
   DDPLUS|IDS	^.* PIPE
          xcd_run DDS
   HRS	^.* PIPE
          xcd_run HRS
          

   To:

   # Entries for XCD decoders
   #DDPLUS|IDS	^.* PIPE
   #	xcd_run DDS
   #HRS	^.* PIPE
   #	xcd_run HRS
          

   and then send a HUP signal to pqact:

   Type: ldmadmin pqactHUP

   Next, kill the process startxcd.k:

   Type: kill -9 pid_of_startxcd.k

   Note that there should be two invocations of startxcd.k running; one should be the child of the other.

   Finally, exit back to the mcidas login:

   Type: exit

5. If you built your previous McIDAS installation to include MySQL support, and if you created a MySQL database, remake the database by removing the old one then making the new one by running the two commands below. Be aware that the gribadmin removedb command completely removes the database, so all entries added before this command will no longer be accessible. If a password is requested, enter the password for the MySQL root user, which was set by the person that installed MySQL:
   Type: gribadmin removedb
   Type: gribadmin makedb

6. Making sure that you are still in the McIDAS-X package source directory (~mcidas/mcidas2009/src), install Unidata McIDAS-XCD:
   Type: cd ~mcidas/mcidas2009/src
   Type: make install.xcd

   This will install the Unidata McIDAS-XCD executable, help, and ancillary data files in the ~mcidas/bin, ~mcidas/help, ~mcidas/data, and ~mcidas/workdata directories.

   If you think that you will be doing XCD development (this is not likely), then you should instead run:

   Type: make install.xcdall

   In addition to the executable, help, and ancillary data files, this will install the XCD include files and library.

7. At this point, the building and installation of McIDAS-XCD is complete. You should refer to the McIDAS-X/-XCD v2009 Unidata McIDAS v2009 Release Notes and complete any required actions listed there.

   After completing any required actions, you can logoff.

   Type: exit