# GaussStor相关参数
#### dr_gaussstor_cms_url_list
**参数说明**：设置GaussStor集群管理节点的ip:port列表。
**参数类型**：字符串
**参数单位**：无
**取值范围**：长度不超过8192字节的字符串，格式为本地GaussStor集群管理节点的ip:port列表+远端GaussStor集群管理节点的ip:port列表。例如："xxx.xxx.xxx.xxx:xxxx,xxx.xxx.xxx.xxx:xxxx,xxx.xxx.xxx.xxx:xxxx+xxx.xxx.xxx.xxx:xxxx,xxx.xxx.xxx.xxx:xxxx,xxx.xxx.xxx.xxx:xxxx"。
**默认值**：""
**设置方式** ：该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议**：使用对接GaussStor的接口时，自动设置，禁止手动设置。
**设置不当的风险与影响**：如果在对接前后，修改此参数的值，使其与对接时的配置不一致，重启集群可能会导致GaussStor对接失败。
#### enable_dr_gaussstor_mode
**参数说明**：设置是否开启GaussStor模式。
**参数类型**：布尔型
**参数单位**：无
**取值范围**：on、off
**默认值**：off
**设置方式** ：该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议**：使用对接GaussStor的接口时，自动设置，禁止手动设置。
**设置不当的风险与影响**：如果在对接后，将该参数设置为off，重启集群会导致对接GaussStor失败。
#### dr_gaussstor_config
**参数说明** ：用于配置与GaussStor连接和写入的相关参数。每个配置项为name=value格式，配置项之间用空格分隔，包含的配置项如[表1]所示。
**参数类型**：字符串
**参数单位**：无
**取值范围**：长度不超过8192字节的字符串，格式为\[gaussstor_async_write_batch_timeout=xxx gaussstor_max_sdk_retry_timeout=xxx enable_gaussstor_sync_commit=xxx max_size_for_gaussstor_xlog_prune=xxx max_gaussstor_wal_sender_buf_size=xxx enable_auto_service_down=xxx run_mode=xxx\]
**默认值**：""
**设置方式** ：该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。设置时所有配置项需补全，若仅含部分配置项则设置失败。
**设置建议**：调用对接GaussStor接口时，自动设置，不建议手动设置。
**设置不当的风险与影响**：请在充分理解参数含义，并经过测试验证后进行修改。
 表1配置项说明 
| 配置项名称                               | 描述                                   | 取值范围                                                                                                                                                                                                                                                 | 默认值                 |
|:---|:---|:---|:---|
| gaussstor_async_write_batch_timeout | 设置SDK汇聚写的最大超时时间。                     | \[0, UINT32_MAX\]，单位：微秒。                                                                                                                                                                                                                             | 200微秒                |
| gaussstor_max_sdk_retry_timeout       | 设置SDK与GaussStor通信的最大超时时间。              | \[0, UINT32_MAX\]，单位：毫秒。                                                                                                                                                                                                                                | 3000毫秒             |
| enable_gaussstor_sync_commit       | 设置是否事务提交时等待对应日志写到GaussStor。            | - on：事务提交时需要等待对应日志写到GaussStor。  - off：事务提交时无需等待对应日志写到GaussStor。   | on                  |
| max_size_for_gaussstor_xlog_prune  | 当灾备集群和主集群断连的时候，允许GaussStor存储的最大Xlog大小。 | \[0, INT_MAX\]，单位KB。                                                                                                                                                                                                                                  | 536870912KB(512GB) |
| max_gaussstor_wal_sender_buf_size   | 设置一次可写到GaussStor的Xlog buffer最大大小。      | \[8, 131072\]，单位KB。                                                                                                                                                                                                                                   | 4088                |
| enable_auto_service_down          | GaussStor故障时，是否开启自动同步转异步。             | - on：GaussStor故障时，开启自动同步转异步。  - off：GaussStor故障时，不开启自动同步转异步。   | on                |
| run_mode                            | 设置日志复制模式。                           | - ""：流式复制模式。该值为默认值。  - "serial"：串行复制模式。               | ""                 |
   
#### enable_dr_gaussstor_parallel_write
**参数说明**：写入GaussStor时，设置写入方式为并行还是串行。
**参数类型**：布尔型
**参数单位**：无
**取值范围**：
- on：设置写入方式为并行，写入备机同时写入GaussStor。
- off：设置写入方式为串行，以备机多数派位置作为写入点写入GaussStor。
**默认值**：on
**设置方式** ：该参数属于POSTMASTER类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议**：使用对接GaussStor接口时，自动设置，不建议手动设置。
**设置不当的风险与影响**：请在充分理解参数含义，并经过测试验证后进行修改。
#### gaussstor_auth_type
**参数说明**：设置GaussDB和GaussStor认证方式，仅sysadmin用户可以访问。
**参数类型**：字符串
**参数单位**：无
**取值范围** ：
- none：表示不使用连接认证。
- only_auth_connect：表示使用连接认证。
- auth_connect_with_encrypt：表示使用连接认证\&\&通信加密。
- auth_connect_with_tls_encrypt：表示使用TLS双向认证\&\&通信加密。
 
**默认值**：auth_connect_with_encrypt
**设置方式** ：该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。设置后对接GaussStor或重新对接GaussStor生效。
**设置建议**：对性能要求较高并且确保无安全风险时，可以使用only_auth_connect。
**设置不当的风险与影响**：配置错误会导致对接GaussStor失败。不使用连接认证可能会导致被仿冒的安全风险。
#### gaussstor_psk_path
**参数说明**：设置预共享密钥文件路径，可设置为相对于$GAUSSHOME数据库安装目录路径或系统绝对路径，仅sysadmin用户可以访问。
**参数类型**：字符串
**参数单位**：无
**取值范围**：不超过1024字节的字符串
**默认值**：share/gaussstor
**设置方式** ：该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。设置后对接或重新对接GaussStor生效。
**设置建议**：建议使用默认值。
**设置不当的风险与影响**：开启认证时对接GaussStor失败。
#### gaussstor_hash_check
**参数说明**：写入GaussStor时，是否开启链式哈希防篡改检测功能。
**参数类型**：布尔型
**参数单位**：无
**取值范围**：
- on：开启链式哈希防篡改检测。
- off：关闭链式哈希防篡改检测。
**默认值**：off
**设置方式** ：该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。设置后对接或重新对接GaussStor生效。
**设置建议**：需要在gaussstor_auth_type不为none的情况下开启。使用链式防篡改检测能力会对性能有影响，请综合业务安全和性能考虑是否开启。
**设置不当的风险与影响**：未开启认证时开启链式防篡改开关，对接GaussStor失败。
#### gaussstor_recycle_ttl
**参数说明**：指定Xlog文件在GaussStor中的IO-WORM保护时间，在保护时间内下发删除命令，文件内容不会实际删除，此时文件会成为只读状态，直到到达保护时间，文件才会被真实删除；在保护时间之后下发删除命令，此时有可能会触发部分过期数据的直接删除，最新数据会滞后一个保护时间再触发实际删除。
**参数类型**：整型
**参数单位**：min（分钟）
**取值范围**：1 \~ 36792000
**默认值**：5
**设置方式** ：该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议**：调用对接GaussStor接口时，作为接口入参设置，不建议手动更改该GUC的值。
**设置不当的风险与影响**：设置过大会使GaussStor的Xlog日志文件长时间不被回收，可能导致磁盘空间满。设置过小会降低GaussStor IO-WORM提供的保护能力。
#### enable_ima
**参数说明**：控制GaussStor完整性度量开关和远程证明校验。
**参数类型**：字符串
**参数单位**：无
**取值范围**：
- on_warning：开启完整性度量开关和远程证明校验，度量失败告警。
- on_exit：开启完整性度量开关和远程证明校验，度量失败退出数据库与GaussStor的连接。
- off：关闭完整性度量和远程证明校验。
**默认值**：off
**设置方式** ：该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议**：调用对接GaussStor接口时，作为接口入参设置，可以根据业务需要手动更改该GUC的值。
**设置不当的风险与影响**：如果没有在本地启动证明代理相关配置，开启此GUC参数，将无法正确获取挑战值随机数，导致度量失败。
#### dr_gaussstor_client_info
**参数说明**：设置数据库实例对接GaussStor需要绑定的客户端IP列表。
**参数类型**：字符串
**参数单位**：无
**取值范围**：格式为数据库实例的实例名:绑定本地GaussStor的客户端ip列表+数据库实例的实例名:绑定远端GaussStor的客户端ip列表。例如："dn6001:xxx.xxx.xxx.xxx,dn_6002:xxx.xxx.xxx.xxx,dn_6003:xxx.xxx.xxx.xxx+dn_6001:xxx.xxx.xxx.xxx,dn_6002:xxx.xxx.xxx.xxx,dn_6003:xxx.xxx.xxx.xxx"。
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
在IPv6环境下，必须将每个IP地址包裹在方括号\[\]内，例如："dn_6001:\[2001:db8:85a3::8a2e:0370:7334\],dn_6002:\[240e:fe:abcd:1234::1\]+dn_6001:\[fe80::1ff:fe23:4567:890a\],dn_6002:\[2001:db8:0:42:0:8a2e:370:7334\]"。
**默认值**：""
**设置方式** ：该参数属于SIGHUP类型参数，请参见[表1](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0993.html#ZH-CN_TOPIC_0000002793699379__zh-cn_topic_0283137176_zh-cn_topic_0237121562_zh-cn_topic_0059777490_t91a6f212010f4503b24d7943aed6d846)中对应设置方法进行设置。
**设置建议**：使用对接GaussStor的接口时自动设置，接口中会把用户传入的数据库实例管理ip和数据库实例名匹配，不建议手动修改GUC参数设置。
**设置不当的风险与影响**：如果在对接前后，修改此参数的值，使其与对接时的配置不一致，重启集群可能会导致GaussStor对接失败。
