Table of contents Previous: Preparing the mcidas Account (Single-User Configuration) Next: Preparing the Main User Account (Single-User Configuration)

Installing McIDAS-X on Win10 (Single-User Configuration)

Note: This section contains the instructions for building and installing McIDAS-X on Win10 in the single-user configuration. For the multi-user configuration instructions (or information about the two configuration options), return to the Configuration Options and Instructions and follow those instructions.

Complete the instructions in the two sections below to obtain, build and install McIDAS-X on Win10 in the single-user configuration. Additional information about the directory structure and optionally removing the previous version of McIDAS-X is included at the end.

Obtaining McIDAS-X 2022

The McIDAS-X on Win10 2022 installation files are listed below.

File Name Description
mcunpack shell script that creates the installation directory structure and unpacks the distribution into the package build directories
mcidasx2022.tar.gz compressed tar file containing the source and data files

Use your web browser to retrieve the files listed above.

NOTE(s)::

Building and Installing Unidata McIDAS-X 2022

For convenience, the McIDAS-X installation files include both the McIDAS-X core package and the McIDAS-XRD sidecar package from SSEC. Installation of the full McIDAS-XRD package is optional.

Complete the steps below to build and install McIDAS-X on Win10 2022 and/or McIDAS-XRD on Win10 2022.

1. Open an Ubuntu shell and run command whoami to verify that you are logged in as the main user account (created in the previous page). Then use sudo to login as mcidas.

Type:  sudo -u mcidas -i

2. Copy or move the installation files that were downloaded in the previous section to the ~mcidas directory.

3. Unpack the compressed distribution that was downloaded in the previous section to the ~mcidas directory.

Type:  chmod +x mcunpack

Type:  ./mcunpack 2022

mcunpack creates the directory specified in the McINST_ROOT environment variable, if needed; creates all of the installation subdirectories under the McINST_ROOT directory; and unpacks the source distribution file.

4. Build the desired package using the appropriate command(s) below.

Type:  cd mcidas2022/src

To build the McIDAS-X portion of the distribution, do the following:

Type:  make mcx

To build the McIDAS-X and -XRD portions of the distribution, do the following:

Type:  make mcx xrd

5. Once McIDAS-X and/or McIDAS-XRD 2022 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 to be uninstalled (for example, 2020).

Type:  cd ~mcidas/mcidasversion#/src

Type:  make uninstall.mcx uninstall.xrd


6. Run the command below to install the packages (McIDAS-X and/or McIDAS-XRD 2022) that you built in step 4 above.

Type:  cd ~mcidas/mcidas2022/src

Type:  make install.mcx

OR

Type:  make install.mcx install.xrd

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


This concludes the instructions for building and installing McIDAS-X on Win10 in the single-user configuration. The sections below contain additional information about the directory structure and optionally removing the previous version.

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 3.6.1 files for the GeoTIFF server
~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/xrd McIDAS-XRD source files, data files, and binaries
~mcidas/mcidas202x/zlib zlib 1.2.8 files for the NEXRAD servers

Removing the Previous Version of McIDAS-X

If you have installed and tested a new version of McIDAS-X and/or McIDAS-XRD and are satisfied they are working properly, you can remove the previous version of the packages. To do so, complete the numbered instructions below.

1. Open an Ubuntu shell and run command whoami to verify that you are logged in as the main user account (created in the previous page). Then use sudo to login as mcidas.

Type:  sudo -u mcidas -i

2. Remove the mcidasversion# directory tree and its contents, replacing version# with the previous version number.

Type:  cd ~mcidas

Type:  rm -rf mcidasversion#

3. Remove the following files:


Table of contents Previous: Preparing the mcidas Account (Single-User Configuration) Next: Preparing the Main User Account (Single-User Configuration)