準備

最終公開日 : Nov 13, 2026
アップグレードを開始する前に、以下の情報を確認し、必要なタスクを完了してください。
注：
VDAのアップグレードはアップグレード手順の後半で行われますが、アップグレードを開始する前にインストーラーを選択し、手順を確認して、何が予想されるかを把握しておくことをお勧めします。
Related information
展開をアップグレードする

アップグレード前のチェックリスト

アップグレードを開始する前に、以下のタスクを完了してください。各項目は詳細にリンクしています。

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

製品ISOのフルプロダクトインストーラーを使用してコンポーネントをアップグレードします。VDAは、フルプロダクトインストーラーまたはスタンドアロンVDAインストーラーのいずれかを使用してアップグレードできます。すべてのインストーラーは、グラフィカルインターフェイスとコマンドラインインターフェイスを提供します。
詳しくは、「インストーラー」を参照してください。
インストールの詳細: 準備作業を完了し、インストーラーを起動する準備ができたら、インストール記事に表示される内容（グラフィカルインターフェイスを使用している場合）または入力する内容（コマンドラインインターフェイスを使用している場合）が示されます。
  • グラフィカルインターフェイスを使用したコアコンポーネントのインストール/アップグレード
  • コマンドラインを使用したコアコンポーネントのインストール/アップグレード
  • グラフィカルインターフェイスを使用したVDAのインストール/アップグレード
  • コマンドラインを使用したVDAのインストール/アップグレード
シングルセッションオペレーティングシステムには、4種類のインストーラーが用意されています。Citrixでは、Citrix VDAのインストール、アップグレード、アンインストールを含むライフサイクル全体で、一貫したインストーラータイプを使用することをお勧めします。詳しくは、「シングルセッションVDAインストーラーを使用するためのベストプラクティス」を参照してください。
VDAを現在のリリースにアップグレードすると、アップグレードプロセス中にマシンの再起動が発生します。（この要件は7.17リリースから始まりました。）再起動は回避できません。再起動後、アップグレードは自動的に再開されます（コマンドラインで/noresumeを指定しない限り）。

Citrixライセンスを確認する

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

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

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

ハイブリッド権限ライセンスを更新する

ハイブリッド権限ライセンスは、お客様が永続ライセンスからクラウドサービスサブスクリプションに移行またはアップグレードする際に、クラウドサービスサブスクリプションに加えて提供される期間ベースのサブスクリプションライセンスです。DaaSサブスクリプションと合わせてハイブリッド権限アドオンを購入することもできます。

SaaS属性を持つハイブリッド権限ライセンス

Citrix Virtual Apps and Desktops™ LTSR 2203以降にアップグレードすると、LTSR 1912では利用できなかった機能が利用できるようになります。これらの機能には、Microsoft Azure、AWS EC2、Google Cloudなどのパブリッククラウドでのワークロードのプロビジョニングとホスティングが含まれます。新しいライセンスファイルを展開する前に、ライセンスサーバーを最新バージョンに更新してください。この前提条件をスキップすると、Citrix Virtual Apps and Desktopsサイトのアップグレードとサイト作成がブロックされます。

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を参照してください。

データベースをバックアップする

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

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のバージョンがサポートされていない場合は、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の製品ドキュメントを参照してください。

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

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

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

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

PvDの削除

PvDを使用するように構成されているすべてのマシンを削除するまで、展開のアップグレードは成功しません。この削除は、カタログとデリバリーグループに影響します。
グループとカタログからPvDを削除するには：
  1. Studioから、デリバリーグループにPvDを使用するカタログのマシンが含まれている場合、そのマシンをグループから削除します。
  2. Studioから、PvDを使用するマシンを含むすべてのカタログを削除します。
VDAのアップグレード: 展開のアップグレードでは、VDAにAppDiskまたはPvDコンポーネントがインストールされているかどうかは検出されません。ただし、VDAインストーラーは検出します。詳細については、「VDAからPvDまたはAppDisksコンポーネントを削除する」を参照してください。
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インストーラーは検出します。詳細については、「VDAからPvDまたはAppDisksコンポーネントを削除する」を参照してください。

サポートされていないホスト項目を削除する

バージョン2006（またはそれ以降のサポートされているバージョン）への展開アップグレードは、サイトがCitrix CloudPlatformやMicrosoft Azure Classicなどのサポートされていないホストタイプへの接続を持っている場合、続行できません。アップグレードを試みる前に、以下のタスクを完了してください。
Studioから：
  • サポートされていないホストへの(/ja-jp/citrix-virtual-apps-desktops/2607-ltsr/install-configure/connections.html#delete-a-connection)をすべて削除します。
  • デリバリーグループに、サポートされていないホストのマスターイメージで作成されたカタログのマシンが含まれている場合は、(/ja-jp/citrix-virtual-apps-desktops/2607-ltsr/install-configure/delivery-groups-manage.html#remove-a-machine-from-a-delivery-group)。
  • サポートされていないホストのマスターイメージを使用して作成された(/ja-jp/citrix-virtual-apps-desktops/2607-ltsr/install-configure/machine-catalogs-manage.html#delete-a-catalog)をすべて削除します。

VDAからPvDまたはAppDisksコンポーネントを削除する

PvDおよびAppDisksテクノロジを有効にするコンポーネントがVDAにインストールされている場合、それらのコンポーネントが削除されるまで、そのVDAはアップグレードできません。この制限は、PvDまたはAppDisksを一度も使用したことがない場合でも適用されます。
注：
バージョン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

以前のWindowsバージョンでPvDの使用を継続する

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累積更新プログラム (CU) を通じて、Windows 7デスクトップ向けのPvD展開に対する期間限定のサポートをJan 14, 2020まで提供することを決定しました。PvDコンポーネントは、Jan 14, 2020以降、LTSR CUから削除され、サポートされなくなります。また、Jan 14, 2020以降にWindows 7でPvDを使用すると、LTSRサイトは非準拠となります。さらに、Windows 10向けのPvDは7.15 LTSRから引き続き除外されます。したがって、お客様は7.15 LTSRサイトでこれを使用しないでください。

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

アップグレードを開始する前に、管理コンソールや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からのテスト結果のみが保持されます。

サイトの健全性とは無関係なテストの失敗を解決する

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

その他の準備タスクを完了する

  • 必要に応じて、テンプレートをバックアップし、ハイパーバイザーをアップグレードします
  • ビジネス継続性計画によって指示されたその他の準備タスクを完了します。