Warning

There are known security vulnerabilities in Open XDMoD versions ≤11.0.2. We strongly encourage upgrading immediately to the latest version of Open XDMoD, 11.0.3, which contains fixes for these vulnerabilities.

To upgrade version 8.1 to 11.0.3, you will first need to upgrade to version 8.5.0, then upgrade to version 9.0.0, then upgrade to version 9.5.0, then upgrade to version 10.0.3, then upgrade to version 10.5.1, then upgrade to version 11.0.3.

If you cannot upgrade immediately, you can follow the instructions below to manually patch your installation as a temporary workaround before upgrading later.

Workaround instructions
  1. First, make sure you are on the correct web page for your version of Open XDMoD. The web page you are on now is for version 8.1. Other versions' pages are linked below:
  2. Download the patch file for your version:
  3. Copy the patch file to your Open XDMoD web server.
  4. Make sure you have the patch command installed; it can be installed with dnf install patch.
  5. Apply the patch by running the command below, replacing [PATH_TO_XDMOD_SHARE_DIR] with the path to the share directory (/usr/share/xdmod for RPM-based installs, /opt/xdmod/share or another location for source code installs) and replacing [PATH_TO_PATCH_FILE] with the path to the patch file. 
    # patch -p1 -d [PATH_TO_XDMOD_SHARE_DIR] < [PATH_TO_PATCH_FILE]
  6. Upgrade to the latest version of Open XDMoD as soon as you can.

Resource Manager Notes → SGE/Grid Engine

Open XDMoD supports Sun Grid Engine with the caveats listed below. SGE support includes Univa Grid Engine (pre-8.2) and the other SGE derivatives that use the same accounting log format as Sun Grid Engine.

NOTE: If you are using Univa Grid Engine 8.2+ you should use the Univa Grid Engine Shredder.

Nodes and CPUs

SGE does not report the nodes used by a given job in the accounting log. For accurate node counts the accounting_summary must be set to FALSE in sge_pe. If accounting_summary is set to TRUE it will appear that all jobs were run on a single node.

Open XDMoD supports two different ways of specifying the number of CPUs used by a job. By default, the number of slots reported by SGE will be used as the number of CPUs. If you configure num_procs as a consumable resource, the greater of the two values will be used as the number of CPUs.

Log Files

If your logs are not rotated (you re-shred the same log file every time you update the Open XDMoD database), when Open XDMoD inserts duplicate data, the unique key constraint on the shredded_job_sge table will prevent the insertion of this data, but will instead update the primary key. This will prevent duplicate data from being entered into the database, even though the entire log file will still be parsed.

Unsupported Shredder Features

The xdmod-shredder -d/--dir option was designed to work with the accounting log naming convention used by PBS/TORQUE. If you are not using the same convention (files are named YYYYMMDD corresponding to the current date), do not use this option.