MAUI is an open source job scheduler for clusters and supercomputers. It is an optimized, configurable tool capable of supporting an array of scheduling policies, dynamic priorities, extensive reservations, and fairshare capabilities.
This Blog Entry attempt to capture the essence of MAUI and some of the more commonly used commands and configuration.
Useful commands for MAUI
1. Configuring MAUI Scheduler
- schedctl -R command can be used to reconfigure the scheduler at any time, forcing it to re-read all config files before continuing.
- Shut-down MAUI Scheduler
# schedctl -k
- Stop maui scheduling
# schedctl -s
- maui will resume scheduling immediately
# schedctl -r
2. Status Commands
Maui provides an array of commands to organize and present information about the current state and historical statistics of the scheduler, jobs, resources, users, accounts, etc. The following commands are taken from Cluster Resources and reproduce here
checkjob -> display job state, resource requirements, environment, constraints, credentials, history, allocated resources, and resource utilization checknode -> Displays state information and statistics for the specified node. diagnose -j -> display summarized job information and any unexpected state diagnose -n -> display summarized node information and any unexpected state diagnose -p -> display summarized job priority information diagnose -r -> display summarized reservation information showgrid -> display various aspects of scheduling performance across a job duration/job size matrix showq -> display various views of currently queued active, idle, and non-eligible jobs showstat -f -> display historical fairshare usage on a per credential basis showstat -g -> display current and historical usage on a per group basis showstat -u -> display current and historical usage on a per user basis showstat -v -> display high level current and historical scheduling statistics
3. Job Management Commands
Maui shares job management tasks with the resource manager. The commands below the available job management commands
canceljob -> cancel existing job releasehold [-a] -> remove job holds or defers runjob -> start job immediately if possible sethold -> set hold on job setqos -> set/modify QoS of existing job setspri -> adjust job/system priority of job
4. Reservation Management Commands
Maui exclusively controls and manages all advance reservation features including both standing and administrative reservations
diagnose -r -> display summarized reservation information and any unexpected state releaseres -> remove reservations setres -> immediately create an administrative reservation showres -> display information regarding location and state of reservations
5. Policy/Config Management Commands
Maui allows dynamic modification of most scheduling parameters allowing new scheduling policies, algorithms, constraints, and permissions to be set at any time.
changeparam -> immediately change parameter value schedctl -> control scheduling behavior (i.e., stop/start scheduling, recycle, shutdown, etc.) showconfig -> display settings of all configuration parameters
6. End User Commands
canceljob -> cancel existing job checkjob -> display job state, resource requirements, environment, constraints, credentials, history, allocated resources, and resource utilization showbf -> show resource availability for jobs with specific resource requirements showq -> display detailed prioritized list of active and idle jobs showstart -> show estimated start time of idle jobs showstats -> show detailed usage statistics for users, groups, and accounts which the end user has access to