glite-lb-interlogd man page

glite-lb-interlogd — interlogger daemon

Synopsis

glite-lb-interlogd [options]

Description

glite-lb-interlogd takes over L&B events from glite-lb-logd and it is responsible for reliable transfer to their target storage - bookkeeping and logging servers. Interlogger maintains message queues for each target server and implements reliable handling in environment with possible communication failures.

On startup (and then periodically during operation) interlogger checks the event files (created by glite-lb-logd, see also the -f option), spawns a thread for each target server, and populates the queues with events read from the files. Then it starts listening for further incoming events on the UNIX socket (see the -s option).

The queue threads periodically attempt to contact the destination servers and to deliver the pending events.

Eventually, when all events from a file are delivered the file is removed after a certain timeout by a clean-up thread. Possible race conditions wrt. glite-lb-logd are prevented by locking the files appropriately.

Options

-b, --book
Send events only to bookkeeping server. This option has effect only if the logging server address is specified through the -l option. There is no implementation of logging server currently.
-c FILE, --cert FILE
Get certificate from FILE. This option overrides the $X509_USER_CERT environment variable.
-k FILE, --key FILE
Get server private key from FILE. This option overrides the $X509_USER_KEY environment variable.
-C DIR, --CAdir DIR
Look for trusted CA's certificates in DIR. This option overrides the $X509_CERT_DIR environment variable.
-d, --debug
Don't run as daemon (do not fork and put itself into background). Additional diagnostics are not enabled, they can be configured through log4c instead.
-i FILE, --pidfile FILE
Store process id into this file rather than default /var/run/glite/glite-lb-[notif|proxy]-interlogd.pid
-f PREFIX, --file-prefix PREFIX

PREFIX is path prefix of the event files.

For each job (jobid) a specific file is created that stores all events associated with this job. The job filename is constructed by stripping the protocol+server prefix from the jobid and appending the rest to this PREFIX.

PREFIX defaults to /var/spool/glite/lb-locallogger/dglogd.log, /var/spool/glite/lb-proxy/dglogd.log, or /var/spool/glite/lb-notif/dglogd.log.

On startup, interlogger checks all files matching the pattern PREFIX*.

The value has to be same as used in the cooperating glite-lb-logd (or glite-lb-bkserverd for proxy).

-k FILE, --key FILE
Get private key from FILE. This option overrides the $X509_USER_KEY environment variable.
-l HOST, --log-server HOST
Use HOST as address of logging server. As the logging is not implemented yet this option should not be used.
-s PATH, --socket PATH
Listen for events sent by glite-lb-logd at the UNIX socket PATH.
-V, --version
Print version and exit.
-L TIMEOUT, --lazy TIMEOUT
Be lazy when closing connections to servers (default, TIMEOUT ==0 means turn lazy off).
-h, --help
Print help and exit.

Files

/var/run/glite-lb-*.sock
Default name of local socket for logger, notification logger and proxy logger.
/var/spool/glite/lb-*/dglogd.log*
Default locations of event files.
/var/spool/glite/lb-*/dglogd.log*.ctl
Interlogger's control files keeping the information on status of the corresponding event file wrt. delivery to the target server.

No configuration files needed.

Environment

X509_USER_KEY
If $X509_USER_KEY is set, it is used to locate private key file.
X509_USER_CERT
If $X509_USER_CERT is set, it is used to locate certificate file.
X509_CERT_DIR
If $X509_CERT_DIR is set, it is used to locate the trusted CA's certificates and ca-signing-policy files.
X509_USER_PROXY
If $X509USER_PROXY is set, it is used to locate proxy certificate file.

Bugs

Please report all bugs to CESNET gLite L&B issue tracker available at https://github.com/CESNET/glite-lb/issu…

See Also

glite-lb-bkserverd(8), glite-lb-logd(8), glite-lb-logevent(1),

Author

EU EGEE, JRA1.

Referenced By

glite-lb-bkserverd(8), glite-lb-dump(1), glite-lb-logd(8), glite-lb-logevent(1), glite-lb-notify(1), glite-lb-purge(1), glite-lb-setup(8).

April 2008 EU EGEE Project Logging&Bookkeeping