•         advanced

Building and Installing McIDAS-X 2009

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

Getting Started

1. Log on to the workstation as mcidas

2. Verify that McINST_ROOT is defined as the directory under 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 build.

   • McINST_ROOT must NOT be defined as the directory under which the distribution is to be unpacked (~mcidas/mcidas2009)! 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. Unpack the Unidata McIDAS-X distribution.
   Type: cd $HOME
   Type: ./mcunpack

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

2. Make needed Unix 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/mcidas2009/src

   Type: make mcx
   -- or --
   Type: make all

   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/mcidas2009/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 2009 before installing it.

Please NOTE:

• Testing the build is NOT necessary 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 one is upgrading from a previous McIDAS installation.

• 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:
   Type: setenv MCDATA /home/mcidas/mcidas2009/data
   Type: setenv MCPATH /home/mcidas/mcidas2009/data:/home/mcidas/mcidas2009/src
   Type: setenv MCGUI /home/mcidas/mcidas2009/src
   Type: unsetenv MCTABLE_READ
   Type: unsetenv MCTABLE_WRITE

4. Add the /home/mcidas/mcidas2009/src directory your PATH:
   Type: setenv PATH /home/mcidas/mcidas2009/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 Unix 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 Shared Memory Configuration 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 (2007).
   Type: cd $HOME/mcidas2006/src
   Type: make uninstall.all

2. Next, install McIDAS-X.
   Type: cd $HOME/mcidas2009/src
   Type: make install.mcx
   -- or --
   Type: make install.all