Installieren bzw. Deinstallieren eines Agenten mithilfe eines Skripts auf einer Windows-Plattform

Sie können einen Agenten auf einer Endpunkt-VM mithilfe eines Skripts installieren.

Voraussetzungen

• Die Endpunkt-VM muss in VMware Aria Operations verfügbar sein.
• Machen Sie alle erforderlichen Angaben. Weitere Informationen finden Sie unter Vorbedingungen.
• Das Paket zum Extrahieren muss auf der Endpunkt-VM verfügbar sein.
• Der Benutzer muss über Zugriffsberechtigungen für den Download-Ordner verfügen.
• Die Windows PowerShell-Version muss 5.0 oder höher sein.
• Die Gast-IP muss ordnungsgemäß konfiguriert sein und ist über vCenter Server hinweg eindeutig. Wenn mehr als eine Endpunkt-VM mit derselben IP über vCenter Server hinweg überwacht wird, kann das Skript nicht aufgelöst und die Anwendungsüberwachung nicht abonniert werden.
• Das Cloud-Konto muss für den vCenter Server konfiguriert werden, zu dem die Endpunkt-VM gehört.
• Die Endpunkt-VM muss über Zugriff auf Port 443 in VMware Aria Operations verfügen.
• Der VMware Aria Operations-Benutzer muss über folgende Berechtigungen verfügen:
  • Verwaltung > REST-APIs > Alle anderen Lese- und Schreib-APIs
  • Verwaltung > REST-APIs > Lesezugriff für APIs
  • Umgebung > Anwendungen > Telegraf-Agenten verwalten
  • Umgebung > Aktionen > Virtuelle Maschinen laden
  • Umgebung > Aktionen > Bootstrap herunterladen
  Hinweis: Navigieren Sie zum Überprüfen von Berechtigungen zu Verwaltung > Zugriffssteuerung > Rollen und wählen Sie die Rolle aus, der der Benutzer zugewiesen ist. Sie können die Berechtigungen auf der rechten Seite am Seitenende anzeigen.
• Derzeit wird nur IPv4 für Cloud-Proxy unterstützt.
• Die VMTools-Version muss 10.2 oder höher sein.

Prozedur

1. Melden Sie sich bei der Endpunkt-VM an und auf der Sie den Agenten installieren/deinstallieren möchten und laden Sie das Beispielskript aus dem Cloud-Proxy von folgendem Speicherort herunter: https://<CloudProxy>/downloads/salt/ telegraf-utils.ps1

   Wenn das Herunterladen des Skripts mit der folgenden Meldung fehlschlägt: Die Anforderung wurde abgebrochen: Sicherer SSL/TLS-Kanal konnte nicht erstellt werden, führen Sie die in Skript-Download schlägt auf einer Windows-Plattform fehl beschriebenen Schritte aus.

   Führen Sie einen der folgenden Befehle aus:

   PowerShell command:
   Invoke-WebRequest "https://<CloudProxy>/downloads/salt/telegraf-utils.ps1 " -OutFile telegraf-utils.ps1
   
   Or if you have the wget tool:
   wget --no-check-certificate https://<CloudProxy>/downloads/salt/telegraf-utils.ps1

   Hinweis: Verwenden Sie die IP-Adresse des entsprechenden Cloud-Proxys für <CloudProxy> in den angegebenen vorhergehenden Befehlen und Speicherorten. Geben Sie für Anwendungsüberwachungs-HA aktivierte Collector-Gruppen die virtuelle IP-Adresse an.
2. Führen Sie den folgenden Befehl aus, um das Skript auszuführen und den Agenten zu installieren/deinstallieren:

   telegraf-utils.ps1  product-managed -c cloud_proxy_ip_or_collector_group_name -t token (-v vmwareariaoperations_ip_or_fqdn | [-g gateway_url -a csp_auth_url]) [-d download_tmp_dir -s sleep_seconds -i list_of_IPs -o operation]
       
   Description of arguments:
         -c : [REQUIRED] cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP or Collector Group Name
         -t : [REQUIRED] token - This can be user_saas_refresh_token or on-prem vmwareariaoperations_auth_token.
               
               on-prem: Auth Token of the user/account. For getting new token
                        ( https://<VMwareAriaOperations_IP>/suite-api/ or curl -ks -X POST https://<VMwareAriaOperations_IP>/suite-api/api/auth/token/acquire -H \"Content-Type: application/json\" -H \"Accept: application/json\" -d \"{\"username\":\"<VMwareAriaOperations_USER>\",\"password\":\"<VMwareAriaOperations_USER_PASSWORD>\"}\")
         -d : [OPTIONAL] download_tmp_dir - Temporary directory for agent installation. Default: current directory
         -v : [CONDITIONAL] [ON-PREM-SPECIFIC] vmwareariaoperations_ip_or_fqdn - IP/FQDN of VMware Aria Operations master node and required for on-prem.
         
         -o : [OPTIONAL] operation - The type of operation to be performed {install,uninstall} Default: install
         -s : [OPTIONAL] sleep_seconds - Time (in seconds) to delay the script execution. This optional parameter will be helpful when this script is used in vRA to have agent installed on deploying VM. Recommended time 600 seconds.
         -i : [OPTIONAL] list_of_IPs - This is an optional parameter. Comma separated IPs that are set as properties of a VM in VMware Aria Operations (VM -> Properties -> Network -> <Integer> -> IP Address). If single adapter has multiple IP Addresses, then delimit them using '_'
                       ex:- If your VM has 3 adapters with IP Address as follows: Adapter1: 10.0.0.1 Adapter2: 10.0.0.2 & 10.0.0.3 Adapter3: 10.0.0.4
                       Then this parameter should be given as "10.0.0.1,10.0.0.2_10.0.0.3,10.0.0.4"
   
   Example: .\telegraf-utils.ps1 product-managed -t 8dab02cc-277c-4383-b910-bd2e89c7e741::8bcde100-6318-44d7-a8dc-11f4ff84b3b -v 10.10.10.100 -c 10.10.10.101

   Hinweis: Das Argument -c ist für die Ausführung des Hilfsskripts obligatorisch.

   Um den Bootstrap-Status zu überprüfen, sehen Sie die Datei uaf-bootstrap-results an. Wenn die Installation fehlschlägt, suchen Sie nach Fehlermeldungen in uaf_bootstrap.log.

   Wenn das Skript erfolgreich ist, wird der Status des Agenten in der Registerkarte Telegraf-Agenten verwalten nach einem Erfassungszyklus aktualisiert, der 5 bis 10 Minuten benötigt.

   Hinweis: Wenn Sie ein Automatisierungsskript verwenden, wird die gleichzeitige Agenteninstallation mit einer Stapelgröße von 20 unterstützt.