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-ID | Naam | Platforms | Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde |
| #1 | Besturingssysteem | Linux, Windows | WARN 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 |
| #2 | Schijfruimte | Linux, Windows | FAIL RMT Server < 20 GB of Agent < 5 GB vrij WARN RMT Server < 50 GB of Agent < 10 GB vrij |
| #2a | Schijftype | Linux, Windows | INFO Meldt of de schijf een SSD of HDD is |
| #3 | RAM | Linux, Windows | WARN RMT Server < 8 GB (minimum) of Agent < 4 GB (minimum) |
| #4 | CPU-kernen | Linux, Windows | WARN RMT Server < 8 GB (minimum) of Agent < 4 GB (minimum) |
| #4a | CPU-instructies | Linux, Windows | FAIL (Linux): sse4_2 of popcnt ontbreekt. WARN (Windows): oudere CPU gedetecteerd. |
| #4b | VC++ Redist | Windows | FAIL Visual Studio 2022 C++ Redistributable ontbreekt. |
| #4c | OpenSSL DLLs | Windows | INFO Controleert op libcrypto-3-x64.dll en libssl-3-x64.dll |
| #5 | Systeembeschikbaarheid | Linux, Windows | INFO: geeft aan indien < 10 minuten (zeer recentelijk opnieuw opgestart) of > 90 dagen (in afwachting van patches) |
| #6 | Systemd wordt uitgevoerd | Linux | FAIL systemd wordt niet uitgevoerd, PASS: wordt uitgevoerd of is in beperkte staat |
| #7 | FIPS-modus | Linux, Windows | FAIL (Windows): ingeschakeld in register, PASS FIPS uitgeschakeld. WARN (Linux) Komt niet overeen met config.json. PASS Besturingssysteem en configuratie komen overeen |
| #7a | PowerShell-versie | Windows | INFO PowerShell-versie |
| #7b | Landinstelling van systeem | Windows | INFO Informatie over landinstelling van het systeem |
| #7c | WMI-status | Windows | WARN WMI-opslagplaats is inconsistent |
Accounts en machtigingen
| Controle-ID | Naam | Platform | Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde |
| #8 | Serviceaccount | Linux, Windows | FAIL RMT-serviceaccount of Windows-service niet gevonden |
| #9 | Groepslidmaatschap | Linux | FAIL vereiste servicegroepen (bijv. rmtmasterapp, rmtmasterconfig, enz.) ontbreken |
| #10 | Systemd gebruiker | Linux | FAIL systemd daemon/linger van gebruiker is niet actief |
| #44 | pamtester geïnstalleerd | Linux | WARN 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-ID | Directory | Expected Owner:Group | Verwachte modus |
| #11 | Configuratiedirectory | tabrmt-master:rmtmasterconfig | 2775 |
| #12 | Logboekdirectory | tabrmt-master:rmtmasterlogs | 2775 |
| #13 | Datadirectory (+ PG/RMQ-subdirectory's) | Geschikt voor component | 2775 |
| #14 | Vereisten directory's | root- of componentgebruiker | 755 |
| #14a | rabbitmq-defaults-bestand | Group-writable vereist | g+w |
| #15 | SSL-certificaatdirectory | tabrmt-master:rmtopenssl | 2775 |
| #15a | Startdirectory | Componentgebruiker | 770 |
| #15b | /etc/profile.d/tabrmt-*.sh | root | standaard |
| #15c | Configuratiedirectory setgid bit | -- | 2xxx vereist |
| #16 | environment.bash | Componentgebruiker | group-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 | Naam | Ernst |
| #11 | ACL's configuratiedirectory | FAIL als de servicegebruiker niet beschikt over FullControl |
| #12 | ACL's logboekdirectory | FAIL als de servicegebruiker niet beschikt over Modify |
| #13 | ACL's datadirectory (RMT Server) | FAIL als de servicegebruiker niet beschikt over FullControl voor PG/RMQ-datadirectory's |
| #14 | ACL'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 |
| #15 | ACL's van SSL-certificaatdirectory (RMT Server) | FAIL als de servicegebruiker niet beschikt over FullControl |
| #16a | Identiteit van servicegebruiker | PASS (ter informatie: geeft aan als welke gebruiker de service wordt uitgevoerd) |
| #16b | SeServiceLogonRight-privilege | INFO indien gevonden; WARN indien niet gevonden of secedit mislukt |
| #16c | ACL's van servicegebruikers op RMT-directory's | FAIL als servicegebruiker niet over de vereiste rechten beschikt |
Database (PostgreSQL)
Alle PostgreSQL-controles worden alleen op RMT Server uitgevoerd.
| Controle-ID | Naam | Vereist--db-password-optie | Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde |
| #17 | PG-service | Nee | FAIL Lokale service gestopt EN uitgeschakeld |
| #18 | Poort 5555 luistert | Nee | WARN (beveiligingsgroep/VPC / RDS-hint) Luistert niet |
| #19 | DB Connection | Ja | WARN Kan geen verbinding maken met interne DB (SSL-, wachtwoord- of netwerkprobleem) |
Berichten (RabbitMQ)
De berichtencontroles (RabbitMQ) worden alleen op RMT Server uitgevoerd.
| Controle-ID | Naam | Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde |
| #22 | RMQ-service | FAIL Lokale service gestopt EN uitgeschakeld |
| #24 | Wachtrij-backlog | WARN Elke wachtrij met > 10.000 berichten |
| #25 | RabbitMQ-gebruikers | WARN als de guest-gebruiker nog bestaat |
| #26 | Actieve verbindingen | Alleen INFO. Meldt het aantal actieve verbindingen |
| #27 | Erlang-cookie toegankelijk | WARN als cookiebestand ontbreekt, als machtigingen onjuist zijn (moet modus 400 of 600 zijn) |
| #27a | ERLANG_HOME ingesteld | WARN (alleen Windows) als 'ERLANG_HOME' niet is ingesteld of pad niet bestaat. |
| #27b | SSL-geldigheid | FAIL Certificaten zijn verlopen |
| #27c | Schijfalarm | FAIL < 10 GB vrij op RMQ-partitie (upgrade loopt vast) |
| #45 | Certificaatdirectory gevuld | WARN als de certificaatdirectory bestaat, maar leeg is of verwachte certificaatbestanden (servercertificaat, sleutel, CA-certificaat) ontbreken in de directory |
Netwerk en configuratie
| Controle-ID | Naam | Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde |
| 28a/b | Agent-Master-communicatie | WARN Agent kan Master niet bereiken op 5671, 5672, 80 of 443 |
| #33-35 | JSON/Bash Config | FAIL Ontbrekende of ongeldige config.json, setup.json of environment.bash |
| #36a | Bekende-slechte versie | FAIL De huidige versie is 2025.3.0 (upgrade regressieblokken) |
Services en back-up
| Controle-ID | Naam | Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde |
| #38 | Alle RMT-services worden uitgevoerd | WARN voor elke gestopte service |
| #38a | Gestrande processen | FAIL Aanhoudende tabrmt-*-processen gevonden nadat services zijn gestopt |
| #39 | Achtergrondprocessor actief | WARN als het hostproces niet wordt uitgevoerd |
| #40 | Herinnering voor back-up vóór upgrade | WARN als een herinnering om een back-up te maken van de configuratie voordat u een upgrade uitvoert |
| #41 | Topologie | Alleen INFO. Meldt Master-/Agent-knooppunttype en (bij DB) het aantal actieve agents |
| #42 | Inventaris van componentversies | Alleen INFO. Meldt RMT-, PostgreSQL-, RabbitMQ- en OpenSSL-versies |
| #43 | Samenvatting van apparaatspecificaties | Alleen 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-ID | Naam | Component | Fout (FAIL)-/Waarschuwing (WARN)-voorwaarde |
| #1a-d | Services en processen | RMT Server, Agent | FAIL Hoofd-, PG- of RMQ-services worden niet uitgevoerd |
| #2 | Supervisorproces host | RMT Server, Agent | WARN Supervisorproces voor host ontbreekt (geen automatisch herstel) |
| #3a-b | Integriteit configuratiebestand | RMT Server, Agent | FAIL indien JSON ontbreekt of ongeldig is |
| #4a-b | Bestandsmachtigingen | RMT Server, Agent | FAIL Configuratie-/logboekdirectory's niet leesbaar/beschrijfbaar door serviceaccount |
| #5a-d | Poort luistert | RMT Server | FAIL Web (443), AMQP (5672) of DB (5555) luisteren niet |
| #6 | PostgreSQL-connectiviteit | RMT Server | FAIL PostgreSQL accepteert geen verbindingen |
| #7 | RabbitMQ-status | RMT Server | SKIP indien extern. FAIL nadat pogingen zijn verbruikt. |
| #8a | Consumenten in wachtrij | RMT Server | WARN Er bestaat een backlog, maar er zijn geen actieve consumenten (Master-workers niet verbonden) |
| #9 | RMQ-alarmen | RMT Server | FAIL Alarmen voor actief geheugen of schijfbronnen gedetecteerd |
| #10 | SSL-certificaat RabbitMQ | RMT Server | FAIL als het certificaat is verlopen. WARN als certificaten binnen 30 dagen verlopen |
| #11 | FIPS-overeenkomst | RMT Server, Agent | FAIL FIPS-status van besturingssysteem komt niet overeen met isFIPSEnabled-configuratie |
| #12 | HTTP-respons webserver | RMT Server | Zorgt 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. |
| #13 | Geldigheid HTTPS-certificaat | RMT Server | FAIL TLS-certificaat van webserver is verlopen |
| #14a-d | Schijfruimte | RMT Server, Agent | FAIL < 1 GB vrij. WARN: < 5 GB vrij |
| #15 | Recente logboekfouten | RMT Server, Agent | FAIL FATAL-fouten in logboeken. WARN: CRITICAL-fouten |
| #16 | RMT-status | RMT Server, Agent | FAIL rmtadmin-status retourneert foutpatronen |
| #17 | Geschiedenis Agentlogboek | Agent | Controleert bestanden voor het bijhouden van logboeken (.history, .json) in de datadirectory van de agent. WARN als bestanden onleesbaar of beschadigd zijn |
| #18a-f | Inventarisversie | RMT Server, Agent | INFO 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
| Afsluitcode | Status | Upgradegedrag |
| 0 | READY TO UPGRADE | Upgrade gaat door |
| 1 | UPGRADE WITH CAUTION | Upgrade gaat door; bekijk waarschuwingen |
| 2 | Geen upgrade uitvoeren | Upgrade geannuleerd |
| 3 | Scriptfout | Controleer uitvoeringsomgeving |
Scripts voor controle na een upgrade
| Afsluitcode | Status |
| 0 | ALL PASSED |
| 1 | WARNINGS PRESENT |
| 2 | CRITICAL 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 | Standaard | InstallerContext |
| #17 | PG-service | WARN bij Gestopt, FAIL bij Gestopt en Uitgeschakeld, INFO als alles is gestopt | WARN |
| #18 | PG-poort | WARN als er niet wordt geluisterd, INFO als alle services zijn gestopt | WARN |
| #22 | RabbitMQ-service | WARN bij Gestopt, FAIL bij Gestopt+Uitgeschakeld, INFO als alles is gestopt | WARN |
| #23 | Port 5672 (AMQP) | WARN als er niet wordt geluisterd, INFO als alle services zijn gestopt | WARN |
| #38a | Gestrande RMT processen | (zie controlebeschrijving) | SKIP (installatieprogramma beheert proceslevenscyclus) |
Drempelwaarden vóór upgrade
| Drempelwaarde | RMT Server | Agent | Eenheid |
| Schijfruimte FAIL | 20 | 5 | GB vrij |
| Schijfruimte WARN | 50 | 10 | GB vrij |
| Tijdelijke directory FAIL | 5 | 5 | GB vrij |
| Tijdelijke directory WARN | 10 | 10 | GB vrij |
| RAM FAIL | 8 | 4 | GB |
| RAM WARN | 16 | 8 | GB |
| CPU FAIL | 4 | 2 | kernen |
| CPU WARN | 8 | 4 | kernen |
| Databasegrootte FAIL | 500 | - | GB |
| Databasegrootte WARN | 200 | - | GB |
| Hangfire-schema FAIL | 10 | - | GB |
| Hangfire-schema WARN | 1 | - | GB |
| WAL-directory FAIL (Windows) | 10 | - | GB |
| WAL-directory FAIL (Windows) | 2 | - | GB |
| WAL-directory FAIL (Linux) | 10 | - | GB |
| Mnesia-directory WARN | 5 | - | GB |
| RabbitMQ-schijfalarm FAIL | 10 | - | GB vrij |
| Wachtrij-backlog WARN | 10000 | - | berichten |
| Vervallen van certificaat WARN | 30 | 30 | dagen |
| Retentieperiode voor opschonen WARN | 180 | - | dagen |
| Vervallen-tupelverhouding WARN | 20 | - | procent |
| Agent-heartbeat verouderd | 15 | - | minuten |
| Leeftijd netwerkstuurprogramma WARN | 3 | - | jaren |
| Grootte logboekdirectory WARN | 5 | 5 | GB |
| Grootte logboekdirectory WARN (ernstig) | 20 | 20 | GB |
Drempelwaarden na upgrade
| Drempelwaarde | Waarde | Eenheid |
| Schijfruimte FAIL | 1 | GB vrij |
| Schijfruimte WARN | 5 | GB vrij |
| Vervallen van certificaat WARN | 30 | dagen |
| Wachtrij-backlog WARN | 10000 | berichten |
| Logboekscanvenster | 60 | minuten |
| Opnieuw starten van RabbitMQ | 6 pogingen x 5 sec | 30 seconden in totaal |
Minimaal ondersteunde componentversies
| Component | Minimale 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
| Poort | Service | Richting |
| 80 | Webinterface RMT (HTTP) | Inkomend |
| 443 | Webinterface RMT (HTTPS) | Inkomend |
| 5672 | AMQP RabbitMQ | Inkomend op RMT Server |
| 5671 | AMQP RabbitMQ via TLS | Inkomend op RMT Server |
| 15672 | Gebruikersinterface RabbitMQ-beheer | Lokaal |
| 25672 | RabbitMQ tussen knooppunten | Lokaal |
| 5555 | Interne PostgreSQL | Lokaal |
