StoreFront

Administrar datos de suscripciones

Si usas una base de datos local, puedes administrar los favoritos de un almacén mediante cmdlets de PowerShell.

Purgar datos de suscripciones

En tu implementación, existe una carpeta y un almacén de datos que contienen los datos de favoritos para cada almacén.

  1. Detén el servicio Citrix Subscriptions Store en el servidor StoreFront. Si el servicio Citrix Subscriptions Store está en ejecución, no es posible eliminar los datos de suscripción de ninguno de tus almacenes.
  2. Localiza la carpeta del almacén de suscripciones en el servidor StoreFront: C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_<StoreName>
  3. Elimina el contenido de la carpeta del almacén de suscripciones, pero no elimines la carpeta en sí.
  4. Reinicia el servicio Citrix Subscriptions Store en el servidor StoreFront.

Puedes usar el siguiente script de PowerShell para purgar los datos de suscripción de un almacén. Ejecuta esta función de PowerShell como administrador con derechos para detener o iniciar servicios y eliminar archivos. Esta función de PowerShell logra el mismo resultado que los pasos manuales descritos anteriormente.

Para ejecutar los cmdlets correctamente, el servicio Citrix Subscriptions Store debe estar en ejecución en el servidor.

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-->

Exportar datos de suscripciones

Puedes obtener una copia de seguridad de los datos de suscripción del almacén en un archivo .txt separado por tabulaciones usando el cmdlet Export-STFStoreSubscriptions, por ejemplo:

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Export-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->

Si administras una implementación de varios servidores, puedes ejecutar este cmdlet de PowerShell en cualquier servidor dentro del grupo de servidores de StoreFront. Cada servidor del grupo de servidores mantiene una copia sincronizada idéntica de los datos de suscripción de sus pares. Si crees que estás experimentando problemas con la sincronización de suscripciones entre los servidores de StoreFront, exporta los datos de todos los servidores del grupo y compáralos para ver las diferencias.

Restaurar datos de suscripciones

Usa Restore-STFStoreSubscriptions para sobrescribir tus datos de suscripción existentes. Puedes restaurar los datos de suscripción de un almacén usando la copia de seguridad del archivo .txt separado por tabulaciones que creaste anteriormente con Export-STFStoreSubscriptions.

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Restore-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->

Para obtener más información sobre Restore-STFStoreSubscriptions, consulta https://developer-docs.citrix.com/en-us/storefront-powershell-sdk/current-release/Restore-STFStoreSubscriptions/

Restaurar datos en un único servidor StoreFront

En una implementación de un solo servidor, no es necesario apagar el servicio Subscriptions Store. Tampoco es necesario purgar los datos de suscripción existentes antes de restaurar los datos de suscripción.

Restaurar datos en un grupo de servidores StoreFront

Para restaurar los datos de suscripción en un grupo de servidores, se requieren los siguientes pasos.

Ejemplo de implementación de grupo de servidores que contiene tres servidores StoreFront.

  • StoreFrontA
  • StoreFrontB
  • StoreFrontC
  1. Realiza una copia de seguridad de los datos de suscripción existentes de cualquiera de los tres servidores.
  2. Detén el servicio Subscriptions Store en los servidores StoreFrontB y C. Esta acción evita que los servidores envíen o reciban datos de suscripción durante la actualización de StoreFrontA.
  3. Purga los datos de suscripción de los servidores StoreFrontB y C. Esto evita la falta de coincidencia de los datos de suscripción restaurados.
  4. Restaura los datos en StoreFrontA usando el cmdlet Restore-STFStoreSubscriptions. No es necesario detener el servicio Subscriptions Store ni purgar los datos de suscripción en StoreFrontA (se sobrescriben durante la operación de restauración).
  5. Reinicia el servicio Subscriptions Store en los servidores StoreFrontB y StoreFrontC. Los servidores pueden entonces recibir una copia de los datos de StoreFrontA.
  6. Espera a que se produzca la sincronización entre todos los servidores. El tiempo requerido depende del número de registros que existan en StoreFrontA. Si todos los servidores están en una conexión de red local, la sincronización normalmente ocurre rápidamente. La sincronización de suscripciones a través de una conexión WAN puede tardar más.
  7. Exporta los datos de StoreFrontB y C para confirmar que la sincronización se ha completado, o consulta los contadores de suscripciones del almacén.

Importar datos de suscripciones

Usa Import-STFStoreSubscriptions cuando no haya datos de suscripción para el almacén. Este cmdlet también permite transferir datos de suscripción de un almacén a otro o si se importan datos de suscripción a servidores StoreFront recién aprovisionados.

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"
Import-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"
<!--NeedCopy-->

Para obtener más información sobre Import-STFStoreSubscriptions, consulta https://developer-docs.citrix.com/en-us/storefront-powershell-sdk/current-release/Import-STFStoreSubscriptions/

Detalles del archivo de datos de suscripciones

El archivo de datos de suscripciones es un archivo de texto que contiene una línea por suscripción de usuario. Cada línea es una secuencia de valores separados por tabulaciones:

<user-identifier> <resource-id> <subscription-id> <subscription-status> <property-name> <property-value> <property-name> <property-value> ...

donde:

  • <user-identifier> - Obligatorio. Una secuencia de caracteres que identifica al usuario. Este identificador es el identificador de seguridad de Windows del usuario.
  • <resource-id> - Obligatorio. Una secuencia de caracteres que identifica el recurso suscrito.
  • <subscription-id> - Obligatorio. Una secuencia de caracteres que identifica de forma única la suscripción. Este valor no se usa (aunque debe haber un valor presente en el archivo de datos).
  • <subscription-status> - Obligatorio. El estado de la suscripción: suscrito o no suscrito.
  • <property-name> y <property-value> - Opcional. Una secuencia de cero o más pares de nombre/valor de propiedad. Estos representan propiedades asociadas a la suscripción por un cliente de StoreFront (normalmente una aplicación Citrix Workspace). Una propiedad con varios valores se representa mediante varios pares de nombre/valor que tienen el mismo nombre (por ejemplo, “… MyProp A MyProp B …” representa la propiedad MyProp con los valores A, B).

Ejemplo

S-0-0-00-0000000000-0000000000-0000000000-0000 XenApp.Excel 21EC2020-3AEA-4069-A2DD-08002B30309D Subscribed dazzle:position 1

Tamaño de los datos de suscripción en el disco del servidor StoreFront

Número de registros Tamaño (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

Tamaño de los archivos .txt de importación y exportación

Número de registros Tamaño (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

Contadores de suscripciones del almacén

Puedes usar los contadores del Monitor de rendimiento de Microsoft Windows (Inicio > Ejecutar > perfmon) para mostrar, por ejemplo, el número total de registros de suscripción en el servidor o el número de registros sincronizados entre grupos de servidores StoreFront.

Ver los contadores de suscripciones usando PowerShell

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-->