Workspace Environment Management

移行

重要:

  • 既存のオンプレミスの 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-migration-tool.zip) をダウンロードします。適切なフォルダーにzipファイルを展開します。

注:

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

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

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

Citrix WEM 移行ツール

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

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

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

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

ターゲット。オンプレミスの WEM データベースのコンテンツを含む SQL ファイルを保存するためのフォルダです。[ 参照 ] ボタンを使用して、SQL ファイルを保存するフォルダにナビゲートします。

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

統計をエクスポートします。エージェントとユーザの統計をエクスポートするかどうかを制御します。有効にすると、エクスポートされるデータベースファイルに統計情報が含まれます。デフォルトでは、このオプションは無効になっています。移行を高速化するために、このオプションは有効にしないことをお勧めします。

注:

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

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

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

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

注:

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

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

エクスポート中にエラーが発生した場合は、 Citrix WEM 移行Tool.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. [管理] > [レガシーコンソール] で、ハンバーガーメニューにカーソルを合わせます。

    管理 > レガシーコンソールのハンバーガーメニュー

  2. Citrix Workspaceアイコンをクリックします。

    HTML5ツールバー用のCitrix Workspace アプリ

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

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

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

重要:

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

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

移行