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)
Create the default directory that the cluster configuration files reside under:
sudo mkdir -p /etc/ood/config/clusters.d
Create a cluster YAML configuration file for each HPC cluster you want to provide access to. They must have the
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.ymlfor 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"
hostis 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.