#共享集群配置

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

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

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

# 参数文件

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

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

参数类型：字符串
默认值：DEBUG
取值范围/格式：OFF，FATAL，ERROR，WARN，INFO，DEBUG，TRACE，ALL
参数说明：指定运行日志级别。OFF：关闭日志；FATAL：致命错误产生的日志；ERROR：一般错误产生的日志；WARN：告警类错误产生的日志；INFO：正常运行日志；DEBUG：调试日志；TRACE：追踪日志；ALL：开启所有日志。从前到后，日志等级依次增高，高日志级别包含低日志级别。
修改立即生效：是
会话级参数：否
只读参数：否

参数类型：数值
默认值：30
取值范围/格式：[0,600]
参数说明：每次重试拉起数据库实例之后增加等待的时间步长，单位为s。举例来说就是重启一次在下次重启时等待一个步长的时间，重启两次就是等两个步长，随着重启次数变多，等待时间呈等差数列增加。
修改立即生效：是
会话级参数：否
只读参数：否

参数类型：数值
默认值：90
取值范围/格式：[0,300]
参数说明：YCS执行停止数据库脚本之后，等待其完全停止的时间，单位为s（秒）。0表示一直等待，直到正常停止结束；其它值表示如果该时间后，数据库还未停止将执行强制停止。
修改立即生效：是
会话级参数：否
只读参数：否

参数类型：数值
默认值：30
取值范围/格式：[2,600]
参数说明：YCS节点之间以及YCS与集群数据库实例之间的网络心跳超时时间，单位为秒。超出该时限都未完成网络心跳交换将被视为异常并进行故障处理。该参数集群统一，支持离线修改。
修改立即生效：否
会话级参数：否
只读参数：否

参数类型：数值
默认值：30
取值范围/格式：[2,600]
参数说明：磁盘心跳超时时间，健康的YCS节点更新磁盘心跳的间隔不可超出该值，单位为秒。超出该时限都未更新磁盘心跳将被视为异常并进行故障处理。该参数集群统一，支持离线修改。
修改立即生效：否
会话级参数：否
只读参数：否

Note：

磁盘心跳超时时间应当在评估实际IO性能和应用场景对RTO的要求后进行合理调整，避免因IO卡顿引起不必要的故障仲裁。

若磁盘心跳超时时间配置过小，将导致IO性能较差的环境出现节点被驱逐、节点自杀等异常表现。