主备共享存储

主备共享存储

特性简介

主备共享存储特性主要提供主备机共享一份存储的能力，提供一种主备共享存储的新HA部署形态，解决传统HA部署下存储容量较单机翻倍的问题，满足降低存储容量及成本的诉求。并可选通过OCK RDMA提升备机实时一致性读能力。

架构介绍

主备共享存储整体架构图如下所示。

图 1 主备共享存储架构图

磁阵设备并且已经安装ultrapath多路径软件，磁阵设备可用。
分布式存储服务DSS（Distributed Storage Service）

DSS是独立进程，直接管理磁阵裸设备，并对外提供类似分布式文件系统的能力。通过共享内存和客户端API动态库，为数据库提供创建文件、删除文件、扩展和收缩文件、读写文件的能力。
分布式内存服务DMS（Distributed Memory Service）

DMS是动态库，集成在数据库内部，通过TCP/RDMA网络传输PAGE内容，将主备内存融合，提供内存池化能力，以此实现备机实时一致性读功能。
主备页面交换通过RDMA加速，依赖CX5网卡，并且依赖OCK RDMA动态库。

功能特点

主备共享一份数据，显著降低传统HA的存储容量。
主备之间去除了日志复制功能，增加了主备页面交换功能，备机支持实时一致性读。
默认情况下，主备之间是通过TCP网络进行页面实时交换。为了降低页面交换的延迟，提供引入计算的OCK RDMA动态库方式，提升备机实时一致性的性能。

适用场景与限制

要求存储设备是磁阵，磁阵的LUN需要支持SCSI3的PR协议（包括PR OUT（“PERSISTENT RESERVE OUT”）PR IN（“PERSISTENT RESERVE IN”）和INQUIRY），用于实现集群IO FENCE；除此之外, 还需要支持SCSI3的CAW协议（COMPARE AND WRITE）, 用于实现共享磁盘锁。如Dorado 5000 V3磁阵设备。
openGauss下可以支持部署8个备机。
由于主备共享存储依赖类似分布式文件系统的功能来实现备机实时一致性读能力，因此要求文件元数据变更越少越好。基于性能考虑，本特性只支持段页式表。
只支持主备部署在同一磁阵设备上，不支持容灾部署，也不支持主备混合部署（如主和备部署在不同的磁阵设备上）。
主备页面交换通过RDMA加速，依赖CX5网卡，并且依赖计算提供的OCK RDMA动态库。
暂不支持备机重建及节点替换、节点修复等能力。
不支持从传统HA部署升级到基于主备共享存储部署。

手动安装示例

与传统gs_initdb建库相比，共享存储建库将目录分为三种类型，每实例独占且不共享、每实例独占且共享、所有实例共享。其中需要共享的目录均需存放到磁阵设备上，而不共享的目录存放在本地盘上。另外备机建库只需要建隶属于自己的目录，不需要再次创建所有实例共享的目录结构。主备共享存储新增了相关GUC参数，以及将系统表存储方式从页式切换到段页式。

说明： 此处的单步手动安装是指工程编译之后，可单步执行相关命令进行共享存储建库。openGauss常规安装请参照《安装指南》。

前置条件
- 工程已完成代码编译，编译请参见软件安装编译。
- 主机已经挂载磁阵LUN设备，并且已经安装ultrapath多路径软件，磁阵设备可用。
操作步骤
1. 为磁阵LUN盘符创建软链接，并赋予相应的用户权限（假设磁阵LUN对应的盘符为/dev/sde, /dev/sdf）。
```
sudo ln -s /dev/sde /dev/tpcc_data
sudo ln -s /dev/sdf /dev/tpcc_log
sudo chmod 777 /dev/tpcc_data
sudo chmod 777 /dev/tpcc_log
```
2. 为需要磁阵RAWIO权限的可执行文件赋权。
```
sudo -i setcap CAP_SYS_RAWIO+ep 绝对路径/perctrl
```
  perctrl：用于对dss相关工具和进程赋予读写权限的可执行工具。
3. 创建DSS服务端进程及建共享存储库需要的配置文件。
  
  测试目录(假设为/data/test)
```
└─dss_home/
├── cfg
│   ├── dss_inst.ini
│   └── dss_vg_conf.ini
└── log // 启动前需存在log目录
```
  dss_init.ini配置内容如下：
```
INST_ID=0
_LOG_LEVEL=55
_LOG_BACKUP_FILE_COUNT=128
_LOG_MAX_FILE_SIZE =20M
LSNR_PATH=/data/test/dss_home
STORAGE_MODE=RAID
_SHM_KEY=12
```
  上述配置中参数说明如下：
  - INST_ID配置实例号，取值范围[0, 63]，每个主备下的dssserver进程各不相同。
  - _LOG_LEVEL日志级别。
  - _LOG_BACKUP_FILE_COUNT日志文件最多保留的个数。
  - _LOG_MAX_FILE_SIZE为单个日志文件最大大小。
  - LSNR_PATH为DSS客户端与服务端之间通信使用的domain socket保存的目录，一般设为DSS服务端进程的家目录。
  - STORAGE_MODE为DSS对应的存储设备类型，磁阵的话配置为RAID。
  - _SHM_KEY共享内存KEY，需要保证每个DSS各不相同。
  dss_vg_conf.ini配置内容如下，
```
 data:/dev/tpcc_data
 log: /dev/tpcc_log
```
  表示+data目录的内容存放在/dev/tpcc_data设备上，+log目录内容存放在/dev/tpcc_log设备上。这里要注意下，约定通过根目录名是否有+字符区分是文件系统中的文件，还是DSS中的文件。用户可以把DSS当做类似分布式文件系统来看待。
4. 使用DSS客户端工具（dsscmd）在磁阵设备上初始化VG（类似于在裸盘上初始化文件系统的操作）。
```
# 清空磁阵LUN开头数据
dd if=/dev/zero bs=2048 count=100000 of=/dev/tpcc_data
dd if=/dev/zero bs=2048 count=100000 of=/dev/tpcc_log
# 创建VG
dsscmd cv -g data -v /dev/tpcc_data -s 2048 -D /data/ss_test/dss_home
dsscmd cv -g log  -v /dev/tpcc_log -s 65536 -D /data/ss_test/dss_home
# 拉起dssserver
dssserver -D /data/ss_test/dss_home &
```
5. 通过gs_initdb建立共享存储库。
```
gs_initdb -D /data/ss_test/dn_primary --nodename=single_node -w Gauss_234 --vgname="+data,+log" --enable-dss --dms_url="0:127.0.0.1:1611,1:127.0.0.1:1711" -I 0 --socketpath="UDS:/data/ss_test/dss_home/.dss_unix_d_socket"
```
  其中新增5个相关参数：
  - –vgname 卷组名，指定共享存储库建在哪个卷组下，这个名字与dss_vg_conf.ini文件中的配置项相关，卷组名需要出现在配置文件中，并且以‘+’字符开头。
  - –enable_dss 表示共享存储库要建到DSS里。
  - –dms_url “0:127.0.0.1:1611,1:127.0.0.1:1711”，格式为instance_id:ip:port。
  - -I 指定当前节点的实例号，取值范围[0,63]。
  - –socketpath 指定DSS客户端（这里指集成到数据库相关可执行文件中的DSS客户端动态库）与服务端通信使用的unix domain socket存放的位置。
6. 建共享存储库成功，通过gs_ctl start命令拉取数据库进程。
```
gs_ctl start -D /data/ss_test/dn_primary
```
7. 按照上述步骤再重新执行安装备机。

OCK RDMA使用示例

共享存储特性提供备机实时一致性读功能，主备之间页面交换可选择通过RDMA加速。此章节简要描述如何在共享存储中开启RDMA通信功能。

前置条件

开启RDMA功能依赖CX5网卡，并且依赖OCK RPC动态库。
操作步骤
1. 获取OCK RPC包。
  
  从指定openGauss接口人处获取。
2. 部署OCK RPC包。
  1. 解压OCK RPC包。
```
tar -zxf OCK_platform_rpc_22.0.0_EulerOS-aarch64.tar.gz
cd OCK_platform_rpc_22.0.0_EulerOS-aarch64_release
tar -zxf OCK_platform_rpc_EulerOS_aarch64.tar.gz
tar -zxf OCK_platform_rpc_sbin.tar.gz
cp rpc_sbin/ock_rpc_opengauss.sh ./
```
  2. 修改部署脚本ock_rpc_opengauss.sh参数。
```
# Deployment user, which is the same as the opengauss user. 
# It is a non-root user. Ensure that this user exists on all servers.
USER_NAME="${USER}"
# Deployment server, which can contain native
HOST_IP=(30.30.xx.7 30.30.xx.8)
# Deployment package. The package name starts with OCK_platform_rpc.
PACKAGES="OCK_platform_rpc_aarch64_EulerOS.tar.gz"
# Specifies the path from the SCP package to the server. 
# If the path does not exist, the path is automatically created.
PATH_TO_SCP="/home/ock/test"
# Opengauss environment variable
GAUSSHOME="/home/ock/mppdb_temp_install"
# OCK_RPC environment variable. Do not change
OCK_RPC_LIB_PATH="${GAUSSHOME}/lib"
```
    脚本中涉及参数如下：
    1. USER_NAME：DN所在机器用户名。
    2. HOST_IP ：集群机器ip，包括本机机器。
    3. PACKAGES：获取到的ock rpc二进制包名（与机器操作系统架构匹配）。
    4. PATH_TO_SCP：拷贝路径。
    5. GAUSSHOME：同openGauss配置的环境变量GAUSSHOME一致。
    6. OCK_RPC_LIB_PATH：ock rpc二进制所在路径，共享存储会通过动态加载方式使用，请务必配置正确。
  3. 执行部署脚本ock_rpc_opengauss.sh。
```
sh ock_rpc_opengauss.sh
```
    说明： 实现功能：
    - 完成集群中OCK RPC二进制包的部署，解压和拷贝。
    - 配置好相关的环境变量$OCK_RPC_LIB_PATH。
    - 配置集群节点UCX环境变量。(UCX为基于RDMA开发的通信组件，OCK RPC是在UCX基础上开发的适配共享存储的通信组件。)
  4. 配置其他参数环境变量。
```
export UCX_ZCOPY_THRESH="32768"
export UCX_USE_MT_MUTEX=n
export UCX_NET_DEVICES=mlx5_1:1
```
    参数说明：
    1. UCX_ZCOPY_THRESH优化参数，RDMA传输过程中减少内存申请。单位：byte。默认值：32768。（可选参数，建议默认值）。
    2. UCX_USE_MT_MUTEX优化参数，RDMA发送过程中保证数据一致性锁的类型，n:原子锁；y:互斥锁。（可选参数，建议使用原子锁，性能较好）。
    3. UCX_NET_DEVICES，UCX配置参数，用于指定网卡端口，可安装mlnx_ofed驱动，使用ibdev2netdev命令查看当前RDMA活动端口。（建议指定活动端口）。
      
      说明： 环境变量配置完之后，执行 source ~/.bashrc
3. 执行1~5完成gs_initdb建库。
4. 修改postgresql.conf配置文件。
  
  配置ss_interconnect_type=RDMA，添加配置项ss_rdma_work_config与ss_ock_log_path。参数说明及配置请参见共享存储参数。
  
  示例：
```
ss_interconnect_type=RDMA
ss_rdma_work_config ='6 10'     （OCK RDMA使用用户态poll方式，并绑定cpu [6 10]，空格分开）
ss_ock_log_path=“/home/ock_test/log”(OCK RDMA 消息通信过程日志记录)
```
5. 执行gs_ctl start命令拉取数据库进程。
```
gs_ctl start -D /data/ss_test/dn_primary
```