Oracle GoldenGate Director 11gR2 (Server, Administrator, Client

and Web) 11.2.1 installation and deployment

In the article you will look at the steps for deploying Oracle Goldengate

(OGG) Director on OEL 5.X using Oracle RDBMS as a repository. OGG Director

consists of the following components:

OGG Director Server

OGG Director Admin

OGG Director Client

OGG Director Web

All of the above components will be installed and configured for you to

monitor and manage the OGG environment.

The following software will be used.

OGG Director 11gR2 11.2.1.0 Server - download from here. OGG Director

Client comes with the OGG Director Server and can be downloaded from

the OGG Server or installed separately.

Oracle WebLogic Server (OWLS) 12c 12.1.1 – download from here

JDK 1.6.0_20 or later – download from here

After downloading the software execute the following steps

1. Install JDK

2. Install Oracle Weblogic Server 12c

3. Install OGG Director Server 11gR2 11.2.1

4. Start OGG Director Server

5. Download OGG Director Client

6. Install OGG Director Client

7. Start OGG Director Admin and configure users and Data Source

8. Start OGG Director Client

9. Start OGG Director WEB

For all the GUI tools to launch successfully as root user execute xhost +.

1. Install JDK

The JDK includes the JRE. Download the JDK.

sh ./jdk-6u37-linux-x64.bin

Take a note that 6u37 is the latest JDK 1.6 as of the time I wrote the

article. The installation creates the following directory structure.

[oracle@raclinux1 bin]$ pwd

/u02/ogg_director/jdk1.6.0_37/bin

[oracle@raclinux1 bin]$

2. Install Oracle Web Logic Server 12c

Launch the OWLS installer by executing the downloaded bin file

sh ./oepe-indigo-installer-12.1.1.0.1.201203120349-12.1.1-linux32.bin

Follow the screens as indicated. Press Next.

Enter the OWLS installation location. Press Next.

Press Next.

Select an Install type and press Next.

Select product installation directories. I left the default. Press

Next.

Review the installation summary and press Next.

Wait for the installation to complete. Press Done button after

selecting Run Quickstart checkbox.

Wait for Quickstart to pop up and press Getting Started with WebLogic

Server 12.1.1.

Select create new domain option.

Select first option.

Enter a domain name and domain location.

Enter credentials.

Enter the location of the JDK installed. You can also use the default

that comes with OWLS.

Select Administration Server checkbox.

Specify ports. I use non-default ports.

Review the summary and press Create button.

Wait for the installation to complete.

Verify the OWLS installation by loging into the server.

And finally…

This concludes the OWLS 12c 12.1.1 installation

3. Install OGG Director Server 11.2.1

Unzip the downloaded OGG Director Server 11.2.1

[oracle@raclinux1 ogg_director]$ unzip -o ogg_director_srv.zip

Archive: ogg_director_srv.zip

inflating: gg-director-serversetup_unix_v11_2_1_0_0_000.sh

inflating: OGG_Dir_Rel_Notes_11.2.1.0.0.doc

inflating: OGG_Dir_Rel_Notes_11.2.1.0.0.pdf

inflating: README.txt

[oracle@raclinux1 ogg_director]$ pwd

/u02/ogg_director

[oracle@raclinux1 ogg_director]$

Start the OGG Director Server installation by executing

./gg-director-serversetup_unix_v11_2_1_0_0_000.sh

Once the GUI pops up press Next.

Select OGG Director Server installation location directory. In my case

it is /u02/ogg_director/oggd.

Select OWLS location. In my case it is /u02/wls/oracle/Oracle/Middleware

Press Next after reviewing the OWLS location and installation details.

Specify http port. I use 7004.

Select the option for an Oracle database.

Specify the details for JDBC connection to the Oracle database.

Specify the credentials for the user schema of the OGG Director

repository. Make sure that a user is created in the database to host

the repository. Press Next.

Review and press Next.

The installation begins and wait until completes. If you see an error

like Unable to run run-cdc-tool script file cat the content of the log

Canonicaly: /u02/ogg_director

Testing connection with: jdbc:oracle:thin:@rac-scan:1521:RACD

Execption while processing db setup. Cannot continue. Exception follows...

java.sql.SQLRecoverableException: ORA-01034: ORACLE not available

ORA-27101: shared memory realm does not exist

Linux-x86_64 Error: 2: No such file or directory

at oracle.jdbc.driver.T4CTTIoer.processError(T4CTTIoer.java:445)

at oracle.jdbc.driver.T4CTTIoer.processError(T4CTTIoer.java:389)

at oracle.jdbc.driver.T4CTTIoer.processError(T4CTTIoer.java:382)

at

oracle.jdbc.driver.T4CTTIoauthenticate.processError(T4CTTIoauthenticate.java:441)

at oracle.jdbc.driver.T4CTTIfun.receive(T4CTTIfun.java:450)

at oracle.jdbc.driver.T4CTTIfun.doRPC(T4CTTIfun.java:192)

at

oracle.jdbc.driver.T4CTTIoauthenticate.doOSESSKEY(T4CTTIoauthenticate.java:404)

at oracle.jdbc.driver.T4CConnection.logon(T4CConnection.java:385)

at oracle.jdbc.driver.PhysicalConnection.<init>(PhysicalConnection.java:546)

at oracle.jdbc.driver.T4CConnection.<init>(T4CConnection.java:236)

at

oracle.jdbc.driver.T4CDriverExtension.getConnection(T4CDriverExtension.java:32)

at oracle.jdbc.driver.OracleDriver.connect(OracleDriver.java:521)

at

com.goldengate.gdsc.util.ConfigDirectorServer.startDBSetup(ConfigDirectorServer.java:670)

at

com.goldengate.gdsc.util.ConfigDirectorServer.main(ConfigDirectorServer.java:922)

[oracle@raclinux1 GGDirectorgg-director]

Fix the JDBC details and retry.

At the end of the installation click Finish.

This concludes the OGG Director Server installation.

4. Start OGG Director Server

Execute the following command in order to stats the server.

[oracle@raclinux1 bin]$ pwd

/u02/ogg_director/oggd/domain/bin

[oracle@raclinux1 bin]$ ls

directorControl.sh setDomainEnv.sh stopManagedWebLogic.sh

nodemanager startManagedWebLogic.sh stopWebLogic.sh

server_migration startPointBaseConsole.sh

service_migration startWebLogic.sh

[oracle@raclinux1 bin]$

[oracle@raclinux1 bin]$ ./directorControl.sh

------------------------------------------------------------------

USAGE:

./directorControl.sh start : to start in foreground

./directorControl.sh stop : to stop

./directorControl.sh -b start : to start in background.

./directorControl.sh -b start <out_file> : to start in background, redirect to

a file.

------------------------------------------------------------------

[oracle@raclinux1 bin]$

[oracle@raclinux1 bin]$ ./directorControl.sh -b start /tmp/oggdirser.out &

5. Download OGG Director Client

Download the OGG Director Client for Unix, I am on OEL 5.X,

6. Install OGG Director Client

Execute the downloaded in Step 5 shell script.

[oracle@raclinux1 u02]$ ./gg-director-clientsetup_unix_v11_2_1_0_0_000.sh

Starting Installer ...

Nov 14, 2012 4:23:39 PM java.util.prefs.FileSystemPreferences$3 run

WARNING: Could not create system preferences directory. System preferences are

unusable.

Once the GUI pops up press Next.

Select directory for the OGG Director Client.

Specify a directory for Symbolic links.

Review the summary.

Wait for the installation to complete and exit the installer by

pressing Finish.

After successful installation there will be two scripts:

run-admin.sh : for starting OGG Director Administrator

run-director.sh : for starting OGG Director Client

Your configuration will look similr to

[oracle@raclinux1 bin]$ pwd

/u02/ogg_director/GoldenGateDirector/bin

[oracle@raclinux1 bin]$ ls

run-admin.sh run-director.sh

[oracle@raclinux1 bin]$

7. Start OGG Director Admin and configure users and Data

Source

Execute the following command

./run-admin.sh

Login as admin/admin

Create OGG Director account (Optional)

Create a data source in order to monitor an existing OGG environment.

Setup Agent Settings. Start an Agent.

8. Start OGG Director Client

Start the OGG Director Client by executing the following shell script.

[oracle@raclinux1 bin]$ ./run-director.sh

Wait for the OGG Director Client to launch.

Login

Assuming a started OGG instance

GGSCI (raclinux1.gj.com) 2> info mgr

Manager is running (IP port raclinux1.gj.com.7809).

GGSCI (raclinux1.gj.com) 3>

GGSCI (raclinux1.gj.com) 4> info all

Program Status Group Lag at Chkpt Time Since Chkpt

MANAGER RUNNING

EXTRACT RUNNING EXTBI1 00:00:00 44:29:22

EXTRACT RUNNING EXTBI2 00:00:00 44:29:27

EXTRACT RUNNING EXTCDC 00:00:00 231:38:54

EXTRACT ABENDED EXTDOWN 00:00:00 44:29:23

EXTRACT RUNNING EXTINT 00:00:00 44:29:32

EXTRACT RUNNING EXTINTBI 00:00:00 44:29:28

EXTRACT RUNNING EXTREV 00:00:00 00:00:07

EXTRACT RUNNING EXTSALE 00:00:00 231:38:53

EXTRACT RUNNING EXTSHHR 00:00:00 231:24:01

EXTRACT RUNNING EXTT1 00:00:00 231:38:58

EXTRACT RUNNING PREV 00:00:00 44:14:19

EXTRACT RUNNING PSHHR 00:00:00 44:14:17

EXTRACT RUNNING PUMPSALE 00:00:00 44:14:19

REPLICAT RUNNING REPBI1 00:00:00 00:00:04

REPLICAT RUNNING REPBI2 00:00:00 00:00:05

REPLICAT RUNNING REPCDC1 00:00:00 00:00:02

REPLICAT RUNNING REPCDC2 00:00:00 00:00:03

REPLICAT RUNNING REPCDC3 00:00:00 00:00:05

REPLICAT RUNNING REPCUST 00:00:00 00:00:04

REPLICAT RUNNING REPDOWN 00:00:00 00:00:05

REPLICAT RUNNING REPINT 00:00:00 00:00:05

REPLICAT RUNNING REPINTBI 00:00:00 00:00:03

REPLICAT ABENDED REPREV 00:00:00 00:02:54

REPLICAT RUNNING REPSALE 00:00:00 00:00:05

REPLICAT RUNNING REPSHHR 00:00:00 00:00:05

REPLICAT RUNNING REPT1 00:00:00 00:00:01

GGSCI (raclinux1.gj.com) 5>

After adding the RACD, or whatever data source you have, you will have

something like this.

9. Start OGG Director WEB

Login to the OGG Director WEB

You will see the same setup

Summary:

In the article you had a look at the steps to install and configure the

different OGG Director components for managing and monitoring OGG

environment.

Reference

1. Oracle® GoldenGate Director Administrator's Guide 11g Release 2

(11.2.1)