TiUP 故障排查

    本文介绍 TiUP 使用过程中一些常见的故障及排查方式，如果本文不包含你目前遇到的问题，可以通过以下方式求助：

    1. Github Issues 新建一个 Issue。
    2. 在 提交你的问题。

    TiUP 并不会每次都从镜像服务器更新最新的组件列表，可以通过 tiup list 来强制刷新组件列表。

    1.2 使用 看不到一个组件的最新版本信息

    如果下载组件的过程中网络中断，可能是由于网络不稳定导致的，可以尝试重新下载，如果多次不能成功下载，请反馈到 ，可能是由于 CDN 服务器导致的。

    1.4 下载组件过程中出现 checksum 错误

    由于 CDN 会有短暂的缓存时间，导致新的 checksum 文件和组件包不匹配，建议过 5 分钟后重试，如果依然不匹配，请反馈到 。

    2. TiUP Cluster 组件故障排查

    1. 如果指定了 参数，可能是由于指定的私钥不能登录，可以通过手动执行 ssh -i identity_file user@remote 命令来验证。
    2. 如果是通过密码登录远程主机，请确保指定了 -p 参数，同时输入了正确的登录密码。

    2.2 使用 TiUP Cluster 升级中断

    为了避免用户误用，TiUP Cluster 不支持指定部分节点升级，所以升级失败之后，需要重新进行升级操作，包括升级过程中的幂等操作。

    升级操作会分为以下几步：

    1. 首先备份所有节点的老版本组件
    2. 分发新的组件到远程
    3. 滚动重启所有组件

    这种情况可能是由于之前的集群是由 TiDB Ansible 迁移过来的，且之前 TiDB Ansible 未部署 exporter 导致的。要解决这种情况，可以暂时通过手动从其他节点复制缺少的文件到新的节点。后续我们会在迁移过程中补全缺失的组件。