glite-lb-interlogd (8) - Linux Manuals

glite-lb-interlogd: interlogger daemon

NAME

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/issues

AUTHOR

EU EGEE, JRA1.