Upgrade von StoreFront™
Durch ein Upgrade bleiben Ihre StoreFront-Konfiguration und die Favoriten der Benutzer erhalten. Im Gegensatz dazu werden bei der Deinstallation von StoreFront StoreFront und die zugehörigen Dienste, Sites, Favoriten (auf eigenständigen Servern) sowie die zugehörige Konfiguration entfernt.
Unterstützte Upgrade-Pfade
Sie können ein Upgrade auf StoreFront 2402 von folgenden Versionen durchführen:
- StoreFront 2311
- StoreFront 2308
- StoreFront 2203 LTSR (beliebiges CU)
- StoreFront 1912 LTSR (beliebiges CU)
- StoreFront 3.12 LTSR CU9
Um ein Upgrade von Versionen vor 3.12 CU9 durchzuführen, müssen Sie zuerst ein Upgrade auf StoreFront 3.12 CU9 durchführen.
Warnung:
Wenn Sie ein Upgrade von Versionen vor 1912 durchführen, werden alle Desktop Appliance-Sites in Ihrer Bereitstellung automatisch entfernt. Alternativ empfiehlt Citrix die Verwendung von Citrix Workspace-App Desktop Lock für alle Anwendungsfälle, die nicht in eine Domäne eingebunden sind.
Wissenswertes
- StoreFront unterstützt keine Bereitstellungen mit mehreren Servern, die unterschiedliche Produktversionen enthalten. Daher müssen alle Server in einer Servergruppe auf dieselbe Version aktualisiert werden, bevor Sie den Zugriff auf die Bereitstellung gewähren.
- Ein gleichzeitiges Upgrade wird für Bereitstellungen mit mehreren Servern nicht unterstützt. Server müssen sequenziell aktualisiert werden.
- Bevor das StoreFront-Upgrade ausgeführt wird, werden einige Vorabprüfungen durchgeführt. Wenn eine dieser Prüfungen fehlschlägt, startet das Upgrade nicht, und Sie werden über die Fehler benachrichtigt. Ihre StoreFront-Installation bleibt unverändert. Nachdem Sie die Ursache der Fehler behoben haben, führen Sie das Upgrade erneut aus.
- Wenn das StoreFront-Upgrade selbst fehlschlägt, kann Ihre vorhandene StoreFront-Installation ihre ursprüngliche Konfiguration verlieren. Stellen Sie Ihre StoreFront-Installation in einen funktionsfähigen Zustand wieder her und führen Sie das Upgrade dann erneut aus. Um StoreFront in einen funktionsfähigen Zustand wiederherzustellen, ziehen Sie die folgenden Ansätze in Betracht:
- Wiederherstellen des VM-Snapshots, den Sie vor dem Upgrade erstellt haben,
- Importieren der StoreFront-Konfiguration, die Sie vor dem Upgrade exportiert haben, siehe Exportieren und Importieren der StoreFront-Konfiguration,
- Befolgen der Ratschläge zur Fehlerbehebung unter Beheben von StoreFront-Upgrade-Problemen.
- Alle StoreFront-Upgrade-Fehler, die vom Citrix Virtual Apps and Desktops Metainstaller auftreten, werden in einem Dialogfeld mit einem Link zum entsprechenden Fehlerprotokoll gemeldet.
-
Hybrid-Start über StoreFront-Versionen zwischen 1912 und 2203
StoreFront-Versionen zwischen 1912 und 2203 unterstützen die Aktivierung des Hybrid-Starts von virtuellen Apps und Desktops, die mit App Protection-Richtlinien aktiviert sind, mithilfe einer Anpassung wie folgt:
Citrix® empfiehlt, diese Anpassung beim Upgrade auf StoreFront 2308 oder höher zu entfernen.
Weitere Informationen finden Sie unter Hybrid-Start über StoreFront-Versionen zwischen 1912 und 2203
Upgrade vorbereiten
Bevor Sie mit dem Upgrade beginnen, empfehlen wir Ihnen, die folgenden Schritte auszuführen, die ein Upgrade-Fehler verhindern können:
- Planen Sie Ihre Backup-Strategie vor dem Upgrade.
- Vergewissern Sie sich, dass Sie von einer unterstützten Version aktualisieren.
- Laden Sie das StoreFront-Installationsprogramm von der Citrix-Website herunter.
Upgrade eines einzelnen StoreFront-Servers
- Sichern Sie den Server, indem Sie einen VM-Snapshot erstellen.
- Exportieren Sie die vorhandene StoreFront-Konfiguration. Wenn Sie mehrere Server in einer Servergruppe haben, exportieren Sie die Servergruppenkonfiguration nur von einem Server. Vorausgesetzt, Sie haben alle Änderungen zwischen ihnen weitergegeben, behalten alle Server in einer Servergruppe identische Kopien der Konfiguration bei. Dieses Backup ermöglicht es Ihnen, einfach eine neue Servergruppe zu erstellen, sodass Sie die Konfiguration im Falle von Problemen leicht wiederherstellen können. Beachten Sie, dass Sie dieses Backup nur auf einem Server wiederherstellen können, der dieselbe Version ausführt, von der es exportiert wurde.
- Wenn Sie Änderungen an Dateien in
C:\inetpub\wwwroot\Citrix\<StoreName>\App_DataoderC:\inetpub\wwwroot\Citrix\<StoreName>Auth\App_Datavorgenommen haben, wie z. B. default.ica und usernamepassword.tfrm, sichern Sie diese für jeden Store. Nach dem Upgrade können Sie sie wiederherstellen, um Ihre Änderungen wiederherzustellen. - Verhindern Sie, dass Benutzer eine Verbindung herstellen, indem Sie den Server von einem Load Balancer entfernen oder anderweitig Verbindungen blockieren.
- Starten Sie den Server neu.
- Stellen Sie sicher, dass keine Anwendungen ausgeführt werden, einschließlich der StoreFront-Verwaltungskonsole, Befehlszeilen- und PowerShell-Fenster oder andere Anwendungen, die eine Sperre für StoreFront-Dateien haben könnten. Dadurch wird sichergestellt, dass alle StoreFront-Dateien während des Upgrades für das Installationsprogramm zugänglich sind. Wenn das Installationsprogramm nicht auf Dateien zugreifen kann, werden diese nicht ersetzt, und das Upgrade schlägt fehl, was zur Entfernung der vorhandenen StoreFront-Konfiguration führt.
- Stellen Sie sicher, dass Sie keine Windows Explorer- oder Eingabeaufforderungsfenster in Verzeichnissen geöffnet haben, die StoreFront-Dateien enthalten.
- Deaktivieren Sie alle Antivirenprogramme.
- Führen Sie die Installationsdatei für die erforderliche StoreFront-Version aus.
Upgrade einer StoreFront-Servergruppe während geplanter Wartungszeiten
Um eine StoreFront-Servergruppe mit mehreren Servern während geplanter Ausfallzeiten zu aktualisieren, führen Sie die folgenden Schritte aus:
- Deaktivieren Sie den Benutzerzugriff auf die Servergruppe, indem Sie die Load-Balancing-URL deaktivieren. Dies verhindert, dass Benutzer während des Upgrade-Vorgangs eine Verbindung zur Bereitstellung herstellen.
- Aktualisieren Sie jeden Server gemäß den Anweisungen unter Upgrade eines einzelnen StoreFront-Servers.
- Überprüfen Sie, ob alle Server ordnungsgemäß funktionieren.
- Aktivieren Sie den Benutzerzugriff auf die aktualisierte Servergruppe, indem Sie die Load-Balancing-URL aktivieren.
Upgrade einer StoreFront-Servergruppe ohne geplante Ausfallzeiten
Ein gleichzeitiges Upgrade der Server in einer aktiven StoreFront-Servergruppe wird nicht unterstützt. Sie können jedoch ein Live-Upgrade erreichen, indem Sie eine neue Servergruppe mit identischer Konfiguration erstellen, diese aktualisieren und dann die Benutzerverbindungen zur neuen Servergruppe migrieren. Benutzer müssen sich bei StoreFront erneut authentifizieren, wenn sie zwischen Servergruppen übertragen werden.
Um beispielsweise eine StoreFront-Servergruppe von drei Servern A, B und C zu aktualisieren:
- Exportieren Sie die StoreFront-Konfiguration mit Export-STFConfiguration. Dieses Backup ist notwendig, da Server später im Prozess auf Werkseinstellungen zurückgesetzt werden, wodurch Konfigurationsdaten gelöscht werden.
- Exportieren Sie Abonnementdaten von Server A mit Export-STFStoreSubscriptions. Dieses Backup ist notwendig, da Server später im Prozess auf Werkseinstellungen zurückgesetzt werden, wodurch Abonnementdaten gelöscht werden. Siehe Verwalten von Abonnementdaten für einen Store.
- Deaktivieren Sie den Benutzerzugriff auf Server C, indem Sie ihn aus dem Load Balancer entfernen. Dies verhindert, dass Benutzer während des Upgrade-Vorgangs eine Verbindung zu Server C herstellen. Der Load Balancer sendet weiterhin Anfragen an die Server A und B.
- Verwenden Sie Server A, um Server C aus der Gruppe zu entfernen. Die Server A und B stellen weiterhin den Zugriff auf die Ressourcen Ihrer Benutzer bereit. Server C ist nun von der Servergruppe getrennt und wird auf Werkseinstellungen zurückgesetzt.
- Setzen Sie den verwaisten Server C auf die Werkseinstellungen zurück mit Clear-STFDeployment.
- Importieren Sie die StoreFront-Konfiguration, die Sie zuvor exportiert haben, in Server C mit Import-STFConfiguration. Server C hat nun eine identische Konfiguration wie die alte Servergruppe. Es ist nicht notwendig, diesen Schritt später erneut zu wiederholen. Nur ein Server benötigt eine Kopie der Konfigurationsdaten, um sie an andere Server weiterzugeben, die der Gruppe beitreten.
- Aktualisieren Sie Server C gemäß den Anweisungen unter Upgrade eines einzelnen StoreFront-Servers. Server C hat nun eine identische Konfiguration wie die alte Servergruppe und wurde auf eine neue Version von StoreFront aktualisiert.
- Importieren Sie die Abonnementdaten, die Sie zuvor exportiert haben, in Server C. Es ist nicht notwendig, diesen Schritt später erneut zu wiederholen. Nur ein Server benötigt eine Kopie der Abonnementdaten, um sie an andere Server weiterzugeben, die der Gruppe beitreten.
- Wiederholen Sie die Schritte 3, 4, 5 und 7 mit Server B (wiederholen Sie Schritt 6 nicht). Während dieser Zeit stellt nur Server A den Benutzern den Zugriff auf Ressourcen bereit. Es wird daher empfohlen, diesen Schritt während ruhiger Arbeitszeiten durchzuführen, in denen die Last auf der StoreFront-Servergruppe voraussichtlich minimal ist.
- Fügen Sie Server B zu Server C hinzu, indem Sie den Prozess Bestehende Servergruppe beitreten verwenden. Dies ergibt eine Einzelserver-Bereitstellung auf der aktuellen StoreFront-Version (Server A) und eine neue Zwei-Knoten-Servergruppe auf der neuen StoreFront-Version (Server B und C).
- Fügen Sie die Server B und C zum Load-Balancing-Dienst hinzu, damit sie Server A übernehmen können.
- Entfernen Sie Server A vom Load Balancer, damit Benutzer zu den neu aktualisierten Servern B und C geleitet werden.
- Wiederholen Sie die Schritte 5, 7, 10 und 11 mit Server A (wiederholen Sie Schritt 6 nicht). Der Upgrade-Prozess der Servergruppe ist nun abgeschlossen. Die Server A, B und C verfügen über identische Konfigurations- und Abonnementdaten der ursprünglichen Gruppe.
Hinweis:
Während des kurzen Zeitraums, in dem Server A der einzige zugängliche Server ist, können Favoriten verloren gehen (Schritt 9). Dies kann dazu führen, dass die neue Servergruppe nach dem Upgrade eine leicht veraltete Kopie der Abonnementdatenbank hat und alle neuen Favoriten verloren gehen.
Dies hat keine funktionellen Auswirkungen, da Favoritendaten für Benutzer nicht wesentlich sind, um sich anmelden und Ressourcen starten zu können. Benutzer müssten jedoch eine Ressource erneut als Favorit markieren, nachdem Server A auf Werkseinstellungen zurückgesetzt und der neu aktualisierten Gruppe beigetreten ist. Obwohl es unwahrscheinlich ist, dass mehr als ein paar Favoriteneinträge verloren gehen, ist dies eine mögliche Konsequenz eines Upgrades einer aktiven StoreFront-Produktionsumgebung ohne Ausfallzeiten.
Beheben von Upgrade-Problemen
-
Öffnen Sie in C:\Windows\Temp\StoreFront die neueste CitrixMsi*.log-Datei und suchen Sie nach Ausnahme-Fehlern.
Thumbs.db Access-Ausnahmen: verursacht durch thumbs.db-Dateien in C:\inetpub\wwwroot\citrix oder in dessen Unterverzeichnissen. Löschen Sie alle gefundenen thumbs.db-Dateien.
Cannot get exclusive file access \in use-Ausnahmen: Stellen Sie den Snapshot/das Backup wieder her, falls verfügbar, oder starten Sie den Server neu und beenden Sie alle StoreFront-Dienste manuell.
Service cannot be started-Ausnahmen: Stellen Sie den Snapshot/das Backup wieder her, falls verfügbar, oder installieren Sie die Vollversion von .NET Framework 4.5 (nicht das Clientprofil).
- Wenn in CitrixMsi*.log keine Ausnahme-Fehler vorhanden sind, überprüfen Sie den Event Viewer > Delivery Services des Servers auf Fehler, die die vorhergehenden Ausnahme-Fehlermeldungen enthalten. Befolgen Sie den entsprechenden Ratschlag.
- Wenn im Event Viewer keine Ausnahme-Fehler vorhanden sind, überprüfen Sie die Admin-Protokolle in C:\Program Files\Citrix\Receiver StoreFront\logs auf Fehler, die die vorhergehenden Ausnahme-Fehlermeldungen enthalten. Befolgen Sie den entsprechenden Ratschlag.
Weitere Details zu Protokolldateien finden Sie unter Installationsprotokolle.