TiUP 常见 FAQ

TiUP 常见 FAQ:

  1. [FAQ] tiup client 退出命令
    使用 ctrl + d 退出

  2. [FAQ] tiup 安装报错 tar: Unexpected EOF in archive
    清理缓存 rm -f ~/.tiup/storage/cluster/packages/* ,重新安装

  3. [FAQ] tiup cluster import 报错:invalid cross-device link
    (1) 执行 tiup cluster list ,查看是否有重名集群,可能是之前的残留;通过删除 /home/tidb/.tiup/storage/cluster/clusters/集群名称 目录完成清理。
    (2) 执行 tiup cluster --no-backup -d /home/tidb/tidb-ansible 来解决该问题。

  4. [FAQ] TiUP v0.6.3 扩容集群配置文件检测冲突 key xxx already set in map
    通过 edit-config 检查是否存在冲突配置项,并将其删除

  5. [FAQ] TiUP 部署 tidb 失败,报错:[sudo:抱歉,您必须拥有一个终端来执行 sudo]
    参考 https://www.cnblogs.com/domestique/p/8215541.html

  6. TiUP 如何进行离线部署
    https://docs.pingcap.com/zh/tidb/v4.0/production-offline-deployment-using-tiup#使用-tiup-离线部署-tidb-集群

  7. [FAQ] tiup deploy 执行报错 cause: module.user.user_add_failed: Failed to create new system user 'search' on remote host
    (1).免密配置好。使用密钥的,将中控机密钥copy到各个机器上
    (2).ssh目录权限744,authorized_keys文件权限600

  8. [FAQ] tiup 升级 cp: 无法创建目录 ‘/data1/deploy/bin.old.v3.1.0-rc’: 文件已存在
    (1). 报错本身我们是忽略的,但从日志看部署机使用了中文 LOCALE, 所以没有匹配到对应的错误消息,我们在后面的版本会对这里再额外处理来避免中断流程
    (2). 当前可以在对应部署机上设置 LANG=en_US.UTF-8 或其他英语 Locale 来绕过(或者可以尝试手动把那个目录重命名看是否能绕过)

  9. [FAQ] ansible 导入 tiup 报错 Error: remove /home/tidb/tidb-ansible: directory not empty
    可以忽略此报错,使用 tiup 管理集群,不要再使用 ansible. 之后的版本会修复此问题

  10. [FAQ] ansible 导入 tiup 后 ,reload 参数不生效
    由于 ansible 配置文件也有此参数,到部署目录 /.tiup/storage/cluster/clusters/xxx/ansible-imported-configs/ 下找到对应的 配置文件,删掉需要修改的配置后,再次 reload 生效