google /seesaw

Seesaw v2 is a Linux Virtual Server (LVS) based load balancing platform.

★ 5,676⑂ 504👁 272⑃ 101● 45▤ 0
GoApache-2.0Created 2015-12-04
+0
Daily
5,676
stars
504
forks
272
watchers
101
prs
45
issues
0
releases

README

Seesaw v2



Note: This is not an official Google product.

 About

Seesaw v2 is a Linux Virtual Server (LVS) based load balancing platform.

It is capable of providing basic load balancing for servers that are on the
same network, through to advanced load balancing functionality such as anycast,
Direct Server Return (DSR), support for multiple VLANs and centralised
configuration.

Above all, it is designed to be reliable and easy to maintain.

 Requirements

A Seesaw v2 load balancing cluster requires two Seesaw nodes - these can be
physical machines or virtual instances. Each node must have two network
interfaces - one for the host itself and the other for the cluster VIP. All
four interfaces should be connected to the same layer 2 network.

 Building

Seesaw v2 is developed in Go and depends on several Go packages:

- golang.org/x/crypto/ssh
- github.com/dlintw/goconf
- github.com/golang/glog
- github.com/golang/protobuf/proto
- github.com/miekg/dns

Additionally, there is a compile and runtime dependency on
libnl

On a Debian/Ubuntu style system, you should be able to prepare for building
by running:

    apt-get install golang
    apt-get install libnl-3-dev libnl-genl-3-dev

If your distro has a go version before 1.18, you may need to fetch a newer
release from https://golang.org/dl/.

If you are running before go version 1.11 or you want to set GO111MODULE=off,
after setting GOPATH to an appropriate location (for example ~/go):

    go get -u golang.org/x/crypto/ssh
    go get -u github.com/dlintw/goconf
    go get -u github.com/golang/glog
    go get -u github.com/miekg/dns
    go get -u github.com/kylelemons/godebug/pretty
    go get -u github.com/golang/protobuf/proto

Ensure that ${GOPATH}/bin is in your ${PATH} and in the seesaw directory:

    make test
    make install

If you wish to regenerate the protobuf code, the protobuf compiler is needed:

    apt-get install protobuf-compiler

The protobuf code can then be regenerated with:

    make proto

 Installing

After make install has run successfully, there should be a number of
binaries in ${GOPATH}/bin with a seesaw_ prefix. Install these to the
appropriate locations:

    SEESAW_BIN="/usr/local/seesaw"
    SEESAW_ETC="/etc/seesaw"
    SEESAW_LOG="/var/log/seesaw"

    INIT=ps -p 1 -o comm=

    install -d "${SEESAW_BIN}" "${SEESAW_ETC}" "${SEESAW_LOG}"

    install "${GOPATH}/bin/seesaw_cli" /usr/bin/seesaw

    for component in {ecu,engine,ha,healthcheck,ncc,watchdog}; do
      install "${GOPATH}/bin/seesaw_${component}" "${SEESAW_BIN}"
    done

    if [ $INIT = "init" ]; then
      install "etc/init/seesaw_watchdog.conf" "/etc/init"
    elif [ $INIT = "systemd" ]; then
      install "etc/systemd/system/seesaw_watchdog.service" "/etc/systemd/system"
      systemctl --system daemon-reload
    fi
    install "etc/seesaw/watchdog.cfg" "${SEESAW_ETC}"

     Enable CAP_NET_RAW for seesaw binaries that require raw sockets.
    /sbin/setcap cap_net_raw+ep "${SEESAW_BIN}/seesaw_ha"
  

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON