自定义 Debian Linux 的代理安装

您可以通过使用命令选项来覆盖当前的安装配置值，或通过配置 debconf 数据库来自定义安装。

从命令行自定义

要从命令行配置安装，请使用以下形式的命令：

sudo <OPTION=value> dpkg  -i vmware-log-insight-agent-<version-and-build-number>_all.deb

有关完整的选项列表，请参见 Linux 上用于安装 vRealize Log Insight 代理的命令行选项。

以下示例显示了一些从命令行完成的典型配置。

指定一个目标 vRealize Log Insight服务器。

要在安装期间设置目标，请运行 sudo 命令，并将 hostname 替换为 vRealize Log Insight 服务器的 IP 地址或主机名，如以下示例中所示：

sudo SERVERHOST=hostname dpkg -iv mware-log-insight-agent-<version-and-build-number>_all.deb

除非您在安装期间启用了 --force-confold 标记，否则只要您更新到新版本，系统就会提示您保留或替换 liagent.ini 配置文件。将显示以下系统消息：

Configuration file `/var/lib/loginsight-agent/liagent.ini'
 ==> Modified (by you or by a script) since installation.
 ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer's version
    N or O  : keep your currently-installed version
      D     : show the differences between the versions
      Z     : start a shell to examine the situation
 The default action is to keep your current version.
*** liagent.ini (Y/I/N/O/D/Z) [default=N] ?

要保留现有配置，请使用 [default=N]。仍会应用从命令行中传递的其他参数。

配置连接协议。

要覆盖默认连接协议，请使用 SERVERPROTO 变量，如以下示例中所示：

sudo SERVERPROTO=syslog dpkg -i vmware-log-insight-agent-<version-and-build-number>_all.deb

配置连接端口。
要覆盖默认连接端口，请为安装程序提供 SERVERPORT 变量值，如以下示例中所示：
```
sudo SERVERPORT=1234 dpkg -i vmware-log-insight-agent-<version-and-build-number>_all.deb 
```
以非 root 用户身份运行代理。
要以非 root 用户身份运行 vRealize Log Insight Linux 代理，请运行 sudo 命令。
```
sudo LIAGENTUSER=liagent dpkg -i vmware-log-insight-agent-<version-build-number>_all.deb
```
如果指定的用户不存在，vRealize Log InsightLinux 代理会在安装期间创建用户帐户。创建的帐户在卸载后不会被删除。如果您使用 LIAGENTUSER=non_root_user 参数安装 Linux 代理并尝试使用 LIAGENTUSER=non_root_user2 参数进行升级，将会出现冲突，并且会显示警告，因为 non_root_user2 用户没有 non_root_user 用户的权限。

debconf 数据库的 DEB 软件包自定义选项

还可以通过 debconf 数据库来配置代理 DEB 软件包。下表显示了支持的 debconf 选项和相应的 vRealize Log Insight 代理 DEB 安装程序选项：


命令行选项	Debconf 选项	描述
SERVERHOST=`hostname`	vmware-log-insight-agent/serverhost	vRealize Log Insight 虚拟设备的 IP 地址或主机名。默认值为 `loginsight`。
SERVERPROTO={`cfapi`\|`syslog` }	vmware-log-insight-agent/serverproto	代理向 vRealize Log Insight 服务器发送日志事件所使用的协议。可能的值为 `cfapi`和 `syslog`。默认值为 cfapi。
SERVERPORT=`portnumber`	vmware-log-insight-agent/serverport	代理向 vRealize Log Insight 服务器或第三方服务器发送日志事件所使用的通信端口。默认情况下，代理根据为 SSL 和协议设置的选项使用相应的端口。请参见下面列表中提供的默认端口值。仅当端口选项与以下默认值不同时，您才需要指定端口选项。激活了 SSL 的 cfapi：9543 停用了 SSL 的 cfapi：9000 激活了 SSL 的 syslog：6514 停用了 SSL 的 syslog：514
LIAGENT_INITSYSTEM=`{init`\|`systemd`}	log-insight-agent/init_system	在安装期间，代理会自动检测安装该代理的计算机的初始化系统类型。您可以使用此选项指定系统类型值，以覆盖此行为。支持的初始化系统有以下两种类型：`init` 和 `systemd`。
LIAGENT_AUTOUPDATE=`{yes`\|`no`}	vmware-log-insight-agent/auto_update	激活或停用代理自动更新。您还必须从 vRealize Log Insight 服务器激活自动更新，才能完全激活自动更新。默认值为 yes。 Linux BIN 软件包不支持自动更新。
LI_AGENT_RUNSERVICES	vmware-log-insight-agent/init_system	默认情况下，在安装后，会立即启动 `liagentd`（代理）和 `liupdaterd`（更新程序）服务。可以将 LIAGENT_RUNSERVICES debconf 参数设置为 `no` 以禁止它们启动。默认值为 yes。只接受值 `yes` 和 `no`；不支持值 `1` 或 0。
LIAGENT_SSL	vmware-log-insight-agent/ssl	C
LIAGENTUSER=`user-account-name`	vmware-log-insight-agent/liagentuser	指定在其下运行代理的帐户。如果用户不存在，安装程序会创建该用户以作为常规用户。如果指定的用户帐户不存在，vRealize Log Insight Linux 代理会在安装期间创建该用户帐户。创建的帐户在卸载后不会被删除。默认情况下，代理在安装后会以 root 用户身份运行。如果您使用 `LIAGENTUSER=non_root_user` 参数安装代理并尝试使用 `LIAGENTUSER=non_root_user2` 进行升级，将会出现冲突，并且会显示警告，因为 `non_root_user2` 用户没有 `non_root_user` 用户的权限。创建的用户在卸载期间不会被移除。可以通过手动方式将其移除。此参数仅适用于代理服务。更新程序服务将始终以 root 用户身份运行。