File: section5

package info (click to toggle)
bdii4 4.0.2.2-2
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 284 kB
  • ctags: 33
  • sloc: sh: 804; perl: 715; makefile: 121
file content (182 lines) | stat: -rw-r--r-- 5,837 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
=head1 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.

=head1 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

=head1 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

=head1 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.

=cut