About McIDAS         McIDAS-V         OpenADDE        
   Advanced
   

McIDAS-XCD Fastrack Version 2008a
Software and Instructions

McIDAS-XCD version 2008a is available here as a Fastrack release with several modifications made since the 2008 upgrade. These changes include:

  • updates to the Terminal Aerodrome Forecast (TAF) decoder to accommodate the format change for the switch from 24-hour to 30-hour TAFs that is scheduled for 05 November 2008
  • corrections to the Ship/Buoy decoder to fix a problem introduced in the 2008 upgrade that resulted in anomalous data in Ship/Buoy MD files
  • fixes to ensure GRIB2 database entries are not missing level units where applicable
  • updates for the new Multi-Grid Wave Model (MGWM) and Global Forecast System (GFS) Alaska region data now available in GRIB2 format on the NOAAPORT datastream
  • fixes to correct improper handling of 5-digit string representation on 32-bit machines (e.g., 10000 m above sea level)
  • use of the station database file (STNDB.CORE) that was updated in McIDAS-X 2008a to include the negative sign in the latitude of Southern Hemisphere stations that are within one degree of the equator, and to include the negative sign in the longitude of Eastern Hemisphere stations that are within one degree of the Greenwich Meridian; plus the addition of four new C-MAN stations

Please keep in mind that McIDAS-XCD 2008a has not been thoroughly tested. If you elect to install 2008a, we ask that you notify the McIDAS Help Desk if you encounter any bugs. Please be sure to mention that you are running version 2008a.

Also note that if you plan to upgrade to 2008a from a version earlier than 2008 (e.g., 2007), you must first read and perform the required actions in the document titled McIDAS-XCD Version 2008 Upgrade Procedure, June 2008 that was included in your site's 2008 upgrade package.


***** Important!!! *****

You must install McIDAS-X 2008a before you install McIDAS-XCD 2008a because it has changes to the station database and GRIB servers and files that are needed in McIDAS-XCD 2008a.

 

To obtain and install McIDAS-XCD 2008a, complete the following steps.

  1. Download the following files to the ~oper/mcidas directory on your McIDAS-XCD workstation.
    File name Size Description
    xcd2008a.sh 12 KB shell script that installs the McIDAS-XCD software
    xcd2008a.tar.Z 961 KB compressed tar file that contains all source and data files
    xcd_README_2008a 3 KB information to review before installation

  2. If you are installing McIDAS-XCD for the first time on the workstation, go to the McIDAS-XCD Administrator's Guide's Installing McIDAS-XCD 2008 for the First Time and complete its instructions, but substitute "2008a" wherever "2008" appears. After installing -XCD for the first time, if you want to make additional GRIB2 dataset changes (i.e., change or add datasets), see the Creating a GRIB2 Dataset page.

    If you are installing McIDAS-XCD Fastrack version 2008a on a workstation that already has version 2008 installed, complete the steps below.

  3. If -XCD is running in the foreground, turn it off by exiting the McIDAS session and wait until all ingestors and data monitors have exited. From the McIDAS Text and Command window,

    Type: EXIT

    If -XCD is running in the background, stop the session by running the following command from an oper xterm.

    Type: xcdadmin stop

  4. From an oper xterm, build and install McIDAS-XCD 2008a using the same compilers (vendor or gcc/g77) and optional flag (-noopt and -mysql) settings that were used to build McIDAS-X 2008a. You must use the same compilers and optional flag settings for both the McIDAS-X and McIDAS-XCD builds.
  5. If you are using vendor compilers,

    Type: sh ./xcd2008a.sh -v flags  build

    If you are using gcc/g77 compilers,

    Type: sh ./xcd2008a.sh -gcc flags  build

    where flags is zero, one or both of the two optional flags described below.

    • The -noopt flag is used to build McIDAS-XCD with no optimization. If you don't specify this -noopt flag, McIDAS-XCD is built using the default optimization: -O2 for builds with vendor compilers and -O1 for builds with gcc/g77.
    • The -mysql flag is used to build McIDAS-XCD using the MySQL database libraries. Use this flag if this workstation will be serving real-time GRIB files from the NOAAPORT data stream and you have installed and want to use a MySQL database to make the GRIB data access faster for your McIDAS-X clients/users. If the database is in a non-standard install location, specify the flag as -mysql=directory, where directory is the root MySQL install directory. Remember, the -mysql flag must be specified when building both McIDAS-X and McIDAS-XCD.

    When the script xcd2008a.sh is finished, you will see the message below.

    McIDAS-XCD binaries built correctly

  6. Run the script below to install the new executable code and a subset of the replaceable McIDAS-XCD data files for your workstation.
  7. Type: sh ./xcd2008a.sh cutover

    When the script is finished, you will see the message below.

    McIDAS-XCD package cutover is now complete

  8. As user oper start a McIDAS-X session and run the command below to recreate the GROUPS.DAT and COUNTRY.DAT files so they contain the station database changes included in McIDAS-X Fastrack 2008a.
  9. Type: BATCH REGROUP.BAT

    When completed, exit the McIDAS-X session.

  10. Switch to user mcadde (with command su mcadde), then start a McIDAS-X session and run the command below to recreate the GROUPS.DAT and COUNTRY.DAT files in the mcadde account so they contain the station database changes included in McIDAS-X Fastrack 2008a.
  11. Type: BATCH REGROUP.BAT

  12. While still logged is as user mcadde make a backup copy of your RESOLV.SRV file (e.g., cp RESOLV.SRV RESOLV.SRV.BAK) then run the command below to add the new MGWM and GFS GRIB2 datasets to the RESOLV.SRV file.
  13. Type: BATCH XCDGRB2.BAT

    When completed, exit the McIDAS-X session.

  14. Switch to user mcidas (with command su mcidas) and run the script below from the ~oper/mcidas directory to install the new ADDE server executable code in the mcidas account.
  15. Type: sh ./xcd2008a.sh install addeservers

  16. Run the exit command twice to exit from user mcidas and then from user mcadde.
  17. Type: exit
    Type: exit

    You should now be logged in as user oper.

  18. Restart McIDAS-XCD. To do so from the foreground, start a McIDAS-X session from the oper account and run the command below from the McIDAS Text and Command window,

    Type: STARTXCD

    To restart -XCD in the background, run the following command from an oper xterm.

    Type: xcdadmin start

This concludes the McIDAS-XCD Fastrack version 2008a installation procedure. If you would like to modify the configuration of your McIDAS-XCD workstation, go to the McIDAS-XCD Administrator's Guide's Configuring McIDAS-XCD.

McIDAS Home