Provided by: bdii4_4.0.2.2-2_all bug

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.