When you install vRealize Log Insight agents from the command line, you can include options to configure your deployment during installation. These options correspond to settings in the liagent.ini file.

Common Linux Agent Options

The following options can be used during installation to configure vRealize Log Insight Linux agents.

Table 1. Installation Options for Linux Agents

Option

Description

SERVERHOST=hostname

IP address or host name of the vRealize Log Insight virtual appliance.

The default is loginsight.

SERVERPROTO={cfapi|syslog}

Protocol that the agent uses to send events to the vRealize Log Insight server. The possible values are cfapi and syslog.

The default is cfapi.

SERVERPORT=portnumber

Communication port that the agent uses to send events to the vRealize Log Insight or third party server. By default the agent uses the appropriate port based on the options that are set for SSL and the protocol. See default port values provided in the list below. You need to specify the port option only if it's different from these defaults.

LIAGENT_INITSYSTEM={init|systemd}

During install time, the agent automatically detects the type of init system for the machine you are installing the agent on. You can override this behavior by specifying the type of system value with this option. There are two types of supported init systems: init and systemd.

LIAGENT_AUTOUPDATE={yes|no}

Enable or disable auto-update for the agent. You must also enable auto-update from the vRealize Log Insight server to fully enable auto-update. The default is yes.

Auto-update is not supported for Linux BIN packages.

LIAGENT_SSL={yes|no}

Enable secure connection. If SSL is enabled, the agent uses TLS 1.2 protocol to communicate to the server. The default is yes.

LIAGENTUSER=user-account-name

Specifies an account under which the agent is run. If the user does not exist, the installer creates it as a regular user. If the specified user account does not exist, the vRealize Log Insight Linux agent creates the user account during the installation. The created account is not deleted after uninstallation.

By default the agent is installed to run as a root user.

Note that if you install the vRealize Log Insight Linux agent with the LIAGENTUSER=non_root_user parameter and try to upgrade with LIAGENTUSER=non_root_user2, a conflict occurs and warnings appear because non_root_user2 user does not have the permissions of the user non_root_user

The created user is not removed during uninstall. It can be removed manually. This parameter is intended for the agent service only. The updater service is always running as a root user.