3. 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
*.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.