OGG19.1 oracle12c到oracle12c经典和集成模式配置实施
-
目的说明
本文提供Oracle GoldenGate在Oracle db到Oracle db的数据复制安装配置指导，适用于入门练习使用，生产环境配置，在关键步骤和重要参数设置需要小心对待。
OGG19.1 oracle12c到oracle12c经典和集成模式配置实施 ---- 支持DDL复制配置。
-
参考文档
《叱咤风云GoldenGate企业级运维实战》
Oracle GoldenGate Document 12.3.0/19.1.0
-
准备系统
准备好两套已经装好Oracle db和Oracle GoldenGate for Oracle的环境。
-- 安装步骤略
-- https://docs.oracle.com/en/middleware/goldengate/core/19.1/installing/installing-classic-architecture.html
-- ./runInstaller -silent -responseFile /tmp/trace/fbo_ggs_Linux_x64_shiphome/Disk1/response/oggcore.rsp
-- /orabin/oraInventory/logs/installActions2020-07-06_04-46-55PM.log
--
source db：
ip：192.168.6.20
db type：Oracle db 12.2.0.1.0
target db：
ip：192.168.6.20
db type：Oracle db 12.2.0.1.0
GoldenGate:
ogg type：GoldenGate for Oracle 19.1.0.0.4
-
配置source db
4.1 配置source db参数
source db的配置主要是归档模式修改、附加日志的添加、强制日志和--ddl语句的支持。
--#源端DB开启归档模式和最小附加日志
--4.1.1 源端DB开启归档模式
archive log list
--#启用主动归档
-- 关闭并mount数据库
shutdown immediate
startup mount
-- 开启归档日志
alter database archivelog;
-- 设置本地归档路径
alter system set log_archive_dest_1='location=/oradata/oggsdb/archive' scope=spfile;
-- 设置归档日志文件名格式
show parameter log_archive_format
----default %t_%s_%r.dbf
alter system set log_archive_format='oggsdb_%t_%s_%r.arc' scope=spfile;
--关闭数据库，再启动数据库 ，使参数 log_archive_dest_1生效
shutdown immediate
startup
--检查配置和参数生效
archive log list
show parameter log_archive_dest_1
show parameter log_archive_format
-- 4.1.2 强制日志变更
alter database force logging; --实时生效 强制日志
--ALTER DATABASE NO FORCE LOGGING;
-- 4.1.3 开启最小附加日志 和 查看最小附加日志
alter database add supplemental log data; --实时生效 最小附加日志
--alter database drop supplemental log data;
--查看source db归档、附加日志和强制日志：
select supplemental_log_data_min from v$database;
select db.LOG_MODE, db.SUPPLEMENTAL_LOG_DATA_MIN, db.FORCE_LOGGING from v$database db;
select db.NAME,
db.LOG_MODE,
db.FLASHBACK_ON,
db.FORCE_LOGGING,
db.supplemental_log_data_min,
db.supplemental_log_data_pk,
db.supplemental_log_data_ui,
db.supplemental_log_data_ui,
db.supplemental_log_data_fk,
db.supplemental_log_data_all,
db.supplemental_log_data_pl
from v$database db;
-- 4.1.4 修改GoldenGate参数
show parameter enable_goldengate_replication
alter system set enable_goldengate_replication = true scope = both;
show parameter enable_goldengate_replication
-- 4.1.5 创建GoldenGate用户
create tablespace ogg_data datafile '/oradata/oggsdb/ogg_data01.dbf' size 50M autoextend on next 8M;
create user ogg identified by Password123 default tablespace ogg_data quota unlimited on ogg_data;
授权GoldeGate用户 ：
grant connect, resource to ogg;
grant alter any table, alter system,alter user, create session, alter session to ogg;
grant select any dictionary, SELECT ANY TRANSACTION,select any table,flashback any table to ogg;
--grant DBA to ogg; -- DDL and sequence support
--GRANT FLASHBACK ANY TABLE TO db_user
--GRANT FLASHBACK ON schema.table TO db_user
--11.2.0.4 or later需要执行以下package 权限 ：
begin
dbms_goldengate_auth.grant_admin_privilege(grantee => 'OGG',
privilege_type => 'CAPTURE',
grant_select_privileges => TRUE,
do_grants => TRUE);
END;
/
/*----此包dbms_goldengate_auth.grant_admin_privilege授予权限如下18个权限：
-- Grant/Revoke object privileges
grant execute on LOGMNR$COL_GG_TABF_PUBLIC to OGG;
grant execute on LOGMNR$GSBA_GG_TABF_PUBLIC to OGG;
grant execute on LOGMNR$KEY_GG_TABF_PUBLIC to OGG;
grant execute on LOGMNR$SEQ_GG_TABF_PUBLIC to OGG;
grant execute on LOGMNR$TAB_GG_TABF_PUBLIC to OGG;
grant insert on LOGMNR_RESTART_CKPT$ to OGG;
-- Grant/Revoke role privileges
grant select_catalog_role to OGG;
-- Grant/Revoke system privileges
grant alter any table to OGG;
grant alter session to OGG;
grant create evaluation context to OGG with admin option;
grant create job to OGG;
grant create rule to OGG with admin option;
grant create rule set to OGG with admin option;
grant dequeue any queue to OGG with admin option;
grant execute any rule set to OGG with admin option;
grant flashback any table to OGG;
grant logmining to OGG;
grant select any table to OGG;
*/
--4.1.6 配置DDL语句支持 ( Support for DDL Capture in Classic Capture Mode )
--Classic capture mode requires the use of the Oracle GoldenGate DDL trigger to
--capture DDL from an Oracle Database. Native DDL capture is not supported by classic capture mode.
--授权GoldeGate用户 ：(除以上 4.1.5 授权部分外，还需要 DBA 权限 支持 DDL and sequence 捕获)
--a.
--创建存放ddl信息的GoldenGate用户： ( 如上 共用 ogg 用户 )
--create tablespace ogg_data datafile '/oradata/oggsdb/ogg_data01.dbf' size 50M autoextend on next 8M;
--create user ogg identified by Password123 default tablespace ogg_data quota unlimited on ogg_data;
--b. 此可暂时忽略
-- (Optional)To cause user DDL activity to fail when the DDL tablespace fills up, edit the params.sql script
-- and set the ddl_fire_error_in_trigger parameter to TRUE. As a best practice, make certain to size the tablespace appropriately in the first place.
#params.sql内容
define the ddl_fire_error_in_trigger = 'TRUE'
define allow_invisible_index_keys = 'TRUE'
#To enable trigger-based DDL replication to recognize Oracle invisible indexes as
#unique identifiers, set the following parameter to TRUE in the params.sql script:
--c. 此可暂时忽略
--#at the root of the Oracle GoldenGate directory. Do not alterthe file name or location.
EDIT PARAMS ./GLOBALS
# 内容
GGSCHEMA schema_name
##Save and close the GLOBALS file and the params.sql file.
--d.
grant dba to ogg ;
GRANT EXECUTE ON utl_file TO ogg;
#Change directories to the Oracle GoldenGate installation directory.
# ----The specific location is: oggma_install_home/lib/sql/legacy.
#Exit all Oracle sessions. Prevent the start of any new sessions.
进入GoldenGate目录，调用SQL脚本：
cd $OGG_HOME
sqlplus / as sysdba
SQL> @marker_setup.sql;
#输入准备好的用户ogg
SQL> @ddl_setup.sql;
#输入准备好的用户ogg
SQL> @role_setup.sql;
#输入准备好的用户ogg
#Grant the role that was created (default name is GGS_GGSUSER_ROLE) to all Oracle GoldenGate Extract users.
#根据上面执行结果的提示授权角色给ogg用户
SQL> grant GGS_GGSUSER_ROLE to ogg;
SQL> @ddl_enable.sql;
##To Install and Use the Optional Performance Tool
SQL> @ddl_pin ogg
至此，ddl语句的支持配置完成。
#验证DDL安装 --运行marker_status.sql校验DDL的状态
SQL> @marker_status.sql
------------------------------------
-- Removing the DDL Objects from the System
-- 卸载 DDL 复制 支持
-- cd $OGG_HOME
-- ggsci
-- ggsci> STOP EXTRACT group1
-- ggsci> STOP REPLICAT group1
--
-- sqlplus / as sysdba
-- SQL> @ddl_disable.sql;
-- SQL> @ddl_remove.sql
-- SQL> @marker_remove.sql
4.2 配置source db manager进程
--EXTRACT exoggs
--SETENV (ORACLE_HOME="/orabin/product/12.2.0.1")
--SETENV (ORACLE_SID = "OGGSDB")
进入GoldenGatean安装目录，创建工作区目录：
cd $OGG_HOME
./ggsci
GGSCI (dbserver) 1> create subdirs
Creating subdirectories under current directory /oradata/ogg
Parameter file /oradata/ogg/dirprm: created.
Report file /oradata/ogg/dirrpt: created.
Checkpoint file /oradata/ogg/dirchk: created.
Process status files /oradata/ogg/dirpcs: created.
SQL script files /oradata/ogg/dirsql: created.
Database definitions files /oradata/ogg/dirdef: created.
Extract data files /oradata/ogg/dirdat: created.
Temporary files /oradata/ogg/dirtmp: created.
Credential store files /oradata/ogg/dircrd: created.
Masterkey wallet files /oradata/ogg/dirwlt: created.
Dump files /oradata/ogg/dirdmp: created.
GGSCI (dbserver) 2>
--创建数据目录(可在dirdat目录下为 oggsdb的抽取进程创建一个单独数据存放目录 )
--cd $OGG_HOME
--oracle[/oradata/ogg]$mkdir -p dirdat/oggsdb
---- /oradata/ogg/dirdat/oggsdb
编辑配置manager参数文件 ：
GGSCI > edit params mgr
添加以下内容
PORT 7809
DYNAMICPORTLIST 7800-7900
ACCESSRULE, PROG , IPADDR 192.168.6.20, ALLOW
ACCESSRULE, PROG SERVER, ALLOW
--PURGEOLDEXTRACTS ./dirdat/oggsdb/ex, usecheckpoints, minkeephours 12 #### 参数 minkeepdays 2
PURGEOLDEXTRACTS ./dirdat//, usecheckpoints, minkeepdays 2 #### 同一台主机，源和目标库共用一个MGR
AUTORESTART EXTRACT *, RETRIES 5, WAITMINUTES 2, RESETMINUTES 60
lagreporthours 1
laginfominutes 30
lagcriticalminutes 45
*/
对需要的表添加trandata
cd $OGG_HOME
./ggsci
GGSCI > dblogin userid ogg@oggsdb password Password123
Successfully logged into database.
GGSCI > add trandata scott.emp
--info trandata scott.emp
--select * from DBA_LOG_GROUPS
4.3 配置source db extract进程
--select * from nls_database_parameters
添加一个extract进程 ：
GGSCI > add extract exggsdb,tranlog,begin now ----, threads 2
编辑extract参数文件：
GGSCI (dbserver) 13> edit params exggsdb
添加以下内容
extract exggsdb
setenv (ORACLE_SID = "OGGSDB")
setenv (NLS_LANG = "AMERICAN_AMERICA.AL32UTF8")
userid ogg@oggsdb, password Password123
TRANLOGOPTIONS DBLOGREADER
reportcount every 30 minutes, rate
discardrollover at 3:00
warnlongtrans 2h, checkinterval 300
exttrail /oradata/ogg/dirdat/oggsdb/ex
discardfile /oradata/ogg/dirdat/exggsdb.dsc, append, megabytes 100
--gettruncates ---- DDL support parameter
getupdatebefores
nocompressdeletes
nocompressupdates
--LOGALLSUPCOLS
dboptions allowunusedcolumn
fetchoptions nousesnapshot
fetchoptions fetchpkupdatecols
table SCOTT.EMP;
创建本地trail文件 ：
GGSCI > add exttrail /oradata/ogg/dirdat/oggsdb/ex, extract exggsdb
EXTTRAIL added.
4.4 配置source db pump进程
添加一个pump进程（本质上也是extract进程），并指定远程trail文件：
GGSCI > add extract ppggsdb,exttrailsource /oradata/ogg/dirdat/oggsdb/ex
EXTRACT added.
编辑pump参数文件：
GGSCI (dbserver) 16> edit params ppggsdb
添加以下内容
extract ppggsdb
passthru
rmthost 192.168.6.20, mgrport 7809 ---- target db主机ip，管理进程端口号 ##共用同一台主机的mgr进程 测试
rmttrail /oradata/ogg/dirdat/oggtdb/pp
--ddl -- DDL support parameter
table scott.emp;
指定远程trail文件：
GGSCI > add rmttrail /oradata/ogg/dirdat/oggtdb/pp, extract ppggsdb
RMTTRAIL added.
4.5 启动source进程
开一个命令行：
cd $OGG_HOME
tail -f 50 ggserr.log
再开一个命令行：
cd $OGG_HOME
./ggsci
GGSCI > info all
GGSCI > start mgr
GGSCI > start exggsdb
GGSCI > start ppggsdb
GGSCI > info all
##########同一台主机，两个oracle数据库测试(source --> target), 可以共用OGG MGR 进程?!
##########若 源数据库 和 目标数据库 在不同主机，目标端也需要安装OGG ，并配置OGG 数据目录。
- 配置target db
5.1 配置target db参数
5.1.1 创建GoldenGate用户
创建GoldenGate用户
create tablespace ogg_data datafile '/oradata/oggtdb/ogg_data01.dbf' size 50M autoextend on next 8M;
create user ogg identified by Password123 default tablespace ogg_data quota unlimited on ogg_data;
设置enable_goldengate_replication参数为true
alter system set enable_goldengate_replication = true scope = both;
授权GoldeGate用户 ：
grant connect, resource to ogg;
grant alter any table, alter system,alter user, create session, alter session to ogg;
grant select any dictionary, SELECT ANY TRANSACTION,select any table,flashback any table to ogg;
授权GoldeGate用户 ：
grant dba to ogg; ---- 支持DDL replicate配置
5.1.2 添加checkpoint表
GGSCI> edit params ./GLOBALS
添加以下内容
ggschema ogg
checkpointtable ogg.checkpoint
登陆target db添加checkpoint表
export ORACLE_SID=OGGTDB
./ggsci
GGSCI > dblogin userid ogg@OGGTDB, password Password123
Successfully logged into database.
GGSCI (dbserver as ogg@OGGTDB) > add checkpointtable ogg.checkpoint
Successfully created checkpoint table ogg.checkpoint.
5.1 配置target db manager进程
----编辑manager参数文件： ---- 同一台主机，两个oracle数据库，可以共用同一个 MGR
----GGSCI (dbserver as ogg@orcl) > edit params mgr
----#添加以下内容
----PORT 7809
----DYNAMICPORTLIST 7800-7900
----ACCESSRULE, PROG , IPADDR 192.168.6.20, ALLOW
----PURGEOLDEXTRACTS ./dirdat/oggtdb/, usecheckpoints, minkeepdays 2 #### 参数 minkeepdays 2 #minkeephours 12
----AUTORESTART ER *, RETRIES 5, WAITMINUTES 2, RESETMINUTES 60
----lagreporthours 1
----laginfominutes 30
----lagcriticalminutes 45
5.2 配置target db replicat进程
添加一个replicat进程 ：
GGSCI (dbserver) 2>
GGSCI (dbserver) 2>
GGSCI (dbserver as ogg@oggtdb) 4> add replicat repggtdb,exttrail /oradata/ogg/dirdat/oggtdb/pp
编辑replicat参数文件：
GGSCI (dbserver as ogg@oggtdb) 6> edit params repggtdb
添加以下内容
replicat repggtdb
setenv (ORACLE_SID = "OGGTDB")
setenv (NLS_LANG = "AMERICAN_AMERICA.AL32UTF8")
userid ogg@oggtdb, password Password123
dboptions deferrefconst
gettruncates
report at 06:00
reportcount every 30 minutes, rate
reportrollover at 02:00
--reperror default, abend
REPERROR DEFAULT,DISCARD
DBOPTIONS NOSUPPRESSTRIGGERS
--handlecollisions
allownoopupdates
--assumetargetdefs
discardfile /oradata/ogg/dirdat/oggtdb/repggtdb.dsc, append, megabytes 100
discardrollover at 02:00
--DDL
map scott.emp, target scott.emp;
----启动 MGR 和 REPLICATE 进程。
-
故障排查trouble shooting
-
测试case
