When it comes to managing a Citrix environment, there’s a lot to take into account. You’ve got to make sure your Citrix Virtual Apps & Desktops (XenApp & XenDesktop if you’ve been around that long) environment is properly licensed, that your NetScalers are doing their thing, and that, no matter what, your users are able to stay productive. But there are some errors that can get in the way of that.

En utilisant des données anonymes et des conversations avec nos milliers de clients, nous avons classé les 10 principales erreurs Citrix qu'ils rencontrent. Nous mettrons en évidence les erreurs elles-mêmes et leurs causes potentielles, et nous vous montrerons également comment ControlUp peut y remédier. 

En guise d'introduction, consultez la liste complète des Événements et codes d'erreur de Citrix Broker.

The Top 10 Citrix Errors, Ranked

  1. Service Citrix Broker - ID d'événement 1151
  2. Service Citrix Broker - ID de l'événement : 2013
  3. Service Citrix Broker - ID de l'événement : 1065
  4. Service de télémétrie Citrix - ID de l'événement : 1007
  5. Citrix Desktop Service - ID de l'événement : 1001
  6. Service Citrix Broker - ID de l'événement : 1201
  7. Citrix Store Services (StoreFront)-Event ID : 4003
  8. Citrix Remote Broker Provider - ID de l'événement : 514
  9. Le bureau n'est pas disponible - Impossible de démarrer le bureau
  10. Lenteur des connexions

 

Source : Citrix Broker Service-ID de l'événement : 1151  

Erreur du serveur de licence : "Le service Citrix Broker ne peut pas contacter le serveur de licences '%1'. Veuillez vous assurer que le serveur de licence fonctionne correctement et que les détails identifiant le serveur de licence sont corrects dans la configuration de XenDesktop".

Voir une erreur n'est jamais quelque chose de souhaitable, mais celle-ci peut être relativement inoffensive. Heureusement, Citrix a tenu compte d'un serveur de licences ou d'une interruption de service en prévoyant une période de grâce de 30 jours pour permettre aux contrôleurs de livraison de continuer à gérer avec succès les nouvelles sessions utilisateur, même si le service de licences ne fonctionne pas. Cela dit, il est toujours préférable d'assurer une résolution rapide afin de remettre le serveur de licences en état de fonctionnement.

Bien entendu, la première condition est d'être alerté lorsque le serveur de licences est indisponible. Comme nous l'avons dit, les utilisateurs finaux de Citrix Virtual Apps & Desktops ne rencontreront probablement aucun problème lié à cette erreur, et n'appelleront donc pas votre service d'assistance à ce sujet (Dieu merci pour les petites faveurs). Néanmoins, vous n'avez évidemment pas envie d'examiner les journaux d'événements toute la journée (personne n'a le temps pour ça).

Voici comment ControlUp peut vous aider.

XenDesktop configuration
Figure 1. Exemple de Scoutbees Scouts configurés pour tester certains services du serveur de licences Citrix.

 

Pour les alertes précoces, vous pouvez utiliser ControlUp Scoutbees pour tester rapidement et simplement la disponibilité de votre serveur de licences Citrix et de tous ses éléments importants. services d'octroi de licences; c'est simple et cela ne prend que quelques minutes à mettre en place.

Citrix License Server
Figure 2. Exemple de politique d'alerte en cas d'échec d'un test ou d'expiration imminente d'un certificat.

 

Vous pouvez configurer des alertes lorsque le serveur ou les services sont indisponibles ou répondent plus lentement que d'habitude. Si vous le souhaitez, vous pouvez aller encore plus loin dans la granularité, car la surveillance proactive de Scoutbees offre de nombreuses options différentes dans la fonction Politique d'alerte. Par exemple, vous pouvez effectuer un test HTTPS sur la console d'administration des licences et être alerté si / quand la page ne se charge pas et aussi quand le certificat est sur le point d'expirer. 

Citrix ControlUp
Figure 3. Exemple de métriques du serveur de licences Citrix dans Real-Time DX

 

Vous pouvez rapidement vérifier l'état du serveur de licences à l'aide de ControlUp for VDI. Vous pouvez ainsi voir si vous manquez de licences disponibles. Pour afficher ces mesures, il suffit d'installer l'agent ControlUp sur votre (vos) serveur(s) de licences Citrix.

ControlUp for VDI
Figure 4. Mise sous tension d'une VM avec ControlUp for VDI

 

Bien sûr, si votre serveur de licences Citrix est vraiment en panne et que vous voulez le remettre en marche rapidement, vous pouvez naviguer jusqu'au serveur dans votre console Real-Time DX et le remettre en marche soit par des actions de gestion de l'alimentation [en faisant un clic droit sur le serveur] ou, si vous êtes connecté dans Real-Time DX à votre hyperviseur (ControlUp supporte Citrix Hypervisor [XenServer si vous êtes de la vieille école], VMware vSphere, Nutanix Acropolis, et Microsoft Hyper-V), vous pouvez utiliser l'excellente fonction de gestion de l'alimentation de ControlUp, qui vous permet d'accéder à votre serveur de licences Citrix. Mise sous tension de la VM action de script.

Citrix Hypervisor XenServer
Figure 5. Démarrage des services de licences Citrix à partir des contrôleurs

 

Si votre serveur de licences semble être sous tension lorsque vous y êtes connecté, vous pouvez essayer de vous connecter à distance à la machine virtuelle à partir de la console ControlUp for VDI pour vous assurer qu'elle fonctionne et/ou choisir de gérer les services, en vous assurant que les services liés aux licences sont tous démarrés. Si ce n'est pas le cas, démarrez-les.

 

Source : Citrix Broker Service-ID de l'événement : 2013 

Une exception inattendue s'est produite lors du traitement d'une requête HTTP par le service Citrix Broker.

Cette erreur peut être causée par différents problèmes sous-jacents et les utilisateurs obtiendront une erreur générique "ne peut pas démarrer". 

Citrix Broker Service
Figure 6. Mesures de l'état de la base de données dans ControlUp for VDI

 

Les causes sous-jacentes potentielles de cette erreur comprennent des problèmes de connectivité de la base de données, entraînant un événement de basculement de la base de données, mais en raison d'une mauvaise configuration, un basculement réussi n'est pas possible. Dans certains cas, un redémarrage des contrôleurs de livraison peut aider à restaurer les services. Vous pouvez effectuer ces redémarrages à partir de la console en temps réel à l'aide d'actions. Si cela ne suffit pas, il est préférable de travailler avec le support Citrix et de coordonner une solution. Cela peut inclure la mise à jour d'un changement de configuration de la base de données.

Si vous êtes un administrateur Citrix depuis plus longtemps qu'une simple tasse de café, vous êtes familier avec la collecte de traces CDF à partager avec le support Citrix. Lorsque vous avez un problème difficile à reproduire et intermittent, il est difficile d'obtenir une trace CDF efficace, SAUF si vous utilisez la méthode suivante ControlUp Automate. Il s'agit d'un excellent blog qui explique comment ControlUp Automate aide à maximiser les ressourcesLe logiciel de gestion de l'information permet d'optimiser l'expérience de l'utilisateur final et de compléter les efforts de dépannage.

 

Source : Citrix Broker Service-ID de l'événement : 1065 

“The Citrix Broker Service failed to determine the base settings needed for virtual desktop agent of machine ‘%1′”

Citrix indique que vous pouvez tenter de redémarrer le VDA comme première mesure d'atténuation. Si cela ne résout pas le problème ou si le problème se manifeste plus fréquemment, vous devez rassembler les traces CDF et les partager avec l'assistance Citrix. Il vous conseillera peut-être de modifier les éléments suivants les paramètres du registre de vos contrôleurs de livraison:

HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxTimeBeforeStuckOnBootFaultSecs DWORD Value : 30000
HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxTimeBeforeUnregisteredFaultSecs DWORD Value : 30000

MaxTimeBeforeStuckOnBootFaultSecs :  Délai d'attente (en secondes) après le démarrage d'une machine qui n'a pas reçu de notification du HCL indiquant que les outils de la VM étaient en cours d'exécution. Après ce délai, l'état d'erreur d'une machine est réglé sur StuckOnBoot.
 
MaxTimeBeforeUnregisteredFaultSecs : Durée d'attente (en secondes) après le démarrage d'une machine qui n'est pas enregistrée auprès du courtier (avec ou sans tentative d'enregistrement). Après ce délai, l'état d'erreur d'une machine sera défini sur Non enregistré.

 

Citrix Delivery Controllers
Figure 7. Définition des valeurs de registre dans les contrôleurs

 

Vous pouvez rapidement et facilement définir les valeurs de registre pour tous vos contrôleurs de livraison en une seule fois en utilisant la fonction Contrôleurs de Real-Time DX. Il vous suffit d'aller dans Contrôleurs, de cliquer sur Registre et d'ajouter vos contrôleurs de livraison. Ensuite, il suffit de créer les valeurs de registre suggérées. 

Si l'extension du délai d'attente par le biais du registre permet d'atténuer les erreurs, il est toujours conseillé de travailler avec l'assistance Citrix et de lui permettre d'examiner certaines traces CDF afin de trouver la cause de la lenteur dans votre environnement. Là encore, vous pouvez utiliser ControlUp Automate pour exécuter ces traces CDF automatiquement pour vous.

ControlUp Scoutbees Response Trends
Figure 8. Tendances des réponses de Scoutbees

 

Une autre façon de résoudre ce problème est de mettre en place un Scoutbees Scout pour tester la performance du réseau vers vos Delivery Controllers en utilisant un Custom Hive sur le même sous-réseau IP que vos VDAs. C'est une excellente solution si le problème est intermittent. Cela vous permettra de repérer les tendances dans les performances au fil du temps et de localiser les dégradations au fil des heures, des jours, des semaines et des mois. Cela permet d'identifier la cause de la lenteur.

 

Source : Service de télémétrie de CitrixID de l'événement : 1007

“We cannot start the Citrix service that enables you to enroll in Call Home.”

Ce problème est relativement simple. Si vous utilisez la version 7.15 ou antérieure du DAVC, il se peut que vous ayez besoin d'une mise à jour cumulative plus récente pour résoudre le problème. Comme la version 7.15 n'est pas la version LTSR actuelle, je suppose que vous ne rencontrez pas l'erreur avec cette version. Si vous rencontrez cette erreur sur une version plus récente de Citrix Virtual Apps and Desktops, votre compte de service pour le Citrix Telemetry Service n'a probablement pas les permissions Logon-as-a-Service.

Citrix Virtual Apps and Desktops
Figure 9. Se connecter en tant que service Propriétés

 

Elle se trouve dans la stratégie de groupe, sous Configuration de l'ordinateur > Paramètres Windows > Paramètres de sécurité > Stratégies locales > Attribution des droits d'utilisateur.

CVAD
Figure 10. Services dans les contrôleurs

 

La fonction Contrôleurs (notre amie dans ControlUp for VDI) peut être utilisée pour afficher rapidement le service de télémétrie Citrix sur le VDA ou le contrôleur concerné afin de voir le compte utilisé pour exécuter le service. Vous pouvez alors vous assurer que le compte dispose de l'attribution des droits d'utilisateur pour l'ouverture de session en tant que service.

Citrix Telemetry Service
Figure 11. Action d'actualisation des politiques de la machine dans DX en temps réel

 

Lorsque cette option est activée, vous pouvez forcer une mise à jour de la stratégie de groupe à partir de Real-Time DX (comme indiqué ci-dessus).

Group Policy Citrix
Figure 12. Redémarrage d'un service dans les contrôleurs

 

Enfin, redémarrez le service à partir de la fonction Contrôleurs.

 

Source : Citrix Desktop Service-ID de l'événement : 1001 

“The Citrix Desktop Service failed to obtain a list of delivery controllers with which to register. Please ensure that the Active Directory configuration for the farm is correct, that this machine is in the appropriate Active Directory domain and that one or more delivery controllers have been fully initialized. Refer to Citrix Knowledge Base article CTX117248 for further information.”

Selon Citrix, cette erreur se produit lorsque le VDA ne peut pas accéder à un contrôleur de domaine sur le port 3268 (Microsoft Global Catalog). Le VDA doit communiquer avec le DC pendant le processus d'enregistrement pour valider sa liste de contrôleurs configurés. Il peut être intéressant de vérifier la liste des DDCs dans le registre de votre VDA (HKLM\Software\Citrix\VirtualDesktopAgent\ListOfDDCs). Si vous avez besoin de définir la liste des CDD par stratégie, consultez le document suivant ce guide.

 

Domain Controllers Citrix
Figure 13. Paramètres des scouts Scoutbees

 

ControlUp Scoutbees peut effectuer des tests sur n'importe quel contrôleur de domaine du réseau d'entreprise via le port 3286 et alerter si/quand le service est indisponible. Il peut également détecter une dégradation des performances qui pourrait indiquer que le service est sur le point de devenir indisponible, ce qui vous permet d'être proactif et de résoudre le problème avant qu'il n'entraîne une interruption du service. Pour une équipe qui n'a pas nécessairement de visibilité sur la maintenance des contrôleurs de domaine, mais qui gère et soutient Citrix, il serait bon de disposer d'un enregistrement clair des tendances en matière de disponibilité.

ControlUp Script Action
Figure 14. Action du script d'affichage de la connexion réseau

 

Pour obtenir une aide au dépannage ponctuel, vous pouvez utiliser la fonction Afficher les connexions réseau pour répertorier les connexions actuelles d'un VDA Citrix sélectionné afin de voir les connexions réseau actives du VDA. Si vous voyez une connexion à un contrôleur de domaine valide sur le port 3286, il n'y a pas de problème pour l'instant. S'il n'y a pas de connexion active, cela indique clairement qu'il y a un problème. Vous pouvez également créer votre propre SBA pour exécuter un simple BAT / CMD de netstat -na pour obtenir une liste brute et non triée des connexions réseau selon la norme CTX133769 but we think Guy’s script is a much cooler experience. 😎

 

Source : Citrix Broker Service-ID de l'événement : 1201 

“The connection between the Citrix Broker Service and the database has been lost.”

Celui-ci est un peu différent car il s'agit d'un avertissement plutôt que d'une erreur, MAIS il pourrait bien s'agir d'une cause légitime d'inquiétude. Dans Citrix XenApp et XenDesktop version v7.12, l'option Cache de l'hôte local a été réintroduite. C'est une bonne idée d'utiliser cette fonction car, en cas de rupture de connexion entre les Delivery Controllers et votre base de données, elle permet de s'assurer que les sessions des utilisateurs ne seront pas interrompues. Il utilise une base de données mise en cache sur le Delivery Controller principal et poursuit son chemin jusqu'à ce qu'il soit en mesure de rétablir la connexion (ce que vous pouvez généralement voir avec l'événement 1200). 

Il existe un cas particulier où cet avertissement est particulièrement gênant. Lorsque la connexion à la base de données commence à battre de l'aile, c'est-à-dire que la connexion s'interrompt, puis s'établit à nouveau, puis s'interrompt et s'établit, s'interrompt, s'établit, et ainsi de suite, encore et encore, dans une boucle virtualisée exaspérante. Le problème est que la connexion peut ne jamais être interrompue assez longtemps pour que le mode Local Host Cache prenne le relais, ce qui peut gêner les utilisateurs qui tentent de lancer des applications et des bureaux pendant que la connexion est interrompue.

XenApp XenDesktop
Figure 15. Visualisation des mesures de la base de données en temps réel DX

 

Once again, ControlUp pour VDI to the rescue! No need to go digging through event logs; you can see the database connectivity status for your Delivery Controllers like in the screenshot above.

Citrix Database
Figure 16. Paramètres du scout Scoutbees

 

L'utilisation de Scoutbees pour tester votre base de données Citrix sur le port que vous utilisez pour votre connexion à la base de données peut être utile pour déterminer quand la base de données devient indisponible (si elle le devient réellement). 

Un exemple concret de cette situation est celui d'un client chez qui ce flapping se produisait lorsque la VM de la base de données était sauvegardée à l'aide d'un produit tiers. L'équipe Citrix n'avait pas de visibilité sur cet outil et son calendrier, mais elle a pu localiser les occurrences à quelques heures près les jours où elles se produisaient, ce qui a permis de découvrir la cause première. 

C'est également un cas où notre exemple précédent d'exécution d'une trace CDF peut s'avérer utile. Vous pouvez également ajouter un script pour modifier la valeur de registre sur votre contrôleur de livraison principal afin de forcer l'utilisation du cache de l'hôte local après une validation rapide de l'état de santé du cache.

 

Source : Citrix Store Services (StoreFront)-ID de l'événement : 4003

“All the Citrix XML Services configured for farm SMSTORE failed to respond to this XML Service transaction.”

Cette erreur peut avoir plusieurs causes : un pare-feu qui bloque le trafic, un délai d'attente atteint ou le port utilisé par le service XML qui devient indisponible. Ce problème n'est pas propre à Citrix ou à ce service particulier ; il peut se produire dans n'importe quel processus. Il est possible que vous ayez corrigé les serveurs Storefront, qu'une mise à jour ait attribué le port à un autre processus et qu'au redémarrage, ce dernier ait pris le contrôle du port.

Notre ami l'action Show network connection script peut vous aider. Elle peut vous aider à identifier ce qui a interrompu le port XML et vous permettre de modifier ou de désactiver ce service pour remettre Storefront en état de marche.

Citrix Storefront
Figure 17. Afficher la connexion réseau Actions du script

 

Source Citrix Remote Broker Provider-ID de l'événement : 514 

“A Connectivity Check has Failed”

Celle-ci peut être simple ! L'erreur indique un problème possible de connectivité réseau sur votre connecteur Citrix Cloud pour Citrix Cloud.

Citrix Cloud
Figure 18. Paramètres des connecteurs cloud dans ControlUp Solve

 

Si vous a ajouté Citrix Cloud en tant que ressource surveillée Dans ControlUp for VDI, vous pouvez rapidement vérifier la santé et l'état de vos Citrix Cloud Connectors, y compris si le Cloud Connector est sur la dernière version ou non. Plus important encore, vous pouvez vérifier les mesures du réseau pour voir s'il y a une indication d'un problème de réseau.

Citrix Cloud Connectors
Figure 19. Services dans les contrôleurs

 

Vous pouvez vous assurer que les bons services Citrix sont tous en cours d'exécution et, si ce n'est pas le cas, les démarrer rapidement à l'aide des contrôleurs.

 

Général : Bureau non disponible

“Cannot Start Desktop”

Si vous disposez d'un nombre limité de postes de travail disponibles ou de postes de travail persistants 1:1 pour vos employés ou peut-être et qu'un (ou plusieurs) de ces postes de travail n'est pas enregistré, vous pouvez vous retrouver dans la situation malheureuse où votre service d'assistance vous appelle tôt le matin pour vous dire que les gens ne peuvent pas travailler parce que leurs postes de travail ne veulent pas être lancés. Il n'y a pas assez de café dans le monde pour vous permettre de tenir le coup.

Citrix Desktop Service
Figure 20. Action de script de redémarrage du service Citrix Desktop

 

Nous disposons d'un script que vous pouvez utiliser pour redémarrer le Citrix Desktop Service à distance, en le couplant à un déclencheur basé sur le fait que le VDA est allumé, qu'il n'est pas en mode maintenance et qu'il n'est pas enregistré pendant plusieurs minutes. Cela forcera le service à redémarrer, ce qui forcera le VDA à se réenregistrer.

Citrix Virtual Desktop
Figure 21. Exemple de déclenchement ControlUp

 

Nous disposons également d'un déclencheur communautaire qui peut être utilisé pour trouver les ordinateurs de bureau non enregistrés et les redémarrer s'ils sont dans cet état depuis au moins cinq minutes. Si le problème à l'origine de la désinscription ou de l'échec de l'enregistrement des ordinateurs de bureau au redémarrage était un problème environnemental ponctuel, un redémarrage du service ou un redémarrage peut probablement résoudre le problème. Étant donné que les déclencheurs garantissent qu'il n'y a aucune session d'utilisateur sur les machines à ce moment-là, cela ne perturbera pas vos utilisateurs.

 

Général : Lenteur des connexions !

Finally, we have the classic slow logons. There are so many different variables to account for when it comes to a slow logon. Luckily, we have you covered! ControlUp examines more than 40 different phases and factors of logon duration, including the execution of some third-party products common in the Enterprise, like those from Ivanti and VMware (to name just a couple).

 

Il est évident qu'en utilisant le Analyse de la durée de connexion L'action script retournera des données importantes et vous permettra de localiser l'origine des problèmes. Mais cela vous permet également de poursuivre de manière proactive les connexions lentes dans votre organisation sans avoir à vérifier constamment les rapports et les métriques de la console.

ServiceNow Analyze Logon Duration
Figure 23. Signaler une connexion lente à ServiceNow ITSM Script Action

 

Pour ce faire, nous disposons d'un autre excellent script d'action (avons-nous mentionné que la bibliothèque de scripts de ControlUp compte 363 actions de scripts (et ce n'est pas fini !) créées par la communauté ?) Si vous utilisez ServiceNow, vous pouvez utiliser notre action de script Signaler une connexion lente au script ITSM de ServiceNow pour signaler les connexions qui dépassent la moyenne attendue afin d'effectuer des recherches plus approfondies, par exemple en décomposant les phases de connexion à l'aide du script Analyser les longues durées. Ne laissez pas les connexions lentes frustrer vos employés, maîtrisez-les (les connexions lentes, pas vos employés ; ce serait une violation des droits de l'homme) grâce à nos scripts géniaux !

Voici les 10 principales erreurs Citrix rencontrées par les clients de ControlUp. Nous espérons que cette répartition vous aidera à trouver des solutions à chacune d'entre elles, et qu'elle vous montrera comment vous pouvez utiliser ControlUp pour détecter ces erreurs dès qu'elles se produisent, les corriger rapidement et, dans de nombreux cas, les faire corriger automatiquement.

Analyze Logon Duration blog series banner