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
LOG_COMPRESSED
参数说明：控制日志转储支持压缩的功能。日志压缩时间计入dss业务执行时间中，开启日志压缩功能下，请勿将日志文件设置过大，否则将影响dss业务执行时间。
取范围： 布尔型，FALSE/TRUE。TRUE表示日志转储时进行文本压缩，最后保存的是GZIP格式的压缩文件。FALSE则表示不开启日志压缩功能。
默认值： FALSE
_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
参数说明：消息接收内存池大小。
取值范围：整型，9M~1G。
默认值： 42M
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
_ENABLE_CORE_STATE_COLLECT
参数说明：控制节点异常coredump时，是否会在DSS_HOME目录下生成临时文件dss.core.file。
取值范围：布尔型，FALSE/TRUE。TRUE表示节点异常coredump时，会在DSS_HOME目录下生成临时文件dss.core.file；FALSE表示节点异常coredump时，不会在DSS_HOME目录下生成临时文件dss.core.file。
默认值： FALSE
DELAY_CLEAN_INTERVAL
参数说明：主机后台延时清理线程的执行时间间隔。
取值范围：整型，5~1000000。单位：秒。
默认值： 300
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