Notes on installing the Oracle GoldenGate Monitor

Download the software from OTN - Oracle_GoldenGate_Monitor_Linux_x64_11.1.1.1.0.zip

Copy on the server which is going to function as the Monitor Server and extract - should see an executable file :

Oracle_GoldenGate_Monitor_unix_x64_11_1_1_1_0.sh

Ensure JDK version is minimum 1.6 and above.

Downloaded and installed Java 1.6 Update 32

Created soft link in /usr/bin to ensure newer java version is picked up

[oracle@pdemora061rhv bin]$ ls -l java

lrwxrwxrwx 1 root root 33 May 29 05:19 java -> /home/oracle/jdk1.6.0_32/bin/java

Create environment variable JAVA_HOME and point it to new java

export JAVA_HOME=/home/oracle/jdk1.6.0_32

Ensure LD_LIBRARY_PATH is updated to point to this java location

[oracle@pdemora062rhv server]$ export LD_LIBRARY_PATH=$JAVA_HOME/jre/lib/amd64/server:$LD_LIBRARY_PATH

Needs to connect to a running database. Provide a username with select any table and create table privileges.

In this case the following database objects were created

OBJECT_TYPE OBJECT_NAME
------------------- --------------------------------------------------
INDEX CONNECTIONS_UNQ_CONNECTIONS_0
INDEX GGS_OBJECTS_UNQ_GGS_OBJECTS_0
INDEX GGS_OBJECTS_UNQ_GGS_OBJECTS_1
INDEX I18N_ENTRIESUNQ_I18N_ENTRIES_0
INDEX IX_ALERTS_UNQ_ALERTS_0
INDEX IX_MMS_INFO_UNQ_MMS_INFO_0
INDEX SYS_C0012285
INDEX SYS_C0012289
INDEX SYS_C0012292
INDEX SYS_C0012294
INDEX SYS_C0012295
INDEX SYS_C0012298
INDEX SYS_C0012303
INDEX SYS_C0012305
INDEX SYS_C0012308
INDEX SYS_C0012309
INDEX SYS_C0012311
INDEX SYS_C0012312
INDEX SYS_C0012319
INDEX SYS_C0012322
INDEX SYS_C0012324
INDEX SYS_C0012328
INDEX SYS_C0012330
INDEX SYS_C0012331
INDEX SYS_C0012334
INDEX SYS_C0012338
INDEX SYS_C0012339
INDEX SYS_C0012341
INDEX SYS_C0012343
INDEX SYS_C0012345
INDEX SYS_C0012347
INDEX SYS_C0012349
INDEX SYS_C0012351
INDEX SYS_C0012353
INDEX SYS_C0012356
INDEX SYS_C0012358
INDEX SYS_C0012396
LOB SYS_LOB0000077251C00007$$
LOB SYS_LOB0000077251C00008$$
LOB SYS_LOB0000077286C00003$$
LOB SYS_LOB0000077290C00003$$
LOB SYS_LOB0000077294C00004$$
LOB SYS_LOB0000077298C00003$$
TABLE ALERTS
TABLE ALERT_NOTICES
TABLE ALERT_SUBSCRIPTIONS
TABLE ALERT_TEMPLATES
TABLE CONNECTIONS
TABLE GGS_OBJECTS
TABLE GGS_PERMISSIONS
TABLE GGS_ROLES
TABLE GGS_USERS
TABLE I18N_ENTRIES
TABLE JMX_INFO
TABLE LINKS
TABLE MCS
TABLE MCS_ARGUMENT
TABLE MMS_INFO
TABLE MONITOR_INFO
TABLE MPS
TABLE MPS_COMPOSITE_VALUES
TABLE MPS_HISTORY
TABLE MPS_HISTORY_COMPOSITE_VALUES
TABLE MPS_UNIT
TABLE ROLE_PERMS
TABLE SEQUENCE
TABLE USER_PROFILES
TABLE USER_ROLES
TABLE VIEW_CHILDREN

69 rows selected.
Launch installer from X Windows session

./Oracle_GoldenGate_Monitor_unix_x64_11_1_1_1_0.sh
We have to enter the hostname, port and SID of the database which is going to serve as a repository
We are entering the existing schema name who is going to own all the objects related to GoldenGate Monitor
Enter the username and password of the Monitor Admin user account. Note this is not a database user account, but is used to login
to the GoldenGate Monitor web interface.
We received errors when trying to start the Tomcat service when we used a lower case username like jmxuser.

Make sure the JMX username is jmxUser

If you want email alerts as well then provide the SMTP server details.
POST INSTALLATION STEPS - to be done on ALL instances of GoldenGate which are required to be monitored

Via GGSCI edit the GLOBALS file

Add the following line if Oracle GoldenGate release is below 11.2.1

EDIT PARAMS ./GLOBALS

ENABLEMONITORAGENT

Add the following line if Oracle GoldenGate release is above 11.2.1

EDIT PARAMS ./GLOBALS

ENABLEMONITORING

Edit the /cfg/Config.properties file located in the GoldenGate software directory

agent.type.enabled=OGGMON

Ensure that the jagent.host property points to the fully qualified host name of the server of the Oracle GoldenGate instance.

Ensure that the property monitor.host points to the fully qualified host name of the server on which Oracle GoldenGate Monitor is
installed.
The monitor.host in Config.properties value MUST MATCH with the value of monitor.jmx.server.host which is found in the
monitor.properties file located in the /cfg directory where we have installed the GoldenGate Monitor software.

Change the monitor.jmx.username property to the user specified on the JMX Configuration screen during the Oracle GoldenGate
Monitor installation.

Create the Wallet

Go to the GoldenGate software location (not GoldenGate Monitor software)

[oracle@pdemora062rhv goldengate]$ ./pw_agent_util.sh -create

Please create a password for Java Agent:

Please confirm password for Java Agent:
Please enter Monitor Server JMX password:
Please confirm Monitor Server JMX password:

Wallet is created successfully.

Start GoldenGate

If GoldenGate version is 11.2.1 and higher then agent is Standalone Agent.

If GoldenGate version is below 11.2.1, then agent is Embedded Agent.

For Embedded Agent.

Stop and Start the Manager from ggsci via STOP MANAGER and START MANAGER comand

For Standalone Agent via GGSCI

Run .

CREATE DATASTORE

STOP MANAGER

START MANAGER

START JAGENT

Starting and Stopping the GoldenGate Monitor Server

Run the monitor.sh script with the start and stop command. The script is located in the /bin directory under the GoldenGate Monitor
installation root directory.

/home/oracle/goldengate_monitor/bin

[oracle@pdemora062rhv bin]$ ./monitor.sh start

Using CATALINA_BASE: /u01/app/goldengate/monitor/tomcat

Using CATALINA_HOME: /u01/app/goldengate/monitor/tomcat

Using CATALINA_TMPDIR: /u01/app/goldengate/monitor/tomcat/temp

Using JRE_HOME: /u01/app/goldengate/monitor/jre

Log files are catalina.<timestamp>.log and catalina.out located under the tomcat subdirectory