Provided by:
slurm-llnl-slurmdbd_1.3.6-1_i386 
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)