Man Linux: Main Page and Category List

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:

       ArchiveDir
              If ArchiveScript is not set the slurmdbd will  generate  a  text
              file  that  can  be read in anytime with sacctmgr load filename.
              This directory is where the file will be placed archive has ran.
              Default is /tmp.

       ArchiveEvents
              Boolean,  yes  to archive event data, no other wise.  Default is
              no.

       ArchiveJobs
              Boolean, yes to archive job data, no other wise.  Default is no.

       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  no  arguments,  The  following
              environment variables are set.

              SLURM_ARCHIVE_EVENTS
                     1 for archive events 0 otherwise.

              SLURM_ARCHIVE_LAST_EVENT
                     Time of last event start to archive.

              SLURM_ARCHIVE_JOBS
                     1 for achive jobs 0 otherwise.

              SLURM_ARCHIVE_LAST_JOB
                     Time of last job submit to archive.

              SLURM_ARCHIVE_STEPS
                     1 for archive steps 0 otherwise.

              SLURM_ARCHIVE_LAST_STEP
                     Time of last step start to archive.

              SLURM_ARCHIVE_SUSPEND
                     1 for archive suspend data 0 otherwise.

              SLURM_ARCHIVE_LAST_SUSPEND
                     Time of last suspend start to archive.

       ArchiveSteps
              Boolean, yes to archive step data, no other  wise.
              Default is no.

       ArchiveSuspend
              Boolean,  yes  to  archive  suspend data, no other
              wise.  Default is no.

       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.

       DbdBackupHost
              The name of the machine  where  the  backup  Slurm
              Database  Daemon is executed.  This host must have
              access to the same underlying  database  specified
              by  the  ’Storage’  options mentioned below.  This
              should be a node  name  without  the  full  domain
              name.    I.e.,   the   hostname  returned  by  the
              gethostname() function cut at the first dot  (e.g.
              use "tux001" rather than "tux001.my.com").

       DbdHost
              The  name  of the machine where the Slurm Database
              Daemon is executed.  This should be  a  node  name
              without  the full domain name.  I.e., the hostname
              returned by the gethostname() function cut at  the
              first   dot   (e.g.   use   "tux001"  rather  than
              "tux001.my.com").  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
              AccountingStoragePort  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.

       DefaultQOS
              When adding a new cluster this will be used as the
              qos for the cluster unless something is explicitly
              set by the admin with the create.

       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.

              reservations
                     restricts  getting  reservation information
                     to users with operator status and above.

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

              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.

       PurgeEventMonths
              Events  happening on the cluster over this age are
              purged from the  database.   This  includeds  node
              down  times and such.  The time is a numeric value
              and is a number of  months.   If  zero  (default),
              then job step records are never purged.

       PurgeJobMonths
              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  months.   If   zero
              (default), then job records are never purged.

       PurgeStepMonths
              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 months.  If  zero
              (default), then job step records are never purged.

       PurgeSuspendMonths
              Records of individual suspend times for jobs  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 months.
              If zero (default), then job step records are never
              purged.

       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".

       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.

       StorageBackupHost
              Define the name of the backup host the database is
              running  where  we  are  going  to store the data.
              This can be viewed as a backup solution  when  the
              StorageHost  is  not  responding.  It is up to the
              backup solution to enforce the  coherency  of  the
              accounting information between the two hosts. With
              clustered database solutions (acitve/passive  HA),
              you  would  not need to use this feature.  Default
              is none.

       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
       #
       ArchiveEvents=yes
       ArchiveJobs=yes
       ArchiveSteps=no
       ArchiveSuspend=no
       #ArchiveScript=/usr/sbin/slurm.dbd.archive
       AuthInfo=/var/run/munge/munge.socket.2
       AuthType=auth/munge
       DbdHost=db_host
       DebugLevel=4
       PurgeEventMonths=1
       PurgeJobMonths=12
       PurgeStepMonths=1
       PurgeSuspendMonths=1
       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).  CODE-OCEC-09-009. All rights reserved.

       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)