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
参数说明:has的二进制文件名。
取值范围:字符串。
默认值:””
om安装后的默认值为libclient.so。
CLUSTER_RUN_MODE
参数说明: DORADO双集群启动模式。
取值范围:”cluster_primary” | “cluster_standby”
默认值:”cluster_primary”
_BLACKBOX_DETAIL_ON
参数说明: 黑匣子日志开启时,是否要打印共享内存信息。
取值范围: 布尔型。
- 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取值