[FAQ] TiDB-Ansible 导入 TiUP 环境,TiDB v3.x 升级到 v4.x,参数不兼容 或者 edit-config 调整参数 reload 不生效问题

【问题澄清】

  • 当前环境:从 tidb-ansible v3.x 导入 tiup v1.0.0
  • 导入成功后执行 tiup cluster upgrade cluster-name v4.0.0 失败,报错如下:

文字版如下:

error=“config file /home/tidb/deloy/conf/tidb.toml contained unknow configuration options: log.file.log-rotate, pessimistic-txn.ttl, tikv-client.max-txn-time-use, txn-local-latches, txn-local-latches.capacity, txn-local-latches.enabled”

截图如下:

【解决办法】

  • 注释 /home/tidb/.tiup/storage/cluster/clusters/formal-cluster/ansible-imported-configs 下的 tidb.toml 相关配置(注:这里是报错信息相关的配置),重新启动 upgrade 任务.

【问题原因】

  • tidb 3.x 版本参数在 4.x 版本取消,导致集群升级失败。

【经典案例】