Building and Installing McIDAS-X 2022

Next, complete the steps below to build and install McIDAS-X 2022.

Getting Started

1. Log on to the workstation as mcidas

2. Verify that McINST_ROOT is defined as the directory in which you want to install Unidata McIDAS-X.

   NOTEs:

   • The directory defined by McINST_ROOT is encoded into executables in the Tcl/Tk portion of the McIDAS-X distribution by the build process. McINST_ROOT must not be redefined after building Unidata McIDAS-X. If it is, several routines will not work.

     If you need to change the definition of McINST_ROOT, change it in your shell-specific configuration file and then log off and log back on BEFORE attempting a rebuild.

   • NOTE: McINST_ROOT must NOT be defined as the directory under which the distribution is to be unpacked (~mcidas/mcidas2022)! If it is, the contents of the package data directory will be deleted when you try to install Unidata McIDAS-X and the installation will fail.

Building Unidata McIDAS-X

1. After performing the previous steps, unpack the Unidata McIDAS-X distribution.
   Type: cd $HOME
   Type: ./mcunpack 2022

   This step first makes the $HOME installation directories and then unpacks the distribution into the $HOME/mcidas2022 package directories. More information on the Installation Directories and Package Directories is available below.

2. Make needed environment variables active.

   There are two ways to make the environment variable definitions needed for the McIDAS build and installation active:

   • logoff and log back on

   • read the definitions you set in your shell-specific definition file

     non-Conforming shells (e.g., .cshrc)	Conforming shells (e.g., .profile, .bash_profile, or .kshrc)
     source .cshrc	For the BASH shell: . .bash_profile For the Bourne or Korn shells: . .profile

3. Build Unidata McIDAS-X.
   Type: cd $HOME/mcidas2022/src

   Type: make mcx   <----- build the McIDAS-X portion of the distribution
   -- or --
   Type: make mcx xcd   <----- build the McIDAS-X and -XCD portions of the distribution
   -- or --
   Type: make all   <----- build the McIDAS-X and -XCD portions of the distribution
   -- or --
   Type: make mcx xcd xrd   <----- build the McIDAS-X,-XCD, and -XRD portions of the distribution
   -- or --
   Type: make all xrd   <----- build the McIDAS-X,-XCD, and -XRD portions of the distribution

   You will be informed of a successful completion or of any problems encountered during the build.

   Compiler and linker output is saved in the file ~mcidas/mcidas2022/src/makelog. You can review this file with a text editor to see how routines were compiled and what, if anything, was in error.

Testing the Build

The user mcidas can now test the Unidata McIDAS-X 2022 before installing it.

NOTE:

• Testing the build is NOT necessary/advised if this is a new McIDAS installation, or if you are committed to upgrading an existing McIDAS installation to the new version.

• Testing is not a bad idea if you are upgrading from a previous McIDAS installation, but it is not required.

• If this is a new McIDAS installation, please complete the instructions in Installing the Distribution now.

  After installing the new build, you can check the functionality of the build by executing the actions listed in steps 5. through 8. below (i.e., skip steps 1. through 4. and 9.).

The example actions in the following all use C-Shell syntax.

1. Verify that no McIDAS-X sessions are running as the user mcidas.

2. If you are upgrading from a previous distribution of McIDAS, and if the mcidas account had been configured to automatically run the Unidata MCGUI, you will need to edit ~mcidas/.mcidasrc and comment out the automatic start of the MCGUI:
   <edit ~mcidas/.mcidasrc>

   Change:

   -c MCGUI

   To:

   # -c MCGUI

3. Define the MCDATA, MCPATH, and MCGUI environment variables (examples use CShell syntax):
   Type: setenv MCDATA /home/mcidas/mcidas2022/data
   Type: setenv MCPATH /home/mcidas/mcidas2022/data:/home/mcidas/mcidas2022/src
   Type: setenv MCGUI /home/mcidas/mcidas2022/src
   Type: unsetenv MCTABLE_READ
   Type: unsetenv MCTABLE_WRITE

4. Add the /home/mcidas/mcidas2022/src directory your PATH:
   Type: setenv PATH /home/mcidas/mcidas2022/src:$PATH

5. Define the DISPLAY environment variable for your system:
   Type: setenv DISPLAY your_machine_name:0

   You must replace your_machine_name with the name of your X Window display server.

6. Start McIDAS-X by typing the following at the Linux command prompt:
   Type: mcidasx

   If this is the first time you have run McIDAS-X, then the file .mcidasrc will be created in the /home/mcidas directory. If you have run McIDAS-X before, the settings in .mcidasrc will be read and used to define your session environment.

   If you get an error during startup something like:

   mcenv: Cannot make positive UC: could not create 5011060-byte shared memory segment

   it means that your system does not have enough shared memory allocated. Your system administrator should review the Allocating Sufficient Shared Memory portion of the workstation preparation page for information on how to configure system shared memory.

7. Run several McIDAS commands from the McIDAS-X Text and Command window to verify that your system is functioning:

   Draw a Mercator projection map of North America in the current frame:

   Type: MAP NA

   Erase graphics from the current frame:

   Type: ERASE

   Create 9 (3x3) panels in the current frame:

   Type: PANEL 3 3

   Draw a Mercator projection map of the US in panel #5:

   Type: MAP USA PRO=MERC PAN=5

   Create an ADDE dataset whose only member is the North American topography image contained in AREA file 9011.

   Type: DSSERVE ADD TOPO/CONF AREA 9011 9011 "North America (Conformal)

   Load the North American topographic image in CONFormal projection into panel #9 and draw a high resolution map on top of the image:

   Type: IMGDISP TOPO/CONF 1 LINELE=0 0 MAG=-6 EU=TOPO PAN=9
   Type: MAP H PAN=9

   Erase just the image portion of panel 9:

   Type: ERASE I PAN=9

   Delete the TOPO/CONF dataset that you created above.

   Type: DSSERVE DEL TOPO/CONF

   Repanelize the frame into one display:

   Type: PANEL 1
8. After verifying that the new distribution works, it is time to install it. First EXIT McIDAS:
   Type: EXIT

9. Since you modified the definitions of several environment variables during the testing, it is advisable to log off and then log back on to restore their original definitions.

   Also, if you modified ~mcidas/.mcidasrc to stop the automatic startup of the MCGUI, you should undo those changes now:

   <edit ~mcidas/.mcidasrc>

   Change:

   # -c MCGUI

   Back To:

   -c MCGUI

   If you have problems with any of the above tests, please send email to: Unidata McIDAS Support <support-mcidas@unidata.ucar.edu> detailing what problems were encountered.

Installing the Distribution

1. Verify that no McIDAS-X sessions are running, and then enter the commands below to uninstall the previous version of McIDAS-X, substituting your current version for the version in the example (2019).
   Type: cd $HOME/mcidas2019/src
   Type: make uninstall.all

2. Next, install McIDAS-X.
   Type: cd $HOME/mcidas2022/src
   Type: make install.mcx
   -- or --
   Type: make install.mcxall
   
3. Optionally, install McIDAS-XCD after installing McIDAS-X.
   Type: make install.xcd
   -- or --
   Type: make install.all