Building and Installing McIDAS-X 2011.1

1. Log on to the workstation as mcidas.

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

or

where packages is one of the three options described below.

• x
  The x option builds only the McIDAS-X package. It is also the default (if you don't specify anything in the packages parameter.)
  
• xrd
  The xrd option builds only the McIDAS-XRD package.
  
• all
  The all option builds both the McIDAS-X and McIDAS-XRD packages, in that order.

and flags is one or more of the three optional flags described below.

• -gcc
  The -gcc flag is used to build McIDAS-X using the GCC (GNU Compiler Collection) compilers on an AIX, HP-UX, Mac OS X or Solaris SPARC system. If you don't specify this -gcc flag, McIDAS-X is built using the default compilers: vendor on AIX, HP-UX and Solaris SPARC systems; gcc/gfortran on Mac OS X systems and, if present, on Linux systems; gcc/g77 on Linux and Solaris x86 systems that do not have gfortran.
  
• -noopt
  The -noopt flag is used to build McIDAS-X with no optimization. If you don't specify this -noopt flag, McIDAS-X is built using the default optimization: -O2 for builds with vendor compilers and -O1 for builds with gcc/g77. The only exception is Solaris builds with vendor compilers, which are done with no optimization.
  
• -mysql
  The -mysql flag is used to build McIDAS-X using the MySQL database libraries. This optional flag is mainly for use by McIDAS-XCD sites that elect to use a MySQL database on their -XCD workstations that serve real-time GRIB files from the NOAAPORT data stream. (The database makes access to the GRIB data much faster for -X client workstations.) If using the database on an -XCD workstation, the -mysql flag must be specified when building both McIDAS-X and McIDAS-XCD. If the database is in a non-standard install location, specify the flag as -mysql=directory, where directory is the root MySQL install directory.

Examples:

• sh  ./mcidas2011.1.sh  make  x
  This command builds McIDAS-X 2011.1 using the default compilers.
  
• sh  ./mcidas2011.1.sh  -gcc  make  all
  This command builds McIDAS-X 2011.1 then McIDAS-XRD 2011.1 using the gcc/g77 compilers.
  

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.

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

First verify that no McIDAS-X sessions are running. Then, if the previous version is 2009.1 or later, enter the command below to uninstall the previous version of the packages, replacing version# with the number of the version (for example, 2010.2). If the previous version is 2008a or earlier, complete the uninstall procedure (step 3) in the 2009.1 version of this manual. Then return to these instructions and proceed to step 4 below.

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 2011.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.

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.

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