Unidata McIDAS-X - Upgrading from a Previous Version

Users upgrading from a previous version of McIDAS-X will at a minimum need to do the following.

Review McIDAS-X v2006 v2006 Release Notes.
Download the McIDAS-X v2006 distribution files:
to the HOME directory of the user mcidas

Define the Unix environment variable McINST_ROOT to be the fully qualified directory name under which McIDAS is to be installed. This is typically the HOME directory of the user mcidas. Define McINST_ROOT in the definition file for the Unix shell you are using (e.g., .cshrc for C and TC shells, .profile for the Bourne shell, .bash_profile for bash, or .kshrc for the Korn shell).

Define the Unix environment variable VENDOR to select which of the two supported set of compilers you want to use to build Unidata McIDAS-X/-XCD (-vendor for vendor-supplied compilers; -g77 for GNU gcc/g77). The VENDOR definition should also be put in your shell definition file.

Assuming that the McIDAS-X/-XCD is to be installed in the standard location, and the user wants to use the GNU gcc/g77 compiler combination, The entries for McINST_ROOT and VENDOR will look like:

non-Conforming shells (e.g., .cshrc) Conforming shells (e.g., .profile, .bash_profile, or .kshrc)

# McINST_ROOT and VENDOR non-conforming shell defines needed to bulid McIDAS setenv McINST_ROOT $HOME setenv VENDOR -g77 if ( -e $HOME/admin/mcidas_env.csh ) then source $HOME/admin/mcidas_env.csh endif

# McINST_ROOT and VENDOR conforming shell defines needed to bulid McIDAS McINST_ROOT=$HOME VENDOR=-g77 export McINST_ROOT VENDOR if [ -e $HOME/admin/mcidas_env.sh ]; then . $HOME/admin/mcidas_env.sh fi

After adding entries to your shell definition file, make those additions active in your session (e.g. source .cshrc, . .profile, . .bash_profile, etc.).

Unpack the distribution:

cd ~mcidas
chmod +x mcunpack
./mcunpack

Build the distribution (if you are upgrading, the assumption is that the needed Unix environment variable definitions for the user mcidas are active):
```
cd ~/mcidas2006/src
make mcx          <- to build McIDAS-X only
  -- OR --
make all          <- to build both McIDAS-X and McIDAS-XCD
```
Test the distribution before installing it (NOTE: not needed this is a new installation or if if you are committed to upgrading to the new distribution).
If you made any changes to the MCGUI image load definition file ADDEIMAGE.CORE, copied the file to your McIDAS working directory, created a site image load file ADDEIMAGE.SITE, or created a user image load defaults file ADDEIMAGE.USER, you MUST move them out of the directories defined in your MCPATH. The 2006 format and content of these files was significantly changed.
If this step applies to you, please review the contents of v2006's ADDEIMAGE.CORE to learn what you must do to convert your previous files to the correct content and format.

stop the LDM if you are installing -XCD:

<login as 'ldm'>
cd ~ldm
ldmadmin stop
<exit>

Uninstall the previous distribution (NOTE: example is for v2005):
```
cd ~/mcidas2005/src
make uninstall.all
```

Install v2006:

cd ~/mcidas2006/src          <- to install McIDAS-X only
make install
  -- OR --
make install.all             <- to install both McIDAS-X and McIDAS-XCD

Merge v2006 example file REDIRECTions from EXAMPLE.NAM with your existing local copy of the previous distribution's definitions:

cd ~mcidas/data

<merge new definitions in EXAMPLE.NAM with existing definitions in
LOCAL.NAM that you created when you installed the previous distribution
of McIDAS>

cd ~mcidas/workdata
redirect.k REST LOCAL.NAM

If you upgrading an -XCD installation, merge v2006 ADDE dataset definitions in DSSERVE.BAT with your existing local copy of the previous distribution's definitions. This will include the modifications needed for the ETAMOS and GFSMOS datasets in RTPTSRC and RTWXTEXT:
```
cd ~mcidas/data

<merge new definitions in DSSERVE.BAT with existing definitions in
LSSERVE.BAT that you created when you installed the previous distribution
of McIDAS>

cd ~mcidas/workdata
batch.k LSSERVE.BAT
```

If you are upgrading an -XCD installation, do the following:

cd ~mcidas/workdata
cp ~mcidas/data/SCHEMA directory_where_XCD_decoders_write_output
rm DECINFO.DAT
batch.k XCD.BAT

<If you were decoding GRIB data using DMGRID, reactivate that data
monitor>

decinfo.k SET DMGRID ACTIVE

If you stopped the LDM in a previous step, restart it now:
```
<login as 'ldm'>
ldmadmin start
<exit>
```

At this point, your McIDAS v2006 distribution should be ready to use. If you have problems, send email to <support-mcidas@unidata.ucar.edu> for assistance. Please make sure to describe the problem you are having in enough detail so we can help you troubleshoot.

Contact Us • Site Map • Search • Terms and Conditions • Privacy Policy • Participation Policy

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