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 vRealize Log Insight sous Linux.

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

  • Spécifiez un serveur vRealize Log Insight 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 vRealize Log Insight 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 vRealize Log Insight 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 vRealize Log Insight 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 vRealize Log Insight :

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 vRealize Log Insight.

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 au serveur vRealize Log Insight. 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 au serveur vRealize Log Insightou 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

Active ou désactive la mise à jour automatique de l'agent. Vous devez également activer la mise à jour automatique à partir du serveur vRealize Log Insight pour activer 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 vRealize Log Insight 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.