Centralised Logging Configuration

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.

Centralised Logging Setup

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.

Other Nodes Setup

Once the Log Server node has properly been initialised, on all other nodes, execute

# /opt/zextras/libexec/zmsyslogsetup  && service rsyslog restart