サーバーのアップグレード - 構成の詳細の収集
インプレース アップグレードを実行する場合 (つまり、アップグレードの一環としてハードウェアを更新しない場合)、ほぼすべての構成データが保持されます。厳密に言うと、この場合、すべての構成情報を収集する必要はありませんが、このトピックで説明している情報を収集することをお勧めします。最悪のシナリオでは、アップグレードが失敗した場合、必要な復元に備えて、すべての構成情報が記録されます。いずれの場合も、収集した構成の詳細を使用して、完了したアップグレードを検証できます。
スクリーン ショットの取得
構成の基本を比較的簡単にキャプチャする方法は、Tableau サービス マネージャーの Web インターフェイス ページと Tableau Server 管理者エリアのスクリーン ショットを取得することです。
表示されているすべてのページをクリックして、スクリーン ショットを取得します。
オブジェクト数の記録
Tableau Server 管理者エリアにサインインしているときに、各サイトで次の項目をカウントして記録します。
- プロジェクト、ワークブック、ビュー、データ ソース
- ユーザーとグループ
アセット ファイルの収集
Tableau Server にアップロードするサポート ファイル (証明書、IdP メタデータ、ロゴなど) の多くは、アップロード後に Tableau サービス マネージャーを使用してアクセスできません。具体的には、クライアント ファイル サービスによってアップロードおよび管理されるファイルは、展開全体に配布される前に名前が変更され、難読化されます。このプロセスでは、Tableau サービスに必要なファイル属性もパラメーター化されます。その結果、ファイルは、以降のファイルのファイル システム上でファイルの単一の場所にマッピングされません。以降のファイルをアップロードした場合、Tableau Server を実行している PC からそれらのファイルのコピーを保存してください。
- SAML 証明書ファイル
- SAML キー ファイル
- SAML IdP メタデータ ファイル
- OpenID.static.file
- Kerberos.keytab ファイル
- LDAP Kerberos keytab ファイル
- LDAP Kerberos conf ファイル
- 相互 SSL 証明書ファイル
- 相互 SSL 失効ファイル
- カスタマイズ ヘッダー ロゴ ファイル
- カスタマイズ サインイン ロゴ ファイル
- カスタマイズ コンパクト ロゴ ファイル
カスタムの構成情報の収集
一部の構成情報は、Tableau サービス マネージャーまたは Tableau Server の Web ページに表示されません。このセクションでは、Tableau の展開をカスタマイズした方法に応じて収集が必要になる場合がある構成の詳細を説明します。
セキュア SMTP
Tableau Server 用に TLS を構成している場合は、Tableau サービス マネージャーの Web UI の電子メール サーバー構成に含まれていない TLS 関連の構成を記録する必要があります。
TLS 関連の構成を収集するには、次のキー値を指定して tsm configuration get コマンドを実行する必要があります。
svcmonitor.notification.smtp.ssl_enabledsvcmonitor.notification.smtp.ssl_requiredsvcmonitor.notification.smtp.ssl_check_server_identitysvcmonitor.notification.smtp.ssl_trust_all_hostssvcmonitor.notification.smtp.ssl_cipherssvcmonitor.notification.smtp.ssl_versions
たとえば、SMTP TLS 用に構成されている暗号のリストを取得するには、次のコマンドを実行します。
tsm configuration get -k svcmonitor.notification.smtp.ssl_ciphers
上記の各キーの詳細については、「SMTP セットアップの構成」の「Tableau サービス マネージャー CLI」セクションを参照してください。
分析拡張機能
分析拡張機能 (以前は「外部サービス」と呼ばれていました) を構成している場合は、構成情報を記録する必要があります。Tableau Server 2020.2 以降にアップグレードすると、この機能のすべての構成が削除されます。
Tableau Server バージョン 2019.1 ～ 2020.1 から分析拡張機能の構成を取得するには、次のコマンドを実行します。
tsm security vizql-extsvc-ssl list
分析拡張機能の接続用に保存されているパスワードを取得するには (存在する場合)、次の tsm コマンドを実行します。
tsm configuration get -k vizqlserver.rserve.password
SSL を構成している場合は、分析拡張機能の証明書のコピーも必要です。
外部リポジトリ
これは、Tableau Server で外部リポジトリ構成を使用している場合にのみ適用されます。適用されるかどうかがわからない場合は、Tableau Server 外部リポジトリを参照してください。
外部リポジトリを使用している場合は、アップグレード時に追加の手順が必要になる場合があります。
- バージョンの変更なし - PostgreSQL にバージョンの変更がない場合、特別なアクションは必要ありません。
- マイナー バージョンの変更 - PostgreSQL にマイナー バージョンの変更がある場合、Tableau Server をアップグレードする前に外部リポジトリをアップグレードする必要があります。ほとんどの場合、アップグレードを行うためのインプレース メソッドがあります。使用するメソッドはリポジトリの場所によって異なり、このドキュメントの対象外です。
メジャー バージョンの変更 - PostgreSQL にメジャー バージョンの変更がある場合、「新しいメジャー バージョンの PostgreSQL を外部リポジトリとして使用する Tableau Server のアップグレード」で説明されている手順に従う必要があります。
次のステップが含まれます。
- PostgreSQL DB の新しいインスタンスを作成します。詳細については、以下を参照してください。
- 構成ファイルを作成し、ステップ 1 で作成した新しいインスタンスの SSl 証明書ファイルをダウンロードします。
アップグレード中に、構成ファイルを使用して新しいインスタンスに Tableau Server を指定する必要があります。アップグレード プロセスによって、コンテンツが現在の外部リポジトリから新しいインスタンスに移行します。詳細については、新しいメジャー バージョンの PostgreSQL を外部リポジトリとして使用する Tableau Server のアップグレードを参照してください。
外部ファイル ストア
外部ファイル ストアを使用して構成された Tableau Server をアップグレードする場合、特別な手順、アクション、構成は必要ありません。通常の手順を使用して Tableau Server をアップグレードできます。
ポートのカスタマイズ
Tableau Server の動的ポート範囲を変更した場合、または手動でポートを構成した場合は、これらの変更を記録してください。
次のコマンドを実行します。
tsm topology list-ports
詳細については、「Tableau サービス マネージャーのポート」を参照してください。
プロキシのカスタマイズ
OAuth を使用していて、<drive>:\Program Files\Tableau\Tableau Server\packages\repository.<version>\jre\conf フォルダー内にある Tableau Server の net.properties ファイルに変更を加えた場合は、その変更内容を記録してください。アップグレード プロセスにより、新しい net.properties ファイルが作成されるため、アップグレード後に新しいファイルを更新する必要がある場合があります。
コピーを安全な場所に保存し、アップグレード後にそのコピーを使用して新しく作成されたファイルと比較し、相違点がないかどうかを確認することができます。
詳細については、Tableau Desktop と Web 作成ヘルプの「OAuth 認証用のプロキシの構成(新しいウィンドウでリンクが開く)」を参照してください。