--- schema_version: "1" id: e2432ba8afc5a47a3efc8e4b5efeebdf1a04f36f79e416003326e20cd7d38fdc title: RMT アップグレードのヘルス チェック スクリプト collection: tableau version: next locale: ja-jp portal_url: https://docs.salesforce.com/tableau/next/ja-jp/server-linux/rmt-admin-upgrade-health-scripts.md canonical_url: https://help.tableau.com/v0.0/server-linux/ja-jp/rmt-admin-upgrade-health-scripts.htm source_site: help.tableau.com content_type: documentation content_hash: 78391f2b727a0204530648ad5d251c62052e6cd0628459abe5cb6f265fe6f68a description: Use the RMT pre-upgrade and post-upgrade health check scripts. --- [メイン コンテンツに進む](#main-content) # RMT アップグレードのヘルス チェック スクリプト 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="" 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 = "" .\\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 (失敗)終了コード 21 つまたは複数の重要なチェックが失敗しました。調査して再修復してください。
## レポート アップグレード前のレポートは、こちらにあります。 - 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/v0.0/server-linux/ja-jp/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