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
|
.\" Man page generated from reStructeredText.
.
.TH LOGCENTRAL 1 "2011-05-11" "0.1" ""
.SH NAME
LogCentral \- Central logging service for distributed applications
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH NAME
.sp
LogCentral \- service using the publisher/subscriber model, where
components publish tagged messages and tools get back appropriate messages .
.SH SYNOPSYS
.INDENT 0.0
.INDENT 3.5
.sp
LogCentral [options] ...
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
LogCentral gathers and publishes the messages to the subscribers.
Messages are tagged, the LogCentral service only sends suscribers
filtered messages.
.sp
Before starting the LogCentral, you must:
.INDENT 0.0
.IP \(bu 2
.
launch a CORBA Naming Service.
.IP \(bu 2
.
launch log forwarders \fIif needed\fP
.IP \(bu 2
.
launch LogCentral service
.UNINDENT
.sp
[Remark: LogCentral must be launched before the log tools/components]
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-config\fP [name]
.sp
The configuration file for the LogCentral service.
First, LogCentral will use the file provided by command\-line, then read environment
variable $LOGCENTRAL_CONFIG and in last resort, it will look for a file named "config.cfg"
in current directory.
.UNINDENT
.SH CONFIGURATION FILE
.sp
You can pass a configuration file to LogCentral using command line
options through the \-config option. Configuration file lists several classes of
tags describing the messages. A minimal configuration will look like this:
.sp
[General]
.sp
[DynamicTagList]
[StaticTagList]
[UniqueTagList]
[VolatileTagList]
.sp
The general tag accept the following parameters:
* \(aqport=xxx\(aq, specifies the port to use
.INDENT 0.0
.IP \(bu 2
.
\(aqMinAge=xxx\(aq, defines the minimum period of time that messages will be stored in the LogCentral
.IP \(bu 2
.
\(aqDynamicStartSuffix=START\(aq, expands tags with START. See DynamicTagList.
.IP \(bu 2
.
\(aqDynamicStopSuffix=STOP\(aq, expands tags with STOP. See DynamicTagList.
.UNINDENT
.sp
The other four categories configure the state manager of the LogCentral. It is
important to know that all tags will be expanded with two suffixes to generate
pairs of tags.
.INDENT 0.0
.IP \(bu 2
.
VolatileTagList, should contain all the monitored tags. Not essential but it may be requested by some tool.
.IP \(bu 2
.
UniqueTagList, should contain tags that will overwrite the previous messages of this tag
.UNINDENT
.SH EXAMPLE
.INDENT 0.0
.IP \(bu 2
.
Launching the LogCentral
.UNINDENT
.sp
.nf
.ft C
LogCentral \-config ./LogCentral.cfg
.ft P
.fi
.SH RATIONALE
.sp
The LogCentral uses CORBA as its communication layer. While it\(aqs a flexible and
robust middleware, its deployement on heterogeneous networks still is delicate
and may require using ssh tunnels.
.SH LICENSE AND COPYRIGHT
.SS Copyright
.sp
(C)2011, GRAAL, INRIA Rhone\-Alpes, 46 allee d\(aqItalie, 69364 Lyon
cedex 07, France all right reserved <\fI\%diet\-dev@ens\-lyon.fr\fP>
.SS License
.sp
This program is free software: you can redistribute it and/or mod‐
ify it under the terms of the GNU General Public License as pub‐
lished by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version. This program is
distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Pub\- lic Li‐
cense for more details. You should have received a copy of the GNU
General Public License along with this program. If not, see
<\fI\%http://www.gnu.org/licenses/\fP>.
.SH AUTHORS
.sp
GRAAL
INRIA Rhone\-Alpes
46 allee d\(aqItalie 69364 Lyon cedex 07, FRANCE
Email: <\fI\%diet\-dev@ens\-lyon.fr\fP>
WWW: \fI\%http://graal.ens\-lyon.fr/DIET\fP
.SH SEE ALSO
.sp
omniNames(1), logForwarder(1)
.SH BUGS
.SH AUTHOR
haikel.guemar@sysfera.com, kevin.coulomb@sysfera.com
License: GPLv3
.SH COPYRIGHT
DIET developers
.\" Generated by docutils manpage writer.
.\"
.
|
