障害復旧(ディザスターリカバリー)の準備
重要
以下の表に記載されているServerのバージョンをお使いの場合、このガイドのプロセスは不要です。お使いのマシンのRuntimeSettings.xmlとデータベースのコピーが利用可能な場合は、 Serverホスト復元ガイド に従って障害復旧を行うことができます。
Serverホスト復元ガイド を使用するAlteryx Serverのバージョン |
---|
2021.4.2.47792 (パッチ4)以前のバージョンまたはパッチ |
2022.1.1.42590 (パッチ1および2) |
障害復旧の準備- RuntimeSettings.xml
先日の暗号化方式の変更(TGAL-6764)により、ユーザーは、元のAlteryx Serverコントローラーノードが使用できなくなった場合の障害復旧シナリオに対し、事前に備える必要があります。このガイドでは、障害復旧に使用するバックアップコントローラーノード上のRuntimeSettings.xmlファイルを準備する手順について説明します。
注記
このガイドでは、障害復旧に必要な永続レイヤーのバックアップの作成については説明しておりません。Serverのバックアップと組み込みのMongoDBの復元の詳細については、「Serverのバックアップと復元におけるベストプラクティス」の パート1 と パート2 をご覧ください。ユーザー管理型のMongoDBまたはSQL Serverインスタンスについては、MongoDB管理者またはSQL Server管理者にお問い合わせください。
重要
本セクションでは、以下2つのマシンで説明します。
元のマシン : Alteryx Serverを実行している現在のマシンです。
ターゲットマシン : 障害復旧に使用するバックアップマシンです。このマシンは、バックアップマシンとして使用するためのAlteryx Serverライセンスは不要です。
必要条件
元のマシンおよびターゲットマシンへの管理者アクセス。
元のマシンが動作可能で、Alteryx Serviceが実行されている必要があります。
元のマシン | 互換性のあるターゲットマシン |
---|---|
2021.4.2.47792 (パッチ5)以降のパッチ | 2021.4.2.47884 (パッチ11)以降の2021.4バージョンのパッチ |
2022.1.1.42590 (パッチ3)以降のパッチ | 2022.1.1.42691 (パッチ9)以降の2022.1バージョンのパッチ |
2022.3.1.430 (Server GA)以降のパッチ | 2022.3.1.553 (パッチ6)以降の2022.3バージョンのパッチ |
2023.1.1.123 (Server GA)以降のパッチ | 2023.1.1.247 (パッチ2)以降の2023.1バージョンのパッチ |
Alteryx Serverのすべての最新バージョンおよび将来のバージョン | 元のマシンとターゲットマシンが同じバージョンとパッチであれば、GAまたはパッチリリースは問いません。 |
ステップ1: Alteryx Serverをインストールする
# | ステップ | 詳細 |
---|---|---|
1.1 | 元のマシンとターゲットマシンにAlteryx Serverの最新バージョンとパッチをアップグレードまたはインストールできますか? | はい: 元のマシンとターゲットマシンにAlteryx Serverの最新バージョンとパッチをアップグレードまたはインストールします。元のマシンを通常どおり設定します。 ステップ2.1 に進みます。 注記 この手順ではライセンスは必要ないため、インストール後にAlteryx Serverをターゲットマシンで設定する必要はありません。 |
いいえ: ステップ1.2 に進みます。 | ||
1.2 | 元のマシンとターゲットマシンを、そのバージョンの最新パッチにアップグレードできますか? | はい: 元のマシンにメジャーバージョンの最新のパッチを 適用 し、ターゲットマシンに一致する最新のバージョンとパッチをインストールします。たとえば、2022.3パッチ3を使用している場合は、2022.3で利用可能な最新のパッチをインストールします。 ステップ2.1 に進みます。 注記 この手順ではライセンスは必要ないため、インストール後にAlteryx Serverを設定する必要はありません。 |
いいえ: ステップ1.3 に進みます。 | ||
1.3 | 元のマシンのAlteryx Serverのバージョンは、 必要条件 セクションの 互換性のあるターゲットマシン のリストに記載されていますか? | はい: ターゲットマシンを、元のマシンとまったく同じメジャーバージョンおよびパッチバージョンにインストールまたはアップグレードします。パッチインストールではなく、フルインストールファイルを使用してください。 必要に応じて、 fulfillment@alteryx.com に連絡して、必要なインストールファイルを要求してください。 ステップ2.1 に進みます。 注記 この手順ではライセンスは必要ないため、インストール後にAlteryx Serverを設定する必要はありません。 |
いいえ: ステップ1.4 に進みます。 | ||
1.4 | ターゲットマシンにAlteryx Serverの最新のパッチバージョンをインストールします。 | ターゲットマシンに、元のマシンにインストールされているメジャーバージョンで利用可能な最新のパッチをインストールまたはアップグレードします(たとえば、元のマシンが2022.3パッチ3を使用している場合は、ターゲットマシンに2022.3の最新のパッチをインストールします)。 ステップ2.1 に進みます。 注記 この手順ではライセンスは必要ないため、インストール後にAlteryx Serverを設定する必要はありません。 |
ステップ2: コントローラートークンとRuntimeSettings.xmlを準備およびコピーする
# | ステップ | 詳細 |
---|---|---|
2.1 | 元のマシンの コントローラートークンの長さ を確認します。 | [ Alteryxシステム設定 ] > [ Controller ] (コントローラー) > [ General ] (一般)で、[ View ] (表示)を選択します。コントローラートークンの長さを記録します。 注記 一部のバージョンでは、コントローラートークンが部分的に表示されません。トークンをダブルクリックして全体を強調表示し、テキストドキュメントにコピー/ペーストして長さを確認します。 |
2.2 | コントローラートークンの長さは40文字ありますか? | はい: [ Alteryxシステム設定 ] > [ Controller ] (コントローラー) > [ Genera ] (一般) > [ Regenerate ] (再生成)を選択します。 |
いいえ: ステップ2.5 に進みます。 | ||
2.3 | AlteryxService を再起動します。 | [ Alteryxシステム設定 ]の残りの設定を確認して、[ Finish ] (完了)を選択します。これによりAlteryxServiceが再起動します。 |
2.4 | 追加のノードを再接続します(該当する場合)。 | マルチノードセットアップの場合は、新しく再生成したコントローラートークンを使用して、すべてのノードをコントローラーノードに再接続します。 |
2.5 | 元のマシンから[ コントローラートークン ]を保存してコピーします。 | コントローラートークンは、[ Alteryxシステム設定 ] > [ Controller ] (コントローラー) > [ General ] (一般) > [ Token ] (トークン) > [ View ] (表示)に移動します。 コントローラートークンをコピーしてテキストドキュメントに保存します。次に、テキストドキュメントをターゲットマシン上の任意の場所にコピーします。 注記 一部のバージョンでは、コントローラートークンが部分的に表示されません。トークンをダブルクリックして全体を強調表示し、テキストドキュメントにコピー/ペーストします。 |
2.6 | 元のマシンから RuntimeSettings.xml をコピーします。 | RuntimeSettings.xml ファイルを元のマシンの %ProgramData%\Alteryx からターゲットマシンの任意の場所にコピーします。 重要 ファイルをターゲットマシンの%ProgramData%\Alteryxにコピーしたり、ファイルを変更したりしないでください。 |
ステップ3: RuntimeSettings.xmlを復元する
# | ステップ | 詳細 |
---|---|---|
3.1 | ターゲットマシン上のbinフォルダーで コマンドプロンプト を開きます。 | 管理者としてコマンドプロンプトを開き、 Alteryx\bin インストールフォルダーに移動します。このセクションのコマンドはすべて、このフォルダーから実行する必要があります。 注記 このフォルダーの場所がわからない場合は、「Alteryxシステム設定」ショートカットのプロパティを確認することで、このショートカットで指されるファイルが目的のフォルダーにあることを確認できます。 既定の場所は C:\Program Files\Alteryx\bin です。 |
3.2 | AlteryxService を停止します。 | 次のコマンドを入力します。
AlteryxServiceが実行されていた場合、成功すると「The AlteryxService service was stopped successfully.」と表示されます。 AlteryxServiceが停止していた場合は、「The AlteryxService service is not started.」と表示されます。 このウィンドウは開いたままにしておきます。 |
3.3 | ターゲットマシン上の既存の RuntimeSettings.xml をバックアップします。 | バックアップとして、ターゲットマシンの %ProgramData%\Alteryx\RuntimeSettings.xml の名前を RuntimeSettings_BACKUP.xml に変更します。 RuntimeSettings.xmlが存在しない場合は、 ステップ3.4 に進みます。 |
3.4 | RuntimeSettings.xml を復元します。 | ステップ2.6 で元のマシンからコピーした RuntimeSettings.xml ファイルを、ターゲットマシンの %ProgramData%\Alteryx にコピー/ペーストします。 注記 必ずファイルをコピーしてください。このガイドでは、元の状態のファイルが必要になるため、ファイルの移動やカットはしないでください。 |
3.5 | コントローラートークン をクリアします。 | ターゲットマシンで %ProgramData%\Alteryx\RuntimeSettings.xml を編集します。 <ServerSecretEncrypted> タグ間をすべて削除し、以下ようにタグだけを残します。 |
3.6 | RuntimeSettings.xml を保存します。 | ターゲットマシンで RuntimeSettings.xml を保存します。 |
3.7 | コントローラートークン を復元します。 | ステップ3.1 で開いたコマンドプロンプトに戻り、 ステップ2.5 で収集した元のマシンのコントローラートークンを使用して次のコマンドを入力します。
トラブルシューティング : バージョン2021.3+では、このステップで次のエラーが発生する場合があります: 「サーバーシークレットの設定に失敗しました: CryptImportKey(3)のエラー: 不良なデータ。(-2146893819)」。これを修正するには、 ステップ3.5-3.6 を参照して、タグ間から値が削除されていることを確認してください。 |
3.8 | ストレージキー をクリアします。 | ターゲットマシンにある %ProgramData%\Alteryx\RuntimeSettings.xml を再度編集します。 <StorageKeysEncrypted> のタグ間をすべて削除して、以下のようにタグだけを残します。 |
3.9 | ストレージキー を復元します。 | ステップ2.6 の RuntimeSettings.xml から <StorageKeysEncrypted> をコピーして、 ターゲットマシンにあるRuntimeSettings.xml の <StorageKeysEncrypted> の間にペーストします。この値の長さはバージョンによって異なります。以下の例を参照してください。 |
3.10 | RuntimeSettings.xml を保存します。 | ターゲットマシンで RuntimeSettings.xml を保存します。 |
3.11 | Run Asユーザー を復元します。 | 元のServerにRun Asユーザーが存在する場合は、次のコマンドを入力します。存在しない場合は、この手順をスキップします。
|
3.12 | SMTPパスワード を復元します。 | [ Alteryxシステム設定 ] > [ Server UI ] > [ SMTP ] > [ Password ] (パスワード)に入力した場合(SMTPチェックボックスがオフになっていても)、次のコマンドを入力します。入力しなかった場合は、この手順をスキップします。
|
3.13 | 暗号化キー を復元します。 | 重要 従来のServerのコントローラーノードでAlteryxServiceが実行されており、新しいServerからネットワーク経由でアクセスできる必要があります。 「 暗号化キーの転送プロセス 」のステップを使用すると、元のマシンからターゲットマシンに暗号化キーを転送できます。「 暗号化キーの転送プロセス 」の最後のステップでは、Serviceを再起動する必要があります。このステップは、ターゲットマシンにライセンスがない場合実行できない場合があります。 |
完了です! これで、元のマシンが使用できなくなった場合の障害復旧シナリオで、ターゲットマシン上のRuntimeSettings.xmlファイルが使用できるようになりました。 ステップ3で準備したRuntimeSettings.xml は、元のマシンで使用していたMongoDBまたはSQL DBを使用しているターゲットマシンでのみ動作することに注意してください。
その後の使用について
元のマシンは新しいバージョンのServerにアップグレードされているので、このプロセスの後、ターゲットマシンも同じバージョンにアップグレードしてパッチを適用することで、障害復旧シナリオで最良の結果を得ることができます。
元のマシンでコントローラートークンを変更した場合は、 ステップ2 以降を再度実行して、ターゲットマシンと元のマシンのコントローラートークンを一致させてください。