Windows 기반 Tableau Server 도움말

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="<tabrmtdb-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 = "<tabrmtdb-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

출력에는 수행된 모든 검사에 대한 자세한 기술 데이터가 표시됩니다.

스크립트 결과 및 필요한 동작

다음 표에는 스크립트 결과와 필요한 동작이 설명되어 있습니다.

업그레이드 후 스크립트

업그레이드 후 상태 검사 스크립트는 모든 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를 명령줄에서 직접 전달하기보다는 환경 변수로 설정하는 것이 좋습니다.

스크립트 결과 및 필요한 동작

다음 표에는 스크립트 결과와 필요한 동작이 설명되어 있습니다.

보고서

업그레이드 전 보고서는 다음 위치에서 찾을 수 있습니다.

• Linux: /tmp/rmt-precheck-<timestamp>.txt

• Windows(수동): C:\temp\rmt-precheck-<component>-<timestamp>.txt

업그레이드 후 보고서는 다음 위치에서 찾을 수 있습니다.

• Linux: <log-dir>/rmt-postcheck-report.txt

• Windows(수동): C:\temp\rmt-postcheck-<component>-<timestamp>.txt

• Windows(설치 프로그램 사용): 설치 프로그램이 검사를 실행할 때 고정된 파일 이름이 사용됩니다.

  • C:\temp\rmt-postcheck-master-report.txt

  • C:\temp\rmt-postcheck-agent-report.txt

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

샘플 보고서

다음은 업그레이드 전 상태 검사 보고서 샘플입니다.

==================================================================
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