#共享集群配置

YCS通过参数文件和集群配置表分别实现节点级、集群级的参数配置。

节点级参数修改的具体操作请参考ycsctl节点管理命令介绍,集群级参数修改则参考ycsctl集群管理命令

本文将对YCS开放的配置参数项进行介绍,请根据描述选择合适的项目和值以满足自身环境下YCS的运行要求。

# 参数文件

YCS的参数文件名称为yascs.ini,名称不可修改,且必须位于每个服务器的如下目录结构中:

## 请确保YASCS_HOME中至少具备以下目录结构:
├── config
│   └── yascs.ini
├── instance
└── log

# 节点级参数项

# AUTO_START

  • 参数类型:字符串

  • 默认值:ALWAYS

  • 取值范围/格式:ALWAYS,NEVER

  • 参数说明:启动YCS时是否同时启动本服务器上的数据库实例,不配置或者配置为ALWAYS时,启动数据库实例,配置为NEVER时不启动数据库实例。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

# LOG_LEVEL

  • 参数类型:字符串

  • 默认值:DEBUG

  • 取值范围/格式:OFF,FATAL,ERROR,WARN,INFO,DEBUG,TRACE,ALL

  • 参数说明:指定运行日志级别。OFF:关闭日志;FATAL:致命错误产生的日志;ERROR:一般错误产生的日志;WARN:告警类错误产生的日志;INFO:正常运行日志;DEBUG:调试日志;TRACE:追踪日志;ALL:开启所有日志。从前到后,日志等级依次增高,高日志级别包含低日志级别。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

# LOG_NUMBER

  • 参数类型:数值

  • 默认值:10

  • 取值范围/格式:[2,10000]

  • 参数说明:指定运行日志文件同时存在的个数。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

# LOG_SIZE

  • 参数类型:数值

  • 默认值:20M

  • 取值范围/格式:[1M,4G]

  • 参数说明:指定每个运行日志文件的大小,超过将形成归档,并创建新的运行日志文件。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

# RESTART_TIMES

  • 参数类型:数值

  • 默认值:3

  • 取值范围/格式:[0,100]

  • 参数说明:数据库实例异常掉线时,Monitor重试拉起数据库实例的次数。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

# RESTART_INTERVAL

  • 参数类型:数值

  • 默认值:30

  • 取值范围/格式:[0,600]

  • 参数说明:每次重试拉起数据库实例之后增加等待的时间步长,单位为s。举例来说就是重启一次在下次重启时等待一个步长的时间,重启两次就是等两个步长,随着重启次数变多,等待时间呈等差数列增加。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

# WAIT_STOP_FIN_TIME

  • 参数类型:数值

  • 默认值:90

  • 取值范围/格式:[0,300]

  • 参数说明:YCS执行停止数据库脚本之后,等待其完全停止的时间,单位为s(秒)。0表示一直等待,直到正常停止结束;其它值表示如果该时间后,数据库还未停止将执行强制停止。

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

# YCR_DISK

  • 参数类型:字符串

  • 默认值:无

  • 取值范围/格式:磁盘路径 例:/dev/sda

  • 参数说明:YCR盘的路径,/dev/sda是路径部分,必须是有效的磁盘。YCR盘对应磁盘大小应该超过100M。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:是

# _HOST_NAME

  • 参数类型:字符串

  • 默认值:无默认值

  • 取值范围/格式:长度[4,64]位的字符串

  • 参数说明:隐藏参数,仅在单机多实例场景下可能使用该参数,方便开发人员调试,不建议在用户环境中使用

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

# _MONITOR_SWITCH

  • 参数类型:数值

  • 默认值:0

  • 取值范围/格式:[0,15]

  • 参数说明:隐藏参数,用于失效某些监控开关,方便内部调试代码,不建议在用户环境中使用

  • 修改立即生效:是

  • 会话级参数:否

  • 只读参数:否

# 集群级参数项

# NETWORK_HB_TIMEOUT

  • 参数类型:数值

  • 默认值:30

  • 取值范围/格式:[2,600]

  • 参数说明:YCS节点之间以及YCS与集群数据库实例之间的网络心跳超时时间,单位为秒。超出该时限都未完成网络心跳交换将被视为异常并进行故障处理。该参数集群统一,支持离线修改。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

# DISK_HB_KEEP_ALIVE

  • 参数类型:数值

  • 默认值:30

  • 取值范围/格式:[2,600]

  • 参数说明:磁盘心跳超时时间,健康的YCS节点更新磁盘心跳的间隔不可超出该值,单位为秒。超出该时限都未更新磁盘心跳将被视为异常并进行故障处理。该参数集群统一,支持离线修改。

  • 修改立即生效:否

  • 会话级参数:否

  • 只读参数:否

Note

  • 磁盘心跳超时时间应当在评估实际IO性能和应用场景对RTO的要求后进行合理调整,避免因IO卡顿引起不必要的故障仲裁。
  • 若磁盘心跳超时时间配置过小,将导致IO性能较差的环境出现节点被驱逐、节点自杀等异常表现。