1GLITE-LB-BKSERVERD(8) Logging&Bookkeeping GLITE-LB-BKSERVERD(8)
2
6 glite-lb-bkserverd - bookkeeping server daemon
7
10 glite-lb-bkserverd [options]
11
14 glite-lb-bkserverd accepts L&B events from interlogger, manages the
15 data storage, and serves user queries (L&B consumer clients).
16 Currently, the data are stored in MySQL database.
18 The main process spawns several slave processes. Then it listens on
21 port (default value is 9000) for consumer queries and port+1 for inter‐
22 logger daemon requests to store events to database. Requests are redi‐
23 rected to the slaves (and picked up by the first free slave process).
24 All the connection handling and data processing (including SSL hand‐
25 shake) is performed by the slaves.
26 The slaves voluntarily die and are resurrected periodically to work‐
28 around potential resource leakage.
29
33 -a HOST:PORT, --address HOST:PORT
34 Make the server pretend (wrt. data handling) it listens on
35 HOST:PORT instead of the real listening address. This is used
36 for debugging and various administrative purposes (e.g. comput‐
37 ing usage statistics on data dumped from another server).
38 -c FILE, --cert FILE
41 Get certificate from FILE. This option overrides the
42 $X509_USER_CERT environment variable.
43 -b SWITCH, --transactions SWITCH
46 Set transaction on/off. SWITCH is true where its value is not
47 0.
48 -C DIR, --CAdir DIR
51 Trusted CA's certificates directory. DIR. This option over‐
52 rides the $X509_CERT_DIR environment variable.
53 -V DIR, --VOMSdir DIR
56 Trusted VOMS server's certificates directory. DIR. This option
57 overrides the $X509_VOMS_DIR environment variable.
58 -d, --debug
61 Don't run as daemon. Additional diagnostics are not enabled,
62 they can be configured through log4c instead.
63 -r, --rgmaexport
66 Write state info to RGMA interface.
67 -i FILE, --pidfile FILE
70 Store master pid into FILE instead of the default pidfile loca‐
71 tion. Unless unavoidable it is not recommended to change the
72 pidfile location as it is also used for locking to prevent
73 starting up multiple server instances and to generate the sema‐
74 phore set unique key (see option -l).
75 -k FILE, --key FILE
79 Get private key from FILE. This option overrides the
80 $X509_USER_KEY environment variable.
81 -l NUM, --semaphores NUM
84 Use NUM semaphores (job locks).
85 To prevent race conditions on simultaneous event storage and
87 job-state updates glite-lb-bkserverd uses a set of semaphores to
88 lock jobs. Jobids are hashed to the semaphores and only one of
89 the set of jobs that map to a particular semaphore may be
90 updated at any given time. Therefore NUM is a limit on poten‐
91 tial processing parallelism.
92 NUM defaults to the number of slaves (see -s).
94 -L NUM:NUM:NUM, --limits NUM:NUM:NUM
98 Limit the maximum number of returned jobs/events that match user
99 query to NUM:NUM:NUM in format
100 events_limit:jobs_limit:size_limit.
101 -N NUM, --notif-dur NUM
103 Maximal duration of notification registrations in hours NUM.
104 -S PREFIX, --purge-prefix PREFIX
107 Purge files full-path prefix PREFIX.
108 -D PREFIX, --dump-prefix PREFIX
111 Dump files full-path prefix PREFIX.
112 -J DIR, --jpreg-dir DIR
115 JP registration temporary files prefix (implies '-j'). DIR.
116 -j , --enable-jpreg-export
119 Enable JP registration export (disabled by default).
120 -m STRING, --mysql STRING
123 STRING is a database connect string in the form
124 USER_NAME/PASSWORD@DB_HOSTNAME:DB_NAME
126 It defaults to lbserver/@localhost:lbserver20.
128 -n, --noauth
131 Turn off any authorization.
132 -p NUM, --port NUM
135 Listen on the port NUM.
136 -w NUM, --wsport NUM
139 Set port to serve the web services requests to NUM.
140 -r, --rgmaexport
143 Write state info into the RGMA interface. Experimental.
144 -s NUM, --slaves NUM
147 Fork NUM slaves.
148 --super-user USER, --super-user-file FILE
151 Bypass query authorization (i.e. return results anyway) when
152 USER (or users listed in FILE) connect.
153 --no-index NUM
156 Disable checking the indices for superusers (NUM=1) or entirely
157 (NUM=2).
158 --strict-locking
161 (not recommended). Use a more strict locking strategy -- lock
162 jobs sooner, when events are stored, not just for status update.
163 This prevents a non-probable but still possible race condition
164 with parallel purge but may slow down processing on heavy loaded
165 servers. Anyway, the only consequence of the race condition is a
166 little garbage left in the database which is cleaned form time
167 to time anyway.
168 --notif-il-sock SOCK
171 Socket SOCK to send notifications.
172 --notif-il-sock PREFIX
175 File PREFIX for notifications.
176 --count-statistics NUM
179 Count certain statistics on jobs for superusers (NUM=1) or for
180 all (NUM=2).
181 -t NUM, --request-timeout NUM
184 Request timeout NUM for one client.
185 --silent
188 Do not print diagnostic, even if -d is on.
189 -g--greyjobs
192 Allow delayed registration (grey jobs), implies --strict-lock‐
193 ing.
194 -A,--enable-lcas
197 Activate LCAS-based authorization.
198 -I,--rss-time NUM
201 Set the maximal age (in seconds) of states published via RSS.
202 -P,--proxyonly
205 Run only proxy service.
206 -B,--withproxy
209 Run both server and proxy service.
210 -o,--sock
213 Path-name to the local socket for communication with LB proxy.
214 -q,--con-queue
217 Size of the connection queue (accept).
218 -W,--proxy-il-sock
221 Socket to send events to.
222 -Z,--proxy-il-fprefix
225 File prefix for events.
226 -G,--proxy-purge
229 Enable automatic purging of the jobs in terminal state for proxy
230 service (disabled by default, purging cron job installed by
231 YAIM).
232 -E,--exclusive-zombies-off
235 Disable checking of purged jobs when registering jobs with the
236 EDG_WLL_LOGLFLAG_EXCL flag set.
237
241 /var/run/edg-bkserverd.pid
242 if running as root (not recommended).
243 $HOME/edg-bkserverd.pid
246 otherwise.
247 File to store pid and to generate semaphores key.
250 No configuration files needed.
253
256 X509_USER_KEY
257 If $X509_USER_KEY is set, it is used to locate private key file.
258 X509_USER_CERT
261 If $X509_USER_CERT is set, it is used to locate certificate
262 file.
263 X509_CERT_DIR
266 If $X509_CERT_DIR is set, it is used to locate the trusted CA's
267 certificates and ca-signing-policy files.
268 X509_USER_PROXY
271 If $X509USER_PROXY is set, it is used to locate proxy certifi‐
272 cate file.
273 EDG_WL_RGMA_FILE
276 If $EDG_WL_RGMA_FILE is set, it is used as name of file for
277 sharing data with RGMA services.
278 EDG_WL_RGMA_SOCK
281 If $EDG_WL_RGMA_SOCK is set, it is used as name of socket for
282 communication with RGMA.
283
286 In a case of a sudden crash, alive slave processes may survive or some
287 resources (IPC locks, open ports) may stay allocated. Please, deal with
288 such problems via standard commands kill and ipcrm.
289 Please report all bugs to CESNET gLite L&B issue tracker available at
291 https://github.com/CESNET/glite-lb/issues
292
295 glite-lb-bkindex(8), glite-lb-purge(1), glite-lb-interlogd(8), glite-
296 lb-logd(8), glite-lb-logevent(1),
297
300 EU EGEE, JRA1.
301EU EGEE Project April 2008 GLITE-LB-BKSERVERD(8)