障害復旧の準備

1.1

元のホストとターゲットホストにAlteryx Serverの最新バージョンとパッチをアップグレードまたはインストールできますか?

はい: 元のホストとターゲットホストにAlteryx Serverの最新バージョンとパッチをアップグレードまたはインストールします。元のホストを通常どおり設定します。

ステップ2.1に進みます。

いいえ:ステップ1.2に進みます。

1.2

元のホストとターゲットホストを、そのバージョンの最新パッチにアップグレードできますか?

はい: 元のホストにメジャーバージョンの最新パッチを適用し、ターゲットホストに最新の一致するバージョンとパッチをインストールします。たとえば、2022.3パッチ3を使用している場合は、2022.3で利用可能な最新のパッチをインストールします。 

ステップ2.1に進みます。

いいえ:ステップ1.3に進みます。

1.3

元のホストのAlteryx Serverのバージョンは、必要条件セクションの互換性のあるターゲットホストのリストに記載されていますか?

はい: ターゲットホストを、元のホストとまったく同じメジャーバージョンおよびパッチバージョンにインストールまたはアップグレードします。パッチインストールではなく、フルインストールファイルを使用してください。

必要に応じて、fulfillment@alteryx.comに連絡して、必要なインストールファイルを要求してください。

ステップ2.1に進みます。

いいえ:ステップ1.4に進みます。

1.4

ターゲットホストにAlteryx Serverの最新のパッチバージョンをインストールします。

ターゲットホストに、元のホストにインストールされているメジャーバージョンで利用可能な最新のパッチをインストールまたはアップグレードします(たとえば、元のホストが2022.3パッチ3を使用している場合は、ターゲットホストに2022.3の最新のパッチをインストールします)。

ステップ2.1に進みます。

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からターゲットホストの任意の場所にコピーします。

3.1

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

管理者としてコマンドプロンプトを開き、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

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

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