030001.Install Oracle GoldenGate microservice 21.3 on centos stream 9

原创 ByteHouse 2024-07-03

712

1.环境描述

主机名	IP	角色	OS Version	DB Version	OGG Version	实例名	管理员名称口令
std	192.168.10.32	源库	Oracle linux 6.10	11.2.0.4	—	big	sys/admin123
dst	192.168.10.32	目标库	Oracle linux 7.9	19.3.0.0	—	fish	sys/admin123
ogg	192.168.10.31	\	Cetnos-Stream-9-20240624	\	21.3.0.0	—	ggsca/Admin@123!

GoldenGate microservice 为独立部署。

2.安装方式

为Oracle和非Oracle数据库安装Oracle GoldenGate Microservices Architecture的步骤相同。

2.1.图形化安装 — 部署安装

GUI Installation and Configuration/GUI 的安装与配置
• Oracle Universal Installer (OUI) to install the binary programs/Oracle Universal Installer（OUI）安装
二进制程序
• oggca.sh to configure GoldenGate/oggca.sh配置GoldenGate
• Create Service Manager/创建服务管理器
• Create Deployment(s)/创建部署
• Integrate with RAC/与RAC集成
• Adding GoldenGate Service Manager as system service/将GoldenGate服务管理器添加为系统服务

step 1.软件下载
https://www.oracle.com/middleware/technologies/goldengate-downloads.html

GoldenGate 21.3 已经内置了oracle client。内置了NGINX 可以代理到各个组件。

step 2.安装依赖包

dnf -y install /lib64/libnsl.so.1

step 3.创建部署用户

groupadd -g 54321 oinstall
groupadd -g 54322 dba
useradd -u 54321 -g oinstall -G dba oracle

step 4.创建微服务目录
OGG经典架构需要一个目录即OGG_HOME，微服务需要３个路径:

OGG_HOME,软件安装路径与经典架构保持一致，简称MA。
服务管理路径，微服务架构采用服务方式管理，简称SM,可以管理多个部署。例如for oracle 11g、oracle 12c等.
部署路径，微服务采购云操作方式，所有部署与管理都是通过web其中管理，简称DEPLOY

具体命令[root用户操作]

mkdir -pv /u01/app/ogg
mkdir -p /u01/app/21.3.0/ogg/ma

mkdir -p /u01/app/ogg/db11.2/ogg191_sm
mkdir -p /u01/app/ogg/db11.2/ogg191_deploy

mkdir -p /u01/app/oraInventory

chown oracle:oinstall /u01/app/oracle/oraInventory
chown oracle:oinstall /u01/app/ogg/ogg191_ma
chown oracle:oinstall /u01/app/ogg/db11.2/ogg191_sm
chown oracle:oinstall /u01/app/ogg/db11.2/ogg191_deploy

step 5.解压并进行软件安装

[root@goldengate opt]# unzip 213000_fbo_ggs_Linux_x64_Oracle_services_shiphome.zip
[root@goldengate opt]# chmod 775 *
[root@goldengate opt]# ll
total 372392
-rw-r--r--. 1 root root 381014026 Jul  3 08:56 213000_fbo_ggs_Linux_x64_Oracle_services_shiphome.zip
drwxr-xr-x. 3 root root        19 Jul 29  2021 fbo_ggs_Linux_x64_Oracle_services_shiphome
-rw-r--r--. 1 root root      2409 Aug 11  2021 OGG-21.3.0.0-README.txt
-rw-r--r--. 1 root root    306395 Aug 11  2021 oracle-goldengate-release-notes_21.3.pdf
[root@goldengate opt]# 
[root@goldengate opt]# cd fbo_ggs_Linux_x64_Oracle_services_shiphome/Disk1/
[root@goldengate Disk1]# ll
total 8
drwxr-xr-x.  4 root root  187 Jul 29  2021 install
drwxrwxr-x.  2 root root   25 Jul 29  2021 response
-rwxr-xr-x.  1 root root  918 Jul 29  2021 runInstaller
drwxr-xr-x. 12 root root 4096 Jul 29  2021 stage
[root@goldengate Disk1]#

从ogg 12 for oracle版本开始，ogg采用安装方式，类似Oracle GUI方式安装或者静默安装方式，取消12之前版本直接解压即可以使用方式，主要是为了将安装软件统一管理。如果环境没有图形支持，可以使用静默方式安装，使用图形安装，需要配置。安装包括软件安装以及服务配置以及部署配置，本次使用图形安装方式。

使用 oracle 用户，启动交互安装界面

[oracle@goldengate Disk1]$ ./runInstaller 
Starting Oracle Universal Installer...

Checking Temp space: must be greater than 120 MB.   Actual 86692 MB    Passed
Checking swap space: must be greater than 150 MB.   Actual 8191 MB    Passed
Checking monitor: must be configured to display at least 256 colors.    Actual 16777216    Passed
Preparing to launch Oracle Universal Installer from /tmp/OraInstall2024-07-03_11-30-08AM. Please wait ...[oracle@goldengate Disk1]$

核对安装信息无误后点击安装，可以存在response file作为模板后续使用静默安装;点击安装即可

使用 root 用户执行安装脚本：

执行完，点击确定，结束安装

[root@localhost bin]# pwd
/u01/app/ogg/ogg213_ma/bin
[root@localhost bin]# 
[root@localhost bin]# ll
total 113596
-rwxrwxr-x. 1 oracle oinstall  5111424 Jul 29  2021 adminclient
-rwxrwxr-x. 1 oracle oinstall 11692320 Jul 29  2021 adminsrvr
-rwxrwxr-x. 1 oracle oinstall  1645280 Jul 29  2021 cachefiledump
-rwxrwxr-x. 1 oracle oinstall  3185008 Jul 29  2021 certstore
-rwxrwxr-x. 1 oracle oinstall  2325248 Jul 29  2021 checkprm
-rwxrwxr-x. 1 oracle oinstall  1903992 Jul 29  2021 convchk
-rwxrwxr-x. 1 oracle oinstall  3075192 Jul 29  2021 convprm
-rwxrwxr-x. 1 oracle oinstall  5676840 Jul 29  2021 defgen
-rwxrwx---. 1 oracle oinstall 12413968 Jul 29  2021 distsrvr
-rwxrwxr-x. 1 oracle oinstall  4976136 Jul 29  2021 emsclnt
-rwxrwx---. 1 oracle oinstall 11182752 Jul 29  2021 extract
-rwxrwxr-x. 1 oracle oinstall  5013192 Jul 29  2021 ggcmd
-rwxrwxr-x. 1 oracle oinstall   112920 Jul 29  2021 keygen
-rwxrwxr-x. 1 oracle oinstall  5568576 Jul 29  2021 logdump
-rwxr-x---. 1 oracle oinstall    10362 Dec 16  2020 oggca.sh
-rwxrwxr-x. 1 oracle oinstall  1694456 Jul 29  2021 oggerr
-rwxrwxr-x. 1 oracle oinstall     4369 Jul 28  2021 orapki
-rwxrwxr-x. 1 oracle oinstall  8977080 Jul 29  2021 pmsrvr
-rwxrwx---. 1 oracle oinstall 10299008 Jul 29  2021 recvsrvr
-rwxrwx---. 1 oracle oinstall 11236912 Jul 29  2021 replicat
-rwxrwxr-x. 1 oracle oinstall  1690360 Jul 29  2021 retrace
-rwxrwxr-x. 1 oracle oinstall  8483888 Jul 29  2021 ServiceManager
-rwxrwxr-x. 1 oracle oinstall     6809 Oct 18  2018 XAGTask
[root@localhost bin]#

gggsci已经被 adminclient 替代。

2.2.静默安装(可选)

可以使用响应文件，进行静默安装，在完成安装准备后，如果要进行静默安装，可以用上述响应文件，启动静默模式，具体启动方式如下：

# 响应文件放到 /u01/app/oracle/stage
./runInstaller -silent -nowait -responseFile  /u01/app/oracle/stage/ogginstall.rsp

2.3.安装后检查

[root@localhost bin]# ./adminclient 
Oracle GoldenGate Administration Client for Oracle
Version 21.3.0.0.0 OGGCORE_21.3.0.0.0_PLATFORMS_210728.1047

Copyright (C) 1995, 2021, Oracle and/or its affiliates. All rights reserved.

Oracle Linux 7, x64, 64bit (optimized) on Jul 28 2021 12:32:46
Operating system character set identified as UTF-8.

OGG (not connected) 1> help

Administration Client Command Summary:

  !                  - Executes the previous command without modifications.
  ADD CREDENTIALS    - Create user credentials for use by the Administration Client.
  ALLOWNESTED        - Enables the use of nested OBEY files.
  CD                 - Change the Admin Client working directory
  CONNECT            - Connect to an Oracle GoldenGate Service Manager
  DELETE CREDENTIALS - Remove user credentials from the Administration Client.
  DISCONNECT         - Disconnect from the Oracle GoldenGate Service Manager
  EXIT               - Exit the Oracle GoldenGate Admin Client
  HELP               - Provides assistance with syntax and usage of commands.
  HISTORY            - Shows a list of the most recently issued commands since the startup of the session.
  INFO CREDENTIALS   - Display information about Administration Client user credentials.
  NOALLOWNESTED      - Disables the use of nested OBEY files.
  OBEY               - Processes a file that contains a list of Oracle GoldenGate commands.
  SET COLOR          - Enable or disable colored text in the Administration Client.
  SET DEBUG          - Enable or disable debugging mode for the Administration Client.
  SET EDITOR         - Sets the default text editor program for editing parameter files.
  SET PAGER          - Sets the default text viewer program for viewing parameter and report files.
  SET VERBOSE        - Enable or disable verbose command result output.
  SHELL              - Executes shell commands on the local system.
  SHOW               - Displays the attributes of the Oracle GoldenGate environment.

OGG (not connected) 2>

3.配置微服务

3.1.OGG环境变量

如果需要，请为数据库设置必要的环境变量。

注：（仅限Oracle）从Oracle GoldenGate 21c版本开始，Oracle_HOME和LD_LIBRARY_PATH不指向任何数据库目录。使用统一构建功能，这些环境变量现在指向OGG_HOME（子）目录，因为Oracle数据库客户端软件嵌入在Oracle GoldenGate中。

OGG_HOME
LD_LIBRARY_PATH
TNS_ADMIN
TNS_ADMIN 环境变量的取值：tnsnames.ora 文件所在目录。
当配置了TNS_ADMIN 环境变量之后，使用网络服务名连接Oracle数据库时，监听服务会优先读取指定目录下相关文件sqlnet.ora、tnsnames.ora。当在指定目录读取不到时，才会去读取默认的Oracle安装目录。

export OGG_HOME=/u01/app/oracle/product/21.3.0/ogghome_1
export LD_LIBRARY_PATH=/u01/app/oracle/product/21.3.0/ogghome_1/lib:$LD_LIBRARY_PATH
export PATH=/u01/app/oracle/product/21.3.0/ogghome_1/bin:$PATH

Windows环境下相关环境变量设置

3.2.运行ogg配置助手（oggca）配置微服务

运行 Oracle GoldenGate 配置助手 (oggca) 向导为 Oracle GoldenGate 安装添加部署

用使用oggca助手添加部署大纲：

创建一个OGG管理服务
注册管理服务
使用管理服务管理web工具细化部署
配置数据复制进程

创建一个管理服务

step 1.进入配置界面

勾选【将服务管理器注册为系统服务/守护进程】

LD_LIBRARY_PATH：默认情况下，此路径指向 Oracle GoldenGate 安装目录和底层即时客户端目录
TNS_ADMIN：${ORACLE_HOME}/network/admin

提示：仅限ORACLE数据库，指明tnsnames.ora文件的位置，如果不设将查找$OGG_HOME/.tnsnames.ora或 /etc/tnsnames.ora,这个文件需要手动配置放到默认目录下。

ODBCINI：使用于postgreSQL上的OGG,指定用于存储数据源名称 (DSN) 以连接到 PostgreSQL 数据库的 ODBC 文件的完整路径。
JAVA_HOME：jdk的位置

注册管理服务

要完成配置过程还需要用root身份执行 /bin/registerServiceManager.sh，执行完成后回到本界面点击确定。注册只在首次安装服务时需要，除非后面删除了所有管理服务，否则以后不用添加。

[root@localhost ogg213_ma]# /u01/app/ogg/db11.2/ogg191_sm/bin/registerServiceManager.sh
Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
----------------------------------------------------
     Oracle GoldenGate Install As Service Script    
----------------------------------------------------
OGG_HOME=/u01/app/ogg/ogg213_ma
OGG_CONF_HOME=/u01/app/ogg/db11.2/ogg191_sm/etc/conf
OGG_VAR_HOME=/u01/app/ogg/db11.2/ogg191_sm/var
OGG_USER=oracle
Running OracleGoldenGateInstall.sh...
Created symlink /etc/systemd/system/multi-user.target.wants/OracleGoldenGate.service → /etc/systemd/system/OracleGoldenGate.service.
[root@localhost ogg213_ma]#

至此完成了OGG一个非安全模式的服务配置。

查看后台 ServiceManage 的进程和监听的端口 7820

[root@localhost ogg213_ma]# ps -ef|grep ServiceManager
oracle     51896       1  0 12:37 ?        00:00:00 /u01/app/ogg/ogg213_ma/bin/ServiceManager --inventory '/u01/app/ogg/db11.2/ogg191_sm/etc/conf'
root       51939    4337  0 12:38 pts/0    00:00:00 grep --color=auto Service
[root@localhost ogg213_ma]# 

[root@localhost ogg213_ma]# ss -lntp|grep 9000
LISTEN 0      128          0.0.0.0:9000      0.0.0.0:*    users:(("ServiceManager",pid=51896,fd=8))
LISTEN 0      128             [::]:9000         [::]:*    users:(("ServiceManager",pid=51896,fd=7))
[root@localhost ogg213_ma]#

测试一下，用浏览器打开 http://localhost:9000

如果 Oracle GoldenGate 服务管理器注册为系统守护程序，则服务管理器和其他服务器会在主机（重新）启动时自动启动

提示：管理服务的启停命令

systemctl start OracleGoldenGate
systemctl status OracleGoldenGate
systemctl stop OracleGoldenGate

在下图中选择管理服务

主页面上可以查看微服务的各种状态及其详细信息，也可以操作微服务的状态变更，其中以下4个是OGG微服务架构的核心服务:

管理服务（Admin server）: 用于创建用户、添加附加日志、创建抽取和投递进程，类似在ggsci命令下添加附加日志、extract、replicat进程
分发服务（Distribution server）：用于创建传输进程，类似于以前的pump进程
接收方服务（Receiver server）：用于监控接收进程，类似于以前的server collector进程
性能度量服务（Performance metrics server）：性能监控，这个里面信息非常多，例如ADMINSRVR包括进程性能，线程性能以及进程状态与配置，非常详细与直观。

墨力计划

最后修改时间：2024-07-10 11:30:56

「喜欢这篇文章，您的关注和赞赏是给作者最好的鼓励」

关注作者

文章被以下合辑收录

03.Golden Gate （共5篇）

Golden Gate 相关