slurman 1.2.3

Terminal GUI for easier Slurm experience

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