Slurman

Enhanced command-line GUI to ease working with Slurm. Written in Python, derived from SlurmUI.

Viewing and managing

• GPUs
• Jobs in the history
• Jobs in the queue
• Logs for current and past jobs

Install and run

pip install slurman
slurman

Optional arguments:

• -h show help message and exit.
• -i refreshing interval in seconds. (10 by default. Set to 0 to disable).
• -v verbose mode (printing info and error to the info panel).

Basics

Under the interface of Slurman we rely on three basic slurm commands:

• sinfo for information of nodes, GPUs, etc.
• squeue for current jobs in the queue
• sacct for history jobs

Make sure you can get meaningful output from these commands on your cluster before trying Slurman.

To debug, you could run slurman -i 0 -v to disable auto update and force verbose logging. Then you will see the full commands that Slurman sends to Slurm in the info panel.

Note

Runtime errors are written into ~/.slurman_error.log.

Tested Clusters

• TUM CVG
• TUM VCG
• LRZ AI

Note

If Slurman does not work on your cluster, try the debugging suggestions in Basics and feel free to open an issue.

Contributions

Open to contribution including but not limited to:

• Improving startup/launch speed
• Enhancing multithreading and concurrency handling
• Strengthening crash recovery and process resiliency
• Expanding features or addressing edge cases