Serverホスト復元ガイド

1.1

ホストのタイムゾーンの設定

ターゲットのホストのWindowsタイムゾーンは、元のホストと一致するように設定する必要があります。

1.2

Alteryxへのアクセスを確保する

Alteryxライセンシングシステムが使用するwhitelist.alteryx.comにホストが接続できる必要があります。

3.1

binフォルダーでコマンドプロンプト1を開く

管理者としてコマンドプロンプトを開き、Alteryx\binフォルダーに移動し、以下のコマンドを入力します(インストール場所に応じて調整します)。

c:

cd \Program Files\Alteryx\bin

3.2

サービスの停止

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

net stop alteryxservice

成功すると、「The AlteryxService service was stopped successfully.」と表示されます。

3.3

既存の RuntimeSettings.xml のバックアップ

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

c:

cd \ProgramData\Alteryx ren RuntimeSettings.xml RuntimeSettings_BACKUP.xml

3.4

障害復旧の準備として、ターゲットホストへ事前にRuntimeSettings.xmlを準備していますか?

はい: 障害復旧プロセスのRuntimeSettings.xmlは、事前にターゲットホストの%ProgramData%\Alteryx\ディレクトリに配置している必要があります。まだの場合は、準備したRuntimeSettings.xmlを%ProgramData%\Alteryx\にコピーします。

ステップ3.13に進みます。

いいえ: 元のホストから現在のターゲットホストの%ProgramData%\Alteryx\ディレクトリにRuntimeSettings.xmlファイルをコピーします。

ステップ3.5に進みます。

3.5

コントローラートークン のクリア

コピーしたRuntimeSettings.xmlを編集し、<ServerSecretEncrypted>タグ間のすべての文字列を削除します。タグは以下のように残します。

ファイルを保存して閉じます。

3.6

コントローラートークン の復元

元のサーバーコントローラートークンを使用して、次のコマンドを入力します。

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

トラブルシューティング:

バージョン2021.3+では、このステップで次のエラーが発生する場合があります: 「サーバーシークレットの設定に失敗しました: CryptImportKey(3)のエラー: 不良なデータ。(-2146893819)」。これを修正するには、前のステップを参照し、タグ間から値が削除されたことを確認します。

3.7

暗号化されたストレージキーの復元

<StorageKeysEncrypted>値は、ステップ3.6でコントローラートークンをリセットした際に変更された可能性があります。その場合、元のRuntimeSettings.xmlファイルの対応する値に置き換える必要があります。これは、ステップ3.4でコピーされたソースRuntimeSettings.xmlファイルです。タグも一緒にコピーして、元のRuntimeSettings.xmlファイルからタグ間の値全体を簡単かつ確実にコピーします。RuntimeSettings.xmlをテキストエディターで開いたままにして、ステップ4でさらに変更を加えることができます。

3.8

Run Asユーザー の復元

元のホストにRun Asユーザーが存在する場合は、次のコマンドを入力します。存在しない場合は、この手順をスキップします。AlteryxService.exe setexecuteuser=NAME,DOMAIN,PASSWORD

3.9

SMTPパスワード の復元

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

3.10

RuntimeSettings.xmlを保存

RuntimeSettings.xmlファイルを保存します。

3.11

元のホストのAlteryx Serverのバージョンは、次のいずれかですか?

はい: ステップ3.13に進みます。

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

3.12

暗号化キーの転送

この機能は、次のバージョンでのみ使用できます。

重要: これには、元のホストでAlteryxServiceが実行されており、ターゲットホストがネットワーク経由でこれにアクセスできる必要があります。

「暗号化キーの転送プロセス」の手順を使用すると、既存のコントローラーから新しいコントローラーに暗号化キーを転送できます。

3.13

そのままコマンドラインに留まる

ステップ4では、\Alteryx\binフォルダーで管理者コマンドラインが使用されていることを前提にしています。

4.1

MongoDBバックアップの取得

元のホストから新しいホストのMONGO_BACKUPフォルダーにMongoバックアップをコピーします。

4.2

新しいフォルダへの復元

バックアップフォルダーから新しい復元フォルダーにMongoデータベースを復元します。以下に示すようにmongoRestore.logを参照して、復元が正常に行われたことを確認します。

使用しているServerのバージョンに適した復元コマンドを見つけるには、MongoDBのバックアップドキュメントの「MongoDBバックアップからの復元」セクションを参照してください。

4.3

正常に復元が完了したことを確認する

正常に復元が完了したことを確認します。

注意

復元が失敗した場合も前の手順では報告されず、Server上でのデータの欠落につながる恐れがあるため、この手順が必要です。これを行うには、データが復元されたMongoDBフォルダーの mongoRestore.log ファイルを確認します。mongoRestore.log を開き、次の手順を実行します。

復元に失敗した場合、または上記のキーワードの検索で該当する結果が見つかった場合は、収集したすべての情報をカスタマーサポートに連絡してください。

MongoDBの復元が失敗した場合は、続行しないでください。

4.4

RuntimeSettings.XMLでMongoパスを設定

RuntimeSettings.xmlを編集し、<EmbeddedMongoDBRootPath>タグにMONGO_RESTORE_FOLDERへのパスを入力します。

例:

保存してテキストエディターを閉じます。

4.5

MongoDBの起動

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

mongod ––dbpath "MONGO_RESTORE_FOLDER" ––auth ––port 27018

例

mongod ––dbpath "%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore" ––auth ––port 27018

コマンドプロンプトウィンドウを閉じないでください。

ステップ4.5でウィンドウを閉じた場合、以降のステップはどれも機能しなくなります。

<<2番目のコマンドプロンプトセクションの開始>>

4.6

2番目のコマンドプロンプトをbinフォルダーで開く

管理者として 2番目のコマンドプロンプトを開き、Alteryx\binフォルダーに移動して、以下のコマンドを入力します(インストール場所に応じて調整します)。

c:

cd \Program Files\Alteryx\bin

4.7

管理者以外のMongoパスワードの取得

次のコマンドを入力して、非管理者のMONGOパスワード をメモ帳にコピーします。

AlteryxService.exe getemongopassword

4.8

Mongoコマンドラインの開始

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

mongosh mongodb://SERVER:PORT/AlteryxGallery -u user -p NON_ADMIN_MONGO_PASSWORD

例

mongosh mongodb://localhost:27018/AlteryxGallery -u user -p CCEC***33C0

成功すると、「>」プロンプトが表示されます。

4.9

元のServerによって設定されたAlteryxGalleryのロックの削除

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

db.locks.remove({})

成功すると、「writeResult({ “nRemoved” : N })」が表示されます。ここで、Nは0から3までの数値です。

4.10

AlteryxServiceデータベースへの切り替え

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

use AlteryxService

4.11

元のServerによって設定されたAlteryxServiceロックの削除

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

db.locks.remove({})

成功すると、「writeResult({ “nRemoved” : N })」が表示されます。このNの数値は0から3までの値です。

4.12

Mongoコマンドラインと コマンドプロンプト2 を終了

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

exit

コマンドプロンプト2 を閉じます。

<<2番目のコマンドプロンプトセクションの終了>>

4.13

Mongoデータベースの停止

元のコマンドプロンプトで、キーボードコマンド

ctrl-c

を1回以上、MongoDBを終了して通常のコマンドプロンプトに戻るまで入力します。

コマンドプロンプトを閉じます。

5.1

元のServerに サービスログオンユーザー がいたか

新しいServerに サービスログオンユーザー を設定します。

[Windowsサービスアプリ] > [AlteryxService] を右クリック> [プロパティ] > [ログオン]

5.2

データドライバーとシステムDSNの追加

元のServerと一致するように、同じバージョン のドライバーと 同じ名前 のシステムDSNを追加します(https://downloads.alteryx.com/)。

復元で発生しない可能性のある高度な問題:

5.3

より安全な環境では、必要なRun Asユーザー権限を設定

ワークフローの実行に使用されるすべての資格情報(Run As、サービスログオン、ワークフロー保存時の資格情報セット)に適切なアクセス権があることを確認し、必要な実行ユーザー権限を設定 します。必要な Run As ユーザー権限の設定

5.4

システムベースエイリアスおよびIn-DB接続エイリアスの復元

システムデータ接続:

%ProgramData%\Alteryx\Engine\SystemAlias.xml

システムIn-DBデータ接続:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

5.5

ユーザベースエイリアスおよびユーザーIn-DB接続エイリアスの復元

ユーザーデータ接続:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserConnections.xml

ユーザーIn-DBデータ接続:

C:\Users\[username]\AppData\Roaming\Alteryx\Engine\UserAlias.xml

5.6

ワークフローでコネクタを使用しているか

コネクタフォルダーを元のサーバーから以下にコピー

%ProgramData%\Alteryx\Tools

新しいServerでコネクタを有効にするには、カスタマーサポート にお問い合わせください。

5.7

ワークフローでPythonツールを使用しているか

ワークフローがインストールしたPythonパッケージがあれば、再インストールします。ServerアップグレードでのPythonツール環境を参照してください。

5.8

SSLを使用しているか

テスト用にサンドボックスServerに復元する場合は、HTTPを使用してテストします。

新しいServerに移行する場合は、SSLを再確立します。

Server SSL/TLSを設定

Configuring Alteryx Server for SSL Obtaining and Installing Certificates(SSL用Alteryx Serverの設定: 証明書の取得とインストール)

6.1

Alteryxシステム設定を確認し、必要に応じてスケジュールを一時停止します。

Alteryxシステム設定 を実行し、各ページの手順を実行して、設定(コントローラートークンなど)に期待される値が含まれていることを確認します。

サービスの開始時にスケジュールを実行しない場合は、次のチェックボックスをオフにします。

Worker(ワーカー) > General(一般) > Allow machine to run scheduled Alteryx workflows(スケジュール設定されたAlteryxワークフローの実行をマシンに許可する)

[Finish] (完了) を選択すると、AlteryxServiceが起動し、ブラウザでServerが使用可能になります。

7.1

基本テスト

AlteryxService は実行されていますか?

次のことができるか確認します。

7.2

ワークフロー固有のテスト

次のような拡張機能や外部接続を含むワークフローを実行できますか?