McIDAS-X User's Guide
Version 2023.1

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


Building and Installing McIDAS-X 2023.1

Note: For convenience, the McIDAS-X installation files 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 optional (done by specifying a non-default value for the packages parameter in the steps below).

Before proceeding, verify that you have installed CMake (a requirement for versions 2020.1 and beyond). Then complete the steps below to build and install McIDAS-X 2023.1 and/or McIDAS-XRD 2023.1. Run each command from the ~mcidas directory.

1. Log on to the workstation as mcidas.

2. Build the desired package (McIDAS-X 2023.1 and/or McIDAS-XRD 2023.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/mcidas2023.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/mcidas2023.1/src/makelog.

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

or

Type:  sh  ./mcidas2023.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.

./mcidas2023.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 2023.1 are successfully built, uninstall the previous version of the corresponding package(s).

First verify that no McIDAS-X sessions are running. Then enter the command below to uninstall the previous version of the packages, replacing version# with the number of the version (for example, 2022.1).

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 2023.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  ./mcidas2023.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.

./mcidas2023.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.

Note: SSEC recommends that you recompile all local code after each new version of McIDAS-X is installed.


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/mcidas202x/bzip2 BZIP2 1.0.5 files for the radar servers
~mcidas/mcidas202x/data McIDAS-X data files
~mcidas/mcidas202x/g2clib g2clib 1.2.2 libraries for GRIB2
~mcidas/mcidas202x/gzip gzip 1.2.4 files for gzip compression
~mcidas/mcidas202x/hdf HDF 4.2.5 files for the MODIS servers
~mcidas/mcidas202x/hdf5 HDF5 1.8.13 files for ADDE servers
~mcidas/mcidas202x/jasper JasPer 2.0.12 libraries for GRIB2
~mcidas/mcidas202x/jpeg JPEG v6b files for the FRMSAVE command
~mcidas/mcidas202x/libgeotiff GeoTIFF 1.7.0 files for the GeoTIFF server
~mcidas/mcidas202x/libpng libpng 1.6.37 files for GINI support
~mcidas/mcidas202x/man McIDAS-X man files for subroutines and functions
~mcidas/mcidas202x/netcdf netCDF 4.4 files for ADDE servers
~mcidas/mcidas202x/sqlite SQLite 3.30.1 files for ADDE servers
~mcidas/mcidas202x/src McIDAS-X source files, help files, and binaries
~mcidas/mcidas202x/tcln.n Tcl files for the GUI (n.n is either 8.4 or 8.5, as chosen during build in step 2 above)
~mcidas/mcidas202x/tiff TIFF files for the GeoTIFF server (3.6.1 on Linux, 4.3.0 on macOS)
~mcidas/mcidas202x/tkn.n Tk files for the GUI (n.n is either 8.4 or 8.5, as chosen during build in step 2 above)
~mcidas/mcidas202x/xcd McIDAS-XCD source files, data files, and binaries
~mcidas/mcidas202x/xrd McIDAS-XRD source files, data files, and binaries
~mcidas/mcidas202x/zlib zlib 1.2.8 files for the NEXRAD servers

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