展開のアップグレード

最終公開日 : Nov 13, 2026
注:
この記事では、Web Studio を含む展開のアップグレードについて説明します。Citrix Studio を含むアップグレードについては、Citrix Virtual Apps and Desktops™ 7 2212 以前の同等の記事を参照してください。

はじめに

新しいマシンやサイトを最初にセットアップすることなく、特定の展開を新しいバージョンにアップグレードできます。これはインプレースアップグレードと呼ばれます。
アップグレードできる Citrix Virtual Apps and Desktops のバージョンについては、「アップグレードできるバージョン」を参照してください。
Citrix Virtual Apps and Desktops のリリースにアップグレードする前に、現在の Customer Success Services の日付が有効であり、期限切れになっていないことを確認してください。詳しくは、「Customer Success Services の更新ライセンス」の記事を参照してください。
アップグレードを開始するには、新しいバージョンのインストーラーを実行して、以前にインストールされたコアコンポーネント、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などのパブリッククラウドでのワークロードのプロビジョニングとホスティングが含まれます。新しいライセンスファイルを展開する前に、ライセンスサーバーを最新バージョンに更新してください。
SaaS属性のないハイブリッド権限ライセンスにアクセスできる場合は、以下の手順に従ってSaaS属性を持つ新しいハイブリッド権限ライセンスにアクセスしてください。
注:
  • 新しいライセンスコードが記載されたメールが届きます。詳しくは、「ライセンスアクセスコードの使用」を参照してください。
  • 既存のライセンスは取り消されます。取り消されたライセンスはライセンスサーバーから削除し、その後新しいライセンスをインストールする必要があります。詳しくは、「ライセンスファイルの削除」を参照してください。
  1. citrix.comのライセンス管理ポータルにアクセスし、クラウドプロビジョニング権限が有効になっている(SaaS属性を持つ)新しいハイブリッド権限ライセンスファイルをダウンロードします。詳しくは、「ライセンスのダウンロード」を参照してください。次の画像は、IncrementsセクションにSaaS属性を持つハイブリッド権限ライセンスファイルを示しています。
    ライセンスファイルのSaaS属性
  2. ライセンスサーバーにハイブリッド権限ライセンスファイルをインストールします。詳しくは、「ライセンスのインストール」を参照してください。
  3. ライセンスのエディションまたはモデルに変更がある場合は、brokerコマンドを実行してエディションとモデルを設定してから、インプレースアップグレードを開始してください。Brokerコマンドの詳細については、「Broker PowerShell SDK」セクションを参照してください。
Citrix Virtual Apps and DesktopsのCurrent ReleasesおよびLong Term Service Releasesでのパブリッククラウドサポートの詳細については、CTX270373を参照してください。

アップグレード手順

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

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

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

ステップ3:StoreFront™のアップグレード

インストールメディアに新しいバージョンのStoreFrontソフトウェアが含まれている場合は、StoreFrontサーバーを含むマシンでインストーラーを実行します。
  • グラフィカルインターフェイスで、Extend deploymentセクションからCitrix 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を使用して、データベーススキーマを更新する他のスクリプトを実行します。データベースとサイトを手動でアップグレードするに進んでください。
  • マルチゾーン展開でデータベースとサイトを自動的にアップグレードする場合、Citrixは、dbschemaのアップグレードを、サイトのSQL Serverデータベースをホストするのと同じゾーンで実行することを推奨します。そうしないと、データベースとサイトの自動アップグレードが失敗する可能性があります。
Citrixは、アップグレード前にデータベースをバックアップすることを強く推奨します。CTX135207を参照してください。データベースのアップグレード中は、製品サービスが無効になります。その間、Controllerはサイトの新しい接続を仲介できないため、慎重に計画してください。

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

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

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

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

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

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

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

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

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

  • VDAがアップグレードされたマシンを使用するカタログをアップグレードする(/ja-jp/citrix-virtual-apps-desktops/2503/install-configure/machine-catalogs-manage.html#upgrade-a-catalog-or-revert-an-upgrade)。
  • VDAがアップグレードされたマシンを使用するデリバリーグループをアップグレードする(/ja-jp/citrix-virtual-apps-desktops/2503/install-configure/delivery-groups-manage.html#upgrade-a-delivery-group-or-revert-an-upgrade)。

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

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

データベーススキーマのアップグレード

展開環境を更新すると、複数のデータベーススキーマをアップグレードできます。次の表に、そのプロセスでアップグレードされるデータベーススキーマを示します。
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およびXenDesktop 7.15 LTSRで、Windows 7デスクトップとPersonal vDiskを使用できますか?
Citrixは、2016年1月に発表されたXenAppおよびXenDesktop 7.6 LTSRからPersonal vDisk (PvD) を除外しました。さらに、CitrixはPvDテクノロジーの非推奨を発表し、今後Citrix App Layeringの使用を開始することを顧客に推奨しています。Citrix App Layering (バージョン4.4以降) は、XenAppおよびXenDesktop 7.15 LTSRの互換性のあるコンポーネントです。ただし、Windows 7で既存のPvD展開を使用している顧客がCitrix App Layeringテクノロジーに移行するのを支援するため、Citrixは、XenAppおよびXenDesktop 7.15 LTSR Cumulative Updates (CUs) を通じて、Windows 7デスクトップ向けPvD展開の期間限定サポートをJan 14, 2020まで提供することを決定しました。PvDコンポーネントは、LTSR CUsから削除され、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の展開ではサポートされていません。
  • カタログ内のユーザーのVMの隣にデータを保存するためのPersonal vDisks (PvD)。ユーザーパーソナライゼーションレイヤー機能がユーザーの永続性を処理するようになりました。
  • デリバリーグループで使用されるアプリケーションを管理するためのAppDisks。
  • ホストタイプ: Azure Classic、CloudPlatform (元のCitrix製品)。
    • このリリースでサポートされているホストタイプについては、システム要件を参照してください。
    • ARMおよびAWSを継続して使用できる代替方法については、CTX270373を参照してください。
現在の展開でPvDまたはAppDiskを使用している場合、あるいはサポートされていないホストの種類(Microsoft Azure Classicなど)への接続がある場合は、それらのテクノロジを使用する項目を削除した後にのみ、バージョン2006(またはそれ以降のサポートされているバージョン)にアップグレードできます。現在の展開でパブリッククラウドホスト接続(AWSなど)を使用している場合は、アップグレードする前にハイブリッド権限ライセンスがあることを確認してください。インストーラーがサポートされていないテクノロジまたはハイブリッド権限ライセンスのないホスト接続を1つ以上検出すると、アップグレードは一時停止または停止し、説明メッセージが表示されます。インストーラーログには詳細が含まれています。
アップグレードを確実に成功させるには、サポートされていない項目を削除するための該当するガイダンスを確認し、それに従ってください。
展開でPvDまたはAppDiskを使用していなかった場合でも、関連するMSIが以前のVDAインストールまたはアップグレードに含まれていた可能性があります。VDAをバージョン2006(またはそれ以降のサポートされているバージョン)にアップグレードする前に、たとえ一度も使用していなくても、そのソフトウェアを削除する必要があります。グラフィカルインターフェイスを使用する場合、その削除は自動的に行われるか、CLIを使用する際に削除オプションを含めることができます。詳細については、PvDまたはAppDiskコンポーネントを持つVDAのアップグレードを参照してください。

PvDの削除

PvDを使用するように構成されているすべてのマシンを削除するまで、展開のアップグレードは成功しません。これはカタログとデリバリーグループに影響します。
グループとカタログからPvDを削除するには:
  1. Studioで、デリバリーグループにPvDを使用するカタログのマシンが含まれている場合、「それらのマシンをグループから削除」(/ja-jp/citrix-virtual-apps-desktops/2503/install-configure/delivery-groups-manage.html#remove-a-machine-from-a-delivery-group)します。
  2. Studioで、PvDを使用するマシンを含む「すべてのカタログを削除」(/ja-jp/citrix-virtual-apps-desktops/2503/install-configure/machine-catalogs-manage.html#delete-a-catalog)します。
VDAのアップグレード: 展開のアップグレードでは、VDAにAppDiskまたはPvDコンポーネントがインストールされているかどうかは検出されません。ただし、VDAインストーラーは検出します。詳細については、「PvDまたはAppDiskコンポーネントを持つVDA」(#vdas-that-have-pvd-or-appdisks-components)を参照してください。
PvDの代わりにApp Layeringを使用する予定がある場合は、データの移行に関する情報についてPvDからApp Layeringへの移行を参照してください。

AppDiskを削除する

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

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

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

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

PvDおよびAppDisksテクノロジを有効にするコンポーネントがVDAにインストールされている場合、それらのコンポーネントが削除されるまで、そのVDAをアップグレードすることはできません。
注:
バージョン1912にアップグレードする場合、現在のVDAをアンインストールしてから新しいVDAをインストールする必要がありました。このバージョンでは、Citrixがコンポーネントを削除してアップグレードを続行するかどうかを尋ねられます。
AppDiskおよびPvDコンポーネントは、それらのテクノロジを一度も使用したことがない場合でも、以前のVDAバージョンでインストールされていた可能性があります。
  • グラフィカルインターフェイス:VDAインストーラーの追加コンポーネントページには、Citrix AppDisk / Personal vDiskオプションが含まれていました。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をアップグレードする必要はありませんが、Citrixでは、利用可能なすべての機能を使用できるように、すべてのVDAをアップグレードすることをお勧めします。
  • 早期リリースまたはテクノロジープレビューバージョン: 早期リリース、テクノロジープレビュー、またはプレビューバージョンからアップグレードすることはできません。
  • 以前のオペレーティングシステム上のコンポーネント: 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
Windows 10 バージョン 1607 より前のもの VDA 7.15 LTSR 7.16
Windows 10 x86 バージョン VDA 1906.2.0 1909
Windows サーバー 2008 R2 VDA 7.15 LTSR 7.16
Windows サーバー 2008 R2 その他のインストーラーコンポーネント 7.17 7.18
Windows サーバー 2012 VDA 7.15 LTSR 7.16
Windows サーバー 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を削除します。Controllerの削除に関する推奨事項については、「Delivery Controllers」を参照してください。

準備

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

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

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

データベース操作

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

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

Citrixライセンスの管理に関する包括的な情報については、Activate, upgrade, and manage Citrix licensesを参照してください。
フル製品インストーラーを使用してライセンスサーバーをアップグレードできます。または、ライセンスコンポーネントを個別にダウンロードしてアップグレードすることもできます。Upgradeを参照してください。
アップグレードする前に、Customer Success Services / Software Maintenance / Subscription Advantageの有効期限が新しい製品バージョンに対応していることを確認してください。日付は2021年11月15日以降である必要があります。

Citrixライセンスサーバーの互換性を確認する

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

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

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

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

アップグレードを開始する前に、管理コンソールや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をアップグレードする場合

1つの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リリースでサポートされているバージョンではないと判断された場合:
    • グラフィカルインターフェイス:アップグレードはメッセージとともに停止します。「I understand」をクリックし、次に「Cancel」をクリックしてCitrixインストーラーを閉じます。(アップグレードを続行することはできません。)
    • コマンドラインインターフェイス:コマンドは失敗します(コマンドに/ignore_db_check_failureオプションを含めた場合でも)。
    SQL Serverのバージョンをアップグレードしてから、Citrixのアップグレードを再度開始してください。
  • チェックで現在インストールされているSQL Serverのバージョンを特定できない場合は、現在インストールされているバージョンがアップグレード先のバージョンでサポートされているか(システム要件)を確認してください。
    • グラフィカルインターフェイス: アップグレードがメッセージとともに停止します。
      • 現在インストールされているSQL Serverのバージョンがサポートされている場合は、「I understand」をクリックしてメッセージを閉じ、次に「Next」をクリックしてCitrixのアップグレードを続行します。
      • 現在インストールされているSQL Serverのバージョンがサポートされていない場合は、「I understand」をクリックしてメッセージを閉じ、次に「Cancel」をクリックして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 は、Local Host Cache がスタンドアロンで使用する SQL Server Express の機能です。Local Host Cache は、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. 既存のSQL LocalDB SQL Server Expressを、プログラムを削除するためのWindowsネイティブ機能を使用して、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. 必要に応じてHigh Availability Service(セカンダリブローカー)が引き継ぐことができることを確認するために、ローカルホストキャッシュデータベースファイルが作成されていることを確認します。
    1. Delivery Controllerで、C:\Windows\ServiceProfiles\NetworkServiceを参照します。
    2. HaDatabaseName.mdfとHaDatabaseName_log.ldfが作成されていることを確認します。
  18. 残りのDelivery Controllerで手順を繰り返します。