About McIDAS         McIDAS-V        
   

McIDAS-XCD Fastrack Version 2016.2
Software and Instructions

This page contains the software and instructions for installing McIDAS-XCD version 2016.2, a fully supported Fastrack release. Modifications made since the previous release (version 2015.2) include:

  • Updated the station database (file STNDB.CORE) in McIDAS-X 2016.2 to include more than 200 new GFSMOS stations, matching what's seen at the NOAA Meteorological Development Lab's GFS MOS and GFS stations pages.
  • Updated the GFSMOS and NAMMOS decoders to write as many as 2,500 columns to the GFSMOS-schema and NAMMOS-schema MD files.
  • Added several fixes and enhancements to the RAOB decoder. The updates include increasing the number of lines read by the RAOB decoder so that all of the mandatory and significant upper level data are decoded; adding a fix where PPDD data are showing up in RTPTSRC/UPPERSIG MD files as TYPE SIGW; and removing RTPTSRC/UPPERSIG readings that contain no data.
  • Added several fixes and enhancements to the SHIP decoder. The updates include properly identifying readings as BUOYs in FM-13 SHIP format and increasing the number of lines read by the SHIP decoder to accommodate longer BUOY messages.
  • Added several fixes and enhancements to the SYNOPTIC decoder. The updates include changing rapid access filing for synoptic data to hourly instead of every 3 hours and to not file decoded synoptic readings that have an MD id number field (IDN) of 0.
  • Added file RMXCDGRIB2016_2.BAT to remove obsolete RTGRIDS datasets. The file XCDNOAAPORTGRID.BAT was updated with several new RTGRIDS datasets. See steps 8, 9 and 10 below for the instructions to complete this procedure, and see the xcd_README_2016.2 file for the complete list of datasets added and removed from the RTGRIDS datasets.

McIDAS-XCD 2016.2 is a fully supported Fastrack release. This means that the software is fully supported by SSEC, and that each change to the software has been tested on all of the supported system configurations. If you elect to install 2016.2, we ask that you notify the McIDAS Help Desk if you encounter any bugs. Please be sure to mention that you are running version 2016.2.

Also note that if you plan to upgrade to 2016.2 from a version earlier than the previous release (2015.2), you must first read and perform any required actions in the release documents for each of the versions you skipped so you know about their major changes and any required actions in the interim. For example, if you are upgrading from version 2012.1 to 2016.2, you must first read and perform the required actions in the release documents for versions 2014.1 and 2015.2 before proceeding to 2016.2. See the past versions page for links to those and other materials from past versions.


Obtaining McIDAS-XCD 2016.2

To obtain McIDAS-XCD 2016.2, download the following files to the ~oper/mcidas directory on your McIDAS-XCD workstation.

File name Size Description
xcd2016.2.sh 15 KB shell script that installs the McIDAS-XCD software (right click to download)
xcd2016.2.tar.Z 983 KB compressed tar file that contains all source and data files
xcd_README_2016.2 12 KB information to review before installation


Installing McIDAS-XCD 2016.2

Note: You must install McIDAS-X 2016.2 on the workstation before you install McIDAS-XCD 2016.2. Then continue with the appropriate set of instructions, as described below.

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 2016.2 for the First Time and complete its instructions. (Use those instructions rather than those below.)

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

  1. 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 as user oper.

    Type: xcdadmin stop

  2. As user oper, run the script below from the ~oper/mcidas directory to build and install McIDAS-XCD 2016.2 using the same settings for optional flags -noopt and -mysql as were used to build McIDAS-X 2016.2. You must use the same compilers and optional flag settings for both the McIDAS-X and McIDAS-XCD builds.

    3. Type: sh ./xcd2016.2.sh  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 xcd2016.2.sh is finished, you will see the message below.

    McIDAS-XCD binaries built correctly

  3. As user oper, run the script below from the ~oper/mcidas directory to install the new executable code and a subset of the replaceable McIDAS-XCD data files for your workstation.

    4. Type: sh ./xcd2016.2.sh cutover

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

    McIDAS-XCD package cutover is now complete

  4. As user oper, run the script below from the ~oper/mcidas directory to make a backup copy of the ~oper/mcidas/data/GFSMOS.CFG and ~oper/mcidas/data/NAMMOS.CFG files then replace them with the new version of these files. The new version's NCOLS variable was increased from 2000 to 2500 in both files, so the GFSMOS and NAMMOS decoders can now write as many as 2,500 columns in the GFSMOS-schema and NAMMOS-schema MD files. Note that this change will take effect when the next day's RTPTSRC/GFSMOS and RTPTSRC/NAMMOS MD files are created.

    5. Type: sh ./xcd2016.2.sh install mosupdate

    The backup copies of the files are named GFSMOS.CFG_yyyymmdd and NAMMOS.CFG_yyyymmdd where yyyymmdd is the current date, e.g., 20161010).

  5. As user oper, start a McIDAS-X session and run the two commands below. The first command (BATCH REGROUP.BAT) recreates the GROUPS.DAT and COUNTRY.DAT files so they contain the station database changes included in McIDAS-X Fastrack 2016.2. The second command (BATCH REBILDRAP.BAT) rebuilds the Rapid Access Pointer files so they include the same station database changes and rebuilds the Rapid Access Text files. Note that running the second command erases the previous content of the *.RAP and *.RAT files, so they will contain only new data. That means that the user commands MOSRPT, OBSRPT, RAOBRPT, SFCRPT, SYNRPT and TAFRPT will not be able to access any data from prior to McIDAS-XCD being restarted (last step below).

    6. Type: BATCH REGROUP.BAT
    Type: BATCH REBILDRAP.BAT

  6. In the McIDAS-X session started as user oper in step 5 above, run the command below to remove the GFSMOS.IDT and NAMMOS.IDT files so that when they are recreated after McIDAS-XCD is restarted (last step below), they contain the MOS decoder additions.

    7. Type: BATCH UPDATEMOS.BAT

    When steps 5 and 6 are completed, exit the McIDAS-X session.

  7. As user mcadde, 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 2016.2.

    8. Type: BATCH REGROUP.BAT

  8. As user mcadde, make a backup copy of your RESOLV.SRV file (e.g., cp RESOLV.SRV RESOLV.SRV.BAK) in preparation of adding the restructured RTGRIDS/* datasets in steps 9 and 10 below.

  9. In the McIDAS-X session started as user mcadde in step 7 above, run the command below to remove the obsolete and/or redefined RTGRIDS/* datasets.

    10. Type: BATCH RMXCDGRIB2016_2.BAT CONTINUE=YES

  10. In the McIDAS-X session started as user mcadde in step 7 above, run the command below to update the RTGRIDS/* datasets so they contain the data currently available over the NOAAPORT WMO and NGRID feeds.

    11. Type: BATCH XCDNOAAPORTGRID.BAT

    Notes:

    • The XCDADDE.BAT file, which is optionally run to create the default ADDE datasets, includes XCDNOAAPORTGRID.BAT among the batch files it runs. See Configuring the Default ADDE Datasets in the McIDAS-XCD Administrator's Guide for more information. As also noted there, you can optionally run the command BATCH XCDCONDUITGRID.BAT to create ADDE datasets for the subset of CONDUIT LDM GRIB2 grids that the SSEC Data Center provides for its users.
    • The XCDNOAAPORTGRID.BAT and XCDCONDUITGRID.BAT files were first implemented in McIDAS-XCD 2014.1; see the 2014.1 software and instructions page for more information.

  11. As user mcidas, run the script below from the ~oper/mcidas directory to install the new ADDE server executable code in the mcidas account.

    12. Type: sh ./xcd2016.2.sh install addeservers

  12. 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 as user oper.

    Type: xcdadmin start

This concludes the McIDAS-XCD Fastrack version 2016.2 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
SSEC Data Center
SSEC
UW-Madison