Skip to main content

Server ホスト復元ガイド

このガイドは、元のホストに障害が発生した場合、新しいアップグレードされたサーバーに移行した場合、オンプレミスからクラウドサーバーに移行した場合、およびその他のインフラストラクチャが変更された場合に、サーバー管理者がサーバーインスタンスを回復するための支援を目的としています。

サーバーリカバリでは、元のサーバーから次のものを取得することに基づいて、元のユーザー、ワークフロー、スケジュールなどで新しいサーバーを実行できます。

  • Controller Token (コントローラートークン)

  • コントローラノードからのRuntimeSettings.xml

  • MongoDB のバックアップ

プロセスの各ステップの詳細は次のとおりです。

1-準備

2- RuntimeSettings.xmlをリカバリする

3- MongoDBのリカバリ

4-他のファイルと設定の復元

5-スタートAlteryx Server

6-テスト

このガイドで扱う範囲と前提とする条件

  • 組み込み MongoDB を使用した、既定の単一 Server インストール の障害からの復元。

  • 必要な情報が破損していないバックアップがあること。

  • ターゲットマシンが上書き可能であること。

このガイドで扱わない事項

  • マルチノード Server 環境またはユーザー管理 MongoDB の場合。カスタマーサポートに連絡してサポートを依頼してください。

  • 接続ファイルのデータベースのマージ。

  • ODBC ドライバーのバックアップまたは復元。

  • ユーザー DSN またはシステム DSN のバックアップまたは復元。

  • Alteryx ではなく Windows に保存されている他のエイリアスのバックアップまたは復元。

必要条件

  • このガイドで説明している手順を実行する前に、ワークフロー操作に必要なすべてのデータベースドライバーとソフトウェアをインストールして、ダウンタイムを最小限に抑えるようにします。

  • ターゲットサーバーの管理者権限。

  • テスト用に暫定的に使用するすべての資格情報。この資格情報としては、サービスアカウント (ローカルシステムではない場合)、Run As ユーザー、定義済み/使用中のワークフロー資格情報があります。

  • 復元元 Server のコントローラートークン。

  • 復元元 Server の RuntimeSettings.xml は、 %PROGRAMDATA%\Alteryx\RuntimeSettings.xml にあります。

  • 復元元 Server の MongoDB のバックアップ。 バックアップの実行方法についてはこちらのリンクから確認してください。

    • Serverのバックアップと復元の詳細については、「Serverのバックアップと復元におけるベストプラクティス」の パート1 パート2 をご覧ください。

  • ターゲットサーバーが元のサーバーと、Windows のタイムゾーン設定で同じタイムゾーンに設定されていることを確認します。同じタイムゾーンに設定されていないと、スケジュール表示の際にエラーが発生する可能性があります。

オプション

次の項目は、復元元 Server では利用されていない可能性があります。機能が使用されていたかどうかを確認し、このガイドで「 (オプション) 」と記載されている該当の手順を完了してください。

  • サービスログオンユーザー(使用している場合)。

  • ワーカー構成の Run-As ユーザーの詳細は次のとおりです。

    • ドメイン

    • ユーザー名

    • パスワード

  • Server 設定用の SMTP サーバーのユーザー名とパスワード。

  • %ProgramData%\Alteryx\Toolsのコネクタ

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

    • システムの In-DB データ接続: %PROGRAMDATA%\Alteryx\Engine\SystemConnections.xml を参照

    • システムのデータ接続: %PROGRAMDATA%\Alteryx\Engine\SystemAlias.xml を参照

  • 復元元 Server の Alteryx ユーザーベース接続エイリアスと In-DB 接続エイリアス。以下は、 Run-As またはワークフロー資格情報ユーザーアカウントに関連する場合があります

    • ユーザーデータ接続 C:sers\[username]\AppData\U\Roaming\Alteryx\Engine\UserConnections.xmlを参照してください。

    • User In-DB Data Connections C:sers\[username]\AppData\U\Roaming\Alteryx\Engine\UserAlias.xmlを参照してください。

ステップ1:アクセス

#

ステップ

詳細

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: RuntimeSettings.xmlを回復する

#

ステップ

詳細

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> タグ間のすべてのタグを、以下のタグを除いて削除します。

64ae505fe2c2c.png

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

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 でさらに変更を加えることができます。

Step 2.7 Restore Encryption Keys

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

暗号化キー の転送

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

  • 2021.4.2パッチ11以降

  • 2022.1パッチ9以降

  • 2022.3パッチ6以降

  • 2023.1パッチ2以降

  • 2023.2 GA以降

重要

これには、従来のServerのコントローラーノードでAlteryxServiceが実行されており、新しいServerからネットワーク経由でアクセスできる必要があります。

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

2.12

コマンドラインをそのまま使用する

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

手順3: MongoDBを回復する

#

ステップ

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 を開き、次の手順を実行します。

  • 最後の行に、「 #### document(s) restored successfully, 0 document(s) failed to restore (####個のドキュメントを復元、0個のドキュメントの復元に失敗)」と報告されていることを確認します。

  • error critical fatal failed を検索します。 failed を確認する際には、その結果が前の項目で示した「 0 document(s) failed 」を含む文ではないことを確認してください。

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

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

3.4

RuntimeSettings.xmlでMongoパスを設定する

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

例:

Set Mongo path in RuntimeSettings.XML

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

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:他のファイルと設定を復元する

#

ステップ

詳細

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:Alteryx Serverの起動

#

ステップ

詳細

5.1

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

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

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

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

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

重要

新しいサーバのURLが異なる場合や、SSL証明書がない場合があるため、サーバUI設定に特に注意してください。

System Settings, the Server UI configuration section.

ステップ6: 任意

#

ステップ

詳細

6.1

基本テスト

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

次のことが可能です。

  • サーバーUI URLにアクセスしますか?

  • 管理ページを移動して、ユーザーやコレクションなどを表示しますか?

  • Designerからサーバーにワークフローを発行しますか?

  • ワークフローを実行します。

  • 設定で許可されている場合は、資格情報を指定してワークフローを保存して実行します。

6.2

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

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

  • ネットワークUNCパスへの入出力

  • データベース接続

  • コネクタツール

  • ロケーションまたはビジネスインサイトデータセット

  • Pythonツール

  • Rツール