Step 1: Start the GGSCI on Source and Target
| Source | Target |
|
Oracle GoldenGate Command Interpreter for Sybase Version 12.1.2.0.0 17185003 OGGCORE_12.1.2.0.0_PLATFORMS_130924.1316 Linux, x86, 64bit (optimized), Sybase 16 |
Oracle GoldenGate Command Interpreter for Oracle Version 11.2.1.0.1 OGGCORE_11.2.1.0.1_PLATFORMS_120423.0230_FBO Linux, x86, 64bit oracle 11g |
Tip: Should I use the same version of Oracle GoldenGate on the Source and Target?
Yes, it is recommended to use the same version on both the source and target. However, If the Oracle GoldenGate versions on the source and target database are different, it is a good practice to use the RELEASE option of the EXTFILE/RMTFILE and EXTTRAIL/RMTTRAIL parameter, especially if you have a lower version of Oracle GoldenGate on the target.
Example: EXTFILE ./dirdat/em, FORMAT RELEASE 11.2
1. Use a defgen paramfile with NOEXTATTR option, or
2. Generate definition file with the same OGG version as the OGG target site version.
$ ./defgen paramfile ./dirprm/defgen.prm reportfile ./dirrpt/defgen.31Jul2013.rptNOEXTATTR
We then need to modify and check the Oracle GoldenGate Manager parameter file to prepare the replication. The following table shows the Oracle GoldenGate Manager setup on the source and target system:
| Source | Target |
|
export DSQUERY=ASE1 GGSCI> edit param mgr port 15021 GGSCI> start mgr |
GGSCI> edit param mgr
port 15021 GGSCI> start mgr |
Step 2: Set up the Source and Target Database
创建city表
| Source (Sybase ASE 16) | Target (Oracle Database 11.2.0.1) |
|
isql -Uogguser -Pogguser -SASE1 >use pubs2 >go create table city (id int, name varchar(10) insert into city values (1,‘New York‘) > select count(1) from city |
connect swat/swat create table city (id int, name varchar2(10); insert into city values (1,‘New York‘); > select count(1) from city; |
Step 3: Set up the Secondary Truncation Point in Sybase Transaction Log
When using Oracle GoldenGate for Sybase, you need to setup the secondary truncation point.This is because Oracle GoldenGate uses the secondary truncation point to identify data that remains to be processed.
To set up the secondary truncation point, you need to login Sybase database with a user who hassa_role privilege and run the “dbcc settrunc(‘ltm’,valid)” command. The detailed steps are shown as follows:
Source
Shell> isql -Uogguser -Pogguser -SASE1
1> use pubs2
2> go
1> dbcc settrunc(‘ltm‘, ‘valid‘)
2> go
ltm_truncpage ltm_trunc_state db_rep_stat gen_id dbid dbname lti_version
------------- --------------- ----------- ----------- ------ ------------ -----------
524307 1 1 0 5 sydatabase 0
Step 4: Prepare the Source Database and Target Database
Connect to the source DB and add trandata. In addition, confirm that Oracle GoldenGate user can access on the target database shown as follows:
| Source | Target |
|
GGSCI >dblogin sourcedb [email protected] userid ogguser password ogguser GGSCI > list table dbo.city GGSCI > info trandata dbo.city Transaction logging disabled for table dbo.city GGSCI > add trandata dbo.city Transaction logging enabled for table suser.regions. |
GGSCI > dblogin userid swat, password swat Successfully logged into database. GGSCI > list table swat.city |
Why I get the "ERROR: Cannot use database syd_database. error, no additional information available." error?
Answer: The problem is the parsing issue in Oracle GoldenGate 11.2.1 version if the database has special characters such as “_” in the database and schema name. The current solution is to remove the special characters.
Because we are working on heterogeneous database replication, you have to create the database metadata definition file on the source system and copy the generated definition file to the target.
| Source | Target |
|
emaster.prm: extract emaster exttrail ./dirdat/em,FORMAT RELEASE 11.2 sourcedb [email protected] userid ogguser password ogguser statoptions resetreportstats report at 00:01 reportcount every 60 seconds, rate table dbo.city; |
rmaster.prm:
replicat rmaster userid swat, password swat sourcedefs ./dirout/city.def discardfile ./dirrpt/rmaster.dsc, purge map dbo.city, target swat.city; |
|
Adding the Extract: GGSCI> add extract emaster, tranlog, begin now GGSCI> add exttrail ./dirdat/em, extract emaster, megabytes 50 |
Adding the Replicat: GGSCI >edit param ./GLOBALS GGSCHEMA goldengate CHECKPOINTTABLE goldengate.checkpoint GGSCI>ADD CHECKPOINTTABLE goldengate.checkpointtable GGSCI>add replicat rmaster, exttrail ./dirdat/pm |
|
pmaster.prm: extract pmaster rmthost 192.168.137.11, mgrport 15021, compress, timeout 30 rmttrail ./dirdat/pm passthru table dbo.city; |
|
|
Adding the Pump: GGSCI > add extract pmaster, exttrailsource ./dirdat/em EXTRACT added. GGSCI > add rmttrail ./dirdat/pm, extract pmaster, megabytes 50 RMTTRAIL added. |
|
|
Insert a New Record in Sybase 1> Insert into regions values(5,‘Antarctica‘) 2> go (1 row affected) |
SQL> select * from regions; REGION_ID REGION_NAME ---- ---------------------- 1 Europe 2 Americas 3 Asia 4 Middle East and Africa 5 Antarctica |
|
Delete a Record in Sybase 1> delete from regions where region_id=5 2> go (1 row affected) |
SQL> select * from regions; REGION_ID REGION_NAME ---- ---------------------- 1 Europe 2 Americas 3 Asia 4 Middle East and Africa |
Now, we have completed the basic setups of a one-way replication from Sybase ASE database to Oracle Database.Feel free to let me know if you have any questions or comments on the tips I provided above.
Installing Oracle GoldenGate for Sybase:
Step 1: Download Oracle GoldenGate for Sybase
Step 2: Unzip the Oracle GoldenGate zip File.
Unzip the downloaded file with the following commands:
unzip V32422-01.zip
tar xvf ggs_Linux_x86_sybase15_5_32bit.tar
Check the shared library path:
env |grep LD_LIBRARY_PATH
LD_LIBRARY_PATH=/home/sybase/ASE-15_0/lib:/home/sybase/DataAccess/ODBC/lib:
/home/sybase/OCS-15_0/lib:/home/sybase/OCS-15_0/lib3p:/home/sybase/ASE-15_0/lib:
/home/sybase/DataAccess/ODBC/lib:/home/sybase/OCS-15_0/lib:
/home/sybase/OCS-15_0/lib3p:
Add the OGG installation path to the path (PATH) and shared library path (LD_LIBRARY_PATH) environment variables:
export PATH=/home/ogg_for_sybase:$PATH
export LD_LIBRARY_PATH=/home/ogg_for_sybase:$LD_LIBRARY_PATH
Note:
LD_LIBRARY_PATH= /opt/sybase/ASE-16_0/lib: /opt/sybase/OCS-16_0/lib: /opt/sybase/OCS-16_0/lib3p: /opt/sybase/OCS-16_0/lib3p64: /opt/sybase/DataAccess/ODBC/lib: /opt/sybase/DataAccess64/ODBC/lib:
Step 3: Create Oracle GoldenGate
Run the ggsci command in the folder where Oracle GoldenGate files are unzipped:
./ggsci
GGSCI> create subdirs
...
GGSCI>Exit
Step 4: Create Database User in Sybase for Replication.
In the Sybase database, create a database user for Oracle GoldenGate, and grant the sa_role and thereplication_role to that user:
Isql –Usa –P –SASE1
1> sp_addlogin ogguser,ogguser
2> go
Password correctly set.
Account unlocked.
New login created.
(return status = 0)
1> sp_adduser ogguser
2> go
New user added.
(return status = 0)
1> sp_role ‘grant‘, replication_role, ogguser
2> go
Authorization updated.
(return status = 0) 1> sp_role ‘grant‘, sa_role, ogguser
2> go
Authorization updated.
(return status = 0)