다음 섹션에서는 업그레이드 후 검사에서 자주 식별되거나 업그레이드 직후에 관찰되는 문제에 대해 자세히 설명합니다.

업그레이드 전 및 업그레이드 후 검사에 대한 자세한 내용은 업그레이드 참조서 섹션을 참조하십시오.

서비스가 실행되고 있지 않음

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 업그레이드의 적용 범위에 포함되지 않으므로, 이 오류는 실제 시스템 충돌을 의미하지 않습니다.