Set up Instant Passthrough for Citrix XenApp published applications

Where to find the Instant Passthrough settings window

What

Where

Global default Instant Passthrough settings

In the Setup menu, go to Application Virtualization > Citrix XenApp Publishing.

Go to the Defaults tab.

Select Enable Instant Passthrough for computers not publishing this application

Click the button [Settings...]

Instant Passthrough settings for a specific managed application

Open or create the managed application at Composition > Applications.

Go to the Publishing tab in its Properties section

Select Enable Citrix XenApp Application Publishing

Select Enable Instant Passthrough for computers not publishing this application

Click the button [Settings...]

Use the Instant Passthrough mechanism to start a Citrix XenApp published application on a remote server, using either an ICA file generated by Workspace Control or a custom ICA file. The ICA file points to the application on the remote server and is stored in the Workspace Control Datastore in the \TPI\ICA sub-folder.

When a user starts the application, the request will automatically be redirected to the remote server on which the application is located, after which the remote server will publish the application to the user's desktop.

Instant Passthrough is not supported when publishing an application to multiple server farms. If the selection of Configured Servers contains servers from different farms, Instant Passthrough is automatically disabled for this application.

If an application changes from being published to multiple farms to being published to a single farm, then the Instant Passthrough option becomes available again. (The configuration of this option will have reverted to the global default configuration for Instant Passthrough.)

Configuration

In the Instant Passthrough settings window, you can configure the settings for the passthrough mechanism and the ICA file.

  • If you access this window from the global Citrix XenApp Integration node, you are defining the default Instant Passthrough settings for all Citrix XenApp published applications in your environment.
  • If you access this window from the Publishing tab of a managed Citrix XenApp published application, the Instant Passthrough settings apply only to that application.
    Please note that if global Instant Passthrough settings have been configured (at Setup > Integration > Citrix XenApp Publishing, on the Defaults tab), but the option Enable Instant Passthrough for computers not publishing this application has been unchecked, the configured settings will still be shown when enabling Instant Passthrough on application level (at Composition > Applications, on the Properties > Publishing > Citrix XenApp Published Application tab of an application).

Properties tab

  • To use the TCP/IP+HTTP network protocol to locate and connect to the ICA Server, select Use TCP/IP+HTTP browsing.
    • To use SSL to locate and connect to the ICA Server, select Use SSL to browse and connect and enter the server name and port of the ICA server.
  • Select how passthrough authentication should be handled:
    • If Workspace Control handles the authentication, then the parameters /username, /domain, and /password will also be passed to the ICA client with the correct values.
    • If Citrix XenApp handles the authentication, then the ICA file will be passed to the ICA Client without any additional parameters.
  • By default, Workspace Control generates an ICA file for each Instant Passthrough connection.
    • To create a single custom ICA file for all Instant Passthrough connections, select Use template ICA file and click [Edit]. Please note that this defines a global custom ICA file that will be used for ALL instant passthrough connections, and will overrule any ICA files configured at application level.
    • To create a custom ICA file per published application, ensure that the global option Use template ICA file is NOT selected. Then, for each Citrix published application for which the default ICA file generated by Workspace Control does not suffice, go to the application's Publishing tab, select Use a custom ICA file for this application and click [Edit].
  • In the Passthrough method area, configure how the passthrough should be made available. Launching the passthrough connection using the Citrix Program Neighborhood Client or Agent can be useful, for example, when smartcards are used for authentication:
    • Use the Citrix Program Neighborhood Agent: if you select this option, the passthrough connection is established by launching pnagent.exe with the correct parameters.
      When using Legacy Citrix Receiver 3.x (with PNA) with Citrix StoreFront, configure Citrix Receiver 3.x to connect to the Citrix XenApp Services URL (in the Citrix Storefront console at Stores -> Configure Legacy Support). In this situation, the name to fill in for XenApp Services Site Farm Name is the "Citrix Store Service Delivery Controller name".
    • Use the Citrix Program Neighborhood client: If you select this option, the passthrough connection is established by launching pn.exe with the correct parameters. Because one of these parameters is the name of the application set, you also need to provide this name.
    • Use an ICA file:
      • Standard Workspace Control ICA file or Use template ICA file: If you select either of these options, Workspace Control will launch wfcrun32.exe using the Standard Workspace Control or template ICA file.

Behavior tab

With the option Do not passthrough if application is available on local computer selected, the published application will only be launched if there is no local version of the application available.

  • If the user logs on to a computer on which an application has been published (which is determined by the list of servers on the Servers tab of the Publishing > Citrix XenApp Published Application tab of the application), the application will be started directly (the original command line will be used to start the application).
  • If the user logs on to a computer on which an application has not been published (again, determined by the list of servers on the Servers tab), the application will not be started directly. Instead, the Citrix ICA Client will be started with the ICA file passed as a parameter.

You can optionally choose to ignore the configured behavior inside or outside specific Zones via the Locations and Devices field.

  • If you configure to passthrough anyway in specific Zones, at least one of the added Zones must apply.
  • If you configure to passthrough anyway outside specific Zones, all added Zones must apply.

Citrix StoreBrowse

Instead of using the default behavior of Instant Passthrough, you can configure a registry setting to use the Citrix StoreBrowse command-line utility tool to start managed Citrix XenApp published applications. For more details, see UseStoreBrowse.