The configuration file is usually located at /etc/liveconfig/lcclient.conf
or can be defined with the command line argument -c
(or --config
).
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>
.
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:
|
connect to IPv6 address |
|
connect to IPv4 address |
|
connect to server |