Oracle GoldenGate 11g Lab

Oracle GoldenGate 11g: Fundamentals for Oracle

Practices for Lesson 1: Introduction


Practices for Lesson 1 Overview There are no practices for this lesson.


Practices for Lesson 2: Technology Overview




Practices for Lesson 3: Oracle GoldenGate Architecture




Practices for Lesson 4: Installing Oracle GoldenGate


Practices for Lesson 4: Overview Practices Overview In these practices, you become familiar with the lab environment that you will be using for the duration of the class. You also install the Oracle GoldenGate software to be used with both the AMER and EURO databases. Then you are briefly introduced to the command-line interface (GGSCI).


Practice 4-1: Preparation Overview There are two databases configured on your machine: AMER and EURO. These are physically different databases, each with its own structure and set of users. In the practices for this course, you sometimes need to connect to one of your databases using SQL*Plus. The following steps describe how to connect to each of your databases and also provide more details about the users and tables that you will be working with. Each database has administrative users, such as system, as well as other users created specifically for this course. The data tables that you create and populate in the AMER database that you use in this course are owned by the WEST user. Conversely, the data tables in the EURO database are owned by the EAST user. Even though there is only one PC for each practice team, there are two host names defined in /etc/hosts: easthost and westhost. You should be able to ping both hosts, and you should use those names in place of localhost so that you can clearly indicate source and target hosts. To connect to the AMER database as the system user using SQL*Plus, enter the following command at the operating system prompt: [OS_prompt ~] sqlplus system@amer The password for all database accounts for this course is oracle_4U.

Operating System Type

Linux

oracle

oracle

AMER Database (Source)

West

oracle_4U

Amer

/u01/app/oracle/gg_amer

Manager

15000

EURO Database (Target)


East

oracle_4U

Euro

/u01/app/oracle/gg_euro

Manager

15001

GoldenGate

/home/oracle

GoldenGate

/u01/app/oracle/gg_amer

GoldenGate

/u01/app/oracle/gg_euro

1. To set up your working environment, create terminal windows to make it easier to navigate between the source and target databases: a. Log in to your designated Linux machine with the following information: 1) Username: oracle 2)

Password: oracle

You can view the online version at http://docs.oracle.com/cd/E28323_01/index.htm . 2. As the user oracle, create two directories to hold the Oracle GoldenGate software. [OS_prompt] cd /u01/app/oracle [OS_prompt] mkdir gg_amer [OS_prompt] mkdir gg_euro


3. Navigate to the $GG_AMER_HOME directory (where the Oracle GoldenGate software will be installed). Verify that you are in the proper directory. [OS_prompt ~] cd $GG_AMER_HOME [OS_prompt gg_amer] pwd /u01/app/oracle/gg_amr 4. Set the Oracle database environment variables for amer. Note the leading period before the oraenv command. In the GG_AMER_HOME window, enter the following commands:

[OS_prompt gg_amer] pwd /u01/app/oracle/gg_amer [OS_prompt gg_amer]. oraenv ORACLE_SID = [amer] ? amer The Oracle base remains unchanged with value /u01/app/oracle Note: Since the current value is already amer, you could accept it without change by just pressing Enter. 5. Set the Oracle database environment variables for euro. Note the leading period before the oraenv command. In the GG_EURO_HOME window, enter the following commands:

[OS_prompt gg_euro] pwd /u01/app/oracle/gg_euro [OS_prompt gg_euro] . oraenv ORACLE_SID = [amer] ? euro The Oracle base remains unchanged with value /u01/app/oracle Note: The first time you must change the value to euro. But if you ever run the command again in the same window/tab, you can accept euro without change by just pressing Enter.

This completes Practice 4-1. You now continue with Practice 4-2.


Practice 4-2: Installing Oracle GoldenGate Overview In this practice, you install two Oracle GoldenGate instances: one to be used with the AMER database and the other to be used with the EURO database. Note: Some parts of the screenshot feedback may be in a smaller font for clarity. However, the commands that you should type are always indicated by full-sized, bold monospace font.

Tasks 1.

In the GG_AMER_HOME terminal window, unzip the .zip file by executing the following command: [OS_prompt] cd $GG_AMER_HOME [OS_prompt gg_amer] ls /home/oracle/ogg* [OS_prompt gg_amer] unzip /home/oracle/ogg* Archive:

inflating: fbo_ggs_Linux_x64_ora11g_64bit.tar inflating: OGG_WinUnix_Rel_Notes_11.2.1.0.0.pdf inflating: Oracle GoldenGate 11.2.1.0 README.txt [OS_prompt gg_amer] 2.

Extract the .tar file to the same (gg_amer) directory: [OS_prompt gg_amer] tar -xvof *.tar UserExitExamples/ UserExitExamples/ExitDemo_more_recs/ UserExitExamples/ExitDemo_more_recs/Makefile_more_recs.HPUX UserExitExamples/ExitDemo_more_recs/Makefile_more_recs.SOLARIS UserExitExamples/ExitDemo_more_recs/Makefile_more_recs.LINUX

... many lines omitted for clarity ... ucharset.h ulg.sql usrdecs.h zlib.txt

[OS_prompt gg_amer]


3. Create the required subdirectories in the installation directory: [OS_prompt gg_amer] ./ggsci Oracle GoldenGate Command Interpreter for Oracle Version 11.2.1.0.0 OGGCORE_11.2.1.0.0_PLATFORMS_120131.1910_FBO Linux, x64, 64bit (optimized), Oracle 11g on Feb 1 2012 00:55:59 Copyright (C) 1995, 2012, Oracle and/or its affiliates. All rights reserved.

GGSCI (AMER) 1> Create Subdirs Creating subdirectories under current directory /u01/app/oracle/gg_amer Parameter files Report files Checkpoint files Process status files SQL script files Database definitions files Extract data files Temporary files Stdout files

/u01/app/oracle/gg_amer/dirprm: already exists

/u01/app/oracle/gg_amer/dirrpt: /u01/app/oracle/gg_amer/dirchk: /u01/app/oracle/gg_amer/dirpcs: /u01/app/oracle/gg_amer/dirsql: /u01/app/oracle/gg_amer/dirdef: /u01/app/oracle/gg_amer/dirdat: /u01/app/oracle/gg_amer/dirtmp: /u01/app/oracle/gg_amer/dirout:

created created created created created created created created

GGSCI (AMER) 2> Exit 4.

The GGSCI CREATE SUBDIRS command creates some or all of the following Oracle GoldenGate subdirectories: Directory dirchk dirdat dirdef

Contents Oracle GoldenGate checkpoint files Oracle GoldenGate trail and extract files Source data definitions produced by defgen and used to translate heterogeneous data dirpcs Process status files Directory that is no longer used dirout dirprm Oracle GoldenGate parameter (runtime configuration) files dirrpt Process report files SQL scripts dirsql Temporary storage for transactions that exceed memory dirtmp An Oracle GoldenGate Veridata directory. This directory is not used dirver unless this software is installed in the Oracle GoldenGate location. 5. Verify that the GoldenGate directories were created: [OS_prompt gg_amer] ls -d dir* dirchk dirdat dirdef dirjar dirout dirpcs dirprm dirrpt dirsql dirtmp [OS_prompt gg_amer] Leave this window open and proceed to the next window.


6.

Repeat steps 1–5 for the other directory to install the Oracle GoldenGate software in the GG_EURO_HOME directory. In the GG_EURO_HOME terminal window, unzip the .zip file by executing the following command: [OS_prompt] cd $GG_EURO_HOME [OS_prompt gg_euro] unzip /home/oracle/ogg* Archive:

inflating: fbo_ggs_Linux_x64_ora11g_64bit.tar inflating: OGG_WinUnix_Rel_Notes_11.2.1.0.0.pdf inflating: Oracle GoldenGate 11.2.1.0 README.txt [OS_prompt gg_euro] 7.

Extract the .tar file into the same (gg_euro) directory: [OS_prompt gg_euro] tar -xvof *.tar UserExitExamples/ UserExitExamples/ExitDemo_more_recs/ UserExitExamples/ExitDemo_more_recs/Makefile_more_recs.HPUX UserExitExamples/ExitDemo_more_recs/Makefile_more_recs.SOLARIS UserExitExamples/ExitDemo_more_recs/Makefile_more_recs.LINUX

... many lines omitted for clarity ... ucharset.h ulg.sql usrdecs.h zlib.txt

[OS_prompt gg_euro] 8. Create the required subdirectories in the installation directory: [OS_prompt gg_euro] ./ggsci Oracle GoldenGate Command Interpreter for Oracle Version 11.2.1.0.0 OGGCORE_11.2.1.0.0_PLATFORMS_120131.1910_FBO Linux, x64, 64bit (optimized), Oracle 11g on Feb 1 2012 00:55:59 Copyright (C) 1995, 2012, Oracle and/or its affiliates. All rights reserved.

GGSCI (EURO) 1> Create Subdirs Creating subdirectories under current directory /u01/app/oracle/gg_euro Parameter files Report files Checkpoint files Process status files SQL script files Database definitions files Extract data files Temporary files Stdout files

GGSCI (EURO) 2> Exit Practices for Lesson 4: Installing Oracle GoldenGate

/u01/app/oracle/gg_euro/dirprm: already exists

/u01/app/oracle/gg_euro/dirrpt: /u01/app/oracle/gg_euro/dirchk: /u01/app/oracle/gg_euro/dirpcs: /u01/app/oracle/gg_euro/dirsql: /u01/app/oracle/gg_euro/dirdef: /u01/app/oracle/gg_euro/dirdat: /u01/app/oracle/gg_euro/dirtmp: /u01/app/oracle/gg_euro/dirout:

created created created created created created created created

Note: If you enter which ggsci at an OS prompt, you see that the search path happens to pick up the binary in amer first, even though you wanted the one in euro. If you had omitted ./ before the ggsci command, it would have appeared to work, but it would have created the directories under the wrong parent folder! 9.

The GGSCI CREATE SUBDIRS command creates the following Oracle GoldenGate subdirectories: Directory Dirchk dirdat dirdef

Contents Oracle GoldenGate checkpoint files Oracle GoldenGate trail and extract files Source data definitions produced by defgen and used to translate heterogeneous data Process status files dirpcs dirout Directory that is no longer used dirprm Oracle GoldenGate parameter (runtime configuration) files dirrpt Process report files SQL scripts dirsql Temporary storage for transactions that exceed memory dirtmp dirver An Oracle GoldenGate Veridata directory. This directory is not used unless this software is installed in the Oracle GoldenGate location. 10. Verify that the Oracle GoldenGate directories were created: [OS_prompt gg_euro] ls -d dir* dirchk dirdat dirdef dirjar dirout dirpcs dirprm dirrpt dirsql dirtmp [OS_prompt gg_euro] Leave both windows open. This completes Practice 4-2. You now continue with Practice 4-3.


Practice 4-3: Introduction to the GGSCI Command Interface Overview In this practice, you learn how to invoke the Oracle GoldenGate command interface ( GGSCI) and how to access online help for all commands. This can be done using either the AMER database or the EURO database.

Assumptions The interchangeability of the databases assumes that they are not currently running any GGSCI commands.

Tasks 1.

How you invoke GGSCI depends on the settings in your profile. From the /home/oracle directory, review the .bash_profile file. Make certain that the ORACLE_HOME, GG_AMER_HOME, and GG_EURO_HOME system environment variables are set to the correct directories. The Oracle GoldenGate processes refer to them when connecting to the database. If the appropriate settings have been included, you can invoke GGSCI directly from the command line. [OS_prompt gg_amer] cd ~ [OS_prompt ~] more .bash_profile # .bashrc # User specific aliases and functions # alias ll='ls -l' # Source global definitions if [ -f /etc/bashrc ]; then . /etc/bashrc fi ORACLE_BASE=/u01/app/oracle ORACLE_HOME=/u01/app/oracle/product/11.2.0/dbhome_1 GG_AMER_HOME=/u01/app/oracle/gg_amer GG_EURO_HOME=/u01/app/oracle/gg_euro LD_LIBRARY_PATH=$JAVA_HOME/jre/lib/amd64/server/:$ORACLE_HOME/lib ORACLE_SID=amer PATH=$ORACLE_HOME/bin:$PATH:$LD_LIBRARY_PATH export ORACLE_BASE ORACLE_HOME GG_AMER_HOME GG_EURO_HOME LD_LIBRARY_PATH ORACLE_SID PATH

[OS_prompt ~]


Note: Some of the Management Pack variables for Director and Monitor are set as well. They are not used in this course. 2. Launch the GGSCI command interface. Be aware of the leading dot for oraenv: [OS_prompt ~] cd $GG_AMER_HOME [OS_prompt gg_amer] . oraenv ORACLE_SID = [amer] ? The Oracle base remains unchanged with value /u01/app/oracle

[OS_prompt gg_amer] ./ggsci Oracle GoldenGate Command Interpreter for Oracle Version 11.2.1.0.0 OGGCORE_11.2.1.0.0_PLATFORMS_120131.1910_FBO Linux, x64, 64bit (optimized), Oracle 11g on Feb 1 2012 00:55:59 Copyright (C) 1995, 2012, Oracle and/or its affiliates. All rights reserved.

GGSCI (AMER) 1>


3. View a HELP summary for all commands: GGSCI (AMER) 1> Help GGSCI Command Summary: Object: SUBDIRS ER EXTRACT

EXTTRAIL GGSEVT MANAGER MARKER PARAMS REPLICAT REPORT RMTTRAIL TRACETABLE TRANDATA SCHEMATRANDATA CHECKPOINTTABLE

Command: CREATE INFO, KILL, LAG, SEND, STATUS, START, STATS, STOP ADD, ALTER, CLEANUP, DELETE, INFO, KILL, LAG, REGISTER, SEND, START, STATS, STATUS, STOP UNREGISTER ADD, ALTER, DELETE, INFO VIEW INFO, SEND, START, STOP, STATUS INFO EDIT, VIEW ADD, ALTER, CLEANUP, DELETE, INFO, KILL, LAG, SEND, START, STATS, STATUS, STOP VIEW ADD, ALTER, DELETE, INFO ADD, DELETE, INFO ADD, DELETE, INFO ADD, DELETE, INFO ADD, DELETE, CLEANUP, INFO

Commands without an object: (Database) DBLOGIN, LIST TABLES, ENCRYPT PASSWORD, FLUSH SEQUENCE MININGDBLOGIN (DDL) DUMPDDL (Miscellaneous) FC, HELP, HISTORY, INFO ALL, OBEY, SET EDITOR, SHELL, SHOW, VERSIONS, ! (note: you must type the word COMMAND after the ! to display the ! help topic.) i.e.: GGSCI (sys1)> help ! command For help on a specific command, type HELP

Oracle GoldenGate 11g Lab

Recommend Documents