Golden Gate Installation Guide.docx

8/10/2019 Golden Gate Installation Guide.docx

http://slidepdf.com/reader/full/golden-gate-installation-guidedocx 1/15

ONB - Golden Gate Installation and Configuration Guide Last Update: 12-Aug-2010

Uncontrolled wen printed! golden source is "rocess Assets Li#rar$ %"AL&

'ersion ()2 "age 1 of 1*









Golden Gate Installation Guide

+ocu,ent 'ersion: ()2 elease date: 1. Aug

20101/)0.)0( 1(:02

INTERNAL USE ONLY


'ersion ()2 "age ( of 1*




Change History

Release Date Author Reason for Change

0)1 21-ul$-2010 Agilan "alani +raft 'ersion

0)2 2.-ul$-2010 Again "alani Based upon te feed #ac fro, +30)( (0-ul$-2010 Agilan "alani 4odified #ased upon I3 guidelines

2)0 1.-Aug-2010 Agilan "alani 4odified #ased on +B 3ce,a standards

()2 20-Aug-2010 Agilan "alani Updated te start,anager script

()( 22-No5-2011 An 'u Update te 4G para,eter to purge old files

Approval Sign!off

6is docu,ent as #een issued to te following persons for appro5al and sign-off

Date Role Na"e






CONTENTS

1. INTRODUCTION..................................................................................................................................................4

1.1 PURPOSE ...........................................................................................................................................................4

1.2 I NTENDED AUDIENCE .......................................................................................................................................4

1.3 SCOPE ...............................................................................................................................................................4

1.4 R EFERENCES .....................................................................................................................................................4

2. INSTRUCTIONS....................................................................................................................................................5

2.1 DOWNLOAD ......................................................................................................................................................5

2.2 SOURCE [CAAA DATA BASE SERVER ] - U NIX REQUIREMENTS/SETUP ...........................................................5

2.3 U NIX USERS ATE ! DBA SETUP .............................................................................................................."

2.4 TARET [FX4CAS# DATABASE SERVER ] $ U NIX R EQUIREMENTS/SETUP .......................................................%

2.5 MONITORIN R EQUIREMENT &BOT# IN SOURCE AND TARET'......................................................................%

2." SOURCE [CAAA DATABASE]$ DATABASE REQUIREMENTS ..............................................................................(

2.% TARET [ FX4CAS# DATABASE ]$ DATABASE R EQUIREMENTS .......................................................................(

2.( SOURCE ! TARET - ORACLE CLIENT I NSTALLATION ....................................................................................(

2.) SOURCE ! TARET - DIS* SPACE R EQUIREMENTS .........................................................................................)

2.1+ SOURCE ! TARET - MEMOR, R EQUIREMENTS .............................................................................................)

2.11 DATABASE SETUP $ SOURCE[CAAA]$ O N-BOARDIN .................................................................................1+2.12 DATABASE SETUP - TARET [FX4CAS#] $ FX4CAS# ......................................................................................11

2.13 I NSTALLIN OLDEN ATE $ SOURCE ! TARET ........................................................................................12

3. APPENDIX...........................................................................................................................................................13

3.1 LIST OF DICTIONAR, TABLES W#IC# OLDEN ATE REQUIRES SELECT ACCESS ...........................................13


'ersion ()2 "age * of 1*




#$ INTRODUCTION

#$# %urpose

The purpose of this document is to detail the steps involved in installation the golden gate forOn-boarding application

#$& Inten'e' au'ien(e

Intended audiences of this document are as follows:

• Infrastructure Team

• DBA Team

• Relevant Staeholders of the pro!ect

#$) S(ope

"olden gate is a tool# which replicates the data $ DD% from one database to anotherdatabase& This document e'plains the steps involved in installation of golden gate for On-

boarding application acting as source and the first target application as ()*+AS,&

#$* Referen(es

"olden gate Installtion "uide: ggorainstv./*&pdf






&$ INSTRUCTIONS

2.1 Download

For Oracle 10G

Download the goldgate software from the below 0R% Oracle ./&/&*&/ $ Sun SparSolaris ./ 1 2* bit& The goldengate version is ./&*&/&.3

http:44www&oracle&com4technolog54software4products4goldengate4inde'&html

Accept the OT6 license&Download the following&

Oracle "olden"ate v./&*&/&' for Oracle ./g 2*bit on Solaris ./ 789 B;

Solaris-<.=.*=-/.&>ip

2.2 Source [CAAA Data Base Server] - Unix requirements/Setu

.& Access to the O6B Database Server 7Sun Spar Solaris ./ 1 2* bit&; Thefollowing must have the same bit t5pe# either all 9?-bit# all 2*-bit

"olden"ate version

Oracle librar5 versions

Database versions

?& +reate two new 06I) account @ggate and @ggdba with the followingsetup# ggdba should be in the dba group

Account Reuirements +ommentsggate uidC.?7ggate; gidC?/*/7ggate;

,ome director5 E4e'port4home4ggateF

Oracle "olden"ate software must be

installed with this account&"olden"ate EmanagerF process need

to started through su privilege

e'ecuting startup shell script as

@ggdba account&

ggdba uidC?.=*7ggdba; gidC.?37gguser;#

gidC?/*/7ggate;# gidC9/? 7dba;

,ome director5 E4e'port44home4ggdbaF

ggdba is a special account that

would not be accessed b5 ggate

directl5 other than running script to

start EmanagerF process for

"olden"ate& Startup scripts would

be managed b5 IGS support&

9& Assign the proper home director5 for ggate and ggdba

*& @ggate reuires read4e'ecute access to the following resources& Oraclesshared libraries $ tnsnames&ora

8& All the binaries# configuration files# custom files and installation will beowned b5 EggateF account&

2& +reate a file s5stem for ?/ "B 7for Hrod;# 8 "B 7for non prod; owned b5ggate account mounted under the director5 as per the standard fore'ample E4app4goldengate4instances4gginstanceJ



http://www.oracle.com/technology/software/products/goldengate/index.html

http://download.oracle.com/otn/goldengate/V18148-01.zip

http://www.oracle.com/technology/software/products/goldengate/index.html

http://download.oracle.com/otn/goldengate/V18148-01.zip




& ae sure that the oracle slplus client is installed& Slplus client should 6OT be the instant

sl plus client it should be the standard full Slplus client=& Open the port =3/

2.! Unix Users ""ate # ""d$a setu

1) Create te )profile wit te following content for ggate user

sh-ggateJ vi K,OG4&profile

set -o vie'port GDITORCvie'port TIGO0TC/e'port TO0TC=2*//HAT, C path to oracle homeJ/bin:KHAT,e'port HAT,""I6STA6+GROOTC"olden gate instances director5 e&g 4app4goldengate4instancesJe'port ""I6STA6+GROOT#If ggate user is shared by Xple environments, use separate profiles for GGI!"""I6SCprde'port ""I6S#If ggate user is shared by Xple environments, use separate profiles for GGO$%"",OGCK""I6STA6+GROOT4K""I6Se'port K"",OG#If ggate user is shared by Xple environments, use separate profiles for the#O&'()%O$%ORA+%G,OGCOracle ,ome# "et it from DBAJe'port ORA+%G,OG#If ggate user is shared by Xple environments, use separate profiles for#)*)I+&'&-'.

%D%IBRARLHAT,CKORA+%G,OG4lib:K"",OG:K%D%IBRARLHAT,e'port %D%IBRARLHAT,T6SADI6Cpath to tns adminJe'port T6SADI6

2) Create additional profiles for eac en5iron,ent for ggate user There would be one ggdba and ggate uni' users per database server machine& If thedatabase server is shared with multiple test environments# ""I6S variable shouldnot be set in the &profile of ggate& Instead use separate &profileenvJ&sh for eachenvironment and set up the following variables appropriatel5&

s-ggate 5i ;<O4= profile-prod)s""I6SCprde'port ""I6S

%D%IBRARLHAT,Cpath to oracle homeJ4lib:K"",OG:K%D%IBRARLHAT,e'port %D%IBRARLHAT,

GG_HOME=$GG_INSTANCE_ROOT/$GG_INSexport $GG_HOME


'ersion ()2 "age . of 1*




() ggd#a setup: 3udo script and start ,anager script setup

ggdba uni' id should used to start the "olden "ate anager& It has to be doneb5 performing 06I) S0DO from ggate id& Do the necessar5 set up for this using thefollowing instructions

a& +reate the startmgr file with the following content content to start the"olden "ate anager HrocessGgdba> /export/home/ggdba/startmgrsh

startmanager.txt

b& Set the proper Ownership and Hermission!ho"# rootggdba /export/home/ggdba/startmgrsh!hmod %&' /export/home/ggdba/startmgrsh

c& Add the following to sudoers file with visudoggate A((= )ggdba* NO+ASS,- /export/home/ggdba/startmgrsh

7) Using ggate user! te start,anager script is e>ecuted using sudo to ggd#a

a& ae sure that ggdba user is part of the ggate user groupuidC?.=*7ggdba; gidC.?37gguser;

b& Start the manager from ggate as followsggate> s.do . ggdba /export/home/ggdba/startmgrsh 0start

ma#ager1 0$GG_HOME1 0$ORAC(E_HOME1 0$TNS_A-MIN1

c& Stop the manager from ggate as follows 76OTG: This will stop all

e'tracts4replicats;&

ggate> s.do . ggdba /export/home/ggdba/startmgrsh 0stop

ma#ager1 0$GG_HOME1 0$ORAC(E_HOME1 0$TNS_A-MIN1

2.% &ar"et ['x%cas( Data$ase Server] ) Unix *equirements/Setu

Follow exactly what is specified for Source, UNIX requirements

2.+ ,onitorin" *equirement Bot( in Source and &ar"et

1) ?rite a ,onitoring script to ,onitor te goldengate process) Configure te script as aCron o# for 6est en5iron,ents and in 6i5oli for te "roduction) 6e script sould #ein5oed e5er$ * ,inutes) 6e logic is as follows

;GG@<O4=scripts-appna,e=cron-,on-,gr)s

a) edirect te output of te startup to a log file


'ersion ()2 "age / of 1*




s.do . ggdba /export/home/ggdba/startmgrsh 0start ma#ager1 0$GG_HOME1

0$ORAC(E_HOME1 0$TNS_A-MIN1 > strmgr2og

#) If te ,anager is alread$ running $ou will get te following ,essage in testr,gr)log file

Ora!2e Go2de#Gate Comma#d I#terpreter 3or Ora!2e 4ers5o# 6'7'689.52d '': So2ar5s; spar!; <7b5t )opt5m5ed*; Ora!2e 6' o# Sep : :''86&687: Cop?r5ght )C* 688&; :''8; Ora!2e a#d/or 5ts a33525ates A22r5ghts reser@ed GGSCI )dbd5d76* 6> MGR is already running GGSCI)dbd5d76* :>

c) 3tart All te e>tracts

s.do . ggdba /export/home/ggdba/startmgrsh 0start extra!t 1 0$GG_HOME1


d) 3tart All te replicats

s.do . ggdba /export/home/ggdba/startmgrsh 0start rep25!at 1 0$GG_HOME1


e) Grep for te 4G is alread$ running in te log! if te grepped te>t is found donoting) If te grepped te>t is NO6 found! send an e,ail to te support witte following ,essage)

To Bto_25st>

S.be!t Go2de#gate Not535!at5o# .serDhost#ame

9od?-ate Bdate t5me>HostName Bhost#ame>Go2de#gate Ma#ager "as do"# It 5s started #o"Go2de# gate home $GG_HOME

Note Fo. !a# get the host; port p5d 3rom

$GG_HOME/d5rp!s/MGRp!m 352e

Samp2e 52e "5th abo@e 2og5! 5s atta!hed be2o"

cron-mon-mgr.sh.txt

2. Source [CAAA Data$ase]) Data$ase requirements

.& "et the DBA and SLSDBA access to the +AAA database for the one timesetup

?& The character set of the target database must be a superset of the characterset of the source database

9& ae sure the archive log files are retained for at least one wee& This isapplicable onl5 in production& In order to retain one wee of archive log 2/ "B






of storage should be additionall5 allocated& Also the respective shell script

should be changed to retain the one wee archive log file

2.0 &ar"et [ '%CAS Data$ase ]) Data$ase *equirements

.& "et the DBA access to the ()*+AS, database for the one time setup?& The character set of the target database must be a superset of the character

set of the source database

2.3 Source # &ar"et - 4racle Client 5nstallation

Source and Target should have proper Oracle +lient installation& Instance +lientshould not be used for installation& The golden gate shares the libraries from the fulloracle client&

2.6 Source # &ar"et - Dis7 Sace *equirements

The following are the Dis Space Reuirements for Installation of "olden"ateSoftware:

•

8/ B for the "olden"ate installation files• */ B for the woring directories

• Additional dis space of ?/ "B 7for Hroduction; and 8 "B 7for non production;

on source $ target s5stems&

2.18 Source # &ar"et - ,emor9 *equirements

The following are the emor5 Reuirements for Installation of "olden"ate Software:

• Gach G'tract4Replicat process needs appro'imatel5 ?8-88 B of memor5# or

more depending on the si>e of the transactions and the number of concurrent

transactions& To start with the Source has ? e'tract processes and the targethas . replicat processes& So .// B on source and 8/ B on the target






2.11Data$ase Setu ) Source[CAAA]) 4n-$oardin"

*$) &eplication "etup

.& "o to the K""I6STA6+GROOT4K""I6S director5?& %aunch the slplus from K""I6STA6+GROOT4K""I6S director5 and connect to

+AAA Database with appropriate user to do the following&9& Gnable Archive %ogging

") Get the synta from *+'*& Gnable Supplementar5 %ogging

") ').%& *'.'+'"% '** "2--)%$%!.') )OG *'.'3

8& To start the supplemental logging# switch the log files&

") ').%& "".%$ "4I.( )OGFI)%3

2& <erif5 that supplemental logging is enabled at the database level with this command:

") "%)%(. "2--)%$%!.'))OG*'.'$I! F&O$ 56*'.'+'"%3(or Oracle ./g# the output of the uer5 must be LGS or IH%I+IT&

& +reate ""ATG0SGR Oracle Account

=& ""ATG0SGR Setup 7!ote: the e'tracts will use this account;a& +reate the database role ""ATGA++GSSRO%G

b& +reate the database role ""ATGOM6GRRO%G

c) "rant database s5stem privilege to the rolegra#t CREATE SESSION; SE(ECT ANF -ICTIONARF to GGATE_O,NER_RO(E

7OR;If select any dictionary is not possible. Grant select on the

Golden Gate required dictionary tables specified in the Appendix3.1

d& "rant privileges to the +AAA ob!ects

GRANT SE(ECT ON BCAAAGC_ tab2es> TO GGATE_ACCESS_RO(E GRANT SE(ECT ON BCAAAGR_ tab2es> TO GGATE_ACCESS_RO(E GRANT SE(ECT ON BCAAAbra#!h> TO GGATE_ACCESS_RO(E GRANT se2e!t o# BCAAAGR_ se.e#!es> TO GGATE_ACCESS_RO(E GRANT exe!.te o# BCAAAGR_ pa!ages> TO GGATE_ACCESS_RO(E GRANT exe!.te o# BCAAAGRJ_KC> TO GGATE_ACCESS_RO(E GRANT (ASH9ACL ON BCAAAGC_ tab2es > TO GGATE_ACCESS_RO(EGRANT (ASH9ACL ON BCAAAGR_ tab2es > TO GGATE_ACCESS_RO(EGRANT (ASH9ACL ON BCAAAbra#!h > TO GGATE_ACCESS_RO(E GRANT SE(ECT ON BCAAAGA_COM+ANF> TO GGATE_ACCESS_RO(E GRANT SE(ECT ON BCAAAGA_MAN-ATE> TO GGATE_ACCESS_RO(E GRANT SE(ECT ON BCAAAGA_+ERSON> TO GGATE_ACCESS_RO(E

e& "rant DBS(%AS,BA+N to the roleGra#t Exe!.te o# -9MS_(ASH9ACL pa!age to GGATE_ACCESS_RO(E

f& "rant the Role to ""ATGGRANT GGATE_ACCESS_RO(E to GGATE






2.12 Data$ase Setu - &ar"et ['x%Cas(] - 'x%Cas(

.& "o to the K""I6STA6+GROOT4K""I6S director5?& %aunch the slplus from K""I6STA6+GROOT4K""I6S director5 and connect to

('*cash Database with appropriate user to do the following&9& +reate "GS Schemaa& "GSOM6GRb& G'ecute the DD% Scripts 7The S% folder in the ()+&>ip contains A%% the DD%

statements reuired to setup the "GSOM6GR schema;

!ote7 .he O!+ team 8ill provide the FX(9:ip to the F;(ash team9

F;cash team 8ill chec<=in the FX(9:ip as part of their code base9*& +reate ""ATG0SGR Schema8& ""ATG0SGR Setup 7!ote: the replicats will use this account;

a& +reate the following database role ""ATGA++GSSRO%Gb& +reate the following database role ""ATGOM6GRRO%G

c) "rant database s5stem privilege to the role

5 gra#t CREATE SESSION; SE(ECT ANF -ICTIONARF to GGATE_O,NER_RO(E%O&55 If select any dictionary is not possible. Grant select on the

Golden Gate required dictionary tables specified in the Appendix

3.1

d& "rant privileges to the ""ATGA++GSSRO%G

GRANT SE(ECT;5#sert;de2ete;.pdate ON BGES_O,NERGC_ tab2es> TOGGATE_ACCESS_RO(EGRANT SE(ECT;5#sert;de2ete;.pdate ON BGES_O,NERGR_ tab2es> TOGGATE_ACCESS_RO(EGRANT SE(ECT;5#sert;de2ete;.pdate ON BGES_O,NERbra#!h> TOGGATE_ACCESS_RO(E

GRANT se2e!t o# BGES_O,NERGR_ se.e#!es> TO GGATE_ACCESS_RO(EGRANT exe!.te o# BGES_O,NERGR_ pa!ages> TO GGATE_ACCESS_RO(E

e& "rant read4write access to the chec point table created in the "GSOM6GR

schema 7!O.%7 (hec< point table 8ill be available only after the activity

in the section >911 and point ? is completed@

GRANT SE(ECT;INSERT;J+-ATE;-E(ETE ON GES_O,NERGR_CHL+OINT TOGGATE_ACCESS_RO(E

f& "rant the role to the ""ATGGRANT GGATE_ACCESS_RO(E to GGATE

2& +reate the schema ('*+ash0SGR4('*+ashRGAD and setup as per instructions from

('*+ash& "rant the following privileges&

a& +reate the "GSRGADO6%L role and grant the following privilegesGra#t se2e!t o# BGES_O,NERGC_ tab2es> to GES_REA-ON(FGra#t se2e!t o# BGES_O,NERbra#!h> to GES_REA-ON(FGra#t se2e!t o# BGES_O,NERGR_ tab2es> to GES_REA-ON(FGra#t se2e!t o# BGES_O,NERGR_ se.e#!es> to GES_REA-ON(F

b& Assign the "GSRGADO6%L role to ('*cashRGAD


'ersion ()2 "age 1( of 1*




GRANT GES_REA-ON(F to 3x7!ash_REA-

c& +reate the "GS0HDATG role and grant the following privilegesGra#t se2e!t;.pdate;5#sert;de2ete o# BGES_O,NERGR_ tab2es> to

GES_J+-ATEGra#t se2e!t o# BGES_O,NERGR_ se.e#!es> to GES_J+-ATE

Gra#t exe!.te o# BGES_O,NERGR_ pa!ages> to GES_J+-ATE

d& +reate the "GSAHH%I+ATIO6 role and Assign the following rolesGra#t GES_REA-ON(F to GES_A++(ICATIONGra#t GES_J+-ATE to GES_A++(ICATION

e& Assign the "GSAHH%I+ATIO6 role to f'*cash0SGRf& Assign the "GSRGADO6%L role to f'*cash0SGR

2.1! 5nstallin" :olden :ate ) Source # &ar"et

.& (TH the >ip file# which is provided b5 oracle or downloaded from oracle website to the

source4target environment& G'tract the Pip file& Inside the Pip the file# 5ou will find a

tar file for solaris installation&?& G'tract the contents of the tar file under K"",OG director5&

9& (rom the GoldenGate home directory# run the ""S+I program&

/ggs!5

*& In ""S+I# issue the following command to create the "olden"ate woring directories&

GGSCI> CREATE SJ9-IRS

8& +onfigure manager to add port&

GGSCI> E-IT +ARAMS MGR

This will create a new mgr&prm file in the EdirprmF director5& T5pe the followingcontents# and save the file&

On the Source Side

+ORT %'8-O,NRE+ORTMINJTES 6(AGRE+ORTMINJTES 6+JRGEO(-EKTRACTS d5rdat/3s; MINLEE+I(ES 6'

On the Target Side

+ORT %'8-O,NRE+ORTMINJTES 6(AGRE+ORTMINJTES 6+JRGEO(-EKTRACTS d5rdat/3s; MINLEE+I(ES 6'

2& Add +hecpoint table 7 -erform this step O!) in the .arget Af;cash@






I# GGSCI 2og5# to the GES_O,NER databsaeGGSCI> db2og5# .ser5d ges_o"#erDB3x7!ashdbhost>B3x7!ashdbport>/B3x7!ash s5d> ; pass"ord Bpass"ord>S.!!ess3.22? 2ogged 5#to databaseGGSCI> A-- CHECL+OINTTA9(E GR_CHL+OINT

Che!po5#t tab2e added

& Start $ <erif5 manager is running

GGSCI> start ma#agerGGSCI> 5#3o a22+rogram Stat.s Gro.p (ag T5me S5#!e ChptMANAGER RJNNING

)$ A%%ENDI+

!.1 ;ist o< dictionar9 ta$les w(ic( :olden "ate requires select access

5;data#ase5;para,eter 5;instance5;data#ase@incarnation5;log5;arci5e@dest5;logfileg5;data#aseg5;para,eter g5;instanceg5;data#ase@incarnationg5;logg5;arci5e@destg5;logfile

d#a@o#Dectsd#a@constraintsd#a@ta#lespacesd#a@ta#@partitionsd#a@log@groupsall@usersall@ta#lesall@log@group@colu,nsall@cons@colu,ns

seg;ta#;props;o#D;user;ta#;col;cdef;con;


'ersion ()2 "age 1* of 1*

Documents

Golden Gate Installation Guide.docx