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 en configureren:

  1. Installeren:
    1. Download het .rpm- of .deb-installatieprogramma voor de agent en sla het op een locatie op die toegankelijk is vanaf de computer waarop u de agent wilt installeren.

    2. Voer de volgende opdracht uit om de agent te installeren waarbij <version> is ingedeeld als major-minor-maintenance:

      Voor RHEL-achtige distributies, waaronder CentOS:

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

      Voor Ubuntu:

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

  2. RMT-agent initialiseren:

    U moet de Gebruikersovereenkomst voor de eindgebruiker (EULA) expliciet accepteren wanneer u de RMT-agent initialiseert. U kunt er ook voor kiezen om niet-standaardconfiguraties op te geven. Om de RMT-agent te initialiseren met een standaardconfiguratie, voert u deze opdracht uit:

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

    De EULA vindt u in de map /opt/tableau/tabrmt/agent/docs.

    Vanaf versie 2023.1 kunt u een aangepast Uitvoeren als-account opgeven dat door RMT moet worden gebruikt, evenals andere configuratieopties. Standaard maakt en gebruikt RMT voor het uitvoeren een account met de naam rmt-agent. Als u een aangepast Uitvoeren als-account wilt opgeven dat door de RMT-agent moet worden gebruikt, voegt u de optie --unprivileged-user toe wanneer u het initialisatiescript uitvoert. Voor informatie over alle beschikbare schakelaars voor het initialize-rmt-agent-script, verwijzen wij u naar Scriptopties voor initialisatie van RMT Agent.

  3. Registreren:
    1. Log uit en log in als de tabrmt-agent-gebruiker, zodat u rtmadmin-opdrachten kunt uitvoeren, waarvoor het altijd nodig is dat u als tabrmt-agent-gebruiker bent ingelogd. Wanneer u opnieuw inlogt, wordt er een nieuwe sessie gemaakt waarin de wijzigingen in het groepslidmaatschap zijn doorgevoerd.

      sudo su --login tabrmt-agent

    2. Voer de volgende opdracht uit en geef het pad op waar het bootstrap-bestand zich bevindt. Geef de beschrijvende naam en het knooppunt op waar de agent wordt geïnstalleerd.

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

      U wordt gevraagd naar het wachtwoord van de RMT-beheerder-gebruiker.

      Opmerking: de tabrmt-agent-gebruiker voert standaard opdrachten uit vanuit de basiswerkmap: /var/opt/tableau/tabrmt/agent. U moet dus het volledige bestandspad opgeven. Als u bijvoorbeeld het bootstrap-bestand in de map /var/opt/tableau/tabrmt/agent/bootstrap/ plaatst, zoals aanbevolen, is het bestandspad /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.json

      In de volgende tabel staan de configuratieopties die worden gebruikt om de agent te registreren:

      OptieVereist?StandaardBeschrijving
      --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
       

      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.

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

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.