google /seesaw
Seesaw v2 is a Linux Virtual Server (LVS) based load balancing platform.
★ 5,676⑂ 504👁 272⑃ 101● 45▤ 0
+0
日增长
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
#107centos7.9 Failed to initialise LB interface: Failed to get network interface: route ip+net: no such network interface10 comments · 2020-12-25#33Unable to start seesaw10 comments · 2017-04-26#125Health Check notification - Send failed2 comments · 2023-03-01#117Support for clients on realservers1 comments · 2022-11-06#104engine.sock no such file or directory1 comments · 2020-10-06#55Error while setting up1 comments · 2019-09-19#133Virtual IPs in different networks supported?0 comments · 2023-10-24#116Any chance I can get it working with a macvlan interface?0 comments · 2022-09-30