Skip to main content

移行準備ツールの実行

重要

このツールは、Serverバージョン2022.2以前からの移行のみに使用してください。暗号化メカニズムが2022.3バージョンで更新されました。

始めに

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

警告

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

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

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

  2. EULA に同意します。次へ を選択します。

  3. インストール場所を変更するには、[変更]を選択します。または、[次へ]を選択して既定の場所を受け入れます。

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

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

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

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

  3. コマンドのいずれかを実行して、移行準備ツールを実行します。注: PowerShellを使用する場合は、各コマンドの先頭に .\ を追加します。この操作は、MongoDB サーバーにアクセスできるすべてのホストで実行できます。ダウンタイムなしで複数回安全に実行することができます。

    マルチノードセットアップの場合、IPアドレス/ホスト名、コントローラートークン、NON_ADMIN_MONGO_PASSWORDは、マルチノードセットアップで行った設定に従ってコントローラーノードが実行されているマシンのものである必要があります。

    シングルノードの場合、詳細はAlteryx Serverがインストールされているマシンと同じである必要があります。

例の使用方法:

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

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

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

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

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

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

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

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

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

データベース

組み込みのMongoDB

注: 「NON_ADMIN_MONGO_PASSWORD」、「CONTROLLER_TOKEN」、「localhost」は、現在の設定に基づいて変更してください。

アプリチャンクとRunAS_Credentialsの両方を移行

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

アプリチャンクの移行のみ

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

RunAS_Credentialの移行のみ

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token>

ユーザー管理型MongoDB

注: 「Password」、「port」、「host.domain.tld」、「authenticationDB」は、現在のMongoDBインスタンスに基づいて変更してください。

アプリチャンクとRunAS_Credentialsの両方を移行

AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

アプリチャンクの移行のみ

AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

RunAS_Credentialの移行のみ

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

MongoDBレプリカセット

アプリチャンクとRunAS_Credentialsの両方を移行

AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

アプリチャンクの移行のみ

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

RunAS_Credentialの移行のみ

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token>

MongoDB Atlas

アプリチャンクとRunAS_Credentialsの両方を移行

AlteryxServiceMigrator22_2.exe -p -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

アプリチャンクの移行のみ

AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

RunAS_Credentialの移行のみ

AlteryxServiceMigrator22_2.exe --credonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token>

コマンドパラメーター
  • -h [ --help] ヘルプ情報を表示する

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

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

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

  • --appsonlyプレフライトチェックなしでチャンク移行のみを実行する

  • --credonlyチャンク移行なしでプレフライトチェックを実行する

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

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

  • -i [--hostname]引数 ホスト名|コントローラーのIPアドレス

  •  -t [--controllertoken]引数 キーを取得するコントローラートークン

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

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

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

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

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

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

トラブルシューティング

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

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

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

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

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

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

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

注記

エラーError during key initialization <Error Error importing keys to Microsoft\Crypto\RSA\MachineKeys\ directory in ProgramData: Access is denied.(5)> RunAs Migration failedが移行コマンドの実行中に生じた場合、C:\ProgramData\Microsoft\Crypto\RSA\MachineKeysに移動します。次に、MachineKeysフォルダーを右クリックして、[Show more options] > [Give access to] > [Specific people]を選択します。[読み取り/書き込み]アクセスで[すべてのユーザー]を選択します。[共有]を選択します。

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

重要

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

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

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

  1. downloads.alteryx.comからServer 2024.1をダウンロードします。

  2. インストーラーを実行します。[はい]を選択してアップグレードを続行します。

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

  4. インストールパスを選択するか、既定のパスに設定します。[次へ]を選択します。

  5. [インストール]を選択して、インストール(アップグレード)を開始します。

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

  7. Server 2024.1のインストールが完了したら、[バックアップと移行を開始する]オプションを選択します。

  8. 移行が正常に完了したら、[OK]を選択します。

注: インストール後、サービスの開始に遅延が生じる場合があります。

インストール後のステップ

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

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

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

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

トラブルシューティング

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

  • LastStartupError.txt

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

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

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

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

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

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

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

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

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

サービス開始ログの検証

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

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

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

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

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

  2. 以下を確認します。

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

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

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

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

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