Doc Menu

Testing Deployment from Binary Tarball

This guide provides installation instructions for all TiDB components across multiple nodes for testing purposes. It does not match the recommended usage for production systems.

See also local deployment and production environment deployment.

Prepare

Before you start, see TiDB architecture and Software and Hardware Recommendations. Make sure the following requirements are satisfied:

Operating system

For the operating system, it is recommended to use RHEL/CentOS 7.3 or higher. The following additional requirements are recommended:

ConfigurationDescription
Supported PlatformRHEL/CentOS 7.3+ (more details)
File Systemext4 is recommended
Swap SpaceShould be disabled
Disk Block SizeSet the system disk Block size to 4096

Network and firewall

ConfigurationDescription
Firewall/PortCheck whether the ports required by TiDB are accessible between the nodes

Operating system parameters

ConfigurationDescription
Nice LimitsFor system users, set the default value of nice in TiDB to 0
min_free_kbytesThe setting for vm.min_free_kbytes in sysctl.conf needs to be high enough
User Open Files LimitFor database administrators, set the number of TiDB open files to 1000000
System Open File LimitsSet the number of system open files to 1000000
User Process LimitsFor TiDB users, set the nproc value to 4096 in limits.conf
Address Space LimitsFor TiDB users, set the space to unlimited in limits.conf
File Size LimitsFor TiDB users, set the fsize value to unlimited in limits.conf
Disk ReadaheadSet the value of the readahead data disk to 4096 at a minimum
NTP serviceConfigure the NTP time synchronization service for each node
SELinuxTurn off the SELinux service for each node
CPU Frequency ScalingIt is recommended to turn on CPU overclocking
Transparent HugepagesFor Red Hat 7+ and CentOS 7+ systems, it is required to set the Transparent Hugepages to always
I/O SchedulerSet the I/O Scheduler of data disks to the deadline mode
vm.swappinessSet vm.swappiness = 0 in sysctl.conf
net.core.somaxconnSet net.core.somaxconn = 32768 in sysctl.conf
net.ipv4.tcp_syncookiesSet net.ipv4.tcp_syncookies = 0 in sysctl.conf

Database running user settings

ConfigurationDescription
LANG environmentSet LANG = en_US.UTF8
TZ time zoneSet the TZ time zone of all nodes to the same value

TiDB components and default ports

Before you deploy a TiDB cluster, see the required components and optional components.

TiDB database components (required)

See the following table for the default ports for the TiDB components:

ComponentDefault PortProtocolDescription
ssh22TCPthe sshd service
TiDB4000TCPthe communication port for the application and DBA tools
TiDB10080TCPthe communication port to report TiDB status
TiKV20160TCPthe TiKV communication port
PD2379TCPthe communication port between TiDB and PD
PD2380TCPthe inter-node communication port within the PD cluster

TiDB database components (optional)

See the following table for the default ports for the optional TiDB components:

ComponentDefault PortProtocolDescription
Prometheus9090TCPthe communication port for the Prometheus service
Pushgateway9091TCPthe aggregation and report port for TiDB, TiKV, and PD monitor
Node_exporter9100TCPthe communication port to report the system information of every TiDB cluster node
Grafana3000TCPthe port for the external Web monitoring service and client (Browser) access
alertmanager9093TCPthe port for the alert service

Create a database running user account

  1. Log in to the machine using the root user account and create a database running user account (tidb) using the following command:

    useradd tidb -m
  2. Switch the user from root to tidb by using the following command. You can use this tidb user account to deploy your TiDB cluster.

    su - tidb

Download the official binary package

  1. Download the package.

    wget https://download.pingcap.org/tidb-v3.0-linux-amd64.tar.gz https://download.pingcap.org/tidb-v3.0-linux-amd64.sha256
  2. Check the file integrity. If the result is OK, the file is correct.

    sha256sum -c tidb-v3.0-linux-amd64.sha256
  3. Extract the package.

    tar -xzf tidb-v3.0-linux-amd64.tar.gz &&
    cd tidb-v3.0-linux-amd64

Multiple nodes cluster deployment for test

If you want to test TiDB but have a limited number of nodes, you can use one PD instance to test the entire cluster.

Assuming that you have four nodes, you can deploy 1 PD instance, 3 TiKV instances, and 1 TiDB instance. See the following table for details:

NameHost IPServices
Node1192.168.199.113PD1, TiDB
Node2192.168.199.114TiKV1
Node3192.168.199.115TiKV2
Node4192.168.199.116TiKV3

Follow the steps below to start PD, TiKV and TiDB:

  1. Start PD on Node1.

    ./bin/pd-server --name=pd1 \
                    --data-dir=pd \
                    --client-urls="http://192.168.199.113:2379" \
                    --peer-urls="http://192.168.199.113:2380" \
                    --initial-cluster="pd1=http://192.168.199.113:2380" \
                    --log-file=pd.log &
  2. Start TiKV on Node2, Node3 and Node4.

    ./bin/tikv-server --pd="192.168.199.113:2379" \
                      --addr="192.168.199.114:20160" \
                      --data-dir=tikv \
                      --log-file=tikv.log &
    
    ./bin/tikv-server --pd="192.168.199.113:2379" \
                      --addr="192.168.199.115:20160" \
                      --data-dir=tikv \
                      --log-file=tikv.log &
    
    ./bin/tikv-server --pd="192.168.199.113:2379" \
                      --addr="192.168.199.116:20160" \
                      --data-dir=tikv \
                      --log-file=tikv.log &
  3. Start TiDB on Node1.

    ./bin/tidb-server --store=tikv \
                      --path="192.168.199.113:2379" \
                      --log-file=tidb.log
  4. Use the MySQL client to connect to TiDB.

    mysql -h 192.168.199.113 -P 4000 -u root -D test