人大金仓数据库KingbaseES KES V8R3升级IPV6相关操作总结

KES V8R3升级IPV6相关操作总结

关键字：

KingbaseES、V8R3、IPV6、人大金仓、KingbaseES

一、IPV6简介

1.1 IPV6定义

IPV6是Internet Protocol Version 6的缩写，是用于代替IPV4的下一代IP协议。由于IPv4存在网络地址资源不足的问题，因此为了加快互联网的应用和发展，各大应用软件都逐步升级到IPV6。

1.2 IPV6地址格式

IPV6地址总长度128比特，分为8组，每组为4个十六进制数的形式，用冒号作为每组之间的间隔。如FC00:0000:130F:0000:0000:09C0:876A:130B。

每组中的前导0可以省略，连续两个以上均为0的组，可以用双冒号替代，但一个地址中只能使用一次双冒号，因此上述地址可缩写为：FC00:0:130F::9C0:876A:130B/64。

1.3 Linux中IPV6的添加与连接

检查/usr/bin/下是否存在ping6命令，如果不存在，请查找其他目录的是否有ping6命令。如果系统不存在ping6，应该系统不支持ipv6。

1.3.1 添加IPV6

输入ip addr查看系统网卡。

在网卡上添加ipv6地址：ip addr add <ipv6地址> dev <网卡名>

例：ip addr add 2023::48 dev enp125s0f3

在网卡上删除ipv6地址：ip addr del <ipv6地址> dev <网卡名>

1.3.2 IPV6连接

在服务器添加好ipv6地址后，执行下面命令去进行测试连接：

Ping6 <ipv6地址>

二、集群升级IPV6步骤及注意事项

2.1 补丁包安装升级

将server补丁包解压到集群目录下的db目录。在支持ipv6的补丁包中，修改了pcp_*的命令，如果db/bin中含有pcp_*的命令，一般需要将kingbasecluster中的pcp命令拷贝到db，如：

\cp -f kingbasecluster/lib/libpcp.* db/lib/ && \cp -f kingbasecluster/bin/pcp_* db/bin/

注意事项：

如果不执行此步骤，主备切换过程集群data正常启动，数据正常，主备流复制正常，但是kingbasecluster显示备机无法正常启动一直在down。需手动执行pcp_attch_node命令才可正常。

2.2 配置change_cluster_ip.conf

配置文件内容如下：

ip_db0='2001:db8::1' # 数据库节1点的ip ip_db1='2001:db8::2' # 数据库节2点的ip ip_pool1='2001:db8::1' # cluster节1点的ip ip_pool2='2001:db8::2' # cluster节2点的ip trust_server='2001:db8::10' # 信任ip,多个ip，需要以空格间隔 db_vip='2001:db8::253/64' # 数据库的vip pool_vip='2001:db8::254/64' # cluster的vip net_dev='ens192' # vip所在的网卡设备也应该和数据库ip所在网卡相同 db_local=$ip_db0 # 本地数据库节点的ip pool_local=$ip_pool1 # 本地cluster节点的ip pool_remote=$ip_pool2 # 其他cluster节点的ip ip_primary=$ip_db0 # 主数据库节点的ip KB_ALL_IP=($ip_db0 $ip_db1) # 所有数据库节点 DATA_PATH="/home/kingbase/cluster/test/db/data"

注意事项：

 1)ip_db0、ip_db1需要和HAmodule.conf中KB_ALL_IP中的之前的ip值

2)db_local为本地数据库节点ip，对应HAmodule.conf中KB_LOCALHOST_IP

 3)pool_local和pool_remote每个cluster节点根据本节点实际情况进行配置。

4)ip_primary应该为主节点的ip，会根据该ip修改recovery.conf，如果不对的话，流复制建立就会出问题。需要注意的是，在升级之前，如果执行了一次主备切换，此时的主机就是新主，对应的配置也要是新主的IP。

 5)KB_ALL_IP=($ip_db0 $ip_db1)为所有数据库节点的ip，应该和ipv4顺序保持一致。即不管是在那个节点进行配置该项，ip的顺序是保持不变的。

配置完change_cluster_ip.conf文件后，执行change_cluster_ip.sh，然后重启集群，此时集群就是以IPV6的方式启动。

如果上述配置不正确，会导致kingbasecluster的VIP无法正常连接，从而导致集群启动失败，报出如下错误：There are no 1 standbys in sys_stat_replication, please check all the standby servers replica from primary。

针对上述问题的处理方法，就是重新编辑每个节点的配置文件，填写正确后再次执行change_cluster_ip.sh，然后再重启集群。

2.3其他注意事项

如果出现如下双主的报错：Fatal error there are two hosts in the current environment. The master ip:2023::73 and 2023::72

解决方法：

从etc中拷贝一个recovery.done重命名为recovery.conf，复制到data目录，仅需一个节点执行即可。

三、其他工具IPV6的升级

3.1升级数据库管理工具

通用机升级数据库管理工具managertools：

tar xf kingbase-V008R003C002B0370PS002-ManagerTools.tar -C {install_dir}/ManagerTools/plugins

如果升级失败，可能的原因是缓存没有清理。

3.2接口升级

升级ipv6后，应用需要使用ipv6，需要替换jdbc。