This document collects the frequently asked questions (FAQs) about TiUP.
TiUP supports specifying the mirror source through the
TIUP_MIRRORS environment variable. The address of the mirror source can be a local directory or an HTTP server address. If your environment cannot access the network, you can create your own offline mirror source to use TiUP.
After using an unofficial mirror, if you want the official mirror back and use it, take one of the following measures:
- Set the
TIUP_MIRRORSvariable to the official mirror address:
- Make sure that the
TIUP_MIRRORSvariable is not set, and then execute the
tiup mirror set https://tiup-mirrors.pingcap.comcommand.
TiUP does not support third-party components for the time being, but the TiUP Team has developed the TiUP component development specifications and is developing the tiup-publish component. After everything is ready, a contributor can publish their own components to TiUP's official mirrors by using the
tiup publish <comp> <version> command.
The TiUP playground component is mainly used to build a stand-alone development environment on Linux or macOS operating systems. It helps you get started quickly and run a specified version of the TiUP cluster easily. The TiUP cluster component is mainly used to deploy and maintain a production environment cluster, which is usually a large-scale cluster.
Refer to these templates to write the topology file. The templates include:
- Multi-DC deployment topology
- Minimal deployment topology
- Complete topology file
You can edit your topology file based on the templates and your needs.
You can use the TiUP cluster component to deploy multiple instances on the same host, but with different ports and directories configured; otherwise, directory and port conflicts might occur.
Port and directory conflicts in the same cluster are detected during deployment and scaling. If there is any directory or port conflict, the deployment or scaling process is interrupted.
If multiple different clusters are deployed by the same TiUP control machine, the port and directory conflicts among these clusters are detected during deployment and scaling. If the clusters are deployed by different TiUP control machines, conflict detection is not supported currently.
During cluster deployment, TiUP received an
ssh: handshake failed: read tcp 10.10.10.34:38980 -> 10.10.10.34:3600: read: connection reset by peer error
The error might occur because the default number of concurrent threads of TiUP exceeds the default maximum number of SSH connections. To solve the issue, you can increase the default number of SSH connections, and then restart the sshd service:
MaxSessions 1000 MaxStartups 1000