OGG安装前需正确配置GGS_HOME和LD_LIBRARY_PATH环境变量，Manager进程须设置PORT、DYNAMICPORTLIST及AUTORESTART+AUTOBIND，Extract依赖FORCE LOGGING、EXTTRAIL路径权限、SELECT ANY DICTIONARY权限，19c与21c兼容需注意UNIFIED_AUDIT_TRAIL支持、ENABLE_DDL_LOGGING关闭及tnsnames.ora全限定服务名。

OGG 安装前必须确认的环境变量

oracle goldengate 依赖特定环境变量才能正常启动进程，ggs_home 和 ld_library_path 错一个，ggsci 就直接报 command not found 或 libnnz19.so: cannot open shared object file。

• GGS_HOME 必须指向解压后的根目录（如 /u01/app/ogg），不能带 trailing slash；设成 /u01/app/ogg/ 会导致部分脚本找不到 dirprm
• LD_LIBRARY_PATH 要包含 $GGS_HOME 和 Oracle 客户端库路径（如 $ORACLE_HOME/lib），顺序不能颠倒——OGG 自带的 libggjava.so 会优先加载自己目录下的 libnnz*.so，若 Oracle 库在前，版本不匹配就 core dump
• 别把 PATH 里的 $GGS_HOME 写成相对路径或软链真实路径；ggsci 启动时会用 readlink -f $0 推导 GGS_HOME，链路断裂就 fallback 到当前目录

配置 Manager 进程必须改的三个参数

Manager 不是配完就能跑，缺一不可：端口冲突、动态端口范围、日志轮转失控，三者占其一，start mgr 就卡住或秒退。

• PORT 建议避开 7809（默认）——很多企业防火墙只放行 1521/22/80，临时开个新端口不如直接改到 1530；写成 PORT 1530，别加 port 或引号
• DYNAMICPORTLIST 必须显式设置，比如 DYNAMICPORTLIST 1531-1540；否则 Extract 报 ERROR OGG-01223 Unable to bind to port，因为内部辅助端口随机失败
• AUTORESTART 和 AUTOBIND 要配套：只开 AUTORESTART 不设 AUTOBIND，进程重启后可能绑定不到原端口；推荐写全 AUTORESTART EXTRACT *, RETRIES 3, WAITMINUTES 2 + AUTOBIND dynamic

Extract 进程启动失败最常见的三个原因

不是权限问题，也不是归档没开，而是配置和 Oracle 环境之间有三处隐性对齐要求没满足。

• 数据库必须开启 FORCE LOGGING 且 ADD SUPPLEMENTAL LOG DATA；只开 LOGGING 不够，ALTER DATABASE ADD SUPPLEMENTAL LOG DATA 缺了就报 OGG-01163 Bad column length（尤其碰到 VARCHAR2(4000)）
• EXTTRAIL 路径必须在 GGS_HOME 下且有写权限，不能写成 /tmp/dirdat/et；OGG 会自动创建子目录，但父目录 dirdat 必须存在且属主为运行用户
• Oracle 用户需被显式授予 SELECT ANY DICTIONARY（不只是 SELECT_CATALOG_ROLE），否则 INFO EXTRACT 显示 STATUS: ABENDED，查 ggserr.log 才看到 ORA-00942: table or view does not exist（实际是访问 DBA_LOG_GROUPS 权限不足）

OGG 19c 与 Oracle 21c 兼容的关键检查点

官方文档说支持，但实际部署中两个细节不处理，Extract 一拉取就 hang 在 RECORDS 计数上。

• OGG 19.1.0.0.0 及之后版本才真正支持 Oracle 21c 的 UNIFIED_AUDIT_TRAIL 模式；旧版会反复重试解析审计记录，CPU 拉满但无数据输出
• 必须关闭 Oracle 21c 的 ENABLE_DDL_LOGGING=FALSE（默认为 TRUE）；OGG 解析 DDL 时依赖 DBA_SOURCE，而开启该参数后部分 DDL 不落表，导致 ADD TRANDATA 失败且无明确报错
• tnsnames.ora 中服务名不能用短名（如 ORCL），必须带域名（如 ORCL.example.com）；21c 默认启用 SQLNET.ALLOWED_LOGON_VERSION_SERVER=12a，短名解析触发兼容性降级，连接延迟超 30 秒后 Extract 主动断连

OGG 的坑不在安装包本身，而在它和 Oracle 实例之间那些没写进 checklist 的握手细节。比如 ADD SCHEMATRANDATA 成功不代表真生效——得查 DBA_LOG_GROUPS 里有没有对应条目，否则上线第一天就丢数据。