Configuration

The configuration file is usually located at /etc/liveconfig/lcclient.conf or can be defined with the command line argument -c (or --config).

General Settings

base_path = BASE PATH

Set the base directory for relative file/path names in configuration file. If you use a relative path name (like eg. .) for base_path, then we use the location of the LiveConfig executable as start point.

license_file = LICENSEFILE

Specify the name of the license file. This file should only be readable by the user under which liveconfig runs. For more informations see liveconfig.key(5).

Default: /etc/liveconfig/liveconfig.key

log_file = LOGFILE

Specify the name of the logfile. That file (or the directory where the file has to be created) must be writeable by the user under which liveconfig runs. If a log file already exists, it must not be a special file (eg. symbolic link, pipe, …). When setting log_file to the value syslog, all log output is sent to the system logger syslog(3).

log_level = emerg | alert | crit | err | warning | notice | info | debug

Set the level when messages will be logged.

Default: info

pid_file = PIDFILE

Specify the name of the PID file. That file (or the directory where the file has to be created) must be writeable by the user under which lcclient runs. The PID file is used to store the process ID of the actual running lcclient process.

Default: /var/run/lcclient.pid

library_path = LIBRARY_PATH

Set the path name where LiveConfig’s additional libraries (eg. database drivers) are located.

libexec_path = LIBEXEC_PATH

Set the path name where LiveConfig’s scripts & utilities (eg. Lua scripts, logsplit utility) are located.

user = USER

Set the system user to switch to for all unprivileged operations (like querying system statistics, etc.). If not defined, the user id -1 will be used. The LiveConfig client must be started as root user in order to switch to a lesser privileged user. If started as non-root user, LiveConfig client will continue to run as that user.

group = GROUP

Set the system group to switch to for all unprivileged operations (see user). If not set, the default group of the user defined by the user option will be used.

proxy_http = URL

If this option is set, LiveConfig uses the defined proxy server for outbound HTTP(S) connections. The URL must have the format http://<server_name>.

LCCP Protocol Settings

The LiveConfig Client Protocol (LCCP) is used for communication between a LiveConfig server and a LiveConfig client.

The LCCP specific options are:

host_id = HOST_ID

Defines the unique identifier for this machine. You can use an IP address, the computer name or any character string with a maximum of 128 characters. Only ASCII characters are allowed (no umlauts), the name must not consist solely of numbers.

Important

If the host ID changes, the LiveConfig license must be reactivated and the host ID must be updated on the LiveConfig server.

server = ADDRESS[:PORT]

Specifies the address of the LiveConfig server to which the connection is to be established. A computer name, an IPv4 or an IPv6 address is allowed. A port number can optionally be specified. Examples of valid addresses are:

[2001:db8::1]:7888

connect to IPv6 address 2001:db8::1 on port 7888

192.168.0.10

connect to IPv4 address 192.168.0.10 on default port 788

my.host.domain:7888

connect to server my.host.domain to port 7888


Last updated on Jun 29, 2020.
next: License Activation
previous: CentOS/RHEL