CLI Reference

The cluster-services CLI can be accessed from either the login or controller nodes, and can only be executed by a user with root privileges.

$ cluster-services --help

Copyright 2020 Fluid Numerics
All Rights Reserved

cluster-services is a tool used to manage fluid-slurm-gcp clusters on Google Cloud Platform.
For more information about fluid-slurm-gcp, go to

  cluster-services list all [--format=<fmt>]
  cluster-services list partitions [--format=<fmt>]
  cluster-services list mounts [--format=<fmt>]
  cluster-services list slurm_accounts [--format=<fmt>]
  cluster-services update config
  cluster-services update all [--preview] [--config=<string>]
  cluster-services update partitions [--preview] [--config=<string>]
  cluster-services update mounts [--preview] [--config=<string>]
  cluster-services update slurm_accounts [--preview] [--config=<string>]
  cluster-services validate config [--config=<string>]
  cluster-services add user <username>
  cluster-services clear users
  cluster-services sample all [--format=<fmt>]
  cluster-services sample partitions [--format=<fmt>]
  cluster-services sample mounts [--format=<fmt>]
  cluster-services sample slurm_accounts [--format=<fmt>]
  cluster-services setup
  cluster-services system-checks
  cluster-services -h | --help
  cluster-services --version

  list all               List the current cluster config to stdout in specified format.
  list partitions        List the current cluster partitions to stdout in the specified format.
  list mounts            List the current cluster mounts to stdout in specified format.
  list slurm_accounts    List the current cluster slurm_accounts to stdout in specified format.
  update config          Update the default cluster config from instance metadata item "cluster-config". 
  update all             Update partitions, mounts, and users using the specified cluster config file.
  update partitions      Update partitions using the specified cluster config file.
  update mounts          Update mounts using the specified cluster config file.
  update slurm_accounts  Update Slurm users using the specified cluster config file.
  validate config        Validate the specified cluster configuration file.
  add user               Add a Slurm user to a default Slurm account with access to all compute partitions.
  clear users            Remove all Slurm users from the default slurm account.
  sample all             Provide a sample cluster-config schema to stdout.
  sample partitions      Provide a sample partitions yaml-block to stdout.
  sample mounts          Provide a sample mounts yaml-block to stdout.
  sample slurm_accounts  Provide a sample slurm_accounts yaml-block to stdout. 
  setup                  Perform initial cluster setup steps.
  system-checks          Perform a set of system checks for the node this is executed from.

  -h --help            Display this help screen
  --preview            Preview expected changes for an update, but do not execute.
  --format=<fmt>       Output format (json|yaml) [default: yaml]
  --config=<string>    Cluster configuration file [default: /apps/cls/etc/cluster-config.yaml]