Product Documentation

Configure user access

Sep 22, 2016

Configure support for connections through XenApp Services URLs

Use the Configure XenApp Services Support task to configure access to your stores through XenApp Services URLs. Users of domain-joined desktop appliances and repurposed PCs running the Citrix Desktop Lock, along with users who have older Citrix clients that cannot be upgraded, can access stores directly using the XenApp Services URL for the store. When you create a new store, the XenApp Services URL is enabled by default.

Important: In multiple server deployments, use only one server at a time to make changes to the configuration of the server group. Ensure that the Citrix StoreFront management console is not running on any of the other servers in the deployment. Once complete, propagate your configuration changes to the server group so that the other servers in the deployment are updated.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane of the Citrix StoreFront management console and, in the results pane, select a store. In the Actions pane, click Configure XenApp Services Support.
  3. Select or clear the Enable XenApp Services Support check box to, respectively, enable or disable user access to the store through the displayed XenApp Services URL.

    The XenApp Services URL for a store has the form http[s]://serveraddress/Citrix/storename/PNAgent/config.xml, where serveraddress is the fully qualified domain name of the server or load balancing environment for your StoreFront deployment and storename is the name specified for the store when it was created.

  4. If you enable XenApp Services Support, optionally specify a default store in your StoreFront deployment for users with the Citrix Online Plug-in.

    Specify a default store so that your users can configure the Citrix Online Plug-in with the server URL or load-balanced URL of the StoreFront deployment, rather than the XenApp Services URL for a particular store.

Disable workspace control reconnect for all Citrix Receivers

Workspace control enables applications to follow users as they move between devices. This allows, for example, clinicians in hospitals to move from workstation to workstation without having to restart their applications on each device.

StoreFront contains a configuration to disable workspace control reconnect in the Store Service for all Citrix Receivers. Manage this feature by using the StoreFront console or PowerShell.

Use the StoreFront management console

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane of the Citrix StoreFront management console and, in the Actions pane, click Configure Store Settings.
  3. Select Advanced Settings and check or uncheck Allow session reconnect.

Use PowerShell

Make sure that you close the Administration Console. Run the following code snippet to import the StoreFront PowerShell modules:

$dsInstallProp = Get-ItemProperty `
-Path HKLM:\SOFTWARE\Citrix\DeliveryServicesManagement -Name InstallDir
$dsInstallDir = $dsInstallProp.InstallDir 
& $dsInstallDir\..\Scripts\ImportModules.ps1

Then the PowerShell command Set-DSAllowSessionReconnect turns Workspace control reconnect on or off.

Syntax

Set-DSAllowSessionReconnect [[-SiteId] <Int64>] [[-VirtualPath] <String> ] `
[[-IsAllowed] <Boolean>]

For example, to turn off workspace control reconnect for a store in /Citrix/Store, the following command configures the store:

Set-DSAllowSessionReconnect -SiteId 1 -VirtualPath /Citrix/Store ` -IsAllowed $false

Configure user subscriptions

Use the User Subscriptions task to require users to subscribe to applications before using them or to enable users to receive all applications when they connect to the store.

Important: In multiple server deployments, use only one server at a time to make changes to the configuration of the server group. Ensure that the Citrix StoreFront management console is not running on any of the other servers in the deployment. Once complete, propagate your configuration changes to the server group so that the other servers in the deployment are updated.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane of the Citrix StoreFront management console and, in the results pane, select a store. In the Actions pane, click Configure Store Settings > User Subscriptions to toggle the user subscriptions feature off or on. 
  3. Choose Enable user subsciptions (Self Service Store) to make users subscribe to the applications to use them. Any previously specified subscriptions are still available. 
  4. Choose Disable user subsciptions (Mandatory Store) to make all applications published to the users available on the Home screen without users subscribing to them. Their subscriptions are not deleted and they can recover them if you re-enable the feature.

Manage subscription data

Manage subscription data for a store using PowerShell cmdlets.

Note: The StoreFront and PowerShell consoles cannot be open at the same time. Always close the StoreFront admin console before using the PowerShell console to administer your StoreFront configuration. Likewise, close all instances of PowerShell before opening the StoreFront console. 

Export subscription data    

You can create a snapshot of a store's subscription data using the following PowerShell cmdlets to create a subscription data file:

Add-PSSnapin Citrix.DeliveryServices.SubscriptionsManagement.Commands

Export-DSStoreSubscriptions -StoreName StoreName -FilePath DataFile

When managing a multiple-server deployment, you can run these PowerShell cmdlets on any server within the StoreFront server group. 

Restore subscription data

You can restore a store's subscription data to a previously saved snapshot using the following PowerShell cmdlets:

Add-PSSnapin Citrix.DeliveryServices.SubscriptionsManagement.Commands

Restore-DSStoreSubscriptions -StoreName StoreName -FilePath DataFile

This command restores the subscription data to the state when the export data file was produced, and it removes any existing subscriptions before adding the subscription data found in the data file.

When managing a multiple-server deployment, you can run these PowerShell cmdlets on any server within the StoreFront server group. 

Import subscription data

You can update a store's subscription data from a previously exported data file using the following PowerShell cmdlets:

Add-PSSnapin Citrix.DeliveryServices.SubscriptionsManagement.Commands

Import-DSStoreSubscriptions -StoreName StoreName -FilePath FilePath

This command allows subscription data to be transferred from one store to another, and it retains existing subscriptions before adding/updating subscription data from the imported data file.

When managing a multiple-server deployment, you can run these PowerShell cmdlets on any server within the StoreFront server group.

Purge subscription data for a store

A folder and datastore containing subscription data exists for each store.

  1. Stop the Citrix Subscriptions Store service on the StoreFront server.
  2. Locate subscription store database folder on each StoreFront server in the new location.
    C:\Windows\ServiceProfiles\NetworkService\AppData\Roaming\Citrix\SubscriptionsStore\1__Citrix_<StoreName>

  3. Delete the contents of this folder, but do not delete the folder. 
  4. Restart the Citrix Subscriptions Store service on all StoreFront servers in the deployment.

Subscription data file details

The subscription data file is a text file containing one line per user subscription. Each line is a tab-separated sequence of values:

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

where:

  • <user-identifier> - Required. A sequence of characters identifying the user. This is the user's Windows Security Identifier.
  • <resource-id> - Required. A sequence of characters identifying the subscribed resource.
  • <subscription-id> - Required. A sequence of characters uniquely identifying the subscription. This value is not used (although, a value must be present in the data file).
  • <subscription-status> - Required. The status of the subscription: subscribed or unsubscribed.
  • <property-name> and <property-value> -Optional. A sequence of zero or more pairs of <property-name> and <property-value> values. These represent properties associated with the subscription by a StoreFront client (typically a Citrix Receiver). A property with multiple values that is represented by multiple name/value pairs with the same name (for example, "… MyProp A MyProp B …." represents the property MyProp with values A, B).

Example:

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

Size of subscription data on the Storefront server's disk

 

Size of import and export .txt files