Serverホスト復元ガイド

1.1

マシンのタイムゾーンの設定

新しいマシンのWindowsタイムゾーンは、元のマシンと一致するように設定する必要があります。

1.2

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

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

1.3

同じバージョンのServerをインストールする

Mongoバックアップを作成したのと同じバージョンのServerのクリーンインストールを実行します。

四半期内で最新のメンテナンスリリースを使用します。たとえば、バックアップがバージョン2022.4. 2 の場合は、2022.4. 5 メンテナンスリリースが利用可能であれば、そのリリースを使用してください。お使いのバージョンがまだ http://downloads.alteryx.com で入手できない場合は、 fulfillment@alteryx.com までお問い合わせください。

Serverのインストールまたはアップグレード

ブラウザに表示されるServer UIをテストします。ログインする必要はありません。

1.4

トラブルシューティング

ライセンスキー「使用中」エラー

ライセンスキーがまだ古いサーバーに関連付けられている場合は、そのマシンでライセンスキーの無効化を行う必要があります。そのマシンにアクセスできない場合は、ライセンス管理者に連絡してライセンスを解除してください。

2.1

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

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

c: cd \Program Files\Alteryx\bin

2.2

サービスの停止

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

net stop alteryxservice

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

2.3

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

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

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

2.4

RuntimeSettings.xml の復元

元のサーバーから現在の %ProgramData%\Alteryx\ ディレクトリに RuntimeSettings.xml ファイルをコピーします。

2.5

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

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

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

2.6

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

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

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

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

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

2.7

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

<StorageKeysEncrypted> 値は、 ステップ2.6 でコントローラートークンをリセットした際に変更された可能性があります。その場合、元のRuntimeSettings.xmlファイルの値に置き換える必要があります。必要に応じて、元のマシンでProgramData%\Alteryx\RuntimeSettings.xmlを開き、必要な値を取得します。タグはコピーした方が、元のRuntimeSettings.xmlファイルからタグ間の値全体を確実に簡単にコピーできます。RuntimeSettings.xmlをテキストエディターで開いたままにして、 ステップ3 でさらに変更を加えることができます。

2.8

Run Asユーザー の復元

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

2.9

SMTPパスワード の復元

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

2.10

RuntimeSettings.xml を保存

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

2.11

暗号化キー の転送

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

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

2.12

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

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

3.1

MongoDBバックアップの取得

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

3.2

新しいフォルダへの復元

バックアップフォルダーから新しい復元フォルダーにMongoデータベースを復元します。最後のパラメーターの ,10 は、復元中のMongoDBによるメモリ使用量を低減します。これにより、メモリ不足エラーが発生する可能性が低くなりますが、復元にかかる時間は長くなる可能性があります。この ,10 を省略すると、復元が高速になる場合があります。いずれの場合も、以下に示すように mongoRestore.log を参照して、復元が正常に行われたことを確認します。

AlteryxService.exe emongorestore="MONGO_BACKUP_FOLDER","MONGO_RESTORE_FOLDER",10

例:

AlteryxService.exe emongorestore="D:\db_bkp","%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore",10

3.3

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

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

注意

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

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

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

3.4

RuntimeSettings.XMLでMongoパスを設定

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

例:

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

3.5

MongoDBの起動

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

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

例

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

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

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

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

3.6

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

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

c: cd \Program Files\Alteryx\bin

3.7

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

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

AlteryxService.exe getemongopassword

3.8

Mongoコマンドラインの開始

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

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

例

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

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

3.9

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

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

db.locks.remove({})

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

3.10

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

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

exit

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

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

3.11

Mongoデータベースの停止

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

ctrl-c

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

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

4.1

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

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

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

4.2

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

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

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

4.3

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

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

4.4

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

システムデータ接続:

%ProgramData%\Alteryx\Engine\SystemAlias.xml

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

%ProgramData%\Alteryx\Engine\SystemConnections.xml

4.5

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

ユーザーデータ接続:

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

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

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

4.6

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

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

%ProgramData%\ Alteryx\Tools

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

4.7

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

ワークフローがインストールしたPythonパッケージがあれば、再インストールします。 Server Upgrade Python Tool Environment Checklistを参照してください。

4.8

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

準備中

4.9

マルチノード環境またはユーザー管理のMongoを使用しているか

(準備中)アカウントエグゼクティブまたは カスタマーサポート にお問い合わせください。

4.10

SSLを使用しているか

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

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

Server SSL/TLSを設定

Alteryx ServerのSSL用設定: 証明書の取得とインストール(15577)

5.1

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

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

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

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

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

6.1

基本テスト

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

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

6.2

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

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