OGG jagentをOGG Monitor Agent 12.1.3にアップグレードする手順

Oracle GoldenGate（OGG）Monitor Agent（通称：jagent）は、GoldenGateインスタンスに関する情報を収集し、Oracle GoldenGate Monitor ServerやEnterprise Manager Plug-In for Oracle GoldenGateへ送信する重要なコンポーネントです。本記事では、OGG 12c環境のjagentを最新バージョンである12.1.3へアップグレードする具体的な手順を、スクリーンショット付きでわかりやすく解説します。

既存のOGG 12c jagentのインストールとアップグレード

V44427-01.zipファイルを解凍します。解凍により、インストーラー本体であるfmw_12.1.3.0.0_ogg.jarが出力されます。
```
-rwxr-xr-x   1 oracle  oinstall 435392820 Jun 18  2014 fmw_12.1.3.0.0_ogg.jar
```

$JAVA_HOMEおよび$JAVA_HOME/binが正しく設定されていることを確認し、次のコマンドでJavaのバージョンが1.7以降であることもチェックしてください。

/nbcogg/goldengate <s0931> java -version
java version "1.8.0_45"
Java(TM) SE Runtime Environment (build 1.8.0_45-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.45-b02, mixed mode)
/nbcogg/goldengate <s0931>

以下のJavaコマンドを実行し、Oracle Universal Installer（OUI）インストーラーを起動します。

/nbcogg/goldengate <s0931> java -jar -Xmx1024m /nbcogg/goldengate/fmw_12.1.3.0.0_ogg.jar
Launcher log file is /var/tmp/OraInstall2015-07-08_08-17-57AM/launcher2015-07-08_08-17-57AM.log.
Extracting files....................................................
Starting Oracle Universal Installer

OUIの起動画面は以下のようになります。

OGG jagentをOGG Monitor Agent 12.1.3にアップグレードする手順

続いて、Oracleホームディレクトリの配置場所を指定します。

「Oracle GoldenGate Monitor Agent」を選択し、次へ（Next）をクリックします。

対象OS固有の前提条件チェックが実行されます。問題がないか確認しましょう。

次の画面では、インストール対象の機能一覧と使用されるディスク容量が表示されます。

インストールの進行状況は以下のように表示されます。

インストールが完了すると、完了メッセージが表示されます。

インストール後の作業

まず、以下のコマンドでjagentの状態を確認し、停止させます。

/testogg<s0931> ./ggsci
Oracle GoldenGate Command Interpreter for Oracle
Version 11.2.1.0.17 17888650 OGGCORE_11.2.1.0.0OGGBP_PLATFORMS_131215.2328_FBO
Solaris, sparc, 64bit (optimized), Oracle 11g on Dec 16 2013 16:59:28
Copyright (C) 1995, 2013, Oracle and/or its affiliates. All rights reserved.
GGSCI (oracle.test.com) 1> info all

Program     Status     Group       Lag at Chkpt  Time Since Chkpt

MANAGER     RUNNING
JAGENT      STOPPED
EXTRACT     RUNNING    ETKX01      00:00:00      00:00:01
EXTRACT     RUNNING    EXTTK01     00:00:00      00:00:06
EXTRACT     RUNNING    PMPTK01     00:00:00      00:00:07
EXTRACT     RUNNING    PTKX01      00:00:00      00:00:05

-rwxr-x---   1 oracle  oinstall     152 Jan  8  2014 create_ogg_agent_instance.sh

/testogg<s0931> ps -ef |grep jagent
oracle    8880   871   0 08:33:42 pts/1       0:00 grep jagent

注意： 万一、jagentのプロセスが残存している場合は、kill -9コマンドで強制終了してください。

次に、create ogg agentスクリプトを実行してエージェントインスタンスを作成します。

/nbcogg/goldengate/GoldenGate/oggmon/ogg_agent <s0931> ./create_ogg_agent_instance.sh
Please enter absolute path of Oracle GoldenGate home directory : /testogg
Please enter absolute path of OGG Agent instance : /testogg
OGG Agent instance directory already exists, do you want to overwrite the contents (yes | no) : yes
Sucessfully created OGG Agent instance.
/nbcogg/goldengate/GoldenGate/oggmon/ogg_agent <s0931>

/testogg/dirjar <s0931> ls -lart *jagent.jar*
-rw-r-----   1 oracle  oinstall  255338 Dec 16  2013 jagent.jar
/testogg/dirjar <s0931>

/testogg/cfg <s0931> vi Config.properties

####################################################################
## jagent backward compatibility                                 ###
####################################################################
jagent.backward.compatibility=false

####################################################################
## jagent SSL Enabled property                                   ###
####################################################################
jagent.ssl=false

以下のコマンドで、稼働中のすべてのサービスを停止します。

GGSCI (oracle.test.com) 4> stop ETKX01

Sending STOP request to EXTRACT ETKX01 ...
Request processed.

GGSCI (oracle.test.com) 5> stop EXTTK01

Sending STOP request to EXTRACT EXTTK01 ...
Request processed.

GGSCI (oracle.test.com) 6> stop PMPTK01

Sending STOP request to EXTRACT PMPTK01 ...
Request processed.

GGSCI (oracle.test.com) 7> stop PTKX01

Sending STOP request to EXTRACT PTKX01 ...
Request processed.

GGSCI (oracle.test.com) 8> info all

Program     Status      Group       Lag at Chkpt  Time Since Chkpt

MANAGER     STOPPED
JAGENT      STOPPED
EXTRACT     STOPPED     ETKX01      00:00:00      00:00:18
EXTRACT     STOPPED     EXTTK01     00:00:00      00:00:13
EXTRACT     STOPPED     PMPTK01     00:00:00      00:00:08
EXTRACT     STOPPED     PTKX01      00:00:00      00:00:04

続いて、各サービスを起動し、正常に動作しているか検証を行います。

注意： 検証を複数回実行すると、jagentのステータスが「STOPPED」と表示されることがあります。これは既知の挙動であり、後述するconfigプロパティの修正によって解消できます。

GGSCI (oracle.test.com) 17> info all

Program     Status     Group       Lag at Chkpt  Time Since Chkpt

MANAGER     RUNNING
JAGENT      RUNNING
EXTRACT     RUNNING    ETKX01      00:00:00      00:00:04
EXTRACT     RUNNING    EXTTK01     00:00:00      00:00:01
EXTRACT     RUNNING    PMPTK01     00:00:00      00:00:05
EXTRACT     RUNNING    PTKX01      00:00:00     00:00:05

GGSCI (oracle.test.com) 18> info all

Program     Status     Group       Lag at Chkpt  Time Since Chkpt

MANAGER     RUNNING
JAGENT      STOPPED
EXTRACT     RUNNING    ETKX01      00:00:00      00:00:08
EXTRACT     RUNNING    EXTTK01     00:00:00      00:00:04
EXTRACT     RUNNING    PMPTK01     00:00:00      00:00:08
EXTRACT     RUNNING    PTKX01      00:00:00      00:00:08

jagentのログでエラー内容を確認するには、以下のコマンドを実行します。

/testogg/logs <s0931> more ogg_agent.log
[2015-07-08T08:48:12.305-07:00] [JAGENT] [NOTIFICATION] [OGGMON-20244] [com.goldengate.monitor.jagent.JAgentWSMain] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] About to call initialize on the WebService
[2015-07-08T08:48:12.475-07:00] [JAGENT] [NOTIFICATION] [OGGMON-20245] [com.goldengate.monitor.jagent.JAgentWSMain] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] Loading agent-spring-ws.xml ###############
[2015-07-08T08:48:15.086-07:00] [JAGENT] [NOTIFICATION] [OGGMON-20593] [com.goldengate.monitor.jagent.config.impl.ConfigFilesHelper] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] JAgent config.dir system property is set, and the configuration is pointed to /export/home/oracle/testogg/cfg location.
[2015-07-08T08:48:15.088-07:00] [JAGENT] [NOTIFICATION] [OGGMON-20594] [com.goldengate.monitor.jagent.config.impl.ConfigFilesHelper] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] JAgent configuration of checkpoint file absolute path: /export/home/oracle/testogg/cfg/../dirchk/agent.cpm
[2015-07-08T08:48:15.088-07:00] [JAGENT] [NOTIFICATION] [OGGMON-20595] [com.goldengate.monitor.jagent.config.impl.ConfigFilesHelper] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] JAgent default configuration of checkpoint file absolute path: /export/home/oracle/testogg/cfg/../cfg/agent.cpm
[2015-07-08T08:48:15.097-07:00] [JAGENT] [NOTIFICATION] [OGGMON-20028] [com.goldengate.monitor.jagent.config.impl.AgentInfoImpl] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] Using IP address 3.156.4.153 to connect to the Manager Web Service
[2015-07-08T08:48:15.099-07:00] [JAGENT] [NOTIFICATION] [OGGMON-20029] [com.goldengate.monitor.jagent.config.impl.AgentInfoImpl] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] Reading Manager port 7810 from mgr.prm file.
[2015-07-08T08:48:17.361-07:00] [JAGENT] [ERROR] [OGGMON-20016] [com.goldengate.monitor.jagent.config.impl.AgentInfoImpl] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] Monitor Server JMX password is not defined. Please run Wallet Utility to create Monitor Server JMX password.
[2015-07-08T08:48:17.372-07:00] [JAGENT] [NOTIFICATION] [OGGMON-20247] [com.goldengate.monitor.jagent.JAgentWSMain] [tid: main] [ecid: 0000KtiM_kHESOsDCjCCwg1LbKOw000001,0] Error Initializing JAgent. JAgent will not be initialized and about to return. , [[org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'agentBootstrapper': Injection of resource dependencies failed; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'agentInfo': Invocation of init method failed; nested exception is java.lang.Exception: One ore more Java Agent properties in Config.properties file are not defined properly. Check ggserr.log file for more detail. Correct the error in the Config.properties file and restart the Manager.

Enterprise Manager（OEM）と連携する場合は、/export/home/oracle/testogg/cfg/Config.propertiesを編集し、agent.type.enabled=OGGMONの記述をagent.type.enabled=OEMに変更してください。

設定変更が完了したら、Managerを再起動し、すべてのサービスが正常に起動・稼働していることを最終確認します。

GGSCI (oracle.test.com) 6> info all

Program     Status     Group       Lag at Chkpt  Time Since Chkpt

MANAGER     RUNNING
JAGENT      RUNNING
EXTRACT     RUNNING    ETKX01      00:00:00      00:00:02
EXTRACT     RUNNING    EXTTK01     00:00:00      00:00:01
EXTRACT     RUNNING    PMPTK01     00:00:00      00:00:04
EXTRACT     RUNNING    PTKX01      00:00:00      00:00:04

まとめ

以上の手順に従うことで、Oracleが推奨する方法でOGG Monitor Agentを問題なくアップグレードできます。このプロセスは、アップグレード作業を完了させるための最もシンプルかつ確実な手法です。jagentのステータスが不安定になる場合は、Config.propertiesの設定内容を見直すことで解決できる点も覚えておきましょう。

ご質問やフィードバックがございましたら、フィードバックタブからお気軽にお寄せください。また、私たちとの対話も歓迎いたします。

ObjectRocket for MongoDBがAWSとGCPへの対応を拡大

Oracleデータベースの代替アーカイブ先の設定方法――ディスク満杯時に備えたフェイルオーバーとフェイルバック

Oracle CloudでDBaaSデータベースを作成する方法：コンパートメント作成からDBシステム構築まで完全解説
この記事では、Oracle® Cloud上にDatabase-as-a-Service（DBaaS）データベースを作成するために必要なすべての手順を、画像付きでわかりやすく解説します。はじめにこのサービスを利用すれば、物理ハードウェアの調達やOSのインストール、Oracle Databaseのインストール前提条件への対応などを一切行うことなく、データベースを構築できます。作成にかかる時間も短く、必要な権限も最小限のシステム管理者レベルで十分です。本記事では、Oracle CloudでDBaaSをセットアップするための以下のステップについて学びます。コンパートメントの作成仮想クラウド
Oracle 19cのDBCAコマンドでデータベースをクローンする方法【サイレントモード完全ガイド】
本記事では、Oracle Database 19cの新機能であるDatabase Configuration Assistant（DBCA）を使用して、ソースデータベースのバックアップを作成することなく、リモートのプラガブル・データベース（PDB）をコンテナ・データベース（CDB）へクローンする手順をご紹介します。 DBCAによるクローンの最大の特長は、ソースからターゲットへの複製にかかる時間が最小限に抑えられる点です。ソースDBの構成 CDB：LCONCDB PDB：LCON 以下は、ソース側の各コンテナ（CDBおよびPDB）に存在するDBFファイルの総数です。クローン作成後は、ター