Unidata - To provide the data services, tools, and cyberinfrastructure leadership that advance Earth system science, enhance educational opportunities, and broaden participation. Unidata
         
  advanced  
 
Table of contents Previous: XCD System Requirements Next: Configuring McIDAS-XCD

Installing McIDAS-XCD 2008

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:

    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/mcidas2008/src), install Unidata McIDAS-XCD:

      Type: cd ~mcidas/mcidas2008/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 v2008 Unidata McIDAS v2008 Release Notes and complete any required actions listed there.

    After completing any required actions, you can logoff.

      Type: exit


Table of contents Previous: XCD System Requirements Next: Configuring McIDAS-XCD
 
 
  Contact Us     Site Map     Search     Terms and Conditions     Privacy Policy     Participation Policy
 
National Science Foundation (NSF) UCAR Office of Programs University Corporation for Atmospheric Research (UCAR)   Unidata is a member of the UCAR Office of Programs, is managed by the University Corporation for Atmospheric Research, and is sponsored by the National Science Foundation.
P.O. Box 3000     Boulder, CO 80307-3000 USA     Tel: 303-497-8643     Fax: 303-497-8690