README 3.23 KB
Newer Older
  > cd slurm
  > ./autogen.sh
  > ./configure [--with-authd] [--with-elan] [--with-totalview] [--enable-debug]
  > make

  NOTES:
     # --with-authd if you want to use authd for authentication
     # --with-elan  if you have an Quadics elan switch, defaults to IP
     # --with-totalview  if you want to support the Etnus TotalView debugger
     # --enable-debug if you want to run the daemons in debug mode (more 
       validity checking and writes core files, useful for getting things 
       running)
Moe Jette's avatar
Moe Jette committed
  You will need to construct a valid configuration file for your machine.
  To run on a single host, you can probably use the file in
    "etc/slurm.conf.localhost" with minimal modifications.  
  For a cluster, you should build something based upon "etc/slurm.conf.dev". 
  Be sure to update "SlurmUser", "JobCredentialPrivateKey" and 
    "JobCredentialPublicCertificate". There are keys in
    "src/slurmd/private.key" and "src/slurmd/public.cert"
  See "doc/man/man5/slurm.conf.5" for help in building this.
  Initiate "src/slurmctld/slurmctld" on the control machine (it can run 
     without root permissions, see SlurmUser in slurm.conf).
     For testing purposes you probably want to use several options:
     "-D" keep in foreground, "-c" clear state from previous executions, 
     and possibly "-v" for verbose messages (more v's for more verbosity).
  Initiate "src/slurmd/slurmd" on each compute server (it needs to run 
     as root for production, but can run as a normal user for testing - 
     it will report errors on the initgroups, seteuid, and setegid functions 
     if not run as root, but if everything is run as the same user that's OK).
     For testing purposes you probably want to use several options:
     "-D" keep in foreground, "-c" clear state from previous executions, 
     and possibly "-v" for verbose messages (more v's for more verbosity).
  Run jobs using the "src/srun/srun" command.
  Get system status using "src/sinfo/sinfo" and "src/squeue/squeue".
  Terminate jobs using "src/scancel/scancel".
  Get and set system configuration information using "src/scontrol/scontrol".
  Man pages for all of these daemons and commands can be found in "doc/man". 
  There DejaGnu scripts to exercise various APIs and tools.
Moe Jette's avatar
Moe Jette committed
  You should have autoconf version 2.52 or higher (see "autoconf -V").
  There is no authentication of communications between commands and 
     daemons without the the authd daemon in operation. For more 
     information, see "http://www.theether.org/authd/".
Moe Jette's avatar
Moe Jette committed

  To generate your own slurm job credential private and public keypair,
  run the following commands:
 
  > openssl genrsa -out <name of private key> 1024
  > openssl rsa -in <name of private key> -pubout -out <name of public key>


STATUS (As of 3/4/2002): 
  Most functionality is in place and working.
  Performance is good (under 5 seconds to run 1900 tasks of "/bin/hostname"
      over 950 nodes). 
  Fault-tolerance is good.
  Support for additional hardware and software is planned in future releases
      (IA64, RedHat 8.1, Myrinet, IBM Blue Gene).
  Support for job suspend/resume and checkpoint/restart is planned for 
      future releases.
  Send feedback to Morris Jette <jette1@llnl.gov> or Mark Grondona
      <grondona1@llnl.gov>.
Moe Jette's avatar
Moe Jette committed