Virtual Desktop Agent (VDA) Troubleshooting von Verbindungsproblemen und Funktionsprinzip

In diesem Artikel wird erklärt, wie man schnell die möglichen Registrierungsprobleme von Citrix Virtual Desktop Agenten (VDA) lokalisieren und lösen kann.

Die misslungene den Virtual Desktop Agent (VDA) an einem Desktop Delivery Controller (DDC) gehört sicherlich zu den häufigsten Problemen.

Bevor wir mit den Troubleshooting-Schritten anfangen, hier ist eine kurze Beschreibung wie die Registrierungsprozess funktioniert und wie Sie den Virtual Desktop Agent (VDA) konfigurieren können.

Virtual Desktop Agent (VDA) - Konfiguration

Es gibt insgesamt fünf Optionen, wie ein Delivery Contoller lokalisiert werden kann. Vier davon stehen bei der Installation des VDAs zu Wahl.

- Choose location from Active Directory
- Do it manually
- Let Machine Cteation Services do it automatically
- Automatisches Controller Update
- do it later (Advanced)

VDA Installation 01

1. Choose location from Active Directory

Diese Methode ist nur für Legacy Sites gedacht und funktioniert nicht mit Windows Server VDAs.

2. Do it manually

Bei einer manuellen Installation ist diese Methode sicher die bevorzugteste. In diesem Fall können Sie die Verbindung zu jeden Delivery Controller testen.

VDA Installation 02

Es ist wichtig zu merken, dass diese Information statisch ist. Die wird nicht geändert oder angepasst wenn z.B. ein weiterer Controller hinzugefügt wird oder der existierende gelöscht.
Der Installation-Wizard erzeugt in der Registry einen Schlüssel und ein String, wo die FQDN den DDCs in Klartest gespeichert wird:
HKLM\Software\Citrix\VirtualDesktopAgent\ListOfDDCs

VDA Installation 05

3. Let Machine Cteation Services do it automatically

Bei dieser Option sucht das System nach einer Konfigurationsdatei namens: Personality.ini Die Konfigurationsdatei wird im Root-Verzeichnis (c:\Personality.ini) gespeichert und soll sich auf jeder VM befinden.

Beispiel einer Personality-Datei:

[StringData]
$DiskMode=Shared
[VdaData]
ListOfDDCs=ctx-ddc01.demo.lab, ctx-ddc02.demo.lab

4. do it later (Advanced)

Bei dieser Option ist meistens die Verwendung von Gruppenrichtlinien gedacht. Sie können die Konfiguration sowohl die Citrix Rechtlinien verwenden, als auch selbsterstellte Rechtlinien

a) Citrix Richtlinien (Citrix Computer Policy). Die Citrix Richtlinien, die man in Citrix Studio konfigurieren kann, beinhalten diese Einstellungen nicht:

VDA Installation 03

Hier wird FQDN des DDCs eingetragen

VDA Installation 04

b) Die andere Option wäre die Richtlinien einzurichten, die die Registry-Werte eintragen:

Computerkonfiguration\Einstellungen\Windows-Einstellungen\Registrierung

VDA Installation 06

5. Automatische Controller Update

Die weitere Möglichkeit die Liste von Controller aktuell zu halten, ist die Citrix Policy Enable auto update of Controllers (Citrix Studio). Die Rechtlinie ist per default aktiv.

VDA Installation 07

Der VDA registriert sich automatisch. Die einzige Voraussetzung ist, dass der Agent sich mindestens ein Mal erfolgreich registriert hatte.  Die Information (die Liste off) werden bei jeder Registrierung am Controller aktualisiert und lokal auf dem Server gespeichert.

VDA Registrierungsschritte:

Der Registrierungsprozess eines VDA besteht aus acht Schritten:

1. Es wird nach Liste von DDSs gesucht. Auf dem Session Host laufender Dienst (Broker Agent)  sucht bzw. überprüft  die lokale Einstellungen, nämlich die Liste von DDCs. Zuerst wird nach Personality.ini -Datei gesucht, danach werden die ListoffDDC aus der Registry gelesen.
2. VDA kontaktiert die AD, um die DNS-Einstrage des DDCs zu überprüfen
3. VDA bekommt Kerberos Tickets auf Basis von SPNs
4. Nach Erhalt des Tickets wird ein zufälliger DDC kontaktiert (auf TCP Port 80)
5. Der DDC (Brocker Server) kontaktiert der Site-Datenbank, um zu überprüfen, ob der VDA zu Site gehört.
6. Nach einer Bestätigung, dass der VDA zu der Site gehört,  wird der Windows Domain Controller kontaktiert, um Kerberos Ticket des VDAs zu überprüfen.
7. Nach einer erfolgreichen Verifizierung des Kerberos Ticketes des VDAs, wird vom DDC ein weiteres Kerberos Ticket für die Rückkommunikation zum VDA angefragt.
8. Am Ende wird noch die Kommunikation zwischen den VDA und DDC überprüft (Callback). Die Registrierung ist damit abgeschlossen und der Server erscheint
in der Console mit den Status „registered“ registriert.

Rangfolge der Delivery Controller Suche:

  1. Auto-Update Method
  2. Policy-based Method (LGPO or GPO)
  3. Registry-based Method (Manual, GPP, specified during installation)
  4. AD-based Method (Legacy OU discovery)
  5. MCS-based Method (Personality.ini)

 

Virtual Desktop Agent (VDA) – Troubleshooting

Wenn ein Session Host (VDA) sich nicht am Desktop Delivery Controller registrieren kann, konnte es viele Gründe haben.  Man konnte die potentielle Probleme in drei Bereiche unterteilt werden:

- Netzwerk
- Active Directory
- XenApp – XenDesktop

Netzwerk. Die möglichen Netzwerkprobleme lassen sich ziemlich schnell lokalisieren.  Meistens handelt es sich um durch die Windows-, Netwerk-Firewall gesperrte Ports, die Belegung des Port 80 durch die andere Prozesse oder die nicht funktionierende DNS-Auflösung.

Active Directory. Die Domain Mitgliedschaft, Zeit Synchronisation oder die Probleme mit SPN (Service Principal names) sind die häufigste AD-Probleme.

XenApp – XenDesktop. Überprüfen Sie die Konfiguration des Session Host. Ist die Adresse bei der manuellen Konfiguration korrekt? Wurden die Rechtlinien gezogen?  Ist der Delivery Controller online?

 

Citrix Health Assistant

Sehr zu empfehlen den Einsatz vom Citrix Health Assistens. Das Tool ist kostenlos und bietet eine schnelle und einfache Problemerkennung in folgenden Bereichen:

1. VDA software installation
2. VDA machine domain membership verification
3. VDA communication ports availability
4. VDA services status
5. Windows firewall configuration
6. VDA communication with Delivery Controllers
7. VDA time sync with each Delivery Controller

Die Verwendung vom Citrix Health Assistant ist extrem einfach, auspacken und starten. Innerhalb weniger Sekunden ist der Scanvorgang abgeschlossen. Es wird auch eine Log-Datei erstellt, die die übersichtliche Information liefert.

1. Inhalte des Citrix Health Assistant.zip Files:

VDA Installation 08

2. "Start anaother VDA registration check" anklicken:

VDA Installation 09

3. Die Überprüfung ist abgeschlossen:

VDA Installation 10 

Die Inhalte des Log-Files:

2016-10-13 08:47:40,509: 1 INFO  –
2016-10-13 08:47:40,525: 1 INFO  – ***************
2016-10-13 08:47:40,525: 1 INFO  –
2016-10-13 08:47:40,525: 1 INFO  – Citrix Health Assistant v1.1.0.10
2016-10-13 08:47:40,525: 1 INFO  –
2016-10-13 08:47:40,525: 1 INFO  – ***************
2016-10-13 08:47:40,525: 1 INFO  –
2016-10-13 08:48:28,978: 4 INFO  –
2016-10-13 08:48:28,978: 4 INFO  – Start VDA Registration Check...
2016-10-13 08:48:28,978: 4 INFO  – >>>>Step 1: (VDA software installation)  Begin. <<<<
2016-10-13 08:48:29,305: 4 INFO  – VDA software installation verified.
2016-10-13 08:48:29,305: 4 INFO  – <<<< Step 1: VDA software installation End. Test Success. >>>>
2016-10-13 08:48:29,305: 4 INFO  – >>>>Step 2: (VDA machine domain membership)  Begin. <<<<
2016-10-13 08:48:29,571: 4 INFO  – Machine domain membership and DNS resolution verified. Retrieved machine SID succesfully.
2016-10-13 08:48:29,571: 4 INFO  – <<<< Step 2: VDA machine domain membership End. Test Success. >>>>
2016-10-13 08:48:29,571: 4 INFO  – >>>>Step 3: (VDA communication port availability)  Begin. <<<<
2016-10-13 08:48:29,788: 4 INFO  – Required port access verified.
2016-10-13 08:48:29,788: 4 INFO  – <<<< Step 3: VDA communication port availability End. Test Success. >>>>
2016-10-13 08:48:29,790: 4 INFO  – >>>>Step 4: (VDA services status)  Begin. <<<<
2016-10-13 08:48:29,862: 4 INFO  – All VDA related services are running
No VDA service errors were found in the event log during the last five minutes.
2016-10-13 08:48:29,862: 4 INFO  – <<<< Step 4: VDA services status End. Test Success. >>>>
2016-10-13 08:48:29,863: 4 INFO  – >>>>Step 5: (Windows firewall configuration)  Begin. <<<<
2016-10-13 08:48:29,922: 4 INFO  – The Windows Firewall Service allows communication between the VDA and the Controller.
2016-10-13 08:48:29,923: 4 INFO  – <<<< Step 5: Windows firewall configuration End. Test Success. >>>>
2016-10-13 08:48:29,923: 4 INFO  – >>>>Step 6: (Communication with DDC)  Begin. <<<<
2016-10-13 08:48:29,980: 4 INFO  – VDA and Controller communication verified.
2016-10-13 08:48:29,980: 4 INFO  – <<<< Step 6: Communication with DDC End. Test Success. >>>>
2016-10-13 08:48:29,981: 4 INFO  – >>>>Step 7: (Time sync with DDC)  Begin. <<<<
2016-10-13 08:48:30,116: 4 INFO  – The time difference between the Controller and VDA is less than five minutes.
2016-10-13 08:48:30,116: 4 INFO  – <<<< Step 7: Time sync with DDC End. Test Success. >>>>
2016-10-13 08:48:30,116: 4 INFO  – All tests passed. The VDA can communicate and register with the Controller.

Citrix Health Assistant - Troubleshoot VDA Registration and Session Launch können unter folgendem Link heruntergeladen: CTX207624

VDA Cleanup Utility

Manschmal empfehlt es sich den Agent zu deinstallieren, dafür wäre das Cleanup Utility die erste Wahl.

VDA Cleanup Utility können unter folgendem Link heruntergeladen: CTX209255

 

Sinnvolle Links zum Thema VDA-Troubleshooting

Troubleshooting Virtual Desktop Agent Registration with Controllers in XenDesktop | CTX126992

Virtual Delivery Agent (VDA) Registration Troubleshooting Tips and Flowchart | CTX136668

Citrix Port Check Utility | CTX122450

 

Wir nutzen Cookies auf unserer Website. Einige von ihnen sind essenziell für den Betrieb der Seite, während andere uns helfen, diese Website und die Nutzererfahrung zu verbessern (Tracking Cookies). Sie können selbst entscheiden, ob Sie die Cookies zulassen möchten. Bitte beachten Sie, dass bei einer Ablehnung womöglich nicht mehr alle Funktionalitäten der Seite zur Verfügung stehen.