dssserver

背景信息

dssserver是独立进程,直接管理磁阵裸设备,并对外提供类似分布式文件系统的能力。通过共享内存和客户端API动态库,为数据库提供创建文件、删除文件、扩展和收缩文件、读写文件的能力。也是一个可执行的命令,能够通过其启动一个dssserver进程。

语法

启动dssserver进程

dssserver -D $DSS_HOME [-M]

须知: -M为DSS MAINTAIN模式,仅供开发者调试及相关工具配合使用,随意使用可能导致数据无法恢复,严禁多节点MAINTAIN模式启动

显示帮助信息

dssserver -h

参数说明

dssserver作为一个独立的进程,在启动之前需要提供配置文件dss_inst.ini,相关的配置参数整理如下:

  • LSNR_PATH

    参数说明: dssserver进程需要的socket文件路径。

    取值范围: 字符串,最大长度为89。

    默认值: /tmp/

    说明:

    • om安装后的默认值为$DSS_HOME
  • LOG_HOME

    参数说明: 日志路径。

    取值范围: 字符串类型,最大长度为171。

    默认值: ""

  • _LOG_BACKUP_FILE_COUNT

    参数说明: 日志文件最多保留的个数。

    取值范围: 整型,0~128。

    默认值: 20

  • _LOG_MAX_FILE_SIZE

    参数说明: 单个日志文件最大大小。

    取值范围: 整型 , [1M,4G]。

    默认值: 256M

  • INST_ID

    参数说明: 实例号,每个主备下的dssserver进程各不相同。

    取值范围: 整型,0~63。

    默认值: 0

    说明:

    • om安装后的默认值为0~63中的某个值
  • STORAGE_MODE

    参数说明: DSS对应的存储设备类型,磁阵的话配置为RAID或者CLUSTER_RAID,非磁阵配置成DISK。

    取值范围: 字符串。

    默认值: DISK

    说明:

    • om安装后的默认值为CLUSTER_RAID
  • _LOG_LEVEL

    参数说明: 日志级别。

    取值范围: 整型,0~4087。

    默认值: 519

  • MAX_SESSION_NUMS

    参数说明: 最大的会话连接数量。

    取值范围: 整型,[16,16320]。

    默认值: 8192

  • DISK_LOCK_INTERVAL

    参数说明: 磁盘锁加锁超时时间。

    取值范围: 整型,1~600000, 单位:毫秒。

    默认值: 100

  • DLOCK_RETRY_COUNT

    参数说明: 磁盘加锁重试次数。

    取值范围: 整型,1~500000。

    默认值: 50

  • _AUDIT_BACKUP_FILE_COUNT

    参数说明: 审计备份文件个数。

    取值范围: 整型,0~128。

    默认值: 10

  • _AUDIT_MAX_FILE_SIZE

    参数说明: 审计备份文件最大大小。

    取值范围: 整型,1M~4G。

    默认值: 10M

  • _LOG_FILE_PERMISSIONS

    参数说明: 日志文件权限。

    取值范围: 整型,600~777。

    默认值: 600

  • _LOG_PATH_PERMISSIONS

    参数说明: 日志路径权限。

    取值范围: 整型,700~777。

    默认值: 700

  • _SHM_KEY

    参数说明: 共享内存KEY。

    取值范围: 整型,1~64。

    默认值: 1

    说明:

    • om安装后的默认值为1~64中的某个值
  • DSS_NODES_LIST

    参数说明: dss instance节点之间mes通信url。

    取值范围: 字符串。格式为 inst_Id:ip:port,inst_Id:ip:port……….。字符串最大长度为4735,节点个数不超过64,通过“:”间隔。inst_Id取值范围为0-63;ip为有效的IPv4,最大长度不超过63;port取值范围1024-65535。

    默认值: 0:127.0.0.1:1611

  • INTERCONNECT_TYPE

    参数说明: 通信协议类型。

    取值范围: 字符串,TCP/RDMA。

    默认值: TCP

  • INTERCONNECT_CHANNEL_NUM

    参数说明: 内部通信mes链接通道个数。

    取值范围: 整型,1~32。

    默认值: 2

  • WORK_THREAD_COUNT

    参数说明: 内部通信mes工作线程数量。

    取值范围: 整型,2~64。

    默认值: 2

  • RECV_MSG_POOL_SIZE

    参数说明: 消息接收内存池大小。

    取值范围: 整型,1M~1G。

    默认值: 16M

  • MES_ELAPSED_SWITCH

    参数说明: 内部通信mes统计计数时延开关。

    取范围: 布尔型,FALSE/TRUE。TRUE表示当前开启mes通信计数统计时延,FALSE表示不开启。

    默认值: FALSE

  • DISK_LOCK_FILE_PATH

    参数说明:STORAGE_MODE为DISK时,所用锁的文件保存路径。

    取值范围: 字符串,最大长度为107。

    默认值: $DSS_HOME

  • SSL_CA

    参数说明: CA服务器的根证书。

    取值范围: 字符串,最大长度为255。建议设置为CA服务器的根证书的绝对路径,否则可能导致证书加载失败。

    默认值: NA,表示没有CA服务器根证书。

  • SSL_KEY

    参数说明: 指定服务器私钥文件,用以对公钥加密的数据进行解密。

    取值范围: 字符串,最大长度255。建议设置为私钥文件的绝对路径,否则可能导致私钥加载失败。

    默认值: NA,表示没有服务器私钥。

  • SSL_CRL

    参数说明: 证书吊销列表。如果客户端证书在改列表中,则当前客户端证书被视为无效证书。

    取值范围: 字符串,最大长度为255。建议设置为吊销证书的据对路径,否则可能导致证书加载失败。

    默认值: NA,表示没有吊销列表。

  • SSL_CERT

    参数说明: 指定服务器证书文件路径,证书文件的内容包含服务器端的公钥,公钥会被发送给对端来对数据进行加密。

    取值范围: 字符串,最大长度为255。建议设置为设备书的据对路径,否则可能导致证书加载失败。

    默认值: NA,表示没有服务器证书。

  • SSL_CIPHER

    参数说明: SSL通讯使用的加密算法。

    取值范围: 字符串。

    默认值:""

  • SSL_PWD_CIPHERTEXT

    参数说明: 私钥密码。

    取值范围: 字符串,最大长度为1023。

    默认值: NA,表示私钥文件没有加密。

  • SSL_CERT_NOTIFY_TIME

    参数说明: SSL服务器证书到期前提醒的天数。

    取值范围: 整型,7~180,单位:天。

    默认值: 30

  • POOL_NAMES

    参数说明: 存储池配置。

    取值范围: 字符串。

    默认值:""

  • IMAGE_NAMES

    参数说明: image配置。

    取值范围: 字符串。

    默认值: 空

  • CEPH_CONFIG

    参数说明: ceph集群配置文件。

    取值范围: 字符串。

    默认值: “/etc/ceph/ceph.conf”

  • VOLUME_TYPES

    参数说明: 卷类型。

    取值范围: 字符串。

    默认值:""

  • DSS_CM_SO_NAME

    参数说明: cm的二进制文件名。

    取值范围: 字符串。

    默认值:""

    说明:

    • om安装后的默认值为libclient.so
  • CLUSTER_RUN_MODE

    参数说明: DORADO双集群启动模式。

    取值范围:“cluster_primary” | “cluster_standby”

    默认值:“cluster_primary”

  • _BLACKBOX_DETAIL_ON

    参数说明: 黑匣子日志开启时,是否要打印共享内存信息。

    取值范围: 布尔型,FALSE/TRUE。TRUE表示当黑匣子日志开启时,打印共享内存信息;FALSE表示当黑匣子开启时,不打印共享内存信息。如果黑匣子功能没有开启,则该参数不生效。

    默认值: FALSE

  • WORK_THREADS

    参数说明: 控制单个reactor线程池线程的数量。

    取值范围: 整型,16~128。

    默认值: 16

  • IO_THREADS

    参数说明: 控制reactor的数量。

    取值范围: 整型,1~8。

    默认值: 2

日志

DSS日志类型如下:

  • RUN日志

打印数据库DSS模式下DSS运行RUN级别信息。如果DSS运行故障,且开启RUN级别日志,请查看dsscmd.rlog和dssinstance.rlog。

日志目录:默认为$DSS_HOME/log/run。

  • DEBUG日志

打印数据库DSS模式下DSS运行DEBUG级别信息。如果DSS运行故障,且开启DEBUG级别日志,请查看dsscmd.dlog和dssinstance.dlog。

日志目录:默认为$DSS_HOME/log/debug。

  • 操作日志

打印数据库DSS模式下DSS运行OPER级别信息。如果DSS运行故障,且开启OPER级别日志,请查看dsscmd.olog。

日志目录:默认为$DSS_HOME/log/oper。

  • 审计日志

打印数据库DSS模式下DSS运行审计数据或者元数据进行修改或查询的信息。

日志目录:默认为$DSS_HOME/log/audit。

  • 黑匣子日志

打印数据库DSS模式下,dssserver进程异常终止时的异常基本信息。黑匣子日志默认开启,如需关闭,需配置参数_LOG_LEVEL=0, 重启dssserver后生效。

日志目录:默认为$DSS_HOME/log/blackbox。

DSS通过_LOG_LEVEL参数控制审计日志外的其他日志的记录情况。如果要记录多种日志类型,请将参数设置为各个日志类型对应的参数取值之和。各日志类型对应的参数取值见表1。

表 1 日志类型对应的_LOG_LEVEL取值

日志类型

_LOG_LEVEL参数取值(十进制)

RUN ERROR

1

RUN WARNING

2

RUN INFORMATION

4

DEBUG ERROR

16

DEBUG WARNING

32

DEBUG INFORMATION

64

OPER LOG

512

意见反馈
编组 3备份
    openGauss 2024-04-27 00:42:13
    取消