Skip to main content

March 14, 2026

Troubleshooting High Availability

You might experience difficulty when you configure High Availability in your environment. You can use a variety of procedures for diagnosing and fixing these problems.

  1. Log in to Unified Access Gateway console.

  2. Run ip addr command to check if the configured virtual IP address is assigned to eth0 interface.

  3. Ensure virtual IP address is assigned within the same subnet as eth0 interface. Ensure it is reachable from the client machine. If there are connectivity issues then it could be due to virtual IP address not being unique and already assigned to a physical or virtual machine.

  4. In the haproxy.conf file in log bundle, configuration related to the current cluster is available. For example,

    server uag1 127.0.0.1:XXXX .....
    server uag2 <IP of machine 2>:XXXX ....
    server uag3 <IP of machine 3>:XXXX ....
    

    The back-end configuration is based on the settings configured on Unified Access Gateway

    • lb_esmanageris for Horizon and Web reverse proxy use cases.
    • lb_cg_server is for Content Gateway use cases.
    • lb_tunnel_server is for Tunnel use cases.
  5. In the haproxy.conf file in log bundle, you can find details about the client connection source, corresponding connection sent, and the Unified Access Gateway server that handles the connections. For example,

    2018-11-27T07:21:09+00:00 ipv6-localhost haproxy[15909]:
    				incoming:::ffff:<IP of Client:xxxx> backend:lb_esmanager
    				connecting-server:uag2/<IP of uag2> connecting-through:<IP of primary
    				node:xxxx> wait-time:1 connect-time:0 total-incoming:1 total-outgoing:1
    				total-to-server:1
    			 
    
  6. To view the statistics, see Collecting Logs from the Unified Access Gateway Appliance.

    Example of a CSV File

    Column NameDescription
    scurIndicates the current number of concurrent connections handled by this server.
    smaxHigh watermark of concurrent connections handled by this server during current uptime.
    stotIndicates the total number of connections handled by this server during current uptime.
    binIndicates the total number of bytes sent to this server.
    boutIndicates the total number of bytes received from this server.
    statusIndicates the status of the server. For example, if it is up or down. This is based on the last health check performed on this server.
  7. Multiple primary node election issues can be seen in the following cases,

    • Different group ID or virtual IP address configured on the nodes that are intended to form the cluster.
    • Virtual IP address and eth0 in different subnet.
    • Multiple NICS on Unified Access Gateway configured within the same subnet.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…