GoldenGate Enterprise Manager Plug-In(12.1.0.3.0) 部署文件

  對於Oracle GoldenGate 12c的監控，之前公司開發過自己的平臺，使用python指令碼定時去執行獲取程式狀態，並且開發了圖形化的介面去檢視OGG的程式拓撲圖，並支援一些簡單的程式新增、刪除、新增表同步等操作。Oracle官方也有OGG的相關管理包，包括GoldenGate Monitor,Goldengate veridata,GoldenGate Director等。其中GoldenGate Monitor是基於Oracle Weblogic的Fusion Middleware相關產品，功能強大，可以實現對OGG的監控。由於現在已經使用EMCC12c的監控資料庫，並且Oracle em 有支援監控OGG的plug-in，所以考慮使用plug-in去監控OGG，省去了單獨部署一套GoldenGate Monitor的工作。

1.相關軟體需求以及支援的版本

由於我這邊安裝的EMCC的版本為12.1.0.5.0,支援的ogg em plug-in的版本只能為12.1.0.3.0，低於此版本的或者高於此版本的plug-in全部下載下來進行了import測試，發現都不支援。

官方文件上的要求:

EMCC版本要在12.1.0.4.0或者以上,我這裡emcc 12c的版本是12.1.0.5.0

Goldengate monitor Jagent的版本需要在12.1.3.0.3或者以上,這裡我安裝的Jagent版本為12.2.1.2.0

Oracle Goldengate的版本為Oracle GoldenGate 12c (12.1.2.0.0)以上，我這裡安裝的版本為 12.2.0.2.2

java要求的最低版本為1.7.0_85，這裡需要安裝安裝的版本為1.8.0_231

注:以上的版本要嚴格按照要求去選擇，否則會出現plug-in無法部署或者jagent啟動報錯無法監控ogg例項的狀態的情況。

2.在監控的目標端主機上部署emcc 12c的agent(此步驟略過，可以參考emcc 12c agent部署的相關文件，有agent clone或者rpm包等方式進行部署)

3.在OMS伺服器上，下載GoldenGate Enterprise Manager Plug-In安裝包，使用emcli進行匯入

[oracle@oramoniter ~]$ emcli login -username=sysman -password=oracle123
Login successful
[oracle@oramoniter ~]$ emcli sync
Synchronized successfully
[oracle@oramoniter ~]$ unzip V137354-01.zip 
[oracle@oramoniter ~]$ emcli import_update -omslocal -file=/home/oracle/12.1.0.3.0_oracle.fmw.gg_2000_0.opar

登入emcc 12c控制檯，點選右上角set up=> extensibility => plug-ins進入介面，可以在Middleware目錄下看見Oracle GoldenGate的監控外掛:

4.把ogg em plug-in deploy到agent目標端,步驟如下圖所示

5.目標端安裝OGG Monitor Aagent

5.1.解壓安裝jdk 1.8

[oracle@rptdb ~]$ tar -xvf jdk-8u231-linux-x64.tar.gz
[oracle@rptdb bin]$ /home/oracle/jdk1.8.0_231/bin/java -version          
java version "1.8.0_231"
Java(TM) SE Runtime Environment (build 1.8.0_231-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.231-b11, mixed mode)

5.2.安裝Jagent

--解壓OGG Monitor安裝包
[oracle@rptdb ~]$  unzip fmw_12.2.1.2.0_ogg_Disk1_1of1.zip
--建立安裝目錄
[oracle@rptdb ~]$ mkdir /u01/app/wls
--調出圖形介面，安裝Jagent
[oracle@rptdb ~]$ xhost +
access control disabled, clients can connect from any host
xhost:  must be on local machine to enable or disable access control.
[oracle@rptdb ~]$ /home/oracle/jdk1.8.0_231/bin/java -jar -Xmx1024m fmw_12.2.1.2.0_ogg.jar
Launcher log file is /tmp/OraInstall2020-09-05_01-33-54PM/launcher2020-09-05_01-33-54PM.log.
Extracting the installer . . . . . Done
Checking if CPU speed is above 300 MHz.   Actual 1995.062 MHz    Passed
Checking monitor: must be configured to display at least 256 colors.   Actual 16777216    Passed
Checking swap space: must be greater than 512 MB.   Actual 8063 MB    Passed
Checking if this platform requires a 64-bit JVM.   Actual 64    Passed (64-bit not required)
Checking temp space: must be greater than 300 MB.   Actual 36105 MB    Passed
Preparing to launch the Oracle Universal Installer from /tmp/OraInstall2020-09-05_01-33-54PM
Log: /tmp/OraInstall2020-09-05_01-33-54PM/install2020-09-05_01-33-54PM.log

安裝圖解如下:

至此，完成了Jagent的安裝。

6.建立OGG Monitor Agent Instances

[oracle@rptdb ogg_agent]$ cd /u01/app/wls/oggmon/ogg_agent
[oracle@rptdb ogg_agent]$ ls -l
total 36
drwxr-x---. 2 oracle oinstall  211 Sep  5 13:38 cfg_templates
-rwxr-x---. 1 oracle oinstall  161 Oct  9  2016 createMonitorAgentInstance.bat
-rwxr-x---. 1 oracle oinstall  152 Oct  9  2016 createMonitorAgentInstance.sh
drwxr-x---. 2 oracle oinstall 4096 Sep  5 13:38 dirjar
drwxr-x---. 2 oracle oinstall   24 Sep  5 13:38 dirprm_templates
-rwxr-x---. 1 oracle oinstall  320 Oct  9  2016 displayMonitorAgentVersion.bat
-rwxr-x---. 1 oracle oinstall  388 Oct  9  2016 displayMonitorAgentVersion.sh
-rwxr-x---. 1 oracle oinstall  357 Oct  9  2016 pw_agent_util.bat
-rwxr-x---. 1 oracle oinstall 1197 Oct  9  2016 pw_agent_util.sh
-rwxr-x---. 1 oracle oinstall  164 Oct  9  2016 upgradeToMonitorAgent1221.bat
-rwxr-x---. 1 oracle oinstall  154 Oct  9  2016 upgradeToMonitorAgent1221.sh
[oracle@rptdb ogg_agent]$ ./createMonitorAgentInstance.sh
Please enter absolute path of Oracle GoldenGate home directory : /u01/app/OGG12_2
Please enter absolute path of OGG Agent instance : /u01/app/wls
OGG Agent instance directory already exists, do you want to overwrite the contents (yes | no) : yes
Please enter unique name to replace timestamp in startMonitorAgent script (startMonitorAgentInstance_20200905134655.sh) : agent
Successfully created OGG Agent instance.

7.建立 Oracle Wallet，使得EMCC Agent連線到OGG Monitor agent接收OGG例項相關的metric values

[oracle@rptdb bin]$ export JAVA_HOME=/home/oracle/jdk1.8.0_231
[oracle@rptdb bin]$ cd /u01/app/wls/bin
[oracle@rptdb bin]$ ls -l
total 12
-rwxr--r--. 1 oracle oinstall  392 Sep  5 13:47 displayMonitorAgentVersion.sh
-rwxr--r--. 1 oracle oinstall 1201 Sep  5 13:47 pw_agent_util.sh
-rwxr--r--. 1 oracle oinstall  316 Sep  5 13:47 startMonitorAgentInstance_agent.sh
[oracle@rptdb bin]$ ./pw_agent_util.sh -jagentonly
Please create a password for Java Agent: 
Please confirm password for Java Agent: 
Sep 05, 2020 2:06:01 PM oracle.security.jps.JpsStartup start
INFO: Jps initializing.
Sep 05, 2020 2:06:02 PM oracle.security.jps.JpsStartup start
INFO: Jps started.
Wallet is created successfully.

8.修改OGG Monitor Agent Instance配置檔案，修改相關引數並配置為OEM Plug-IN模式

[oracle@rptdb ogg_agent]$ cd /u01/app/wls/cfg
[oracle@rptdb cfg]$ ls -l
total 60
-rw-r--r--. 1 oracle oinstall  8537 Sep  5 13:47 Config.properties
-rw-r--r--. 1 oracle oinstall  3526 Sep  5 13:47 MPMetadataSchema.xsd
-rw-r--r--. 1 oracle oinstall  1483 Sep  5 13:47 jps-config-jse.xml
-rw-r--r--. 1 oracle oinstall  1284 Sep  5 13:47 logging-config.xml
-rw-r--r--. 1 oracle oinstall 13791 Sep  5 13:47 mpmetadata-em.xml
-rw-r--r--. 1 oracle oinstall  4623 Sep  5 13:47 mpmetadata-new.xml
-rw-r--r--. 1 oracle oinstall 12138 Sep  5 13:47 mpmetadata.xml
[oracle@rptdb cfg]$ vim Config.properties

需要修改下面部份:

####################################################################
## jagent.host: Host name of the machine where jAgent is running ###
## Note: This host name has to be reachable from Monitor Server  ###
####################################################################
jagent.host=rptdb
####################################################################
## jagent.username: jAgent username                              ###
## It can be any name. This jAgent username will be passed to    ###
## Monitor Server during jAgent registration.                    ###
####################################################################
jagent.username=oggagent
####################################################################
## jagent.rmi.port                                               ###
## RMI Port which EM Agent will use to connect to JAgent         ###
## RMI Port will only be used if agent.type.enabled=OEM          ###
####################################################################
jagent.rmi.port=5559
####################################################################
## agent.type.enabled : Choose either OEM or OGGMON              ###
## Choosing OGGMON will allow JAgent to register to              ### 
## Monitor Server and JMX RMI connector will not be enabled.     ### 
## Choosing OEM will enable JMX RMI connector which will be used ###
## by EM Agent to connect to JAgent and JAgent will not register ###
## to Monitor Server.                                            ###
####################################################################
agent.type.enabled=OEM
################## Start SSL Properties ############################
####################################################################
## jagent SSL Enabled property                                   ###
####################################################################
jagent.ssl=false

9.啟動Oracle GoldenGate和Oracle GoldenGate agent

9.1.登入ogg,編輯GLOBAL檔案:

[oracle@rptdb bin]$ cd /u01/app/OGG12_2/
[oracle@rptdb OGG12_2]$ ./ggsci
Oracle GoldenGate Command Interpreter for Oracle
Version 12.2.0.2.2 OGGCORE_12.2.0.2.0_PLATFORMS_170630.0419_FBO
Linux, x64, 64bit (optimized), Oracle 11g on Jun 30 2017 14:42:26
Operating system character set identified as US-ASCII.
Copyright (C) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
GGSCI (rptdb) 1> edit params GLOBALS
--新增:
ENABLEMONITORING

9.2.建立datastore

GGSCI (rptdb) 2> CREATE DATASTORE
2020-09-05T06:16:29Z  WARNING OGG-01932  Datastore already exists.
GGSCI (rptdb) 3> DELETE DATASTORE
Are you sure you want to delete the datastore? Y
2020-09-05T06:16:41Z  WARNING OGG-06310  The DELETE DATASTORE command requires that all Oracle GoldenGate processes are stopped, including Manager.
GGSCI (rptdb) 4> stop mgr
Manager process is required by other GGS processes.
Are you sure you want to stop it (y/n)?y
Sending STOP request to MANAGER ...
Request processed.
Manager stopped.
GGSCI (rptdb) 5> DELETE DATASTORE
Are you sure you want to delete the datastore? Y
2020-09-05T06:17:11Z  INFO    OGG-06492  Datastore deleted
GGSCI (rptdb) 6> CREATE DATASTORE
Profile 'Trace' added.
2020-09-05T06:17:17Z  INFO    OGG-06489  Datastore created
GGSCI (rptdb) 7> START MGR
Manager started.

9.3.重新執行ggsci登入，檢視Jagent狀態

[oracle@rptdb OGG12_2]$ ./ggsci
Oracle GoldenGate Command Interpreter for Oracle
Version 12.2.0.2.2 OGGCORE_12.2.0.2.0_PLATFORMS_170630.0419_FBO
Linux, x64, 64bit (optimized), Oracle 11g on Jun 30 2017 14:42:26
Operating system character set identified as US-ASCII.
Copyright (C) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
GGSCI (rptdb) 1> info all
Program     Status      Group       Lag at Chkpt  Time Since Chkpt
MANAGER     RUNNING                                           
JAGENT      STOPPED

9.4.編輯Jagent引數配置檔案，修改java路徑

GGSCI (rptdb) 3> edit params JAGENT
COMMAND java -Dconfig.dir=/u01/app/wls/cfg -Djava.util.logging.config.class=oracle.core.ojdl.logging.LoggingConfiguration -Doracle.core.ojdl.logging.config.file=/u01/app/wls/cfg/logging-config.xml -Doracle.core.ojdl.logging.componentId=JAGENT -jar -Xms512m -Xmx1024m /u01/app/wls/oggmon/ogg_agent/dirjar/jagent.jar

--把COMMAND後面的java替換成/home/oracle/jdk1.8.0_231/bin/java，否則會使用Centos 7預設的openjdk，啟動Jagent會報錯，儲存退出

COMMAND /home/oracle/jdk1.8.0_231/bin/java -Dconfig.dir=/u01/app/wls/cfg -Djava.util.logging.config.class=oracle.core.ojdl.logging.LoggingConfiguration -Doracle.core.ojdl.logging.config.file=/u01/app/wls/cfg/logging-config.xml -Doracle.core.ojdl.logging.componentId=JAGENT -jar -Xms512m -Xmx1024m /u01/app/wls/oggmon/ogg_agent/dirjar/jagent.jar

9.5.啟動Jagent

GGSCI (rptdb) 5> start Jagent
Sending START request to MANAGER ...
GGCMD JAGENT starting
GGSCI (rptdb) 6> info all
Program     Status      Group       Lag at Chkpt  Time Since Chkpt
MANAGER     RUNNING                                           
JAGENT      RUNNING

9.6.檢視Jagent狀態，確認無報錯

GGSCI (rptdb) 7> view report JAGENT
***********************************************************************
               Oracle GoldenGate Command Tool for Oracle
      Version 12.2.0.2.2 OGGCORE_12.2.0.2.0_PLATFORMS_170630.0419
         Linux, x64, 64bit (optimized) on Jun 30 2017 11:27:55
 
Copyright (C) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
                    Starting at 2020-09-05 14:25:05
***********************************************************************
Operating System Version:
Linux
Version #1 SMP Tue Aug 22 21:09:27 UTC 2017, Release 3.10.0-693.el7.x86_64
Node: rptdb
Machine: x86_64
                         soft limit   hard limit
Address Space Size   :    unlimited    unlimited
Heap Size            :    unlimited    unlimited
File Size            :    unlimited    unlimited
CPU Time             :    unlimited    unlimited
Process id: 21115
Parameters...
COMMAND /home/oracle/jdk1.8.0_231/bin/java -Dconfig.dir=/u01/app/wls/cfg -Djava.util.logging.config.class=oracle.core.ojdl.logging.LoggingConfiguration -Doracle.core.ojdl.logging.config.file=/u01/app/wls/cfg/lo
gging-config.xml -Doracle.core.ojdl.logging.componentId=JAGENT -jar -Xms512m -Xmx1024m /u01/app/wls/oggmon/ogg_agent/dirjar/jagent.jar
Program is '/home/oracle/jdk1.8.0_231/bin/java', arguments are '-Dconfig.dir=/u01/app/wls/cfg -Djava.util.logging.config.class=oracle.core.ojdl.logging.LoggingConfiguration -Doracle.core.ojdl.logging.config.fil
e=/u01/app/wls/cfg/logging-config.xml -Doracle.core.ojdl.logging.componentId=JAGENT -jar -Xms512m -Xmx1024m /u01/app/wls/oggmon/ogg_agent/dirjar/jagent.jar'
***********************************************************************
**                     Run Time Messages                             **
***********************************************************************
2020-09-05 14:25:05  INFO    OGG-00978  GGCMD JAGENT is running.
2020-09-05 14:25:05  INFO    OGG-01927  Child process started, process ID 21121, command line '/home/oracle/jdk1.8.0_231/bin/java -Dconfig.dir=/u01/app/wls/cfg -Djava.util.logging.config.class=oracle.core.ojdl.
logging.LoggingConfiguration -Doracle.core.ojdl.logging.config.file=/u01/app/wls/cfg/logging-config.xml -Doracle.core.ojdl.logging.componentId=JAGENT -jar -Xms512m -Xmx1024m /u01/app/wls/oggmon/ogg_agent/dirjar
/jagent.jar'.

10.登入EMCC 12C控制檯，新增此主機上的OGG例項到監控

10.1.配置discovery modules,勾選GoldenGateDiscovery,並配置相關引數

  注:這裡的賬號就是GoldenGate Monitor agent例項建立後配置檔案裡的agent使用者名稱稱，密碼為建立Oracle Wallet時設定的密碼。該使用者和密碼做為em agent連線到ogg monitor agent收集接受相關OGG例項狀態資訊的身份驗證。

10.2.開始搜尋該目標主機上的OGG例項

10.3.把搜尋到的結果進行提升操作,提升完成後，登入Target => GoldenGate標籤頁，可以檢視到已經成功新增此OGG例項的監控

  到這裡，Oracle GoldenGate Enterprise Manager Plug-In監控就已經部署完成了。部署的過程中遇到了許多坑，查了Google和Mos上面一些文章和案例，結合自己對EMCC的使用經驗，最終順利解決了遇到的問題。在這裡分享一下自己的部署過程，希望可以給大家提供一些參考。

來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/69982136/viewspace-2717357/，如需轉載，請註明出處，否則將追究法律責任。