Build on CentOS
Instructions for building Vitess on your machine for testing and development purposes
The following has been verified to work on CentOS 7. If you are new to Vitess, it is recommended to start with the local install guide instead.
Install Dependencies #
Install Go #
Download and install Golang. Vitess is tested and shipped using a specific Golang version for each release.
For maximum compatibility we encourage you to use the same Golang version as the one mentioned in our build.env
file.
Install Node 16.13.0+ #
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
Ensure the following is in your bashrc/zshrc or similar:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
Finally, install node:
nvm install --lts 16.13.0
nvm use 16.13.0
See the vtadmin README for more details.
Packages from CentOS repos #
First install the MySQL repository from Oracle:
sudo yum localinstall -y https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
sudo yum install -y mysql-community-server
Install additional dependencies required to build and run Vitess:
sudo yum install -y make unzip g++ etcd curl git wget
Notes:
- We will be using etcd as the topology service. The command
make tools
can also install Zookeeper or Consul for you, which requires additional dependencies.
Disable SELinux #
SELinux will not allow Vitess to launch MySQL in any data directory by default. You will need to disable it:
sudo setenforce 0
Build Vitess #
Navigate to the directory where you want to download the Vitess source code and clone the Vitess GitHub repo:
cd ~
git clone https://github.com/vitessio/vitess.git
cd vitess
Set environment variables that Vitess will require. It is recommended to put these in your .bashrc
:
# Additions to ~/.bashrc file
#VTDATAROOT
export VTDATAROOT=/tmp/vtdataroot
# Vitess binaries
export PATH=~/vitess/bin:${PATH}
Build Vitess:
make build
Since the addition of #13263 the vtadmin
React application will be built when doing a make build
.
You can skip this step by setting the NOVTADMINBUILD
environment variable.
NOVTADMINBUILD=1 make build
Testing your Binaries #
The unit tests require the following additional packages:
sudo yum install -y ant maven zip gcc
You can then install additional components from make tools
. If your machine requires a proxy to access the Internet, you will need to set the usual environment variables (e.g. http_proxy
, https_proxy
, no_proxy
) first:
make tools
make unit_test
In addition to running tests, you can try running the local example.
Common Build Issues #
Key Already Exists #
This error is because etcd was not cleaned up from the previous run of the example. You can manually fix this by running ./401_teardown.sh
, removing vtdataroot and then starting again:
Error: 105: Key already exists (/vitess/zone1) [6]
Error: 105: Key already exists (/vitess/global) [6]
MySQL Fails to Initialize #
This error is most likely the result of SELinux enabled:
1027 18:28:23.462926 19486 mysqld.go:734] mysqld --initialize-insecure failed: /usr/sbin/mysqld: exit status 1, output: mysqld: [ERROR] Failed to open required defaults file: /home/morgo/vitess/vtdataroot/vt_0000000102/my.cnf
mysqld: [ERROR] Fatal error in defaults handling. Program aborted!
could not stat mysql error log (/home/morgo/vitess/vtdataroot/vt_0000000102/error.log): stat /home/morgo/vitess/vtdataroot/vt_0000000102/error.log: no such file or directory
E1027 18:28:23.464117 19486 mysqlctl.go:254] failed init mysql: /usr/sbin/mysqld: exit status 1, output: mysqld: [ERROR] Failed to open required defaults file: /home/morgo/vitess/vtdataroot/vt_0000000102/my.cnf
mysqld: [ERROR] Fatal error in defaults handling. Program aborted!
E1027 18:28:23.464780 19483 mysqld.go:734] mysqld --initialize-insecure failed: /usr/sbin/mysqld: exit status 1, output: mysqld: [ERROR] Failed to open required defaults file: /home/morgo/vitess/vtdataroot/vt_0000000101/my.cnf
mysqld: [ERROR] Fatal error in defaults handling. Program aborted!