障害復旧(ディザスターリカバリー)の準備

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.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.1

ターゲットホスト上のbinフォルダーでコマンドプロンプトを開きます。

管理者としてコマンドプロンプトを開き、Alteryx\binインストールフォルダーに移動します。このセクションのコマンドはすべて、このフォルダーから実行する必要があります。

注: このフォルダーの場所がわからない場合は、「Alteryxシステム設定」ショートカットのプロパティを確認することで、このショートカットで指されるファイルが目的のフォルダーにあることを確認できます。既定の場所はC:\Program Files\Alteryx\binです。

3.2

AlteryxServiceを停止します。

次のコマンドを入力します。

net stop 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で収集した元のホストのコントローラートークンを使用して次のコマンドを入力します。

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

トラブルシューティング: バージョン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ユーザーが存在する場合は、次のコマンドを入力します。存在しない場合は、この手順をスキップします。

AlteryxService.exe setexecuteuser=NAME,DOMAIN,PASSWORD

3.12

SMTPパスワードを復元します。

[Alteryxシステム設定] > [Server UI] > [SMTP ] > [Password] (パスワード)に入力した場合(SMTPチェックボックスがオフになっていても)、次のコマンドを入力します。入力しなかった場合は、この手順をスキップします。

AlteryxService.exe setsmtppassword=PASSWORD

3.13

暗号化キーを復元します。

重要: 従来のServerのコントローラーノードでAlteryxServiceが実行されており、新しいServerからネットワーク経由でアクセスできる必要があります。

暗号化キーの転送プロセスのステップを使用すると、元のホストからターゲットホストに暗号化キーを転送できます。暗号化キーの転送プロセスの最後のステップでは、Serviceを再起動する必要があります。このステップは、ターゲットホストにライセンスがない場合実行できない場合があり、スキップすることができます。