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

Sie können einen Agenten mithilfe eines Skripts auf einer Zielmaschine installieren.

Voraussetzungen

Machen Sie alle erforderlichen Angaben. Weitere Informationen finden Sie unter Vorbedingungen.
Das Entpacken des Pakets muss auf der Zielmaschine 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 mehrere vom vCenter Server-Cloud-Konto verwaltete VMs mit derselben IP überwacht werden, kann das Skript nicht aufgelöst und die Anwendungsüberwachung nicht abonniert werden.
Hinweis: Diese Voraussetzung gilt nur für die VMs, die vom vCenter Server-Cloud-Konto verwaltet werden. Weitere Informationen zu Objekttypen Sie unter Überwachung von Betriebssystem und Anwendungen.
Die vom vCenter Server-Cloud-Konto verwaltete VM muss in VMware Aria Operations verfügbar sein.
Hinweis: Diese Voraussetzung gilt nur für die VMs, die vom vCenter Server-Cloud-Konto verwaltet werden.
Das Cloud-Konto muss für den vCenter Server konfiguriert werden, zu dem die VM gehört.
Hinweis: Diese Voraussetzung gilt nur für die VMs, die vom vCenter Server-Cloud-Konto verwaltet werden.
Die Zielmaschine 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.
Hinweis: Gilt nur für VMs, die vom vCenter Server-Cloud-Konto verwaltet werden.

Prozedur

Melden Sie sich bei der Zielmaschine an, auf der Sie den Agenten installieren bzw. deinstallieren möchten, und laden Sie das Beispielskript aus dem Cloud-Proxy an 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.

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.