ADC

Session reliability on NetScaler high availability pair

May 2, 2023

Contributed by:

S C

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 smooth 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.

Receivers can reconnect their ICA sessions seamlessly using the ICA session reliability feature, when HDX Insight is enabled. This feature works both in standalone and in a NetScaler HA pair configuration, and even when a NetScaler failover happens.

Note:

NetScaler appliances must be running on software version 11.1 build 49.16 or later.

You must 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. It results in the loss of information about the sessions.

Session reliability on a high availability setup is disabled by default for NetScaler software version 11.1 49.16 or later. Session reliability is supported on a high availability setup only if both the nodes of the setup run the same build (for example, release 11.1 build 53). In other words, session reliability is not supported on a high availability setup if both the nodes run different builds (for example, one node has release 11.1 build 53 whereas the other has release 11.1 build 56). Session reliability for SSL VDA is supported if the following conditions are met:

The “EnableSRonHAFailover” parameter in the set ica parameter command must be YES.

The HTTPS must be used instead of HTTP while configuring the virtual server.

When HDX Insight is enabled, basic encryption applications and desktops reconnect after high availability failover even if the EnableSRonHAFailover parameter is disabled.

To configure Session reliability by using CLI:

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

To Enable Session reliability on HA failover by using GUI:

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

Limitations

Enabling this feature results 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.
When HDX Insight is enabled, and session reliability on the HA knob is set to NO, only ACR reconnect mode is supported in the NetScaler high availability failover scenario. The HA knob does not disable session reliability if HDX Insight is disabled.

The Session Reconnect Semantics table is as follows:

Session reconnects semantics

Status	EnableSRonHAFailover Yes	EnableSRonHAFailover No (Default)
HDX Insight enabled	Session reconnect for ICA Session works	Session reconnect for ICA Sessions does not work
HDX Insight disabled	Session reconnect for ICA Session works	Session reconnect for ICA Sessions works

Points to note

Session reliability for ICA sessions works out of the box with NetScaler Gateway.
Session reliability for ICA sessions does not work when both the following conditions are met:
- HDX Insight is enabled
- EnableSRonHAFailover is set to NO
Setting the EnableSRonHAFailover knob to either YES or NO does not make any difference, when HDX Insight is disabled.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Session reliability on NetScaler high availability pair

May 2, 2023

Contributed by:

S C

May 2, 2023

Contributed by:

S C

Session reliability on NetScaler high availability pair

Limitations

Session reconnects semantics

In this article