McIDAS-XCD Administrator's Guide
Version 2023.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]

Installing McIDAS-XCD 2023.1 for the First Time

If you are installing McIDAS-XCD on a workstation that already has a previous version of McIDAS-XCD installed, go to the previous section, Upgrading to McIDAS-XCD 2023.1.

Installing McIDAS-XCD for the first time on a workstation consists of the three tasks in this section (Adding the mcdata Group and Disabling Binary Logging, Assigning Directory Permissions, Loading the McIDAS-XCD Software), followed by additional configuration steps in the section Configuring McIDAS-XCD.

Before proceeding with the instructions below, verify that McIDAS-X 2023.1 has been installed on the workstation. If it hasn't you must do so before you install McIDAS-XCD 2023.1.

Adding the mcdata Group and Disabling Binary Logging

The workstation running the McIDAS-XCD software must have the group name mcdata which contains the users oper and mcidas. It also should disable the writing of binary log files associated with the database. This is needed because MySQL/MariaDB 8.0 and later enable binary logging by default, which fills large amounts of disk (possibly an entire file system) due to it logging millions of INSERT into file_list entries per day. Use this procedure to add the mcdata group, if needed, and disable binary logging.

  1. Log on to the root account.

  2. Add the following line to the /etc/group file. Replace groupid with a unique group ID number.

  3. mcdata::groupid:oper,mcidas

    For example: mcdata::23000:oper,mcidas

  4. Disable the writing of binary log files associated with the database.
  5. Type: /home/oper/mcidas/bin/gribadmin disablelog

    When the command is finished, you should see a message like that below.

    /etc/my.cnf.d/disable-log-bin.cnf successfully written!

  6. Log out of the root account.

Assigning Directory Permissions

Use the steps below to assign write privileges to the directory ~mcidas/data.

  1. Log on to the workstation as user mcidas and change the group for the ~mcidas/data directory to the group mcdata.
  2. Type: chgrp mcdata ~mcidas/data

  3. Change the permissions for the directory ~mcidas/data so only the user mcidas and members of the group mcdata have write permission.
  4. Type: chmod 775 ~mcidas/data

  5. Log out of the mcidas account.

Loading the McIDAS-XCD Software

Complete the steps below to load the McIDAS-XCD software.

  1. Logon to the workstation as user oper and change to the ~oper/mcidas directory.
  2. Type: cd ~oper/mcidas

  3. Verify that the PATH environment variable contains the ~mcidas/bin and ~oper/mcidas/bin directories, and the operating system-specific modifications listed for the mcidas account in the McIDAS User's Guide.
  4. Type: echo $PATH

  5. Verify that the ~oper/mcidas/data directory exists (use command mkdir ~oper/mcidas/data to make it if it doesn't) and that the MCPATH environment variable is set and includes the ~oper/mcidas/data, ~oper/mcidas/help, ~mcidas/data, and ~mcidas/help directories.

    Type: echo $MCPATH

  6. 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.
  7. Type: sh ./  flags  install all

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

    This script performs the following steps:

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

    McIDAS-XCD package installation is now complete

  8. Switch to user mcidas so you can install the McIDAS-XCD ADDE servers.
  9. Type: su mcidas

  10. Run the script below to install the new ADDE server executable code in the mcidas account.
  11. Type: sh ./ install addeservers

  12. Exit from user mcidas.
  13. Type: exit

    You should now be logged on as user oper.

  14. Start a McIDAS-X session.
  15. Type: mcidas

  16. Determine the full Unix path of the directory in which you want -XCD to write data. The location where you store data is up to you; be sure to take disk space needs into account when making your decision. The data directory needs to exist, and also needs to contain grib and bufr subdirectories. Once you've determined the path of your data directory, create a McIDAS string named MCDATA that contains the full Unix path to the directory. From the McIDAS-X session,
  17. Type: TE MCDATA "/data_directory_path

    For example: TE MCDATA "/home/oper/xcd_data     
    In order for -XCD to correctly file data in this example, the /home/oper/xcd_data, /home/oper/xcd_data/grib, and /home/oper/xcd_data/bufr directories need to exist. Create the #MCDATA, #MCDATA/grib, and #MCDATA/bufr directories, if necessary.

  18. Run the batch file XCD.BAT to redirect to data files in #MCDATA and to initialize the files GROUPS.DAT and COUNTRY.DAT.
  19. Type: BATCH XCD.BAT

  20. Run the batch file XCDDEC.BAT to register MD file schemas, create rapid access pointer files, and initialize several data files.

Proceed to the next section, Configuring McIDAS-XCD, and complete the configuration instructions for each section.

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]