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.

       

So installieren und konfigurieren Sie den Agenten:

  1. Installieren:
    1. Laden Sie die RPM- oder DEB-Datei für das Agenten-Installationsprogramm herunter, und speichern Sie sie an einem Speicherort, auf den Sie von dem Computer aus zugreifen können, auf dem Sie den Agenten installieren möchten.

    2. Führen Sie den folgenden Befehl aus, um den Agenten zu installieren, wobei <version> als Große-Kleine-Wartung formatiert ist:

      Für RHEL-ähnliche Verteilungen mit CentOS:

      sudo yum install Tabrmt-Agent-x86_64-<version>.rpm

      Für Ubuntu:

      sudo apt install Tabrmt-Agent-amd64-<version>.deb

  2. Initialisieren von RMT Agent:

    Sie müssen die Lizenzvereinbarung für Endbenutzer (EULA) ausdrücklich akzeptieren, wenn Sie RMT Agent initialisieren. Sie haben auch die Möglichkeit, nicht standardmäßige Konfigurationen anzugeben. Führen Sie diesen Befehl aus, um RMT Agent mit einer Standardkonfiguration zu initialisieren:

    sudo /opt/tableau/tabrmt/agent/install-scripts/initialize-rmt-agent --accepteula

    Die Lizenzvereinbarung für Endbenutzer (EULA) finden Sie im Ordner /opt/tableau/tabrmt/agent/docs.

    Ab Version 2023.1 können Sie ein benutzerdefiniertes ausführendes Konto angeben, das von RMT verwendet werden soll, sowie andere Konfigurationsoptionen. In der Standardeinstellung erstellt und verwendet RMT ein Konto namens rmt-agent, unter dem es ausgeführt wird. Um ein benutzerdefiniertes ausführendes Konto anzugeben, das von RMT Agent verwendet werden soll, geben Sie die Option --unprivileged-user mit an, wenn Sie das Initialisierungsskript ausführen. Informationen zu sämtlichen verfügbaren Schaltern für das initialize-rmt-agent-Skript finden Sie unter Optionen des RMT-Agent-Initialisierungsskripts.

  3. Registrieren:
    1. Melden Sie sich ab, und melden Sie sich als tabrmt-agent-Benutzer an, damit Sie rtmadmin-Befehle ausführen können. Dafür ist grundsätzlich eine Ausführung als tabrmt-agent-Benutzer erforderlich. Wenn Sie sich wieder anmelden, erstellen Sie auch eine neue Sitzung, in der die Änderungen der Gruppenmitgliedschaft angewendet wurden.

      sudo su --login tabrmt-agent

    2. Führen Sie den folgenden Befehl aus, und geben Sie den Pfad an, unter dem sich die Bootstrap-Datei befindet. Geben Sie den Anzeigenamen und eine Beschreibung des Knotens an, auf dem der Agent installiert wird.

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

      Sie werden aufgefordert, das Kennwort für den RMT-Administratorbenutzer einzugeben.

      Hinweis: Der tabrmt-agent-Benutzer verwendet standardmäßig Befehle aus dem Basisarbeitsverzeichnis "/var/opt/tableau/tabrmt/agent", daher müssen Sie den vollständigen Dateipfad entsprechend angeben. Wenn Sie beispielsweise die Bootstrap-Datei wie empfohlen im Ordner "/var/opt/tableau/tabrmt/agent/bootstrap/" gespeichert haben, lautet der Dateipfad /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.json.

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

      OptionErforderlich?StandardBeschreibung
      --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.
       

      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.

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

Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.