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

最終公開日 : 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では、最新の機能を使用できるように、エージェントを最新バージョンにアップグレードすることをお勧めします。
エージェントをアップグレードするには、ターゲットマシンで新しいエージェントのセットアップ実行可能ファイルを実行します。