TiDB instance fails to start when launching the cluster

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

Original topic: 启动集群时TiDB instance启动失败

| username: TiDBer_NUP2nMAg

| username: dba-kit | Original post link

It might be because you have installed everything on the same machine, and the machine’s resources are insufficient, causing the tidb-server to take more than 2 minutes to start. You can first use tiup cluster display to check the cluster status. If there are any anomalies, you can continue by executing tiup cluster start <cluster-name> --wait-timeout 3600.

| username: buddyyuan | Original post link

This kind of issue generally requires checking the operating system logs, specifically /var/log/message. It will show the reason for the failure. Common reasons include incorrect parameter settings or directory permission issues.

| username: 考试没答案 | Original post link

TiDB is stateless. I encountered three solutions:

  1. Check the TiDB logs of the target instance.
  2. Inspect the firewall, fearing that SSH access might be blocked or the port might be firewalled.
  3. If everything seems fine but it still won’t start, perform a scale-out or scale-in.
    For high-availability systems, especially TiDB, there are no issues at all.
| username: tidb菜鸟一只 | Original post link

Check the logs, you can’t tell much from this.