Home

About
Overview
What's New
Publications
SLURM Team

Using
Documentation
FAQ
Getting Help

Installing
Platforms
Download
Guide

## Maui Scheduler Integration Guide

### Overview

Maui configuration is quite complicated and is really beyond the scope of any documents we could supply with SLURM. We don't intend SLURM to be a "wrapper" for Maui, or to subordinate Maui. The best (and practically only) resource for configuration Maui is the online documents at the site of Maui's developers: http://www.supercluster.org.

### Configuration

First, compile Maui from its source distribution. As part of the Maui pre-compilation configuration you will be asked whether you want to us PBS. Say no. You will be asked for a "Checksum Seed". Enter any number and make note of the number you give; it will be needed for the SchedulerAuth configuration parameter in SLURM.

You must also select a TCP port number over which Maui and SLURM will communicate. I use 7321, but you can pick any port that is available and accessible. In the Maui configuration file, add the following configuration parameters:

    RMCFG[base]     TYPE=WIKI
    RMPORT          7321            # or whatever you choose as a port

You must also give the host name on which the SLURM controller is running. Note that "localhost" doesn't seem to work; if you run Maui and SLURM on the same machine, you must still give the host name. In the Maui configuration add:

    RMHOST          myhost.mydomain

replacing "myhost.mydomain" with your SLURM controller host. You can also set a polling interval with

    RMPOLLINTERVAL  00:00:20

I like Maui to poll SLURM quite often -- in this case every 20 seconds. Note that a job submitted to an idle cluster will not be initiated until the Maui daemon polls SLURM and decides to make it run, so the value of RMPOLLINTERVAL should be set to a value appropriate for your site considering both the desired system responsiveness and the overhead of executing Maui daemons too frequently. The sample SLURM configuration file contains a schedule section that looks like this:

    #
    # o Define a scheduler.
    #
    # "SchedulerType"        : the type of scheduler.
    #       "sched/builtin"  : the default, SLURM's built-in FIFO scheduler.
    #       "sched/backfill" : FIFO scheduling with backfill.
    #       "sched/wiki"     : the Wiki interface to Maui.
    #
    # "SchedulerAuth"        : an authentication token, if any, that must
    #                          be used in a scheduler communication
    #                          protocol.  The interpretation of this value
    #                          depends on the plugin type.
    #
    # "SchedulerPort"        : for polling schedulers, the port number on
    #                          which slurmctld should listen for connection
    #                          requests.
    #
    SchedulerType=sched/wiki
    SchedulerPort=7321
    SchedulerAuth=42

In this case, "SchedulerAuth" has been set to 42, which is the number you could have given as the "Checksum Seed" to Maui. Just make sure the numbers match. The Maui folks have assured me that the checksum won't always be a compiled-in feature.

For information about this page, contact slurm-dev@lists.llnl.gov.