移行準備ツール
Server用移行準備ツールは、ワークフローとアプリケーションのデータベースを新しいAES256標準に迅速に移行するために事前移行ができるユーティリティです。
この移行準備ツールはオプションであり、独立したコマンドラインユーティリティです。Server 2022.1 (またはそれ以前のバージョン)から2022.3.x以降にアップグレードする前に、一度実行するだけです。
重要
2022.1以前のバージョンからアップグレードする場合は、2022.3以降にアップグレードする前に移行準備ツールを実行してください。
2022.3以降のバージョンからアップグレードする場合、データベースはすでに暗号化移行されているため、移行準備ツールを実行する必要はありません。
注記
このツールを作成した理由を教えてください。
Serverは、保存データの暗号にAES256を使用するようにアップデートされました。暗号化して保存されている既存のデータはすべて、現在の暗号化方式から新しい暗号化方式に移行する必要があります。このデータの一部は、2022.3へのアップグレードに先立ち、Serverが運用されている間に移行することができます。
移行が必要なデータの中で最も時間がかかるのは、Serverに保存されているアプリとワークフローです。このデータは事前に移行することができるので、Server 2022.3へのアップグレードを実行するときに時間を節約できます。
Alteryxは、アップグレード前にこのデータを移行できるように、移行準備ツールを作成しました。
移行準備ツールを使用するタイミングを教えてください
移行準備ツールは、次の場合に実行することをお勧めします。
アップグレードする Server のインストールが本番システムまたは開発システムで、数時間以上ダウンできない場合
数百以上のワークフローがある場合
MongoDB Atlasまたはユーザー管理のMongoDBで実行している場合
これらのケースが当てはまらない場合でも、アップグレードを実行する前に移行準備ツールを実行して、成功を確実にすることをお勧めします。
さらに、 db.AS_App_Chunks.dataSize() と AS_PackageDefinitions のサイズも考慮することを推奨します。移行準備ツールを準備モードで実行する必要がある場合について、データベースサイズに関連する推奨事項はありません。
ワークフローが少ない場合や、Serverのアップグレードに数時間から数日かかっても問題ない場合は、移行準備ツールの使用を省略し、標準のServerインストーラーを実行して2022.3にアップグレードすることができます。暗号化の移行がアップグレードの一部となるため、ダウンタイムが通常より長くなります。
注記
アップグレード前に移行準備ツールを実行しないことを選択した場合、ツールは2024.1アップグレードインストールの一部としてインストールされ、実行されます。
実行前チェック
2022.3以降にアップグレードする前に対処しておくべき予想される問題を確認するには、移行準備ツールの一部として実行前チェックを実行します。
重要
You can only perform a pre-flight check on Server instances using a 64-character Controller Token.
If your Server is on version 2021.3 or earlier, you need to first upgrade to version 2022.1 before proceeding with the next steps.
Check the length of your Controller Token in Alteryx System Settings > Controller > General > Token > View.
If your token is 40 characters long, select Regenerate to create a new token. Then select OK to restart the AlteryxService and create the new token.
移行準備または完全移行プロセス中に、自分で解決できるエラーログを確認することができます。これにより、エラーが発生しても、推奨されるアクションを実行して完全移行を正常に完了することができます。
移行準備ツールの実行前に利用できる、 新しい実行オプションを3つ 追加しました。
既定: 移行準備と移行準備チェックを同時に実行(-p)
移行準備(アプリ)のみを実行(--appsonly)
資格情報検証ステップのみを実行(--credonly)
移行準備ツールの実行中は、コントローラートークン(-t)とコントローラーのホスト名/IPアドレス(-i)を指定する必要があります。また、コントローラーのホスト名/IPアドレスとコントローラートークンを指定することで、マルチノードセットアップで移行準備ツールを実行できるようになりました。
移行準備ツールの2つのインスタンスは、同じコントローラーに対して同時に実行できません。