下面文章的部分內容來網路，但所有內容都經過自己的測試、整理、補充。

目錄概要

1.1概述

1.2GoldenGate Director概述

1.3GoldenGate Director的安裝.

1.3.1部署方案必需條件..

1.3.1.1Director伺服器安裝前提

1.3.1.2Director客戶端安裝前提

1.3.2安裝GoldenGate Director Server

1.3.3安裝GoldenGate Director Client

1.3.4啟動GoldenGate Director Server/Client

1.4GoldenGate Director的配置使用

1.4.1

Director Admin.

1.4.2基於Web的Director客戶端.

1.4.2.1監控整體執行情況.

1.4.2.2監控程序狀態.

1.4.2.3檢視事件日誌.

1.4.2.4Email告警

1.4.2.5執行GGSCI命令

1.4.3基於C/S的Director客戶端

1.4.3.1檢視事件日誌

1.4.3.2Email告警.

1.4.3.3執行GGSCI命令.

1.5參考文獻.

1.1概述

本章節所有文字均基於Oracle GoldenGate版本，主要描述GoldenGate Director的安裝及配置使用。所有部署在生產系統的GoldenGate程序，均需要經過開發、測試小組嚴格認真的測試之後才可以進行部署。

1.2 GoldenGate Director概述

GoldenGate Director是GoldenGate的圖形化監控管理軟體，可以方便、集中管理多個GoldenGate例項。平安集團需要部署多個GoldenGate例項，每個例項部署在一個單獨的伺服器上，如果使用命令列方式進行監控和維護，則每次都需要登入到每個單獨的伺服器，極不方便。使用GoldenGate Director，只需要事先配置好連線，就可以在統一介面中監控所有的GoldenGate例項。Director提供了兩種圖形化監控客戶端，一種是基於Web方式，另一種是基於C/S。

   下圖描述了GoldenGate Director各個元件及其關係：

GoldenGate Director 體系架構

1)       GoldenGate Instances是需要被管理的例項。Director可以方便管理多個GoldenGate例項。

2)       Director Server是Director服務端，需要部署在WebLogic Server下。Director伺服器通過Monitor Agent和GoldenGate例項進行通訊。

3)       Director Database用來存放Director Server資料庫（Repository）。

4)       Director Administrator是管理Director Server的客戶端工具，主要負責例項的註冊和配置。

5)       Director Client是基於C/S模式的客戶端，可以用於監控例項。

6)       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, 10.3.2, 10.3.3),需在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或者更高版本

以下是典型的一個安裝部署例子。

注意：對於下面的例子，右邊應該也是windows伺服器

GoldenGate Director部署方案

1.3.2 安裝GoldenGate Director Server

安裝環境：

作業系統：Windows 2008 R2 Enterprise 64bit

Director版本：gg-director-serversetup_win_v11_1_1_1_0_001

JRE版本：JavaSetup6u31_32bit.exe

JDK版本：jdk-6u30-windows-x64.exe

Weblogic版本：wls1032_generic.jar

Weblogic安裝見：

安裝步驟如下：

1．  執行安裝程式，在彈出的歡迎介面上點Next。

2．  選擇安裝目錄。

3．  輸入WebLogic Server的安裝目錄，以及Domain Name(如GGMonitor)。

4．  輸入HTTP埠。

5．  選擇資料庫型別。選擇Oracle Database。

6．  配置資料庫連線。

7．  配置資料庫使用者名稱和密碼。

8．  檢查各項配置之後，就可以開始安裝。

 

 

輸入Weblogic Server安裝目錄

 

輸入HTTP埠

選擇資料庫型別

 

配置資料庫連線

安裝之前要建立director的管理使用者

User_id:gg_director

Password:password123

SQL> create user gg_director identified by password123 default tablespace users;

SQL> grant resource,connect,create view to gg_director;

配置資料庫使用者名稱和密碼

 

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已經啟動並正常執行。

 啟動步驟：

1)       進入安裝目錄/domain

Unix/Linux平臺

執行./startWebLogic.sh

Windows平臺

執行startWebLogic.cmd

啟動Director Admin

Unix/Linux平臺

1）  進入Client安裝目錄/GoldenGateDirector/bin

2）  執行./run-admin.sh

Windows平臺

進入到GoldenGate Director Client安裝目錄/ GoldenGateDirector，開啟GDSC Admin Tool.exe。

    輸入的使用者/口令為admin/admin，server為Director Server的IP和埠（圖1），要確保Director Server已經啟動。

圖1

 

啟動基於C/S的Director客戶端

Unix/Linux平臺

1）  進入Client安裝目錄/GoldenGateDirector/bin

2）  執行./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的配置使用

基於“GoldenGate之Win平臺ora-ora單向複製實驗(原).doc”文件配置

1.4.1 Director Admin

1)      啟動Director Admin，輸入口令

2)      建立監控管理使用者

填寫Account Info和Password，“Save”以儲存。

3)      建立監控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 : 11.1.1.1

§           點選 “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 : 11.1.1.1

§           點選“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例項分組列出了每個例項上所有程序的概況。

右側下方列出了所選例項的事件日誌。

監控整體執行情況

首先檢視主介面左側面板，點選一個例項左邊的黑三角符號可以展開該例項，檢視到具體的程序。右側面板也會有相應的變化，列出該例項下所有程序的概要資訊以及事件日誌。

表示例項正在執行（MGR程序正常執行）

表示例項沒有啟動（MGR程序已停止）

表示程序正常執行

表示程序正常停止

表示程序非正常停止，需要進一步調查原因。同時會用紅色的Abended字樣標示。  

右側上方的面板顯示了每一個程序的概要資訊。點選More Info檢視詳細的程序資訊。

這裡可以檢視到程序報告檔案、詳細資訊、歷史延時情況以及被丟棄的記錄。Discard File是程序用來存放丟棄記錄的檔案。如果該檔案中有記錄，需要詳細檢視記錄情況，分析記錄被丟棄的原因，並解決相關問題。

主介面右側下方是事件日誌。

Info事件只是一般的事件，如收到stats命令等，不會對GoldenGate的正常執行造成影響。

Warning事件是有可能對GoldenGate造成影響的事件，如停止MGR程序等。

Error事件需要引起關注，表示有重大錯誤發生，已經影響到了GoldenGate的正常執行。

點選右上角的Filter按鈕，把Show Information和Show Un-acknowledged Only兩項勾選掉。這樣，僅Warning和Error資訊被顯示出來，便於發現問題。

篩選事件型別

篩選後的情況

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 告警

選擇主介面右上方某個例項，點選例項下方的GGSCI圖示，進入命令列互動頁面。

在這裡，可以輸入各種命令，並顯示輸出結果。具體命令，請參考第二章內容。

GGSCI 互動頁面

 

1.4.3 基於C/S的Director客戶端

建流程圖管理程序

1.       新建流程圖

在開啟Director客戶端登入後，在選單欄裡的File-->New diagram，輸入流程圖名：gg01

建完後會在軟體面板的上半部分

2.       部署各資料來源程序

把面板下半部分左側的三個資料來源的圖示拖到面板上部分的空白處，此時會自動形成一個完整的流程圖。如果流程圖比較複雜，還需要手工拖動整理一下，使其看上去更加流暢。

如下圖：

注意：

A.此流程圖是根據“GoldenGate之Win平臺ora-ora單向複製實驗(原).doc”文件部署的。

B.有一個源例項orcl_source，對應著兩個目標例項oratask、vmstest

C.由於director不能正常的連線目標源例項vmtest (具體問題見“遇到的問題2”)，所以此例項不能正確部署在流程圖裡。

3.       建立和修改程序

單擊資料來源圖示的右鍵，點new capture可以建立一個extract程序。

然後出現建立對話方塊

在下方右側parameters頁可以修改mgr程序引數：

同樣，用上面的方法可以修改配置map,trail,pump,remote taril,replicat程序等。

和基於Web的方式類似，基於C/S的Director客戶端集中多個GoldenGate例項的日誌，可以進行排序、過濾等操作。

Email告警

和基於Web的方式類似，可以指定規則，將滿足規則的日誌資訊通過email方式告警。

 

和基於Web的方式類似，可以在多個GoldenGate例項間切換執行ggsci命令，以管理GoldenGate。

1.5 遇到的問題

1. Director v2.0 installer fails with error "Unable t

安裝過程中出現：

Symptoms

After installing JDK 6 and WebLogic Server 10.3.1, I started the GG Director v2.0 server installation. The installation started off but did not complete successfully. The error I get is -"Unable to run run-cds-tool script" .

Cause

The error "Unable to run run-cds-tool script file" can be caused by a couple of different reasons.  When you get to this point, before you click OK, check the cds-tool-error.log which should be in the <weblogic install>\wlserver_10.3\server\bin directory. If you click OK, this file will be dropped and you won't be able to see what the root cause of the problem is.

Solution

You don't need to create a Weblogic domain prior to running the Director install. The Director installer expects the default Weblogic admin password to be available and it will display this error if it is not available. If the Weblogic admin password has been changed from the default, change it back to the defaultor uninstalling Weblogic and reinstalling withoutany configuration of Weblogic. The Director installer will create the domain it needs.

The error can also be caused when the installer cannot access the database to install the Director database repository. Make sure that the database connection credentials supplied in the install are correct and that the database is up and available for logon.

解決：

最後發現確實是由於安裝時連線資料庫的問題，在安裝之前沒有建立director的管理使用者gg_director，所以連線失敗。

2.連線某個goldengate target目標例項失敗

Checking connection to: 192.168.1.100:7500

Test is running directly from Director Server.

Opening GGSCI connection...

Connection was successful.

Sending AllStat command...

GGSCI Connection error: EOF from GGSCI - unexpected end of stream.Closing connection...

Closed. All done.

 

Web監控頁面：例項沒有啟動

 

但repl程序的狀態還是正常的

解決：

3.

Failed to get login context.Perhaps your etc/gdsc-client-login.conf file is missing? :javax.security.auth.login.LoginException: java.net.ConnectException:

 t3://172.16.64.75:7001: Destination unreachable; nested excepion is: java.net.ConnectException: connection refused: connect; No available router to destination

 

ID 973711.1

Applies to:
Management Pack for Oracle GoldenGate - Version: 1.4.0.6 and later [Release: 1.4 and later ]
Information in this document applies to any platform.

Symptoms
ISSUE:

Logging on to the v2.0 Director GDSC Admin Tool or Director Client using User Name: admin Password: admin and Server: hostname is giving me an error:

"Failed to get login context. Perhaps your etc/gdsc-client.conf file is missing? : javax.security.auth.login.LoginException:java.net.ConnectException: t3:/andross: No known valid part for : 'Default[t3]:t3(t3):null:-1:153.64.202.209:-1', No available router to destination "

Cause
Director v2.0 requires the http port included in the Server string: <hostname>:<http port>

Solution
When logging on using the v2.0 Director Admin Tool or Director Client, the Server name entry must include the http port. So the string entered for Server should include:

<hostname where director server is installed>:<http port>

ie:

andross:7001

or if it is the current host:

localhost:7001

啟動weblogic後,再嘗試登入仍報下面的錯誤：

Make sure you start WebLogic from the directory created by Director Server install, **NOT** from the Oracle Middleware home.

For example, from /u01/oracle/gg-director/domain/bin
run ./startWebLogic.sh

Failed to get login context.Perhaps your etc/gdsc-client-login.conf file is missing? :javax.security.auth.login.LoginException: User: admin, failed to be authenticated

無解。。。

1)       《Oracle GoldenGate Licensing Information Release 10.4》

2)       《Oracle GoldenGate Director Administration Guide Version 2.0》

3)       《Oracle GoldenGate Director Patch Set Notes 2.0.0 for Open Systems》

4)       《Oracle GoldenGate Director 2.0 Release Notes》