移行

重要:

  • 既存のオンプレミスの WEM データベースを WEM サービスに移行する場合は、必ず最新バージョンの移行ツールを使用してください。
  • 移行ツールが期待どおりに動作するようにするには、.NET Framework をアップグレードする必要があります。WEM 1909 以前を使用する場合は、ツールを実行するコンピューターで.NET Framework 4.7.1 以降にアップグレードします。
  • インフラストラクチャサービスがインストールされているコンピューターで移行ツールを実行することをお勧めします。これにより、インフラストラクチャサービスが WEM データベースに接続でき、インフラストラクチャサービスが実行されているマシンに必要なコンポーネントがあることが保証されます。

既存のオンプレミスのWorkspace Environment Management (WEM) データベースを WEM サービスに移行するためのツールキットを提供します。このツールキットには、WEM データベースの内容を含む SQL ファイルを生成するウィザードと、SQL ファイルを WEM サービスの Azure データベースにアップロードする簡単な方法が含まれています。この記事では、オンプレミスデータベースの移行を完了する方法について説明します。移行プロセスを開始する前にシーケンス全体を確認して、予想される内容を確認します。

WEM データベースを移行する前に、次の点に注意してください。

  • 移行が正常に完了すると、現在の WEM サービスデータベースに関連付けられているすべてのデータが失われます。
  • WEM サービスが正常にプロビジョニングされた後にのみ、WEM データベースを移行できます。
  • 移行プロセスを開始する前に、オンプレミスのWEMデータベースをバックアップすることをお勧めします。
  • 移行プロセスを開始する前に、[データベースのメンテナンス] タブでデータベースのメンテナンスを構成することをお勧めします。これにより、WEM データベースのサイズが小さくなり、移行エクスペリエンスが向上します。データベースのメンテナンスの詳細については、インフラストラクチャサービスを構成するを参照してください。
  • WEMサービスのアップグレード中にWEMデータベースを移行しようとすると、Citrix Cloudユーザーインターフェイスの右上隅にある通知領域に次のエラーメッセージが表示されます:「Workspace Environment Managementサービスのアップグレードが進行中のため、Workspace Environment Managementデータベースの移行に失敗しました。後でもう一度お試しください。」このような場合は、WEM サービスが正常にアップグレードされた後に SQL ファイルをアップロードしてみてください。サービスのアップグレードは、Citrix Cloudユーザーインターフェイスの右上隅にも通知されます。

システム要件

このツールキットは、WEM 4.7 以降からの移行をサポートします。以前のバージョンから移行するには、WEM 4.x を WEM 4.7 以降にアップグレードしてから、データベースを WEM サービスに移行します。アップグレードについて詳しくは、「環境のアップグレード」を参照してください。

導入

Citrix Cloudアカウントにログオンします。詳しくは、「Citrix Cloud アカウントとは」を参照してください。

オンプレミスデータベースを移行する

手順 1: 移行ツールをダウンロードする

WEM サービスの [ ダウンロード ] タブから移行ツール (WEM 移行ツール.zip) をダウンロードします。適切なフォルダーにzipファイルを展開します。

注:

インフラストラクチャサービスがインストールされているマシンで移行ツールを実行することをお勧めします。これにより、インフラストラクチャサービスが WEM データベースに接続でき、インフラストラクチャサービスが実行されているマシンに必要なコンポーネントがあることが保証されます。

手順 2: データベースデータを SQL ファイルにエクスポートする

zipファイルに含まれている Citrix WEM移行ツール.exe を実行します。

Citrix WEM 移行ツール

ウィザードで次のデータを入力します。

サーバーとインスタンス名。データベースをホストするSQLサーバー・インスタンスのアドレス。ここで入力したとおりにインフラストラクチャサーバから到達可能である必要があります。

統合接続 (Windows 認証情報) を使用します。選択すると、 データベース移行ウィザード は、実行中の ID の Windows アカウントを使用して SQL サーバーに接続し、オンプレミスの WEM データベースの内容を含む SQL ファイルを生成できます。このWindowsアカウントに十分な権限がない場合は、十分な権限を持つWindowsアカウントを使用して Citrix WEM Migration Tool.exe を実行するか、このオプションをオフにして十分な権限を持つSQLアカウントを指定します。

データベース名。移行するデータベースの名前。

ターゲット。オンプレミスの WEM データベースの内容を含む SQL ファイルを保存するフォルダ。「 参照 」ボタンを使用して、SQLファイルを保存するフォルダに移動します。

ログをエクスポートします。ログをエクスポートするかどうかを制御します。ログには、WEM エージェントに加えられた変更が含まれます。有効にすると、エクスポートされるデータベースファイルにログが含まれます。移行を高速化するために、このオプションを有効にしないことをお勧めします。

注:

ファイルとして保存すると、WEMデータベースファイルは自動的に「データベースname_upload.7z」に名前が変更されます。

[ エクスポート ] をクリックしてデータベースのエクスポートプロセスを開始するか、[ キャンセル ] をクリックして データベースマイグレーションウィザード を終了します。

エクスポートプロセス中に、[ データベースマイグレーションステータス] ウィンドウが表示されます。

エクスポートプロセスが終了したら、[ 完了 ] をクリックしてウィンドウを閉じ、 データベースマイグレーションウィザード に戻ります。

注:

  • データベースのサイズによっては、エクスポート処理に数秒から数分、あるいは数時間かかることがあります。

  • データベースのエクスポート中に [ データベースマイグレーションステータス] ウィンドウを閉じると、 データベースマイグレーションウィザード に戻ります。ただし、データベースの エクスポートプロセスはバックグラウンドで続行されるため、[エクスポート ] ボタンは無効になります。エクスポート処理を完全に停止するには、[ キャンセル] をクリックします。

エクスポート中にエラーが発生した場合は、 Citrix WEM移行ツール **.exeを含む移行ツールフォルダーにあるCitrix WEM移行 ツールのデバッグログ** ファイルを確認します。

ステップ 3: SQL ファイルを WEM サービスデータベースにアップロードする

重要:

アップロードが完了する前に、Workspace Environment Management サービスのページを閉じないでください。そうしないと、SQL ファイルを正常にアップロードできません。

  1. WEM サービスの [ ダウンロード ] タブで、[ アップロード ] をクリックしてアップロードプロセスを開始します。
  2. [SQL ファイルのアップロード] ページで [ファイルの選択 ] をクリックし、アップロードする SQL ファイルを選択します。
  3. [ OK] をクリックしてアップロードを開始し、[WEM サービス ダウンロード ] タブに戻ります。

WEM サービスの [ ダウンロード ] タブに戻ると、[ アップロード ] の下に進行メッセージが表示されます。このメッセージは、アップロードの進行に伴って更新されます。SQL ファイルが正常にアップロードされると、移行プロセスが自動的に開始されます。

注:

SQL ファイルが正常にアップロードされたら、10 分待ってから再度アップロードできます。

移行後

数時間後に、移行の結果を通知する通知メッセージが届きます。Citrix Cloudのユーザーインターフェイスの右上隅に通知が表示されます。移行が正常に完了したら、[ Manage ] タブで次の手順を実行して、オンプレミスの WEM データベースから移行されたデータを表示します。

手順 1: 移行したデータを WEM サービスコンソールにロードする

  1. WEM サービスの [ 管理 ] タブのドロップダウンメニューにマウスを合わせます。
  2. Citrix Workspaceアイコンをクリックします。
  3. 省略記号アイコンをクリックして、追加オプションを展開します。
  4. ログオフ 」をクリックして、WEM サービスから切断します。
  5. ブラウザーウィンドウを更新して、WEM サービスに再接続し、オンプレミスの WEM データベースから移行されたデータを表示します。

手順 2: サービスエージェントモードに切り替える

エージェントスイッチ機能を使用して、オンプレミスエージェントモードからサービスエージェントモードに切り替えます。エージェントスイッチの詳細については、エージェントスイッチを参照してください。

重要:

エージェントスイッチ機能は、Workspace Environment Management 1909 以降で使用できます。以前のバージョンでは、エージェントスイッチを使用する前に、エージェントを再インストールするか、またはバージョン 1909 以降にアップグレードする必要があります。

または、サービスの [ ダウンロード ] タブからエージェントをダウンロードし、エージェントを手動で再インストールすることもできます。

移行