If you have read my previous post on Debezium, I have mentioned that currently, I am working on a platform which includes capturing CDC events from Oracle and publishing those to our new database. For this to work Oracle provides Golden Gate which is similar to what Debezium does, publishing all database changes to Kafka topics. However, If you are a developer like me who is working on Mac OS and do not have Oracle DB setup for Mac and which is sad 😞 then this post will help you to have your own Oracle Vagrant environment.
While I was working on this new platform development one of my colleagues told me about Oracle having vagrant images which could provide Oracle 12c to developers working on mac. Then I checked and found that Oracle has created a GitHub repo with the vagrant files both for Linux and Oracle 11 and 12c. After that, I basically took this vagrant files as a base for my work and installed golden gate setup along with confluent package on the Linux box. But you know it was a very tedious task to manually do the installation and all. And if I do a big blog with all the steps you guys would be like?
So, I enhanced the scripts to do the hard work and install Golden Gate + Confluent + enable some configuration for the Oracle database during vagrant box provisioning. And you know what one command does all the setup and configuration for you. Follow the exact given steps in the post and you will be gifted with the magical power of Oracle database, golden gate and confluent. 😂
1. Clone Vagrant Box Images
Clone my oracle vagrant fork from here. Let's wish my pull request get accepted by the oracle contributors team and this work becomes officially a part of Oracle GitHub repository ( finger crossed 🤞🏼).
2. Download Oracle Database Zip
Download the Oracle database 12c zip file from oracle tech network here or here. Use the Oracle Database 12c Release 2 - Linux x86-64 version and download the single file zip which is around 3.2GB.
3. Download Oracle GG and Oracle GG BD
Now, we need the Oracle Golden Gate and Golden Gate for Big Data zip files. These files can be downloaded from here. Download Oracle GoldenGate for Big Data 184.108.40.206.1 on Linux x86-64 & Oracle GoldenGate 220.127.116.11.4 for Oracle on Linux x86-64.
Keep all the downloaded files in the same vagrant git checkout directory.
4. Start Vagrant
At this point, all the pre-requisites are done. Now run
vagrant up and this will start installing Oracle database 12c, oracle golden gate, oracle golden gate for big data and confluent oss package on the Linux box.
Wait till everything finishes. At the very end, the setup will print the password for Oracle database make sure you copy that as this will help you to progress with the next steps. Now, you have your CDC dev environment ready on Mac or on any machine having vagrant. 😎
If you are new to Oracle golden gate and want to know about configuring the golden gate for Oracle database follow the below steps in the post.
Configure Golden Gate On Vagrant Box
There are two things we need to configure, the first is oracle golden gate and then oracle golden gate for big data. Let's begin by first configuring the golden gate for Oracle database. Please follow the exact step to get it running. You can find more information about the following command on oracle golden gate documentation.
1. Load Sample Schema To Oracle Database.
We need a schema present in the installed oracle database so that we can configure the golden gate to listen to the changes happening on this schema. Well, Oracle setup comes with HR schema SQL files present in the installation. We will load the same into our database.
vagrant sshcommand to ssh into the virtual machine
Log in to the database using SQL shell as a sysdba::
sqlplus / as sysdba
Alter the session to allow Oracle scripts to execute::
alter session set "_ORACLE_SCRIPT"=true;
Alter the session to use the PDB database (inside SQL shell)::
alter session set container=ORCLPDB1;
Load the schema and for all the input asked by the below command provide proper responses::
Execute the below commands as an oracle user, switch the vagrant user to Oracle using
sudo su - oracle
2. Configure Oracle Golden Gate
- Go to Oracle golden gate installation directory.
- Open golden gate console.
- Start manager.
> start mgr
- Log in to the database.
> DBLOGIN USERID [email protected]:1521/ORCLCDB PASSWORD [password copied while installation]
- Register Extract.
> REGISTER EXTRACT EXT1 DATABASE CONTAINER (ORCLPDB1)
- Enable schema-level supplemental logging for a table.
> ADD SCHEMATRANDATA ORCLPDB1.HR ALLCOLS
- Create an Extract group.
> ADD EXTRACT EXT1, INTEGRATED TRANLOG, BEGIN NOW
- Create a trail for online processing on the local system and Associate it with an Extract group.
> ADD EXTTRAIL ./dirdat/lt EXTRACT EXT1
- Create EXT1 parameter file and paste the content in the file.
> EDIT PARAM EXT1
USERID SYSTEM@ORCLCDB, PASSWORD [password copied during installation]
- Start Extract EXT1.
> start ext1
- View status of manager and ext1.
> info all
Program Status Group Lag at Chkpt Time Since Chkpt
EXTRACT RUNNING EXT1 00:00:00 00:00:00
The Oracle golden gate for Oracle 12c is configured. Now, its time to configure Oracle golden gate for big data which will push all the changes/ CDC events to confluent Kafka.
3. Configure Oracle Golden Gate For Big Data
Before following the below steps make sure you add java path to
$LD_LIBRARY_PATH environment variable in your
.bashrc file. The location of the java is
/usr/lib/jvm/java-1.8.0-openjdk-XXXXX/jre/lib/amd64/server. Replace XXXXX with your current version installed on during the installation.
Change directory to oggbd
Open golden gate for bd console.
Create default directories.
> CREATE SUBDIRSAfter doing this exit the console using
exitcommand, and create the following files in
Login to GG console again using step
2then execute the below command and add the contents to the param file
> edit param mgr
Start the manager.
> start mgr
Create replicat group
> add replicat rkafka, exttrail /u01/ogg/dirdat/lt
Start the replicat.
> start rkafka
View status of all if everything is properly configured.
> info all
Program Status Group Lag at Chkpt Time Since Chkpt
REPLICAT RUNNING RKAFKA 00:00:00 00:00:09
4. Verify Setup
Login to the database and add row to any table like::
> sqlplus / as sysdba
SQL> alter session set container=ORCLPDB1;
SQL> INSERT INTO HR.REGIONS(REGION_ID, REGION_NAME) VALUES(47, 'FOO');
Check if the kafka topics are created for the data inserted tables
> kafka-topics --zookeeper localhost:2181 --list
To check the data in the kafka topics run -
> kafka-avro-console-consumer --bootstrap-server localhost:9092 --topic ora-ogg-HR-REGIONS-avro --from-beginning
You can run both
kafka-avro-console-consumer from the host machine where you are running vagrant. This will help you while coding to connect to Kafka instance present in the vagrant vm. Also, The Oracle database is running on port 1521 to which you can connect from your java code or from your IDE.
This vagrant images is really helpful to me and hope it will also help you guys while developing your CDC related applications. For any issues, during setup or configuring please do comment on the post.
- Zookeeper Port:: 2181
- Kafka Broker:: 9092
- Confluent Schema Registry:: 8081
- Oracle DB Port:: 1521
Don't forget to share the post with your friends and colleagues.