#共享集群配置

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]
参数说明：每次重试拉起数据库实例之后增加等待的时间步长，单位为秒。举例来说就是重启一次在下次重启时等待一个步长的时间，重启两次就是等待两个步长，随着重启次数变多，等待时间呈等差数列增加。
修改立即生效：是
会话级参数：否
只读参数：否

# WAIT_STOP_FIN_TIME

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

# OSW_AUTO_START

参数类型：字符串
默认值：ON
取值范围/格式：[ON|OFF]
参数说明：启动YCS时是否同时启动OS Watcher，默认会启动。
修改立即生效：否
会话级参数：否
只读参数：否

# OSW_INTERVAL

参数类型：数值
默认值：DISK_HB_KEEP_ALIVE / 3
取值范围/格式：[1,86400]
参数说明：OS Watcher每次收集信息的时间间隔，单位为秒。不配置该参数时，实际时间间隔等于磁盘心跳超时时间DISK_HB_KEEP_ALIVE的三分之一（向下取整）。
修改立即生效：是
会话级参数：否
只读参数：否

# OSW_FILE_NUM

参数类型：数值
默认值：20
取值范围/格式：[2,10000]
参数说明：指定OS Watcher每种类型下的数据文件同时存在的个数。
修改立即生效：是
会话级参数：否
只读参数：否

# OSW_FILE_SIZE

参数类型：数值
默认值：20M
取值范围/格式：[1M,4G]
参数说明：指定OS Watcher数据文件的大小，超过将形成归档，并创建新的数据文件。
修改立即生效：是
会话级参数：否
只读参数：否

# YCR_FILE_NAME

参数类型：字符串
默认值：+SYSTEM/ycr
取值范围/格式：此参数必须与创建YCR文件时指定的文件名相等
参数说明：YFS的根目录是 +，YCR文件必须存储在SYSTEM磁盘组中。
修改立即生效：否
会话级参数：否
只读参数：是

# VOTING_FILE_NAME

参数类型：字符串
默认值：+SYSTEM/voting
取值范围/格式：此参数必须与创建投票文件时指定的文件名相等
参数说明：YFS的根目录是 +，投票文件必须存储在SYSTEM磁盘组中。
修改立即生效：否
会话级参数：否
只读参数：是

# _HOST_NAME

参数类型：字符串
默认值：无默认值
取值范围/格式：长度[4,64]位的字符串
参数说明：隐藏参数，仅在单机多实例场景下可能使用该参数，方便开发人员调试，不建议在用户环境中使用。
修改立即生效：否
会话级参数：否
只读参数：否

# _MONITOR_SWITCH

参数类型：数值
默认值：0
取值范围/格式：[0,15]
参数说明：隐藏参数，用于失效某些监控开关，方便内部调试代码，不建议在用户环境中使用。
修改立即生效：是
会话级参数：否
只读参数：否

# WORKER_LIMIT

参数类型：数值
默认值：0
取值范围/格式：[0, 18446744073709551615]
参数说明：集群中单个节点能够处理的SCAN VIP连接请求的最大值，0表示不限制请求数量。
修改立即生效：是
会话级参数：否
只读参数：否

# 集群级参数项

# NETWORK_HB_TIMEOUT

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

# DISK_HB_KEEP_ALIVE

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

Note:

磁盘心跳超时默认值是经过验证的稳定阈值，如果要修改为小于默认值，需要经过存储延迟的稳定性测试，并持续监控测试结果，经过技术支持确认后才能修改。

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

# FENCE_TYPE

参数类型：数值
默认值：0
取值范围/格式：[0|1]
参数说明：共享集群的I/O Fencing类型，0表示在途I/O保护算法，1表示基于SCSI持久预留的I/O Fencing。不同I/O Fencing方法的原理、硬件要求和配置方法请查阅IO Fencing，请在调整此配置项前仔细阅读和准备。
修改立即生效：否
会话级参数：否
只读参数：否