UWAL
介绍
本章节主要介绍openGauss数据库UWAL（Unified Write-Ahead Log）特性的安装使用，指导用户顺利完成操作。本特性将数据库和自研公共组件UWAL相结合，以提高数据库的主备事务提交和流复制传输性能，从而加速WAL（Write-Ahead Log）的处理效率。
安装准备
获取安装包
请通过openGauss社区RM SIG获取UWAL安装包。
环境要求
需要支持RDMA和以太网并开启RDMA协议，开启RDMA协议的具体步骤请参见《RDMA网络指导》。 | ||
| ||
| ||
| ||
| UWAL安装包。openeuler_22.03、centos-7.6表示操作系统，aarch64、x86_64表示服务器架构，gcc10、gcc7表示依赖的GCC版本，具体UWAL安装包请用户根据实际情况选择。 |
安装卸载
一键部署UWAL特性
UWAL提供简易部署脚本，支持一键部署。
前提条件
- openGauss已部署完成。
- 获取对应操作系统和CPU架构的UWAL安装包，例如：OCK_UWAL_23.0.0_openeuler_22.03-aarch64_gcc10.tar.gz。
- 主备节点均已存在以下目录：
- “${GAUSSHOME}/lib“路径
- UWAL文件存放路径（“uwal_devices_path“对应的值）
- UWAL日志文件存放路径（“uwal_log_path“对应的值）
操作步骤
说明：
以下操作除特殊说明外，默认只在主节点进行操作。将安装包上传至节点，在安装包所在目录执行以下命令赋予openGauss数据库用户操作权限。
chown omm:dbgrp OCK_UWAL_23.0.0_openeuler_22.03-aarch64_gcc10.tar.gz 说明：- omm：数据库管理用户名。
- dbgrp：数据库管理用户组。
切换为openGauss数据库管理用户，解压缩安装包。
su - omm tar -xzvf OCK_UWAL_23.0.0_openeuler_22.03-aarch64_gcc10.tar.gz解压后得到以下文件。
解压源文件压缩包。
tar -xzvf OCK_UWAL_23.0.0_openeuler_22.03_aarch64_gcc10.tar.gz解压后得到如下文件。
说明：
如果重复解压源文件，需清理以上文件后再解压。使用“bin“目录下的verification二进制，进行软件包签名验证。
./bin/verification OCK_UWAL_23.0.0_openeuler_22.03_aarch64_gcc10.tar.gz OCK_UWAL_23.0.0_openeuler_22.03_aarch64_gcc10.tar.gz.cms OCK_UWAL_23.0.0_openeuler_22.03_aarch64_gcc10.tar.gz.txt 说明：
verification可执行二进制需要三个参数，按先后顺序分别是：源文件、签名文件、描述文件。验证成功控制台会输出：
Starting to verify OCK_UWAL_23.0.0_openeuler_22.03_aarch64_gcc10.tar.gz... Verify the source file passed. Verify the sha file passed.验证失败控制台会输出：
Starting to verify OCK_UWAL_23.0.0_openeuler_22.03_aarch64_gcc10.tar.gz... ... Verify the source file failed.或者
Starting to verify OCK_UWAL_23.0.0_openeuler_22.03_aarch64_gcc10.tar.gz... ... Verify the sha file failed. 说明：
校验失败说明此安装包已被篡改，建议重新获取安装包后再次校验。
安装包验证成功后，进入“scripts“目录，准备执行部署脚本。
cd scripts启动脚本，即可完成UWAL部署。
sh ock_uwal_install.sh -H '192.168.4.164 192.168.4.165 192.168.4.166' -U omm -D /home/omm/lib 说明：- -H：集群IP地址。例如：'192.168.4.164 192.168.4.165 192.168.4.166'
- -U：数据库管理用户名。例如：omm
- -D：“${GAUSSHOME}/lib“库路径。例如：“/home/omm/lib“
- -h：查看帮助信息。
（可选）kill om_monitor进程。
gs_om -t killmonitor执行以下命令，加载环境变量。
source ~/.bashrc
须知：
此步骤也需要在备节点执行。（可选）UWAL组件依赖HCOM组件进行RPC通信，用户可根据需要配置以下环境变量。
export HCOM_FILE_PATH_PREFIX="/home/uds/socket/file" export HCOM_OPENSSL_PATH="/home/openssl" export HCOM_TRACE_LEVEL=0 export HCOM_QP_TRAFFIC_CLASS=106 export HCOM_SHM_EXCHANGE_FD_QUEUE_SIZE=10 export HCOM_CONNECTION_RETRY_TIMES=5 export HCOM_CONNECTION_RETRY_INTERVAL_SEC=2具体参数见下表：
- 0：不开打点。
- 1：打开高优先级打点。
- 2：打开中优先级打点。
- 3：打开低优先级打点。
启用UWAL特性
启用UWAL特性，需要通过修改配置文件，重启数据库使其生效。
前提条件
- 主备节点已安装包含UWAL特性的openGauss版本。
- 已完成UWAL特性的一键部署。
操作步骤
以数据库管理用户登录管理节点。
配置数据库的postgresql.conf文件。
打开postgresql.conf文件。
vim postgresql.conf按“i”进入编辑模式，在文件最后增加如下参数。此处以一主一备做举例，具体参数请根据实际情况设置，参数说明请参见表1。
replconninfo1='localhost=10.10.10.201 localport=5432 remotehost=10.10.10.207 remoteport=5432 remotenodeid=2 remoteuwalhost=10.10.10.207 remoteuwalport=9991' enable_uwal = on uwal_config = '{"uwal_nodeid": 0, "uwal_ip": "10.10.10.201", "uwal_port": 9991, "uwal_protocol": "tcp", "cpu_bind_switch": "true", "cpu_bind_start": 1, "cpu_bind_num": 3}' uwal_disk_size = 8589934592 uwal_devices_path = '/home/Data/uwal/' uwal_log_path = '/home/Data/opengauss_master/uwal_log' uwal_rpc_compression_switch = true uwal_rpc_flowcontrol_switch = true uwal_rpc_flowcontrol_value = 128 uwal_async_append_switch = false application_name = 'node201' 说明：- 一主两备，需要在“replconninfo1“参数的下一行添加“replconninfo2“参数，如：
replconninfo2='localhost=10.10.10.201 localport=5432 remotehost=10.10.10.208 remoteport=5432 remotenodeid=2 remoteuwalhost=10.10.10.208 remoteuwalport=9991'- 一主N备时，依次增加至“replconninfoN“参数即可。
表 1 UWAL的配置参数
表 2 uwal_config配置参数
- tcp
- rdma
- true，表示开启绑核。
- false，表示关闭绑核。
按“Esc”键，输入 :wq!，按“Enter”保存并退出编辑。
重启数据库使UWAL特性生效。
停止openGauss。
cm_ctl stop启动openGauss。
cm_ctl start 说明：
如果启动失败请根据openGauss日志目录下的“postgresql-YYYY-MM-DD_HHMMSS.log”日志信息排查错误。
验证UWAL特性是否启用成功。
gsql -d postgres -p 16600 -c "show enable_uwal"如果回显如下内容，则启用成功。
enable_uwal ------------------- on (1 row) 说明：- -p 16600：16600为数据库端口号，请根据实际情况修改。
- 如需查看启用UWAL特性的日志文件，可进入“uwal_log_path“对的路径执行以下命令。
cat uwal*.log