RMT-upgrade: technische referentie

Dit gedeelte bevat technische referenties voor de operationele drempelwaarden, systeempaden en netwerkpoorten die tijdens het upgradeproces worden gecontroleerd. Gebruik deze tabellen om snel een diagnose te stellen van validatiefouten en om uw omgeving af te stemmen op de vereiste RMT-basiswaarden.

Opmerking: in lijn met onze bedrijfswaarden met betrekking tot gelijkwaardigheid, hebben we de term RMT Master veranderd in RMT Server. In sommige gevallen wordt voor de installatiepaden en -opdrachten van RMT Server de term 'master' mogelijk nog gebruikt in plaats van 'server'. Het kan dus zijn dat de term nog steeds voorkomt in CLI-opdrachten en -opties, installatiemappen, configuratiebestanden en andere items. Zie Over Tableau Help(Link wordt in een nieuw venster geopend) voor meer informatie.

Statuscontroles vóór een upgrade

Bij de statuscontrole vóór een upgrade wordt uw RMT Server of Agent-host geïnspecteerd terwijl de bestaande installatie nog intact is, zoals services die worden uitgevoerd, toegang tot de database, en wordt een gedetailleerd PASS/FAIL/WARN-rapport gegenereerd. Er worden meer dan 80 afzonderlijke controles uitgevoerd voor systeembronnen, accounts, bestandsmachtigingen, PostgreSQL, RabbitMQ, netwerken, configuratiebestanden en RMT-services. In de volgende tabel staan de controles die vóór de upgrade worden uitgevoerd. Als een item de status FAIL retourneert (Exit Code 2), wordt de upgrade geannuleerd.

Systeem en hardware

Controle-IDNaam PlatformsFout (FAIL)-/Waarschuwing (WARN)-voorwaarde
#1BesturingssysteemLinux, WindowsWARN De versie van het besturingssysteem staat niet in de lijst met toegestane versies van vóór de controle. De ondersteunde versies zijn RHEL 8.x/9.x, Ubuntu 20.04/22.04/24.04, CentOS Stream 8/9, Oracle Linux 8.x/9.x, AlmaLinux 8.x/9.x, Rocky Linux 8.x/9.x, Amazon Linux 2023, Windows Server 2019/2022
#2SchijfruimteLinux, WindowsFAIL RMT Server < 20 GB of Agent < 5 GB vrij WARN RMT Server < 50 GB of Agent < 10 GB vrij
#2aSchijftypeLinux, WindowsINFO Meldt of de schijf een SSD of HDD is
#3

RAM

Linux, WindowsWARN RMT Server < 8 GB (minimum) of Agent < 4 GB (minimum)
#4CPU-kernenLinux, WindowsWARN RMT Server < 8 GB (minimum) of Agent < 4 GB (minimum)
#4aCPU-instructiesLinux, WindowsFAIL (Linux): sse4_2 of popcnt ontbreekt. WARN (Windows): oudere CPU gedetecteerd.
#4bVC++ RedistWindowsFAIL Visual Studio 2022 C++ Redistributable ontbreekt.
#4cOpenSSL DLLsWindowsINFO Controleert op libcrypto-3-x64.dll en libssl-3-x64.dll
#5SysteembeschikbaarheidLinux, WindowsINFO: geeft aan indien < 10 minuten (zeer recentelijk opnieuw opgestart) of > 90 dagen (in afwachting van patches)
#6Systemd wordt uitgevoerdLinuxFAIL systemd wordt niet uitgevoerd, PASS: wordt uitgevoerd of is in beperkte staat
#7FIPS-modusLinux, WindowsFAIL (Windows): ingeschakeld in register, PASS FIPS uitgeschakeld. WARN (Linux) Komt niet overeen met config.json. PASS Besturingssysteem en configuratie komen overeen
#7aPowerShell-versieWindowsINFO PowerShell-versie
#7bLandinstelling van systeemWindowsINFO Informatie over landinstelling van het systeem
#7cWMI-statusWindowsWARN WMI-opslagplaats is inconsistent

 

Accounts en machtigingen

Controle-IDNaam PlatformFout (FAIL)-/Waarschuwing (WARN)-voorwaarde
#8ServiceaccountLinux, WindowsFAIL RMT-serviceaccount of Windows-service niet gevonden
#9GroepslidmaatschapLinuxFAIL vereiste servicegroepen (bijv. rmtmasterapp, rmtmasterconfig, enz.) ontbreken
#10Systemd gebruikerLinuxFAIL systemd daemon/linger van gebruiker is niet actief
#44pamtester geïnstalleerdLinuxWARN als deze niet is geïnstalleerd. Installeer yum install pamtester of apt install libpam-runtime om dit op te lossen.

Directory-eigendom en -machtigingen voor Linux

Controle-IDDirectory Expected Owner:GroupVerwachte modus
#11Configuratiedirectorytabrmt-master:rmtmasterconfig2775
#12Logboekdirectorytabrmt-master:rmtmasterlogs2775
#13Datadirectory (+ PG/RMQ-subdirectory's)Geschikt voor component2775
#14Vereisten directory'sroot- of componentgebruiker755
#14arabbitmq-defaults-bestandGroup-writable vereistg+w
#15SSL-certificaatdirectorytabrmt-master:rmtopenssl2775
#15aStartdirectoryComponentgebruiker770
#15b/etc/profile.d/tabrmt-*.shrootstandaard
#15cConfiguratiedirectory setgid bit--2xxx vereist
#16environment.bashComponentgebruikergroup-writable

Ernst: FAIL alleen voor eigendom voor de data-dir-set (#13 en #15). Alle andere controles van de Linux-directory (#11, #12, #14, #14a, #15a–c, #16) geven WARN af bij niet-overeenkomend(e) eigendom/modus, omdat het script van het installatieprogramma voor na de installatie het eigendom opnieuw toepast tijdens de upgrade. WARN als de machtigingsmodus onjuist is, maar het eigendom correct.

Directory-eigendom en machtigingen voor Windows

Controle NaamErnst
#11ACL's configuratiedirectoryFAIL als de servicegebruiker niet beschikt over FullControl
#12ACL's logboekdirectoryFAIL als de servicegebruiker niet beschikt over Modify
#13ACL's datadirectory (RMT Server)FAIL als de servicegebruiker niet beschikt over FullControl voor PG/RMQ-datadirectory's
#14ACL's vereistendirectory (RMT Server)WARN als ReadAndExecute ontbreekt (adviserend: bij elke upgrade worden de vereiste MSI's opnieuw geïnstalleerd en de daarbij behorende acties van na de installatie opnieuw toegepast
#15ACL's van SSL-certificaatdirectory (RMT Server)FAIL als de servicegebruiker niet beschikt over FullControl
#16aIdentiteit van servicegebruikerPASS (ter informatie: geeft aan als welke gebruiker de service wordt uitgevoerd)
#16bSeServiceLogonRight-privilegeINFO indien gevonden; WARN indien niet gevonden of secedit mislukt
#16cACL's van servicegebruikers op RMT-directory'sFAIL als servicegebruiker niet over de vereiste rechten beschikt

 

Database (PostgreSQL)

Alle PostgreSQL-controles worden alleen op RMT Server uitgevoerd.

Controle-IDNaam Vereist--db-password-optieFout (FAIL)-/Waarschuwing (WARN)-voorwaarde
#17PG-serviceNeeFAIL Lokale service gestopt EN uitgeschakeld
#18Poort 5555 luistertNeeWARN (beveiligingsgroep/VPC / RDS-hint) Luistert niet
#19DB ConnectionJaWARN Kan geen verbinding maken met interne DB (SSL-, wachtwoord- of netwerkprobleem)

 

Berichten (RabbitMQ)

De berichtencontroles (RabbitMQ) worden alleen op RMT Server uitgevoerd.

Controle-IDNaam Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde
#22RMQ-serviceFAIL Lokale service gestopt EN uitgeschakeld
#24Wachtrij-backlogWARN Elke wachtrij met > 10.000 berichten
#25RabbitMQ-gebruikersWARN als de guest-gebruiker nog bestaat
#26Actieve verbindingenAlleen INFO. Meldt het aantal actieve verbindingen
#27Erlang-cookie toegankelijkWARN als cookiebestand ontbreekt, als machtigingen onjuist zijn (moet modus 400 of 600 zijn)
#27aERLANG_HOME ingesteldWARN (alleen Windows) als 'ERLANG_HOME' niet is ingesteld of pad niet bestaat.
#27bSSL-geldigheidFAIL Certificaten zijn verlopen
#27cSchijfalarmFAIL < 10 GB vrij op RMQ-partitie (upgrade loopt vast)
#45Certificaatdirectory gevuldWARN als de certificaatdirectory bestaat, maar leeg is of verwachte certificaatbestanden (servercertificaat, sleutel, CA-certificaat) ontbreken in de directory

Netwerk en configuratie

Controle-IDNaam Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde
28a/bAgent-Master-communicatieWARN Agent kan Master niet bereiken op 5671, 5672, 80 of 443
#33-35JSON/Bash ConfigFAIL Ontbrekende of ongeldige config.json, setup.json of environment.bash
#36aBekende-slechte versieFAIL De huidige versie is 2025.3.0 (upgrade regressieblokken)

Services en back-up

Controle-IDNaam Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde
#38Alle RMT-services worden uitgevoerdWARN voor elke gestopte service
#38aGestrande processenFAIL Aanhoudende tabrmt-*-processen gevonden nadat services zijn gestopt
#39Achtergrondprocessor actiefWARN als het hostproces niet wordt uitgevoerd
#40Herinnering voor back-up vóór upgradeWARN als een herinnering om een back-up te maken van de configuratie voordat u een upgrade uitvoert
#41TopologieAlleen INFO. Meldt Master-/Agent-knooppunttype en (bij DB) het aantal actieve agents
#42Inventaris van componentversiesAlleen INFO. Meldt RMT-, PostgreSQL-, RabbitMQ- en OpenSSL-versies
#43Samenvatting van apparaatspecificatiesAlleen INFO. Meldt besturingssysteem, CPU-kernen, RAM, vrije schijfruimte

 

Statuscontroles na een upgrade

Deze controles worden na de upgrade uitgevoerd. Ze zijn niet-blokkerend en fouten stoppen de upgrade niet, maar duiden op problemen na de installatie.

Controle-IDNaam ComponentFout (FAIL)-/Waarschuwing (WARN)-voorwaarde
#1a-dServices en processenRMT Server, AgentFAIL Hoofd-, PG- of RMQ-services worden niet uitgevoerd
#2Supervisorproces hostRMT Server, AgentWARN Supervisorproces voor host ontbreekt (geen automatisch herstel)
#3a-bIntegriteit configuratiebestandRMT Server, AgentFAIL indien JSON ontbreekt of ongeldig is
#4a-bBestandsmachtigingenRMT Server, AgentFAIL Configuratie-/logboekdirectory's niet leesbaar/beschrijfbaar door serviceaccount
#5a-dPoort luistertRMT ServerFAIL Web (443), AMQP (5672) of DB (5555) luisteren niet
#6PostgreSQL-connectiviteitRMT ServerFAIL PostgreSQL accepteert geen verbindingen
#7RabbitMQ-statusRMT ServerSKIP indien extern. FAIL nadat pogingen zijn verbruikt.
#8aConsumenten in wachtrijRMT ServerWARN Er bestaat een backlog, maar er zijn geen actieve consumenten (Master-workers niet verbonden)
#9RMQ-alarmenRMT ServerFAIL Alarmen voor actief geheugen of schijfbronnen gedetecteerd
#10SSL-certificaat RabbitMQRMT ServerFAIL als het certificaat is verlopen. WARN als certificaten binnen 30 dagen verlopen
#11FIPS-overeenkomstRMT Server, AgentFAIL FIPS-status van besturingssysteem komt niet overeen met isFIPSEnabled-configuratie
#12HTTP-respons webserverRMT ServerZorgt ervoor dat HTTP GET naar 'https://localhost:<port>/authentication/login' gaat. PASS bij 200 of 302. FAIL bij verbinding geweigerd/time-out. WARN bij andere fouten.
#13Geldigheid HTTPS-certificaatRMT ServerFAIL TLS-certificaat van webserver is verlopen
#14a-dSchijfruimteRMT Server, AgentFAIL < 1 GB vrij. WARN: < 5 GB vrij
#15Recente logboekfoutenRMT Server, AgentFAIL FATAL-fouten in logboeken. WARN: CRITICAL-fouten
#16RMT-statusRMT Server, AgentFAIL rmtadmin-status retourneert foutpatronen
#17Geschiedenis AgentlogboekAgentControleert bestanden voor het bijhouden van logboeken (.history, .json) in de datadirectory van de agent. WARN als bestanden onleesbaar of beschadigd zijn
#18a-fInventarisversieRMT Server, AgentINFO over RMT-versie, PostgreSQL-versie, RabbitMQ-versie, Erlang/OTP-versie, .NET Runtime (Windows) / Besturingssysteem (Linux), versie van besturingssysteem (Windows) / Kernel (Linux)

Afsluitcodes statuscontrole

Gebruik de onderstaande afsluitcodes om de resultaten van de scripts voor statuscontrole vóór en na een upgrade te interpreteren.

Scripts voor controle vóór een upgrade

AfsluitcodeStatus Upgradegedrag
0READY TO UPGRADEUpgrade gaat door
1UPGRADE WITH CAUTIONUpgrade gaat door; bekijk waarschuwingen
2Geen upgrade uitvoerenUpgrade geannuleerd
3ScriptfoutControleer uitvoeringsomgeving

Scripts voor controle na een upgrade

AfsluitcodeStatus
0ALL PASSED
1WARNINGS PRESENT
2CRITICAL FAILURES

Wijzigingen in ernst InstallerContext

Bij uitvoering met -InstallerContext tijdens automatische Windows MSI-upgrades, wijkt het gedrag van de volgende controles af van het standaardgedrag bij handmatige uitvoering. Het standaardgedrag (niet-InstallerContext) is *al* WARN voor de statussen 'gestopt maar niet Uitgeschakeld'-/'poort luistert niet'; FAIL is gereserveerd voor 'Gestopt+Uitgeschakeld'. Onder '-InstallerContext' wordt zelfs de tak 'Uitgeschakeld' gemeld als WARN, zodat een actieve, door het installatieprogramma aangestuurde upgrade nooit een veto krijgt door een tijdelijke staat die door het installatieprogramma wordt hersteld.

Controle Naam StandaardInstallerContext
#17PG-serviceWARN bij Gestopt, FAIL bij Gestopt en Uitgeschakeld, INFO als alles is gestoptWARN
#18PG-poortWARN als er niet wordt geluisterd, INFO als alle services zijn gestoptWARN
#22RabbitMQ-serviceWARN bij Gestopt, FAIL bij Gestopt+Uitgeschakeld, INFO als alles is gestoptWARN
#23Port 5672 (AMQP)WARN als er niet wordt geluisterd, INFO als alle services zijn gestoptWARN
#38aGestrande RMT processen(zie controlebeschrijving)SKIP (installatieprogramma beheert proceslevenscyclus)

Drempelwaarden vóór upgrade

Drempelwaarde RMT Server AgentEenheid
Schijfruimte FAIL205GB vrij
Schijfruimte WARN5010GB vrij
Tijdelijke directory FAIL55GB vrij
Tijdelijke directory WARN1010GB vrij
RAM FAIL84GB
RAM WARN168GB
CPU FAIL42kernen
CPU WARN84kernen
Databasegrootte FAIL500-GB
Databasegrootte WARN200-GB
Hangfire-schema FAIL10-GB
Hangfire-schema WARN1-GB
WAL-directory FAIL (Windows)10-GB
WAL-directory FAIL (Windows)2-GB
WAL-directory FAIL (Linux)10-GB
Mnesia-directory WARN5-GB
RabbitMQ-schijfalarm FAIL10-GB vrij
Wachtrij-backlog WARN10000-berichten
Vervallen van certificaat WARN3030dagen
Retentieperiode voor opschonen WARN180-dagen
Vervallen-tupelverhouding WARN20-procent
Agent-heartbeat verouderd15-minuten
Leeftijd netwerkstuurprogramma WARN3-jaren
Grootte logboekdirectory WARN55GB
Grootte logboekdirectory WARN (ernstig)2020GB

Drempelwaarden na upgrade

DrempelwaardeWaarde Eenheid
Schijfruimte FAIL1GB vrij
Schijfruimte WARN5GB vrij
Vervallen van certificaat WARN30dagen
Wachtrij-backlog WARN10000berichten
Logboekscanvenster60minuten
Opnieuw starten van RabbitMQ6 pogingen x 5 sec30 seconden in totaal

 

Minimaal ondersteunde componentversies

ComponentMinimale versie
RabbitMQ>= 3.10.10
Agent-versie>= 2023.1.0

Automatisering en CI-/CD integratie

Voor Linux:

```base
# Linux
sudo bash rmt-pre-upgrade-check.sh --component master --db-password "$DB_PASSWORD"
EXIT_CODE=$?
if [ $EXIT_CODE -eq 2 ]; then
echo "BLOCKED: Fix critical issues before upgrading"
exit 1
fi
```

Voor Windows:

```powershell
# Windows
.\rmt-pre-upgrade-check.ps1 -Component master
if ($LASTEXITCODE -eq 2) {
Write-Error "BLOCKED: Fix critical issues before upgrading"
exit 1
}
```

 

Installatiedirectory-referentie

Als u de onderliggende diagnostische hulpprogramma's handmatig wilt aanroepen of uw installatiestructuur wilt controleren, raadpleegt u de platformspecifieke directorypaden:

Linux-directorystructuur

```

/opt/tableau/tabrmt/ # Install root

+-- master/ # Master application binaries

+-- agent/ # Agent application binaries

+-- prerequisites/ # Bundled dependencies

/var/opt/tableau/tabrmt/ # Data root

+-- master/config/ # config.json, setup.json

+-- master/logs/ # Application logs

+-- data/postgresql15/ # PostgreSQL data files

+-- data/rabbitmq313/ # RabbitMQ data/mnesia

+-- data/ssl/ # TLS certificates

/etc/opt/tableau/tabrmt/

+-- master/environment.bash # Master environment variables

+-- agent/environment.bash # Agent environment variables

```

Windows-directorystructuur

```

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\ # Install root

C:\ProgramData\Tableau\Tableau Resource Monitoring Tool\ # Data root

```

Vereiste netwerkpoorten

PoortService Richting
80Webinterface RMT (HTTP)Inkomend
443Webinterface RMT (HTTPS)Inkomend
5672AMQP RabbitMQInkomend op RMT Server
5671AMQP RabbitMQ via TLSInkomend op RMT Server
15672Gebruikersinterface RabbitMQ-beheerLokaal
25672RabbitMQ tussen knooppuntenLokaal
5555Interne PostgreSQLLokaal
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.