HTML Access can monitor the network quality during remote sessions and display a notification message if it detects network instability due to high latency. The network latency is measured in terms of the round-trip time (RTT) metric.

You can configure HTML Access settings to control the display of these notification messages. You can also configure the threshold parameters used by HTML Access to identify unstable networks.

Configure the Display of Network Notification Messages

To turn on and off notification messages, click the Settings toolbar button in the upper-right corner of the desktop and application selector window and toggle the Disable network state display option.

Customize How HTML Access Determines the Network Quality

To determine the quality of the network connection, HTML Access compares the detected RTT value during a specified time interval to a pair of low and high threshold values and calculates a quality score from 0 through 100 percent. If the score falls below a certain percentage, the network is deemed to be high-latency and unstable.

HTML Access uses the following rules to calculate the network quality score:

Definitions:
rtt = detected RTT value
lowBound = low threshold value
highBound = high threshold value
score = network quality score

If rtt >= highBound, then score = 0

If rtt <= lowBound, then score = 100

If lowBound < rtt < highBound, then score = 100 * ((rtt - lowBound) / (highBound - lowBound))

HTML Access then uses the following rules to determine the network stability:

Definitions:
score = network quality score
thresholdGood = minimum score required to indicate good network stability
thresholdPoor = high limit of score range indicating poor network stability

If score >= thresholdGood, the network is considered good and no notification is displayed.

If thresholdPoor <= score < thresholdGood, the network is considered OK and no notification is displayed.

If score < thresholdPoor, the network is considered poor and a notification is displayed.

You can use the following steps to customize the threshold values used by HTML Access to calculate the network quality score and determine network stability.

  1. Log in to the Horizon Connection Server host machine with administrator privileges.
  2. Navigate to the Program Files/VMware/VMware View/Server/broker/webapps/portal/WEB-INF/classes directory.
  3. Open the portal-version.properties file in a text editor.
  4. Specify the following properties in the configuration file.
    Property Valid Values Description
    enableNetworkIndicator true or false

    Specifies whether to activate the network notification feature (true) or deactivate the feature (false).

    Setting the value to false removes the Disable network state display option from the Settings window.

    The default value is true.
    networkState.TcpRttMSLow A positive integer

    The low RTT threshold value used to calculate the network quality score. This value must be less than the networkState.TcpRttMSHigh value. This value corresponds to the "lowBound" variable in the rules described earlier.

    The default value is 2.
    networkState.TcpRttMSHigh A positive integer

    The high RTT threshold value used to calculate the network quality score. This value must be greater than the networkState.TcpRttMSLow value. This value corresponds to the "highBound" variable in the rules described earlier.

    The default value is 400.
    networkState.TcpThresholdGood A percentage from 0 through 100

    The minimum score required to indicate good network stability. This value must be greater than the networkState.TcpThresholdPoor value. This value corresponds to the "thresholdGood" variable in the rules described earlier.

    The default value is 85.
    networkState.TcpThresholdPoor A percentage from 0 to 100

    The high limit of the score range indicating poor network stability. This value must be less than the networkState.TcpThresholdGood value. This value corresponds to the "thresholdPoor" variable in the rules described earlier.

    The default value is 40.
    networkState.RttCheckPeriodMs An integer greater than 2000

    The time interval, in milliseconds, during which network RTT is monitored.

    The default value is 15000.