Product Documentation

Decoupling the Receiver Icon

Aug 24, 2015

When a XenApp and XenDesktop deployment is configured with the NetScaler Gateway plug-in integrated with Citrix Receiver, the plug-in’s icon is not visible to a user who is connected to the VPN. The NetScaler Gateway plug-in icon normally resides in the Windows system tray or the Mac OS X Finder’s menu bar. This icon is the interface into the plug-in’s settings and controls. For Windows users, when Citrix Receiver and the NetScaler Gateway plug-in are integrated, the About dialog (Figure 1) in Citrix Receiver displays the controls for the NetScaler Gateway plug-in. For Mac OS X users, there are no controls for the NetScaler Gateway plug-in available after integration.

localized image

Figure 1: Receiver for Windows About dialog 

Some integrated deployments might present a need to expose the plug-in controls while retaining the integration of the underlying functionality. To do so, use the following CLI command or NetScaler configuration utility task to toggle the icon integration for VPN clients.

Setting icon integration with the command line

On the NetScaler command line, use the set vpn parameter command with the –iconWithReceiver option: 

set vpn parameter [-iconWithReceiver ( ON | OFF )]

Setting icon integration with the configuration utility

Using the NetScaler configuration utility:

1.    On the Configuration tab, navigate to NetScaler Gateway > Global Settings.

2.    Click Change Global Settings, and then select the Client Experience tab.

3.    Click Advanced Settings

4.    Select Show VPN Plug-in icon with Receiver (Figure 2).

localized image

Figure 2: Show VPN Icon control


You can toggle the icon integration as a global VPN setting, or you can override the global setting within session profiles.