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

最終公開日 : Nov 13, 2026

はじめに

新しいマシンやサイトを最初にセットアップすることなく、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: インフラストラクチャサービスをアップグレードする

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. データベースアップグレードウィザードで、必要な情報を入力します。
    データベースアップグレードウィザード(/en-us/workspace-environment-management/2209/media/wem-database-upgrade.png)
    • サーバーとインスタンス名。データベースがホストされているSQL Server\\インスタンスのアドレス。インフラストラクチャサーバーから入力どおりに到達可能である必要があります。
    • データベース名。アップグレードするデータベースの名前。
    • インフラストラクチャサービスはWindows認証を使用します。デフォルトでは、このオプションは選択されていません。この場合、インフラストラクチャサービスはvuemUser SQLユーザーアカウントを使用してデータベースに接続します。(vuemUser SQLユーザーアカウントはインストールプロセス中に作成されます。)SQLインスタンスで混合モード認証が有効になっていることを確認してください。
      選択すると、インフラストラクチャサービスはWindowsアカウントを使用してデータベースに接続します。この場合、選択したWindowsアカウントは、SQLインスタンスにすでにログインがあってはなりません。つまり、データベースの作成に使用したWindowsアカウントと同じアカウントをインフラストラクチャサービスの実行に使用しないでください。
    • 統合接続を使用する。デフォルトでは、このオプションが選択されています。このオプションを使用すると、ウィザードは、ウィザードが実行されている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:エージェントをアップグレードする

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