Home

Awesome

ZEVENET Load Balancer

This is the repository of ZEVENET Load Balancer Community Edition (Zen Load Balancer CE next generation) and it'll guide you to install a development and testing instance of load balancer.

ZEVENET becomes SKUDONET and RELIANOID ZEVENET project and brand is in the process of extinction in favor of the two new awesome projects called SKUDONET and RELIANOID which will ensure the continuity of the Zevenet products and services to all our customers and users. Both projects are legitimate to continue with the great work done all these years with Zevenet. You’re in good hands.

Repository Contents

In this repository you'll find the source code usually placed into the folder /usr/local/zevenet/ with the following structure:

ZEVENET Load Balancer Installation

Currently, there is only available package for Debian Buster, the installation is not supported out of this operating system.

There are two options to deploy a ZEVENET load balancer: The first is deploying the ZEVENET CE ISO, and the other is deploying a Debian Buster image and installing ZEVENET with its dependencies.

ISO

ZEVENET CE ISO is a Debian Buster template with ZEVENET already installed. It can be got from the following link, clicking on the "Download ISO image" button.

https://www.zevenet.com/products/community/

Installation on Debian Buster

If you prefer install ZEVENET yourself, you should get a Debian ISO installable from debian.org. This installation process has been only tested with the 64 bits version.

Please, take into account these requirements before installing the load balancer:

  1. You'll need at least 1,5 GB of storage.

  2. Install a fresh and basic Debian Buster (64 bits) system with openssh and the basic system tools package recommended during the distribution installation.

  3. Configure the load balancer with a static IP address. ZEVENET Load Balancer doesn't support DHCP yet.

  4. Configure the apt repositories in order to be able to install some dependencies.

This git repository only contains the source code, the installable packages based in this code are updated in our Zevenet APT repos, you can use them configuring your Debian Buster system as follows:

root@zevenetlb#> echo "deb http://repo.zevenet.com/ce/v5 buster main" >> /etc/apt/sources.list.d/zevenet.list
root@zevenetlb#> wget -O - http://repo.zevenet.com/zevenet.com.gpg.key | apt-key add -

Now, update the local APT database

root@zevenetlb#> apt-get update

And finally, install the ZEVENET CE

root@zevenetlb#> apt-get install zevenet

Updates

Please use the ZEVENET APT repo in order to check if updates are available.

How to Contribute

You can contribute with the evolution of the ZEVENET Load Balancer in a wide variety of ways:

Reporting Bugs

  1. Please use the GitHub project Issues to report any issue or bug with the software.
  2. Try to describe the problem and a way to reproduce it.
  3. To facilitate troubleshooting from our side, attach supportsave, tcpdump and .har files. Also, attach any screenshot if necessary.
  4. In case these files contain sensible information that the user does not want to share in GitHub, please send an email to ce-support@zevenet.com with the same subject as the issue title published in GitHub and the relevant files attached.

Generating Support Files

First of all, enable debugging in the farms affected:

HTTP/S:
cd /usr/local/zevenet/config
sed -i '/^LogLevel/c\LogLevel 7' FARMNAME_proxy.cfg` (replace FARMNAME with the name of the farm in question)

Restart the farm

L4XNAT:
cd /usr/local/zevenet/config
sed -i '/^\$nftlb_debug/c\$nftlb_debug="9"' global.conf
/etc/init.d/zevenet stop
/etc/init.d/zevenet start

If the debug log are enabled, more information can be logged and it will help us to analyze the problem.

Then, proceed to collect the information that we need to start troubleshooting:

SUPPORTSAVE:
.HAR FILE:
TCPDUMP FILE:
tcpdump -s 65535 -w <file>` (replace <file> with the filename where you want to capture the dump)
SCREENSHOTS:

Development & Resolving Bugs

In order to commit any change, as new features, bug fix or improvement, just perform a git clone of the repository, git add when all the changes has been made and git commit when you're ready to send the change.

During the submit, please ensure that every change is associated to a logical change in order to be easily identified every change.

In the commit description please use the following format:

[CATEGORY] CHANGE_SHORT_DESCRIPTION

OPTIONAL_LONGER_DESCRIPTION

SIGNED_OFFS

MODIFIED_FILES

Where:

Usually, executing git commit -a -s will create the fields described above.

Finally, just execute a git push and request a pull of your changes. In addition, you can use git format-patch to create your patches and send them through the official distribution list.

Creating & Updating Documentation or Translations

In the official GitHub wiki there is available a list of pages and it's translations. Please clone the wiki, apply your changes and request a pull in order to be applied.

Helping another Users

The official distribution list could be accessed through the zevenet-ce-users google group.

To post in this group, send email to zevenet-ce-users@zevenet.com.

But you need to request a join first into the group by sending an email to zevenet-ce-users+subscribe@zevenet.com.

To unsubscribe from this group, send email to zevenet-ce-users+unsubscribe@zevenet.com

For more options, visit https://groups.google.com/a/zevenet.com/d/optout

www.zevenet.com