McIDAS-XCD Installation Instructions

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

McIDAS-XCD v. 2023.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 2023.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 2023.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 2023.1 using the same settings for optional flags -noopt and -mysql as were used to build McIDAS-X 2023.1. You must use the same compilers and optional flag settings for both the McIDAS-X and McIDAS-XCD builds.

    Type: sh ./xcd2023.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 xcd2023.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 ./xcd2023.1.sh cutover

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

    McIDAS-XCD package cutover is now complete
  4. As user mcadde, make a backup copy of your RESOLV.SRV file (e.g., cp RESOLV.SRV RESOLV.SRV.BAK) in preparation for adding the restructured RTGRIDS/* datasets below.
  5. In the McIDAS-X session started as user mcadde in step 4 above, run the command below to remove obsolete and add new RTGRIDS/* datasets.

    Type: BATCH UPDATEGRIB2023_1.BAT CONTINUE=YES

  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 ./xcd2023.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 2023.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.