Verwenden des lokalen Host-Cache für unterbrechungsfreie Datenbank-Upgrades

Mit der Funktion Local Host Cache (LHC) können Verbindungsvermittlungsvorgänge auf einer Citrix Virtual Apps and Desktops-Site fortgesetzt werden, wenn ein Ausfall auftritt.
Das folgende Verfahren zeigt, wie LHC verwendet werden kann, um ein unterbrechungsfreies Upgrade der Site durchzuführen, wenn keine sekundären Zonen vorhanden sind.

Bevor Sie fortfahren, wird empfohlen, die Funktion Local Host Cache, ihre Anforderungen und Einschränkungen zu überprüfen: https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/manage-deployment/local-host-cache.html

Es gibt auch einen Tech Zone-Leitfaden zur Größe und Skalierung des lokalen Hostcaches, den Sie hier finden: https://docs.citrix.com/en-us/tech-zone/design/design-decisions/local-host-cache-sizing-scaling.html

Haftungsausschluss: Führen Sie diese Schritte in einer Testumgebung durch, bevor Sie sie in einer Live-Produktionsumgebung implementieren, um sicherzustellen, dass Sie mit dem Prozess vertraut sind und auf alle umgebungsspezifischen Probleme oder Fragen vorbereitet sind, die auftreten. Es wird auch empfohlen, das neueste verfügbare LTSR Cumulative Update (CU) zu verwenden, da es mehrere Korrekturen im Zusammenhang mit LHC gibt, von denen Ihre Umgebung profitieren kann.

Übersicht

  1. Konfigurieren Sie die Umgebung für dieses Verfahren.
  2. Ermitteln Sie den primären Broker.
  3. Erzwingen Sie einen Ausfall, um die Local Host Cache-Funktion auszulösen.
  4. Erlauben Sie VDAs, sich erneut bei den ausgewählten Sekundärbrokern zu registrieren.
  5. Führen Sie das Produktupgrade auf einem nicht ausgewählten sekundären Broker durch.
  6. Führen Sie das obligatorische Site-Upgrade einschließlich Datenbank-Upgrade durch.
  7. Führen Sie Produktupgrades bei allen verbleibenden nicht gewählten Sekundärbrokern durch.
  8. Beenden Sie den Ausfall und den Local Host Cache-Modus.
  9. Erlauben Sie VDAs, sich erneut bei neu aktualisierten Delivery Controllern zu registrieren.
  10. Führen Sie ein Produkt-Upgrade auf dem letzten verbleibenden Delivery Controller durch (zuvor gewählter sekundärer Broker).
  11. Setzen Sie die Umgebung auf die Standardkonfiguration zurück.

Prozedur

  1. Überprüfen Sie mit dem folgenden PowerShell-Cmdlet, ob der lokale Hostcache aktiviert ist.

    Get-BrokerSite

    Suchen Sie nach LocalHostCacheEnabled : True

    Befehl BrokerSite abrufen

    Falls falsch, aktivieren Sie den lokalen Hostcache.

    Set-BrokerSite -LocalHostCacheEnabled $true -ConnectionLeasingEnabled $false

    Dieses Cmdlet deaktiviert außerdem das Verbindungsleasing. Aktivieren Sie den lokalen Hostcache und das Verbindungsleasing nicht gleichzeitig.

  2. Standardmäßig werden energieverwaltete Desktop-VDAs in gepoolten Bereitstellungsgruppen, für die die Eigenschaft “ShutdownDesktopsAfterUse” aktiviert ist, bei einem Ausfall in den Wartungsmodus versetzt. Um das Standardverhalten außer Kraft zu setzen, müssen Sie es Site-übergreifend für jede betroffene Bereitstellungsgruppe aktivieren. Führen Sie folgende PowerShell-Cmdlets aus:

    Set-BrokerSite -ReuseMachinesWithoutShutdownInOutageAllowed $true

    Set-BrokerDesktopGroup -Name "<Delivery Group Name>"- ReuseMachinesWithoutShutdownInOutage $true

  3. Wenn der Brokerdienst für die Verwendung benutzerdefinierter VDA-, StoreFront- oder StoreFront-TLS-Ports konfiguriert wurde, führen Sie die folgenden Schritte aus, um sicherzustellen, dass der Hochverfügbarkeitsdienst (HA) auch mit den richtigen benutzerdefinierten Ports konfiguriert ist.
    • Überprüfen Sie die aktuellen Broker Service-Porteinstellungen für jeden Broker, indem Sie den folgenden Befehl ausgeben: %programfiles%\Citrix\Broker\Service\BrokerService.exe -show Broker Service image

    • Überprüfen Sie die aktuellen HA-Dienst-Porteinstellungen für jeden Broker, indem Sie den folgenden Befehl ausführen: %programfiles%\Citrix\Broker\Service\HighAvailabilityService.exe -show HA service image

    • Wenn die für den HA Service aufgeführten VDA-, StoreFront- oder StoreFront-TLS-Ports nicht mit dem Brokerdienst übereinstimmen, verwenden Sie die entsprechenden aufgelisteten Befehlszeilen-Switches, um die Porteinstellungen des HA Service entsprechend anzupassen:

    %programfiles%\Citrix\Broker\Service\HighAvailabilityService.exe -VdaPort <port>
    %programfiles%\Citrix\Broker\Service\HighAvailabilityService.exe -StoreFrontPort <port>
    %programfiles%\Citrix\Broker\Service\HighAvailabilityService.exe -StoreFrontTlsPort <port>
    <!--NeedCopy-->
    

    VDA-Port für HA-Dienste

    Hinweis:

    Es wird erwartet, dass sich der SDK-Port zwischen dem Broker Service und dem HA Service unterscheidet.

    Wenn Sie den StoreFront-Port des Brokerdienstes ändern, wird der StoreFront-Port des HA-Dienstes automatisch aktualisiert. Der Dienst, der das automatische Update erhält, muss jedoch weiterhin manuell neu gestartet werden, um den neuen Port verwenden zu können.

  4. Während eines Ausfalls verarbeitet der gewählte sekundäre Broker alle Verbindungen. Wenn der Ausfall beginnt, hat der sekundäre Broker keine aktuellen VDA-Registrierungsdaten, aber wenn ein VDA mit ihm kommuniziert, wird ein erneuter Registrierungsprozess ausgelöst. Während dieses Vorgangs erhält der sekundäre Broker auch aktuelle Sitzungsinformationen zu dem betreffenden VDA. Um die Neuregistrierung der VDAs vom Standardintervall von 5 Minuten auf ein Intervall von 1 Minute zu beschleunigen, muss diese Einstellung auf alle Controller in der Site angewendet werden.

    New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer -Name HeartbeatPeriodMs -PropertyType DWORD -Value 60000

  5. Um die VDA-Neuregistrierungen zu überwachen, starten Sie Citrix Studio und klicken Sie auf den Knoten Konfiguration > Controller. Dort wird die Anzahl der VDAs angezeigt, die bei primären Brokern registriert sind. Lassen Sie das Citrix Studio geöffnet, um zu sehen, wie die Anzahl auf Null sinkt, wenn sich die VDAs während des Ausfalls erneut beim ausgewählten sekundären Broker registrieren. Beachten Sie, dass Sie Citrix Studio nicht verwenden können, um die Anzahl der beim sekundären Broker registrierten VDAs anzuzeigen.

  6. Um den Ausfall zu erzwingen und in den LHC-Modus zu wechseln, bearbeiten Sie die Registry der einzelnen Delivery Controller.

    New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name OutageModeForced -PropertyType DWORD -Value 1

  7. Um festzustellen, ob der Ausfall ausgelöst wurde und jeder primäre Broker in den LHC-Modus gewechselt ist, gehen Sie zum Anwendungsknoten der Ereignisprotokolle auf jedem Controller und suchen Sie im Citrix High Availability Service nach dem folgenden Ereignis.

    3502: Der Citrix High Availability Service ist aktiv geworden und vermittelt Benutzeranfragen für Sitzungen, bis das bei der normalen Vermittlungsaktivität festgestellte Problem behoben ist.

    Event 3502 Bild

  8. Bestätigen Sie, dass sich alle VDAs beim ausgewählten sekundären Broker erneut registriert haben, indem Sie den Controller-Knoten in Citrix Studio aktualisieren. Wahrscheinlich wurden alle VDAs erneut registriert, obwohl die primären Broker keine registrierten VDAs vorweisen.

  9. Die sekundären Broker verwenden die alphabetische Liste der FQDNs der Maschinen, auf denen sie laufen, um zu bestimmen (auszuwählen), welcher sekundäre Broker für die Brokering-Operationen in der Zone zuständig ist, falls ein Ausfall auftritt. Um zu überprüfen, welcher sekundäre Broker ausgewählt wurde, suchen Sie in den Windows-Ereignisanwendungsprotokollen nach dem folgenden Ereignis aus dem Citrix High Availability Service.

    3504: Der Citrix High Availability Service ‘FQDN of elected Controller’ ist zur ausgewählten Instanz unter seinen Peers geworden (Liste der Peer-Controller-FQDNs).

    Event 3504 Bild

  10. Wählen Sie einen der nicht ausgewählten Peer-Controller und führen Sie das Produktupgrade auf dem nicht ausgewählten Controller durch.

  11. Starten Sie Citrix Studio vom neu aktualisierten Controller aus und führen Sie das obligatorische Site-Upgrade einschließlich des Datenbank-Upgrades durch.

    Bild für das Site-Upgrade

  12. Führen Sie Produktupgrades auf den verbleibenden nicht ausgewählten Peer-Controllern durch. Achten Sie darauf, den ausgewählten Controller nicht zu stören, der immer noch alle neuen und aktiven Verbindungen in der Umgebung verwaltet.

  13. Nachdem alle nicht ausgewählten Controller aktualisiert wurden, ist es an der Zeit, den Ausfall der Site zu beenden und den LHC-Modus zu beenden. Um den Auslöser für einen erzwungenen Ausfall zu entfernen, bearbeiten Sie die Registrierung der einzelnen Controller. Der Schlüssel kann auf Wunsch auch gelöscht werden.

    Set-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name OutageModeForced -Value 0

  14. Um zu überprüfen, ob sich der Standort außerhalb des Ausfallmodus befindet, suchen Sie auf jedem Controller im Anwendungsereignisprotokoll nach den folgenden Ereignissen aus dem Citrix Broker-Service.

    3004: Der Citrix Broker Service hat erfolgreich eine Verbindung zur XenDesktop-Datenbank hergestellt.

    Event 3004 Bild

    3500: Der Citrix Broker Service hat festgestellt, dass das Problem mit der Kommunikation mit der Datenbank behoben wurde, und nimmt die normale Vermittlungsaktivität mithilfe der Konfiguration in der Hauptdatenbank des Standorts wieder auf.

    Event 3500 (Bild)

  15. Aktualisieren Sie den Controller-Knoten von Citrix Studio, um zu beobachten, wie sich die VDAs bei den aktualisierten Controllern erneut registrieren. Vergewissern Sie sich, dass alle VDAs erfolgreich neu registriert wurden.

  16. Führen Sie das Produkt-Upgrade auf dem letzten verbleibenden Controller durch, der während des Ausfalls als gewählter sekundärer Broker diente.

  17. (Dieser Schritt ist optional.) Setzen Sie das VDA-Registrierungsintervall auf den Standardwert von 5 Minuten zurück, indem Sie die Registrierung auf jedem Controller ändern (der Schlüssel kann auch gelöscht werden, falls gewünscht).

    Set-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer -Name HeartbeatPeriodMs -PropertyType DWORD -Value 300000

  18. (Dieser Schritt ist optional.) Verwenden Sie die folgenden Cmdlets, wenn Sie zum Standardverhalten der energieverwalteten Bereitstellungsgruppen zurückkehren möchten.

    Set-BrokerSite  -ReuseMachinesWithoutShutdownInOutageAllowed $false
    Set-BrokerDesktopGroup -Name "<Delievery Group Name>" -ReuseMachinesWithoutShutdownInOutage $false
    <!--NeedCopy-->
    

Das unterbrechungsfreie Upgrade mit Local Host Cache sollte jetzt abgeschlossen sein.

Verwenden des lokalen Host-Cache für unterbrechungsfreie Datenbank-Upgrades