Documentation produit
App Layering
Voir PDF

Problèmes connus

January 9, 2026
Contributeur: 
C C

Mise à niveau d’App Layering

App Layering 2511

  • Pour le connecteur Google Cloud Platform, il existe actuellement un problème avec le packaging des couches et la publication des images en couches. La tâche échoue après avoir attendu le démarrage du moteur de composition, avec un message d’erreur contenant The resource ‘citrix-ce/’ of type ‘Guest Attribute’ was not found. [404]. Ce problème sera résolu dans une future mise à jour ou version. [UNI-92996]

  • La fonctionnalité Image Portability Service ne prend actuellement pas en charge les images Azure configurées avec un contrôleur de disque NVMe. La prise en charge est prévue pour une future version.

App Layering 2409

  • Vous pouvez rencontrer un message incorrect une fois la migration terminée avec des agents défaillants dans Citrix App Layering. Le message indique : « La migration s’est terminée avec succès, mais nous n’avons pas pu enregistrer les agents App Layering suivants auprès de l’appliance cible : System.Collections.Generic.List`1[System.String]. » [UNI-91339]

  • Après la migration vers l’Elastic Layer Manager (ELM) cible, vous ne serez pas invité à définir les mots de passe de l’administrateur root et de la console. Si ces mots de passe n’ont pas été définis avant la migration, ils seront réinitialisés aux paramètres d’usine par défaut.

    Solution de contournement :

    Si les mots de passe n’ont pas été définis avant la migration, connectez-vous à la console ELM cible en tant que root et modifiez les mots de passe manuellement à l’aide des commandes suivantes :

    • Modifiez le mot de passe root :

      passwd

      Vous serez invité à définir un mot de passe pour root.

    • Modifiez le mot de passe de l’administrateur :

      passwd administrator

      Vous serez invité à définir un mot de passe pour l’administrateur ; utilisez un « a » minuscule. [UNI-91472]

  • Lorsque vous vous connectez à un nouvel ELM à l’aide d’un utilisateur non-root, vous pouvez recevoir un message d’erreur peu clair indiquant : « Cannot convert undefined or null to object. » Vous devriez vous attendre à un message spécifique indiquant que l’utilisateur est incorrect. [UNI-91330]

  • Vous devez éviter d’utiliser des caractères spéciaux tels que &, < et > dans votre mot de passe administrateur par défaut sur l’ELM, car cela pourrait entraîner des échecs de création de couche de système d’exploitation via le script d’importation. [UNI-87311]

  • Après la migration, le mot de passe de l’administrateur de la console de gestion sur l’Elastic Layer Manager (ELM) cible sera écrasé par le mot de passe de l’ELM source. Pour contourner ce problème, vous pouvez vous connecter à l’ELM cible en tant qu’utilisateur disposant de privilèges d’administrateur et modifier le mot de passe administrateur par défaut. [UNI-91451]

  • Après la migration, les onglets Images, Connectors, Directory Services et User Layer Storage de l’ELM cible ne se rafraîchissent pas automatiquement. Vous remarquerez peut-être que ces onglets apparaissent vides, même si l’onglet Layers affiche des données. Pour afficher les informations correctes, actualisez manuellement votre navigateur ou votre onglet. [UNI-91374]

  • Après avoir effectué une migration par copie, vous ne pouvez pas lancer les couches d’applications attribuées de manière élastique sur les images publiées par l’Elastic Layer Manager (ELM) cible lorsqu’un nouveau partage réseau est créé.

    Cause

    Le nouveau partage réseau ne contient aucune couche d’application précédemment attribuée et synchronisée avec le partage réseau d’origine sur l’ELM source.

    Solutions de contournement

    Solution de contournement 1 : Exécutez la commande suivante : mono /usr/local/unitools/MAService.exe -fire SyncRevisionsToShareEvent

    Solution de contournement 2 : Copiez manuellement toutes les couches d’applications du partage réseau de l’ELM source vers le nouveau partage réseau associé à l’ELM cible.

    Solution de contournement 3 : Désattribuez puis réattribuez les couches d’applications. Cette action déclenchera une synchronisation des couches vers le nouveau partage réseau. [UNI-91377]

App Layering 2312

La mise à niveau vers App Layering 2312 peut échouer, renvoyant l’erreur « Une défaillance s’est produite lors de la mise à niveau de l’appliance. Réessayez la mise à niveau après être revenu à un instantané propre. » Nous sommes conscients d’un problème avec certaines appliances qui ont été mises à niveau à partir de versions antérieures. Dans ce scénario, la mise à niveau peut échouer en raison de la présence de composants de mise à niveau hérités. Nous travaillons sur une version corrigée d’App Layering 2306 qui contient un correctif permanent pour ce problème.

Pour contourner ce problème, il est nécessaire de supprimer le module hérité en apportant les modifications suivantes à l’appliance Layering :

  1. Connectez-vous à la console de l’appliance à l’aide de l’identifiant et du mot de passe root.
  2. Exécutez la commande « yum remove mod_http2 ». L’exécution de la commande peut prendre plusieurs minutes.
  3. Une fois la commande terminée, reconnectez-vous à l’appliance à l’aide d’un navigateur Web et relancez la mise à niveau.
  4. La mise à niveau peut prendre 30 minutes ou plus, mais elle doit maintenant réussir.

App Layering 2005

  • Le package de mise à niveau d’App Layering 2005 est suffisamment volumineux pour que les appliances plus anciennes ne puissent pas le télécharger automatiquement. Si vous utilisez la version 2001 ou une version antérieure, téléchargez le package manuellement depuis le site de téléchargement.

  • Nous vous recommandons d’exécuter la mise à niveau à partir d’une console de gestion en HTTP sécurisé (HTTPS). Si vous effectuez la mise à niveau en HTTP, les messages ne s’affichent pas dans le navigateur. Si cela se produit, actualisez le navigateur après 20 minutes. (L’actualisation ne causera pas de problèmes malgré le message qui indique de ne pas actualiser.) Si la mise à niveau est toujours en cours, vous obtenez une « erreur de service indisponible ». Vous pouvez ignorer le message et continuer à actualiser le navigateur toutes les quelques minutes jusqu’à ce que la page de connexion apparaisse.

  • Si vous avez deux packages de mise à niveau portant le même nom dans des dossiers différents du partage de fichiers réseau, la sélection de l’un de ces packages entraîne la sélection des deux packages. Si les deux packages ont la même version, la mise à niveau réussit. S’ils ont des versions différentes, le système choisit le numéro de version inférieur. Cela se produit avec l’Enterprise Layer Manager (ELM) version 22.2.

Appliance et console de gestion App Layering

  • Dans la nouvelle interface utilisateur, les types de plateformes ne peuvent pas être modifiés. Modifier les types de plateformes fonctionne toujours correctement dans l’ancienne interface utilisateur. (UNI-86856)
  • Lors de l’installation de l’appliance App Layering, vous devez utiliser le paramètre CPU par défaut de 4 CPU.
  • Si vous utilisez des rôles dans un environnement Active Directory complexe et que les connexions sont lentes, attribuez tous les rôles à des utilisateurs explicites plutôt qu’à des groupes.

Liens de la documentation App Layering

Les liens de la documentation dans la console de gestion s’ouvrent sous forme de page vierge dans Internet Explorer 11. Pour contourner ce problème, collez le lien dans un autre navigateur. La documentation s’affiche correctement.

Agent App Layering

Par défaut, l’agent Citrix App Layering™ s’exécute sous le compte Système local sur le serveur Hyper-V. Si vous modifiez le compte pour autre chose que Système local, l’agent ne peut pas transférer de disques vers et depuis l’appliance.

Outils de machine OS App Layering

  • (Version 19.5 uniquement) Après la mise à niveau vers la version 19.5 (ou ultérieure) à partir de la version 19.3 (ou antérieure), assurez-vous de mettre à jour l’activation KMS Office pour utiliser Office 2019. Lors de la préparation de votre image OS pour le layering, téléchargez et exécutez les nouveaux outils de machine OS App Layering.

  • (Version 19.1 uniquement) Lors de la préparation de votre image OS pour le layering, assurez-vous que votre activation KMS Office est déclenchée au démarrage du bureau. Pour cette version uniquement, téléchargez et exécutez les outils de machine OS App Layering de la version 18.12.

Microsoft Teams 2.x

Layering élastique

  • Microsoft Office ne peut pas être appliqué de manière élastique en raison de la façon dont ses licences sont intégrées au Windows Store. La couche d’application Office doit être incluse dans l’image en couches.
  • Lorsque vous activez une image avec le layering élastique, les utilisateurs peuvent être en mesure de visualiser des fichiers et des répertoires d’autres sessions dans l’Explorateur Windows. Les répertoires explorés dans l’autre session peuvent créer des dossiers visibles par toutes les sessions ayant l’autorisation de parcourir ce répertoire.
  • Si vous utilisez des attributions de couches élastiques avec Windows Server 2008 ou Windows 7, créez votre partage de fichiers avec une taille de secteur de 512. Pour plus de détails sur ce problème et les mises à jour du système d’exploitation associées, consultez les éléments suivants :

Couches utilisateur

  • La connexion après la mise à niveau démarre les écrans de première connexion Windows : Lorsque vous vous connectez après la mise à niveau vers la version 4.10 ou ultérieure, la première connexion Windows habituelle met à jour la couche utilisateur avec la version du système d’exploitation. Le processus préserve les fichiers de la couche utilisateur.

Prise en charge de Windows 10

  • Mises à niveau de Windows 10, version 20H2. Si vous mettez à niveau la couche OS vers Windows 10 20H2 à partir d’une version antérieure, effectuez la mise à niveau directement vers la Build 19042.630, ou une version ultérieure. La mise à niveau à partir de builds de Windows 10 20H2 publiées avant le 16/11/2020 peut entraîner des déploiements d’images incohérents. Par exemple, si vous publiez des images à l’aide d’un modèle avec Généraliser hors ligne sélectionné, les images publiées risquent de ne pas fonctionner correctement.
  • La mise à niveau nécessite des étapes supplémentaires lors du passage à une nouvelle version majeure de Windows 10 : Pendant la mise à niveau, Windows 10 peut créer un volume de récupération sur le même disque que la version de la couche OS. Supprimez toujours ce volume avant de finaliser la version de la couche OS. Sinon, le volume de récupération peut empêcher les bureaux de démarrer correctement. Pour plus d’informations, consultez le problème 9 sous Windows 10 v2004, 20H2, 21H1 & 21H2 - Citrix Known Issues.
  • Si vous avez généré et appliqué le script Optimizations.cmd d’App Layering à une couche OS Windows 10 1909, l’option Rechercher du menu Démarrer pourrait ne pas fonctionner comme prévu. Pour éviter ce problème, ajoutez une version à la couche OS et exécutez le programme c:\windows\setup\scripts\Optimize.hta. Pour créer un nouveau script Optimizations.cmd à appliquer à la nouvelle version de la couche, désélectionnez Désactiver le service de saisie de la tablette (Section 6, Option M) et sélectionnez Enregistrer le fichier. Avant de finaliser la couche OS, exécutez la commande Powershell Set-Service TabletInputService -startuptype manual pour annuler l’effet de tout Optimizations.cmd précédent qui aurait pu désactiver le service.

Connecteurs

  • Lorsque vous utilisez le connecteur Déploiements Azure, si vous supprimez tous les modèles et modifiez le connecteur pour choisir un nouveau modèle, une version de modèle supprimée apparaît. Ensuite, lorsque vous cliquez sur Enregistrer, une erreur apparaît. Pour contourner ce problème, resélectionnez une version de modèle valide avant de cliquer sur Enregistrer. (UNI-88412)
  • Lorsque vous utilisez l’option de mini-disque de démarrage Windows, vous pouvez spécifier jusqu’à quatre couches de prérequis pour toute couche d’application donnée. Si une application nécessite plus de quatre autres applications pour être présente pendant l’installation, installez plusieurs applications dans une seule couche. (UNI-69524)
  • Lors de la création d’une couche (application, OS ou plateforme) sur Windows 7 64 bits, si vous sélectionnez Déchargement de la composition dans la configuration du connecteur, vous pouvez rencontrer des problèmes pour ajouter une version à la couche. Une erreur se produit et la machine de packaging n’est pas créée. Lorsque le déchargement de la composition n’est pas sélectionné dans la configuration du connecteur, la machine de packaging est créée. (UNI-82545)
  • Réception de l’erreur 503, « Problèmes de serveur occupé » d’Azure. Si vous recevez constamment cette erreur, suivez les étapes de CTX310868. Ce problème se produit sporadiquement, et une solution est en cours de test. (ALHELP-1383)
  • Si vous tentez de saisir un nom pour un connecteur, et que ce nom existe déjà, vous recevez un message d’erreur générique du système, plutôt que le message d’erreur correct. Le problème se produit pour les connecteurs Déploiements Azure, Création de machine pour les déploiements Azure, VMware vSphere et Création de machine pour vSphere. (UNI-89218)

Citrix Provisioning™

  • Lorsque vous créez un modèle d’image, les paramètres matériels du périphérique cible doivent correspondre aux paramètres du système d’exploitation Windows et de la couche de plateforme. Assurez-vous que les paramètres matériels du périphérique cible correspondent aux paramètres matériels du système d’exploitation et de la couche de plateforme, en particulier le nombre de CPU. Si les paramètres ne correspondent pas, vous pouvez obtenir un message « redémarrage requis » lorsque vous démarrez l’image publiée. (UNI-50799)
  • Si vous utilisez Provisioning Services, vous devez désactiver IPv6 dans la couche OS et non dans la couche de plateforme. (UNI-53600)
  • Lors de l’importation de fichiers VHDX publiés depuis App Layering vers le magasin de disques PVS, vous recevez parfois un message de disque invalide. Éliminez l’erreur en modifiant les caractères point (.) dans la date et l’heure du nom de fichier publié. Un nom de fichier valide ne contient qu’un seul point pour l’extension de nom de fichier VHDX. (UNI-75902)
  • Lorsque Déchargement de la composition est sélectionné dans la configuration du connecteur :
    • Le chemin d’accès au magasin Citrix Provisioning ne parvient pas à être validé s’il contient des espaces. Remplacez les espaces par %20 pour rendre le nom valide. (UNI-84868)
    • Les tâches de publication échouent si le chemin du partage de fichiers se termine par une barre oblique inverse (\). (UNI-85045)
    • Les tâches de publication échouent avec un message d’erreur ComponentActivator si l’utilisateur de domaine ne dispose pas des autorisations de lecture et d’écriture sur le chemin du partage de fichiers. (UNI-85020)
  • Lorsque vous sélectionnez un connecteur Hyper-V pour la configuration de déchargement de la composition, et que la couche OS est de génération 2, vous devez créer une autre version de la couche OS, puis créer la couche de plateforme à partir de cette version OS. Sinon, la cible ne démarre pas. (UNI-85044)

  • Lors de la définition du chemin de partage de fichiers de composition pour la configuration du connecteur, la connectivité entre le moteur de composition et le magasin Citrix Provisioning n’est pas vérifiée. Si le chemin du magasin ne correspond pas au chemin du partage de fichiers, vous recevez une erreur similaire à :

    • Erreur : « Une erreur système inattendue s’est produite. Réessayez l’opération ou contactez le support technique. Message d’exception : Le code d’état de la réponse n’indique pas de succès : 404 (Non trouvé). [Détails de l’exception] (UNI-85045), (UNI-85020)

XenServer®

  • Lorsque vous préparez votre image de système d’exploitation pour l’utiliser dans votre XenServer, vous devez ouvrir le port 5900 pour autoriser l’accès à la console. (UNI-50846)
  • Configurez toujours le connecteur Citrix App Layering pour qu’il pointe vers le nœud maître. (UNI-52454)
  • Couches de prérequis :
    • Si une machine se bloque au démarrage et qu’une couche de prérequis est sélectionnée, l’un des disques de la couche n’est probablement pas attaché. Assurez-vous que les outils Citrix Guest sont inclus dans les couches OS ou de plateforme.
    • Si vous utilisez des couches de prérequis pour créer la couche OS ou la couche de plateforme, les outils Citrix doivent être présents. Sans ces outils, la machine de packaging échoue et vous recevez un écran bleu. XenServer n’est pas en mesure de voir les périphériques attachés après le lecteur de DVD. Le lecteur de DVD est toujours dans le troisième emplacement. (UNI-67741)

Citrix Virtual Apps and Desktops™ (CVAD)

  • Lors de la mise à jour de Citrix Virtual Apps and Desktops vers la version 7.15 CU4, vous devez d’abord installer .NET Framework 4.7.1 sur une nouvelle version de votre couche OS, plutôt que sur la couche de plateforme. L’installation de .NET Framework 4.7.1 sur la couche OS garantit que toutes les couches d’applications, les couches de plateforme et les images fonctionnent correctement. Les dernières mises à jour Windows incluent déjà .NET Framework 4.7.1 dans le cadre des mises à jour. (ALHELP-588, UNI-75108)

Google Cloud

  • Lors de l’importation de couches depuis une autre plateforme, vous devez ajouter une version à la couche OS, puis passer à l’utilisation de la nouvelle version de la couche. Sinon, les machines de packaging et les images publiées risquent d’échouer avec un écran bleu.

  • Configuration du connecteur Google Cloud. « Vérifier les informations d’identification » vérifie le rôle d’utilisateur du compte de service. Si le compte de service spécifié dans le fichier Clé JSON du compte de service de la configuration du connecteur Google Cloud est différent du compte de service associé à votre Modèle d’instance sélectionné, votre compte de service dans la configuration doit avoir le rôle Utilisateur du compte de service. Si ce n’est pas le cas, vous recevez une erreur lors du déploiement d’une machine à l’aide de cette configuration de connecteur. (UNI-82082)

Nutanix Acropolis

  • Le message suivant lors de la création de la couche d’application indique que les paramètres de la couche d’application spécifient une couche de plateforme. N’utilisez pas de couches de plateforme avec la fonctionnalité de mise en cache améliorant les performances de la couche d’application. (UNI-67742)

    image

VMware vSphere

  • Lors de la création de la couche OS à l’aide de l’Assistant Création de couche OS, les machines virtuelles Unified Extensible Firmware Interface (UEFI) sont répertoriées. Vous ne pouvez cependant pas créer de machines UEFI à l’aide de l’assistant. Utilisez plutôt le nouveau script ImportOsLayer.ps1 pour importer l’OS sur la nouvelle machine de couche OS.
  • Lorsque vous utilisez une configuration de connecteur vSphere avec VMware Cloud et un datastore vSAN 7.0 Update 2 (ou ultérieur), Déchargement de la composition doit être sélectionné. (UNI-85216)
  • Lorsque vous utilisez le nouveau connecteur VMware vSphere dans AL 23.4, si vous sélectionnez un réseau opaque lors de la création ou de la modification du connecteur, le connecteur échoue. Pour contourner ce problème, sélectionnez un réseau non opaque. Les configurations de connecteur existantes utilisant un réseau opaque créé avant AL 23.4 continuent de fonctionner normalement. (UNI-89439)

Microsoft Azure

  • App Layering ne prend pas en charge le stockage de fichiers Azure. Pour le stockage dans Azure, créez un partage de fichiers SMB ou un partage de fichiers réseau. (UNI-42272)
  • Les disques gérés ne sont pris en charge que pour les importations d’OS. Le packaging des couches d’applications et la publication d’images ne produisent que des disques non gérés. Lors de la création d’une machine virtuelle dans Azure, sélectionnez Aucun disque géré.

Microsoft Hyper-V

  • Lorsque vous sélectionnez une configuration de connecteur Hyper-V pour le déchargement de la composition et que votre couche OS est de génération 2, la couche doit avoir au moins une version en plus de l’originale. De plus, la couche de plateforme où le logiciel du périphérique cible Citrix Provisioning est installé doit être créée à l’aide de la nouvelle version de la couche OS. (UNI-85044)
  • Lorsqu’une configuration de connecteur Hyper-V est définie pour le déchargement de la composition avec Gen 2 (UEFI) et VHDX, le choix de VHD comme format de disque dans la configuration du connecteur Citrix Provisioning est autorisé, mais cette configuration n’est pas prise en charge.
  • Lorsque vous configurez le layering élastique dans Hyper-V, vous devez utiliser des pools RDS non gérés (UNI-53545)

  • Lors de la création d’une couche d’application, si une couche de plateforme est spécifiée dans les paramètres de la couche d’application, vous recevez une erreur. N’utilisez pas de couches de plateforme avec la fonctionnalité de mise en cache d’App Layering. (UNI-71868, UNI-67743)

    image

  • La création d’une couche OS sur Hyper-V Server 2019 peut entraîner cette erreur :

    « Échec de la création du VHD. Assurez-vous qu’il y a suffisamment d’espace sur le partage spécifié dans la configuration du connecteur. »

    Cette erreur est due à un problème avec la cmdlet Microsoft PowerShell New-VHD. Nous surveillons la publication d’un correctif par Microsoft. En attendant, utilisez la solution de contournement suivante pour cette erreur :

    1. Assurez-vous que la VM Gold n’a pas de points de contrôle.
    2. Assurez-vous que le disque de la VM Gold se trouve dans le même chemin de répertoire que celui configuré dans la configuration du connecteur. Exemple : Le chemin local est D:\Brock
      Le disque de la VM Gold est stocké dans D:\Brock\WIn10Gold\Win10GoldDisk.vhdx

  • App Layering ne parvient pas à créer une couche d’application/plateforme si le chemin d’accès au stockage dans la configuration du connecteur Hyper-V contient une apostrophe inversée (`). Par exemple :

     mystoragename`
 <!--NeedCopy-->

Impression

Avec les images App Layering configurées pour la couche utilisateur complète, vous pouvez installer directement vos propres périphériques d’impression. Cependant, lorsque vous vous déconnectez et vous reconnectez, Imprimantes et scanners n’affiche plus les périphériques d’impression auto-installés.

Pour contourner ce problème, vous pouvez accéder ou sélectionner les imprimantes à partir des applications.

Réseau

Les applications qui incluent des composants réseau peuvent ne pas fonctionner correctement lorsqu’elles sont installées dans une couche d’application puis incluses dans une image publiée. Les applications de ce type doivent être installées dans la couche OS ou la couche de plateforme pour assurer une fusion correcte des informations de registre liées au réseau dans l’image.

Informations connexes

Problèmes connus
January 9, 2026
Contributeur: 
C C
January 9, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.