McIDAS-XCD Installation Instructions

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

McIDAS-XCD v. 2024.1

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

– or –

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

  1. At a Unix prompt as user oper, stop McIDAS-XCD and then LDM by running the commands below in order.

    Type: xcdadmin stop
    Type: ldmadmin stop

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

    Type: sh ./xcd2024.1.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: -O1 for builds with gcc/gfortran.
    • The -mysql flag is used to build McIDAS-XCD using the MySQL/MariaDB 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/MariaDB 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/MariaDB install directory. Remember, the -mysql flag must be specified when building both McIDAS-X and McIDAS-XCD.

      When the script xcd2024.1.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.

    Type: sh ./xcd2024.1.sh cutover

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

    McIDAS-XCD package cutover is now complete
  4. Confirm that the RAOB alias contains the UQ WMO header.  In a McIDAS-X session as user oper on the -XCD machine, run the command below to list the the WMO headers, indices and aliases for the NTXT circuit.

    Type: WMORTE LIST NTXT

    Find the line in the list for the alias RAOB.  If the RAOB line looks like the following and contains UQ, but not UX, skip to Step 6. Otherwise, proceed to Step 5.

    RAOB     UJ     UJ UE UF UK UL UM UP US UG UQ
  5. If the command in Step 4 returns a line with the UX header or does not have the UQ header listed, run the commands below to remove the UX header and to define the UQ header.  In the McIDAS-X session as user oper on the -XCD machine, run the following commands.

    Type: WMORTE DEL WMO INDEX=UJ HEADER=UX CIRCUIT=NTXT

    Type: WMORTE ADD WMO INDEX=UJ HEADER=UQ CIRCUIT=NTXT

    Type: WMORTE LIST NTXT

    Once again, find the line in the list for the alias RAOB.  If the RAOB line looks like the following and contains UQ, but not UX, then the IDXALIAS.DAT file has been successfully updated.

    RAOB     UJ     UJ UE UF UK UL UM UP US UG UQ
  6. As user mcidas, run the script below from the ~oper/mcidas directory to install the new ADDE server executable code in the mcidas account.

    Type: sh ./xcd2024.1.sh install addeservers

  7. Restart LDM and then McIDAS-XCD by running the commands below in order at a Unix prompt as user oper.

    Type: ldmadmin start
    Type: xcdadmin start

.This concludes the McIDAS-XCD Fastrack version 2024.1 installation procedure.

Depending on your site’s configuration and needs, additional actions may be required now or at a later time. Go to Configuring McIDAS-XCD in the McIDAS-XCD Administrator’s Guide for all configuration options.