展開のアップグレード

最終公開日 : Nov 13, 2026
注:
従来、さまざまなオンプレミスコンポーネントのアクティベーションに使用されてきたファイルベースのライセンスシステムは、April 15, 2026にサポート終了（EOL）となります。License Activation Service (LAS) は、Citrix製品スイート全体での製品アクティベーションのための次世代テクノロジーです。April 15, 2026以降、LASがCitrixオンプレミスコンポーネントをアクティベートおよびライセンス供与する唯一の方法となります。サポートを継続するには、Citrix Virtual Apps and Desktopsの展開がLAS互換バージョンである必要があります。LAS互換の最小要件となるCVADバージョンは次のとおりです。
  • CVAD 2203 LTSR CU7
  • CVAD 2402 LTSR CU3
  • CVAD 2507 LTSR
  • CVAD 2411
ご質問やご不明な点がございましたら、カスタマーケアにお問い合わせください。Citrixは、これらの要件を遵守しない場合、Citrixが法律上または衡平法上持つ可能性のあるその他の救済措置に加えて、責任を負うことなくCitrix Maintenanceを制限または停止することがあります。これらの要件は、法律または規制によって禁止されている場合は適用されません。
Related information
アップグレードと移行

はじめに

注:
この記事では、Web Studioを含む展開のアップグレードについて説明します。Citrix Studioを含むアップグレードについては、Citrix Virtual Apps and Desktops™ 7 2212以前の同等の記事を参照してください。
新しいマシンやサイトを最初にセットアップすることなく、特定の展開を新しいバージョンにアップグレードできます。これはインプレースアップグレードと呼ばれます。
アップグレードできるCitrix Virtual Apps and Desktopsのバージョンについては、(/ja-jp/citrix-virtual-apps-desktops/2411/upgrade-migrate.html#versions-you-can-upgrade)を参照してください。
Citrix Virtual Apps and Desktopsのいずれかのリリースにアップグレードする前に、現在のCustomer Success Servicesの有効期限が切れていないことを確認してください。詳細については、(/ja-jp/licensing/current-release/customer-success-services.html#customer-success-services-renewal-licenses)の記事を参照してください。
アップグレードを開始するには、新しいバージョンのインストーラーを実行して、以前にインストールされたコアコンポーネント、VDA、および特定のその他のコンポーネントをアップグレードします。次に、データベースとサイトをアップグレードします。
新しいバージョンが提供されている場合、フルプロダクトインストーラー（およびスタンドアロンVDAインストーラー）でインストールできるコンポーネントはすべてアップグレードできます。フルプロダクトインストーラーでインストールされないその他のコンポーネント（Citrix Provisioning™やProfile Managementなど）については、そのコンポーネントのドキュメントを参照してください。ホストのアップグレードについては、適切なドキュメントを参照してください。
アップグレードを開始する前に、この記事のすべての情報を確認してください。

アップグレードシーケンス

次の図は、アップグレードシーケンスの手順を示しています。アップグレード手順には、図の各手順の詳細が含まれています。
アップグレードシーケンスのフロー図
注:
障害を回避するため、新しいマシンカタログの作成、マシンカタログの削除、デリバリーグループ内のマシンの更新など、プロビジョニングおよびデリバリーグループ関連のタスクを実行する前に、すべてのDelivery Controllerとデータベースをアップグレードする必要があります。

ハイブリッド権限ライセンス

ハイブリッドライツライセンスは、顧客が永続ライセンスからクラウドサービスサブスクリプションに移行またはアップグレードする際に、クラウドサービスサブスクリプションに加えて提供される期間ベースのサブスクリプションライセンスです。DaaSサブスクリプションでハイブリッドライツアドオンを購入することもできます。
SaaS属性を持つハイブリッドライツライセンスをお持ちの場合、Citrix Virtual Apps and Desktops LTSR 2203以降にアップグレードすると、Citrix Virtual Apps and Desktops LTSR 1912では利用できなかった機能にアクセスできるようになります。これらの機能には、Microsoft Azure、AWS EC2、Google Cloudなどのパブリッククラウドでのワークロードのプロビジョニングとホスティングが含まれます。新しいライセンスファイルを展開する前に、License Serverを最新バージョンに更新してください。
SaaS属性のないハイブリッドライツライセンスにアクセスできる場合は、次の手順に従ってSaaS属性を持つ新しいハイブリッドライツライセンスにアクセスしてください。
注:
  • 新しいライセンスコードが記載されたメールが届きます。詳細については、ライセンスアクセスコードの使用を参照してください。
  • 既存のライセンスは取り消されます。取り消されたライセンスは、ライセンスサーバーから削除し、その後新しいライセンスをインストールする必要があります。詳細については、ライセンスファイルの削除を参照してください。
  1. citrix.comのライセンス管理ポータルにアクセスし、クラウドプロビジョニング権限が有効になっている（SaaS属性を持つ）新しいハイブリッドライツライセンスファイルをダウンロードします。詳細については、ライセンスのダウンロードを参照してください。次の画像は、インクリメントセクションにSaaS属性を持つハイブリッドライツライセンスファイルを示しています。
    「ライセンスファイルのSaaS属性」(/en-us/citrix-virtual-apps-desktops/2411/media/lic-file-hybrid-rights.png)
  2. ハイブリッド権限ライセンスファイルをライセンスサーバーにインストールします。詳細については、「ライセンスのインストール」を参照してください。
  3. ライセンスのエディションまたはモデルに変更がある場合は、brokerコマンドを実行してエディションとモデルを設定し、インプレースアップグレードを開始してください。Brokerコマンドの詳細については、「Broker PowerShell SDK」セクションを参照してください。
Citrix Virtual Apps and DesktopsのCurrent ReleasesおよびLong Term Service Releasesでのパブリッククラウドサポートの詳細については、「CTX270373」を参照してください。

アップグレード手順

主要な製品コンポーネントのほとんどは、コンポーネントを含むマシンで製品インストーラーを実行することでアップグレードできます。
1台のマシンに複数のコンポーネント（StudioやLicense Serverなど）が含まれている場合、製品メディアにそれらのソフトウェアの新しいバージョンが含まれていれば、そのマシン上のすべてのコンポーネントがアップグレードされます。
インストーラーを使用するには：
  • フル製品インストーラーのグラフィカルインターフェイスを実行するには、マシンにログオンし、メディアを挿入するか、新しいリリースのISOドライブをマウントします。「AutoSelect」をダブルクリックします。
  • コマンドラインインターフェイスを使用するには、適切なコマンドを発行します。「コマンドラインを使用したインストール」を参照してください。

ステップ1：準備

アップグレードを開始する前に、準備が整っていることを確認してください。必要なタスクを読み、完了してください。

手順2：ライセンスサーバーのアップグレード

インストールに新しいバージョンのCitrix License Serverソフトウェアが含まれている場合は、他のコンポーネントよりも先にこのコンポーネントをアップグレードしてください。
まだライセンスサーバーが新しいバージョンと互換性があるかどうかを判断していない場合は、他のコアコンポーネントをアップグレードする前に、ライセンスサーバーでインストーラーを実行することが不可欠です。

手順3：StoreFront™のアップグレード

インストールメディアにStoreFrontソフトウェアの新しいバージョンが含まれている場合は、StoreFrontサーバーがインストールされているマシンでインストーラーを実行します。
  • グラフィカルインターフェイスで、 セクションから を選択します。
  • コマンドラインから、Citrix Virtual Apps and Desktopsインストールメディアのx64フォルダーにあるCitrixStoreFront-x64.exeを実行します。

手順4：Directorのアップグレード

インストールメディアにDirectorソフトウェアの新しいバージョンが含まれている場合は、Directorがインストールされているマシンでインストーラーを実行します。

手順5：Citrix Provisioningのアップグレード

Citrix Provisioningのインストールメディアは、Citrix Virtual Apps and Desktopsのインストールメディアとは別に提供されています。Citrix Provisioningサーバーおよびターゲットデバイスソフトウェアのインストールとアップグレードの方法については、Citrix Provisioning製品ドキュメントを参照してください。

ステップ6：Delivery Controllerの半分をアップグレードする

たとえば、サイトに4つのControllerがある場合、そのうちの2つでインストーラーを実行します。
Controller の半分をアクティブなままにしておくことで、ユーザーはサイトにアクセスできます。VDA は残りの Controller に登録できます。Controller の数が少ないため、サイトの容量が低下する場合があります。アップグレードは、最終的なデータベースアップグレード手順中に新しいクライアント接続を確立する際に、一時的な中断を引き起こすだけです。アップグレードされた Controller は、サイト全体がアップグレードされるまで要求を処理できません。
サイトに Controller が1つしかない場合、アップグレード中は動作しません。
実際のアップグレードが開始される前に、最初の Controller で予備サイトテストが実行されます。詳細については、予備サイトテストを参照してください。

ステップ7：Studioのアップグレード

Web Studio をまだアップグレードしていない場合（別のコンポーネントと同じマシンにあったため）、Studio が含まれているマシンでインストーラーを実行します。
注:
Web Studio をアップグレードした後、バージョン情報がすぐに更新されない場合があります。Web Studio がすでに最新の状態であっても、アップグレードを促されることがあります。この問題に対処するには、Web Studio サーバーに移動し、Internet Information Services (IIS) マネージャーを開き、 > > に移動して、 ペインで を選択します。

ステップ8：Studioの再起動

アップグレードされた Web Studio を再起動します。アップグレードプロセスが自動的に再開されます。

ステップ9：データベースとサイトのアップグレード

注:
障害を回避するには、新しいマシンカタログの作成、マシンカタログの削除、デリバリーグループ内のマシンの更新など、プロビジョニングおよびデリバリーグループ関連のタスクを実行する前に、すべての Delivery Controller とデータベースをアップグレードする必要があります。
SQL Server データベースのスキーマを更新するために必要な権限については、準備 を確認してください。
  • SQL Server データベーススキーマを更新する十分な権限がある場合は、データベースの自動アップグレードを開始できます。データベースとサイトを自動的にアップグレードする に進みます。
  • データベースの権限が不十分な場合は、スクリプトを使用する手動アップグレードを開始し、データベース管理者（必要な権限を持つユーザー）の助けを借りて続行できます。手動アップグレードの場合、Studio ユーザーがスクリプトを生成し、サービスを有効化および無効化するスクリプトを実行します。データベース管理者は、SQLCMD ユーティリティまたは SQLCMD モードの SQL Server Management Studio を使用して、データベーススキーマを更新する他のスクリプトを実行します。データベースとサイトを手動でアップグレードする に進みます。
  • マルチゾーン展開でデータベースとサイトを自動的にアップグレードする場合は、サイトの SQL Server データベースをホストするのと同じゾーンで dbschema アップグレードを実行することを Citrix は推奨します。そうしないと、データベースとサイトの自動アップグレードが失敗する可能性があります。
Citrix は、アップグレード前にデータベースをバックアップすることを強く推奨します。CTX135207 を参照してください。データベースのアップグレード中は、製品サービスが無効になります。その間、Controller はサイトの新しい接続を仲介できないため、慎重に計画してください。

データベースとサイトを自動的にアップグレードする

  1. 新しくアップグレードされた Studio を起動します。
  2. サイトのアップグレードを自動的に開始することを示し、準備ができたことを確認します。
データベースとサイトのアップグレードが進行します。

データベースとサイトを手動でアップグレードする

  1. 新しくアップグレードされた Studio を起動します。
  2. サイトを手動でアップグレードすることを示します。ウィザードはライセンスサーバーの互換性を確認し、確認を求めます。
  3. データベースをバックアップしたことを確認します。
    ウィザードは、スクリプトとアップグレード手順のチェックリストを生成して表示します。アップグレード対象の製品バージョン以降、データベースのスキーマが変更されていない場合、そのスクリプトは生成されません。たとえば、ログデータベースのスキーマが変更されない場合、UpgradeLoggingDatabase.sql スクリプトは生成されません。
  4. 次のスクリプトを、表示されている順序で実行します。
    • DisableServices.ps1: Studioユーザーは、製品サービスを無効にするために、ControllerでこのPowerShellスクリプトを実行します。
    • UpgradeSiteDatabase.sql: データベース管理者は、サイトデータベースを含むサーバーでこのSQLスクリプトを実行します
    • UpgradeMonitorDatabase.sql: データベース管理者は、監視データベースを含むサーバーでこのSQLスクリプトを実行します。
    • UpgradeLoggingDatabase.sql: データベース管理者は、構成ログデータベースを含むサーバーでこのSQLスクリプトを実行します。このスクリプトは、このデータベースが変更された場合（たとえば、修正プログラムを適用した後など）にのみ実行してください。
    • EnableServices.ps1: Studioユーザーは、製品サービスを有効にするために、ControllerでこのPowerShellスクリプトを実行します。
    データベースのアップグレードが完了し、製品サービスが有効になると、Studioは環境と構成を自動的にテストし、HTMLレポートを生成します。問題が特定された場合は、データベースのバックアップを復元できます。問題を解決した後、データベースを再度アップグレードできます。
  5. チェックリストのタスクを完了したら、Finish upgradeをクリックします。

ステップ10：残りのDelivery Controllerをアップグレードする

新しくアップグレードされたStudioから、ナビゲーションペインでCitrix Studio サイト名を選択します。Common Tasksタブで、Upgrade remaining Delivery Controllersを選択します。
注:
Upgrade remaining Delivery Controllersを利用できるようにするには、サイト用に少なくとも1つのマシンカタログと1つのデリバリーグループを作成します。
アップグレードを完了し、完了を確認したら、Studioを閉じてから再度開きます。Studioは、Controllerのサービスをサイトに登録するため、またはゾーンIDが存在しない場合にゾーンIDを作成するために、追加のサイトアップグレードを促すことがあります。

ステップ11：VDAをアップグレードする

重要:
VDAをバージョン1912以降にアップグレードする場合は、「VDAを1912以降にアップグレードする」を参照してください。
VDAsを含むマシンで製品インストーラーを実行します。
Machine Creation Services™とマスターイメージを使用してマシンを作成した場合は、ホストに移動してマスターイメージ上のVDAをアップグレードします。利用可能なVDAインストーラーのいずれかを使用できます。
  • グラフィックインターフェイスのガイダンスについては、VDAsのインストールを参照してください。
  • コマンドラインのガイダンスについては、コマンドラインを使用したインストールを参照してください。
Citrix Provisioningを使用してマシンを作成した場合は、アップグレードのガイダンスについてCitrix Provisioning製品ドキュメントを参照してください。

ステップ12：マシンカタログとデリバリーグループを更新する

ステップ13：アップグレード後

展開内の他のコンポーネントをアップグレードします。ガイダンスについては、以下の製品ドキュメントを参照してください。
Microsoft SQL Server Express LocalDBソフトウェアを以降のバージョンに置換する必要がある場合は、「SQL Server Express LocalDBの置換」(#replace-sql-server-express-localdb)を参照してください。

Dbschemaのアップグレード

展開を更新すると、複数のデータベーススキーマをアップグレードできます。次の表に、そのプロセスでアップグレードされるデータベーススキーマを示します。
Dbschemaの更新
用語の定義:
  • サイト: サイトデータストア。Dbschemaの更新はサイトデータストアに対して行われます。
  • モニター: モニターデータストア。Dbschemaの更新はモニターデータストアに対して行われます。
  • 構成: 構成テーブル。構成テーブルでは、Desktop Studioのバージョン、ライセンス情報、またはその両方が更新されます。
  • ロギング: ロギングデータストア。Dbschemaの更新はロギングデータストアに対して行われます。

VDAを2203以降にアップグレードする

Personal vDisk (PvD)コンポーネントがVDAにインストールされていた場合、そのVDAはバージョン2203以降にアップグレードできません。新しいVDAを使用するには、現在のVDAをアンインストールしてから、新しいVDAをインストールする必要があります。
この指示は、PvDを一度も使用したことがない場合でも適用されます。
以前のバージョンで PvD コンポーネントがインストールされた可能性のある方法は次のとおりです。
  • VDA インストーラーのグラフィックインターフェイスでは、PvD は ページのオプションでした。
  • コマンドラインでは、/baseimage オプションで PvD がインストールされました。このオプションを指定した場合、またはこのオプションを含むスクリプトを使用した場合は、PvD がインストールされました。
VDA に PvD がインストールされているかどうかわからない場合は、マシンまたはイメージで新しい VDA (2203 以降) のインストーラーを実行します。
  • PvD がインストールされている場合、互換性のないコンポーネントがあることを示すメッセージが表示されます。
    • グラフィックインターフェイスから、メッセージを含むページで をクリックし、インストーラーを閉じたいことを確認します。
    • CLI からは、コマンドは表示されたメッセージとともに単に失敗します。
  • PvD がインストールされていない場合、アップグレードが続行されます。

対処法

VDAにPvDがインストールされていない場合は、通常のアップグレード手順に従ってください。
VDAにPvDがインストールされている場合：
  1. 現在のVDAをアンインストールします。
  2. 新しいVDAをインストールします。
Windows 10 (1607 以前、更新なし) マシンで PvD の使用を継続したい場合は、VDA 7.15 LTSR がサポートされる最新バージョンです。
注記:
XenApp and XenDesktop 7.15 LTSR で Windows 7 デスクトップと Personal vDisk を使用できますか？
Citrix は、2016年1月に発表された XenApp and XenDesktop 7.6 LTSR から Personal vDisk (PvD) を除外しました。さらに、Citrix は PvD テクノロジの非推奨を発表し、今後 Citrix App Layering の使用を開始するようお客様に推奨しています。Citrix App Layering (バージョン 4.4 以降) は、XenApp and XenDesktop 7.15 LTSR の互換性のあるコンポーネントです。ただし、Windows 7 上で既存の PvD 展開を使用しているお客様が Citrix App Layering テクノロジに移行できるよう、Citrix は XenApp and XenDesktop 7.15 LTSR 累積更新プログラム (CU) を通じて Windows 7 デスクトップ用の PvD 展開に対する期間限定のサポートを Jan 14, 2020 まで提供することを決定しました。PvD コンポーネントは LTSR CU から削除され、Jan 14, 2020 以降はサポートされません。また、Jan 14, 2020 以降に Windows 7 で PvD を使用すると、LTSR サイトは非準拠になります。また、Windows 10 用の PvD は 7.15 LTSR から引き続き除外されます。したがって、お客様は 7.15 LTSR サイトでこれを使用しないでください。

PvD、AppDisks、およびサポートされていないホストを削除する

Citrix Virtual Apps and Desktops 7 Current Release の展開では、以下のテクノロジとホストの種類はサポートされていません。
  • Personal vDisks (PvD)。カタログ内のユーザーの VM の隣にデータを保存するためのものです。ユーザーパーソナライゼーションレイヤー機能が、ユーザーの永続性を処理するようになりました。
  • AppDisks。デリバリーグループで使用されるアプリケーションを管理するためのものです。
  • ホストの種類: Azure Classic、CloudPlatform (元の Citrix 製品)。
    • このリリースでサポートされているホストの種類については、システム要件を参照してください。
    • ARM と AWS を引き続き使用できる代替方法については、CTX270373を参照してください。
現在の展開で PvD または AppDisks を使用している場合、またはサポートされていないホストの種類 (Microsoft Azure Classic など) への接続がある場合、それらのテクノロジを使用する項目を削除した後にのみ、バージョン 2006 (またはそれ以降のサポートされているバージョン) にアップグレードできます。現在の展開でパブリッククラウドホスト接続 (AWS など) を使用している場合は、アップグレードする前にハイブリッド権限ライセンスがあることを確認してください。インストーラーがサポートされていないテクノロジまたはハイブリッド権限ライセンスのないホスト接続を 1 つ以上検出すると、アップグレードは一時停止または停止し、説明メッセージが表示されます。インストーラーログに詳細が含まれています。
アップグレードを確実に成功させるために、サポートされていない項目を削除するための該当するガイダンスを確認し、それに従ってください。
展開でPvDまたはAppDisksを使用していなかった場合でも、関連するMSIが以前のVDAインストールまたはアップグレードに含まれていた可能性があります。VDAをバージョン2006（またはそれ以降のサポートされているバージョン）にアップグレードする前に、たとえ一度も使用していなかったとしても、そのソフトウェアを削除する必要があります。グラフィカルインターフェイスを使用する場合、その削除は自動的に行われるか、CLIを使用する際に削除オプションを含めることができます。詳細については、「PvDまたはAppDisksコンポーネントを持つVDAのアップグレード」を参照してください。

PvDを削除する

PvDを使用するように構成されているすべてのマシンを削除するまで、展開のアップグレードは成功しません。これはカタログとデリバリーグループに影響します。
グループおよびカタログからPvDを削除するには：
  1. Studioで、デリバリーグループにPvDを使用するカタログのマシンが含まれている場合は、それらのマシンをグループから削除します。
  2. Studioで、PvDを使用するマシンを含むすべてのカタログを削除します。
VDAのアップグレード： 展開のアップグレードでは、VDAにAppDiskまたはPvDコンポーネントがインストールされているかどうかは検出されません。ただし、VDAインストーラーは検出します。詳細については、「PvDまたはAppDisksコンポーネントを持つVDA」を参照してください。
PvDの代わりにApp Layeringを使用する予定がある場合は、データの移行に関する情報について「PvDからApp Layeringへの移行」を参照してください。

AppDisksを削除する

AppDisksを使用するすべてのデリバリーグループからAppDisksを削除し、その後AppDisks自体を削除するまで、展開のアップグレードは続行できません。
  1. Studioのナビゲーションペインで**［デリバリーグループ］**を選択します。
  2. グループを選択し、アクションペインで**［AppDiskの管理］**をクリックします。
  3. グループからAppDiskを削除するアクションをクリックします。
  4. AppDisksを使用する各デリバリーグループに対して、手順2と3を繰り返します。
  5. Studioのナビゲーションペインで、 を選択します。
  6. AppDisk を選択し、AppDisk を削除するアクションをクリックします。
  7. 各 AppDisk について、手順 5 と 6 を繰り返します。
VDA のアップグレード: 展開のアップグレードでは、VDA に AppDisk または PvD コンポーネントがインストールされているかどうかは検出されません。ただし、VDA インストーラーは検出します。詳細については、「PvD または AppDisk コンポーネントがインストールされている VDA」を参照してください。

サポートされていないホストアイテムを削除する

サイトが Citrix CloudPlatform や Microsoft Azure Classic などのサポートされていないホストタイプに接続している場合、バージョン 2006 (またはそれ以降のサポートされているバージョン) への展開のアップグレードは続行できません。アップグレードを試みる前に、次のタスクを完了してください。
Studio から:

PvD または AppDisk コンポーネントがインストールされている VDA

PvD および AppDisk テクノロジーを有効にするコンポーネントが VDA にインストールされている場合、それらのコンポーネントが削除されるまで、その VDA はアップグレードできません。
注:
バージョン 1912 にアップグレードする場合、現在の VDA をアンインストールしてから新しい VDA をインストールする必要がありました。このバージョンでは、Citrix がコンポーネントを削除してアップグレードを続行するかどうかを尋ねられます。
AppDisk および PvD コンポーネントは、それらのテクノロジーを一度も使用していなくても、以前の VDA バージョンでインストールされている可能性があります。
  • グラフィカルインターフェイス: VDA インストーラーの ページには、 オプションが含まれていました。7.15 LTSR およびそれ以前の 7.x リリースでは、このオプションがデフォルトで有効になっていました。したがって、デフォルトを受け入れた場合 (または、このオプションが提供されているリリースで明示的に有効にした場合)、そのコンポーネントがインストールされました。
  • CLI: /baseimageオプションを指定すると、コンポーネントがインストールされます。

実行すること

VDAインストーラーが現在インストールされているVDAでAppDisksまたはPvDコンポーネントを検出しない場合、アップグレードは通常どおり続行されます。
インストーラーが現在インストールされているVDAでAppDisksまたはPvDコンポーネントを検出した場合：
  • グラフィカルインターフェイス：アップグレードが一時停止します。サポートされていないコンポーネントを自動的に削除するかどうかを尋ねるメッセージが表示されます。OKをクリックすると、コンポーネントは自動的に削除され、アップグレードが続行されます。
  • CLI：コマンドの失敗を避けるため、コマンドに次のオプションを含めます。
    • /remove_appdisk_ack
    • /remove_pvd_ack

制限事項

アップグレードには次の制限が適用されます。
  • コンポーネントの選択的インストール： 新しいバージョンにコンポーネントをインストールまたはアップグレードしても、アップグレードが必要な他のコンポーネント（別のマシン上）をアップグレードしないことを選択した場合、Studioが通知します。たとえば、アップグレードにControllerとStudioの新しいバージョンが含まれているとします。Controllerはアップグレードしますが、Studioがインストールされているマシンでインストーラーを実行しません。Studioをアップグレードするまで、Studioはサイトの管理を続行できません。
    VDAをアップグレードする必要はありませんが、利用可能なすべての機能を使用できるように、すべてのVDAをアップグレードすることをCitrixは推奨します。
  • 早期リリースまたはテクノロジープレビューバージョン： 早期リリース、テクノロジープレビュー、またはプレビューバージョンからアップグレードすることはできません。
  • 以前のオペレーティングシステム上のコンポーネント： MicrosoftまたはCitrixによってサポートされなくなったオペレーティングシステムに現在のVDAをインストールすることはできません。詳細については、「以前のオペレーティングシステム」を参照してください。
  • 混在環境/サイト： 以前のバージョンのサイトと現在のバージョンのサイトを継続して実行する必要がある場合は、「混在環境に関する考慮事項」を参照してください。
  • 製品の選択: 以前のバージョンからアップグレードする場合、インストール時に設定された製品 (Citrix Virtual Apps または Citrix Virtual Apps and Desktops) を選択または指定することはありません。

混在環境に関する考慮事項

アップグレードする際は、エディションとバージョンに含まれるすべての新規機能および強化された機能にアクセスできるように、すべてのコンポーネントとVDAをアップグレードすることをお勧めします。
たとえば、以前のControllerバージョンを含む展開で現在のVDAを使用することはできますが、現在のリリースの一部の新機能は利用できない場合があります。また、最新ではないバージョンを使用している場合、VDA登録の問題が発生することもあります。
一部の環境では、すべてのVDAを最新バージョンにアップグレードできない場合があります。その場合、マシンカタログを作成する際に、マシンにインストールされているVDAバージョンを指定できます。(これは機能レベルと呼ばれます。) デフォルトでは、この設定は推奨される最小VDAバージョンを指定します。ほとんどの展開では、デフォルト値で十分です。カタログにデフォルトよりも古いVDAが含まれている場合にのみ、設定を以前のバージョンに変更することを検討してください。マシンカタログ内でVDAバージョンを混在させることは推奨されません。
カタログがデフォルトの最小VDAバージョン設定で作成され、1つ以上のマシンがデフォルトバージョンよりも古いVDAを持っている場合、それらのマシンはControllerに登録できず、機能しません。
詳細については、VDAバージョンと機能レベルを参照してください。

異なるバージョンを持つ複数のサイト

環境に異なる製品バージョン (たとえば、XenDesktop 7.18サイトとCitrix Virtual Apps and Desktops 1909サイト) のサイトが含まれている場合、CitrixではStoreFrontを使用して異なる製品バージョンのアプリケーションとデスクトップを集約することをお勧めします。詳細については、StoreFrontのドキュメントを参照してください。
混在環境では、各リリースに対応するStudioおよびDirectorのバージョンを引き続き使用しますが、異なるバージョンは別々のマシンにインストールされていることを確認してください。

以前のオペレーティングシステム

サポートされているオペレーティングシステム (OS) バージョンを実行しているマシンに、以前のバージョンのコンポーネントをインストールしたとします。現在、より新しいコンポーネントバージョンを使用したいと考えていますが、そのOSは現在のコンポーネントバージョンではサポートされていません。
たとえば、Windows Server 2016マシンにサーバーVDAをインストールしたとします。現在、そのVDAを現在のリリースにアップグレードしたいが、アップグレード先の現在のリリースではWindows Server 2016がサポートされていません。
許可されていないオペレーティングシステムにコンポーネントをインストールまたはアップグレードしようとすると、「このオペレーティングシステムにはインストールできません」などのエラーメッセージが表示されます。
これらの考慮事項は、Current ReleaseおよびLong Term Service Releaseバージョンのアップグレードに適用されます。(LTSRバージョンにCUを適用することには影響しません。)
サポートされているOSについては、以下のリンクを参照してください。

無効なオペレーティングシステム

次の表に、現在のリリースでコンポーネントのインストール/アップグレードに無効な以前のオペレーティングシステムを示します。各OSでサポートされている最新の有効なコンポーネントバージョンと、インストールおよびアップグレードが無効になったコンポーネントバージョンを示します。
表のオペレーティングシステムには、サービスパックと更新プログラムが含まれます。
オペレーティングシステム コンポーネント/機能 最新の有効なバージョン インストール/アップグレードが不可能になったバージョン
Windows 7およびWindows 8 VDA 7.15 LTSR 7.16
Windows 7 および Windows 8 その他のインストーラーコンポーネント 7.17 7.18
1607より前のWindows 10バージョン VDA 7.15 LTSR 7.16
Windows 10 x86バージョン VDA 1906.2.0 1909
ウィンドウズ サーバー 2008 R2 VDA 7.15 LTSR 7.16
ウィンドウズ サーバー 2008 R2 その他のインストーラーコンポーネント 7.17 7.18
ウィンドウズ サーバー 2012 VDA 7.15 LTSR 7.16
ウィンドウズ サーバー 2012 その他のインストーラーコンポーネント 7.17 7.18
ウィンドウズ サーバー 2012 R2 その他のインストーラーコンポーネント * 1912 LTSR 2003
ウィンドウズ サーバー 2012 R2 サーバーVDI 7.15 LTSR 7.16
Windows サーバー 2016 サーバーVDI 7.15 LTSR 7.16
Windows XPおよびWindows Vistaは、7.xのコンポーネントまたはテクノロジーでは無効です。
* Delivery Controller、Studio、Director、およびVDAに適用されます。

実行できること

選択肢があります。次のことができます。
  • 現在のOSを使い続ける(#continue-with-the-current-os)
  • マシンを再イメージ化またはアップグレードする(#reimage-or-upgrade-the-machine)
  • 新しいマシンを追加し、古いマシンを削除する(#add-new-machines-and-then-remove-old-machines)

現在のOSを使い続ける

これらの方法はVDAで実行可能です。以前のOSを搭載したマシンを使い続けたい場合は、次のいずれかを選択できます。
  • インストールされているコンポーネントバージョンを使い続ける。
  • 最新の有効なコンポーネントバージョンをダウンロードし、そのバージョンにコンポーネントをアップグレードする。（これは、最新の有効なコンポーネントバージョンがまだインストールされていないことを前提としています。）
たとえば、Windows 7 SP1マシンに7.14 VDAがインストールされているとします。Windows 7 OSマシンで有効な最新のVDAバージョンは、XenApp and XenDesktop 7.15 LTSRです。7.14を使い続けるか、7.15 LTSR VDAをダウンロードしてVDAをそのバージョンにアップグレードすることができます。これらの以前のVDAバージョンは、より新しいバージョンのDelivery Controllerを含む展開で動作します。たとえば、7.15 LTSR VDAはCitrix Virtual Apps and Desktops 7 1808 Controllerに接続できます。

マシンの再イメージ化またはアップグレード

これらの方法は、VDAや、コアコンポーネント（Delivery Controllerなど）がインストールされていない他のマシンで実行可能です。次のいずれかを選択してください。
  • マシンをサービスから外し（メンテナンスモードをオンにしてすべてのセッションを閉じさせてから）、サポートされているWindows OSバージョンに再イメージ化し、コンポーネントの最新バージョンをインストールできます。
  • 再イメージ化せずにVDAマシンでOSをアップグレードするには、まずアップグレード先のOSでサポートされているVDAバージョンをインストールするか、OSのアップグレード後にVDAをアップグレードする必要があります。そうしないと、Citrixソフトウェアはサポートされません。VDAをアンインストールせずにインプレースアップグレードを実行する場合、次の最小OSバージョンにアップグレードできます。
  • アップグレードを計画しているWindowsのバージョンが上記のガイドラインに合致しない場合は、OSをアップグレードする前にVDAをアンインストールし、OSのアップグレードが完了した後にサポートされているVDAバージョンをインストールする必要があります。

新しいマシンを追加し、古いマシンを削除する

この方法は、Delivery Controller™ またはその他のコアコンポーネントを含むマシンの OS をアップグレードする必要がある場合に実行可能です。
Citrixは、サイト内のすべてのControllerが同じOSを持つことを推奨します。以下のアップグレードシーケンスは、異なるControllerが異なるOSを持つ期間を最小限に抑えます。
  1. サイト内のすべての Delivery Controller のスナップショットを取得し、サイトデータベースをバックアップします。
  2. サポートされているオペレーティングシステムを搭載したクリーンなサーバーに新しいDelivery Controllerをインストールします。
  3. 新しいControllerをサイトに追加します。
  4. 現在のリリースで有効でないオペレーティングシステムで実行されているControllerを削除します。Delivery ControllersのController削除に関する推奨事項に従ってください。

準備

アップグレードを開始する前に、以下の情報を確認し、必要なタスクを完了してください。
注:
VDA のアップグレードは アップグレードシーケンス の後半で行われますが、アップグレードを開始する前にインストーラーを選択し、手順を確認して、何が予想されるかを知っておくことをお勧めします。

インストーラーとインターフェースを選択する

製品ISOからフルプロダクトインストーラーを使用してコンポーネントをアップグレードします。VDAは、フルプロダクトインストーラーまたはスタンドアロンVDAインストーラーのいずれかを使用してアップグレードできます。すべてのインストーラーは、グラフィカルインターフェースとコマンドラインインターフェースを提供します。
詳細については、インストーラー を参照してください。
「インストールの詳細: 準備作業を完了し、インストーラーを起動する準備が整ったら、インストールの記事には、表示される内容 (グラフィカルインターフェイスを使用している場合) または入力する内容 (コマンドラインインターフェイスを使用している場合) が示されます。」.
「シングルセッションVDAをVDAWorkstationCoreSetup.exeインストーラーで最初にインストールした場合、Citrixはそのインストーラーを使用してアップグレードすることを推奨します。フルプロダクトVDAインストーラーまたはVDAWorkstationSetup.exeインストーラーを使用してVDAをアップグレードすると、アップグレードから明示的に除外しない限り、元々除外されていたコンポーネントがインストールされる可能性があります。」.
「VDAを現在のリリースにアップグレードする際、アップグレードプロセス中にマシンの再起動が発生します。(この要件は7.17リリースから始まりました。) これは回避できません。再起動後、アップグレードは自動的に再開されます (コマンドラインで/noresumeを指定しない限り)。」.

「データベース操作」

「サイト、監視、および構成ログデータベースをバックアップします。CTX135207の指示に従ってください。アップグレード後に問題が発見された場合、バックアップを復元できます。」.
「サポートされなくなったSQL Serverバージョンのアップグレードについては、SQL Serverバージョンチェックを参照してください。(これは、サイト、モニター、および構成ログデータベースに使用されるSQL Serverを指します。)」
「Microsoft SQL Server Express LocalDBは、ローカルホストキャッシュで使用するために自動的にインストールされます。以前のバージョンを置き換える必要がある場合、新しいバージョンはSQL Server Express LocalDB 2019である必要があります。コンポーネントとサイトをアップグレードした後、SQL Server Express LocalDBを新しいバージョンに置き換える方法の詳細については、SQL Server Express LocalDBの置き換えを参照してください。」.

「Citrixライセンスが最新であることを確認する」

「Citrixライセンスの管理に関する包括的な情報については、Citrixライセンスのアクティブ化、アップグレード、および管理を参照してください。」.
「フルプロダクトインストーラーを使用してライセンスサーバーをアップグレードできます。または、ライセンスコンポーネントを個別にダウンロードしてアップグレードすることもできます。アップグレードを参照してください。」.
「アップグレードする前に、Customer Success Services / Software Maintenance / Subscription Advantageの日付が新しい製品バージョンに対して有効であることを確認してください。日付は2021.11.15以降である必要があります。」.

Citrix License Server の互換性を確認する

Citrix License Server が新しいバージョンと互換性があることを確認してください。これには2つの方法があります。
  • 他のCitrixコンポーネントをアップグレードする前に、Delivery Controller を含むマシンでISOレイアウトから XenDesktopServerSetup.exe インストーラーを実行します。互換性の問題がある場合、インストーラーは推奨される解決手順とともにそれを報告します。
  • インストールメディアの XenDesktop Setup ディレクトリから、コマンド .\LicServVerify.exe -h <license-server-fqdn> -p 27000 -v を実行します。表示により、License Server が互換性があるかどうかが示されます。License Server に互換性がない場合は、ライセンスサーバーをアップグレードしてください。

StoreFront の変更をバックアップする

アップグレードを開始する前に、C:\inetpub\wwwroot\Citrix\<StoreName>\App_Data 内のファイル（例: default.ica や usernamepassword.tfrm）を変更している場合は、各ストア用にそれらをバックアップしてください。アップグレード後に、変更を元に戻すためにそれらを復元できます。

アプリケーションとコンソールを閉じる

アップグレードを開始する前に、管理コンソールやPowerShellセッションなど、ファイルロックを引き起こす可能性のあるすべてのプログラムを閉じます。
マシンを再起動すると、ファイルロックがすべて解除され、保留中のWindowsアップデートがないことが保証されます。
アップグレードを開始する前に、サードパーティの監視エージェントサービスをすべて停止し、無効にします。

適切な権限があることを確認する

ドメインユーザーであることに加えて、製品コンポーネントをアップグレードするマシンではローカル管理者である必要があります。
サイトデータベースとサイトは、自動または手動でアップグレードできます。自動データベースアップグレードの場合、Studioユーザーの権限には、SQL Serverデータベーススキーマを更新する機能（たとえば、db_securityadmin または db_owner データベースロール）が含まれている必要があります。詳細については、データベース を参照してください。
Studioユーザーがこれらの権限を持っていない場合、手動データベースアップグレードを開始すると、スクリプトが生成されます。Studioユーザーは、Studioから一部のスクリプトを実行します。データベース管理者は、SQL Server Management Studioなどのツールを使用して、他のスクリプトを実行します。

その他の準備タスク

  • 必要に応じて、テンプレートをバックアップし、ハイパーバイザーをアップグレードします
  • 事業継続計画で定められているその他の準備タスクを完了します。

サイトの事前テスト

Delivery Controllerとサイトをアップグレードする際、実際のアップグレードが開始される前に事前サイトテストが実行されます。これらのテストでは、以下を確認します。
  • サイトデータベースにアクセスでき、バックアップされていること
  • 重要なCitrixサービスへの接続が正しく機能していること
  • Citrixライセンスサーバーのアドレスが利用可能であること
  • 構成ログデータベースに到達可能であること
  • パブリッククラウドホスト接続（例：AWS）を追加する場合は、Hybrid Rights Licenseがあることを確認してください。そうでない場合、事前サイトテストは一時停止または停止し、説明メッセージが表示されます。
テストの実行後、結果のレポートを表示できます。検出された問題を修正し、テストを再度実行できます。予備サイトテストを実行せず、問題を解決しないと、サイトの動作に影響を与える可能性があります。
テスト結果を含むレポートは、インストールログと同じディレクトリにあるHTMLファイル (PreliminarySiteTestResult.html) です。そのファイルが存在しない場合は作成されます。ファイルが存在する場合は、その内容が上書きされます。

テストの実行

  • インストーラーのグラフィカルインターフェイスを使用してアップグレードする場合、ウィザードにはテストを開始してレポートを表示できるページが含まれています。テストが実行され、レポートを確認し、見つかった問題を解決した後、テストを再実行できます。テストが正常に完了したら、「次へ」をクリックしてウィザードを続行します。
  • コマンドラインインターフェイスを使用してアップグレードする場合、テストは自動的に実行されます。デフォルトでは、テストが失敗した場合、アップグレードは実行されません。レポートを確認し、問題を解決した後、コマンドを再実行してください。
Citrixは、Controllerとサイトのアップグレードを続行する前に、常に事前サイトテストを実行し、問題を解決することを推奨します。テストを実行するわずかな時間で得られる潜在的なメリットは十分にあります。ただし、この推奨されるアクションを上書きすることもできます。
  • グラフィカルインターフェイスを使用してアップグレードする場合、テストをスキップしてアップグレードを続行することを選択できます。
  • コマンドラインからアップグレードする場合、テストをスキップすることはできません。デフォルトでは、サイトテストが失敗すると、アップグレードを実行せずにインストーラーが失敗します。通常、/ignore_site_test_failure オプションを含めると、テストの失敗は無視され、アップグレードが続行されます。（例外については、SQL Server のバージョンチェック を参照してください。）

複数のControllerをアップグレードする場合

あるControllerでアップグレードを開始し、その後、同じサイト内の別のControllerでアップグレードを開始した場合（最初のアップグレードが完了する前）：
  • 最初のControllerで予備サイトテストが完了している場合、他のControllerのウィザードには予備サイトテストページは表示されません。
  • 最初のControllerでのテストが進行中に他のControllerでアップグレードを開始した場合、他のControllerのウィザードにサイトテストページが表示されます。ただし、最初のControllerでのテストが完了すると、最初のControllerからのテスト結果のみが保持されます。

サイトの健全性に関連しないテストの失敗

  • 予備サイトテストがメモリ不足で失敗した場合は、より多くのメモリを確保してからテストを再実行してください。
  • アップグレードの権限はあるが、サイトテストを実行する権限がない場合、予備サイトテストは失敗します。これを解決するには、テストを実行する権限を持つユーザーアカウントでインストーラーを再実行してください。

SQL Serverバージョンの確認

Citrix Virtual Apps and Desktopsの展開を成功させるには、サイト、モニター、および構成ログデータベース用にサポートされているバージョンのMicrosoft SQL Serverが必要です。サポートされなくなったSQL ServerバージョンでCitrix展開をアップグレードすると、機能上の問題が発生する可能性があり、サイトはサポート対象外となります。
アップグレード先のCitrixリリースでサポートされているSQL Serverのバージョンについては、そのリリースのシステム要件 の記事を参照してください。
Controllerをアップグレードする際、Citrixインストーラーは、サイト、モニター、および構成ログデータベースに使用されている現在インストールされているSQL Serverのバージョンをチェックします。
  • チェックの結果、現在インストールされているSQL Serverのバージョンが、アップグレード先のCitrixリリースでサポートされているバージョンではないと判断された場合：
    • グラフィカルインターフェイス：アップグレードはメッセージとともに停止します。「了解」をクリックし、次に「キャンセル」をクリックしてCitrixインストーラーを閉じます。（アップグレードを続行することはできません。）
    • コマンドラインインターフェイス: コマンドは失敗します (コマンドに /ignore_db_check_failure オプションを含めた場合でも)。
    SQL Server のバージョンをアップグレードしてから、Citrix のアップグレードを再度開始します。
  • チェックで現在インストールされている SQL Server のバージョンを特定できない場合は、現在インストールされているバージョンがアップグレード先のバージョンでサポートされているかどうかを確認してください (システム要件)。
    • グラフィカルインターフェイス: アップグレードがメッセージとともに停止します。
      • 現在インストールされている SQL Server のバージョンがサポートされている場合は、 をクリックしてメッセージを閉じ、 をクリックして Citrix のアップグレードを続行します。
      • 現在インストールされている SQL Server のバージョンがサポートされていない場合は、 をクリックしてメッセージを閉じ、 をクリックして Citrix のアップグレードを終了します。SQL Server をサポートされているバージョンにアップグレードしてから、Citrix のアップグレードを再度開始します。
    • コマンドラインインターフェイス: コマンドがメッセージとともに失敗します。メッセージを閉じた後:
      • 現在インストールされている SQL Server のバージョンがサポートされている場合は、/ignore_db_check_failure オプションを指定してコマンドを再度実行します。
      • 現在インストールされている SQL Server のバージョンがサポートされていない場合は、SQL Server をサポートされているバージョンにアップグレードします。コマンドを再度実行して Citrix のアップグレードを開始します。

SQL Server のアップグレード

新しい SQL Server を起動してサイトデータベースを移行する場合は、接続文字列を更新する必要があります。
サイトが現在、サイトデータベースに SQL Server Express (Citrix がサイト作成時に自動的にインストールしたもの) を使用している場合:
  1. 最新の SQL Server Express バージョンをインストールします。
  2. データベースをデタッチします。
  3. データベースを新しい SQL Server Express にアタッチします。
  4. 接続文字列を移行します。
詳細については、「接続文字列の構成」およびMicrosoft SQL Serverの製品ドキュメントを参照してください。

SQL Server Express LocalDBを置き換える

Microsoft SQL Server Express LocalDBは、ローカルホストキャッシュがスタンドアロンで使用するSQL Server Expressの機能です。ローカルホストキャッシュは、SQL Server Express LocalDB以外のSQL Server Expressのコンポーネントを必要としません。
CitrixはSQL Server Express LocalDBを自動的に更新しません。SQL Server Express LocalDBのバージョンを更新するには、このセクションのガイダンスに従ってください。
  • Delivery ControllerをCitrix Virtual Apps and Desktopsバージョン2203 LTSR以降のバージョンにアップグレードする場合、サポートされるバージョンはSQL Server Express LocalDB 2019またはSQL Server Express LocalDB 2022です。
必要なもの:
  • Citrix Virtual Apps and Desktopsのインストールメディア。
  • Windows SysinternalsツールボックスのPsExecツール。
手順:
  1. Citrix Virtual Apps and Desktopsのコンポーネント、データベース、およびサイトのアップグレードを完了します。（これらのデータベースアップグレードは、サイト、監視、および構成ログデータベースに影響します。SQL Server Express LocalDBを使用するローカルホストキャッシュデータベースには影響しません。）
  2. SQL Server Express LocalDBを更新したいDelivery Controllerにログオンします。
  3. MicrosoftからPsExecをダウンロードし、そのDelivery Controller上のアクセスしやすい場所（例: C:\Temp）に配置します。
  4. Windowsシステムサービスから、Delivery Controller上のCitrix High Availability Serviceを停止します。
  5. Delivery Controllerでコマンドプロンプトを開き、PsExecがある場所（例: C:\Temp）に移動して、次のコマンドを実行し、Network Serviceアカウントでコマンドプロンプトを昇格させます。
    psexec -i -u "NT AUTHORITY\NETWORKSERVICE" cmd
  6. whoamiを実行して、コマンドプロンプトがNetwork Serviceアカウントとして実行されていることを確認します。次の出力が表示されるはずです: nt authority\networkservice。
  7. コマンドプロンプトを使用して、SQL LocalDBインスタンスに移動します:
    • SQL LocalDB 2014からアップグレードする場合:
      cd "C:\Program Files\Microsoft SQL Server\120\Tools\Binn"
    • SQL LocalDB 2017からアップグレードする場合:
      cd "C:\Program Files\Microsoft SQL Server\140\Tools\Binn"
    • SQL LocalDB 2019からアップグレードする場合:
      cd "C:\Program Files\Microsoft SQL Server\150\Tools\Binn"
  8. SQL LocalDBインスタンスを停止して削除します: CitrixHA。
    SqlLocalDB stop CitrixHA

    SqlLocalDB delete CitrixHA
  9. Delivery Controllerから以下のファイルを削除します:
    C:\Windows\ServiceProfiles\NetworkService\HADatabaseName.*
    C:\Windows\ServiceProfiles\NetworkService\HADatabaseName_log.*
    C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName.* (if exists)
    C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName_log.* (if exists)
  10. プログラムを削除するためのWindowsのネイティブ機能を使用して、既存のSQL LocalDB SQL Server ExpressをDelivery Controllerからアンインストールします。
  11. アンインストールが完了したら、Delivery Controllerを再起動します。
  12. Windowsシステムサービスから、Delivery Controller上のCitrix High Availability Serviceを停止します。
  13. Citrix Virtual Apps and DesktopsインストールメディアをDelivery Controllerにマウントします。
  14. Delivery ControllerにSQL Server Express LocalDB 2022を管理者としてインストールします。
    1. Citrix Virtual Apps and DesktopsインストールメディアのSupport > SQLLocalDBフォルダーにあるsqllocaldb.msiファイルを使用します。たとえば、インストールメディアがE driveドライブにマウントされている場合、ファイルはE:\Support\SQLLocalDB\sqllocaldb.msiにあります。インストールを完了するには再起動が必要です。
    2. 新しいSQL LocalDBはC:\Program Files\Microsoft SQL Server\160\Tools\Binnにある必要があります。
  15. Windowsシステムサービスから、Delivery Controller上のCitrix High Availability Serviceを開始します。
  16. Delivery Controller のコマンドプロンプトで、C:\Program Files\Microsoft SQL Server\160\Tools\Binn に移動し、SqlLocalDB i を実行して、CitrixHA インスタンスが作成されたことを確認します。返されたインスタンスのリストに CitrixHA が含まれている必要があります。
    注記：
    Citrix High Availability Service の開始後、CitrixHA データベースが作成されるまでに最大15分かかる場合があります。
  17. ローカルホストキャッシュデータベースファイルが作成されていることを確認し、必要に応じて高可用性サービス（セカンダリブローカー）が引き継ぐことができることを確認します。
    1. Delivery Controller で、C:\Windows\ServiceProfiles\NetworkService に移動します。
    2. HaDatabaseName.mdf と HaDatabaseName_log.ldf が作成されていることを確認します。
  18. 残りの Delivery Controller で手順を繰り返します。