glite-lb-interlogd(8)

1GLITE-LB-INTERLOGD(8)         Logging&Bookkeeping        GLITE-LB-INTERLOGD(8)
2
3
4

NAME

6       glite-lb-interlogd - interlogger daemon
7
8

SYNOPSIS

10       glite-lb-interlogd [options]
11
12

DESCRIPTION

14       glite-lb-interlogd  takes  over L&B events from glite-lb-logd and it is
15       responsible for reliable transfer to their target storage - bookkeeping
16       and  logging  servers.   Interlogger  maintains message queues for each
17       target server and implements reliable handling in environment with pos‐
18       sible communication failures.
19
20       On  startup (and then periodically during operation) interlogger checks
21       the event files (created by glite-lb-logd, see  also  the  -f  option),
22       spawns  a  thread for each target server, and populates the queues with
23       events read from the files.   Then  it  starts  listening  for  further
24       incoming events on the UNIX socket (see the -s option).
25
26       The  queue  threads  periodically  attempt  to  contact the destination
27       servers and to deliver the pending events.
28
29       Eventually, when all events from a  file  are  delivered  the  file  is
30       removed  after  a  certain timeout by a clean-up thread.  Possible race
31       conditions wrt. glite-lb-logd are prevented by locking the files appro‐
32       priately.
33
34

OPTIONS

36       -b, --book
37              Send  events  only to bookkeeping server. This option has effect
38              only if the logging server address is specified through  the  -l
39              option. There is no implementation of logging server currently.
40
41
42       -c FILE, --cert FILE
43              Get   certificate   from   FILE.    This  option  overrides  the
44              $X509_USER_CERT environment variable.
45
46
47       -k FILE, --key FILE
48              Get server private key from FILE.   This  option  overrides  the
49              $X509_USER_KEY environment variable.
50
51
52       -C DIR, --CAdir DIR
53              Look  for  trusted  CA's certificates in DIR.  This option over‐
54              rides the $X509_CERT_DIR environment variable.
55
56
57       -d, --debug
58              Don't run as daemon (do not  fork  and  put  itself  into  back‐
59              ground).  Additional  diagnostics  are  not enabled, they can be
60              configured through log4c instead.
61
62
63       -i FILE, --pidfile FILE
64              Store  process  id  into   this   file   rather   than   default
65              /var/run/glite/glite-lb-[notif|proxy]-interlogd.pid
66
67
68       -f PREFIX, --file-prefix PREFIX
69              PREFIX is path prefix of the event files.
70
71              For  each job (jobid) a specific file is created that stores all
72              events associated with this  job.   The  job  filename  is  con‐
73              structed  by stripping the protocol+server prefix from the jobid
74              and appending the rest to this PREFIX.
75
76              PREFIX defaults  to  /var/spool/glite/lb-locallogger/dglogd.log,
77              /var/spool/glite/lb-proxy/dglogd.log,   or  /var/spool/glite/lb-
78              notif/dglogd.log.
79
80              On startup, interlogger checks all files  matching  the  pattern
81              PREFIX*.
82
83              The  value  has  to be same as used in the cooperating glite-lb-
84              logd (or glite-lb-bkserverd for proxy).
85
86
87       -k FILE, --key FILE
88              Get  private  key  from  FILE.   This   option   overrides   the
89              $X509_USER_KEY environment variable.
90
91
92       -l HOST, --log-server HOST
93              Use  HOST  as  address of logging server.  As the logging is not
94              implemented yet this option should not be used.
95
96
97       -s PATH, --socket PATH
98              Listen for events sent by glite-lb-logd at the UNIX socket PATH.
99
100
101       -V, --version
102              Print version and exit.
103
104
105       -L TIMEOUT, --lazy TIMEOUT
106              Be lazy when closing connections to  servers  (default,  TIMEOUT
107              ==0 means turn lazy off).
108
109
110       -h, --help
111              Print help and exit.
112
113
114

FILES

116       /var/run/glite-lb-*.sock
117              Default name of local socket for logger, notification logger and
118              proxy logger.
119
120       /var/spool/glite/lb-*/dglogd.log*
121              Default locations of event files.
122
123       /var/spool/glite/lb-*/dglogd.log*.ctl
124              Interlogger's control files keeping the information on status of
125              the corresponding event file wrt. delivery to the target server.
126
127
128       No configuration files needed.
129
130

ENVIRONMENT

132       X509_USER_KEY
133              If $X509_USER_KEY is set, it is used to locate private key file.
134
135
136       X509_USER_CERT
137              If  $X509_USER_CERT  is  set,  it  is used to locate certificate
138              file.
139
140
141       X509_CERT_DIR
142              If $X509_CERT_DIR is set, it is used to locate the trusted  CA's
143              certificates and ca-signing-policy files.
144
145
146       X509_USER_PROXY
147              If  $X509USER_PROXY  is set, it is used to locate proxy certifi‐
148              cate file.
149
150

BUGS

152       Please report all bugs to CESNET gLite L&B issue tracker  available  at
153       https://github.com/CESNET/glite-lb/issues
154
155

AUTHOR

161       EU EGEE, JRA1.
162
163
164
165EU EGEE Project                   April 2008             GLITE-LB-INTERLOGD(8)