dsscmd

dsscmd

概述

openGauss部署共享存储模式且开启ss_enable_dss功能情况下，经常需要对基于磁阵实现的集群文件系统进行各种查询，操作和管理。为了对dss创建的文件系统进行有效的管理，共享存储提供了dsscmd管理工具。

命令

显示帮助信息

1. dsscmd - 创建卷组

1. dsscmd cv <-g vg_name> <-v vol_name> [-s au_size] [-D DSS_HOME]

此处的vg_name为卷组名，命名长度不能超过64，仅支持数字，大小写字母，和部分特殊字符 ‘ _ ‘ , ‘ . ‘ , ‘ - ‘ 。其他字符不支持。 - 显示卷组和磁盘使用信息

1. dsscmd lsvg [-m measure_type] [-t show_type] [-U UDS:socket_domain] - 卷组中添加卷

1. dsscmd adv <-g vg_name> <-v vol_name> [-U UDS:socket_domain]

此处的vg_name为卷组名，不需要以‘+’开头。 - 新建目录

1. dsscmd mkdir <-p path> <-d dir_name> [-U UDS:socket_domain] - 创建文件

1. dsscmd touch <-n name> [-U UDS:socket_domain]

此处的name为文件名命名长度不能超过64（非目录，单指文件名），仅支持数字，大小写字母，和部分特殊字符 ‘ _ ‘ , ‘ . ‘ , ‘ - ‘ 。其他字符不支持。 - 显示路径下文件信息

1. dsscmd ls <-p path> [-m measure_type] [-U UDS:socket_domain] - 将源文件复制到目标文件

1. dsscmd cp <-s src_file> <-d dest_file> [-U UDS:socket_domain] - 删除卷组文件

1. dsscmd rm <-n name> [-U UDS:socket_domain] - 删除卷组中的卷

1. dsscmd rmv <-g vg_name> <-v vol_name> [-U UDS:socket_domain]

此处的vg_name为卷组名，不需要以‘+’开头。 - 删除目录及其内容

1. dsscmd rmdir <-p path> [-r] [-U UDS:socket_domain path] - 查询LUN/注册信息

1. dsscmd inq <-t inq_type> - 显示客户端信息

1. dsscmd lscli - 将当前节点添加到集群，走服务端

1. dsscmd regh [-U UDS:socket_domain] - 将当前节点从集群中移除

1. dsscmd unregh [-U UDS:socket_domain] - 从集群中移除非当前节点，第一个参数是要移除的节点id

1. dsscmd kickh <-i inst_id> [-U UDS:socket_domain] - 将节点添加到集群，不走服务端

1. dsscmd reghl <-i inst_id> [-D DSS_HOME] - 将节点从集群中移除，不走服务端

1. dsscmd unreghl <-i inst_id> [-D DSS_HOME] - 将节点注册到volname，不走服务端

1. dsscmd reg <-i inst_id> <-v vol_name> - 将节点从volname中取消注册，不走服务端

1. dsscmd unreg <-i inst_id> <-v vol_name> - 清理掉节点在volume上保留的所有信息

1. dsscmd clrreg <-i inst_id> <-v vol_name> - 抢占持续预留并删除注册信息

1. dsscmd kick <-i inst_id> <-k kicked_inst_id> <-v vol_name> - 设置dss节点的auid

1. dsscmd auid <-a auid> - 抢占持续预留并删除注册信息与服务端无交互

1. dsscmd kickhl <-i inst_id> <-k kicked_inst_id> [-D DSS_HOME] - 读取dss文件内容

1. dsscmd examine <-n name> <-o offset> <-f format> [-s read_size] [-D DSS_HOME] [-U UDS:socket_domain]

此处format为读取文件内容的格式，取值范围为：c char、h unsigned short、u unsigned int、l unsigned long、s string、x hex。 - 读取磁阵文件内容

1. dsscmd dev <-p path> <-o offset> <-f format> [-D DSS_HOME]

此处format为读取文件内容的格式，取值范围为：c char、h unsigned short、u unsigned int、l unsigned long、s string、x hex。 - 显示磁盘信息

1. dsscmd showdisk <-g vg_name> <-s struct_name> [-D DSS_HOME] 2. dsscmd showdisk <-g vg_name> <-b block_id> <-n node_id> [-D DSS_HOME]

说明： 如果指定参数-b block_id，则需指定-n node_id。 - 重命名文件名

1. dsscmd rename <-o old_name> <-n new_name> [-U UDS:socket_domain] - 显示带有可选参数的文件/目录的磁盘使用情况

1. dsscmd du <-p path> [-f format] [-U UDS:socket_domain]

说明： format：支持3种参数，参数之间不需要任何分隔符。

B|K|M|G|T B: Byte, K: KB ,M: MB , G: GB, T: TB。

s|a s :目录，a：计算所有文件，而不仅仅是目录。

S 对于目录不包括子目录的大小。

按文件名查找文件所在路径

1. dsscmd find <-p path> <-n name> [-U UDS:socket_domain] - 创建软连接

1. dsscmd ln <-s src_path> <-t target_path> [-U UDS:socket_domain] - 显示文件链接信息

1. dsscmd readlink <-p path> [-U UDS:socket_domain] - 取消软连接

1. dsscmd unlink <-p path> [-U UDS:socket_domain] - 加密

1. dsscmd encrypt - 设置配置项

1. dsscmd setcfg <-n name> <-v value> [-s scope] [-U UDS:socket_domain] - 获取配置项信息

1. dsscmd getcfg <-n name> [-U UDS:socket_domain] - 关闭dssserver进程

1. dsscmd stopdss [-U UDS:socket_domain]

参数说明

show_type

d显示详细信息，t显示表中的信息。 - au_size：

au的大小，单位KB，范围为2MB-64MB。 - vg_name

卷组名。 - measure_type

显示文件大小的单位。例如，B:Byte, K:KB, M:MB, G:GB, T:TB。

默认为Byte。 - dir_name

目录名，命名长度不能超过64，仅支持数字，大小写字母，和部分特殊字符 ‘ _ ‘ , ‘ . ‘ , ‘ - ‘ 。其他字符不支持。 - dest_file

目标文件，文件名命名长度不能超过64（非目录，单指文件名），仅支持数字，大小写字母，和部分特殊字符 ‘ _ ‘ , ‘ . ‘ , ‘ - ‘ 。其他字符不支持。 - vol_name

卷名。 - -D

$DSS_HOME所在路径。 - -U UDS:socket_domain

dss实例进程使用的socket文件路径。 - inst_id |kicked_inst_id

集群中dss实例id。 - addr

volume上锁的起始地址。 - -r

级联删除。 - inq_type

查询信息的类型。取值如下:

lun：查询LUN 信息。
reg：查询reservations信息。
read_size

读取长度。 - struct_name

指定输出信息的文件类型。

取值范围：core_ctrl、vg_header、 volume_ctrl 、root_ft_block。 - new_name

重命名后的文件名。

文件名命名长度不能超过64（非目录，单指文件名），仅支持数字，大小写字母，和部分特殊字符 ‘ _ ‘ , ‘ . ‘ , ‘ - ‘ 。其他字符不支持。 - target_path

目标文件。

文件名命名长度不能超过64（非目录，单指文件名），仅支持数字，大小写字母，和部分特殊字符 ‘ _ ‘ , ‘ . ‘ , ‘ - ‘ 。其他字符不支持。 - name:

配置项名称。 - value

配置项的值。 - scope

配置项生效的范围。

取值范围：memory、pfile或both。

memory：表示在内存中进行修改，立即生效。
pfile：表示在pfile中进行修改，修改后需要重启数据库才能生效。
both：表示既在内存也在pfile中进行修改。

使用示例

创建卷组，卷组名为data和log，au大小分别为2048和65536，-D指定dss_home。

1. dsscmd cv -g data -v /dev/tpcc_data -s 2048 -D /home/ss_test/dss_home 2. dsscmd cv -g log -v /dev/tpcc_log -s 65536 -D /home/ss_test/dss_home - 创建文件夹pg_xlog0 ，UDS指定dss进程的socket文件。

1. dsscmd mkdir -p +log -d pg_xlog0 -U UDS:/home/ss_test/dss_home/.dss_unix_d_socket - 文件复制，将data中的文件复制到log中。

1. dsscmd cp -s +data/pg_xlog0/000000010000000000000001 -d +log/pg_xlog0/000000010000000000000001 -U UDS:/home/ss_test/dss_home/.dss_unix_d_socket - 文件删除，删除data中文件。

1. dsscmd rm -n +data/pg_xlog0/000000010000000000000001 -U UDS:/home/ss_test/dss_home/.dss_unix_d_socket - 删除data中文件夹pg_xlog0/archive_status（文件夹为空，若文件夹内有文件需要级联删除，需要加-r）。

1. dsscmd rmdir -p +data/pg_xlog0/archive_status -U UDS:/home/ss_test/dss_home/.dss_unix_d_socket - 创建软链接。

1. dsscmd ln -s +log/pg_xlog0 -t +data/pg_xlog0 -U UDS:/home/ss_test/dss_home/.dss_unix_d_socket - 查看data中pg_xlog0目录下的文件信息。

1. dsscmd ls -p +data/pg_xlog0 -U UDS:/home/ss_test/dss_home/.dss_unix_d_socket