Abonnementsdaten verwalten
Wenn Sie eine lokale Datenbank verwenden, können Sie Favoriten für einen Store mithilfe von PowerShell-Cmdlets verwalten.
Abonnementsdaten bereinigen
Für jeden Store in Ihrer Bereitstellung existiert ein Ordner und ein Datenspeicher, der Favoritendaten enthält.
- Beenden Sie den Dienst „Citrix Subscriptions Store“ auf dem StoreFront-Server. Wenn der Dienst „Citrix Subscriptions Store“ ausgeführt wird, können keine Abonnementsdaten für Ihre Stores gelöscht werden.
- Suchen Sie den Abonnements-Store-Ordner auf dem StoreFront-Server:
C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_<StoreName> - Löschen Sie den Inhalt des Abonnements-Store-Ordners, aber nicht den Ordner selbst.
- Starten Sie den Dienst „Citrix Subscriptions Store“ auf dem StoreFront-Server neu.
Sie können das folgende PowerShell-Skript verwenden, um Abonnementsdaten für einen Store zu bereinigen. Führen Sie diese PowerShell-Funktion als Administrator mit Rechten zum Beenden oder Starten von Diensten und zum Löschen von Dateien aus. Diese PowerShell-Funktion erzielt dasselbe Ergebnis wie die oben beschriebenen manuellen Schritte.
Damit die Cmdlets erfolgreich ausgeführt werden, muss der Dienst „Citrix Subscriptions Store“ auf dem Server ausgeführt werden.
function Remove-SubscriptionData
{
[CmdletBinding()]
[Parameter(Mandatory=$False)][String]$Store = "Store"
$SubsService = "Citrix Subscriptions Store"
# Path to Subscription Data in StoreFront version 2.6 or later
$SubsPath = "C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_$Store\*"
Stop-Service -displayname $SubsService
Remove-Item $SubsPath -Force -Verbose
Start-Service -displayname $SubsService
Get-Service -displayname $SubsService
}
Remove-SubscriptionData -Store "YourStore"
<!--NeedCopy-->
Abonnementsdaten exportieren
Sie können ein Backup der Store-Abonnementsdaten in Form einer tabulatorgetrennten .txt-Datei mithilfe des Cmdlets Export-STFStoreSubscriptions erhalten, zum Beispiel:
$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Export-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->
Wenn Sie eine Bereitstellung mit mehreren Servern verwalten, können Sie dieses PowerShell-Cmdlet auf jedem Server innerhalb der StoreFront-Servergruppe ausführen. Jeder Server in der Servergruppe verwaltet eine identische, synchronisierte Kopie der Abonnementsdaten von seinen Peers. Wenn Sie glauben, dass Probleme mit der Abonnementssynchronisierung zwischen den StoreFront-Servern auftreten, exportieren Sie die Daten von allen Servern in der Gruppe und vergleichen Sie sie, um Unterschiede festzustellen.
Abonnementsdaten wiederherstellen
Verwenden Sie Restore-STFStoreSubscriptions, um Ihre vorhandenen Abonnementsdaten zu überschreiben. Sie können die Abonnementsdaten eines Stores mithilfe des tabulatorgetrennten .txt-Datei-Backups wiederherstellen, das Sie zuvor mit Export-STFStoreSubscriptions erstellt haben.
$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Restore-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->
Weitere Informationen zu Restore-STFStoreSubscriptions finden Sie unter https://developer-docs.citrix.com/en-us/storefront-powershell-sdk/current-release/Restore-STFStoreSubscriptions/
Wiederherstellen von Daten auf einem einzelnen StoreFront-Server
In einer Einzelserverbereitstellung ist es nicht erforderlich, den Subscriptions Store-Dienst herunterzufahren. Es ist auch nicht erforderlich, die vorhandenen Abonnementsdaten zu bereinigen, bevor die Abonnementsdaten wiederhergestellt werden.
Wiederherstellen von Daten in einer StoreFront-Servergruppe
Um Abonnementsdaten in einer Servergruppe wiederherzustellen, sind die folgenden Schritte erforderlich.
Beispiel einer Servergruppenbereitstellung mit drei StoreFront-Servern.
- StoreFrontA
- StoreFrontB
- StoreFrontC
- Sichern Sie die vorhandenen Abonnementsdaten von einem der drei Server.
- Beenden Sie den Subscriptions Store-Dienst auf den Servern StoreFrontB und C. Diese Aktion verhindert, dass die Server während der Aktualisierung von StoreFrontA Abonnementsdaten senden oder empfangen.
- Bereinigen Sie die Abonnementsdaten von den Servern StoreFrontB und C. Dies verhindert eine Inkonsistenz der wiederhergestellten Abonnementsdaten.
- Stellen Sie die Daten auf StoreFrontA mithilfe des Cmdlets Restore-STFStoreSubscriptions wieder her. Es ist nicht erforderlich, den Subscriptions Store-Dienst zu beenden oder die Abonnementsdaten auf StoreFrontA zu bereinigen (sie werden während des Wiederherstellungsvorgangs überschrieben).
- Starten Sie den Subscriptions Store-Dienst auf den Servern StoreFrontB und StoreFrontC neu. Die Server können dann eine Kopie der Daten von StoreFrontA empfangen.
- Warten Sie, bis die Synchronisierung zwischen allen Servern erfolgt ist. Die benötigte Zeit hängt von der Anzahl der Datensätze ab, die auf StoreFrontA vorhanden sind. Wenn sich alle Server in einer lokalen Netzwerkverbindung befinden, erfolgt die Synchronisierung normalerweise schnell. Die Synchronisierung von Abonnements über eine WAN-Verbindung kann länger dauern.
- Exportieren Sie die Daten von StoreFrontB und C, um zu bestätigen, dass die Synchronisierung abgeschlossen ist, oder zeigen Sie die Store-Abonnementzähler an.
Abonnementsdaten importieren
Verwenden Sie Import-STFStoreSubscriptions, wenn keine Abonnementsdaten für den Store vorhanden sind. Dieses Cmdlet ermöglicht auch die Übertragung von Abonnementsdaten von einem Store zu einem anderen oder den Import von Abonnementsdaten auf neu bereitgestellte StoreFront-Server.
$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Import-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->
Weitere Informationen zu Import-STFStoreSubscriptions finden Sie unter https://developer-docs.citrix.com/en-us/storefront-powershell-sdk/current-release/Import-STFStoreSubscriptions/
Details zur Abonnementsdatendatei
Die Abonnementsdatendatei ist eine Textdatei, die eine Zeile pro Benutzerabonnement enthält. Jede Zeile ist eine tabulatorgetrennte Abfolge von Werten:
<user-identifier> <resource-id> <subscription-id> <subscription-status> <property-name> <property-value> <property-name> <property-value> ...
wobei:
-
<user-identifier>– Erforderlich. Eine Zeichenfolge, die den Benutzer identifiziert. Dieser Bezeichner ist die Windows-Sicherheits-ID des Benutzers. -
<resource-id>– Erforderlich. Eine Zeichenfolge, die die abonnierte Ressource identifiziert. -
<subscription-id>– Erforderlich. Eine Zeichenfolge, die das Abonnement eindeutig identifiziert. Dieser Wert wird nicht verwendet (obwohl ein Wert in der Datendatei vorhanden sein muss). -
<subscription-status>– Erforderlich. Der Status des Abonnements: abonniert oder abbestellt. -
<property-name>und<property-value>– Optional. Eine Abfolge von null oder mehr Paaren von Eigenschaftsnamen/-werten. Diese stellen Eigenschaften dar, die einem Abonnement von einem StoreFront-Client (typischerweise einer Citrix Workspace-App) zugeordnet sind. Eine Eigenschaft mit mehreren Werten, die durch mehrere Name/Wert-Paare mit demselben Namen dargestellt wird (z. B. „… MyProp A MyProp B …“ stellt die Eigenschaft MyProp mit den Werten A, B dar).
Beispiel
S-0-0-00-0000000000-0000000000-0000000000-0000 XenApp.Excel 21EC2020-3AEA-4069-A2DD-08002B30309D Subscribed dazzle:position 1
Größe der Abonnementsdaten auf der StoreFront-Serverfestplatte
| Anzahl der Datensätze | Größe in MB |
|---|---|
| 0 | 6.02 |
| 1.000 | 7.02 |
| 10.000 | 40.00 |
| 100.000 | 219.00 |
| 200.000 | 358.00 |
| 500.000 | 784.00 |
| 800.000 | 1213.02 |
| 1.000.000 | 1597.15 |
| 1.300.000 | 1919.15 |
| 1.500.000 | 2205.15 |
| 2.000.000 | 2915.15 |
Größe der Import- und Export-.txt-Dateien
| Anzahl der Datensätze | Größe in MB |
|---|---|
| 0 | 0.00 |
| 1.000 | 0.13 |
| 10.000 | 1.30 |
| 100.000 | 12.80 |
| 200.000 | 25.60 |
| 500.000 | 64.10 |
| 800.000 | 102.00 |
| 1.000.000 | 128.00 |
| 1.300.000 | 166.00 |
| 1.500.000 | 192.00 |
| 1.700.000 | 218.00 |
| 2.000.000 | 256.00 |
Store-Abonnementzähler
Sie können Microsoft Windows Leistungsüberwachungszähler (Start > Ausführen > perfmon) verwenden, um beispielsweise die Gesamtzahl der Abonnementsdatensätze auf dem Server oder die Anzahl der zwischen StoreFront-Servergruppen synchronisierten Datensätze anzuzeigen.
Abonnementszähler mit PowerShell anzeigen
Get-Counter -Counter "\Citrix Subscription Store(1__citrix_store)\Subscription Entries Count (including unpurged deleted records)"
Get-Counter -Counter "\Citrix Subscription Store Synchronization\Subscriptions Store Synchronizing"
Get-Counter -Counter "\Citrix Subscription Store Synchronization\Number Subscriptions Synchronized"
Get-Counter -Counter "\Citrix Subscription Store Synchronization\Number Subscriptions Transferred"
<!--NeedCopy-->
In diesem Artikel
- Abonnementsdaten bereinigen
- Abonnementsdaten exportieren
- Abonnementsdaten wiederherstellen
- Wiederherstellen von Daten auf einem einzelnen StoreFront-Server
- Wiederherstellen von Daten in einer StoreFront-Servergruppe
- Abonnementsdaten importieren
- Details zur Abonnementsdatendatei
- Beispiel
- Store-Abonnementzähler
- Abonnementszähler mit PowerShell anzeigen