NAME
bdii - configuration files
DESCRIPTION
bdii-update.conf
Configuration for bdii-update: a list of source URLs for resource
information. Format: one unique name + one URL per line, shell-style
commented. For a site-level BDII each name represents a grid resource
provided by the site, for a top-level BDII each name represents a whole
site.
Typical content of a bdii-update.conf file for a site-level BDII:
CE ldap://ce.example.com:2135/Mds-Vo-name=local,o=Grid
SE ldap://se.example.com:2135/Mds-Vo-name=local,o=Grid
RB ldap://rb.example.com:2135/Mds-Vo-name=local,o=Grid
NOTE: when BDII_AUTO_UPDATE is set to yes in bdii.conf, this file will
be periodically overwritten with the document referred to by the
BDII_UPDATE_URL.
bdii.conf
Configuration set up parameters for bdii, bdii-fwd, and bdii-update.
Format:
attribute=value shell variable assignments, with case-sensitive
attributes, shell-style commented
BDII_PORT_READ
BDII LDAP service port exposed to the outside.
Allowed values: 1-65536, but may not overlap with
the BDII_PORTS_WRITE
Typical value: 2170
BDII_PORTS_WRITE
Ports used to connect to any of the set of slapd servers that
host the directory content. At any time the port of the most
up-to-date slapd is used as a backend by the bdii-fwd service
to link to the BDII service port $BDII_PORT_READ. The slapd
databases are updated cyclically, with each instance being
used for up to a few minutes.
Allowed values: space separated and quoted list of
non-identical ports, each between 1-65535,
non overlapping with BDII_PORT_READ
Typical value: "2171 2172 2173"
BDII_USER
Username under which the bdii-related processes run.
This user will own the slapd databases.
Typical value: edguser
BDII_BIND
DN of the top of the DIT used to publish the information through
this bdii.
Allowed values: any DN that is compatible with the schemas
installed.
Typical values:
"Mds-Vo-name=example.com, o=Grid" for a site-level BDII
"Mds-Vo-name=local, o=Grid" for a top-level BDII
BDII_PASSWD
Password used to access the backend slapd servers, used
both to configure the slapd instances and in the bdii
update script to access the same.
Allowed values: any string, shell meta-characters must
be escaped.
Typical value: site specific
BDII_SEARCH_FILTER
Filter used in queries to underlying information
sources
Allowed values: valid LDAP search filter
Typical value: '*' (quoted asterisk)
BDII_SEARCH_TIMEOUT
Maximum amount in seconds to wait for a response from
an underlying information source.
Allowed values: non-negative integer
Typical value: 30
BDII_BREATHE_TIME
Period between BDII updates in seconds
Allowed values: non-negative integer
Typical value: 60
BDII_AUTO_UPDATE
Flag to determine whether or not to periodically refresh the
list of information sources from the $BDII_UPDATE_URL.
Allowed values: yes or no.
Typical value: usually follows from the role of this BDII,
with 'no' for site- and 'yes' for top-level BDIIs.
BDII_DIR
Directory used as a base for locating the slapd databases
and logfiles.
Allowed values: pathname
Typical value: /opt/bdii
BDII_UPDATE_URL
URL of a document containing a bdii-update.conf file.
Allowed values: http or https URL
Typical value:
http://some.host.some.domain/some/path/all-sites.conf
BDII_PROXY
Path to a proxy derived from the host certificate, to be made
available to info providers that query secure services.
Allowed values: full path to file, or empty to disable the
feature
Typical value: /opt/bdii/var/hostproxy (default)
SLAPD_SYSLOG_LEVEL
Loglevel for the OpenLDAP server. Please see the man page for
slapd.conf when specifying this value. Be sure to have the
syslog facility configured to accept log messages from the
slapd daemon. A level of 0 disables logging (default).
SLAPD
Path of the slapd daemon installed by the third-party
openldap-servers package.
Allowed value: path to a valid slapd executable
Typical value: /usr/sbin/slapd
SLAPADD
Path of the slapadd command installed by the third-party
openldap-servers package.
Allowed values: path to a valid slapadd executable
Typical value: /usr/sbin/slapadd
Typical content for a top-level BDII:
BDII_PORT_READ=2170
BDII_PORTS_WRITE="2171 2172 2173"
BDII_USER=edguser
BDII_BIND="Mds-Vo-name=local, o=Grid"
BDII_PASSWD=secret
BDII_SEARCH_FILTER='*'
BDII_SEARCH_TIMEOUT=30
BDII_BREATHE_TIME=60
BDII_AUTO_UPDATE=yes
BDII_DIR=/opt/bdii/
BDII_UPDATE_URL=http://some.host.some.domain/some/path/all-sites.conf
SLAPD=/usr/sbin/slapd
SLAPADD=/usr/sbin/slapadd
Typical content for a site-level BDII:
BDII_PORT_READ=2170
BDII_PORTS_WRITE="2171 2172 2173"
BDII_USER=edguser
BDII_BIND="Mds-Vo-name=example.com, o=Grid"
BDII_PASSWD=secret
BDII_SEARCH_FILTER='*'
BDII_SEARCH_TIMEOUT=30
BDII_BREATHE_TIME=60
BDII_AUTO_UPDATE=no
BDII_DIR=/opt/bdii/
BDII_UPDATE_URL=
SLAPD=/usr/sbin/slapd
SLAPADD=/usr/sbin/slapadd
schemas
List of schemas describing the contents of the BDII. The schemas are
not provided by the BDII system but supplied by other packages. This
file contains the pathnames of those external schema files.
Format: one pathname per line, each pointing to a schema file.
Typical content for the schemas file:
/etc/openldap/schema/core.schema
/opt/glue/schema/ldap/Glue-CORE.schema
/opt/glue/schema/ldap/Glue-CE.schema
/opt/glue/schema/ldap/Glue-SE.schema
/opt/glue/schema/ldap/Glue-CESEBIND.schema
/opt/lcg/schema/ldap/SiteInfo.schema
bdii-fwd.conf
File containing the target port number of the bdii-fwd port forwarding
service.
Format: a single integer between 1 - 65535, terminated by a newline.
Typical content: Written automatically by the bdii-update service.
Should not be set by the user.