McIDAS Man computer Interactive Data Access System

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.)

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

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.