Centralised Logging Configuration#
The log system in Carbonio is rsyslog, which supports a
centralised setup: in other words, all log files produced by
Carbonio can be sent to a unique host server (we call it “Log
Server”), that is appropriately configured to receive log files,
which is particularly useful in a Multi-Server installation.
The Log Server can be one of the Nodes on which Carbonio is installed, or a dedicated Node, either within the Carbonio infrastructure or an existing, company-wide server that already exists.
In this scenario, we configure a log Server on Node 1 within the
Carbonio infrastructure, and we use srv1.example.com as FQDN.
On srv1.example.com, open file /etc/rsyslog.conf,
find the following lines, and uncomment them (i.e., remove the
# character at the beginning of the line):
# Provides UDP syslog reception
module(load="imudp")
input(type="imudp" port="514")
# Provides TCP syslog reception
module(load="imtcp")
input(type="imtcp" port="514")
Then, restart the rsyslog service.
# systemctl restart rsyslog
Finally, specify the host server that will receive logs: we already
called it srv1.example.com, so use this hostname.
zextras$ carbonio prov mcf zimbraLogHostname srv1.example.com
Note
Since zimbraLogHostname is a global attribute, this
command must be run only once on one node.
Once the Log Server node has properly been initialised, on all other nodes, execute
# /opt/zextras/libexec/zmsyslogsetup && service rsyslog restart