Provided by: slurm-llnl-slurmdbd_1.3.13-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:

       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 9 are legal, with ‘0’ being  "quiet"  operation
              and ‘9’ 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".

       PrivateData
              This controls what type of information is  hidden  from  regular
              users.   By  default,  all  information is visible to all users.
              User SlurmUser, root, and users with AdminLevel=Admin can always
              view  all  information.  Multiple values may be specified with a
              comma separator.  Acceptable values include:

              accounts
                     prevents  users  from  viewing  any  account  definitions
                     unless they are coordinators of them.

              jobs   prevents  users  from  viewing  job  records belonging to
                     other  users  unless  they  are   coordinators   of   the
                     association running the job when using sacct.

              users  prevents users from viewing information of any user other
                     than themselves, this also makes it so users can only see
                     associations   they  deal  with.   Coordinators  can  see
                     associations of all users they are  coordinator  of,  but
                     can only see themselves when listing users.

              usage  prevents  users  from  viewing  usage  of any other user.
                     This applys to sreport.

       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  plugin  is  not
              complete  and should not be used if wanting to use associations.
              It will however work with  basic  accounting  of  jobs  and  job
              steps.    If   interested  in  completing  please  email  slurm-
              dev@lists.llnl.gov.  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.

       TrackWCKey
              Boolean  yes  or  no.   Used  to  set  display  and track of the
              Workload Characterization Key. Must be set to track wckey usage.

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)