McIDAS User's Guide
Version 2011.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]


Building and Installing McIDAS-X 2011.1

Note: For convenience, the McIDAS-X installation files now include both the McIDAS-X core package and the McIDAS-XRD sidecar package (see the McIDAS-XRD Software page for details). Installation of McIDAS-XRD is still optional (done by specifying a non-default value for the packages parameter in the steps below).

Complete the steps below to build and install McIDAS-X 2011.1 and/or McIDAS-XRD 2011.1. Run each command from the ~mcidas directory.

1. Log on to the workstation as mcidas.


2. Build the desired package (McIDAS-X 2011.1 and/or McIDAS-XRD 2011.1) using the appropriate command below. If building McIDAS-X (by specifying x or all in the packages parameter), this step first makes the ~mcidas installation directories and ~mcidas/mcidas2011.1 package directories (see the tables below). Then, it uncompresses the data files, source files, and man pages. Finally, it makes the help files, compiles the source code, and writes the compiler output to the file ~mcidas/mcidas2011.1/src/makelog.

Type:  sh  ./mcidas2011.1.sh  make   packages

or

Type:  sh  ./mcidas2011.1.sh   flags  make   packages

where packages is one of the three options described below.

and flags is one or more of the three optional flags described below.

Examples:

The message below is displayed if McIDAS-X is selected (by specifying x or all in the packages parameter) and the build is successfully completed.

./mcidas2011.1.sh: McIDAS-X make completed normally.

If McIDAS-XRD is selected (by specifying xrd or all in the packages parameter) and the build is successfully completed, the message is the same as that above, except McIDAS-X is replaced with McIDAS-XRD.


3. Once McIDAS-X and/or McIDAS-XRD 2011.1 are successfully built, uninstall the previous version of the corresponding package(s).

First verify that no McIDAS-X sessions are running. Then, if the previous version is 2009.1 or later, enter the command below to uninstall the previous version of the packages, replacing version# with the number of the version (for example, 2010.2). If the previous version is 2008a or earlier, complete the uninstall procedure (step 3) in the 2009.1 version of this manual. Then return to these instructions and proceed to step 4 below.

Type:  sh  ./mcidasversion#.sh  uninstall  all

The messages below are displayed if the uninstall is successfully completed.

./mcidasversion#.sh: McIDAS-X uninstall completed normally.
./mcidasversion#.sh: McIDAS-XRD uninstall completed normally.


4. Run the command below to install the packages (McIDAS-X and/or McIDAS-XRD 2011.1) that you built in step 2 above. You must specify the same option in packages (x, xrd or all) as you did in step 2 above. This step creates hard links from the files in the package directories to the appropriate ~mcidas installation directories.

Type:  sh  ./mcidas2011.1.sh  install   packages

The message below is displayed if McIDAS-X is selected (by specifying x or all in the packages parameter) and the install is successfully completed.

./mcidas2011.1.sh: McIDAS-X install completed normally.

If McIDAS-XRD is selected (by specifying xrd or all in the packages parameter) and the install is successfully completed, the message is the same as that above, except McIDAS-X is replaced with McIDAS-XRD.


Installation Directories

The install process makes hard links (as opposed to symbolic links) between the installation directories and the files in the package directories. The uninstall process simply removes the hard links. The McIDAS-X installation directories and their contents are listed below.

Directory Contents
~mcidas/bin program executables
~mcidas/data data files
~mcidas/help help files
~mcidas/inc include files
~mcidas/lib libraries
~mcidas/man man files for subroutines and functions
~mcidas/tcl Tcl and Tk executables and libraries

Other McIDAS packages also make hard links in the installation directories. Thus the installation directories are the repositories for all McIDAS packages currently installed.


Package Directories

Each version of McIDAS-X and other McIDAS packages (for example, McIDAS-XCD) builds its own set of directories. The names of the directories depend on the package name and version number. The McIDAS-X package directories and their contents are listed below.

Directory Contents
~mcidas/mcidas201x/data McIDAS-X data files
~mcidas/mcidas201x/bzip2 BZIP2 1.0.5 files for the radar servers
~mcidas/mcidas201x/g2clib g2clib 1.2.1 libraries for GRIB2
~mcidas/mcidas201x/gzip gzip 1.2.4 files for gzip compression
~mcidas/mcidas201x/hdf HDF 4.2.5 files for the MODIS servers
~mcidas/mcidas201x/jasper jasper 1.701.0 libraries for GRIB2
~mcidas/mcidas201x/jpeg JPEG v6b files for the FRMSAVE command
~mcidas/mcidas201x/libgeotiff GeoTIFF 1.2.1 files for the GeoTIFF server
~mcidas/mcidas201x/man McIDAS-X man files for subroutines and functions
~mcidas/mcidas201x/netcdf netCDF 4.1 files for ADDE servers
~mcidas/mcidas201x/src McIDAS-X source files, help files, and binaries
~mcidas/mcidas201x/tcl Tcl 8.5.9 files for the GUI
~mcidas/mcidas201x/tiff TIFF 3.6.1 files for the GeoTIFF server
~mcidas/mcidas201x/tk Tk 8.5.9 files for the GUI
~mcidas/mcidas201x/zlib zlib 1.1.4 files for the NEXRAD servers

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]