Configuring Load Balancing and High Availability with HAProxy

HAProxy is an open source utility that is available on most Linux distributions and cloud platforms for load-balancing TCP and HTTP requests. Users can leverage this tool to distribute incoming client requests among the region server nodes on which Splice Machine instances are running.

The advantages of using HAProxy with Splice Machine clusters are:

  • Users need to point to only one JDBC host and port for one Splice Machine cluster, which may have 100s of nodes.
  • The HAProxy service should ideally be running on a separate node that is directing the traffic to the region server nodes; this means that if one of the region server node goes down, users can still access the data from another region server node.
  • The load balance mechanism in HAProxy helps distribute the workload evenly among the set of nodes; you can optionally select this algorithm in your configuration, which can help increase throughput rate.

The remainder of this topic walks you through configuring HAProxy on a non-Splice Machine node that is running Red Hat Enterprise Linux.

Configuring HAProxy with Splice Machine

The following example shows you how to configure HAProxy load balancer on a non-Splice Machine node on a Red Hat Enterprise Linux system. Follow these steps:

  1. Install HAProxy as superuser :

    # yum install haproxy

    You may use a different haproxy package, depending on which Linux distribution you’re using.

  2. Configure the /etc/haproxy/haproxy.cfg file, following the comments in the sample file below:

    In this example, we set the incoming requests to haproxy_host:1527, which uses a balancing algorithm of least connections to distribute among the nodes srv127, srv128, srv129, and srv130. This means that the incoming connection is routed to the region server that has the least number of connections; thus, the client JDBC URL should point to <haproxy_host>:1527.

    The example below uses the least connections load-balancing algorithm. There are other load balancing algorithms, such as round robin, that can also be used, depending on the nature of your desired workload distribution.

    Here is the haproxy.cfg file for this example:

    # Global settings
        # to have these messages end up in /var/log/haproxy.log you will
        # need to:
        # 1) configure syslog to accept network log events.  This is done
        #    by adding the '-r' option to the SYSLOGD_OPTIONS in
        #    /etc/sysconfig/syslog
        # 2) configure local2 events to go to the /var/log/haproxy.log
        #   file. A line like the following can be added to
        #   /etc/sysconfig/syslog
        #    local2.*                       /var/log/haproxy.log
        maxconn 4000
        log local2
        user haproxy
        group haproxy
    # common defaults that all the 'listen' and 'backend' sections will
    # use if not designated in their block
        log global
        retries 2
        timeout connect 30000
        timeout server 50000
        timeout client 50000
    # This enables jdbc/odbc applications to connect to HAProxy_host:1527 port
    # so that HAProxy can balance between the splice engine cluster nodes
    # where each node's splice engine instance is listening on port 1527
    listen splice-cluster
        bind *:1527
        log global
        mode tcp
        option tcplog
        option tcp-check
        option log-health-checks
        timeout client 3600s
        timeout server 3600s
        balance leastconn
        server srv127 check
        server srv128 check
        server srv129 check
        server srv130 check
    # (Optional) set up the stats admin page at port 1936
    listen   stats :1936
        mode http
        stats enable
        stats hide-version
        stats show-node
        stats auth admin:password
        stats uri  /haproxy?stats

    Note that some of the parameters may need tuning per the sizing and workload nature:

    • The maxconnections parameter indicates how many concurrent connections are served at any given time; you may need to configure this, based on size of the cluster and expected inbound requests.
    • Similarly, the timeout values, which are by default in msecs, should be tuned so that the connection does not get terminated while a long-running query is executed.
  3. Start the HAProxy service:

    As superuser, follow these steps to enable the HAProxy service:

    Distribution Instructions
    # chkconfig haproxy on
    # service haproxy start

    If you change the configuaration file, reload it with this command:

    # service haproxy reload
    # systemctl enable haproxy
    ln -s '/usr/lib/systemd/system/haproxy.service
    # systemctl start haproxy

    If you change the configuaration file, reload it with this command:

    # systemctl haproxy reload

    You can find the HAProxy process id in: /var/run/ If you encounter any issues starting the service, check if Selinux is enabled; you may want to disable it initially.

  4. Connect:

    You can now connect JDBC clients, including the Splice Machine command line interpreter, Use the following JDBC URL:


    For ODBC clients to connect through HAProxy, ensure that the DSN entry in file .odbc.ini is pointing to the HAProxy host.

  5. Verify that inbound requests are being routed correctly:

    You can check the logs at /var/log/haproxy.log to make sure that inbound requests are being routed to Splice Machine region servers that are receiving inbound requests on port 1527.

  6. View traffic statistics:

    If you have enabled HAProxy stats, as in our example, you can view the overall traffic statistics in browser at:


    You’ll see a report that looks similar to this:

    HAProxy statistics