系统配置

检测及关闭系统swap

本段介绍 swap 关闭方法。TiDB 运行需要有足够的内存，并且不建议使用 swap 作为内存不足的缓冲，这会降低性能。因此建议永久关闭系统 swap，并且不要使用 swapoff -a 方式关闭，否则重启机器后该操作会失效。

建议执行以下命令关闭系统 swap：

echo "vm.swappiness = 0">> /etc/sysctl.conf
swapoff -a && swapon -a
sysctl -p

配置SSH互信及sudo免密

# 添加用户
useradd -m -d /home/tidb tidb
# 设置登录密码为tidb123
echo "tidb123"|passwd --stdin tidb

# 添加sudoers文件读写权限
chmod u+w /etc/sudoers
# 编辑sudoers文件
vim /etc/sudoers

# 添加下面一行
tidb ALL=(ALL) NOPASSWD: ALL

部署TiDB

使用TiUP cluster部署

• 适用场景：希望用单台 Linux 服务器，体验 TiDB 最小的完整拓扑的集群，并模拟生产的部署步骤。
• 耗时：10 分钟

本节介绍如何参照 TiUP 最小拓扑的一个 YAML 文件部署 TiDB 集群。

准备环境

准备一台部署主机，确保其软件满足需求：

• 推荐安装 Ubuntu 16.04 及以上版本
• Linux 操作系统开放外网访问，用于下载 TiDB 及相关软件安装包

最小规模的 TiDB 集群拓扑：

部署主机软件和环境要求：

• 部署主机关闭防火墙或者开放 TiDB 集群的节点间所需端口
• 目前 TiUP 仅支持在 x86_64 (AMD64) 架构上部署 TiDB 集群（TiUP 将在 4.0 GA 时支持在 ARM 架构上部署）
  • 在 AMD64 架构下，建议使用 CentOS 7.3 及以上版本 Linux 操作系统
  • 在 ARM 架构下，建议使用 CentOS 7.6 1810 版本 Linux 操作系统

实施部署

注意：

你可以使用 Linux 系统的任一普通用户或 root 用户登录主机，以下步骤以 root 用户为例。

1. 下载并安装 TiUP：

   curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
   

2. 声明全局环境变量。

   source .bash_profile
   

   注意：

   TiUP 安装完成会提示对应的 profile 文件的绝对路径，以下 source 操作需要根据实际位置进行操作。

3. 安装 TiUP 的 cluster 组件：

   tiup cluster
   

4. 如果机器已经安装 TiUP cluster，需要更新软件版本：

   tiup update --self && tiup update cluster
   

5. 创建并启动集群

   按下面的配置模板，编辑配置文件，命名为 topo.yaml，其中：

   • user: "tidb"：表示通过 tidb 系统用户（部署会自动创建）来做集群的内部管理，默认使用 22 端口通过 ssh 登录目标机器
   • replication.enable-placement-rules：设置这个 PD 参数来确保 TiFlash 正常运行
   • host：设置为本部署主机的 IP

   配置模板如下：

   # # Global variables are applied to all deployments and used as the default value of
   # # the deployments if a specific deployment value is missing.
   global:
    user: "tidb"
    ssh_port: 22
    deploy_dir: "/tidb-deploy"
    data_dir: "/tidb-data"
   
   # # Monitored variables are applied to all the machines.
   monitored:
    node_exporter_port: 9100
    blackbox_exporter_port: 9115
   
   server_configs:
    tidb:
      log.slow-threshold: 300
    tikv:
      readpool.storage.use-unified-pool: false
      readpool.coprocessor.use-unified-pool: true
    pd:
      replication.enable-placement-rules: true
      replication.location-labels: ["host"]
    tiflash:
      logger.level: "info"
   
   pd_servers:
    - host: 10.0.1.1
   
   tidb_servers:
    - host: 10.0.1.1
   
   tikv_servers:
    - host: 10.0.1.1
      port: 20160
      status_port: 20180
      config:
        server.labels: { host: "logic-host-1" }
    - host: 10.0.1.1
      port: 20161
      status_port: 20181
      config:
        server.labels: { host: "logic-host-2" }
    - host: 10.0.1.1
      port: 20162
      status_port: 20182
      config:
        server.labels: { host: "logic-host-3" }
   
   tiflash_servers:
    - host: 10.0.1.1
   
   monitoring_servers:
    - host: 10.0.1.1
   
   grafana_servers:
    - host: 10.0.1.1
   

6. 执行集群部署命令：

   tiup cluster deploy tidb-test v5.0.0 ./topo.yaml --user tidb -p
   

   • 参数 <cluster-name> 表示设置集群名称
   • 参数 <tidb-version> 表示设置集群版本，可以通过 tiup list tidb 命令来查看当前支持部署的 TiDB 版本

   按照引导，输入”y”及 tidb密码，来完成部署：

   Do you want to continue? [y/N]:  y
   Input SSH password:
   

7. 启动集群：

   tiup cluster start tidb-test
   

8. 访问集群：

   • 安装 MySQL 客户端。如果已安装 MySQL 客户端则可跳过这一步骤。

     yum -y install mysql
     

   • 访问 TiDB 数据库，密码为空：

     mysql -h 10.0.1.1 -P 4000 -u root
     

   • 访问 TiDB 的 Grafana 监控：

     通过 http://{grafana-ip}:3000 访问集群 Grafana 监控页面，默认用户名和密码均为 admin。

   • 访问 TiDB 的 Dashboard：

     通过 http://{pd-ip}:2379/dashboard 访问集群 TiDB Dashboard 监控页面，默认用户名为 root，密码为空。

   • 执行以下命令确认当前已经部署的集群列表：

     tiup cluster list
     

   • 执行以下命令查看集群的拓扑结构和状态：

     tiup cluster display <cluster-name>