南大通用GBase 8s 连接管理器CM的配置参数解析

原文链接：https://www.gbase.cn/community/post/4313
更多精彩内容尽在南大通用GBase技术社区，南大通用致力于成为用户最信赖的数据库产品供应商。

在数据库的稳定运行中，连接管理器（Connection Manager, CM）扮演着至关重要的角色。它不仅监控和维护客户端连接，还通过一系列精细的配置参数，确保数据库连接的高效管理和负载均衡。本文将带您了解南大通用GBase 8s CM配置文件中的各个参数，基本设置及选项，为您提供一份CM配置指南。

CM配置文件概览：详细介绍CM配置文件的结构，包括HEADER和BODY两个部分，并解释每个部分的作用。

CM配置文件参数——HEADER部分

• NAME参数： 定义CM实例的名称，是必填参数。
• MACRO参数： 通过宏定义简化服务器列表的管理，并支持负载均衡。
• LOCAL_IP参数： 指定CM监控的计算机IP地址。
• LOG参数： 设置CM日志级别，范围从0到3。
• LOGFILE参数： 指定日志文件的存储路径。
• DEBUG参数： 是否启用调试模式，记录SQL错误消息。

# *** HEADER ***
# 必填参数
# 定义CM实例的名称必填
NAME cm1 
                           
# 可选参数
# 通过宏定义的方式给一个服务器列表定义一个名字，可以有多个
MACRO name_1=server1,server2 
# 使用圆括号括起来，可以指示CM根据这些数据库服务器的CPU使用情况来实现负载均衡                
MACRO name_2=(server3,server4)
# 用于指定要监控的运行连接管理器的计算机上的 IP 地址         
LOCAL_IP 192.168.x.x,172.16.x.x
# CM日志级别，可配置0~3，0不记录任何日志，配置为3时日志最详细    
LOG 1
# 日志路径                                    
LOGFILE ${GBASEDBTDIR}/tmp/cm.log
# 是否启用调试模式，1-启用， 0-禁用，默认值0，调试模式下会记录SQL的错误消息    
DEBUG 0
# CM超时时间，默认60秒，CM切换使用                               
CM_TIMEOUT 60
# 主节点事件超时时间，默认60秒，可配置-1~60，-1-无限期等待主节点的事件，或从辅节点接到通知主已经离线；0~30-这个范围都被视为30秒                               
EVENT_TIMEOUT 60
# 辅节点事件超时时间，参数范围同上                        
SECONDARY_EVENT_TIMEOUT 60 
# 可配置为LOCAL|REMOTE|LOCAL+REMOTE       
SQLHOSTS LOCAL                       

CM配置文件参数——BODY部分

• unit_type和unit_name参数： 定义连接单元的类型和名称。
• GBASEDBTSERVER参数： 指定CM初始化时连接的数据库服务器。
• SLA参数： 配置服务级别协议，包括DBSERVERS、MODE、USEALIASES、POLICY、WORKERS等子参数。
• HOST、NETTYPE、SERVICE参数： 提供连接的网络配置选项。
• SQLHOSTSOPT参数： 等同于sqlhosts文件中的options。

# *** BODY ***
# 配置连接单元
unit_type unit_name_1                # unit_type可配置为CLUSTER|REPLSET|GRID|SERVERSET 
{
GBASEDBTSERVER server_list        # 指定CM初始化时连接的数据库服务器，可配置一个或多个server或group
    SLA sla_name_1 DBSERVERS=value \    # 必填参数，可配置为ANY|PRI|primary|SDS|HDR|RSS|${marco_name}
                MODE=value \        # 可选参数，可配置为REDIRECT|PROXY，默认REDIRECT，使用重定向还是代理方式连接服务器
                USEALIASES=value \    # 可选参数，可配置为ON|OFF，默认ON，是否可以将客户端请求重定向到服务器别名
                POLICY=value \        # 可选参数，可配置为LATENCY|FAILURE|WORKLOAD，支持配置权重如：10*LATENCY+FAILURE，默认值为WORKLOAD；该参数用于指定如何根据特定的规则或标准来指导客户端连接请求：LATENCY（最低延时）、FAILURE（失败次数最少）、WORKLOAD（工作负载最低）
                WORKERS=number_of_threads \ # 可选参数，当前SLA分配的工作线程数，默认值4，该线程用来处理连接到此SLA的客户端请求
                HOST=host_name \    #可配置为hostname或ip地址,配置后将不使用sqlhosts文件中定义的值，等价于sqlhosts文件中的hostname
                NETTYPE=network_protocol \    # 可配置为onsoctcp|drsoctcp|onsocssl，等价于sqlhosts文件中的nettype
                SERVICE=service_name \    # 可配置为端口号或服务名称，等价于sqlhosts文件中的servicename
                SQLHOSTSOPT=options    #等价于sqlhosts文件中的options，例如SQLHOSTSOPT="cms=path"
    SLA sla_name_2 DBSERVERS=value ...
    SLA sla_name_n DBSERVERS=value ...
     #可选的故障转移参数
    FOC ORDER=value \    # 可配置为ENABLED|DISABLED|SDS,HDR,RSS；ENABLED - CM参与故障转移，并使用主节点的HA_FOC_ORDER 配置参数来确定转移顺序；DISABLED - 禁用CM故障转移处理。如果PRIORITY 设置为正数，则ORDER必须设置为ENABLED
        PRIORITY=value \    #可配置>=0; 此值必须唯一；0：禁用故障转移；大于0：当PRIORITY=n的连接管理器进行故障转移时，如果会导致PRIORITY<n的连接管理器对主节点失去连接，则会阻止故障转移
        TIMEOUT=seconds \    # 超时时间，默认值0；在等待EVENT_TIMEOUT时间后，再额外等待TIMEOUT时间，如果主节点没有事件，才开始故障转移
        RETRY=attempts        # 可配置>=0;故障转移尝试次数，0：无限次尝试
    #可选的故障转移报警参数
    CMALARMPROGRAM path_and_filename    # 指定故障转移错误时执行的程序或脚本的路径
}
# Connection Unit 2
unit_type unit_name_2
{
...
}

通过本文的解析，您应能全面掌握CM配置参数的设置方法。合理配置CM不仅能够提升数据库的连接性能，还能增强系统的稳定性和可靠性。

感谢您的阅读。

原文链接：https://www.gbase.cn/community/post/4313
更多精彩内容尽在南大通用GBase技术社区，南大通用致力于成为用户最信赖的数据库产品供应商。