GoldenGate OGG Director 安装及配置文档
安装及配置文档
GoldenGate Director
安装及配置文档
1.1 概述
本章节所有文本均基于Oracle GoldenGate V10.4版本,主要描述GoldenGate Director的安装及配置使用。所有部署在生产系统的GoldenGate进程,均需要经过开发、测试小组严格认真的测试之后才可以进行部署。
1.2 GoldenGate Director概述
GoldenGate Director是GoldenGate的图形化监控管理软件,可以方便、集中管理多个GoldenGate实例。平安集团需要部署多个GoldenGate实例,每个实例部署在一个单独的服务器上,如果使用命令行方式进行监控和维护,则每次都需要登录到每个单独的服务器,极不方便。使用GoldenGate Director,只需要事先配置好连接,就可以在统一界面中监控所有的GoldenGate实例。Director提供了两种图形化监控客户端,一种是基于Web方式,另一种是基于C/S。
下图描述了GoldenGate Director各个组件及其关系:
GoldenGate Director 体系架构
- GoldenGate Instances是需要被管理的实例。Director可以方便管理多个GoldenGate实例。
- Director Server是Director服务端,需要部署在WebLogic Server下。Director服务器通过Monitor Agent和GoldenGate实例进行通信。
- Director Database用来存放Director Server资料库(Repository)。
- Director Administrator是管理Director Server的客户端工具,主要负责实例的注册和配置。
- Director Client是基于C/S模式的客户端,可以用于监控实例。
- Director Web是基于Web的客户端,可以通过统一的Web界面监控多个GoldenGate实例。
1.3 GoldenGate Director的安装
1.3.1 部署方案必需条件
1.3.1.1 Director服务器安装前提
硬件
可支持的操作系统
Windows NT/XP/2000/Vista
Solaris
AIX
Redhat Linux
HP-UX
1GB内存
1.5GB磁盘空间
安装过程需要设置HTTP端口,默认端口为7001
软件
JRE 6.0
WebLogic 11g(10.3.1),需在Director Server安装之前安装。
在Director安装之前,需要安装下列数据库之一,作为Director的资料库(Repository)。
MySQL 5.x 企业版
SQL Server 2000或2005
Oracle 9i或更高版本
在Unix/Linux下安装,XWindow必须可用。
至少需要分配200MB空间的数据库数据,作为资料库使用。
1.3.1.2 Director客户端安装前提
操作系统:可以支持JRE 6.0的Windows/Linux/Unix平台
安装JRE6.0
需要Window,或XWindow
对于基于Web的客户端,支持下列的浏览器
Microsoft Internet Explorer 5.0或者更高版本
Mozilla Firefox 1.3或者更高版本
Apple Safari 1.2或者更高版本
以下是典型的一个安装部署例子。
GoldenGate Director部署方案
1.3.2 安装GoldenGate Director Server
安装步骤如下:
- 执行安装程序,在弹出的欢迎界面上点Next。
- 选择安装目录。
- 输入WebLogic Server的安装目录,以及Domain Name(如GGMonitor)。
- 输入HTTP端口。
- 选择数据库类型。选择Oracle Database。
- 配置数据库连接。
- 配置数据库用户名和密码。
- 检查各项配置之后,就可以开始安装。
输入Weblogic Server安装目录
输入HTTP端口
选择数据库类型
配置数据库连接
配置数据库用户名和密码
1.3.3 安装GoldenGate Director Client
GoldenGate Director Client的安装非常简单。启动安装文件后,一路按照提示安装即可。
需要说明的是,GoldenGate Director Client中包含了管理工具(Director Admin)。需要通过管理工具对GoldenGate Director Server进行配置。
1.3.4 启动GoldenGate Director Server/Client
启动Director Server
启动Director Server之前,必须确保Director Database已经启动并正常运行。
启动步骤:
- 进入安装目录/domain
Unix/Linux平台
运行./startWebLogic.sh
Windows平台
运行startWebLogic.cmd
启动Director Admin
Unix/Linux平台
- 进入Client安装目录/GoldenGateDirector/bin
- 运行./run-admin.sh
Windows平台
进入到GoldenGate Director Client安装目录/ GoldenateDirector,打开GDSC Admin Tool.exe。
输入的用户/口令为admin/admin,server为Director Server的IP和端口,要确保Director Server已经启动。
启动基于C/S的Director客户端
Unix/Linux平台
- 进入Client安装目录/GoldenGateDirector/bin
- 运行./run-director.sh
Windows平台
进入到GoldenGate Director Client安装目录/ GoldenGateDirector,打开GoldenGate-Director.exe
输入的用户/口令为admin/admin,或者Director Admin创建的用户/口令,server为Director Server的IP和端口,要确保Director Server已经启动。
启动基于Web的Director客户端
启动浏览器,输入http://<Director server IP地址或域名>:<端口,默认为7001>/acon, 输入的用户/口令为admin/admin,或者Director Admin创建的用户/口令,要确保Director Server已经启动。
1.4 GoldenGate Director的配置使用
1.4.1 Director Admin
- 启动Director Admin,输入口令
- 创建监控管理用户
填写Account Info和Password,“Save”以保存。
- 创建监控GoldenGate实例
Director Administrator Tool配置界面
这里需要配置需要监管维护的GoldenGate实例。创建Data Source的过程如下:
Host Identity:
- Fully Qualified Domain Name : GoldenGate实例所在的服务器名
- Manager Port : GoldenGate实例MGR进程端口号
- Data Source Name :原则上可以填写任何名称。建议制定命名规范。
- 点击Check–Connection 验证连接。
GoldenGate Info:
- Host Operating System: 选择WU(即Windows/Unix意思)
- Database: 选择数据库类型。Oracle数据库应选择ORA。
- GoldenGate Version : 10.4
- 点击 “Save”,然后点击“Yes”。
从左侧的面板上选择刚才创建的Data Source(只在通过ODBC连接时才需要填写),填写完其他信息,包括:
Default DB Credential:
- DSN: 数据库实例名或服务名
- Username : 用户名
- Password & Confirm Password : 密码
Access Control:
- Owner : 选择admin(表示配置该数据源的owner为admin,也可以选择admin外的用户)
- 勾选Host is Observable选项(表示配置该数据源对其他用户可见,也可以不勾选)
- GoldenGate Version : 10.4
- 点击“Save”
1.4.2 基于Web的Director客户端
要进入Director Web界面,在浏览器里面输入网址:http://<system name>:<port>/acon。如:http://gg_director_server:7001/acon
<system name>是Director Server所在服务器的主机名或IP地址,<port>为安装时选择的端口号。要确保开启此端口号给Director Server专用。
首次进入Director Web,需要输入用户名和密码(默认为admin/admin)。进入之后的主界面如下图示:
Director Web 主界面
整个主界面分为三个区域:
左侧面板包含了所有GoldenGate实例的列表以及一些功能链接。
右侧上方按照GoldenGate实例分组列出了每个实例上所有进程的概况。
右侧下方列出了所选实例的事件日志。
1.4.2.1 监控整体运行情况
首先查看主界面左侧面板,点击一个实例左边的黑三角符号可以展开该实例,查看到具体的进程。右侧面板也会有相应的变化,列出该实例下所有进程的概要信息以及事件日志。
表示实例正在运行(MGR进程正常运行)
表示实例没有启动(MGR进程已停止)
表示进程正常运行
表示进程正常停止
表示进程非正常停止,需要进一步调查原因。同时会用红色的Abended字样标示。
1.4.2.2 监控进程状态
右侧上方的面板显示了每一个进程的概要信息。点击More Info查看详细的进程信息。
这里可以查看到进程报告文件、详细信息、历史延时情况以及被丢弃的记录。Discard File是进程用来存放丢弃记录的文件。如果该文件中有记录,需要详细查看记录情况,分析记录被丢弃的原因,并解决相关问题。
1.4.2.3 查看事件日志
主界面右侧下方是事件日志。
Info事件只是一般的事件,如收到stats命令等,不会对GoldenGate的正常运行造成影响。
Warning事件是有可能对GoldenGate造成影响的事件,如停止MGR进程等。
Error事件需要引起关注,表示有重大错误发生,已经影响到了GoldenGate的正常运行。
点击右上角的Filter按钮,把Show Information和Show Un-acknowledged Only两项勾选掉。这样,仅Warning和Error信息被显示出来,便于发现问题。
筛选事件类型
筛选后的情况
1.4.2.4 Email告警
开启Email告警功能需要事先部署一个Mail服务器。点击主界面左侧面板上My Email Alerts链接,在新窗口中填写以下信息:
- Alert Name:告警的名字
- Alert Type:有两种类型可供选择。
如果选择Process Lag,则需要指定一个时限,超过这个时限会引发告警。
如果选择Event Text,则需要指定Event Type(Error,Warning等),以及Event text中包含的文本。当Event消息中包含此文本时,会引发告警。支持通配符*。
- Process Name:进程名称,支持通配符*。
- Sent an email to:目标邮件地址
- With the subject:邮件标题
- From Address:发送方地址
- Mail server:邮件服务器,需要事先部署。
Email 告警
1.4.2.5 运行GGSCI命令
选择主界面右上方某个实例,点击实例下方的GGSCI图标,进入命令行交互页面。
在这里,可以输入各种命令,并显示输出结果。具体命令,请参考第二章内容。
GGSCI 交互页面
1.4.3 基于C/S的Director客户端
1.4.3.1 查看事件日志
和基于Web的方式类似,基于C/S的Director客户端集中多个GoldenGate实例的日志,可以进行排序、过滤等操作。
1.4.3.2 Email告警
和基于Web的方式类似,可以指定规则,将满足规则的日志信息通过email方式告警。
1.4.3.3 运行GGSCI命令
和基于Web的方式类似,可以在多个GoldenGate实例间切换执行ggsci命令,以管理GoldenGate。
1.5 参考文献
- 《Oracle GoldenGate Licensing Information Release 10.4》
- 《Oracle GoldenGate Director Administration Guide Version 2.0》
- 《Oracle GoldenGate Director Patch Set Notes 2.0.0 for Open Systems》
- 《Oracle GoldenGate Director 2.0 Release Notes》