Administrar datos de suscripción a un almacén

Puede administrar los datos de suscripción a un almacén mediante los cmdlets de PowerShell.

Nota:

Use la consola de administración de StoreFront o PowerShell para administrar StoreFront. No use ambos métodos al mismo tiempo. Cierre siempre la consola de administración de StoreFront antes de usar la consola de PowerShell para cambiar la configuración de StoreFront. Citrix también recomienda que se realice una copia de seguridad de los datos de suscripción existente antes de realizar cambios, de modo que se pueda revertir a un estado anterior.

Purgar datos de suscripción

Para cada almacén de la implementación, existe una carpeta y un almacén de datos de suscripción.

  1. Detenga el servicio de suscripciones a almacenes de Citrix en el servidor de StoreFront. Mientras el servicio de suscripciones a almacenes de Citrix esté en ejecución, no se puede eliminar datos de suscripción de ningún almacén.
  2. Busque la carpeta de suscripción al almacén, ubicada en el servidor de StoreFront: C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_<StoreName>
  3. Elimine el contenido de la carpeta de suscripción al almacén, pero no elimine la carpeta en sí.
  4. Vuelva a iniciar el servicio de suscripciones a almacenes de Citrix en el servidor de StoreFront.

En StoreFront 3.5 o versiones posteriores, puede utilizar el siguiente script de PowerShell para purgar los datos se suscripción a un almacén. Ejecute esta función PowerShell como un administrador con derechos para detener o iniciar servicios y eliminar archivos. Esta función PowerShell tiene el mismo resultado que los pasos manuales descritos anteriormente.

Para ejecutar los cmdlets de manera efectiva, el servicio Citrix Subscriptions Store debe estar ejecutándose 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"

Exportar datos de suscripción

Puede obtener una copia de seguridad de los datos de suscripción a un almacén en el formato de archivo .txt con texto separado por tabulaciones. Para ello, ejecute el siguiente cmdlet de PowerShell.

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"

Export-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"

Si administra una implementación con varios servidores, puede ejecutar este cmdlet de PowerShell en cualquier servidor del grupo de servidores de StoreFront. Cada servidor del grupo de servidores mantiene una copia sincronizada idéntica de los datos de suscripción proveniente de sus homólogos. Si cree que hay problemas con la sincronización de suscripciones entre los servidores de StoreFront, exporte los datos de todos los servidores del grupo y compárelos para ver las diferencias.

Restaurar datos de suscripción

Use Restore-STFStoreSubscriptions para sobrescribir los datos existentes de suscripción. Puede restaurar los datos de suscripción a un almacén con la ayuda de la copia de seguridad del archivo TXT que contiene texto separado con tabulaciones que ha creado antes mediante Export-STFStoreSubscriptions.

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"

Restore-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"

Para obtener más información sobre Restore-STFStoreSubscriptions, consulte https://developer-docs.citrix.com/projects/storefront-powershell-sdk/en/latest/Restore-STFStoreSubscriptions/

Restaurar datos en un solo servidor de StoreFront

En una implementación de un solo servidor, no es necesario que finalice el servicio de suscripciones a almacenes. Tampoco es necesario eliminar los datos de suscripción existentes antes de restaurarlos.

Restaurar datos en un grupo de servidores de StoreFront

Para restaurar los datos de suscripción a un grupo de servidores, debe seguir estos pasos.

Ejemplo: implementación de un grupo de tres servidores de StoreFront.

  • StoreFrontA
  • StoreFrontB
  • StoreFrontC
  1. Haga una copia de los datos existentes de suscripción que contiene cualquiera de los tres servidores.
  2. Detenga el servicio de suscripción a almacenes en los servidores de StoreFrontB y C. Esta acción impide que los servidores envíen o reciban datos de suscripción durante la actualización de StoreFrontA.
  3. Purgue los datos de suscripción que contienen los servidores de StoreFrontB y C. Esto impide que haya diferencias entre los datos de suscripción restaurados.
  4. Restaure los datos en StoreFrontA con el cmdlet Restore-STFStoreSubscriptions. No es necesario detener el servicio de suscripción a almacenes ni eliminar los datos de suscripción presentes en StoreFrontA (se sobrescriben durante la operación de restauración).
  5. Vuelva a iniciar el servicio Subscriptions Store en los servidores de StoreFrontB y C. Los servidores ya pueden recibir una copia de los datos procedente de StoreFrontA.
  6. Espere a que todos los servidores se sincronicen. El tiempo necesario depende de la cantidad de registros que existan en StoreFrontA. Si todos los servidores se encuentran en una red local, la sincronización suele producirse rápidamente. En cambio, la sincronización de suscripciones a través de una conexión WAN puede tardar más.
  7. Exporte los datos de StoreFrontB y C para confirmar que se ha completado la sincronización o consulte los contadores de Store Subscription.

Importar datos de suscripción

Use Import-STFStoreSubscriptions cuando no hay datos de suscripción al almacén. Este cmdlet también permite que los datos de suscripción se transfieran de un almacén a otro, además de permitir que esos datos se importen a servidores de StoreFront recién aprovisionados.

$StoreObject = Get-STFStoreService -SiteID 1 -VirtualPath "/citrix/<yourstore>"

Import-STFStoreSubscriptions -StoreService $StoreObject -FilePath "$env:USERPROFILE\Desktop\Subscriptions.txt"

Para obtener más información sobre Import-STFStoreSubscriptions, consulte https://developer-docs.citrix.com/projects/storefront-powershell-sdk/en/latest/Import-STFStoreSubscriptions/

Detalles del archivo de datos de suscripción

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

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

donde:

  • <user-identifier>: Requerido. Una secuencia de caracteres que identifica al usuario. Es el identificador de seguridad de Windows perteneciente al usuario.
  • <resource-id>: Requerido. Una secuencia de caracteres que identifica los recursos suscritos.
  • <subscription-id>: Requerido. Una secuencia de caracteres que identifica de forma única la suscripción. Este valor no se utiliza (aunque debe haber un valor presente en el archivo de datos).
  • <subscription-status>: Requerido. 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 valores de nombre y valor. Estos representan propiedades asociadas a la suscripción por parte de un cliente StoreFront (suele ser una aplicación Citrix Workspace). Una propiedad del mismo nombre con varios valores, representada por varios pares de nombre y valor (por ejemplo, “… MyProp A MyProp B …” representa la propiedad MyProp con 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 de StoreFront

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

Tamaño de archivos .txt importados y exportados

Tamaño de archivos .txt importados y exportados

Contadores de Store Subscription

Puede usar los contadores de los monitores de rendimiento Windows de Microsoft (Inicio > Ejecutar > perfmon) para ver, por ejemplo, la cantidad total de registros de suscripción existente en el servidor o la cantidad de registros que se sincroniza entre grupos de servidores de StoreFront.

Ver contadores de suscripción mediante 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"