Product Documentation

Session Reliability on NetScaler High Availability Pair

Oct 19, 2016

When a network disruption or a device failover occurs during an ICA session, session reconnection can use one of two mechanisms: Session Reliability or Auto Client Reconnect.

Session Reliability, the preferred mode, is a seamless experience for the user. The disruption is barely noticeable for brief network interruptions.

Auto Client Reconnect, the fallback option, involves restarting the client. This mechanism is disruptive for the user and is not always supported.

All the receivers currently support both mechanisms when HDX Insight is not enabled. When HDX Insight is enabled, the receivers support both ACR and SR reconnect modes, and supports both modes in the network disruption scenario, but only ACR in the NetScaler high availability failover scenario. For high availability mode, you need to manually enable Session reliability mode to achieve the same.


You should not Enable or disable Session Reliability mode when the NetScaler appliances have active connections. Enabling or Disabling the feature when connections are still active causes HDX Insight to stop parsing those sessions after a failover occurs and result in loss of information about the sessions.

To configure Session reliability from NetScaler CLI

  1. At the command line, use the default system administrator credentials to log on to the system.
  2. To enable Session Reliability on HA failover, at the prompt, type: set ica parameter EnableSRonHAFailover YES
  3. To disable Session Reliability on HA failover, at the prompt, type: set ica parameter EnableSRonHAFailover NO

To Enable Session reliability on HA failover from NetScaler GUI

  1. In a web browser, type the IP address of the primary NetScaler instance in the HA pair (for example,
  2. In User Name and Password, enter the administrator credentials.
  3. On the Configuration tab, navigate to System > Settings, and click Change ICA Parameters.
  4. In in the Change ICA parameters section, select Session Reliability on HA Failover.
  5. Click OK


  • Enabling this feature will result in increased bandwidth consumption which is due to ICA compression being turned off by the feature, and the extra traffic between the primary and secondary nodes to keep them in sync.
  • This feature is supported in Active-Passive mode only. Active-Active mode is not currently supported.