Skip to content

Installation

Tip

ECOX currently doesn't provide an online installation repository, so you need to obtain the installation package first. It is assumed that you have saved the installation package in the /opt/software directory.

sudo dnf install -y /opt/software/ecox-6alpha1-g1547a955e.rocky9.6.x86_64.rpm

sudo apt install -y /opt/software/ecox_6alpha1-g1547a955e.ubuntu24.04_amd64.deb

sudo apt install -y /opt/software/ecox_6alpha1-g1547a955e.debian12_amd64.deb

Note

The following software packages are required for the VIP feature.

sudo dnf install -y iputils iproute sudo

sudo apt install -y iputils-arping iproute2 sudo

sudo apt install -y iputils-arping iproute2 sudo

ECOX is installed by default in the /opt/ecox-6alpha1 directory, and its directory structure as follows:

/opt/ecox-6alpha1/
├── bin
├── etc
├── lib
└── share
  • bin the directory stores binary files.
  • etc the directory stores template files, such as ecox.conf.sample.
  • lib the directory stores dynamic libraries that the ECOX runtime depends on.
  • share the directory stores other files, such as man page.

ECOX requires a license to use. You can purchase or apply for a license by emailing support@ww-it.cn. Once you obtain the license, save it to /opt/ecox-6alpha1/LICENSE.

Tip

ECOX license is tied to the PostgreSQL instance, so you'll need to provide the database identifier when applying for a license. You can obtain this by running the following command:

LANG=C pg_controldata -D $PGDATA | grep 'Database system identifier'

Replace $PGDATA with your database directory path.