App Layering

既知の問題

June 27, 2024

寄稿者:

App Layering アップグレード

App Layering 2312

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

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

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

App Layering 2005

App Layering 2005 アップグレードパッケージは、古いアプライアンスで自動的にダウンロードできないほど大きなサイズです。バージョン 2001 以前を実行している場合は、ダウンロードサイトからパッケージを手動でダウンロードします。
Secure HTTP（HTTPS）の管理コンソールからアップグレードを実行することをお勧めします。HTTP でアップグレードすると、ブラウザにメッセージが表示されません。その場合は、20分後にブラウザを更新します。(更新しないというメッセージが表示されても、更新しても問題は発生しません。)アップグレードがまだ実行されている場合は、「サービス利用不可」エラーが表示されます。メッセージを無視し、ログインページが表示されるまで数分おきにブラウザを更新し続けることは安全です。
Network File Share の異なるフォルダーに同じ名前の 2 つのアップグレードパッケージがある場合、それらのパッケージの 1 つを選択すると、両方のパッケージが選択されます。両方のパッケージが同じバージョンであれば、アップグレードは成功します。バージョンが異なる場合は、小さい方のバージョン番号が選択されます。これは、エンタープライズレイヤマネージャ (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サーバーのローカルシステムアカウントで実行されます 。アカウントをローカルシステム以外に変更すると、エージェントはアプライアンスとの間でディスクを転送できません。

App Layering OSマシンツール

(リリース 19.5 のみ) 19.3 (またはそれ以前) からリリース 19.5 (またはそれ以降) にアップグレードした後、Office 2019 を使用するように必ず KMS Office ライセンス認証を更新してください。OSイメージをレイヤリング用に準備するときは、新しいApp Layering OSマシンツールをダウンロードして実行します。
(リリース 19.1 のみ) OS イメージを階層化用に準備するときは、デスクトップの起動時に必ず KMS Office ライセンス認証がトリガーされるようにしてください。このリリースのみ、 リリース 18.12から App Layering OS マシンツールをダウンロードして実行します。

Microsoft Teams 2.x

Microsoft Teams 2.x ではインストール方法が変更され、C:\Program Files\WindowsAppsにインストールされるようになりました。この変更をサポートするには、App Layering バージョン 2403.2 以降を実行している必要があります。この修正を含むアップグレードディスクは、 App Layering のダウンロードページでダウンロードできます。

心に留めておいてください：

ただし、特定のフォルダ/ファイルを永続化から除外するには、MSFTの推奨事項に従う必要があります。
Elastic-Fit は、これらのアプリレイヤーがエラスティックアサインメントに適していないことを示しています (公開されたイメージに UWP/AppX アプリレイヤーを含めてください)。
既存のユーザー層ユーザーは、イメージ内でこれら2つのアプリケーションの組み合わせが変更されたり、これら2つのアプリケーションのバージョンが変更されたりすると、「初めて」ログインすることになります。
アプリレイヤーのリビジョンで Microsoft Teams を更新する場合、新しいバージョンをインストールする前に以前のバージョンを削除してください。
Microsoft Teams 2.1 が以前に OS レイヤーにインストールされている場合は、アプリレイヤーを作成する前に OS レイヤーから削除する必要があります。

App Layering の以前のバージョンを実行している場合は、OS レイヤーに Microsoft Teams 2.1 をインストールするための回避策が必要です。次の回避策を使用してください。

回避方法：

OS レイヤーバージョンを作成します。
Windows 10 または 11 用の.exe インストーラーをダウンロードします。
MSIXをダウンロードしてください。

注：

.exe インストーラーと MSIX の詳細については、 Microsoft のドキュメントを参照してください。
管理コマンドプロンプトを開きます。
次のコマンドを使用して Microsoft Teams の自動更新を無効にします。 reg add hklm\software\microsoft\teams /v disableAutoUpdate /t REG_DWORD /d 1 /f
.MSIXの場所に応じて、次の手順を実行してください：
1. Windows 10 または 11 の場合は、次のコマンドを使用してください。 .\teamsbootstrapper.exe -p -o "c:\path\to\teams.msix"
2. Windows Server 2016、2019、または 2022 の場合は、次のコマンドを使用します。 Dism /Online /Add-ProvisionedAppxPackage /PackagePath:<MSIX package path> /SkipLicense
インストールを完了するには、Microsoft Teamsを起動します。
UserExclusionファイルを作成して、次のMSFT推奨除外項目を含めます：
- c:\Users\*\AppData\Local\Publishers\8wekyb3d8bbwe\TeamsSharedConfig\Meeting-Addin\
- c:\Users\*\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\
- c:\Users\*\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\PerfLogs\
- c:\Users\*\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\WebStorage\
OS レイヤーのバージョンを最終化します。
(オプション) 以前の Microsoft Teams バージョンを含むアプリケーションレイヤーが弾力的または統計的に割り当てられていないことを確認します。

注：

.MSIX ファイル自体は実行しないでください。これにより Microsoft Teams がインストールされ、[スタート] メニューに表示されますが、クリックしてもプロセスが開始されません。

OS レイヤーの作成中は、どの Microsoft Teams アカウントにもログインしないでください。また、Microsoft Teams の設定を変更しないでください。新しい Microsoft Teams では個人アカウントはサポートされていません。詳細については、 Microsoft のドキュメントを参照してください。

[UNI-90395]

Elastic Layering

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

ユーザーレイヤー

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

Windows 10 サポート

Windows 10、バージョン20H2のアップグレード。以前のリリースから Windows 10 20H2 に OS レイヤーをアップグレードする場合は、ビルド 19042.630 またはそれ以降に直接アップグレードします。2020 年 11 月 16 日以前にリリースされた Windows 10 20H2 のビルドからアップグレードすると、一貫性のないイメージ展開が発生する可能性があります。たとえば、「 オフラインで一般化 」を選択したテンプレートを使用して画像を公開すると、公開された画像が正しく機能しない場合があります。
新しい Windows 10 メジャーリリースに移動する場合、アップグレードには追加の手順が必要です 。アップグレード時に、Windows 10 は OS レイヤーバージョンと同じディスクに回復ボリュームを作成できます。OS レイヤーのバージョンを確定する前に、必ずこのボリュームを削除してください。そうしないと、復元ボリュームが原因でデスクトップが正常に起動しなくなる可能性があります。詳細については、「 Windows 10 v2004、20H2、21H1、21H2-Citrix 既知の問題9」を参照してください。
Windows 10 1909 OS レイヤーにApp Layering Optimizations.cmdスクリプトを生成して適用した場合、[ スタート ] メニューの [ 検索 ] オプションが期待どおりに機能しないことがあります。この問題を回避するには、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 デプロイメント、Azure デプロイ用のマシン作成、VMware vSphere、および vSphere用マシン作成コネクタで発生します。(UNI-89218)

Citrix Provisioning

イメージテンプレートを作成する場合、ターゲットデバイスのハードウェア設定は、Windowsオペレーティングシステムおよびプラットフォームレイヤーの設定と一致する必要があります。ターゲットデバイスのハードウェア設定が、オペレーティングシステムおよびプラットフォーム層のハードウェア設定（特にCPUの数など）と一致していることを確認します。設定が一致しない場合、公開イメージを開始したときに「再起動が必要です」というメッセージが表示されることがあります。(UNI-50799)
Provisioning Servicesを使用する場合は、 プラットフォームレイヤーではなく 、OSレイヤーでIPv6を無効にする必要があります。(UNI-53600)
App LayeringからPVSディスクストアに公開されたVHDXファイルをインポートすると、無効なディスクメッセージが表示されることがあります。パブリッシュされたファイル名の日付と時刻のピリオド (.) 文字を変更することで、エラーを解消します。有効なファイル名には、VHDXファイル名の拡張子にピリオドが1つだけ含まれます。(UNI-75902)
コネクタ設定で [ コンポジットをオフロード ] が選択されている場合:
- Citrix Provisioning ストアのパスにスペースが含まれているかどうかの検証に失敗します。名前を有効にするには、スペースを %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)
前提条件レイヤー:
- 起動時にマシンがハングし、前提条件となるレイヤーが選択されている場合、レイヤーディスクの 1 つが接続されていない可能性があります。Citrixゲストツールが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レイヤーにインストールする必要があります。.NET Framework 4.7.1 をOSレイヤーにインストールすると、すべてのアプリケーションレイヤー、プラットフォームレイヤー、およびイメージが正しく動作することが保証されます。最新の Windows 更新プログラムには、更新プログラムの一部として.NET Framework 4.7.1 が既に含まれています。（ALHELP-588、UNI-75108）

Google Cloud

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

Nutanix Acropolis

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

VMware vSphere

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

Microsoft Azure

App Layering は、Azure ファイルストレージをサポートしていません。Azure の記憶域の場合は、SMB ファイル共有またはネットワークファイル共有を作成します。(UNI-42272)
管理ディスクは OS のインポートでのみサポートされます。アプリレイヤーをパッケージ化してイメージを公開すると、管理対象外のディスクのみが生成されます。Azure で仮想マシンを作成するときは、[ 管理対象ディスクなし] を選択します。

Microsoft Hyper-V

Offload コンポジット用に Hyper-V コネクタ構成を選択し、OS レイヤーが Gen 2 の場合、レイヤーには元のレイヤー以外に少なくとも 1 つのバージョンが必要です。また、Citrix Provisioning ターゲットデバイスソフトウェアがインストールされるプラットフォームレイヤーは、新しいOSレイヤーバージョンを使用して作成する必要があります。(UNI-85044)
Hyper-Vコネクタ構成が第2世代（UEFI）およびVHDXでのオフロードコンポジットに設定されている場合、Citrix Provisioning コネクタ構成でディスク形式としてVHDを選択することはできますが、この構成はサポートされていません。
Hyper-V で Elastic レイヤリングを構成する場合は、 管理対象外の RDS プール (UNI-53545) を使用する必要があります
アプリレイヤーの作成時に、アプリレイヤーの設定でプラットフォームレイヤーが指定されている場合、エラーが発生します。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 は/プラットフォームレイヤーの作成に失敗します。例：
```
 mystoragename`
 
```

印刷

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

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

ネットワーク

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