Anpassen Ihrer Agenteninstallation für Debian Linux

Sie können die Installation mithilfe von Befehlsoptionen anpassen und damit die aktuellen Konfigurationswerte für die Installation ändern oder die Debconf-Datenbank konfigurieren.

Anpassung über die Befehlszeile

Für die Konfiguration Ihrer Installation über die Befehlszeile verwenden Sie einen Befehl im folgenden Format:

sudo <OPTION=Wert> dpkg  -i vmware-log-insight-agent-<Versions-und-Build-Nummer>_all.deb

Eine vollständige Liste der Optionen finden Sie unter Befehlszeilenoptionen für die VMware Aria Operations for Logs-Agenten-Installation auf Linux.

Die folgenden Beispiele zeigen einige typische Konfigurationen über die Befehlszeile.

Geben Sie einen Ziel-VMware Aria Operations for Logs-Server an.
Um den Zielserver bei der Installation festzulegen, führen Sie den Befehl sudo aus, wobei Sie „hostname“ durch die IP-Adresse oder den Hostnamen des VMware Aria Operations for Logs-Servers ersetzen, wie im folgenden Beispiel dargestellt:
```
sudo SERVERHOST=hostname dpkg -iv mware-log-insight-agent-<Versions-und-Build-Nummer>_all.deb
```
Sofern Sie nicht das --force-confold-Flag während der Installation aktiviert haben, müssen Sie bei jeder Aktualisierung auf eine neuere Version wählen, ob Sie die Konfigurationsdatei liagent.ini beibehalten oder ersetzen. Die folgenden Systemmeldungen werden angezeigt:
```
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] ? 
```
Verwenden Sie zum Beibehalten der vorhandenen Konfiguration [Standard = N]. Die von der Befehlszeile übergebenen zusätzlichen Parameter werden nach wie vor angewandt.
Konfigurieren Sie das Verbindungsprotokoll.
Zum Überschreiben des Standardverbindungsprotokolls verwenden Sie die Variable SERVERPROTO, wie im folgenden Beispiel dargestellt:
```
sudo SERVERPROTO=syslog dpkg -i vmware-log-insight-agent-<Versions-und-Build-Nummer>_all.deb
				  
				
```
Konfigurieren Sie den Client-Verbindungsport.
Zum Überschreiben des Standardverbindungsports legen Sie einen Wert für die Variable SERVERPORT im Installationsprogramm wie im folgenden Beispiel dargestellt fest:
```
sudo SERVERPORT=1234 dpkg -i vmware-log-insight-agent-<Versions-und-Build-Nummer>_all.deb 
```
Führen Sie den Agenten als Nicht-Root-Benutzer aus.
Um den Linux-Agent für VMware Aria Operations for Logs als Nicht-Root-Benutzer auszuführen, verwenden Sie den Befehl sudo.
```
sudo LIAGENTUSER=liagent dpkg -i vmware-log-insight-agent-<Versions-Build-Nummer>_all.deb
```
Wenn der angegebene Benutzer nicht existiert, erstellt der Linux-Agent für VMware Aria Operations for Logs das entsprechende Benutzerkonto während der Installation. Das erstellte Konto wird nach der Deinstallation nicht gelöscht. Wenn Sie den Linux-Agent mit dem Parameter LIAGENTUSER=non_root_user installieren und versuchen, ein Upgrade mit dem Parameter LIAGENTUSER=non_root_user2 auszuführen, tritt ein Konflikt auf. Es werden Warnmeldungen angezeigt, da der Benutzer non_root_user2 nicht über die Berechtigungen des Benutzers non_root_user verfügt.

Anpassungsoptionen des DEB-Pakets für die Debconf-Datenbank

Das Agent-DEB-Paket kann auch über die Debconf-Datenbank konfiguriert werden. Die folgende Tabelle zeigt unterstützte Debconf-Optionen und entsprechende VMware Aria Operations for Logs Agent DEB-Installer-Optionen:


Befehlszeilenoptionen	Debconf-Optionen	Beschreibung
SERVERHOST=`Hostname`	vmware-log-insight-agent/serverhost	IP-Adresse oder Hostname der virtuellen VMware Aria Operations for Logs-Appliance. Die Standardeinstellung lautet `loginsight`.
SERVERPROTO={`cfapi`\|`syslog` }	vmware-log-insight-agent/serverproto	Protokoll, mit dem der Agent Protokollereignisse an den VMware Aria Operations for Logs-Server sendet. Die möglichen Werte lauten `cfapi` und `syslog`. Der Standardwert ist cfapi.
SERVERPORT=`Portnummer`	vmware-log-insight-agent/serverport	Kommunikationsport, den der Agent zum Senden von Protokollereignissen an den VMware Aria Operations for Logs-Server oder an Server von Drittanbietern verwendet. Standardmäßig verwendet der Agent den richtigen Port basierend auf den Optionen, die für SSL und das Protokoll festgelegt sind. Die Standardwerte für den Port finden Sie in der unten angegebenen Liste. Sie müssen die Port-Option nur angeben, wenn sie sich von diesen Standardeinstellungen unterscheidet. cfapi mit aktiviertem SSL: 9543 cfapi mit deaktiviertem SSL: 9000 Syslog mit aktiviertem SSL: 6514 Syslog mit deaktiviertem SSL: 514
LIAGENT_INITSYSTEM=`{init`\|`systemd`}	log-insight-agent/init_system	Während der Installation erkennt der Agent automatisch den Init-Systemtyp für die Maschine, auf der Sie den Agent installieren. Sie können dieses Verhalten außer Kraft setzen, indem Sie den Typ des Systemwerts mit dieser Option angeben. Es gibt zwei Arten von unterstützten Init-Systemen: `init` und `systemd`.
LIAGENT_AUTOUPDATE=`{yes`\|`no`}	vmware-log-insight-agent/auto_update	Aktivieren oder deaktivieren Sie die automatische Aktualisierung für den Agenten. Sie müssen auch die automatische Aktualisierung vom VMware Aria Operations for Logs-Server aktivieren, um die automatische Aktualisierung vollständig zu aktivieren. Die Standardeinstellung ist „yes“ (Ja). Die automatische Aktualisierung wird nicht für Linux-BIN-Pakete unterstützt.
LI_AGENT_RUNSERVICES	vmware-log-insight-agent/init_system	Sofort nach der Installation werden die Dienste `liagentd` (Agent) und `liupdaterd` (Updater) standardmäßig gestartet. Sie können deren Start verhindern, indem Sie den Parameter „LIAGENT_RUNSERVICES Debconf“ auf `no` (Nein) festlegen. Die Standardeinstellung ist „yes“ (Ja). Es werden nur die Werte `yes` und `no` akzeptiert. Die Werte `1` oder 0 werden nicht unterstützt.
LIAGENT_SSL	vmware-log-insight-agent/ssl	C
LIAGENTUSER=`Benutzername-Konto`	vmware-log-insight-agent/liagentuser	Gibt ein Konto an, unter dem der Agent ausgeführt wird. Wenn der Benutzer nicht existiert, erstellt sie das Installationsprogramm als normaler Benutzer. Wenn das angegebene Benutzerkonto nicht existiert, erstellt der Linux-Agent für VMware Aria Operations for Logs das entsprechende Benutzerkonto während der Installation. Das erstellte Konto wird nach der Deinstallation nicht gelöscht. Standardmäßig wird der Agent installiert, um als Root-Benutzer ausgeführt zu werden. Wenn Sie den Agent mit dem Parameter `LIAGENTUSER=non_root_user` installieren und versuchen, mit `LIAGENTUSER=non_root_user2` ein Upgrade auszuführen, kommt es zu einem Konflikt. Es werden dann entsprechende Warnungen angezeigt, da der Benutzer `non_root_user2` nicht über die Berechtigungen des Benutzers `non_root_user` verfügt. Der erstellte Benutzer wird während der Deinstallation nicht entfernt. Er kann manuell entfernt werden. Dieser Parameter ist nur für den Agent-Dienst bestimmt. Der Updater-Dienst wird immer als ein Root-Benutzer ausgeführt.