Citrix Virtual Apps and Desktops

Affichages, messages et résolution des problèmes

Surveiller les PvD via des rapports

Vous pouvez utiliser un outil de diagnostic pour surveiller les modifications effectuées par les utilisateurs pour les deux parties de leurs Personal vDisks (les données de l’utilisateur et l’application). Ces modifications incluent les applications que les utilisateurs ont installé et les fichiers qu’ils ont modifié. Les modifications sont stockées dans un ensemble de rapports.

  1. Sur la machine que vous voulez surveiller, exécutez C:\\Program Files\\Citrix\\personal vDisk\\bin\\CtxPvdDiag.exe.
  2. Recherchez un emplacement où vous souhaitez stocker les rapports et les journaux, sélectionnez les rapports à générer, et cliquez sur OK. Les rapports disponibles sont répertoriés ci-dessous.

Rapport de la ruche de logiciels : ce rapport génère deux fichiers : Software.Dat.Report.txt et Software.Dat.delta.txt.

Le fichier Software.Dat.Report.txt enregistre les modifications effectuées par l’utilisateur dans la ruche HKEY_LOCAL_MACHINE\Software. Il contient les sections suivantes :

  • Liste des applications installées sur la base : les applications qui ont été installées dans Layer 0.
  • Liste des logiciels installés par l’utilisateur : les applications installées par l’utilisateur sur la partie de l’application du vDisk personnel.
  • Liste de logiciels désinstallés par l’utilisateur : les applications supprimées par l’utilisateur qui étaient présentes à l’origine dans Layer 0.

Voir le rapport delta de la ruche pour de plus amples informations sur Software.Dat.delta.txt.

Rapport de la ruche système : le fichier SYSTEM.CurrentControlSet.DAT.Report.txt généré enregistre les modifications apportées à la ruche HKEY_LOCAL_MACHINE\System par l’utilisateur. Il contient les sections suivantes :

  • Liste des services installés par l’utilisateur : les services et les pilotes installés par l’utilisateur.
  • Le démarrage des services suivants a été modifié : les services et les pilotes dont le type de démarrage a été modifié par l’utilisateur.

Rapport de la ruche de sécurité : le fichier SECURITY.DAT.Report.txt généré surveille toutes les modifications que l’utilisateur effectue dans la ruche HKEY_LOCAL_MACHINE\Security.

Rapport de ruche du gestionnaire de comptes de sécurité (SAM) : le fichier SAM.DAT.Report.txt généré surveille toutes les modifications que l’utilisateur effectue dans la ruche HKEY_LOCAL_MACHINE\SAM.

Rapport delta de la ruche : le fichier Software.Dat.delta.txt généré enregistre toutes les clés de Registre et les valeurs ajoutées ou supprimées, et toutes les valeurs modifiées par l’utilisateur dans la ruche HKEY_LOCAL_MACHINE\Software.

Journal Personal vDisk : les fichiers journaux Pud-IvmSupervisor.log, PvDActivation.log, PvDSvc.log, PvDWMI.log, SysVol-IvmSupervisor.log et vDeskService-<#>.log sont générés par défaut dans P:\Users\<compte utilisateur>\AppData\Local\Temp\PVDLOGS, mais sont déplacés vers l’emplacement sélectionné.

Journaux du système d’exploitation Windows :

  • EvtLog_App.xml et EvtLog_System.xml sont les journaux d’événements application et système au format XML du format Personal vDisk.
  • Setupapi.app.log et setuperr.log contiennent des messages de journal de msiexec.exe qui était exécuté pendant l’installation de Personal vDisk.
  • Setupapi.dev.log contient des messages de journal d’installation du périphérique.
  • Msinfo.txt contient la sortie de msinfo32.exe. Pour de plus amples informations, veuillez consulter la documentation Microsoft.

Rapport du système de fichiers : le fichier FileSystemReport.txt généré enregistre les modifications effectuées par l’utilisateur pour le système de fichiers dans les sections suivantes :

  • Fichiers déplacés : les fichiers dans Layer 0 qui ont été déplacés par l’utilisateur vers le vDisk. Les fichiers Layer 0 sont hérités de l’image principale par la machine à laquelle le Personal vDisk est connecté.
  • Fichiers supprimés : les fichiers dans Layer 0 qui ont été masqués par une action de l’utilisateur (par exemple, la suppression d’une application).
  • Fichiers ajoutés (MOF, INF, SYS) : les fichiers qui possèdent des extensions .mof, .inf ou .sys que l’utilisateur a ajouté au Personal vDisk (par exemple, lorsqu’ils installé une application telle que Visual Studio 2010 qui enregistre un fichier .mof pour la récupération automatique).
  • Fichiers ajoutés (autres) : autres fichiers que l’utilisateur a ajouté au vDisk (par exemple, lors de l’installation d’une application).
  • Fichiers de base modifiés mais pas déplacés : les fichiers dans Layer 0 que l’utilisateur a modifié mais que les pilotes Personal vDisk en mode Kernel n’ont pas capturé dans le vDisk.

Mises à jour d’image

Dans Studio, lorsque vous choisissez une machine PvD dans un catalogue de machines, l’onglet « PvD » offre un statut de surveillance lors des mises à jour de l’image, ainsi que l’heure de fin et de progression estimée. Les affichages possibles de l’état lors de la mise à jour d’une image sont : Prêt, Préparation, En attente, En échec et Demandée.

Une mise à jour d’image peut échouer pour d’autres raisons par manque d’espace ou un bureau ne trouve pas le PvD suffisamment rapidement. Lorsque Studio indique qu’une mise à jour d’image a échoué, un code d’erreur est fourni avec un texte descriptif pour faciliter la résolution des problèmes. Utilisez l’outil de contrôle de mise à jour d’image Personal vDisk ou le script personal-vdisk-poolstats.ps1 afin de contrôler la progression de la mise à jour de l’image et obtenir les codes d’erreur associés à l’échec.

Si une mise à jour d’image échoue, les fichiers journaux suivants peuvent fournir davantage d’informations sur la résolution de ce problème :

  • Journal du service PvD : C:\ProgramData\Citrix\personal vDisk\Logs\PvDSvc.log.txt
  • Journal d’activation PvD : P:\PVDLOGS\PvDActivation.log.txt

Le contenu le plus récent se trouve à la fin du fichier journal.

Messages d’erreur : version 7.6 et ultérieure

Les erreurs suivantes sont valides pour la version 7.6 de PvD et version ultérieure :

  • Une erreur interne s’est produite. Consultez les journaux Personal vDisk pour plus de détails. Code d’erreur %d (%s)

    Ceci est un passe-partout pour les erreurs n’appartenant à aucune catégorie, et il ne possède ainsi pas de valeur numérique. Toutes les erreurs inattendues qui se sont produites lors de la création de l’inventaire ou de la mise à jour de Personal vDisk sont indiquées par ce code d’erreur.

    • Collectez les journaux et contactez l’assistance Citrix.
    • Si cette erreur se produit lors de la mise à jour du catalogue, restaurez le catalogue vers la version précédente de l’image principale.
  • Il existe des erreurs de syntaxe dans les fichiers de règle. Consultez les journaux pour plus de détails.

    Code d’erreur 2. Le fichier de règle contient des erreurs de syntaxe. Les fichiers journaux Personal vDisk contiennent le nom du fichier de règles et le numéro de ligne sur laquelle l’erreur de syntaxe a été détectée. Corrigez l’erreur de syntaxe dans le fichier de règle, puis recommencez l’opération.

  • L’inventaire stocké dans le Personal vDisk correspondant à la version précédente de l’image principale est endommagé ou illisible.

    Code d’erreur 3. Le dernier inventaire est stocké dans « UserData.V2.vhd » dans « \ProgramData\CitrixPvD\Settings\Inventory\VER-LAST ». Restaurez l’inventaire correspondant à la dernière version de l’image principale en important le dossier « VER-LAST » à partir d’une machine PvD en cours d’exécution connue associée à la version précédente de l’image principale.

  • L’inventaire stocké dans le Personal vDisk correspondant à la version précédente de l’image principale est une version supérieure.

    Code d’erreur 4. Ceci est dû à une incompatibilité de version de Personal vDisk entre la dernière image principale et l’image principale courante. Réessayez d’effectuer la mise à jour du catalogue après l’installation de la dernière version de Personal vDisk dans l’image principale.

  • Un dépassement de capacité du journal des modifications de a été détecté.

    Code d’erreur 5. Un dépassement de capacité du journal USN a été causé par un nombre important de modifications apportées à l’image principale lors de la création de l’inventaire. Si ce problème persiste après plusieurs tentatives, utilisez procmon pour déterminer si un logiciel tiers tente de créer ou de supprimer un grand nombre de fichiers pendant la création de l’inventaire.

  • Personal vDisk n’a pas pu détecter un disque connecté au système pour le stockage des données de l’utilisateur.

    Code d’erreur 6. Vérifiez, tout d’abord, que le disque PvD est connecté à la VM au travers de la console de l’hyperviseur. Cette erreur se produit généralement à cause d’un logiciel de « prévention des fuites de données » empêchant l’accès au disque PvD. Si le disque PvD est connecté à la VM, essayez d’ajouter une exception pour « disque connecté » dans la configuration du logiciel de « prévention des fuites de données ».

  • Le système n’a pas été redémarré après l’installation. Effectuez le redémarrage pour appliquer les modifications.

    Code d’erreur 7. Redémarrez le bureau et recommencez l’opération.

  • Installation altérée. Essayez de réinstaller Personal vDisk.

    Code d’erreur 8. Installez Personal vDisk et réessayez.

  • L’inventaire Personal vDisk n’est pas à jour. Mettez à jour l’inventaire de l’image principale, puis réessayez.

    Code d’erreur 9. L’inventaire Personal vDisk n’a pas été mis à jour dans l’image principale avant fermeture du bureau. Redémarrez l’image principale et arrêter le bureau au moyen de l’option « Mettre Personal vDisk à jour », puis créez un nouvel instantané ; utilisez cet instantané pour mettre le catalogue à jour.

  • Une erreur interne s’est produite lors du démarrage du Personal vDisk. Consultez les journaux Personal vDisk pour plus de détails.

    Code d’erreur 10. Cela peut être causé par le pilote de PvD qui ne peut pas démarrer une session de virtualisation en raison d’une erreur interne ou d’une altération de Personal vDisk. Essayez de redémarrer le bureau via le Controller. Si le problème persiste, collectez les journaux et contactez l’assistance Citrix.

  • Le délai de Personal vDisk a expiré lors de la recherche d’un disque de stockage pour les paramètres de personnalisation des utilisateurs.

    Code d’erreur 11. Cette erreur se produit lorsque le pilote PvD ne parvient pas à détecter le disque PvD dans les 30 secondes suivant le redémarrage. Ceci est généralement dû à un contrôleur SCSI non pris en charge ou une latence de stockage. Si ce problème se produit avec tous les bureaux du catalogue, modifiez le type de contrôleur SCSI associé à la « VM modèle »/« VM principale pour un type pris en charge par la technologie Personal vDisk. Si ce problème se produit uniquement avec certains bureaux du catalogue, il peut être dû à des pics de latence de stockage dus à un nombre important de bureaux démarrant en même temps. Essayez de limiter le paramètre des actions d’alimentation actives maximales associées à la connexion hôte.

  • Le Personal vDisk a été désactivé car un arrêt du système non sécurisé a été détecté. Redémarrez la machine.

    Code d’erreur 12. Cela peut être dû au fait que le bureau n’est pas parvenu à terminer le processus de redémarrage avec PvD activé. Essayez de redémarrer le bureau. Si le problème persiste, observez le démarrage du bureau via la console de l’hyperviseur et vérifiez si le bureau est bloqué. Si un bureau se bloque lors du démarrage, restaurez le PvD à partir d’une sauvegarde (si vous en possédez une) ou réinitialisez le PvD.

  • La lettre de lecteur spécifiée pour le montage du Personal vDisk n’est pas disponible.

    Code d’erreur 13. Cela peut être dû au fait que le PvD n’est pas parvenu à monter le disque PvD lors du montage spécifié par l’administrateur. Le montage du disque PvD échouera si la lettre de lecteur est déjà utilisée par d’autres matériels. Sélectionnez une lettre différente comme point de montage pour le Personal vDisk.

  • Les pilotes en mode noyau de Personal vDisk n’ont pas réussi à s’installer.

    Code d’erreur 14. Personal vDisk installe des pilotes lors de la première mise à jour de l’inventaire après l’installation. Certains produits anti-virus empêchent l’installation de ce pilote en dehors du contexte d’un programme d’installation. Désactivez temporairement l’analyse antivirus en temps réel ou ajoutez des exceptions dans l’antivirus pour les pilotes PvD lors de la première création d’inventaire.

  • Impossible de créer un instantané du volume système. Vérifiez que le service de cliché instantané des volumes est activé.

    Code d’erreur 15. Cela peut se produire si le service de cliché instantané des volumes est désactivé. Activez le service de cliché instantané des volumes et réessayez d’effectuer un inventaire.

  • L’activation du journal des modifications a échoué. Réessayez après une attente de quelques minutes.

    Code d’erreur 16. Personal vDisk utilise le journal des modifications pour le suivi des modifications apportées à l’image principale. Au cours de la mise à jour d’un inventaire, si le PvD détecte que le journal des modifications est désactivé, il tente de l’activer, cette erreur se produit lorsque cette tentative échoue. Patientez quelques minutes, puis réessayez.

  • Il n’y a pas suffisamment d’espace disponible sur le volume système.

    Code d’erreur 17. Il n’y a pas suffisamment d’espace disponible sur le lecteur C du bureau pour l’opération de mise à jour de l’image. Développez le volume système ou supprimez des fichiers non utilisés pour libérer de l’espace dans le volume système. La mise à jour d’image doit commencer après le redémarrage suivant.

  • Il n’y a pas suffisamment d’espace disponible dans le stockage Personal vDisk. Développez le stockage Personal vDisk pour fournir plus d’espace.

    Code d’erreur 18. Il n’y a pas suffisamment d’espace disponible sur le lecteur Personal vDisk lors de la réalisation d’une opération de mise à jour de l’image. Développez le stockage Personal vDisk ou supprimez des fichiers non utilisés pour libérer de l’espace dans le stockage Personal vDisk. La mise à jour d’image devrait redémarrer après le redémarrage suivant.

  • Le stockage Personal vDisk est trop engagé. Développez le stockage Personal vDisk pour fournir plus d’espace.

    Code d’erreur 19. Il n’y a pas suffisamment d’espace disponible sur le lecteur Personal vDisk pour accueillir complètement un « UserData.V2.vhd » provisionné. Développez le stockage Personal vDisk ou supprimez des fichiers non utilisés pour libérer de l’espace dans le stockage Personal vDisk.

  • Registre système endommagé.

    Code d’erreur 20. Le Registre système est altéré, endommagé, manquant ou illisible. Réinitialisez le Personal vDisk ou effectuez sa restauration à partir d’une sauvegarde antérieure.

  • Une erreur interne s’est produite lors de la réinitialisation de Personal vDisk. Vérifiez les journaux Personal vDisk pour plus de détails.

    Code d’erreur 21. Ceci est un passe-partout pour toutes les erreurs rencontrées lors de la réinitialisation d’un Personal vDisk. Collectez les journaux et contactez l’assistance Citrix.

  • Échec de réinitialisation de Personal vDisk, car il n’y a pas suffisamment d’espace disponible dans le stockage Personal vDisk.

    Code d’erreur 22. Il n’y a pas suffisamment d’espace disponible sur le lecteur Personal vDisk lors de la réalisation d’une opération de réinitialisation. Développez le stockage Personal vDisk ou supprimez des fichiers non utilisés pour libérer de l’espace dans le stockage Personal vDisk.

Messages d’erreur : versions antérieures à 7.6

Les erreurs suivantes sont valides pour les versions PvD 7.x antérieures à 7.6 :

  • Échec de démarrage. Personal vDisk n’a pas pu détecter de disque de stockage pour les paramètres de personnalisation des utilisateurs.

    Le logiciel PvD n’a pas réussi à trouver le Personal vDisk (par défaut le lecteur P:) ou n’a pas pu le monter en tant que point de montage sélectionné par l’administrateur lors de la création du catalogue.

    • Cherchez l’entrée suivante dans le journal du service PvD : « PvD 1 status –> 18:183 ».
    • Si vous utilisez une version de PvD antérieure à la version 5.6.12, la mise à niveau vers la dernière version résout ce problème.
    • Si vous utilisez la version 5.6.12 ou supérieure, utilisez l’outil de gestion du disque (diskmgmt.msc) pour déterminer si le lecteur P: est présent en tant que volume non monté. S’il est présent, exécutez chkdsk sur le volume pour déterminer s’il est endommagé, et essayez de le réparer à l’aide de chkdsk.
  • Échec de démarrage. Échec de démarrage de Citrix Personal vDisk. Pour obtenir de l’aide… Code d’état : 7, code d’erreur : 0x70

    Le code d’état 7 implique qu’une erreur s’est produite lors de la tentative de mise à jour du PvD. Le code d’erreur peut être l’un des suivants :

    Code d’erreur Description
    0x20000001 Impossible d’enregistrer le package de différentiel, probablement à cause d’un espace insuffisant dans le VHD.
    0x20000004 Impossible d’obtenir les privilèges requis pour la mise à jour du PvD.
    0x20000006 Impossible de charger la ruche depuis l’image PvD où l’inventaire PvD, probablement en raison d’une image ou d’un inventaire PvD endommagé.
    0x20000007 Impossible de charger l’inventaire du système de fichiers, probablement en raison d’une image ou d’un inventaire PvD altéré.
    0x20000009 Impossible d’ouvrir le fichier contenant l’inventaire du système de fichiers, probablement en raison d’une image ou d’un inventaire PvD altéré.
    0x2000000B Impossible d’enregistrer le package de différentiel, probablement à cause d’un espace insuffisant dans le VHD.
    0x20000010 Impossible de charger le package de différentiel.
    0x20000011 Fichiers de règles manquants.
    0x20000021 Inventaire PvD endommagé.
    0x20000027 Le catalogue « MojoControl.dat » est altéré.
    0x2000002B Inventaire PvD endommagé ou manquant.
    0x2000002F Impossible d’enregistrer le fichier MOF installé par l’utilisateur sur la mise à jour de l’image, mettez à niveau vers 5.6.12 pour résoudre le problème.
    0x20000032 Consultez le fichier PvDactivation.log.txt pour rechercher la dernière entrée de journal avec un code d’erreur Win32.
    0x20 Impossible de monter le conteneur d’application pour une mise à jour d’image, mettez à niveau vers 5.6.12 pour résoudre le problème.
    0x70 Espace insuffisant sur le disque.
  • Échec de démarrage. Citrix Personal vDisk n’est pas parvenu à démarrer [ou Personal vDisk a rencontré une erreur interne]. Pour obtenir de l’aide… Code d’état : 20, code d’erreur : 0x20000028

    Les Personal vDisk ont été détecté mais aucune session PvD n’a pu être créée.

    Collectez les journaux et vérifiez SysVol-IvmSupervisor.log pour des échecs de création de session :

    1. Recherchez l’entrée suivante dans le journal : « IvmpNativeSessionCreate: failed to create native session, status XXXXX ».
    2. Si l’état est 0xc00002cf, vous pouvez résoudre le problème en ajoutant une nouvelle version de l’image principale au catalogue. Le code d’état implique une saturation du journal USN en raison d’un grand nombre de changements apportés après la mise à jour d’un inventaire.
    3. Redémarrez le bureau virtuel affecté. Si le problème persiste, contactez le support technique Citrix.
  • Échec de démarrage. Citrix Personal vDisk a été désactivé car un arrêt du système non sécurisé a été détecté. Pour réessayer, sélectionnez Réessayez. Si le problème persiste, contactez votre administrateur système.

    La VM groupée ne peut pas terminer son démarrage avec le PvD activé. Déterminez tout d’abord la raison pour laquelle le démarrage ne peut pas être effectué. Les raisons possibles peuvent être l’apparition d’un écran bleu car :

    • Un produit anti-virus incompatible est présent sur l’image principale, par exemple des versions anciennes de Trend Micro.
    • L’utilisateur a installé un logiciel incompatible avec PvD. Cela est fort peu probable, mais vous pouvez le vérifier en ajoutant une nouvelle machine au catalogue et voir si elle redémarre correctement.
    • L’image PvD est endommagée. Cela a été rencontré dans la version 5.6.5.

    Pour vérifier que la VM affiche un écran bleu ou qu’elle redémarre prématurément :

    • Ouvrez une session sur la machine via la console de l’hyperviseur.
    • Cliquez sur Try Again et attendez que la machine s’arrête.
    • Démarrez la machine via Studio.
    • Utilisez la console de l’hyperviseur pour observer la console de machine lorsqu’elle démarre.

    Autres résolutions de problèmes :

    • Collectez l’image mémoire de la machine affichant l’écran bleu et envoyez-la à l’assistance technique de Citrix pour une analyse plus approfondie.
    • Vérifiez les erreurs dans les journaux d’événements associés au PvD :
      1. Montez UserData.V2.vhd à partir de la racine du lecteur P: à l’aide de DiskMgmt.msc en cliquant sur Action > Attach VHD.
      2. Lancez Eventvwr.msc.
      3. Ouvrez le journal d’événements système (Windows\System32\winevt\logs\system.evtx) depuis UserData.V2.vhd en cliquant sur Action > Open saved logs.
      4. Ouvrez le journal d’événements d’applications (Windows\System32\winevt\logs\application.evtx) depuis UserData.V2.vhd en cliquant sur Action > Open saved logs.
  • Le Personal vDisk ne peut pas démarrer. Le Personal vDisk n’a pas pu démarrer car l’inventaire n’a pas été mis à jour. Mettez l’inventaire à jour dans l’image principale, puis réessayez. Code d’état : 15, code d’erreur : 0x0

    L’administrateur a sélectionné un instantané incorrect lors de la création ou de la mise à jour du catalogue PvD (en d’autres termes, l’image principale n’a pas été arrêtée à l’aide de l’option Update Personal vDisk lors de la création de l’instantané).

Événements consignés par Personal vDisk

Si Personal vDisk n’est pas activé, vous pouvez afficher les événements suivants dans l’Observateur d’événements de Windows. Sélectionnez le nœud Applications dans le panneau de gauche ; la Source des événements dans le panneau de droite est Citrix Personal vDisk. Si Personal vDisk est activé, aucun de ces événements n’est affiché.

Un ID d’événement de 1 signifie un message d’information et un ID de 2 signifie une erreur. Les événements ne peuvent pas tous être utilisés dans chaque version de Personal vDisk.

ID d’événement Description
1 État de Personal vDisk : inventaire de mise à jour démarré.
1 État de Personal vDisk : inventaire de mise à jour terminé. GUID : %s.
1 État de Personal vDisk : mise à jour de l’image démarrée.
1 État de Personal vDisk : mise à jour de l’image terminée.
1 Réinitialisation en cours.
1 OK.
2 État de Personal vDisk : échec de l’inventaire de mise à jour avec : %s.
2 État de Personal vDisk : échec de mise à jour de l’image avec : %s.
2 État de Personal vDisk : échec de mise à jour de l’image avec erreur interne.
2 État de Personal vDisk : échec de l’inventaire de mise à jour avec : erreur interne.
2 Personal vDisk a été désactivé suite à un arrêt incorrect.
2 Échec de la mise à jour de l’image. Code d’erreur %d.
2 Personal vDisk a rencontré une erreur interne. Code d’état [%d] Code d’erreur [0x%X].
2 Échec de réinitialisation de Personal vDisk.
2 Détection du disque utilisé pour stocker les paramètres de personnalisation utilisateur impossible.
2 Espace disponible sur le disque de stockage insuffisant pour créer un conteneur Personal vDisk.
Affichages, messages et résolution des problèmes