--- schema_version: "1" id: ae55c2f470dba40084715d79c15be794e38f49c9de19e0bc56880662d2930a12 title: RMT 업그레이드 상태 검사 스크립트 collection: tableau version: current locale: ko-kr portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server/rmt-admin-upgrade-health-scripts.md canonical_url: https://help.tableau.com/current/server/ko-kr/rmt-admin-upgrade-health-scripts.htm source_site: help.tableau.com content_type: documentation content_hash: 2e7770c6c5d23b3fb0cf3cf380f11b49fd4672bee7f580803b7739392e883960 description: Use the RMT pre-upgrade and post-upgrade health check scripts. --- [주요 콘텐츠로 건너뛰기](#main-content) # RMT 업그레이드 상태 검사 스크립트 2025.3.6 릴리스부터 RMT 설치 프로그램에 업그레이드 전후 Tableau RMT(Resource Monitoring Tool) 환경의 유효성을 검사하는 업그레이드 전 및 업그레이드 후 상태 검사 스크립트가 포함됩니다. 이러한 스크립트는 구성 오류, 사용 권한 변경, 디스크 공간 부족, 만료된 인증서, 서비스 장애 등 업그레이드 실패를 유발할 수 있는 기존 환경 내의 문제를 식별합니다. 업그레이드 전 및 업그레이드 후 상태 검사 스크립트는 다음과 같은 문제를 식별할 수 있습니다. - **데이터베이스 및 디스크 준비 상태**: 대규모 데이터베이스 또는 과도한 WAL 파일로 인해 마이그레이션이 중단되거나 디스크 공간이 소진되는지 감지합니다. - **사용 권한 및 보안 무결성**: 서비스 재시작이나 에이전트 재연결을 차단할 수 있는 파일 소유권 변경 사항이나 만료된 SSL 인증서를 식별합니다. - **종속성 유효성 검사**: PostgreSQL 15를 설치하기 전에 Visual C++ 2022 재배포 가능 패키지 및 OpenSSL 3.x와 같은 필수 Windows 구성 요소가 있는지 확인합니다. - **버전 논리 안전성**: 버전 메타데이터의 회귀 현상으로 인해 발생하는 '잘못된 다운그레이드' 오류를 방지합니다. ## 업그레이드 전 스크립트 업그레이드 전 스크립트는 업그레이드를 시작할 때 자동으로 실행됩니다. 기존 설치가 아직 존재하는 동안 RMT 서버 또는 Agent 호스트를 검사하고 PASS/FAIL/WARN 보고서를 생성합니다. **Linux**의 경우 업그레이드 전 검사가 다음의 일부로 자동 실행됩니다. sudo bash upgrade-rmt-master ... sudo bash upgrade-rmt-agent ... 자동 검사를 건너뛰려면(권장하지 않음): sudo bash upgrade-rmt-master --skip-pre-upgrade-check ... **Windows**의 경우 설치 프로그램이 업그레이드 전 검사를 자동으로 실행합니다. 설치 중에 업그레이드를 건너뛸 수 있는 옵션이 표시됩니다. 그러나 이는 권장되지 않습니다. ### 수동 업그레이드 전 검사 스크립트를 수동으로 실행하여 잠재적인 문제를 미리 볼 수 있습니다. 수동으로 실행하려면 운영 체제에 따라 다음 단계를 사용하십시오. **Linux의 경우:** 루트 사용자로 명령을 실행합니다. 데이터베이스 검사를 포함하려면 export 명령을 사용하여 비밀번호를 안전하게 전달합니다. sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh PostgreSQL 검사를 사용하도록 설정한 상태로 실행하려면 다음 명령을 사용합니다. export RMT\_DB\_PASSWORD="" sudo -E bash /opt/tableau/tabrmt/master/install-scripts/rmt-pre-upgrade-check.sh 특정 구성 요소 및 출력 경로를 사용하여 실행하려면 다음 명령을 사용합니다. sudo bash rmt-pre-upgrade-check.sh --component master --output /tmp/rmt-report.txt **Windows의 경우:** RMT 서버의 업그레이드 전 파일은 기본적으로 다음 위치에 설치됩니다. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1` Agent의 업그레이드 전 파일은 기본적으로 다음 위치에 설치됩니다. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\pre-upgrade\rmt-pre-upgrade-check.ps1` 스크립트를 수동으로 실행하려면 관리자 권한으로 PowerShell을 시작하고 다음을 실행합니다. `cd "C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\pre-upgrade"` .`\rmt-pre-upgrade-check.ps1` PostgreSQL 검사를 사용하도록 설정한 상태로 실행하려면 다음 명령을 사용합니다. $env:RMT\_DB\_PASSWORD = "" .\\rmt-pre-upgrade-check.ps1 특정 구성 요소 및 출력 경로를 사용하여 실행하려면 다음 명령을 사용합니다. .\\rmt-pre-upgrade-check.ps1 -Component master -OutputPath C:\\temp\\rmt-report.txt ### 추가 옵션 다음 옵션을 사용하여 업그레이드 전 검사를 사용자 지정합니다. `-Component` RMT 서버 또는 Agent를 지정합니다. 생략할 경우 스크립트가 이를 자동으로 감지합니다. `--db-password / -DbPassword` 내부 RMT 데이터베이스 관리자 비밀번호입니다. PostgreSQL 검사에 필요합니다. `--output / -OutputPath` 보고서를 저장할 위치를 지정합니다. 기본적으로 저장되는 위치: `/tmp/ (Linux) or C:\temp\ (Windows).` `--target-version / -TargetVersion` 설치하려는 RMT 버전이며, 버전별 검사를 사용하도록 설정합니다. `--quiet / -Quiet` 출력을 필터링하여 FAIL 및 WARN 결과만 표시합니다. `--verbose / -Verbose` 출력에는 수행된 모든 검사에 대한 자세한 기술 데이터가 표시됩니다. ### 스크립트 결과 및 필요한 동작 다음 표에는 스크립트 결과와 필요한 동작이 설명되어 있습니다.
결과상태동작
PASSEXIT CODE 0문제가 발견되지 않았습니다. 업그레이드가 계속 진행됩니다.
WARNEXIT CODE 1업그레이드가 계속 진행되지만 보고서를 검토하여 심각하지 않은 위험이 무엇인지 확인해야 합니다.
FAILEXIT CODE 2업그레이드가 중단되었습니다. 업그레이드를 다시 실행하기 전에 이러한 문제를 해결해야 합니다.
## 업그레이드 후 스크립트 업그레이드 후 상태 검사 스크립트는 모든 RMT 설치 및 업그레이드가 끝날 때 자동으로 실행됩니다. 모든 서비스가 올바르게 시작되었는지, 인프라가 정상 상태인지, 구성이 손상되지 않았는지를 검사합니다. 업그레이드 후 검사는 설치 프로그램을 차단하지 않습니다. 식별된 모든 오류는 최종 보고서에 기록됩니다. ### 수동 업그레이드 후 검사 수동으로 실행하려면 운영 체제에 따라 다음 단계를 사용하십시오. **Linux의 경우:** 루트 사용자 또는 `sudo` 권한이 있는 사용자로 다음 명령을 실행합니다. - RMT 서버의 경우: sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-post-upgrade-check --component master --mode upgrade - Agent의 경우: sudo bash /opt/tableau/tabrmt/agent/install-scripts/rmt-post-upgrade-check --component agent --mode upgrade **Windows의 경우:** RMT 서버의 업그레이드 후 파일은 기본적으로 다음 위치에 설치됩니다. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\post-upgrade\rmt-post-upgrade-check.ps1` Agent의 업그레이드 후 파일은 기본적으로 다음 위치에 설치됩니다. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent\scripts\post-upgrade\rmt-post-upgrade-check.ps1` 스크립트를 수동으로 실행하려면 관리자 자격으로 PowerShell을 열고 RMT 설치 디렉터리로 이동한 후 명령을 실행해야 합니다. - RMT 서버의 경우: .\\rmt-post-upgrade-check.ps1 -Component master -Mode upgrade - Agent의 경우: .\\rmt-post-upgrade-check.ps1 -Component agent -Mode upgrade ### 추가 옵션 다음 옵션을 사용하여 스크립트를 사용자 지정할 수 있습니다. `--component / -Component` RMT 서버 또는 Agent를 지정합니다. 생략된 경우 자동 감지가 시도됩니다. `--db-password / -DbPassword` 내부 RMT 데이터베이스 관리자의 비밀번호입니다. 이는 PostgreSQL 검사를 사용하도록 설정하는 데 필요합니다. `--output / -OutputPath` 보고서 파일이 저장될 경로입니다. 기본값은 `/tmp/ (Linux)` 또는 `C:\temp\ (Windows)`입니다. `--target-version / -TargetVersion` 업그레이드하려는 특정 RMT 버전이며, 버전별 검사에 사용됩니다. `--quiet / -Quiet` 출력을 축소하여 **FAIL** 및 **WARN** 결과만 표시합니다. `--verbose / -VerboseOutput` 수행된 모든 검사에 대한 자세한 기술 출력을 제공합니다. 참고: 명령줄 인수는 프로세스 목록에 표시되므로 RMT\_DB\_PASSWORD를 명령줄에서 직접 전달하기보다는 환경 변수로 설정하는 것이 좋습니다. ### 스크립트 결과 및 필요한 동작 다음 표에는 스크립트 결과와 필요한 동작이 설명되어 있습니다.
결과상태동작
PASSEXIT CODE 0시스템이 정상 상태입니다. 필요한 동작이 없습니다.
WARNEXIT CODE 1경고를 검토하십시오. 대부분은 자체적으로 해결됩니다(예: 일시적인 RabbitMQ 시작 지연).
FAILEXIT CODE 2하나 이상의 중요 검사에 실패했습니다. 조사하여 해결하십시오.
## 보고서 업그레이드 전 보고서는 다음 위치에서 찾을 수 있습니다. - Linux: `/tmp/rmt-precheck-.txt` - Windows(수동): `C:\temp\rmt-precheck--.txt` 업그레이드 후 보고서는 다음 위치에서 찾을 수 있습니다. - Linux: `/rmt-postcheck-report.txt` - Windows(수동): `C:\temp\rmt-postcheck--.txt` - Windows(설치 프로그램 사용): 설치 프로그램이 검사를 실행할 때 고정된 파일 이름이 사용됩니다. - `C:\temp\rmt-postcheck-master-report.txt` - `C:\temp\rmt-postcheck-agent-report.txt` 보고서의 업그레이드 전 및 업그레이드 후 검사에 대한 자세한 내용은 [업그레이드 참조서](https://help.tableau.com/current/server/ko-kr/rmt-admin-upgrade-reference.htm) 섹션을 참조하십시오. ### 샘플 보고서 다음은 업그레이드 전 상태 검사 보고서 샘플입니다. \================================================================== RMT Pre-Upgrade Health Check Report Script Version : 1.0.0 Generated : 2026-04-08 14:30:00 Component : master Hostname : rmt-master-01.example.com RMT Version : 2025.1.9 \================================================================== OVERALL STATUS : UPGRADE WITH CAUTION (2 warning(s) -- review before proceeding) PASS: 44 FAIL: 0 WARN: 2 INFO: 10 SKIP: 3 \================================================================== WARNINGS -- Review Before Upgrading \================================================================== \[WARN\] #21d Hangfire schema is 1.2 GB Check 21g for delete\_hash() volatility bug \[WARN\] #24 1 queue(s) with >10000 messages (max: 15234) Resolve backlogs before upgrading