Provided by: slurm-llnl-slurmdbd_1.3.6-1_i386 bug

NAME

       slurmdbd.conf - Slurm Database Daemon (SlurmDBD) configuration file

DESCRIPTION

       /etc/slurmdb.conf  is  an  ASCII  file  which  describes Slurm Database
       Daemon (SlurmDBD) configuration information.

       The file location can be  modified  at  system  build  time  using  the
       DEFAULT_SLURM_CONF  parameter.   The  contents  of  the  file  are case
       insensitive except for the names of nodes and files. Any text following
       a "#" in the configuration file is treated as a comment through the end
       of that line.  The size of each line in the file  is  limited  to  1024
       characters.  Changes to the configuration file take effect upon restart
       of SlurmDbd or daemon receipt of the  SIGHUP  signal  unless  otherwise
       noted.

       This  file  should  be only on the computer where SlurmDBD executes and
       should only be readable by  the  user  which  executes  SlurmDBD  (e.g.
       "slurm").  This file should be protected from unauthorized access since
       it contains a database password.  The overall configuration  parameters
       available include:

       AllowView
              This  controls  who  can  view  accounting  records.  A value of
              "user" prevents normal users  from  viewing  accounting  records
              that  are  not  generated directly by them (preventing them from
              viewing any other users jobs).  A value  of  "account"  prevents
              normal  users  from  viewing  accounting  records  that  are not
              generated by users in the same account.  A value of "none"  lets
              any  user  view  accounting records generated by any other user.
              The default value is "none".

       ArchiveAge
              Move data over this age out of the database to an archive.   The
              time  is a numeric value and is a number of days.  If zero, then
              never archive the data.  The default value is zero.

       ArchiveScript
              This script  is  executed  periodically  in  order  to  transfer
              accounting  records  out  of  the  database into an archive. The
              script  is  executed  with  a  single  argument,  the  value  of
              ArchiveTime as described below.

       AuthInfo
              Additional   information   to  be  used  for  authentication  of
              communications with the Slurm control daemon (slurmctld) on each
              cluster.   The  interpretation of this option is specific to the
              configured AuthType.  In the case of  auth/munge,  this  can  be
              configured  to  use  a  Munge  daemon specifically configured to
              provide authentication between clusters while the default  Munge
              daemon  provides authentication within a cluster.  In that case,
              this will specify the  pathname  of  the  socket  to  use.   The
              default   value   is   NULL,   which   results  in  the  default
              authentication mechanism being used.

       AuthType
              Define the  authentication  method  for  communications  between
              SLURM   components.    Acceptable   values  at  present  include
              "auth/none", "auth/authd", and "auth/munge".  The default  value
              is  "auth/none",  which  means the UID included in communication
              messages  is  not  verified.   This  may  be  fine  for  testing
              purposes, but do not use "auth/none" if you desire any security.
              "auth/authd" indicates that Brett Chun’s authd  is  to  be  used
              (see  "http://www.theether.org/authd/"  for  more  information).
              "auth/munge" indicates that LLNL’s Munge system is  to  be  used
              (this  is the best supported authentication mechanism for SLURM,
              see   "http://home.gna.org/munge/"   for   more    information).
              SlurmDbd  must  be  terminated  prior  to  changing the value of
              AuthType and later restarted.

       DbdAddr
              Name that DbdHost  should  be  referred  to  in  establishing  a
              communications  path  to  the  Slurm Database Daemon.  This name
              will be used as an argument to the gethostbyname() function  for
              identification.   For   example,  "elx0000"  might  be  used  to
              designate the ethernet address for node  "lx0000".   By  default
              the  DbdAddr  will be identical in value to DbdHost.  This value
              must be equal to the SlurmDbdAddr parameter  in  the  slurm.conf
              file.

       DbdHost
              The  name  of  the  machine  where  the Slurm Database Daemon is
              executed.  This should be a node name without  the  full  domain
              name (e.g. "lx0001").  This value must be specified.

       DbdPort
              The  port  number  that  the  Slurm  Database  Daemon (slurmdbd)
              listens to for work.  The  default  value  is  SLURMDBD_PORT  as
              established   at  system  build  time.  If  none  is  explicitly
              specified, it will be set to 6819.  This value must be equal  to
              the SlurmDbdPort parameter in the slurm.conf file.

       DebugLevel
              The level of detail to provide the Slurm Database Daemon’s logs.
              Values from 0 to 7 are legal, with ‘0’ being  "quiet"  operation
              and ‘7’ being insanely verbose.  The default value is 3.

       JobPurge
              Individual  job  records  over  this  age  are  purged  from the
              database.    Aggregated   information    will    be    preserved
              indefinitely.   The  time  is a numeric value and is a number of
              days.  If zero, then job records are never purged.  The  default
              value is 360 days.

       LogFile
              Fully qualified pathname of a file into which the Slurm Database
              Daemon’s logs are written.  The default value is none  (performs
              logging via syslog).

       MessageTimeout
              Time  permitted  for  a  round-trip communication to complete in
              seconds. Default value is 10 seconds.

       PidFile
              Fully qualified pathname of a file into which the Slurm Database
              Daemon  may write its process ID. This may be used for automated
              signal     processing.       The      default      value      is
              "/var/run/slurmdbd.pid".

       PluginDir
              Identifies  the places in which to look for SLURM plugins.  This
              is  a  colon-separated  list  of  directories,  like  the   PATH
              environment      variable.      The     default     value     is
              "/usr/local/lib/slurm".

       SlurmUser
              The name of the user that  the  slurmctld  daemon  executes  as.
              This user must exist on the machine executing the Slurm Database
              Daemon and have the same user ID as the hosts on which slurmctld
              execute.   For  security  purposes,  a user other than "root" is
              recommended.  The default value is "root".

       StepPurge
              Individual job step records over this age are  purged  from  the
              database.     Aggregated    information    will   be   preserved
              indefinitely.  The time is a numeric value and is  a  number  of
              days.   If  zero,  then  job step records are never purged.  The
              default value is 30 days.

       StorageHost
              Define the name of the host the database is running where we are
              going  to  store  the  data.  Ideally this should be the host on
              which slurmdbd executes.

       StorageLoc
              Specify  the  name  of  the  database  as  the  location   where
              accounting records are written.

       StoragePass
              Define the password used to gain access to the database to store
              the job accounting data.

       StoragePort
              The port  number  that  the  Slurm  Database  Daemon  (slurmdbd)
              communicates with the database.

       StorageType
              Define the accounting storage mechanism type.  Acceptable values
              at       present       include        "accounting_storage/gold",
              "accounting_storage/mysql", and "accounting_storage/pgsql".  The
              value "accounting_storage/gold" indicates that  account  records
              will            be           written           to           Gold
              (http://www.clusterresources.com/pages/products/gold-allocation-
              manager.php),  which  maintains  its  own  database.   The value
              "accounting_storage/mysql"  indicates  that  accounting  records
              should be written to a MySQL database specified by the torageLoc
              parameter.  The value "accounting_storage/pgsql" indicates  that
              accounting  records  should  be written to a PostgreSQL database
              specified by the  StorageLoc  parameter.   This  value  must  be
              specified.

       StorageUser
              Define  the  name  of  the  user  we are going to connect to the
              database with to store the job accounting data.

EXAMPLE

       #
       # Sample /etc/slurmdbd.conf
       #
       ArchiveAge=365   # keep 1 year of data online
       ArchiveScript=/usr/sbin/slurm.dbd.archive
       AuthInfo=/var/run/munge/munge.socket.2
       AuthType=auth/munge
       DbdHost=db_host
       DebugLevel=4
       JobPurge=90
       StepPurge=30
       LogFile=/var/log/slurmdbd.log
       PidFile=/var/tmp/jette/slurmdbd.pid
       SlurmUser=slurm_mgr
       StoragePass=shazaam
       StorageType=accounting_storage/mysql
       StorageUser=database_mgr

COPYING

       Copyright (C) 2008 Lawrence Livermore National Security.   Produced  at
       Lawrence    Livermore    National    Laboratory    (cf,    DISCLAIMER).
       LLNL-CODE-402394.

       This file is  part  of  SLURM,  a  resource  management  program.   For
       details, see <https://computing.llnl.gov/linux/slurm/>.

       SLURM  is free software; you can redistribute it and/or modify it under
       the terms of the GNU General Public License as published  by  the  Free
       Software  Foundation;  either  version  2  of  the License, or (at your
       option) any later version.

       SLURM is distributed in the hope that it will be  useful,  but  WITHOUT
       ANY  WARRANTY;  without even the implied warranty of MERCHANTABILITY or
       FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General  Public  License
       for more details.

FILES

       /etc/slurmdbd.conf

SEE ALSO

       slurm.conf(5), slurmctld(8), slurmdbd(8) syslog(2)