Common Issues When Installing a Single-Node TiDB Cluster Environment

This topic has been translated from a Chinese forum by GPT and might contain errors.

Original topic: 安装TiDB单机集群环境常见问题

| username: 魔礼养羊

[TiDB Usage Environment] Testing
[TiDB Version] 6.5.1
[Reproduction Path] Two issues encountered during Tiup deployment of a single-node test environment
[Encountered Issues: yaml file, operation deployment]

  1. The command for installing a single-node test environment lacks an operational example.
    TiDB 数据库快速上手指南 | PingCAP 文档中心
    The command line is: tiup cluster deploy ./topo.yaml --user root -p
    Suggested example: tiup cluster deploy cluster-zhangsan v6.5.1 ./topo.yaml --user root -p

  2. yaml file validation
    Original text: "Create and start the cluster
    Edit the configuration file according to the following configuration template and name it topo.yaml, in which:

  • user: "tidb": Indicates that the cluster’s internal management is done through the tidb system user (which will be automatically created during deployment), and the default is to use port 22 to log in to the target machine via ssh
  • replication.enable-placement-rules: Set this PD parameter to ensure TiFlash runs properly
  • host: Set to the IP of the host being deployed
    The configuration template is as follows:"
    In practice, theoretically, you only need to modify the IP in the yaml file, but there are too many unexpected factors during the copying process.
    It is recommended to first copy the template content to this website:
    Then modify the IP address and copy it to the topo.yaml file…
    Do not change this process, otherwise, even a single space can cause you a lot of trouble.
| username: xingzhenxiang | Original post link

The system generates the configuration file demo, you just need to modify it.

| username: 魔礼养羊 | Original post link

Hello, where is the system-generated demo file located?
I manually edit it every time I deploy, which is very troublesome.

| username: xingzhenxiang | Original post link

I have provided the URLs above, just click on them, right?