McIDAS-X Incremental Fastrack
Version 2006b Software and Instructions

All changes in McIDAS-X 2006b have been tested by the SSEC MUG team; however, a complete system test has not been performed. Therefore, this version may not be as stable as a fully-supported upgrade and we recommend that you do NOT install it on a mission-critical workstation.

McIDAS-X 2006b is not supported by the MUG as it is still being evaluated. However, it is likely that some or all of its changes will be included in a future McIDAS-X upgrade. If you elect to install 2006b, we ask that you notify the McIDAS Help Desk if you encounter any bugs. Please be sure to mention that you are running version 2006b.

To install incremental Fastrack version 2006b, you must have a previously compiled version of McIDAS-X from the 2006 series (i.e., 2006, 2006a, 2006b, etc.) in the mcidas account. If you don't, you must install the full version of this Fastrack.

Before installing Fastrack version 2006b make sure you view the composite list of Fastrack Software Changes. You might want to print or download the file for future reference.

To obtain and install McIDAS-X 2006b, complete the following steps.

1. Download the following files to the ~mcidas directory on your McIDAS-X workstation.

   File name	Size	Description
   README	8 KB	disk space requirements
   mcidas2006b_inc.sh	33 KB	install/uninstall script
   mcidas2006b_inc.sp	1 KB	disk space information used by mcidas2006b_inc.sh
   mcidas2006b_inc.tar.Z	6098 KB	compressed tar file containing source & data files
   mcinet2006b.sh	15 KB	script that configures an ADDE remote server

2. Examine the README file to read about the disk space requirements.
3. Log on to the workstation as mcidas.
4. Build McIDAS-X 2006b using the appropriate command below. You must build each incremental version using the same compilers (vendor or gcc/g77) that were used to build the base version. For example, to build incremental version 2006b you must use the compilers that were used to build the 2006 or 2006a full version in the mcidas account.

   If you are using the default compilers (vendor on AIX, HP-UX, IRIX and Solaris SPARC systems; gcc/g77 on Solaris x86, Linux and Mac OS X systems),

   Type: sh ./mcidas2006b_inc.sh make

   If you are using the gcc/g77 compilers on an AIX, HP-UX, IRIX or Solaris SPARC system,

   Type: sh ./mcidas2006b_inc.sh -gcc make

   This step first searches for a previously compiled version of McIDAS-X from the 2006 series (i.e., 2006, 2006a, 2006b, etc.). If one is found, it uncompresses the data files, source files, and man pages from the mcidas2006b_inc.tar.Z file. Then the source, data, man, binary and object files from the previous version's package directories are either copied or hard linked in to the new ~mcidas/mcidas2006b package directories. Then new files in the ~mcidas/mcidas2006b_inc directories are copied into the ~mcidas/mcidas2006b package directories. Finally, it makes the help files, compiles the source code, and writes the compiler output to the file ~mcidas/mcidas2006b/src/makelog. The message below is displayed when the build is successfully completed.

   ./mcidas2006b_inc.sh: Make completed normally.

5. Verify that no McIDAS-X sessions are running. Then enter the command below to uninstall the previous version of McIDAS-X, replacing version# with the number of the version (for example, 2006).

   Type: sh ./mcidasversion# .sh uninstall

   This step removes the hard links between the files in the ~mcidas/mcidasversion# directories and the appropriate directories in ~mcidas. The message below appears when the uninstall is successfully completed.

   ./mcidasversion#.sh: Uninstall completed normally.

6. Install McIDAS-X 2006b.

   Type: sh ./mcidas2006b_inc.sh install

   This step creates hard links from the files in the ~mcidas/mcidas2006b package directories to the appropriate ~mcidas installation directories. The message below is displayed when the install is successfully completed.

   ./mcidas2006b_inc.sh: Install completed normally.

Continue with the steps below if you want to install the McIDAS-X 2006b ADDE remote server. For more information about remote servers, see Appendix I, McIDAS-X Site Administration and Management in the McIDAS User's Guide.

1. Log on to the workstation as root.
2. Change to the home directory for user mcidas.

   Type: cd ~mcidas

3. Check to see if an ADDE remote server is installed on the workstation.

   Type: sh ./mcinet2006b.sh list

   The output should include three lines similar to those below.

   mcinet: gzip transfer services installed and running: YES mcinet: uncompressed transfer services installed and running: YES mcinet: compressed transfer services installed and running: YES

   If all three lines in your output end with "NO", the workstation does not currently have an ADDE remote server installed. In that case, you can skip step 4 and go directly to step 5 (although there is no harm caused by completing step 4 even if an ADDE remote server is not currently installed).

   If any of the three lines in your output end with "YES", a previous version's ADDE remote server is installed and you must complete step 4 before going to step 5.

4. Uninstall the previous version's ADDE remote server. Replace version# in the command below with the previous version number of McIDAS-X (2006, for example). If you used an account other than mcadde for your ADDE remote server, insert that account name in place of mcadde.

   Type: sh ./mcinetversion#.sh uninstall mcadde

   This step removes the modifications made to the Internet services daemon (inetd) configuration files, forces inetd to reread its configuration files, and attempts to verify that inetd is no longer listening for ADDE requests from McIDAS-X clients.

5. Install the McIDAS-X 2006b ADDE remote server. If you use an account other than mcadde for your ADDE remote server, insert that account name in place of mcadde in the command below.

   Type: sh ./mcinet2006b.sh install mcadde

   This step modifies the Internet services daemon (inetd) configuration files to make inetd aware of the ADDE service, forces inetd to reread its configuration files, and attempts to verify that inetd is listening for ADDE requests from McIDAS-X clients.