RMT アップグレードのヘルスチェックスクリプト

適用先: Tableau Advanced Management

2025.3.6 リリース以降、RMT インストーラーにはアップグレード前とアップグレード後のヘルスチェックスクリプトが含まれており、アップグレードの前後に Tableau Resource Monitoring Tool (RMT) 環境を検証できます。これらのスクリプトは、構成ミス、権限のずれ、ディスク領域の不足、期限切れの証明書、または以前から存在していたサービス障害など、環境内の既存の問題を特定します。これらの問題は、アップグレードが失敗する原因となる可能性があります。

アップグレード前後のヘルスチェックスクリプトで、次の問題を特定できます。

データベースとディスクの準備: 大規模なデータベースや過剰な WAL ファイルによって、移行がハングしたり、ディスク領域が枯渇したりするかどうかを検出します。
パーミッションとセキュリティの整合性: ファイル所有権の移行や SSL 証明書の期限切れなど、サービスの再起動やエージェントの再接続を阻害する原因となる問題を特定します。
依存関係の検証: PostgreSQL 15 がインストールされる前に、Visual C++ 2022 Redistributable や OpenSSL 3.x などの必要な Windows コンポーネントが存在することを確認します。
バージョンロジックの安全性: バージョンのメタデータのリグレッションによって引き起こされる「誤ったダウングレード」エラーを防止します。

アップグレード前のスクリプト

アップグレード前のスクリプトは、アップグレードを開始すると自動的に実行されます。既存のインストール環境を維持したまま RMT サーバーまたはエージェントのホストを検査し、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 の場合:

root ユーザーとしてコマンドを実行してください。データベースチェックを含めるには、`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

エージェントのアップグレード前のファイルは、既定で次の場所にインストールされます。

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 サーバーまたはエージェントを指定してください。省略された場合、スクリプトはこれを自動的に検出します。

--db-password / -DbPassword

内部 RMT データベースの管理者パスワードです。PostgreSQL のチェックに必要です。

--output / -OutputPath

レポートを保存する場所を指定します。既定では、/tmp/ (Linux) or C:\temp\ (Windows). に保存されます。

--target-version / -TargetVersion

インストールする予定の RMT バージョン。バージョン固有のチェックを有効にします。

--quiet / -Quiet

出力をフィルタリングして、FAIL (失敗) と WARN (警告) の結果のみを表示します。

--verbose / -Verbose

出力には、実行された各チェックの詳細な技術データが表示されます。

スクリプトの結果と必要なアクション

次の表で、スクリプトの結果とアクションを説明します。

結果	ステータス	アクション
PASS (成功)	終了コード 0	問題は検出されませんでした。アップグレードが進行します。
WARN (警告)	終了コード 1	アップグレードは続行されますが、重大ではないリスクについてレポートを確認する必要があります。
FAIL (失敗)	終了コード 2	アップグレードは中止されました。アップグレードを再実行する前に、これらの問題を解決する必要があります。

アップグレード後のスクリプト

アップグレード後のヘルスチェックスクリプトは、各 RMT のインストールとアップグレードの最後に自動的に実行されます。すべてのサービスが正しく開始されたこと、インフラストラクチャが正常であること、構成に問題がないことを検証します。アップグレード後のチェックによってインストーラーがブロックされることはありません。特定されたすべての不具合は、最終レポートに記録されます。

手動でのアップグレード後の確認

手動で実行するには、オペレーティングシステムに応じて次の手順を実行します。

Linux の場合:

root ユーザーとして、または sudo 権限を使用して、次のコマンドを実行します。

RMT サーバー:

sudo bash /opt/tableau/tabrmt/master/install-scripts/rmt-post-upgrade-check --component master --mode upgrade

エージェント:

sudo bash /opt/tableau/tabrmt/agent/install-scripts/rmt-post-upgrade-check --component agent --mode upgrade

Windows の場合:

RMT Server のアップグレード後のファイルは、既定では次の場所にインストールされます。

C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\scripts\post-upgrade\rmt-post-upgrade-check.ps1

エージェントのアップグレード後のファイルは、既定で次の場所にインストールされます。

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

エージェント:

.\rmt-post-upgrade-check.ps1 -Component agent -Mode upgrade

その他のオプション

次のオプションを使用して、スクリプトをカスタマイズできます。

--component / -Component

RMT サーバーまたはエージェントを指定してください。省略した場合、スクリプトはこれを自動検出しようとします。

--db-password / -DbPassword

内部 RMT データベース管理者のパスワードです。PostgreSQL のチェックを有効にするために必要です。

--output / -OutputPath

レポートファイルが保存されるパスです。既定では /tmp/ (Linux) or C:\temp\ (Windows) です。

--target-version / -TargetVersion

アップグレード先の特定の RMT バージョンです。バージョン固有のチェックに使用されます。

--quiet / -Quiet

出力を減らして、FAIL (失敗) と WARN (警告) の結果のみを表示します。

--verbose / -VerboseOutput

実行されるすべてのチェックについて、詳細な技術的情報が出力されます。

注: コマンドラインの引数はプロセスリストに表示されるため、RMT_DB_PASSWORD はコマンドラインで渡すのではなく、環境変数として設定することをお勧めします。

スクリプトの結果と必要なアクション

次の表で、スクリプトの結果とアクションを説明します。

結果	ステータス	アクション
PASS (成功)	終了コード 0	システムは正常です。必要なアクションはありません。
WARN (警告)	終了コード 1	警告を確認してください。ほとんどは自然に解決します (一時的な RabbitMQ の起動の遅延など)。
FAIL (失敗)	終了コード 2	1 つまたは複数の重要なチェックが失敗しました。調査して再修復してください。

レポート

アップグレード前のレポートは、こちらにあります。

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

一番上に戻る

フィードバックをお送りいただき、ありがとうございます。

フィードバックは正常に送信されました。ありがとうございます!

Tableau Server on Windows ヘルプ