关于 TIUP 部署最新 5.2.1 版本, 使用 topology.yaml 配置文件中参数问题

【 TiDB 使用环境】
【概述】:场景 + 问题概述
在虚拟化环境部署了 10台 虚机,用于生产业务的Tidb ,选用最新版本 5.2.1

虚机拓扑架构如下:

【背景】:做过哪些操作
通过 官网 文档修改 topology.yaml

1、TiFlash 部署拓扑
https://docs.pingcap.com/zh/tidb/stable/tiup-cluster-topology-reference

2、TiDB 集群的拓扑文件配置
https://docs.pingcap.com/zh/tidb/stable/tiup-cluster-topology-reference#cdc_servers

3、TiCDC 部署拓扑
https://docs.pingcap.com/zh/tidb/stable/ticdc-deployment-topology

【问题】:当前遇到的问题
在使用命令 Tiup 部署 集群,报错如下:

想问一下,这报错 涉及哪些参数 需要修改 修正。。。

【TiDB 版本】:5.2.1
【附件】:

3 个赞

image 检查log相关的配置项书写是否正确

3 个赞

你好!

如楼上 @h5n1 所说,报错已经很明显了。提示,log 是一个未知的配置项。

%E5%9B%BE%E7%89%87

TiKV 组件关于日志级别的正确配置项是 log-level,具体可以参考官方文档:https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file#log-level。

温馨提示:

  1. 你的拓扑配置文件中配置了多处,都需要更改为正确的配置项,或者放到 server_configs 全局配置部分
  2. 不同组件,相同意义的配置项,“配置字段”可能不同,具体可以查阅对应组件的官方文档。如,TiDB server关于日志级别的配置项是 log.level,TiKV 的则是 log-level
3 个赞

你好,多谢提示,我也感觉参数有错误导致安装报错,但没找到地方。。。

另外,配置文件是使用 tiup cluster template > topology.yaml 生成的配置文件,我刚刚重新测试了一下 ,发现你们上面的模版上参数是不对的。。。。

生成过程如下:

topology01.yaml (11.1 KB)

请官方是不是看看可以做修改,因为按照你们官方文档来生成配置文件的话,这个 Log 参数就是错误的!

2 个赞

你好 ,我大概知道是那部分问题了 就是 server_configs 全局部分;

可以帮我修改让参考一下 不 ?

我添加的参数都是从官网上看的,可能格式上有点问题;

我将 全局部分参数 全部禁止,安装没啥问题了

所以 可以帮忙看看我配置文件 全局部分 是那边 错误吗 ?

1 个赞

你好!

  1. 如果你现在还卡在部署阶段,可以先使用 tiup cluster template --local > xxx.yaml 生成一个最简模板,在此基础上稍作修改(添加集群节点,以满足你的拓扑需求),就可以部署出集群。或者参考 https://docs.pingcap.com/zh/tidb/stable/quick-start-with-tidb#Linux 这个文档中的示例文档修改也可以。
    等集群部署完成后,再使用 tiup cluster edit-config <cluster-name> 去添加你的定制化配置。
  2. tiup cluster template > xxx.yaml 生成的示例模板确实是有问题,我们这边处理下,感谢你的反馈。
2 个赞

server_configs 里的配置项,你先看你是否用的上,如果根本不使用,就没必要定义出来,直接删掉就好。像日志清理这块,应该是要用的,这块你可以参考下我的,如下:

这个层级关系,在官方文档中都有展示:(https://docs.pingcap.com/zh/tidb/stable/tidb-configuration-file#logfile)

你给的第一个拓扑文档,其实也有,请看:(你这个拓扑文件是 tiup cluster template 命令生成的吗,我这边测试都没有 server_configs 段)

2 个赞

你好,多谢了!!
刚刚一个个对比参数测试部署了,检测出 server_configs 全局下 tikv 上参数 日志等级 是错误的:
修改为 :logger.level: “info” 就可以部署完成;

 另外:文档中  https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file
 参数貌似也是错误的, 我全局参数也是参考这文档

1 个赞

好的,不客气。

1 个赞

你好 ,还是参数格式问题 ,刚刚看了一下你发出来的截图 ,对比了一下 ; 想问问 前缀部分 log.file 不写 有影响吗? 是不是不能生效?

1 个赞

这里涉及到 yaml 到 toml 的转换,如果写

log.file.max-days: 10

会转换成:

log:
  file:
    max-days: 10

反之如果写

max-days: 10

会转换成

max-days: 10

根据上面 tikv 的文档描述,应该使用前者

好的,多谢了
那我就按照

log.file.max-days: 10

格式来写把!! :grinning:

这边跟研发同事确认了,TiKV 里用 log-level 没问题。

你好
我昨晚做测试的时候,发现一个 问题
如: log-level :info 是无法生效,参数报错;但如果 log-level: info 确实可以; 也就是在符号 : 后面需要有个空格
所以想问的是,可以不可以 默认 有没空格都可以生效,有时候配置参数格式,习惯不写空格

格式要求:后面必须有个空格

2 个赞

收到,多谢了!!

此话题已在最后回复的 1 分钟后被自动关闭。不再允许新回复。