Skip to main content

移行準備ツールの実行

始めに

移行準備ツールでは、データベースに保存されているワークフローデータのステージングコピーが作成されます。このプロセスでは、移行準備ツールにより、続行するために必要な容量の概算が表示されます。十分な空き容量がない場合は、続行しないでください。

警告

このプロセスを完了するのに十分な空き容量があることを手動で確認する必要があります。移行準備ツールでは空き容量を確認することはできません。

ステップ 1: 移行準備ツールをインストールする

ランナーツールをインストールするには、次の手順を実行します。

#

ステップ

1.1

https://downloads.alteryx.com からインストーラーをダウンロードして実行します。

Run the installer of the Migration Prep Tool.

1.2

EULA に同意します。

Accept the EULA.

1.3

インストールパスを選択するか、既定のパスに設定します。

Choose the installation path or accept the default path. 

1.4

プロンプトに従ってインストールを完了します。

Follow the prompts to complete the installation.
Follow the prompts to complete the installation.

ステップ 2: 移行準備ツールを起動する

移行準備ツールを起動するには、次の手順に従います。

#

ステップ

2.1

コマンドプロンプトまたは PowerShell を開きます。

2.2

選択したインストールパス (既定: C:\Program Files\Alteryx Migration Tool\ ) に移動します。

2.3

次の3つのコマンドのいずれかを実行して、移行準備ツールを実行します。 注: PowerShellを使用する場合は、 各コマンドの先頭に.\を追加します。

この操作は、MongoDB サーバーにアクセスできるすべてのホストで実行できます。ダウンタイムなしで複数回安全に実行することができます。

#組み込みMongoDBまたは単一のユーザー管理MongoDBサーバーで使用する例:

AlteryxServiceMigrator22_2.exe -p -c "MongoDB://:@:/AlteryxService?authsource=""{user}{password}{host.domain.tld}{port}{authenticationDB}

これは、次の例のようになります。「 non_admin_mongo_password 」と「 localhost は、現在の設定に基づいて変更する必要があります。

AlteryxServiceMigrator22_2.exe -p -c "MongoDB://user:non_Admin_Mongo_password@localhost:27018/AlteryxService?authsource=AlteryxService"

#MongoDBレプリカセットでの使用例:

AlteryxServiceMigrator22_2.exe -p -c "MongoDB://:@:,:,:/AlteryxService?authsource=""{user}{password}{host1.domain.tld}{port}{host2.domain.tld}{port}{host3.domain.tld}{port}{authenticationDB}

#MongoDB Atlasでの使用例:

AlteryxServiceMigrator22_2.exe -p -c "MongoDB + srv://:@/AlteryxService?retryWrites=true&w=majority"{user}{password}{atlasCluster.cloudProvider.mongodb.net}

  • 接続文字列内のこれらの変数を、環境に適した値に置き換えます。これらは、Server データベースの設定に使用されるものと同じ資格情報で、 Alteryx システム設定 で確認することができます。

    • {authenticationDB} {authenticationDB} =指定されたユーザーの資格情報を認証するデータベースです。

      • Serverが組み込みのMongoDBを使用するように設定されている場合は、管理者以外のMongoDBパスワードを使用する必要があります。接続文字列では、authSource が「AlteryxService」である必要があります。

      • ユーザー管理のMongoDBを使用している場合は、MongoDB管理者に連絡してユーザー資格情報とauthSourceを確認してください。

    • {port} {port} = MongoDBがデータベースへのアクセスを提供するために使用しているサービスポートです。

    • {host.domain.tld} {host.domain.tld} = MongoDBサーバーの完全修飾ドメイン名です。

    • {password} {password} =ユーザーの資格情報です。

    • {user} {user} =データベースにアクセスするためのユーザー名です。

    • {atlasCluster.cloudProvider.mongodb.net} = MongoDB Atlasクラスタアドレス。

  • コマンドパラメーターは次のとおりです。

    • -h [ --help] ヘルプ情報を表示する

    • -q [ --quiet ] ログメッセージをコマンドラインに出力する (進捗メッセージはこのフラグを無視します)

    • -s [ --severity ] 引数 (=7) コンソールログの重大度レベル (移行進捗レポートはレベル 5 で送信)

    • -p [ --perform ] 移行を実行する

    • -u [ --forcenoprogressupdates ] コンソールに進捗状況の最新メッセージを書き込まない (ただしログファイルには書き込まれます)

    • -c [ --connection ] 引数 接続文字列 (AlteryxService データベースを指定する必要があります)

    • -l [ --loggingpath ] 引数 (=C:\ProgramData\Alteryx) ログファイルのパス (ログのローテーションのために %N を含める必要があります)

    • --loggingmaxfilesize 引数 (=64) ログファイルがローテーションされる前に MB 単位でサイズを最大化

    • -r [ --runtimesettings] 引数 ランタイム設定ファイルのパス

    • -d [ --stagingdirectory ]引数 復号化されたワークフローが再暗号化されるまで一時的に保存されるディレクトリ

2.4

移行が開始すると、データベースとランタイム設定ファイルのバックアップが作成されたことを確認するメッセージが表示されます。

When the migration starts it will it will prompt you to confirm you have made a backup of the database and your runtime settings file.

2.5

バックアップ作成の確認後、ユーティリティが現在の容量の使用状況をチェックします。移行に必要な追加容量の概算が表示されます。システムを確認し、十分な空き容量があることが確認できた場合のみ続行します。

Once you confirm the backups, the utility will check current space usage .

2.6

十分な空き容量があることを確認すると、ユーティリティはワークフローデータの移行を開始します。開始時刻と完了時刻を示すコンソールメッセージと、進捗状況メッセージが表示されます。

After confirming sufficient free space is available, the utility will begin migrating the the workflow data in preparation for the upgrade to 2022.3.

トラブルシューティング

移行中にエラーが発生した場合は、コンソールにエラーが表示され、ログファイルにもキャプチャされます。

エラーが発生した場合は、次のステップを実行してください。

  1. コマンドプロンプトのスクリーンショットをキャプチャします。

  2. 機密データを隠すか、または削除します。

  3. ログをキャプチャします(場所と名前については、検証ステップを参照してください)。

  4. 移行を再度実行します。

  5. 移行が再度失敗した場合は、サポートに連絡し、スクリーンショットとログファイルを報告に含めてください。

ステップ 3: Server 2022.3 にアップグレードする

重要

  • アップグレードする前に、 Mongoデータベース RuntimeSettings.xmlのバックアップコピー を作成します。メンテナンス時に実行される暗号化は元に戻すことができません。バックアップを作成しておくと、データ損失やダウンタイムの延長からインストールを保護することができます。

  • 2022.3のアップグレード中、移行の進捗状況は表示されません。

  • アップグレードの詳細については、「 Serverのインストールまたはアップグレード 」を参照してください。

#

ステップ

3.1

2022.3インストーラーをダウンロードして実行します。

Run the installer.

3.2

ライセンス契約に同意します。

Accept the license agreement.

3.3

インストールパスを選択するか、既定のパスに設定します。

Choose your installation path or accept the default.

3.4

インストールを開始します。

Start the installation.

3.5

インストールが完了するまで待ちます。

Allow the installation to complete.

3.6

インストールが完了したら、 [今すぐ Server 設定を行う] オプションを選択します。

Upon completion of the installation choose the ‘Configure Server Now’ option.

注記

Server 2022.3のインストール完了後、サービスの開始に遅延が生じることがあります。

3.7

[Alteryx システム設定] が開きます。 [システム設定] の内容を見ていき、設定が正しいことを確認します。次に、 [Fnish] [Done] の順に選択して、サービスを開始します。

3.8

サービスが起動されると、Serverはメンテナンスモードに入り、RuntimeSettingsと、事前に移行できなかったデータベース値を移行します。メンテナンスモードでは、Server インスタンスは使用できません。

3.9

移行準備ツールは、前回の実行以降にデータベースが変更されたかどうかの最終チェックを行います。その後、(新たに見つかった変更を含めて)移行を実行し、ステージング移行の使用に進みます。

3.10

この最終移行には数時間かかる場合があります。所要時間は、設定のサイズや、アップグレード前に移行準備ツールが実行済みかどうかによって異なります。このプロセスが完了すると、Serverはメンテナンスモードを終了し、稼働状態になります。

トラブルシューティング

一定時間経過した後にサービスがシャットダウンした場合は、これらのログで移行エラーを確認してください。

  • LastStartupError.txt

  • 移行準備ツールによって作成されたAlteryxServiceMigrator_#.log

  • サービス開始時に作成されたAlteryxServiceMigrator_#.log

移行エラーが発生した場合は、AlteryxServiceの再起動を試みます。AlteryxServiceを再起動しようとすると、問題が解決する場合があります。問題が解決しない場合は、ログを収集し、カスタマーサポートにお問い合わせください。エラーによっては、AlteryxService を再起動すると、完了していない移行手順が再試行されるため、問題が解決する場合があります。

移行の失敗を引き起こす可能性のある原因とは

2つのエラーケースがあります。

  1. レコードを復号できなかった。これは、破損レコードが存在し、ユーザーがテーブルから削除する必要があることを意味します(必要に応じて、バックアップした後)。

  2. レコードを再暗号化できなかった。解決策は、前述のものと同じです。

その他のエラーケースは通常、環境的な問題です。これらは、環境的な問題を修正してからユーティリティを再実行することで解決されます。MongoDBへの接続切断や、ディスク容量不足などの例があります。

ステップ 4: 移行が正常に完了したことを確認する

移行準備ツールが正常に完了したことを確認するには、次のいずれかのオプションを実行します。

移行準備ツールログの検証

  1. C:\ProgramData\Alteryx\Service\ に移動します。

  2. AlteryxServiceMigrator_#.log を開きます。

  3. ログにエラーまたはエラーメッセージが出力されていないかを確認します。ログに「 ;3; 」としてステータス3が表示されていないか検索します。

サービス開始ログの検証

  1. Alteryxシステム設定 > コントローラー > 一般 > ログ で設定されたログフォルダーに移動します。

  2. AlteryxServiceMigrator_#.log を開きます。

  3. ログにエラーまたはエラーメッセージが出力されていないかを確認します。ログに「 ;3; 」としてステータス3が表示されていないか検索します。

2022.3 へのアップグレード後の検証 (最終移行後)

  1. Web URI を使用して Server にログインします。

  2. 以下を確認します。

    • ワークフローとアプリを手動で実行できる。

    • スケジュールがアクティブで、想定される結果で実行されている。

    • ワークフローの資格情報を表示、編集、作成、使用できる。

    • Server データ接続を表示、編集、作成、使用できる。

    • API からワークフローパッケージを取得し、そのパッケージを Designer にインポートして、ワークフローを Designer で実行できる。