TiUP FAQ

Is it possible to not use the official mirror source for TiUP?

TiUP supports specifying the mirror source through the environment variable TIUP_MIRRORS. The address of the mirror source can be a local directory or HTTP server address.If the user's environment cannot access the network, you can create your own offline mirror source to use TiUP.

If you want to switch back to the official mirror after using an unofficial mirror, you can do one of the following:

• Set the TIUP_MIRRORS variable to the address of the official mirror: https://tiup-mirrors.pingcap.com.
• Make sure the TIUP_MIRRORS variable is not set, and then execute the tiup mirror set https://tiup-mirrors.pingcap.com command.

How to put the components written by yourself into the TiUP mirror warehouse?

TiUP does not support externally developed components for the time being, but TiUP Team has formulated the TiUP component development specification and is developing the tiup-publish component. After the tiup-publish component is completed, developers can use tiup publish Publish the components developed by yourself to TiUP's official mirror repository.

What is the difference between tiup-playground and tiup-cluster?

TiUP Playground component is mainly positioned to quickly get started and build a stand-alone development environment. It supports Linux/macOS, and it is easier to run a TiUP cluster of a specified version.TiUP Cluster components mainly deploy production environment clusters, usually a large-scale cluster, and also include operations related to operation and maintenance.

How to write the topology file of the tiup-cluster component?

You can refer to the Example of the topology file.Examples include:

1. Three centers in two places
2. Minimum deployment topology
3. Complete topology file

You can choose different templates to edit according to your needs.

Can multiple instances be deployed on the same host?

Multiple instances can be deployed on the same host using TiUP Cluster, but different ports and directory information need to be configured. Otherwise, directory and port conflicts may occur.

Is it possible to detect port and directory conflicts within the same cluster?

The port and directory conflicts of the same cluster will be detected during deployment and expansion. If there is a directory and port conflict, the deployment or expansion will be interrupted.

Is it possible to detect port and directory conflicts in different clusters?

If different clusters are deployed by the same TiUP central control machine, they will be detected during deployment and expansion. If they belong to different TiUP central control machines, detection is currently not supported.

During cluster deployment, TiUP received an error ssh: handshake failed: read tcp 10.10.10.34:38980 -> 10.10.10.34:3600: read: connection reset by peer

This error may be caused by the default concurrency of TiUP exceeding the default maximum number of ssh connections. You can try to increase the default number of ssh connections, and then restart the sshd service to solve the problem:

vi /etc/ssh/sshd_config MaxSessions 1000 MaxStartups 1000