デプロイをアップグレードする

最終公開日 : Nov 13, 2026

はじめに

注:
WEM 2212以降、エージェントは必要な場合にのみ構成データをダウンロードします。この機能強化により、帯域幅の消費量とインフラストラクチャサービスへの負荷を最大50%削減できます。新機能を参照してください。このメリットを享受できるように、エージェントを2212以降にアップグレードすることをお勧めします。
新しいマシンやサイトを最初にセットアップすることなく、Workspace Environment Management™ (WEM) の展開を新しいバージョンにアップグレードできます。これはインプレースアップグレードと呼ばれます。
Workspace Environment Management 4.7より前のバージョンからバージョン1808以降へのインプレースアップグレードはサポートされていません。それらの以前のバージョンからアップグレードするには、まずバージョン4.7にアップグレードしてから、ターゲットバージョンにアップグレードする必要があります。詳細については、次の表を参照してください。
元 対象 インプレースアップグレードのサポート
4.6以前 4.7 はい
4.6以前 1808以降 いいえ（ターゲットバージョンにアップグレードする前にバージョン4.7にアップグレードしてください）
4.7 1808以降 はい
注:
  • WEMデータベース、インフラストラクチャサービス、および管理コンソールはすべて同じバージョンである必要があります。
  • 2006より前のWEM展開を2209以降にアップグレードする予定がある場合は、次の点に注意してください。データベースのアップグレードの失敗を避けるため、まず2103にアップグレードしてから2209以降にアップグレードしてください。
Workspace Environment Managementコンポーネントは、次の順序でアップグレードする必要があります。
  1. インフラストラクチャサービスをアップグレードする(#step-1-upgrade-the-infrastructure-services)
  2. データベースをアップグレードする(#step-2-upgrade-the-database)
  3. インフラストラクチャサービスを再構成する(#step-3-reconfigure-the-infrastructure-services)
  4. 管理コンソールをアップグレードする(#step-4-upgrade-the-administration-console)
  5. Webコンソールサービスをアップグレードして再構成する(#step-5-upgrade-and-reconfigure-the-web-console-service)
  6. エージェントをアップグレードする(#step-6-upgrade-the-agent)

手順1：インフラストラクチャサービスをアップグレードする

Workspace Environment Managementインフラストラクチャサービスをアップグレードするには、インフラストラクチャサーバーで新しいWorkspace Environment Managementインフラストラクチャサービスのセットアップを実行します。アップグレード手順は、それ以外はインストール手順と同じです。

インフラストラクチャサーバーのオペレーティングシステムをアップグレードする

インフラストラクチャサーバーのオペレーティングシステムをアップグレードするには、まず新しいオペレーティングシステムを搭載した別のマシンにインフラストラクチャサービスをインストールし、同じインフラストラクチャサービス設定で手動で構成してから、「古い」インフラストラクチャサーバーを切断します。
注:
Windows Server 2022にアップグレードした後、WEMインフラストラクチャサービスが応答しなくなることがあります。回避策として、インフラストラクチャサービスを再インストールし、WEMデータベースに接続するように構成してください。

手順2：データベースをアップグレードする

重要:
データベースのアップグレードプロセスは元に戻せません。アップグレードプロセスを開始する前に、有効なデータベースバックアップがあることを確認してください。
ヒント:
Workspace Environment Management PowerShell SDKモジュールを使用してデータベースをアップグレードすることもできます。SDKドキュメントについては、Citrix Developer Documentationを参照してください。
データベースを更新するには、WEM Database Management Utilityを使用します。これは、インフラストラクチャサービスのインストールプロセス中にWorkspace Environment Managementインフラストラクチャサーバーにインストールされます。
注:
SQL Server に Windows 認証を使用している場合は、sysadmin 権限を持つ ID でデータベースアップグレードユーティリティを実行してください。
  1. 「スタート」メニューから、「Citrix® > Workspace Environment Management > WEM Database Management Utility」を選択します。
  2. 「データベースのアップグレード」をクリックします。
  3. データベースアップグレードウィザードで、必要な情報を入力します。
    データベースアップグレードウィザード
    • サーバーとインスタンス名。データベースがホストされている SQL Server\インスタンスのアドレス。インフラストラクチャサーバーから入力どおりに到達できる必要があります。
    • データベース名。アップグレードするデータベースの名前。
    • インフラストラクチャサービスは Windows 認証を使用します。デフォルトでは、このオプションは選択されていません。この場合、インフラストラクチャサービスは vuemUser SQL ユーザーアカウントを使用してデータベースに接続します。（vuemUser SQL ユーザーアカウントはインストールプロセス中に作成されます。）SQL インスタンスで混合モード認証が有効になっていることを確認してください。
      選択すると、インフラストラクチャサービスは Windows アカウントを使用してデータベースに接続します。この場合、選択した Windows アカウントは、SQL インスタンスにすでにログインがあってはなりません。つまり、データベースの作成に使用した Windows アカウントと同じアカウントをインフラストラクチャサービスの実行に使用しないでください。
      gMSA を選択するには、AD ユーザーを選択する場合と同じ手順に従います。gMSA にデータベースの db-owner ロールメンバーシップがあることを確認してください。
    • 統合接続を使用。デフォルトでは、このオプションが選択されています。このオプションを使用すると、ウィザードは、ウィザードが実行されている ID の Windows アカウントを使用して SQL Server に接続し、データベースを作成できます。この Windows アカウントにデータベースを作成する十分な権限がない場合は、十分な権限を持つ Windows アカウントとしてデータベース管理ユーティリティを実行するか、このオプションをクリアして、代わりに十分な権限を持つ SQL アカウントを入力してください。
  4. 「アップグレード」をクリックして、データベースのアップグレードプロセスを開始します。データベースのアップグレードが正常に完了したら、ウィザードを終了します。
データベースのアップグレード中にエラーが発生した場合は、Workspace Environment Management インフラストラクチャサービスインストールフォルダーにある「VUEM Database Management Utility Log」ファイルを確認してください。

手順 3：インフラストラクチャサービスを再構成する

WEM Infrastructure Service Configuration ユーティリティを使用して、インフラストラクチャサービスを再構成します。「インフラストラクチャサービスの構成」を参照してください。

ステップ 4: 管理コンソールをアップグレードする

注:
管理コンソールで構成されたすべての Workspace Environment Management 設定は、データベースに保存され、アップグレード中に保持されます。
管理コンソールをアップグレードするには、管理コンソールのセットアップ実行可能ファイルを実行します。それ以外の手順は、インストール手順と同じです。

ステップ 5: Web コンソールサービスをアップグレードして再構成する

  1. Web コンソールサービスのセットアップ実行可能ファイルを実行して、Web コンソールサービスをアップグレードします。それ以外の手順は、インストール手順と同じです。
  2. WEM Web コンソールサービス構成ユーティリティを実行して、Web コンソールサービスを再構成します。
詳しくは、「Web コンソールサービスのインストールと構成」を参照してください。

ステップ 6: エージェントをアップグレードする

重要:
  • エージェントをアップグレードする前に、ユーザーがログオンしていないことを確認してください。これにより、アップグレードプロセスがそのマシンのファイルを変更できるようになります。
  • WEM インフラストラクチャサービスのバージョンは、WEM エージェントのバージョン以上である必要があります。Citrix は、最新の機能を使用できるように、エージェントを最新バージョンにアップグレードすることをお勧めします。
エージェントをアップグレードするには、ターゲットマシンで新しいエージェントのセットアップ実行可能ファイルを実行します。