障害復旧の準備

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

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

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