squeue is a command-line tool used to view the jobs that are queued or running in the SLURM job scheduler. SLURM is a popular open-source job scheduler used in many high-performance computing (HPC) environments. It is used to manage and allocate computing resources to individual jobs submitted by users.
When a user submits a job to the SLURM scheduler, it is added to a queue with other jobs waiting to be executed. squeue is used to view the status of these jobs, including their ID, priority, user, state, and the resources they are using. It also provides real-time updates on the status of running jobs.
squeue can be used with various options to filter and sort the job list. For example, the –user option can be used to show only jobs submitted by a specific user, and the –state option can be used to show jobs in a specific state (e.g., pending, running, completed, failed).
If you encounter the below error while running the command squeue:
squeue: command not found
you may try installing the below package as per your choice of distribution:
Distribution | Command |
---|---|
Debian | apt-get install slurm-client |
Ubuntu | apt-get install slurm-client |
Kali Linux | apt-get install slurm-client |
Fedora | dnf install slurm |
OS X | brew install slurm |
Raspbian | apt-get install slurm-client |
squeue Command Examples
1. View the queue:
# squeue
2. View jobs queued by a specific user:
# squeue -u username
3. View the queue and refresh every 5 seconds:
# squeue -i 5
4. View the queue with expected start times:
# squeue --start
Summary
Overall, squeue is a useful tool for users and administrators of SLURM-based HPC clusters to view the status of jobs submitted to the scheduler. It provides a simple and efficient way to monitor the progress of jobs and the resources they are using.