Note: This section contains the instructions for building and installing McIDAS-X on Win10 in the multi-user configuration. For the single-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 three sections below to obtain, build and install McIDAS-X on Win10 in the multi-user configuration. Additional information about the directory structure and optionally removing the previous version of McIDAS-X is included at the end.
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)::
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).
Complete the steps below to build and install McIDAS-X on Win10 2022 and/or McIDAS-XRD on Win10 2022.
1. Log in to the mcidas account in Windows 10, open an Ubuntu shell and run command whoami to verify that you are logged in to the mcidas account in Ubuntu (created in the previous page).
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. Run the sudo command below (all one line) to use
rsync to mirror the contents of /home/mcidas to the
shared location so they are accessible by other users of this workstation. Type: sudo rsync -avP --delete --delete-excluded --exclude="mcidas????*"
/home/mcidas /mnt/c/Users/mcidas/Ubuntu/home This concludes the instructions for building and installing McIDAS-X
on Win10 in the multi-user configuration. The sections below contain additional
information about the directory structure and optionally removing the previous version. 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. Other McIDAS packages also make hard links in the installation
directories. Thus the installation directories are the repositories for all
McIDAS packages currently installed. 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. 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. Log in to the mcidas account in Windows 10,
open an Ubuntu shell and run command whoami to verify that you
are logged in to the mcidas account in Ubuntu (created in the
previous page) 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:
Mirroring the Contents of /home/mcidas
Installation Directories
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
Package Directories
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