Installieren des Agenten mithilfe der Befehlszeile

Der Agent ist ein kompakter Prozess, der nur minimale Serverressourcen beansprucht und Daten an den Resource Monitoring Tool-Server (RMT-Server) sendet. Installieren Sie den Resource Monitoring Tool-Agenten auf jedem Ihrer Tableau Server-Knoten. Wenn Sie einen Agenten installieren und registrieren möchten, laden Sie die Agent-Bootstrap-Konfigurationsdatei herunter, und speichern Sie diese an einem Speicherort, der von den Resource Monitoring Tool-Agent-Knotenpunkten aus zugänglich ist.

In diesem Thema werden die Schritte beschrieben, mit denen Sie den Resource Monitoring Tool-Agenten über die Befehlszeile installieren können. Die Befehlszeileninstallation wird sowohl auf Windows- als auch auf Linux-Betriebssystemen unterstützt.

In dem Bestreben, uns an unserem Unternehmenswert der Gleichstellung auszurichten, haben wir nicht-inklusive Terminologie wo immer möglich geändert. Da die Änderung von Begriffen an bestimmten Stellen zu einer grundlegenden Änderung führen kann, behalten wir die vorhandene Terminologie bei. Daher werden Sie die Begriffe möglicherweise weiterhin in Befehlen und Optionen der Kommandozeile (CLI), Installationsordnern, Konfigurationsdateien und anderen Instanzen finden. Weitere Informationen finden Sie unter Über Tableau-Hilfe(Link wird in neuem Fenster geöffnet).

Vor der Installation

  • Laden Sie die Bootstrap-Datei herunter und speichern Sie sie an einem Speicherort, auf den die Knoten, auf denen Sie den RMT-Agent installieren möchten, zugreifen können. Bootstrap-Dateien sind nach dem Herunterladen nur 24 Stunden lang gültig. Wenn die von Ihnen verwendete Datei älter als 24 Stunden ist, müssen Sie die Bootstrap-Datei neu generieren.
  • Ab Version 2021.3 muss die Agentenregistrierung sowohl über einen https-Endpunkt als auch über RabbitMQ kommunizieren, um die Agentenregistrierung abzuschließen. Vergewissern Sie sich, dass die Ports 443 und 5672 für diese Kommunikationen geöffnet sind.

So installieren und konfigurieren Sie den Agenten:

  1. Laden Sie die Bootstrap-Datei in einen Speicherort herunter, auf den über Tableau Server-Knotenpunkte zugegriffen werden kann.

    rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>

  2. Führen Sie das Agent-Setup-Programm aus:
    1. Laden Sie das Agent-Installationsprogramm herunter, und speichern Sie es an einem Speicherort, auf den Sie von Tableau Server-Computern aus zugreifen können.

    2. Öffnen Sie die Eingabeaufforderung als Administrator.
    3. Navigieren Sie zum Speicherort des Agent-Installationsprogramms, und führen Sie die exe-Datei mit dem folgenden Befehl aus.

      Tabrmt-Agent-64bit-<version>.exe /silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password>

      Ab 2021.4 müssen Sie ein Konto vom Typ "Als Benutzer ausführen" für einen Agenten angeben. Dieses Konto wird für den Zugriff auf Tableau Server verwendet, um Überwachungsinformationen zu sammeln.

      Geben Sie für das Konto vom Typ "Als Benutzer ausführen" dasselbe Konto an, das Sie derzeit für das Tableau Server-Benutzerkonto verwenden. Wenn die von Ihnen angegebenen Kontoinformationen nicht mit denen auf Tableau Server übereinstimmen, kann der Agent die Überwachungsdaten auf diesem Knoten nicht erfassen.

      • Verwenden Sie "RUN_AS_NETWORK_SERVICE=1", wenn Ihr Tableau Server so konfiguriert ist, dass er das Netzwerkdienstkonto vom Typ "Als Benutzer ausführen" verwendet.
      • Verwenden Sie "RUN_AS_USER_CUSTOM=1", wenn Ihr Tableau Server für die Verwendung eines benutzerdefinierten Benutzers konfiguriert ist. Verwenden Sie dieselben Anmeldeinformationen, die Sie für Tableau Server angegeben haben.

      Der Standardinstallationsordner lautet in der Regel wie folgt: C:\Programme\Tableau\Tableau Resource Monitoring Tool\agent. Führen Sie den folgenden Befehl aus, um einen anderen Installationsspeicherort bereitzustellen:

      Tabrmt-Agent-64bit-<version>.exe/silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password> InstallFolder="D:\Tableau Resource Monitoring Tool\agent"

      Hinweis: Verwenden Sie den Switch "/silent" oder "/quiet", um das Setup unbeaufsichtigt und ohne Anzeige von Benutzeroberfläche oder Eingabeaufforderungen auszuführen.

  3. Registrieren Sie den Agenten:
    1. Führen Sie zum Registrieren des Agenten den folgenden Befehl aus.

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description> --username <name of the RMT admin user> --password <password for the user account>

      In der folgenden Tabelle sind die Konfigurationsoptionen aufgeführt, die zum Registrieren des Agenten verwendet werden:

      OptionErforderlich?

      Standard

      Beschreibung
      --bootstrap fileJa<none>Der Speicherort der Bootstrap-Datei.
      --usernameJa<none>Dies ist in der Regel der Admin-Benutzer, den Sie bei der Installation des RMT-Servers angelegt haben.
      --passwordJa<none>Dies ist das Kennwort für das Benutzerkonto.
      --password-file

      Nein

      Das Kennwort kann in der Befehlszeile angegeben oder in einer Datei bereitgestellt werden, die das Kennwort enthält. Bei fehlender Angabe werden Sie aufgefordert, das Kennwort einzugeben.

      <none>Pfad einschließlich des Dateinamens, unter dem das Kennwort gespeichert ist.
      --server-nameNeinHostname des ComputersName des Computers, auf dem der Agent installiert ist. Wenn keine Option angegeben ist, wird dieses Feld standardmäßig auf den Hostnamen des Computers festgelegt.
      --server-descriptionNein<none>Beschreibung des Computers, auf dem der Agent installiert ist. Wenn keine Option angegeben ist, bleibt dieses Feld leer.

      Windows-Installationseigenschaften und -Switches

      Switches:

      SwitchBeschreibungKommentare
      /passiveSetup mit minimaler Benutzeroberfläche und ohne Eingabeaufforderungen ausführen. 
      /quiet | /silentSetup im unbeaufsichtigten und vollständig automatischen Modus ausführen. Es werden weder die Webschnittstelle noch Eingabeaufforderungen angezeigt.Verwenden Sie entweder "/quiet" oder "/silent", nicht beides.

      Eigenschaften:

      EigenschaftBeschreibungKommentare
      InstallFolder=<path\to\installation\directory>In einem angegebenen, nicht standardmäßigen Installationsort installieren.

      Gibt den Speicherort für die RMT-Installation an. Wenn Sie diese Option nicht verwenden, wird RMT unter C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master installiert.

      Beispiel: <Setup file> /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"

      ACCEPTEULA=1|0Die Lizenzvereinbarung für Endbenutzer akzeptieren. Für die stille, automatische und passive Installation sowohl auf dem Anfangs- als auch auf allen weiteren Knoten erforderlich. 1 = wahr, EULA akzeptieren, 0 = falsch, EULA nicht akzeptieren.Ist dies bei der Verwendung von "/passive", "/silent" oder "/quiet" nicht enthalten, schlägt die Einrichtung ohne Rückmeldung fehl. Wenn er enthalten, aber auf 0 gesetzt ist, schlägt Setup fehl.

       

Installieren des Agenten auf einem Multi-Node-Tableau Server

Führen Sie die oben beschriebenen Schritte auf jedem Tableau Server-Knoten aus. Auf der Weboberfläche des RMT-Servers sollten Sie alle Knoten sehen können, auf denen der Agent installiert ist.

Wer kann dies tun?

Zum Installieren des Resource Monitoring Tools müssen Sie über Folgendes verfügen:

Windows:

  • Administratorberechtigungen für den Computer, auf dem Sie Resource Monitoring Tool installieren.
  • Tableau Server-Administrator-Site-spezifische Rolle

Linux:

  • Vollständiger Sudo-Zugriff für das Benutzerkonto, das zum Installieren des Agenten verwendet wird.

Nächster Schritt

Konfigurieren von Tableau Resource Monitoring Tool