Finding in the Wild | Citrix PVS – Datenbankverbindung bricht ab, weil die vDisk-Version 20 ist!

Manchmal sind es die unscheinbarsten Details, die eine ziemlich aufwendige Fehlersuche verursachen.

Es wurde mir über ein besonders kurioses Verhalten berichtet bei Citrix Provisioning Services (PVS):

⚠️ Das Fehlerbild

In der PVS-Umgebung kam es wiederholt zu kurzzeitigen Datenbankverbindungsabbrüchen.

Im Eventlog tauchten dabei regelmäßig folgende Ereignisse auf:

• Event ID 201 / 214 – PVS-Datenbankverbindungsprobleme
• SQL Error 8023 – Fehler bei der Verarbeitung eines übergebenen Wertes
• PVS verliert für wenige Sekunden die Datenbankverbindung und geht temporär offline.

Das Merkwürdige: Nicht alle Targets waren betroffen, sondern ausschließlich eine bestimmte Gruppe.

🔬 Die Ursache – von Citrix im Labor reproduziert

Nach intensiver Analyse konnte Citrix den Fehler mit den bereitgestellten Daten im Labor nachstellen.

Die Ursache liegt im Microsoft OLE DB Driver for SQL Server (MSOLEDBSQL), über den PVS mit seiner SQL-Datenbank kommuniziert.

Der entscheidende Auslöser?

Die vDisk-Versionsnummer 20!

Beim Starten und Stoppen eines PVS-Targets schreibt PVS einen Lizenz-Nutzungseintrag in die Datenbank. Dieser enthält auch die Versionsnummer der verwendeten vDisk.

Ist diese Versionsnummer exakt 20, übermittelt der Treiber den Wert fehlerhaft.

SQL Server lehnt die Verarbeitung mit Error 8023 ab.

PVS interpretiert diesen Fehler als Verlust der Datenbankverbindung und geht kurzzeitig offline.

In der untersuchten Umgebung war genau eine vDisk-Version 20 aktiv. Damit ließ sich auch erklären, warum ausschließlich die zugehörigen Targets betroffen waren.

🛠 Der Workaround

Die Lösung ist überraschend einfach:

✅ Keine vDisk-Version 20 produktiv verwenden.
✅ Eine neuere Version (21 oder höher) bereitstellen.
✅ Alternativ die vDisk-Versionen entsprechend mergen.
✅ Bei weiteren vDisks darauf achten, Version 20 nicht dauerhaft zu verwenden.

Wichtig: Das ist kein generelles SQL-Verbindungsproblem. Ein Neustart des SQL Servers oder eine Anpassung der Netzwerk-Timeouts beseitigt den eigentlichen Auslöser nicht.

📌 Herstellerstatus

Citrix hat das Verhalten im Labor reproduziert.

Ein dauerhafter Fix ist für ein späteres PVS-Release vorgesehen.

💡 Mein Fazit

Eine einzige Versionsnummer kann ausreichen, um PVS-Datenbankverbindungen kurzzeitig ausfallen zu lassen.

Wer bei PVS die Events 201/214 in Verbindung mit SQL Error 8023 sieht, sollte deshalb auch die verwendeten vDisk-Versionen prüfen.

Auf die Zahl 20 wäre ich als Erstes jedenfalls nicht gekommen. 😉

Finding in the Wild | SQL Server 2019 installiert – Citrix sagt trotzdem „SQL zu alt“

Beim Upgrade einer Citrix-Umgebung auf CVAD 2507 LTSR kann man über einen ziemlich unscheinbaren Stolperstein laufen.

Der SQL Server ist aktuell.
SQL Server 2019 wird verwendet.
Alles sieht sauber aus.
Und trotzdem scheitert das Citrix Site Upgrade aufgrund der SQL-Anforderungen.

Die Ursache kann in der Datenbank selbst liegen.
Ein SQL Server Upgrade hebt nämlich nicht automatisch den Compatibility Level bestehender Datenbanken an.

So kann die Umgebung beispielsweise aussehen:
SQL Server: 2019
Citrix Site DB: Compatibility Level 110
Citrix Monitoring DB: Compatibility Level 110
Citrix Logging DB: Compatibility Level 110

Und 110 bedeutet:
👉 SQL Server 2012

Der SQL Server lebt also 2019 – die Citrix-Datenbank denkt noch, wir hätten 2012. 😄

Schnell geprüft:
SELECT
name AS DatabaseName,
compatibility_level AS CompatibilityLevel
FROM sys.databases
ORDER BY name;

Die wichtigsten Levels:
110 = SQL Server 2012
120 = SQL Server 2014
130 = SQL Server 2016
140 = SQL Server 2017
150 = SQL Server 2019
160 = SQL Server 2022
170 = SQL Server 2025

Bei einem SQL Server 2019 kann der Compatibility Level beispielsweise angepasst werden mit:
ALTER DATABASE [CitrixSite]
SET COMPATIBILITY_LEVEL = 150;
GO

ALTER DATABASE [CitrixLogging]
SET COMPATIBILITY_LEVEL = 150;
GO

ALTER DATABASE [CitrixMonitoring]
SET COMPATIBILITY_LEVEL = 150;
GO

⚠️ Natürlich nicht einfach blind ausführen.

Vorher:
✅ Citrix-/SQL-Supportmatrix prüfen
✅ Datenbanken sichern
✅ tatsächliche DB-Namen kontrollieren
✅ Wartungsfenster verwenden
✅ anschließend Compatibility Level und Citrix Site testen

Und noch ein zweiter Punkt aus der Praxis:

Beim CVAD 2507 Site Upgrade sollte auch das verwendete SQL-/Upgrade-Konto geprüft werden. Fehlende Berechtigungen für notwendige Änderungen innerhalb der Citrix-Datenbanken können ebenfalls für interessante Fehlersuche sorgen.

Mein neuer Citrix Pre-Upgrade-Check
Vor einem größeren CVAD-Upgrade gehört deshalb für mich inzwischen neben Controller-, VDA-, StoreFront- und SQL-Version auch dieser kleine Query dazu:

SELECT name, compatibility_level
FROM sys.databases;

Dauert 10 Sekunden.

Kann einem aber eine ziemlich lange Fehlersuche während des Wartungsfensters ersparen.
Finding in the Wil
d. 🔎

Manchmal ist nicht der SQL Server zu alt.
Sondern nur die Datenbank, die vergessen hat, welches Jahr wir h
aben. 😄

Migration von Citrix Datenbanken

Mit der neuesten Citrix Virtual Apps & Desktops (CVAD) LTSR Version wurden ältere SQL-Server-Versionen abgekündigt. Wer seine Umgebung stabil und supportfähig halten möchte, kommt um eine Migration der Citrix-Datenbanken (Site, Logging, Monitoring) auf moderne SQL-Server (2019/2022) nicht herum. Ob Cluster, Always On oder Spiegelung – das Vorgehen bleibt im Kern gleich. In diesem Beitrag zeige ich Schritt für Schritt, wie die Migration sicher gelingt.

1. Voraussetzungen

  • Vollständige Backups aller Citrix-Datenbanken
  • Backups/VM-Snapshots der Delivery Controller (DDCs)
  • Neuer SQL Server (Cluster, Always On oder Mirror)
  • Gleiche SQL-Version auf Principal und Mirror
„Migration von Citrix Datenbanken“ weiterlesen

Upgrade auf Virtual Apps and Desktops Version 1912 LTSR

Am 18. Dezember 2019 ist Citrix Virtual Apps and Desktops (CVAD) Version 1912 erschienen. Folgend eine kleine Anleitung zum Update auf die neuste Version.

Link zur Citrix Virtual Apps and Desktops Dokumentation

Citrix Virtual Apps and Desktops EOM EOL Matrix
„Upgrade auf Virtual Apps and Desktops Version 1912 LTSR“ weiterlesen

Upgrade von Citrix Virtual Apps and Desktops Current Release

Am 29. September ist Citrix Virtual Apps and Desktops (CVAD) Version 2009 erschienen. Folgend eine kleine Anleitung zum Update auf die neuste Version.

Link zur Citrix Virtual Apps and Desktops Dokumentation

„Upgrade von Citrix Virtual Apps and Desktops Current Release“ weiterlesen