製品ドキュメント
アプリケーションレイヤリング
PDFを表示

既知の問題

January 9, 2026
寄稿者: 
C C

App Layering のアップグレード

App Layering 2511

  • Google Cloud Platform コネクタでは、現在、レイヤーのパッケージ化とレイヤー化されたイメージの公開に関する問題が発生しています。タスクは、Compositing Engine の起動を待機した後に失敗し、「The resource ‘citrix-ce/’ of type ‘Guest Attribute’ was not found. [404]」というエラーメッセージが表示されます。この問題は、今後のアップデートまたはリリースで解決される予定です。 [UNI-92996]

  • Image Portability Service 機能は現在、NVMe ディスクコントローラで構成された Azure イメージをサポートしていません。今後のリリースでサポートが予定されています。

App Layering 2409

  • Citrix App Layering でエージェントの移行が失敗した後に、誤ったメッセージが表示されることがあります。メッセージには、「移行は正常に完了しましたが、次の App Layering エージェントをターゲットアプライアンスに登録できませんでした: System.Collections.Generic.List`1[System.String]。」と表示されます。 [UNI-91339]

  • ターゲットの Elastic Layer Manager (ELM) への移行後、root およびコンソール管理者パスワードの設定を求められることはありません。これらのパスワードが移行前に設定されていなかった場合、工場出荷時の設定がデフォルトになります。

    回避策:

    パスワードが移行前に設定されていなかった場合は、root としてターゲット ELM コンソールにログインし、次のコマンドを使用して手動でパスワードを変更します。

    • root パスワードの変更:

      passwd

      root のパスワードを設定するよう求められます。

    • 管理者パスワードの変更:

      passwd administrator

      管理者のパスワードを設定するよう求められます。小文字の「a」を使用してください。[UNI-91472]

  • 非 root ユーザーを使用して新しい ELM に接続すると、「Cannot convert undefined or null to object」という不明瞭なエラーメッセージが表示されることがあります。ユーザーが正しくないことを示す特定のメッセージが表示されるはずです。 [UNI-91330]

  • ELM のデフォルトの管理者パスワードに &、<、> などの特殊文字を使用することは避けてください。これにより、インポートスクリプトを介した OS レイヤーの作成が失敗する可能性があります。 [UNI-87311]

  • 移行後、ターゲットの Elastic Layer Manager (ELM) の管理コンソール管理者パスワードは、ソース ELM のパスワードで上書きされます。回避策として、管理者権限を持つユーザーとしてターゲット ELM にログインし、デフォルトの管理者パスワードを変更できます。 [UNI-91451]

  • 移行後、ターゲット ELM の Images、Connectors、Directory Services、および User Layer Storage ブレードは自動的に更新されません。Layers ブレードにデータが表示されていても、これらのブレードが空に見えることがあります。正しい情報を表示するには、ブラウザまたはタブを手動で更新してください。[UNI-91374]

  • コピー移行を実行した後、新しいネットワーク共有が作成されると、ターゲットの Elastic Layer Manager (ELM) によって公開されたイメージ上で、弾力的に割り当てられたアプリレイヤーを起動できません。

    原因

    新しいネットワーク共有には、以前にソース ELM の元のネットワーク共有に割り当てられ、同期されたアプリレイヤーが含まれていません。

    回避策

    回避策 1: 次のコマンドを実行します。 mono /usr/local/unitools/MAService.exe -fire SyncRevisionsToShareEvent

    回避策 2: ソース ELM のネットワーク共有からすべてのアプリレイヤーを、ターゲット ELM に関連付けられた新しいネットワーク共有に手動でコピーします。

    回避策 3: アプリレイヤーの割り当てを解除し、再度割り当てます。この操作により、レイヤーが新しいネットワーク共有に同期されます。[UNI-91377]

App Layering 2312

App Layering 2312 へのアップグレードが失敗し、「アプライアンスのアップグレード中にエラーが発生しました。クリーンなスナップショットから復元した後、再度アップグレードを試してください。」というエラーが返されることがあります。以前のバージョンからアップグレードされた一部のアプライアンスで問題が発生していることを認識しています。このシナリオでは、レガシーアップグレーダーコンポーネントの存在により、アップグレードが失敗する可能性があります。この問題に対する永続的な修正を含む App Layering 2306 のパッチビルドに取り組んでいます。

この問題を回避するには、Layering アプライアンスで次の変更を行い、レガシーモジュールを削除する必要があります。

  1. root ログインとパスワードを使用してアプライアンスコンソールにログインします。
  2. 「yum remove mod_http2」コマンドを実行します。コマンドの実行には数分かかる場合があります。
  3. コマンドが完了したら、Web ブラウザを使用してアプライアンスに再度ログインし、アップグレードを再実行します。
  4. アップグレードの完了には 30 分以上かかる場合がありますが、今度は成功するはずです。

App Layering 2005

  • App Layering 2005 アップグレードパッケージはサイズが大きいため、古いアプライアンスでは自動的にダウンロードできません。バージョン 2001 以前を実行している場合は、ダウンロードサイトからパッケージを手動でダウンロードしてください。

  • セキュア HTTP (HTTPS) の管理コンソールからアップグレードを実行することをお勧めします。HTTP でアップグレード中に、メッセージがブラウザに表示されない場合があります。その場合は、20 分後にブラウザを更新してください。(更新しないようにというメッセージが表示されても、更新しても問題は発生しません。) アップグレードがまだ実行中の場合、「サービス利用不可エラー」が表示されます。このメッセージは無視して、ログインページが表示されるまで数分ごとにブラウザを更新し続けても安全です。

  • ネットワークファイル共有の異なるフォルダに同じ名前のアップグレードパッケージが 2 つある場合、いずれかのパッケージを選択すると、両方のパッケージが選択されます。両方のパッケージが同じバージョンである場合、アップグレードは成功します。バージョンが異なる場合、システムはより低いバージョン番号を選択します。これは Enterprise Layer Manager (ELM) バージョン 22.2 で発生します。

App Layering アプライアンスと管理コンソール

  • 新しい UI では、プラットフォームタイプを編集できません。プラットフォームタイプの編集は、古い UI では引き続き正しく機能します。(UNI-86856)
  • App Layering アプライアンスをインストールする際は、デフォルトの CPU 設定である 4 CPU を使用する_必要があります_。
  • 複雑な Active Directory 環境でロールを使用しており、ログインが遅い場合は、すべてのロールをグループではなく明示的なユーザーに割り当ててください。

App Layering ドキュメントリンク

管理コンソールのドキュメントリンクは、Internet Explorer 11 で空白のページとして開きます。この問題を回避するには、リンクを別のブラウザに貼り付けてください。ドキュメントは正しく表示されます。

App Layering エージェント

デフォルトでは、Citrix App Layering™ エージェントは Hyper-V サーバー上の Local System アカウントで実行されます。アカウントを Local System 以外に変更すると、エージェントはアプライアンスとの間でディスクを転送できません。

App Layering OS マシンツール

  • (リリース 19.5 のみ) 19.3 (またはそれ以前) からリリース 19.5 (またはそれ以降) にアップグレードした後、KMS Office Activation を更新して Office 2019 を使用するようにしてください。レイヤー化のために OS イメージを準備する際は、新しい App Layering OS マシンツールをダウンロードして実行します。

  • (リリース 19.1 のみ) レイヤー化のために OS イメージを準備する際は、KMS Office Activation がデスクトップ起動時にトリガーされるようにしてください。このリリースのみ、リリース 18.12 から App Layering OS マシンツールをダウンロードして実行します。

Microsoft Teams 2.x

Elastic Layering

  • Microsoft Office は、ライセンスが Windows ストアと統合されているため、_弾力的に_レイヤー化することはできません。Office アプリレイヤーは、レイヤー化されたイメージに含める必要があります。
  • 弾力的なレイヤー化でイメージを有効にすると、ユーザーは Windows エクスプローラーで他のセッションのファイルやディレクトリを表示できる場合があります。他のセッションで探索されたディレクトリは、そのディレクトリを参照する権限を持つすべてのセッションに表示されるフォルダを作成する可能性があります。
  • Windows Server 2008 または Windows 7 で弾力的なレイヤー割り当てを使用する場合は、セクターサイズ 512 でファイル共有を作成してください。この問題と関連するオペレーティングシステムの更新の詳細については、以下を参照してください。

ユーザーレイヤー

  • アップグレード後のサインオンで Windows 初回サインイン画面 が開始される: 4.10 以降にアップグレードした後でサインインすると、通常の Windows 初回サインイン により、ユーザーレイヤーが OS バージョンに合わせて最新の状態になります。このプロセスにより、ユーザーレイヤーファイルは保持されます。

Windows 10 のサポート

  • Windows 10 バージョン 20H2 のアップグレード。 OS レイヤーを以前のリリースから Windows 10 20H2 にアップグレードする場合は、ビルド 19042.630 以降に直接アップグレードしてください。2020 年 11 月 16 日より前にリリースされた Windows 10 20H2 のビルドからアップグレードすると、イメージの展開が一貫しない場合があります。たとえば、オフラインで一般化が選択されたテンプレートを使用してイメージを公開すると、公開されたイメージが正しく機能しない可能性があります。
  • 新しい Windows 10 メジャーリリースに移行する際の追加手順が必要: アップグレード中に、Windows 10 は OS レイヤーバージョンと同じディスク上に回復ボリュームを作成する場合があります。OS レイヤーバージョンを確定する前に、必ずこのボリュームを削除してください。そうしないと、回復ボリュームが原因でデスクトップが正しく起動しない可能性があります。詳細については、「Windows 10 v2004, 20H2, 21H1 & 21H2 - Citrix Known Issues」の「問題 9」を参照してください。
  • App Layering の Optimizations.cmd スクリプトを Windows 10 1909 OS レイヤーに生成して適用した場合、スタートメニューの検索オプションが期待どおりに機能しない可能性があります。この問題を回避するには、OS レイヤーにバージョンを追加し、プログラム c:\windows\setup\scripts\Optimize.hta を実行します。新しいレイヤーバージョンに適用する新しい Optimizations.cmd スクリプトを作成するには、タブレット入力サービスを無効にする (セクション 6、オプション M) の選択を解除し、ファイルを保存を選択します。OS レイヤーを確定する前に、Powershell Set-Service TabletInputService -startuptype manual コマンドを実行して、サービスを無効にした可能性のある以前の Optimizations.cmd の影響を元に戻します。

コネクタ

  • Azure Deployments コネクタを使用しているときに、すべてのテンプレートを削除し、コネクタを編集して新しいテンプレートを選択すると、削除されたテンプレートバージョンが表示されます。その後、保存をクリックするとエラーが表示されます。回避策として、保存をクリックする前に有効なテンプレートバージョンを再選択してください。(UNI-88412)
  • Windows ミニブートディスクオプションを使用する場合、任意のアプリレイヤーに対して最大 4 つの前提条件レイヤーを指定できます。アプリがインストール中に 4 つ以上の他のアプリケーションを必要とする場合は、複数のアプリを 1 つのレイヤーにインストールしてください。(UNI-69524)
  • Windows 7 64 ビットでレイヤー (アプリ、OS、またはプラットフォーム) を作成する際に、コネクタ構成でオフロードコンポジティングを選択すると、レイヤーにバージョンを追加する際に問題が発生する可能性があります。エラーが発生し、パッケージングマシンが作成されません。コネクタ構成でオフロードコンポジティングが_選択されていない_場合、パッケージングマシンは作成されます。(UNI-82545)
  • Azure から 503 エラー「サーバービジーの問題」を受信します。このエラーが継続的に発生する場合は、CTX310868 の手順に従ってください。この問題は散発的に発生し、その解決策がテスト中です。(ALHELP-1383)
  • コネクタの名前を入力しようとして、その名前が既に存在する場合、正しいエラーメッセージではなく、システムから一般的なエラーメッセージが表示されます。この問題は、Azure Deployments、Machine Creation for Azure Deployments、VMware vSphere、および Machine Creation for vSphere コネクタで発生します。(UNI-89218)

Citrix Provisioning™

  • イメージテンプレートを作成する際、ターゲットデバイスのハードウェア設定は Windows オペレーティングシステムおよびプラットフォームレイヤーの設定と一致している必要があります。ターゲットデバイスのハードウェア設定が、特に CPU 数において、オペレーティングシステムおよびプラットフォームレイヤーのハードウェア設定と一致していることを確認してください。設定が一致しない場合、公開されたイメージを起動する際に「再起動が必要です」というメッセージが表示されることがあります。(UNI-50799)
  • Provisioning Services を使用する場合、IPv6 は OS レイヤーで無効にする必要があり、プラットフォームレイヤーでは_無効にしないでください_。(UNI-53600)
  • App Layering から公開された VHDX ファイルを PVS ディスクストアにインポートする際、無効なディスクメッセージが表示されることがあります。公開されたファイル名の日付と時刻に含まれるピリオド (.) 文字を変更することで、エラーを解消してください。有効なファイル名には、VHDX ファイル名拡張子にピリオドが 1 つだけ含まれます。(UNI-75902)
  • コネクタ構成でオフロードコンポジティングが選択されている場合:
    • Citrix Provisioning Store のパスにスペースが含まれている場合、検証に失敗します。スペースを %20 に置き換えて、名前を有効にしてください。(UNI-84868)
    • ファイル共有パスがバックスラッシュ (\) で終わっている場合、公開ジョブは失敗します。(UNI-85045)
    • ドメインユーザーがファイル共有パスに対する読み取りおよび書き込み権限を持っていない場合、公開ジョブは ComponentActivator エラーメッセージで失敗します。(UNI-85020)
  • オフロードコンポジティング構成のために Hyper-V コネクタを選択し、OS レイヤーが Gen 2 の場合、OS レイヤーの別のバージョンを作成し、その OS バージョンからプラットフォームレイヤーを作成する必要があります。そうしないと、ターゲットが起動しません。(UNI-85044)

  • コネクタ構成のコンポジティングファイル共有パスを設定する際、コンポジティングエンジンと Citrix Provisioning Store 間の接続は検証されません。ストアパスがファイル共有パスにマップされていない場合、次のようなエラーが表示されます。

    • エラー: 「予期しないシステムエラーが発生しました。操作を再試行するか、テクニカルサポートにお問い合わせください。例外メッセージ: 応答ステータスコードは成功を示しません: 404 (Not Found)。[例外の詳細]」 (UNI-85045), (UNI-85020)

XenServer®

  • XenServer で使用するためにオペレーティングシステムイメージを準備する際、コンソールアクセスを許可するためにポート 5900 を開く必要があります。(UNI-50846)
  • Citrix App Layering コネクタ構成は、常にマスターノードを指すように設定してください。(UNI-52454)
  • 前提条件レイヤー:
    • マシンが起動時にハングし、前提条件レイヤーが選択されている場合、レイヤーディスクのいずれかがアタッチされていない可能性があります。Citrix Guest Tools が OS またはプラットフォームレイヤーのいずれかに含まれていることを確認してください。
    • 前提条件レイヤーを使用して OS またはプラットフォームレイヤーを作成する場合、Citrix Tools が存在する必要があります。ツールがないと、パッケージングマシンは失敗し、ブルースクリーンが表示されます。XenServer は DVD ドライブの_後に_アタッチされたデバイスを認識できません。DVD ドライブは常に 3 番目のスロットにあります。 (UNI-67741)

Citrix Virtual Apps and Desktops™ (CVAD)

  • Citrix Virtual Apps and Desktops をバージョン 7.15 CU4 に更新する際、まず .NET Framework 4.7.1 をプラットフォームレイヤーではなく、OS レイヤーの新しいバージョンにインストールする必要があります。OS レイヤーに .NET Framework 4.7.1 をインストールすることで、すべてのアプリレイヤー、プラットフォームレイヤー、およびイメージが正しく機能するようになります。最新の Windows アップデートには、すでに .NET Framework 4.7.1 が更新の一部として含まれています。(ALHELP-588, UNI-75108)

Google Cloud

  • 別のプラットフォームからレイヤーをインポートする場合、OS レイヤーにバージョンを追加し、それ以降は新しいレイヤーバージョンを使用するように切り替える必要があります。そうしないと、パッケージングマシンと公開されたイメージがブルースクリーンで失敗する可能性があります。

  • Google Cloud コネクタ構成。「資格情報の確認」はサービスアカウントユーザーロールを検証します。Google Cloud コネクタ構成のサービスアカウント JSON キーファイルで指定されたサービスアカウントが、選択したインスタンステンプレートに関連付けられたサービスアカウントと異なる場合、構成内のサービスアカウントはサービスアカウントユーザーロールを持っている必要があります。持っていない場合、そのコネクタ構成を使用してマシンを展開する際にエラーが表示されます。(UNI-82082)

Nutanix Acropolis

  • アプリレイヤー作成中に表示される次のメッセージは、アプリレイヤー設定がプラットフォームレイヤーを指定していることを示します。アプリレイヤーのパフォーマンス向上キャッシュ機能でプラットフォームレイヤーを使用しないでください。(UNI-67742)

    アプリレイヤーのエラー - パフォーマンス

VMware vSphere

  • OS レイヤー作成ウィザードを使用して OS レイヤーを作成する際、Unified Extensible Firmware Interface (UEFI) 仮想マシンがリストされます。ただし、ウィザードを使用して UEFI マシンを作成することはできません。代わりに、新しい ImportOsLayer.ps1 スクリプトを使用して、新しい OS レイヤーマシンにOS をインポートしてください。
  • VMware Cloud および vSAN 7.0 Update 2 (またはそれ以降) データストアで vSphere コネクタ構成を使用する場合、オフロードコンポジティングを選択する必要があります。(UNI-85216)
  • AL 23.4 で新しい VMware vSphere コネクタを使用する際、コネクタの作成または編集時に不透明なネットワークを選択すると、コネクタが失敗します。回避策として、不透明ではないネットワークを選択してください。AL 23.4 より前に作成された不透明なネットワークを使用する既存のコネクタ構成は、引き続き正常に機能します。(UNI-89439)

Microsoft Azure

  • App Layering は Azure File ストレージをサポートしていません。Azure でストレージを使用するには、SMB ファイル共有またはネットワークファイル共有を作成してください。(UNI-42272)
  • マネージドディスクは OS インポートのみでサポートされています。アプリレイヤーのパッケージ化とイメージの公開では、アンマネージドディスクのみが生成されます。Azure で仮想マシンを作成する際は、マネージドディスクなしを選択してください。

Microsoft Hyper-V

  • オフロードコンポジティングのために Hyper-V コネクタ構成を選択し、OS レイヤーが Gen 2 の場合、レイヤーには元のバージョン以外に少なくとも 1 つのバージョンが必要です。また、Citrix Provisioning ターゲットデバイスソフトウェアがインストールされているプラットフォームレイヤーは、新しい OS レイヤーバージョンを使用して作成する必要があります。(UNI-85044)
  • Hyper-V コネクタ構成が Gen 2 (UEFI) および VHDX でオフロードコンポジティングに設定されている場合、Citrix Provisioning コネクタ構成でディスク形式として VHD を選択することは許可されていますが、この構成はサポートされていません。
  • Hyper-V で Elastic Layering を構成する場合、アンマネージド RDS プールを使用する必要があります (UNI-53545)

  • アプリレイヤーを作成する際、アプリレイヤー設定でプラットフォームレイヤーが指定されている場合、エラーが表示されます。App Layering のキャッシュ機能でプラットフォームレイヤーを使用しないでください。(UNI-71868, UNI-67743)

    アプリレイヤーのエラー - パフォーマンス

  • Hyper-V Server 2019 で OS レイヤーを作成すると、次のエラーが発生する可能性があります。

    「VHD の作成に失敗しました。コネクタ構成で指定された共有に十分な空き容量があることを確認してください。」

    このエラーは、Microsoft PowerShell の New-VHD コマンドレットの問題によるものです。Microsoft からの修正プログラムに注目しています。それまでの間、このエラーに対する次の回避策を使用してください。

    1. ゴールド VM にチェックポイントがないことを確認します。
    2. ゴールド VM のディスクが、コネクタ構成で設定されているのと同じディレクトリパスにあることを確認します。例: ローカルパスは D:\Brock
      ゴールド VM ディスクは D:\Brock\WIn10Gold\Win10GoldDisk.vhdx に保存されています。

  • Hyper-V コネクタ構成のストレージへのパスにバッククォート (`) が含まれている場合、App Layering はアプリ/プラットフォームレイヤーの作成に失敗します。例:

     mystoragename`
 <!--NeedCopy-->

印刷

フルユーザーレイヤー用に構成された App Layering イメージでは、独自のプリンターデバイスを直接インストールできます。ただし、ログアウトしてログインすると、プリンターとスキャナーに自己インストールされたプリンターデバイスが表示されなくなります。

回避策として、アプリケーション内からプリンターにアクセスまたは選択できます。

ネットワーク

ネットワークコンポーネントを含むアプリケーションは、App Layer にインストールされ、その後公開されたイメージに含まれる場合、正しく動作しない可能性があります。この種のアプリケーションは、イメージ内のネットワーク関連のレジストリ情報が適切にマージされるように、OS Layer または Platform Layer のいずれかにインストールする必要があります。

関連情報

既知の問題
January 9, 2026
寄稿者: 
C C
January 9, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.