--- schema_version: "1" id: 94c506fbd4a4f3415a0f1975e7ac4c098dbca29ccbbd5084576bdac1cc63e81e title: 업그레이드 후 오류 문제 해결 collection: tableau version: current locale: ko-kr portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server-linux/rmt-troubleshoot-upgrade.md canonical_url: https://help.tableau.com/current/server-linux/ko-kr/rmt-troubleshoot-upgrade.htm source_site: help.tableau.com content_type: documentation content_hash: 83da4be202772c1bda404ee855b31fa667ebb3ba416ff2e4bbb76fd740a50ce4 description: Troubleshoot errors encountered after upgrading the Resource Monitoring Tool. --- [주요 콘텐츠로 건너뛰기](#main-content) # 업그레이드 후 오류 문제 해결 다음 섹션에서는 업그레이드 후 검사에서 자주 식별되거나 업그레이드 직후에 관찰되는 문제에 대해 자세히 설명합니다. 업그레이드 전 및 업그레이드 후 검사에 대한 자세한 내용은 [업그레이드 참조서](https://help.tableau.com/current/server-linux/ko-kr/rmt-admin-upgrade-reference.htm) 섹션을 참조하십시오. ## 서비스가 실행되고 있지 않음 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 업그레이드의 적용 범위에 포함되지 않으므로, 이 오류는 실제 시스템 충돌을 의미하지 않습니다.