Hands-on Lab : Oracle GoldenGate Director

Highlights of the Hands-on Lab exercises 1. 2. 3. 4. 5. 6. Install Oracle GoldenGate Director Server Start Oracle GoldenGate Director Server Install Oracle GoldenGate Director Client Register Oracle GoldenGate Manager processes in GoldenGate Director Retrofit current Oracle GoldenGate replication models Create a new Replication Model

Pre-requisites : Install Oracle WebLogic Server 10.3.1 or above Create a database schema with DBA and SELECT ANY DICTIONARY (if 11g DB) roles if to host the GoldenGate Director repository At least 2 instances of GoldenGate Manager available (1 for Extract, 1 for Replicat)

1. Install Oracle GoldenGate Director Server Instructions: Execute the Oracle GG Director Server installation file o ggdirector-serversetup_v2.0.0.2_001.exe Click on Next when the following screen pop-ups

Select your WLS 10.3.1 Installation directory, then next.

Then provide the location and the name of the pre-created WebLogic Domain with GoldenGate director, and click on Next. DO NOT CREATE A WEBLOGIC DOMAIN IN ADVANCE.

Change the default port if needed, and click on Next

Select Oracle Database for the GoldenGate repository, then click on Next

Specify your database location and click on Next

Specify the DB schema username and password, then click on Next

Review the installation setting then click on Next to start the installation.

2. Start Oracle GoldenGate Server Once the installation is completed, simply start the GoldenGate Director Server from Start > Programs > Oracle GoldenGate Director Server > Start Oracle GoldenGate Director

3. Install Oracle GoldenGate Client Execute the Oracle GG Director Client installation file o ggdirector-clientsetup_v2.0.0.2_001.exe Click on Next when the following screen pop-ups

Specify the installation location, then click on Next

Then use the default setting for the next screens, and click on Next until the installation is finished.

4. Register Oracle GoldenGate Manager processes in GoldenGate Director Now that all the components are installed, we can start configuring Oracle GoldenGate Director. The first step is to register all the GoldenGate Manager process available in the network. Start the Oracle GDSC Admin-Tool from the following location :

Login in as admin/admin, and specify the GoldenGate Server location (for ex : localhost:7001)

When logged in, go to Data Sources Tab

Follow the steps below to register a GoldenGate Manager process (it must be already running) from your environment. o Fill up the following information : Fully Qualified Domain Name : localhost Manager Port : 9090 Data Source Name : EE-source (a logical name to identify the process ) Click Check Connection to validate the setting, then Close

GoldenGate Version : 10.4 Click on Save NOW, then click on Yes if the following pop-ups

Then select from the left-panel the data-source we just created to complete the registration, and fill-up the following information : Username : ggsource (the db account used in the manager) Password & Confirm Password : ggsource Owner : Admin Check Host is Observable option GoldenGate Version : 10.4 (do it again) Click on Save Registration completed. Re-do the same instruction to register the other Manager processes in your environment. At this stage your should have at least the following :

o o

Now you can Exit the Oracle GDSC Admin Tool.

5. Retrofit current Oracle GoldenGate replication models Start Oracle GoldenGate Director from the following location :

Once the Oracle GoldenGate is started, click on File > Login to login into GoldenGate Server

Login in as admin/admin, and specify the GoldenGate Server location (for ex : localhost:7001)

Once logged in, create a new Diagram where you can visualize all the existing replication models or create new ones. To create a Diagram, click on File > New Diagram and name it.

Now we can Drag & Drop the Data Source that GoldenGate Manager are managing. In GoldenGate director, select the Data Sources tab in the bottom-left panel, then Drag & Drop both sources we created in the previous section :

By default, all the existing Extract, Trail and Replicat are not shown in the diagram. Just select File > Actions > Show Hidden Items to enable them. Once enabled, you will see the following:

After some arrangement, you should see a diagram similar to the following one:

6. Create a new Replication Model In the previous section we managed to retrofit existing model created via GGSCI. Now lets create a new replication model directly from Oracle GoldenGate Director. Create the following table in both source and target database o Create table gg_director_test (id number, value varchar2(20)); Right click on the source data-source and select New Capture

Provide the Capture Name (the name used to identify the Extract process), and make sure the Database Access has the correct DB credential, then click on OK:

Now from the newly create Extract icon in the Diagram, right-click and select New Trail:

Configure the Trail as follow: o Choose host : Select the target data-source o With prefix : DD o Keep the rest as default, then click OK

Now from the diagram, click on the Map for EORADIR icon, then click on Show Tables button in the bottom right of GoldenGate Director:

Check the box next to GGDEMO.GG_DIRECTOR_TEST table, then click on Save

Now right-click on the Trail icon and select New Delivery

Configure the Replicat process as follow, then click on OK: o Delivery Name : RORADIR o Check Extract Trail and set : DD o Check Checkpoint Table and set : ggdemo.ggschkpt o Validate the Database credential to access the database

Finally, click on the Map for RORADIR icon, then go to the button and check the box related to the ggdemo.gg_director_test Map:

Congratulation ! The replication of the table GG_DIRECTOR_TEST is now configured. Now lets start the processes from the Director Diagram. Right-Click on the EORADIR icon, and select Start:

Do the same with RORADIR icon to start the Replicat process:

At this stage a pop-up window shows the different startup option. Do not select anything, just click on Start:

Now your replication should be fully functional, and its represented by the green link as shown below:

Test the replication via SQL*Plus to validate the setting.

End of Oracle GoldenGate Director Hands-on Lab.