Add Cluster Configuration Files

(Optional, but recommended)

The following apps do not require a cluster configuration file:

• Dashboard App
• Files App
• Shell App (but only launched from within the Files App)

The following apps do require a cluster configuration file:

• Shell App (connect to a cluster login node from the Dashboard App)
• Active Jobs App (view a list of active jobs for the various clusters)
• Job Composer App (submit jobs to various clusters)

1. Create the default directory that the cluster configuration files reside under:

   sudo mkdir -p /etc/ood/config/clusters.d
   

2. Create a cluster YAML configuration file for each HPC cluster you want to provide access to. They must have the *.yml extension.

   Note

   It is best to name the file after the HPC cluster it is defining. For example, we added the cluster configuration file /etc/ood/config/clusters.d/oakley.yml for the Oakley cluster here at OSC.

   The simplest cluster configuration file for an HPC cluster with only a login node and no resource manager looks like:

   # /etc/ood/config/clusters.d/my_cluster.yml
   ---
   v2:
     metadata:
       title: "My Cluster"
     login:
       host: "my_cluster.my_center.edu"
   

   Where host is the SSH server host for the given cluster.

   In production you will also want to add a resource manager. That is because the Active Jobs App and the Job Composer App won’t be able to list or submit jobs without a defined resource manager.

   See Resource Manager Configuration for how to modify the cluster config so OnDemand works with your particular resource manager.

Cluster Config

• Cluster Config Schema v2