From a109ee706c6ef910d9d7adea4513e6b42e3e00f4 Mon Sep 17 00:00:00 2001 From: Moe Jette <jette1@llnl.gov> Date: Mon, 24 Jan 2005 23:04:44 +0000 Subject: [PATCH] Major update of maui integration guide courtesy of Susanne Ball <susanne.balle@hp.com> --- doc/html/maui.html | 112 +++++++++++++++++++++++++-------------------- doc/html/team.html | 5 +- 2 files changed, 65 insertions(+), 52 deletions(-) diff --git a/doc/html/maui.html b/doc/html/maui.html index 95ada24e62d..9cd591af7a9 100644 --- a/doc/html/maui.html +++ b/doc/html/maui.html @@ -9,7 +9,7 @@ <meta http-equiv="keywords" content="Simple Linux Utility for Resource Management, SLURM, resource management, Linux clusters, high-performance computing, Livermore Computing"> <meta name="LLNLRandR" content="UCRL-WEB-204324"> -<meta name="LLNLRandRdate" content="8 July 2004"> +<meta name="LLNLRandRdate" content="24 January 2005"> <meta name="distribution" content="global"> <meta name="description" content="Simple Linux Utility for Resource Management"> <meta name="copyright" @@ -58,72 +58,84 @@ 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: -<a href="http://www.supercluster.org">http://www.supercluster.org</a>. +<a href="http://www.clusterresources.com/products/maui/docs/mauiadmin.shtml"> +http://www.clusterresources.com/products/maui/docs/mauiadmin.shtml</a>. <h3>Configuration</h3> -<p>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. +<p>First, download the Maui scheduler kit from their web site +<a href="http://www.clusterresources.com/products/maui"> +http://www.clusterresources.com/products/maui</a>. +Note: maui-3.2.6p9 has been validated with SLURM, other versions +should also work properly.</p> -<p>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: -<pre> -RMCFG[base] TYPE=WIKI -RMPORT 7321 # or whatever you choose as a port -</pre> +<p>Make sure that SLURM is installed and running before building Maui. +Then build Maui from its source distribution. This is a two step process: +<ol> +<li>./configure --with-key=42 --with-wiki +<li>gmake +</ol> +The key of 42 is arbitrary. You can use any value, but will need to +specify the same value as a SLURM configuration parameter.</p> -<p>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: +<p>Update the Maui configuration file <i>maui.conf</i> (Copy the file +maui-3.2.6p9/maui.cfg.dist to maui.conf). Add the following configuration +paramters to maui.conf: <pre> -RMHOST myhost.mydomain +RMCFG[host] TYPE=WIKI +RMPORT 7321 # or whatever you choose as a port +RMHOST host +RMAUTHTYPE[host] NONE </pre> -replacing "myhost.mydomain" with your SLURM controller host. You can -also set a polling interval with +<i>host</i> is the hostname where the SLURM controller is running. +This must match the value of <i>ControlMachine</i> configured in +slurm.conf. Note that <i>localhost</i> doesn't work. If you run Maui +and SLURM on the same machine, you must specify the actual host name. +The above example uses a TCP port number of 7321 for +communications between SLURM and Maui, but you can pick any port that +is available and accessible. You can also set a polling interval with <pre> RMPOLLINTERVAL 00:00:20 </pre> 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 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.</p> -The sample SLURM configuration file contains a schedule section that -looks like this: +<p>In order for Maui to be able to access your SLURM partition, you will +need to define in maui.conf a partition with the same name as the SLURM +partition(s). For example if nodes "linux[0-3]" are in SLURM partition +"PartA", slurm.conf includes a line of this sort: +<pre> +PartitionName=PartA Default=yes Nodes=linux[0-3] +</pre> +The add the corresponding lines to maui.cfg: +<pre> +PARTITIONMODE ON +NODECFG[linux0] PARTITION=PartA +NODECFG[linux1] PARTITION=PartA +NODECFG[linux2] PARTITION=PartA +NODECFG[linux3] PARTITION=PartA +</pre> + +<p> +Set the slurm.conf scheduler parameters as follows: <pre> -# -# 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 </pre> -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. +In this case, "SchedulerAuth" has been set to 42, which was the key +specified when Maui was configured above. Just make sure the numbers match. +The Maui folks have assured me that the key won't always be a compiled-in +feature.</p> +<p>Set the following environment variables and path: +<pre> +set path=(/root/MAUI/maui-3.2.6p9/bin $path) +setenv MAUIHOMEDIR /root/MAUI/maui-3.2.6p9 +</pre> <p class="footer"><a href="#top">top</a></p></td> </tr> @@ -131,7 +143,7 @@ always be a compiled-in feature. <td colspan="3"><hr> <p>For information about this page, contact <a href="mailto:slurm-dev@lists.llnl.gov">slurm-dev@lists.llnl.gov</a>.</p> <p><a href="http://www.llnl.gov/"><img align=middle src="lll.gif" width="32" height="32" border="0"></a></p> <p class="footer">UCRL-WEB-207187<br> -Last modified July 8, 2004</p></td> +Last modified 24 January 2005</p></td> </tr> </table> </td> diff --git a/doc/html/team.html b/doc/html/team.html index f078ababbf7..5ca5da31086 100644 --- a/doc/html/team.html +++ b/doc/html/team.html @@ -9,7 +9,7 @@ <meta http-equiv="keywords" content="Simple Linux Utility for Resource Management, SLURM, resource management, Linux clusters, high-performance computing, Livermore Computing"> <meta name="LLNLRandR" content="UCRL-WEB-204324"> -<meta name="LLNLRandRdate" content="11 October 2004"> +<meta name="LLNLRandRdate" content="24 January 2005"> <meta name="distribution" content="global"> <meta name="description" content="Simple Linux Utility for Resource Management"> <meta name="copyright" @@ -64,6 +64,7 @@ The primary SLURM development staff includes: </p> <p> SLURM contributers include: <ul> <li>Danny Auble (LLNL)</li> +<li>Susanne Balle (HP)</li> <li>Chris Dunlap (LLNL)</li> <li>Joey Eckstrom (LLNL/Bringham Young University)</li> <li>Jim Garlick (LLNL)</li> @@ -78,7 +79,7 @@ The primary SLURM development staff includes: </p> <td colspan="3"><hr> <p>For information about this page, contact <a href="mailto:slurm-dev@lists.llnl.gov">slurm-dev@lists.llnl.gov</a>.</p> <p><a href="http://www.llnl.gov/"><img align=middle src="lll.gif" width="32" height="32" border="0"></a></p> <p class="footer">UCRL-WEB-207187<br> -Last modified 11 October 2004</p></td> +Last modified 24 January 2005</p></td> </tr> </table> </td> -- GitLab