Personnalisation de votre installation de l'agent pour Linux Debian

Vous pouvez personnaliser votre installation en utilisant des options de commande pour remplacer les valeurs de configuration actuelles pour l'installation ou en configurant la base de données debconf.

Personnalisation à partir de la ligne de commande

Pour configurer votre installation à partir de la ligne de commande, utilisez une commande au format suivant :

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

Pour obtenir la liste complète des options, reportez-vous à la section Options de ligne de commande pour l'installation de l'agent VMware Aria Operations for Logs sous Linux.

Les exemples suivants montrent quelques configurations classiques faites à partir de la ligne de commande.

Spécifiez un serveur VMware Aria Operations for Logs cible.
Pour définir le serveur cible pendant l'installation, exécutez la commande sudo et remplacez hostname par l'adresse IP ou le nom d'hôte du serveur VMware Aria Operations for Logs comme indiqué dans l'exemple suivant :
```
sudo SERVERHOST=hostname dpkg -iv mware-log-insight-agent-<version-and-build-number>_all.deb
```
Si vous n'avez pas activé l'indicateur --force-confold au cours de l'installation, le système vous invite à conserver ou à remplacer le fichier de configuration liagent.ini à chaque fois que vous effectuez une mise à jour vers une version plus récente. Le message système suivant s'affiche :
```
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] ? 
```
Pour conserver la configuration existante, utilisez [default=N] . Les paramètres supplémentaires issus de la ligne de commande sont toujours appliqués.
Configurer le protocole de connexion.
Pour remplacer le protocole de connexion par défaut, utilisez la variable SERVERPROTO comme indiqué dans l'exemple suivant :
```
sudo SERVERPROTO=syslog dpkg -i vmware-log-insight-agent-<version-and-build-number>_all.deb
				  
				
```
Configurez le port de connexion.
Pour remplacer le port de connexion par défaut, fournissez une valeur pour la variable SERVERPORT au programme d'installation comme indiqué dans l'exemple suivant :
```
sudo SERVERPORT=1234 dpkg -i vmware-log-insight-agent-<version-and-build-number>_all.deb 
```
Exécutez l'agent en tant qu'utilisateur non racine.
Pour exécuter l'agent Linux VMware Aria Operations for Logs en tant qu'utilisateur non racine, exécutez la commande sudo.
```
sudo LIAGENTUSER=liagent dpkg -i vmware-log-insight-agent-<version-build-number>_all.deb
```
Si l'utilisateur spécifié n'existe pas, l'agent Linux VMware Aria Operations for Logs crée le compte utilisateur pendant l'installation. Le compte créé n'est pas supprimé après la désinstallation. Si vous installez l'agent Linux avec le paramètre LIAGENTUSER=non_root_user et que vous tentez d'effectuer une mise à niveau à l'aide du paramètre LIAGENTUSER=non_root_user2, un conflit se produit. Des avertissements s'affichent, car l'utilisateur non_root_user2 ne dispose pas des autorisations de l'utilisateur non_root_user.

Options de personnalisation de module DEB pour la base de données debconf

Le module DEB de l'agent peut également être configuré via la base de données debconf. Le tableau suivant présente les options debconf prises en charge et celles correspondantes du programme d'installation DEB de l'agent VMware Aria Operations for Logs :


Options de ligne de commande	Options Debconf	Description
SERVERHOST=`hostname`	vmware-log-insight-agent/serverhost	Adresse IP ou nom d'hôte du dispositif virtuel VMware Aria Operations for Logs. La valeur par défaut est `loginsight`.
SERVERPROTO={`cfapi`\|`syslog` }	vmware-log-insight-agent/serverproto	Protocole que l'agent utilise pour envoyer des événements de journaux au serveur VMware Aria Operations for Logs. Les valeurs possibles sont `cfapi` et `syslog`. La valeur par défaut est cfapi.
SERVERPORT=`portnumber`	vmware-log-insight-agent/serverport	Port de communication utilisé par l'agent pour envoyer des événements de journaux au serveur VMware Aria Operations for Logs ou tiers. Par défaut, l'agent utilise le port adéquat en fonction des options qui sont définies pour SSL et le protocole. Consultez les valeurs de port par défaut mentionnées dans la liste ci-dessous. Vous devez uniquement spécifier l'option de port si elle est différente de ces valeurs par défaut. cfapi avec SSL activé : 9543 cfapi avec SSL désactivé : 9000 Syslog avec SSL activé : 6514 Syslog avec SSL désactivé : 514
LIAGENT_INITSYSTEM=`{init`\|`systemd`}	log-insight-agent/init_system	Au moment de l'installation, l'agent détecte automatiquement le type de système de la machine sur laquelle vous installez l'agent. Vous pouvez remplacer ce comportement en spécifiant le type de valeur système avec cette option. Il existe deux types de systèmes init pris en charge : `init` et `systemd`.
LIAGENT_AUTOUPDATE=`{yes`\|`no`}	vmware-log-insight-agent/auto_update	Activez ou désactivez la mise à jour automatique pour l'agent. Vous devez également activer la mise à jour automatique à partir du serveur VMware Aria Operations for Logs pour activer entièrement la mise à jour automatique. La valeur par défaut est Yes. La mise à jour automatique n'est pas prise en charge pour les modules binaires Linux.
LI_AGENT_RUNSERVICES	vmware-log-insight-agent/init_system	Immédiatement après l'installation, les services `liagentd` (agent) et `liupdaterd` (mise à jour) sont démarrés par défaut. Vous pouvez empêcher leur démarrage en définissant le paramètre debconf LIAGENT_RUNSERVICES sur `no`. La valeur par défaut est yes. Les seules valeurs acceptées sont `yes` et `no` ; les valeurs `1` et 0 ne sont pas prises en charge.
LIAGENT_SSL	vmware-log-insight-agent/ssl	C
LIAGENTUSER=`user-account-name`	vmware-log-insight-agent/liagentuser	Indique un compte sous lequel l'agent est exécuté. Si l'utilisateur n'existe pas, le programme d'installation crée un utilisateur normal. Si le compte d'utilisateur spécifié n'existe pas, l'agent Linux VMware Aria Operations for Logs crée le compte utilisateur pendant l'installation. Le compte créé n'est pas supprimé après la désinstallation. Par défaut, l'agent est configuré pour s'exécuter en tant qu'utilisateur racine. Si vous installez l'agent avec le paramètre `LIAGENTUSER=non_root_user` et que vous tentez d'effectuer une mise à niveau avec `LIAGENTUSER=non_root_user2`, un conflit survient. Des avertissements s'affichent, car l'utilisateur `non_root_user2` ne dispose pas des autorisations de l'utilisateur `non_root_user`. L'utilisateur créé n'est pas supprimé durant la désinstallation. Il peut être supprimé manuellement. Ce paramètre est destiné au service d'agent uniquement. Le service de mise à jour s'exécute toujours en tant qu'utilisateur racine.