19C RAC环境，利用XAG工具实现GoldenGate高可用-526互联

前言

一套19C RAC预生产环境，上面运行着一套GoldenGate，客户希望GoldenGate能实现高可用，当计算节点出现故障时，GoldenGate能自动切换到其他节点继续运行。

实现GoldenGate高可用，主要有两种方法来完成。一种是自己编写脚本，然后在GI集群中添加资源，调用编写的脚本，实现GoldenGate资源的高可用。另一种是利用xag工具完成GoldenGate的高可用，xag工具实际上是对第一种方式进行了命令行封装，所以实现过程非常简单。

本文主要记录利用xag工具进行配置GoldenGate高可用的步骤。

配置过程

整个环境如下表所示。

环境说明
GI版本	19.19
DB版本	19.19
GoldenGate版本	19.1.0.0.4
DB_HOME	/u01/app/oracle/product/19.0.0/dbhome_1
GoldenGate_HOME	/ogg

0、下载xag工具。

Xag工具所对应的Patch ID为：31215432，下载后的文件名：p31215432_190000_Generic.zip

1、所有节点上都创建xag目录：

[grid@testdb01 grid]$ mkdir -p /u01/app/grid/xaghome

2、安装xag软件至所有节点：

[grid@testdb01 grid]$ cd /tmp/xag/

[grid@testdb01 xag]$ ./xagsetup.sh --install --directory /u01/app/grid/xaghome --all_nodes

Installing Oracle Grid Infrastructure Agents on: testdb01

Installing Oracle Grid Infrastructure Agents on: testdb02

Installing Oracle Grid Infrastructure Agents on: testdb03

Updating XAG resources.

Successfully updated XAG resources.

[grid@testdb01 xag]$

只需要在节点1上执行，会自动分发到所有计算节点。

3、创建应用VIP：

[root@testdb01 tmp]# appvipcfg create -network=1 -ip=20.78.212.108 -vipname=ggatevip -user=root

[root@testdb01 tmp]# crsctl setperm resource ggatevip -o root

[root@testdb01 tmp]# crsctl setperm resource ggatevip -u user:grid:r-x

4、启动应用VIP：

[root@testdb01 ~]# crsctl start resource ggatevip

5、配置xag，添加ogg资源：

[root@testdb01 bin]# cd /u01/app/grid/xaghome/bin

[root@testdb01 bin]# ./agctl add goldengate gg_1 --gg_home /ogg --nodes testdb01,testdb02,testdb03 --oracle_home /u01/app/oracle/product/19.0.0/dbhome_1 --vip_name ggatevip --user grid

[root@testdb01 bin]#

[root@testdb01 bin]# crsctl setperm resource xag.gg_1.goldengate -o oracle

6、启动ogg资源：

[root@testdb01 bin]# crsctl start resource xag.gg_1.goldengate

7、模拟切换：

[root@testdb01 bin]# ./agctl relocate goldengate gg_1 --node testdb02

此时，GoldenGate会自动切换到testdb02节点上继续运行。

后记

利用xag工具配置高GoldenGate高可用后，使用crsctl start resource命令启动GoldenGate时，抽取进程启动失败。报错信息如下所示：

2023-09-07T11:01:48.541+0800 ERROR OGG-00303 Oracle GoldenGate Capture for Oracle, ext_cjjh.prm: Unable to connect to database using user ogg. Ensure that the necessary privileges are granted to the user. Login to the database as user ogg failed because of error ORA-12162: TNS:net service name is incorrectly specified.

2023-09-07T11:01:48.541+0800 ERROR OGG-01668 Oracle GoldenGate Capture for Oracle, ext_cjjh.prm: PROCESS ABENDING.

从报错的日志可以看出，GoldenGate用户（ogg）无法登录数据库，失败的原因是连接数据库的服务名不正确。

查看抽取进程的配置文件，配置文件中可能会引发故障的核心代码如下所示：

GGSCI (testdb01) 3> view params ext_cjjh

EXTRACT ext_cjjh

Setenv (NLS_LANG="AMERICAN_AMERICA.AL32UTF8")

USERID ogg, PASSWORD AACAAAAAAAAAAAKAIHMGXGPEZEIJMFGBTAMEPIDAQGPHSJZD,encryptkey default

CACHEMGR CACHESIZE 20240MB,CACHEDIRECTORY ./dirtmp 50480MB

DISCARDFILE ./dirrpt/extcjjh.dsc, APPEND, MEGABYTES 1024

DBOPTIONS ALLOWUNUSEDCOLUMN

。。。。略

从抽取进程的配置文件可以看出，使用ogg用户连接数据库，由于未使用连接串，所以默认使用了oracle用户的环境变量中的ORACLE_SID变量来连接数据库。