展開のアップグレード

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

はじめに

新しいマシンやサイトを最初にセットアップすることなく、特定のデプロイメントを新しいバージョンにアップグレードできます。これはインプレースアップグレードと呼ばれます。アップグレードできる Citrix Virtual Apps and Desktops のバージョンについては、Citrix Upgrade Guide を参照してください。
Citrix Virtual Apps and Desktops のいずれかのリリースにアップグレードする前に、現在の Customer Success Services の日付が有効であり、期限切れになっていないことを確認してください。詳細については、Customer Success Services renewal licenses の記事を参照してください。
アップグレードを開始するには、新しいバージョンのインストーラーを実行して、以前にインストールされたコアコンポーネント、VDA、およびその他の特定のコンポーネントをアップグレードします。その後、データベースとサイトをアップグレードします。
より新しいバージョンが提供されている場合、フルプロダクトインストーラー(およびスタンドアロン VDA インストーラー)でインストールできる任意のコンポーネントをアップグレードできます。フルプロダクトインストーラーでインストールされないその他のコンポーネント(Citrix Provisioning™ や Profile Management など)については、そのコンポーネントのドキュメントを参照してください。ホストのアップグレードについては、適切なドキュメントを参照してください。
アップグレードを開始する前に、この記事のすべての情報を確認してください。

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

次の図は、アップグレードシーケンスのステップを示しています。Upgrade procedure には、図の各ステップの詳細が含まれています。
アップグレードシーケンスのフロー図
注:
障害を回避するため、新しいマシンカタログの作成、マシンカタログの削除、デリバリーグループ内のマシンの更新など、プロビジョニングおよびデリバリーグループ関連のタスクを実行する前に、すべての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属性を持つ)新しいハイブリッドライツライセンスファイルをダウンロードします。詳細については、「ライセンスのダウンロード」を参照してください。次の図は、インクリメントセクションにあるSaaS属性を持つハイブリッドライツライセンスファイルを示しています。
    ライセンスファイルのSaaS属性
  2. ライセンスサーバーにハイブリッド権限ライセンスファイルをインストールします。詳しくは、「ライセンスのインストール」を参照してください。
  3. ライセンスのエディションまたはモデルに変更がある場合は、ブローカーコマンドを実行してエディションとモデルを設定し、インプレースアップグレードを開始してください。ブローカーコマンドの詳細については、「Broker PowerShell SDK」セクションを参照してください。
Citrix Virtual Apps and Desktops Current ReleasesおよびLong Term Service Releasesでのパブリッククラウドサポートの詳細については、CTX270373を参照してください。

アップグレード手順

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

ステップ1:準備

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

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

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

インストールメディアに新しいバージョンのStoreFrontソフトウェアが含まれている場合、StoreFrontサーバーがインストールされているマシンでインストーラーを実行します。
  • グラフィカルインターフェイスで、「展開の拡張」セクションから「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 サーバーに移動し、インターネットインフォメーションサービス (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 を選択します。
注:
残りの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:マシンカタログとデリバリーグループを更新する

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

展開内の他のコンポーネントをアップグレードします。ガイダンスについては、以下の製品ドキュメントを参照してください。
Microsoft SQL Server Express LocalDBソフトウェアを新しいバージョンに置き換える必要がある場合は、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は追加コンポーネントページでオプションとして提供されていました。7.15 LTSRおよびそれ以前の7.xリリースでは、このオプションがデフォルトで有効になっていました。したがって、デフォルトを受け入れた場合(または、いずれかのリリースでこのオプションを明示的に有効にした場合)、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は、January 2016に発表された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累積更新プログラム(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展開では、以下のテクノロジーとホストタイプはサポートされていません。
  • カタログ内のユーザーのVMの隣にデータを保存するためのPersonal vDisks (PvD)。ユーザーパーソナライゼーションレイヤー機能がユーザーの永続性を処理するようになりました。
  • デリバリーグループで使用されるアプリケーションを管理するためのAppDisks。
  • ホストタイプ: Azure Classic、CloudPlatform(元のCitrix製品)。
    • このリリースでサポートされているホストの種類については、システム要件を参照してください。
    • ARMおよびAWSを引き続き使用できる代替方法については、CTX270373を参照してください。
現在の展開でPvDまたはAppDiskを使用している場合、あるいはサポートされていないホストタイプ(Microsoft Azure Classicなど)への接続がある場合、それらのテクノロジーを使用する項目を削除した後にのみ、バージョン2006(またはそれ以降のサポートされているバージョン)にアップグレードできます。現在の展開でパブリッククラウドホスト接続(AWSなど)を使用している場合は、アップグレードする前にHybrid Rights Licenseがあることを確認してください。インストーラーがサポートされていないテクノロジーまたはHybrid Rights Licenseのないホスト接続を1つ以上検出すると、アップグレードは一時停止または停止し、説明メッセージが表示されます。インストーラーログには詳細が含まれています。
アップグレードを確実に成功させるために、サポートされていない項目を削除するための該当するガイダンスを確認し、それに従ってください。
展開でPvDまたはAppDiskを使用していなかったとしても、関連するMSIが以前のVDAインストールまたはアップグレードに含まれていた可能性があります。VDAをバージョン2006(またはそれ以降のサポートされているバージョン)にアップグレードする前に、たとえ一度も使用していなくても、そのソフトウェアを削除する必要があります。グラフィカルインターフェイスを使用する場合、その削除は自動的に行われるか、CLIを使用する際に削除オプションを含めることができます。詳細については、PvDまたはAppDiskコンポーネントを持つVDAのアップグレードを参照してください。

PvDを削除する

PvDを使用するように構成されているすべてのマシンを削除するまで、展開のアップグレードは成功しません。これはカタログとデリバリーグループに影響します。
グループとカタログからPvDを削除するには:
  1. Studioから、デリバリーグループにPvDを使用するカタログのマシンが含まれている場合、それらのマシンをグループから削除します。
  2. Studioから、PvDを使用するマシンを含むすべてのカタログを削除します。
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. グループを選択し、アクションペインで をクリックします。
  3. グループから AppDisk を削除するアクションをクリックします。
  4. AppDisk を使用している各デリバリーグループに対して、手順 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 から:
  • サポートされていないホストへのすべての接続を削除します。
  • デリバリーグループに、サポートされていないホストのマスターイメージで作成されたカタログのマシンが含まれている場合は、それらのマシンをグループから削除します。
  • サポートされていないホストのマスターイメージを使用して作成されたすべてのカタログを削除(/ja-jp/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-manage.html#delete-a-catalog)。

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をアップグレードする必要はありませんが、利用可能なすべての機能を使用できるように、すべての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を使用することをお勧めします。詳細については、(/ja-jp/storefront.html)のドキュメントを参照してください。
混在環境では、各リリースに対応するStudioおよびDirectorのバージョンを引き続き使用しますが、異なるバージョンは別々のマシンにインストールされていることを確認してください。

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

サポートされているオペレーティングシステム(OS)バージョンを実行しているマシンに、コンポーネントの以前のバージョンをインストールしたとします。現在、より新しいコンポーネントバージョンを使用したいと考えていますが、そのOSは現在のコンポーネントバージョンではサポートされていません。
例えば、Windows Server 2008 R2マシンにサーバーVDAをインストールしたとします。現在、そのVDAを現在のリリースにアップグレードしたいと考えていますが、アップグレード先の現在のリリースではWindows Server 2008 R2はサポートされていません。
サポートされなくなったオペレーティングシステムにコンポーネントをインストールまたはアップグレードしようとすると、「このオペレーティングシステムにはインストールできません」などのエラーメッセージが表示されます。
これらの考慮事項は、Current ReleaseおよびLong Term Service Releaseバージョンのアップグレードに適用されます。(LTSRバージョンにCUを適用することには影響しません。)
サポートされているOSについては、以下のリンクを参照してください。
  • Citrix Virtual Apps and Desktops (現在のリリース):
  • LTSRについては、お使いのLTSRバージョンとCUのコンポーネントリストを参照してください。(メインの(/ja-jp/citrix-virtual-apps-desktops.html)製品ドキュメントページからLTSRバージョンを選択してください。)

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

次の表に、現在のリリースでコンポーネントのインストール/アップグレードに無効な以前のオペレーティングシステムを示します。各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
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 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ソフトウェアはサポートされていない状態になります。

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

この方法は、Delivery Controller™ またはその他のコアコンポーネントを含むマシンでOSをアップグレードする必要がある場合に実行可能です。
Citrix は、サイト内のすべてのコントローラーが同じ OS を持つことを推奨しています。以下のアップグレードシーケンスは、異なるコントローラーが異なる OS を持つ期間を最小限に抑えます。
  1. サイト内のすべてのDelivery Controllerのスナップショットを取得し、サイトデータベースをバックアップします。
  2. サポートされているオペレーティングシステムを搭載したクリーンなサーバーに新しいDelivery Controllerをインストールします。たとえば、2台のWindows Server 2016マシンにControllerをインストールします。
  3. 新しいControllerをサイトに追加します。
  4. 現在のリリースで有効でないオペレーティングシステムで実行されているControllerを削除します。たとえば、2台のWindows Server 2008 R2マシン上の2つの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ライセンスサーバーが互換性があることを確認してください

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

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をアップグレードする場合

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を使用するLocal Host Cacheデータベースには影響しません。)
  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のネイティブ機能を使用して、Delivery Controllerから既存のSQL LocalDB SQL Server Expressをアンインストールします。
  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 2019をインストールします。
    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で手順を繰り返します。