移行準備ツールの実行
始めに
移行準備ツールでは、データベースに保存されているワークフローデータのステージングコピーが作成されます。このプロセスでは、移行準備ツールにより、続行するために必要な容量の概算が表示されます。十分な空き容量がない場合は、続行しないでください。
警告
このプロセスを完了するのに十分な空き容量があることを手動で確認する必要があります。移行準備ツールでは空き容量を確認することはできません。
ステップ 1: 移行準備ツールをインストールする
ランナーツールをインストールするには、次の手順を実行します。
# | ステップ |
---|---|
1.1 | https://downloads.alteryx.com からインストーラーをダウンロードして実行します。 |
1.2 | EULA に同意します。 |
1.3 | インストールパスを選択するか、既定のパスに設定します。 |
1.4 | プロンプトに従ってインストールを完了します。 |
ステップ 2: 移行準備ツールを起動する
移行準備ツールを起動するには、次の手順に従います。
# | ステップ |
---|---|
2.1 | コマンドプロンプトまたは PowerShell を開きます。 |
2.2 | 選択したインストールパス (既定:
|
2.3 | 次の3つのコマンドのいずれかを実行して、移行準備ツールを実行します。
注:
PowerShellを使用する場合は、
この操作は、MongoDB サーバーにアクセスできるすべてのホストで実行できます。ダウンタイムなしで複数回安全に実行することができます。 #組み込みMongoDBまたは単一のユーザー管理MongoDBサーバーで使用する例:
これは、次の例のようになります。「
#MongoDBレプリカセットでの使用例:
#MongoDB Atlasでの使用例:
|
2.4 | 移行が開始すると、データベースとランタイム設定ファイルのバックアップが作成されたことを確認するメッセージが表示されます。 |
2.5 | バックアップ作成の確認後、ユーティリティが現在の容量の使用状況をチェックします。移行に必要な追加容量の概算が表示されます。システムを確認し、十分な空き容量があることが確認できた場合のみ続行します。 |
2.6 | 十分な空き容量があることを確認すると、ユーティリティはワークフローデータの移行を開始します。開始時刻と完了時刻を示すコンソールメッセージと、進捗状況メッセージが表示されます。 |
トラブルシューティング
移行中にエラーが発生した場合は、コンソールにエラーが表示され、ログファイルにもキャプチャされます。
エラーが発生した場合は、次のステップを実行してください。
コマンドプロンプトのスクリーンショットをキャプチャします。
機密データを隠すか、または削除します。
ログをキャプチャします(場所と名前については、検証ステップを参照してください)。
移行を再度実行します。
移行が再度失敗した場合は、サポートに連絡し、スクリーンショットとログファイルを報告に含めてください。
ステップ 3: Server 2022.3 にアップグレードする
重要
アップグレードする前に、 Mongoデータベース と RuntimeSettings.xmlのバックアップコピー を作成します。メンテナンス時に実行される暗号化は元に戻すことができません。バックアップを作成しておくと、データ損失やダウンタイムの延長からインストールを保護することができます。
2022.3のアップグレード中、移行の進捗状況は表示されません。
アップグレードの詳細については、「 Serverのインストールまたはアップグレード 」を参照してください。
# | ステップ |
---|---|
3.1 | 2022.3インストーラーをダウンロードして実行します。 |
3.2 | ライセンス契約に同意します。 |
3.3 | インストールパスを選択するか、既定のパスに設定します。 |
3.4 | インストールを開始します。 |
3.5 | インストールが完了するまで待ちます。 |
3.6 | インストールが完了したら、 [今すぐ Server 設定を行う] オプションを選択します。 注記 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つのエラーケースがあります。
レコードを復号できなかった。これは、破損レコードが存在し、ユーザーがテーブルから削除する必要があることを意味します(必要に応じて、バックアップした後)。
レコードを再暗号化できなかった。解決策は、前述のものと同じです。
その他のエラーケースは通常、環境的な問題です。これらは、環境的な問題を修正してからユーティリティを再実行することで解決されます。MongoDBへの接続切断や、ディスク容量不足などの例があります。
ステップ 4: 移行が正常に完了したことを確認する
移行準備ツールが正常に完了したことを確認するには、次のいずれかのオプションを実行します。
移行準備ツールログの検証
C:\ProgramData\Alteryx\Service\
に移動します。AlteryxServiceMigrator_#.log を開きます。
ログにエラーまたはエラーメッセージが出力されていないかを確認します。ログに「 ;3; 」としてステータス3が表示されていないか検索します。
サービス開始ログの検証
Alteryxシステム設定 > コントローラー > 一般 > ログ で設定されたログフォルダーに移動します。
AlteryxServiceMigrator_#.log を開きます。
ログにエラーまたはエラーメッセージが出力されていないかを確認します。ログに「 ;3; 」としてステータス3が表示されていないか検索します。
2022.3 へのアップグレード後の検証 (最終移行後)
Web URI を使用して Server にログインします。
以下を確認します。
ワークフローとアプリを手動で実行できる。
スケジュールがアクティブで、想定される結果で実行されている。
ワークフローの資格情報を表示、編集、作成、使用できる。
Server データ接続を表示、編集、作成、使用できる。
API からワークフローパッケージを取得し、そのパッケージを Designer にインポートして、ワークフローを Designer で実行できる。