De agent installeren via de opdrachtregel

De agent is een lichtgewicht proces dat minimale serverbronnen gebruikt en data naar Resource Monitoring Tool Server (RMT-server) stuurt. Installeer Resource Monitoring Tool-agent op elk van uw Tableau Server-knooppunten. Om een agent te installeren en te registreren, downloadt u het bootstrap-configuratiebestand voor de agent en slaat u dit op een locatie op die vanaf de Resource Monitoring Tool-agentknooppunten toegankelijk is.

In dit onderwerp worden de stappen beschreven die u kunt volgen om de Resource Monitoring Tool-agent via de opdrachtregel te installeren. Installatie via de opdrachtregel wordt ondersteund op zowel Windows- als Linux-besturingssystemen.

In een poging om aan te sluiten bij onze bedrijfswaarden van gelijkheid, hebben we niet-inclusieve terminologie waar mogelijk veranderd. Omdat het veranderen van termen op bepaalde plaatsen een verandering kan veroorzaken die tot het verlies van functionaliteit leidt, handhaven we de bestaande terminologie. U kunt de termen dus nog steeds zien in CLI-opdrachten en -opties, installatiemappen, configuratiebestanden en op andere plaatsen. Zie Over Tableau Help(Link wordt in een nieuw venster geopend) voor meer informatie.

Voor de installatie

  • Download het bootstrap-bestand en sla het op een locatie op die toegankelijk is voor de knooppunten waarop u de RMT-agent gaat installeren. Bootstrap-bestanden zijn na het downloaden slechts 24 uur geldig. U moet het bootstrap-bestand opnieuw genereren als het bestand dat u gebruikt ouder is dan 24 uur.
  • Vanaf versie 2021.3 moet registratie van de agent via zowel een https-eindpunt als RabbitMQ communiceren om de registratie te voltooien. Zorg ervoor dat zowel poort 443 als poort 5672 open is voor deze communicatie.

De agent installeren en configureren:

  1. Download het bootstrap-bestand naar een locatie die toegankelijk is vanaf de Tableau Server-knooppunten.

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

  2. Voer het installatieprogramma van de agent uit:
    1. Download het installatieprogramma van de agent en sla het op een locatie op die toegankelijk is vanaf Tableau Server-machines.

    2. Open de opdrachtprompt als beheerder.
    3. Navigeer naar de locatie van het installatieprogramma van de agent en voer het exe.-bestand uit met behulp van de volgende opdracht

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

      Vanaf 2021.4 moet u een Uitvoeren als gebruiker-account voor de agent opgeven. Met dit account krijgt u toegang tot Tableau Server om bewakingsinformatie te verzamelen.

      Geef voor het Uitvoeren als gebruiker-account hetzelfde account op dat u momenteel voor het Tableau Server-gebruikersaccount gebruikt. Als de accountdata die u opgeeft niet overeenkomen met die op Tableau Server, kan de agent de bewakingsdata op dat knooppunt niet verzamelen.

      • Gebruik RUN_AS_NETWORK_SERVICE=1 als uw Tableau Server is geconfigureerd om het netwerkserviceaccount te gebruiken als de Uitvoeren als-gebruiker.
      • Gebruik RUN_AS_USER_CUSTOM=1 als uw Tableau Server is geconfigureerd om een aangepaste gebruiker te gebruiken. Gebruik dezelfde accountreferenties als die welke voor Tableau Server zijn opgegeven.

      De standaardinstallatiemap ziet er meestal als volgt uit: C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent. Als u een andere installatielocatie wilt opgeven, voert u de volgende opdracht uit:

      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"

      Opmerking: gebruik de schakeloptie /silent of /quiet om de installatie onbeheerd uit te voeren, zonder dat er een gebruikersinterface of prompts worden weergegeven.

  3. Registreer de agent:
    1. Voer de volgende opdracht uit om de agent te registreren:

      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 de volgende tabel staan de configuratieopties die worden gebruikt om de agent te registreren:

      OptieVereist?

      Standaard

      Beschrijving
      --bootstrap fileJa<none>De locatie van het bootstrap-bestand.
      --usernameJa<none>Dit is doorgaans de beheerder-gebruiker die u tijdens de installatie van de RMT-server hebt gemaakt.
      --passwordJa<none>Dit is het wachtwoord voor het gebruikersaccount
      --password-file

      Nee

      Het wachtwoord kan worden opgegeven via de opdrachtregel of via een bestand waarin het wachtwoord is opgenomen. Als geen van beide wordt opgegeven, wordt u om het wachtwoord gevraagd.

      <none>Pad inclusief de bestandsnaam waar het wachtwoord is opgeslagen.
      --server-nameNeeHostnaam van de machineNaam van de computer waarop de agent is geïnstalleerd. Als er geen optie wordt opgegeven, wordt in dit veld standaard de hostnaam van de machine ingevuld.
      --server-descriptionNee<none>Beschrijving van de computer waarop de agent is geïnstalleerd. Als er geen optie is opgegeven, blijft dit veld leeg.

      Windows installatie-eigenschappen en schakelaars

      Schakelaars:

      SchakelaarBeschrijvingOpmerkingen
      /passiveVoer de configuratie uit met een minimale gebruikersinterface en zonder prompts. 
      /quiet | /silentVoer de configuratie uit in een onbeheerde, volledig stille modus. Er worden geen interface of prompts weergegeven.Gebruik /quiet of /silent, niet beide.

      Eigenschappen:

      EigenschapBeschrijvingOpmerkingen
      InstallFolder=<path\to\installation\directory>Installeren op de opgegeven, niet-standaard installatielocatie.

      Geeft de locatie op waar RMT moet worden geïnstalleerd. Als RMT niet wordt gebruikt, wordt de installatie uitgevoerd op C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master.

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

      ACCEPTEULA=1|0Accepteer de licentieovereenkomst voor eindgebruikers (EULA). Vereist voor een stille en passieve installatie op zowel de eerste als de extra knooppunten. 1 = true, accepteer de EULA, 0 = false, accepteer de EULA niet.Als dit niet is opgenomen bij het gebruik van /passive, /silent of /quiet, mislukt de installatie zonder melding. Als dit wel is opgenomen maar op 0 is ingesteld, mislukt de installatie.

       

De agent installeren op Tableau Server met meerdere knooppunten

Voer de hierboven beschreven stappen uit op elk van de knooppunten van Tableau Server. In de webinterface van de RMT-server kunt u alle knooppunten zien waarop de agent is geïnstalleerd.

Wie kan dit doen

Om Resource Monitoring Tool te installeren, moet u over al het volgende beschikken:

Windows:

  • Beheerdersrechten op de machine waarop u Resource Monitoring Tool installeert.
  • De siterol Tableau Server-beheerder.

Linux:

  • Volledige sudo-toegang voor het gebruikersaccount waarmee de agent wordt geïnstalleerd.

Volgende stap

Resource Monitoring Tool van Tableau configureren