
1. Oracle GoldenGate Director 12.1.2 安装前先把这几个坑填了Oracle GoldenGate Director 12.1.2 是一套用来集中管理多个 GoldenGate 实例的 Web 控制台跑在 WebLogic 上适合手里有十几套甚至几十套 OGG 抽取、投递链路靠命令行ggsci一个个连已经管不过来的 DBA 和运维。它本身不搬数据只做配置下发、进程启停、状态监控和日志查看所以装它的核心难点不在 Director 本身而在前置的数据库游标、资料库用户、WebLogic 版本匹配以及 OGG 实例侧的远程访问参数。我这次装的环境是 Oracle 数据库 12c 作为资料库WebLogic 10.3.6Director Server 和 Client 都是 12.1.2.0.2操作系统是 Linux。踩过的坑集中在三处一是 WebLogic 版本选错12.1.3 装完启动直接报用户密码认证失败二是 OGG 12c 实例没加_DISABLEFIX21427144Director 连不上远端 Manager三是资料库用户密码策略没注意纯数字密码建用户时被拒。下面按安装顺序把每一步的可复制命令和参数模板给出来最后再讲怎么用 TaoToken 的统一 Key 把 AI 辅助排障接进这套环境。先明确一个前提Director 的 Server 端要连数据库存元数据Client 端是图形工具两者可以装在同一台机器也可以分开。本文按同机部署写路径统一用/ggdirServer和/ggdclientClientWebLogic 装在/wls11g全部用 oracle 用户操作避免权限混乱。2. 前置准备游标数、资料库用户、WebLogic 版本2.1 调大 open_cursorsDirector 连资料库时会开不少游标官方建议开到 2000。先查当前值SQL show parameter open_cursors;如果还是默认的 300直接改SQL alter system set open_cursors2000 scopeboth; System altered.scopeboth保证重启后依然生效别只改 memory。2.2 建资料库表空间和用户Director 的元数据表会由安装程序自动建但表空间和用户得先准备好。表空间给 5G 起步自动扩展SQL create tablespace ogg_director 2 datafile /oracle/oradata/orcl/ogg_director01.dbf 3 size 5g autoextend on next 128m; Tablespace created. SQL create user diradmin identified by Dir2024abc 2 default tablespace ogg_director; User created. SQL grant dba to diradmin; Grant succeeded.注意密码这里我实测纯数字或纯字母在部分 12c 密码策略下会报ORA-28003用「字母数字」组合最稳。grant dba是官方文档要求的Director 安装时要建表、建索引、插初始数据权限不够会在cds-tool.log里报错回滚。2.3 WebLogic 版本必须卡在 10.3.x这是最容易翻车的一步。官方兼容列表里 Director 12.1.2 对应 WebLogic 10.3 到 10.3.6我试过装 12.1.3WebLogic 启动时直接抛用户密码认证失败域根本起不来。所以老老实实下wls1036_generic.jar[oracleoggjk soft]$ java -jar wls1036_generic.jar Extracting 0%..........................................................100%图形安装一路下一步不要在这一步创建域域交给 Director 安装程序自己生成否则路径和配置对不上。装完确认一下目录[oracleoggjk soft]$ ls /wls11g/wlserver_10.32.4 OGG 实例侧加远程访问参数如果被管理的 OGG 是 12c 版本Director Server 从 Linux 去连远端 Manager 会被挡。需要在 OGG 的GLOBALS文件里加一行_DISABLEFIX21427144然后在dirprm/mgr.prm里加访问规则把 Director Server 的 IP 放行ACCESSRULE, PROG *, IPADDR 10.136.3.152, PRI 1, ALLOW改完必须重启 Manager 才生效GGSCI stop mgr GGSCI start mgr这一步不做后面 Director 里加数据源会一直显示连接超时日志里看不到明确报错很容易误判成网络问题。3. TaoToken 统一 Key 接入给排障加个 AI 通道装 Director 的过程中会遇到各种日志报错cds-tool-error.log、WebLogic 的server.log、OGG 的ggserr.log靠人肉翻很费时间。我的做法是把 TaoToken 的统一 Key 接进来用它的 API 通道做日志分析和配置校验一个 Key 走多个模型不用在每台机器上分别配不同厂商的凭证。TaoToken 的定位是统一模型接入层官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。先在控制台建 Key控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite拿到 Key 之后在运维机上建一个settings.json把 Director 排障常用的模型通道配好。这个文件不是 Director 自己的配置是给本地 AI 辅助工具读的放在/home/oracle/.config/ogg-director-ai/settings.json{ provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, models: { log_analysis: claude-sonnet, config_review: gpt-4o, quick_qa: claude-haiku }, context: { director_home: /ggdir, weblogic_home: /wls11g/wlserver_10.3, ogg_home: /ogg }, log_paths: [ /ggdir/cds-tool-error.log, /ggdir/cds-tool.log, /ggdir/domain/servers/AdminServer/logs/server.log ] }base_url只写https://taotoken.net/api不要带 UTM 参数那是给网页链接用的。models里三个通道按场景分日志分析用长上下文模型配置审查用推理强的快速问答用轻量的省额度。配好之后用 curl 验证 Key 通不通curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-haiku, messages: [{role:user,content:回复 OK 两个字母即可}] }返回里有content: OK就说明通道正常。这一步单独验证很重要别等排障时才发现 Key 或网络有问题。4. 安装 Director Server 与 Client命令行方式全流程4.1 安装 Director Server上传gg-director-serversetup_unix_v12_1_2_0_2.zip解压后给.sh加执行权限用-c走命令行安装[oracleoggjk server]$ chmod x gg-director-serversetup_unix_v12_1_2_0_2.sh [oracleoggjk server]$ ./gg-director-serversetup_unix_v12_1_2_0_2.sh -c交互过程中几个关键输入提示项输入值说明Installation Location/ggdirDirector 安装目录Weblogic Location/wls11gWebLogic 的 homeHTTP Port7001控制台端口Database3选 Oracle DatabaseServer Host Name10.136.3.152必须写 IP 或域名别用 localhostSID/Service Name2然后orcl选 Service NameDatabase Port1521监听端口User IDdiradmin资料库用户PasswordDir2024abc字母数字安装过程会解压gdsc-server.ear、domain.jar、各数据库的建表脚本。如果中途失败安装程序会回滚去/ggdir下看cds-tool-error.log和cds-tool.log定位原因常见的是资料库连不上或权限不足。装完检查目录[oracleoggjk ggdir]$ ls cds_current_db_config.xml cds-tool-error.log cds-tool.log domain domain-new.jar ggs.url installDirSvc.cmd uninstall4.2 安装 Director ClientClient 是图形工具同样命令行装[oracleoggjk client]$ chmod x gg-director-clientsetup_unix_v12_1_2_0_2.sh [oracleoggjk client]$ ./gg-director-clientsetup_unix_v12_1_2_0_2.sh -c安装目录填/ggdclient符号链接目录用默认/usr/local/bin。装完bin下有两个脚本run-admin.sh管理工具用来加管理账号、注册 OGG 数据源run-director.sh日常管理界面启停进程、看状态4.3 启动 Director Server进域目录后台启动 WebLogic[oracleoggjk ggdir]$ cd /ggdir/domain [oracleoggjk domain]$ nohup ./startWebLogic.sh 启动日志会写到servers/AdminServer/logs/server.log等看到Server started in RUNNING mode就绪。访问地址http://10.136.3.152:7001/acon默认账号密码admin/admin第一次登录后立刻改掉。5. 连通性验证与日志检查5.1 验证 WebLogic 控制台浏览器打开http://10.136.3.152:7001/acon能出登录页说明 Server 端正常。如果 404检查gdsc-server.ear是否部署成功去 WebLogic 控制台http://10.136.3.152:7001/console看 Deployments 状态。5.2 验证资料库连接Director 的元数据都在diradmin用户下连上去数一下表SQL conn diradmin/Dir2024abcorcl SQL select count(*) from user_tables;表数量在几十张量级如果为 0说明安装时建表脚本没跑成功回看cds-tool.log。5.3 验证 OGG 数据源连通启动 Client 管理工具[oracleoggjk bin]$ ./run-admin.sh在界面里添加数据源填 OGG 所在主机、Manager 端口默认 7809、OGG Home 路径。保存后如果状态是绿色说明_DISABLEFIX21427144和ACCESSRULE都生效了。红色或超时先telnet 目标IP 7809确认端口通再回查mgr.prm。5.4 用 TaoToken 通道分析日志把报错日志丢给配好的通道比如查 WebLogic 启动失败原因curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [{ role: user, content: 以下是 WebLogic 启动日志片段请指出导致启动失败的关键错误行并给出排查方向\nAuthentication denied: Boot identity not valid }] }返回会直接定位到认证失败提示检查boot.properties或域的用户名密码。这比在几千行日志里翻快得多。需要长期做编码和 Agent 类任务的可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。6. 本篇常见报错排查WebLogic 启动报用户密码认证失败九成是 WebLogic 版本不对12.1.3 换回 10.3.6。检查/wls11g/wlserver_10.3的版本号。Director 安装回滚cds-tool-error.log 报 ORA-01031diradmin权限不够确认grant dba执行了且表空间有剩余空间。Client 连不上数据源状态一直超时先确认 OGG 侧GLOBALS加了_DISABLEFIX21427144mgr.prm的ACCESSRULEIP 写的是 Director Server 的 IP改完重启 Manager。访问 /acon 报 503WebLogic 域没完全启动看server.log最后几行通常是资料库连接池初始化失败回查cds_current_db_config.xml里的连接串。TaoToken 调用返回 401Key 没带对或过期去 API Keys 页面重新生成https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。整套装下来最花时间的不是 Director 本身而是前置的版本匹配和 OGG 侧参数。把 WebLogic 卡在 10.3.6、资料库用户密码用字母加数字、OGG 实例加远程访问规则这三件事做对后面基本一路顺。日志分析接上 TaoToken 之后遇到报错先让模型定位关键行再针对性查文档比盲翻日志省一半时间。