다음 섹션에서는 업그레이드 후 검사에서 자주 식별되거나 업그레이드 직후에 관찰되는 문제에 대해 자세히 설명합니다.
업그레이드 전 및 업그레이드 후 검사에 대한 자세한 내용은 업그레이드 참조서 섹션을 참조하십시오.
서비스가 실행되고 있지 않음
RMT 웹 사용자 인터페이스에 액세스할 수 없으며 rmtadmin status 명령을 실행하니 필수 서비스가 중지되었다고 나타납니다.
업그레이드 후 검사 #1, #2, #16으로 감지됩니다.
이 문제를 해결하려면 다음 단계를 사용합니다.
Linux의 경우 다음 명령을 사용합니다.
sudo -u tabrmt-master XDG_RUNTIME_DIR=/run/user/$(id -u tabrmt-master) systemctl --user start tabrmt-master
Windows의 경우 다음 명령을 사용합니다.
Start-Service TableauResourceMonitoringTool
로그 디렉터리의 서비스 로그에서 시작 오류를 확인합니다.
PostgreSQL이 연결을 허용하지 않음
웹 UI에 데이터베이스 오류가 표시되고 데이터가 저장되지 않는 경우입니다.
업그레이드 후 검사 #5c, #6으로 감지됩니다.
이 문제를 해결하려면 다음을 확인하십시오.
PostgreSQL 서비스가 실행 중인지 확인
데이터 디렉터리의 PostgreSQL 로그에서 시작 오류 확인
데이터베이스 포트(기본값 5555)가 다른 프로세스에 의해 차단되지 않았는지 확인
RabbitMQ가 응답하지 않음
Agent가 연결 끊김으로 표시되고 새 모니터링 데이터가 표시되지 않는 경우입니다.
업그레이드 후 검사 #5b, #7, #9로 감지됩니다.
이 문제를 해결하려면 다음을 확인하십시오.
업그레이드 후 RabbitMQ가 완전히 초기화되려면 30~60초 정도 걸릴 수 있음 - 기다렸다가 다시 확인
Erlang/beam 프로세스가 실행 중인지 확인
RabbitMQ 리소스 경보 확인(디스크 공간이 10GB 미만이면 모든 메시지 게시가 차단됨)
Erlang 쿠키 파일이 존재하고 올바른 사용 권한을 보유하고 있는지 확인
메시지 큐 백로그
RMT 웹 UI에서 데이터가 지연된 것으로 나타나고 대시보드에 오래된 메트릭이 표시됩니다.
업그레이드 후 검사 #8로 감지됩니다.
업그레이드 직후 Agent가 다시 연결하여 버퍼링된 데이터를 다시 보낼 때 백로그가 발생하는 것은 정상입니다. 이를 수행하려면 다음을 수행합니다.
`mtadmin status`로 모니터링 - 백로그가 15-30분 이내에 지워져야 함
백로그가 지속되면 모든 Agent 서비스가 실행 중이고 연결되어 있는지 확인
RMT 서버 작업자가 소비되지 않음(업그레이드 후 데이터가 수집되지 않음)
모든 RMT 서비스가 실행 중이고 업그레이드 후 검사가 서비스/포트/연결을 통과한다고 보고하지만 웹 UI에는 새 데이터가 표시되지 않고 Agent가 '연결 문제'로 나타납니다. `rmtadmin status` 명령어를 실행하면 메시지가 쌓여 있는 큐가 하나 이상 표시되지만, 소비자 수는 **0**으로 나타납니다.
이는 RMT 서버의 백그라운드 작업자가 시작되지만, 현재 위치 업그레이드 후 RabbitMQ 소비자 채널에 다시 바인딩하는 데 실패할 때 발생합니다. Agent가 게시에 성공하고 메시지가 RabbitMQ에 누적되지만 데이터베이스에 아무것도 도착하지 않습니다.
업그레이드 후 검사 #8a로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
마스터 다시 시작:
`rmtadmin restart`약 60초 동안 기다린 후 `
rmtadmin status` 다시 실행 - 중단된 큐는 이제 'Consumers = 1'로 표시되어야 하며 백로그는 몇 분 이내에 비워져야 함다시 시작한 후에도 큐에 `Consumers = 0`이 계속 표시되면 백그라운드 로그에서 consumer-binding 예외 검사:
Windows: `
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\logs\background\*.log`Linux: `
/var/opt/tableau/tabrmt/master/logs/background/*.log`로그에서 `
exception`, `channel` 또는 `binding failed` 검색
FIPS 모드 불일치
암호화 또는 TLS 오류로 인해 서비스가 시작되지 않는 경우입니다.
업그레이드 후 검사 #11로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
OS 수준 FIPS 설정이 RMT 구성(setup.json의 `isFIPSEnabled`)과 일치하는지 확인
Linux:
`/proc/sys/crypto/fips_enabled` 확인Windows: `
HKLM:\SYSTEM\CurrentControlSet\Control\Lsa\FIPSAlgorithmPolicy\Enabled` 확인
구성 파일 손상
JSON 구문 분석 오류와 함께 서비스가 시작되지 않습니다.
업그레이드 후 검사 #3로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
구성 파일의 유효성 검사: `
python3 -c "import json; json.load(open('config.json'))"`업그레이드 전 백업에서 복원(모든 업그레이드 전에 백업 권장)
SSL 인증서가 만료되었거나 만료 예정임
웹 브라우저에 인증서 경고가 표시되고 Agent가 TLS 오류와 함께 연결에 실패하는 경우입니다.
업그레이드 후 검사 #10, #13으로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
HTTPS 인증서를 갱신하고
`rmtadmin set-ssl-certificate`를 사용하여 업데이트RabbitMQ 인증서의 경우 인증서 디렉터리에서 PEM 파일을 바꾸고 서비스 다시 시작
디스크 공간 소진
서비스가 충돌하거나 로그에 데이터 및 데이터베이스 오류를 기록하지 못하는 경우입니다.
업그레이드 후 검사 #14, 업그레이드 전 검사 #2 #2b로 감지됩니다.
이를 수정하려면 다음을 수행합니다.
디스크 여유 공간을 확보하거나 볼륨 확장
데이터베이스 정리 실행: config.json에서 `
db:cleanup:type`가 `None`이 아닌 `Purge`로 설정되어 있는지 확인오래된 로그 파일 아카이빙 또는 삭제
로그의 FATAL 또는 CRITICAL 오류
업그레이드 후 예기치 않은 동작이 발생하거나 서비스가 불안정합니다.
업그레이드 후 검사 #15로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
업그레이드 직후의 '브로커에 연결할 수 없음' 오류는 일반적으로 일시적임. RabbitMQ가 현재 실행되고 있는지 확인
다른 FATAL 오류의 경우 전체 로그 항목을 검토하고 로그 파일을 사용하여 Tableau 지원 부서에 문의
RMT 서버 업그레이드 후 Agent 연결 끊김
Agent가 RMT 웹 UI에서 연결 끊김으로 표시되고, 특정 Tableau Server 노드의 모니터링 데이터가 없습니다.
업그레이드 전 검사 #36b, #36c #36d로 감지됩니다.
RMT 서버 업그레이드가 완료되면 Agent가 자동으로 다시 연결됩니다. 이 문제가 해결될 때까지 5~10분 정도 기다립니다. 해결되지 않으면 다음을 확인합니다.
각 Agent 호스트에서 Agent 서비스가 실행되고 있는지 확인
Agent가 훨씬 이전 버전을 실행하는 경우 RMT 서버 버전과 일치하도록 업그레이드
Agent와 RMT 서버 호스트 간의 네트워크 연결(AMQP 포트 5672) 확인
알려진 결함이 있는 버전의 회귀 현상
설치된 버전의 알려진 결함으로 인해 특정 기능이 손상된 경우입니다.
업그레이드 전 검사 #36a로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
후속 패치 릴리스로 업그레이드(예: 2025.3.0에서 2025.3.1 이상으로 업그레이드)
버전별 패치에 대해서는 Tableau 지원 팀에 문의
Hangfire 정리 기능이 손상됨(W-19380780)
데이터베이스가 지속적으로 증가하고 hangfire 스키마가 비정상적으로 큽니다(1GB 초과).
업그레이드 전 검사 #21d, #21g로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
고정 버전으로 업그레이드하여
delete_hash()함수 변동성을 수정합니다.hangfire 스키마의 분리된 행은 수동 정리가 필요할 수 있습니다. Tableau 지원 팀에 문의하십시오.
데이터베이스 정리 사용 안 함
시간이 지남에 따라 데이터베이스 크기가 제한 없이 증가하고 업그레이드 속도가 느려집니다.
업그레이드 전 검사 #21c로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
config.json에서db:cleanup:type을Purge로 설정db:cleanup:afterDays를 30~90일로 단축(기본값: 14일)RMT Director 서비스를 다시 시작하여 변경 사항 적용
파일 사용 권한 문제
서비스가 시작되지 않거나 구성을 읽을 수 없고 로그를 기록할 수 없습니다.
업그레이드 후 검사 #4, 업그레이드 전 검사 #11~#16으로 감지됩니다.
이 문제를 해결하려면 다음을 확인하십시오.
Linux: 구성, 로그 및 데이터 디렉터리의 소유권 및 그룹 멤버십 확인
Windows: 서비스 계정에 설치 디렉터리에 대한 읽기/쓰기 권한이 있는지 확인
새로 설치한 후에도 사용 권한 문제가 지속되면 Tableau 지원 팀에 문의
rmtadmin stop 명령어 실행 후 RMT 프로세스가 중단됨
문서에 설명된 업그레이드 절차에 따라 rmtadmin stop을 실행한 후에도 하나 이상의 tabrmt-master, tabrmt-master-background, tabrmt-agent 또는 tabrmt-agent-background 프로세스가 계속 실행 중입니다. 이 상태에서 업그레이드가 진행되면 설치 프로그램이 실행 중간에 실패하고 파일이 사용 중이라는 오류가 발생할 수 있습니다.
업그레이드 전 검사 #38a로 감지됩니다.
이를 수행하려면 다음을 수행합니다.
정상 종료를 위해 약 30초간 기다린 다음 업그레이드 전 검사 다시 실행
프로세스가 지속되는 경우:
Linux: `
pkill -u tabrmt-master -f tabrmt-master ; pkill -u tabrmt-agent -f tabrmt-agent`(이 노드에 적용되지 않는 것은 건너뜀)Windows: `
Stop-Process -Name tabrmt-master,tabrmt-master-background,tabrmt-agent,tabrmt-agent-background -Force`업그레이드를 시작하기 전에 업그레이드 전 검사를 다시 실행하여 정리된 상태인지 확인
공동 위치 업그레이드 중 거짓 오류 발생
RMT 마스터와 Agent가 동일한 컴퓨터에 공동 위치한 경우 Agent의 업그레이드 전 검사(특히 #38a 검사)가 마스터 프로세스를 잘못 감지할 수 있습니다. 스크립트가 tabrmt-agent-*를 엄격하게 필터링하는 대신 모든 tabrmt-* 프로세스를 검사하기 때문에 거짓 FAIL 상태가 트리거될 수 있습니다.
대부분의 환경에서는 별도의 컴퓨터를 사용하며, 이 문제가 발생하지 않습니다. 그러나 같은 위치에 배치된 설치를 사용하고 있는데 이 특정 오류가 발생하면 다음을 사용하여 검사를 우회하고 설치를 안전하게 진행할 수 있습니다.
--skip-upgrade-checks
기술적 세부 정보:
근본 원인: #38a 검사는 지나치게 포괄적인 방식으로 일치하는 프로세스 이름(tabrmt-*)을 찾습니다.
범위: 마스터와 Agent가 동일한 OS 인스턴스를 공유하는 현재 위치 업그레이드인 경우에만 영향을 받습니다.
위험 수준: 낮음. 마스터 프로세스는 Agent 업그레이드의 적용 범위에 포함되지 않으므로, 이 오류는 실제 시스템 충돌을 의미하지 않습니다.