App Layering

PDFを表示

既知の問題

September 7, 2025

寄稿者:

C C

App Layering アップグレード

App Layering 2409

Citrix App Layeringでエージェントの移行が失敗した状態で完了した後、誤ったメッセージが表示されることがあります。メッセージには「The migration has completed successfully, but we were unable to register the following App Layering agents with the target appliance: 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) によって公開されたイメージ上で、エラスティックに割り当てられたApp Layerを起動できません。

原因

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

回避策

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

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

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

App Layering 2312

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

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

rootのログインとパスワードを使用してアプライアンスコンソールにログインします。
「yum remove mod_http2」コマンドを実行します。このコマンドの実行には数分かかる場合があります。
コマンドが完了したら、Webブラウザを使用してアプライアンスに再度ログインし、アップグレードを再実行します。
アップグレードの完了には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アクティベーションをOffice 2019を使用するように更新してください。OSイメージをレイヤー化のために準備する際、新しいApp Layering OSマシンツールをダウンロードして実行してください。
(リリース19.1のみ) OSイメージをレイヤー化のために準備する際、KMS Officeアクティベーションがデスクトップ起動時にトリガーされることを確認してください。このリリースのみ、リリース18.12のApp Layering OSマシンツールをダウンロードして実行してください。

Microsoft Teams 2.x

Microsoft Teams 2.xの詳細については、App Layeringまたはユーザーパーソナライゼーションレイヤー (UPL) の新しいTeams展開ガイダンスを参照してください。

Elastic Layering

Microsoft Officeは、ライセンスがWindowsストアと統合されているため、エラスティックにレイヤー化できません。Office App Layerは、レイヤー化されたイメージに含める必要があります。
エラスティックレイヤー化でイメージを有効にすると、ユーザーはWindowsエクスプローラーで他のセッションのファイルやディレクトリを表示できる場合があります。他のセッションで探索されたディレクトリは、そのディレクトリを参照する権限を持つすべてのセッションに表示されるフォルダーを作成する可能性があります。
Windows Server 2008またはWindows 7でエラスティックレイヤー割り当てを使用する場合、ファイル共有をセクターサイズ512で作成してください。この問題および関連するオペレーティングシステムの更新の詳細については、以下を参照してください。
- Windowsにおける4KセクターハードドライブのMicrosoftサポートポリシー
- Win 7およびWin Server 2008 R2とAdvanced Format Disksの互換性を向上させる更新 (UNI-48984)

ユーザーレイヤー

アップグレード後のサインオンで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既知の問題のIssue 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ミニブートディスクオプションを使用する場合、任意のApp Layerに対して最大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を使用する場合、OSレイヤーでIPv6を無効にする必要があり、プラットフォームレイヤーでは無効にしないでください。(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に更新する際、まず、プラットフォームレイヤーではなく、OSレイヤーの新しいバージョンに.NET Framework 4.7.1をインストールする必要があります。OSレイヤーに.NET Framework 4.7.1をインストールすることで、すべてのApp Layer、プラットフォームレイヤー、およびイメージが正しく機能するようになります。最新のWindowsアップデートには、すでに.NET Framework 4.7.1が更新の一部として含まれています。(ALHELP-588, UNI-75108)

Google Cloud

別のプラットフォームからレイヤーをインポートする際、OSレイヤーにバージョンを追加し、それ以降は新しいレイヤーバージョンを使用するように切り替える必要があります。そうしないと、パッケージングマシンと公開されたイメージがブルースクリーンで失敗する可能性があります。
Google Cloudコネクター構成。「資格情報の確認」はサービスアカウントユーザーロールを検証します。Google Cloudコネクター構成のサービスアカウントJSONキーファイルで指定されたサービスアカウントが、選択したインスタンステンプレートに関連付けられたサービスアカウントと異なる場合、構成内のサービスアカウントにはサービスアカウントユーザーロールが必要です。そうでない場合、そのコネクター構成を使用してマシンを展開する際にエラーが表示されます。(UNI-82082)

Nutanix Acropolis

App Layer作成中に表示される以下のメッセージは、App Layer設定がプラットフォームレイヤーを指定していることを示しています。App Layerのパフォーマンス向上キャッシュ機能でプラットフォームレイヤーを使用しないでください。(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ファイルストレージをサポートしていません。Azureでのストレージには、SMBファイル共有またはネットワークファイル共有を作成してください。(UNI-42272)
マネージドディスクはOSのインポートのみをサポートしています。App Layerのパッケージングとイメージの公開は、アンマネージドディスクのみを生成します。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 Layerを作成する際、App Layer設定でプラットフォームレイヤーが指定されている場合、エラーが表示されます。App Layeringのキャッシュ機能でプラットフォームレイヤーを使用しないでください。(UNI-71868, UNI-67743)
Hyper-V Server 2019でOSレイヤーを作成すると、次のエラーが発生する可能性があります。

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

このエラーは、Microsoft PowerShellのNew-VHDコマンドレットの問題によるものです。Microsoftからの修正を注視しています。それまでの間、このエラーに対する以下の回避策を使用してください。
1. Gold VMにチェックポイントがないことを確認してください。
2. Gold VMのディスクが、コネクター構成で設定されているのと同じディレクトリパスにあることを確認してください。例：ローカルパスはD:\Brock
  Gold VMディスクはD:\Brock\WIn10Gold\Win10GoldDisk.vhdxに保存されています
Hyper-Vコネクター構成のストレージへのパスにバッククォート (`) が含まれている場合、App LayeringはApp/プラットフォームレイヤーの作成に失敗します。例：
```
 mystoragename`
 
```

印刷

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

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

ネットワーク

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