Server ホスト復元ガイド

1.1

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

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

1.2

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

Alteryxライセンシングシステムが使用するWebドメイン whitelist.alteryx.com にコンピューターを接続する必要があります。

1.3

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

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

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

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

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

1.4

トラブルシューティング

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

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

2.1

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

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

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 Userが存在する場合は、次のコマンドを入力します。そうでない場合は、この手順をスキップします。 AlteryxService.exe setexecuteuser=名前、ドメイン、パスワード

2.9

SMTPパスワードの復元

Alteryxシステム設定 > サーバUI > SMTP > パスワードに入力した場合 （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––ポート27018

例

mongod––dbpath "%ProgramData%\Alteryx\Sservice\Persistence\Mongo_Restore"––認証––ポート27018

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

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

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

3.6

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

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

Program Files \ Alteryx \ bin。

3.7

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

コマンドを入力し、 非ADMIN_MONGO_PASSWORDを メモ帳にコピーします。

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

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

mongoコマンドを入力します

db.locks.remove({})

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

3.10

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

コマンドを入力します。

終了

Command Prompt_2を閉じる

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

3.11

Mongoデータベースの停止

元のコマンドプロンプトで、キーボードコマンドを入力します。

ctrl-c

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

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

4.1

元のサーバにサービスログオンユーザがいましたか。

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

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

4.2

データドライバとシステムDSNを追加します。

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

リカバリには適用されない高度な問題：

4.3

より安全な環境では、必要なRun Asユーザー権限を構成します。

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

4.4

システムベースおよびデータベース内の接続エイリアスのリストア

データ接続がありません。

%ProgramData%\Alteryx\Engine\SystemAlias.xml

システムインDBデータ接続：

%ProgramData%\Alteryx\Engine\SystemConnections.xml

4.5

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

データ接続を管理：

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

ユーザーの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を使用していますか？

テスト用にサンドボックスサーバーにリカバリする場合は、HTTPを使用してテストします。

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

Server SSL/TLS を設定

SSL 用 Alteryx Server の設定：証明書の取得とインストール

5.1

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

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

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

［ワーカー ］ > ［全般］ > ［ マシンによるスケジュールされたAlteryxワークフローの実行を許可

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

6.1

基本テスト

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

次のことが可能です。

6.2

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

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