Oracle® GoldenGate

DB2 z/OSのためのOracle GoldenGateのインストールおよび構成

12c (12.1.2)

E52451-01(原本部品番号:E29289-01)

2014年2月

DB2 z/OSデータベース用のOracle GoldenGateのインストールおよび初期設定の手順について説明します。

Oracle GoldenGate DB2 z/OSのためのOracle GoldenGateのインストールおよび構成, 12c (12.1.2)

E52451-01

Copyright © 2013, 2014, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。誤りがないことの保証はいたしかねます。誤りを見つけた場合は、ご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 システム要件とインストール前の指示

- 1.1 サポートされているプラットフォーム

- 1.2 オペレーティング・システムの要件

- 1.2.1 システム・サービス

- 1.2.2 メモリー要件

- 1.2.3 ディスク要件

- 1.2.4 ネットワーク要件

- 1.2.5 他のオペレーティング・システム要件

- 1.2.6 オペレーティング・システム権限

- 1.3 データベース要件

- 1.3.1 データベース構成

- 1.3.2 Oracle GoldenGateプロセスのデータベース・ユーザー

- 1.4 サポートされているz/OS上のDB2のデータ型

- 1.5 サポートされていないz/OS上のDB2のデータ型

- 1.6 z/OS上のDB2に対してサポートされているオブジェクトと操作

- 1.7 z/OS上のDB2に対してサポートされていないオブジェクトと操作

2 Oracle GoldenGateのインストール

- 2.1 インストールの概要

- 2.2 DB2のインストール・システムの選択

- 2.3 Oracle GoldenGateのダウンロード

- 2.4 z/OSのUSSでのOracle GoldenGateのインストール

- 2.5 LinuxおよびUNIXでのOracle GoldenGateのインストール

- 2.6 WindowsでのOracle GoldenGateのインストール

- 2.6.1 WindowsクラスタへのOracle GoldenGateのインストール

- 2.6.2 Oracle GoldenGateファイルのインストール

- 2.6.3 カスタムManager名の指定

- 2.6.4 WindowsサービスとしてのManagerのインストール

3 Oracle GoldenGateのためのシステムの準備

- 3.1 処理のための表の準備

- 3.1.1 トリガーおよびカスケード制約の無効化

- 3.1.2 行識別子の割当て

- 3.1.2.1 使用する行識別子の種類のOracle GoldenGateによる決定方法

- 3.1.2.2 KEYCOLSを使用したカスタム・キーの指定

- 3.1.3 ROWID列の処理

- 3.2 データベース接続の構成

- 3.2.1 初期化パラメータの設定

- 3.2.2 初期化ファイルのパスの指定

- 3.2.3 ODBC接続互換性の確認

- 3.2.4 接続スレッド数の指定

- 3.3 ロード・モジュールへのアクセス

- 3.4 ジョブの名前と所有者の指定

- 3.5 WLMベロシティ目標の割当て

- 3.6 プロセスの監視

- 3.6.1 Oracle GoldenGateメッセージの表示

- 3.6.2 Oracle GoldenGateプロセスの識別

- 3.6.3 更新操作の統計の解釈

- 3.7 グローバリゼーション関数のサポート

- 3.7.1 ASCIIとEBCDICの両方を含むソースからのレプリケート

- 3.7.2 オブジェクト名内のマルチバイト文字の指定

4 Oracle GoldenGateのためのDB2 for z/OSトランザクション・ログの準備

- 4.1 ブートストラップ・データ・セットの指定

- 4.2 トランザクション・データを使用可能にする

- 4.2.1 変更の取得の有効化

- 4.2.2 ログ・レコードへのアクセスの有効化

- 4.2.3 ログのサイズ設定と保持

- 4.2.4 テープ上のアーカイブ・ログの使用

- 4.2.5 ログ・フラッシュの制御

5 Oracle GoldenGateのアンインストール

- 5.1 LinuxまたはUNIX (USSを含む)からのOracle GoldenGateのアンインストール

- 5.2 WindowsクラスタからのOracle GoldenGateの削除

- 5.3 Windows(非クラスタ)からのOracle GoldenGateのアンインストール

A インストールされるOracle GoldenGateコンポーネント

- A.1 Oracle GoldenGateプログラムおよびユーティリティ

- A.2 Oracle GoldenGateのサブディレクトリ

- A.3 その他のOracle GoldenGateのファイル

- A.4 Oracle GoldenGateチェックポイント表

はじめに

IBM z/OSプラットフォームでは、DB2用Oracle GoldenGateは、Open MVS (OMVS)とも呼ばれるUNIX System Services (USS)上でネイティブに実行されます。Oracle GoldenGateを使用すると、同種または異種のサポートされているDB2 for z/OSバージョン間でデータを移動したり、DB2 for z/OSデータベースとOracleやDB2 for LUWなどの別の種類のデータベースとの間でデータを移動できます。z/OSプラットフォーム上のOracle GoldenGate for DB2は、このドキュメント内で特に断りのないかぎり、データのフィルタリング、マッピングおよび変換をサポートします。

このガイドは、DB2 z/OSデータベース・システムでOracle GoldenGateのインストールおよび初期設定を行う際に有用です。Oracle GoldenGate環境の構成、実行および管理の詳細は、この章に示されている他のOracle GoldenGateドキュメントを参照してください。

対象読者

このガイドは、Oracle GoldenGateをインストール、構成および実行するインストール実行者、データベース管理者およびシステム管理者を対象としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

Oracleサポート・サービスでは、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

関連ドキュメント

Oracle GoldenGateドキュメント・セットには、次のドキュメントが含まれます。

HP NonStopプラットフォーム

- Oracle GoldenGateリファレンスfor Mainframe for HP NonStop Guardian

- Oracle GoldenGateの管理for Mainframe for HP NonStop Guardian

Windows、UNIXおよびLinuxプラットフォーム

- DB2 for iのためのOracle GoldenGateのインストールおよび構成

- DB2 LUWのためのOracle GoldenGateのインストールおよび構成

- DB2 z/OSのためのOracle GoldenGateのインストールおよび構成

- SQL ServerのためのOracle GoldenGateのインストールおよび構成

- MySQLのためのOracle GoldenGateのインストールおよび構成

- NonStop SQL/MXのためのOracle GoldenGateのインストールおよび構成

- Oracle TimesTenのためのOracle GoldenGateのインストールおよび構成

- Oracle DatabaseのためのOracle GoldenGateのインストールおよび構成

- PostgreSQLのためのOracle GoldenGateのインストールおよび構成

- SQL ServerのためのOracle GoldenGateのインストールおよび構成

- SybaseのためのOracle GoldenGateのインストールおよび構成

- TeradataのためのOracle GoldenGateのインストールおよび構成

- Oracle GoldenGateの管理for Windows and UNIX

- Oracle GoldenGateリファレンスfor Windows and UNIX

- Oracle GoldenGateログダンプ・リファレンス

- Oracle GoldenGateのアップグレードfor Windows and UNIX

- Oracle GoldenGateエラー・メッセージ・リファレンスfor Windows and UNIX

その他のOracle GoldenGate製品

- Oracle GoldenGate Adaptersの管理

- Oracle GoldenGate Directorの管理

- Oracle GoldenGate Monitorの管理

- Oracle GoldenGate Veridataの管理

表記規則

このドキュメントでは次の表記規則を使用します。

表記規則

意味

太字

太字は、"「ファイル」メニューから「保存」を選択します"などの操作に関連するグラフィカル・ユーザー・インタフェース要素を示します。太字は、本文中または用語集で定義される用語にも使用されます。

イタリック体

イタリック体

イタリック体は、パラメータ文TABLE table_nameなどのユーザーが特定の値を指定するプレースホルダ変数を示します。イタリック体は、ドキュメントのタイトルおよび強調にも使用されます。

固定幅フォント

大文字の固定幅フォント

固定幅フォントは、ユーザー・イグジットやスクリプトなどのコードのコンポーネント、ファイルおよびデータベース・オブジェクトの名前、URLのパス、および画面に表示される入出力テキストを示します。大文字の固定幅フォントは、Oracle GoldenGateのパラメータ、コマンド、ユーザーが構成可能な関数およびSQLコマンドとキーワードを表すために使用されます。

大文字

通常フォントの大文字は、特別な場合を除き、ユーティリティの名前を表します。

{ }

構文内の中カッコは、パイプ記号で区切ったオプションのセットを囲み、その中の1つを選択する必要があることを表します。たとえば、{option1 | option2 | option3}です。

[ ]

構文内の大カッコは、オプションの要素を示します。たとえば、CLEANUP REPLICAT group_name [, SAVE count]という構文では、SAVE句がオプションです。オプション要素内の複数のオプションは、パイプ記号で区切られます。たとえば、[option1 | option2]です。

1 システム要件とインストール前の指示

この章には、Oracle GoldenGateをサポートするシステム・リソースとデータベース・リソースの要件が含まれます。

この章の内容は次のとおりです。

- 1.1項「サポートされているプラットフォーム」

- 1.2項「オペレーティング・システムの要件」

- 1.3項「データベース要件」

- 1.4項「サポートされているz/OS上のDB2のデータ型」

- 1.5項「サポートされていないz/OS上のDB2のデータ型」

- 1.6項「z/OS上のDB2に対してサポートされているオブジェクトと操作」

- 1.7項「z/OS上のDB2に対してサポートされていないオブジェクトと操作」

1.1 サポートされているプラットフォーム

データベース・バージョンとオペレーティング・システムの特定の組合せで使用可能なOracle GoldenGateのビルドを確認するには、http://support.oracle.comにログオンし、「動作保証」タブを選択します。不明な点がある場合は、「動作保証検索のヒント」をクリックしてください。

このサイトに入るには、電子メールとパスワードが必要です。

1.2 オペレーティング・システムの要件

この項では、ローカル・オペレーティング・システムでOracle GoldenGateをサポートするための要件を概説します。

1.2.1 システム・サービス

ホスト・システムで次のシステム・サービスが有効である必要があります。

- Unix System Services (USS)を、最小モードでなく全機能モードでアクティブにします。これには、 z/OS UNIX構成ウィザードを使用できます。詳細は、『IBM UNIX System Services Planning』を参照してください。UNIXのカスタマイズについては、次のとおりです。

- 言語環境ランタイム・ライブラリ(RTL)をリンク・リストまたはLink Pack Area (LPA)に含めるか、STEPLIB環境変数に追加して、Oracle GoldenGateおよび他のCプログラムで使用できるようにします。RTLは、データ・セットSCEERUNおよびSCEERUN2で構成されます。STEPLIBを使用する場合、SCEERUNデータ・セットをLLAに定義すると、ランタイム・モジュールのロードが速くなります。詳細は、『UNIX System Services Planning』を参照してください。

- TSO/E OMVSコマンドでOracle GoldenGateの編集およびレポート・コマンドをサポートするには、次のターゲット・ライブラリを適切なISPFデータ定義名(ddnames)に連結します。

- データ・セットSYS1.SBPXPENUをddname ISPPLIBに

- データ・セットSYS1.SBPXMENUをddname ISPMLIBに

- データ・セットSYS1.SBPXTENUをddname ISPTLIBに

- データ・セットSYS1.SBPXEXECをddname SYSEXECまたはSYSPROCに

- Recoverable Resource Manager Services (RRS)をインストールして、パフォーマンスを最適にします。接続タイプに応じて、Oracle GoldenGateを実行するユーザーは、DSNRリソース・クラスに対して次の権限のいずれかが必要です。

- RRSAFを使用する場合、RACF ACCESS(READ)をRRSAFリソースに割り当てます。RRSAFには、CAFと比べていくつかの利点(2フェーズ・コミットのサポート、スレッドの再利用、アカウンティング期間の管理など)があるため、IBM社はRRSAFの使用を推奨しています。

- CAFを使用する場合、RACF ACCESS(READ)をBATCH環境に割り当てます。CAFを使用する場合、トランザクションのコミットを受信するまでOracle GoldenGateでシステム・カタログのロックを保持することが可能です。

- Oracle GoldenGateでは、シスプレックス・データ共有がサポートされます。

1.2.2 メモリー要件

Oracle GoldenGateは、ローカル・システムに次のメモリー・リソースを必要とします。

- 作業単位当たりの未コミット・データの量に応じて、約50-100MBの仮想メモリーを各Oracle GoldenGate Extractプロセスに割り当てます。Oracle GoldenGateでは、コミットまたはロールバックのインジケータを受信するまで、ソース・システムにトランザクション・データを保持します。あるいは、スピル・ファイルを使用してデータの大半を保持することもできます。USSの使用率の高いz/OSページ・データ・セットの使用状況を監視する必要があります。初期Extractメモリー・ヒープのデフォルト・サイズは、一部のz/OSシステム(特に、主に小規模なトランザクションを生成するアプリケーションを実行するシステム)には大きすぎます。サイズを調整するには、Extractパラメータ・ファイルでTRANSMEMORYパラメータを使用します。

- GGSCIプログラムは、International Components for Unicode (ICU)ライブラリを使用します。このため、48MBの仮想メモリーの割当てが必要です。

- TSOを使用してUSSにアクセスする場合、TSOユーザーに、Oracle GoldenGate GGSCIプロセスを起動するのに十分なメモリーを割り当てます。エラー・メッセージ"CEE3536S Not enough storage was available for the WSA"が表示される場合、TSOユーザー・メモリーを増やすか、TSO管理者にそのように依頼してください。

1.2.3 ディスク要件

この項では、Oracle GoldenGateのサポートに必要なディスク要件を概説します。

- zFS (zSeriesファイル・システム)またはHierarchical File System (HFS)ボリュームを割り当てます。Oracle GoldenGateのダウンロード・ファイルのサイズを判断するには、選択したビルドをOracle Software Delivery Cloudからダウンロードする前に「サイズ」列を確認します。表示される値は、圧縮形式のファイルのサイズです。展開したOracle GoldenGateインストール・ディレクトリのサイズは、ディスク上で非常に大きくなります。詳細は、2.3項「Oracle GoldenGateのダウンロード」を参照してください。

- Oracle GoldenGateをクラスタ環境にインストールするには、すべてのクラスタ・ノードで使用できる共有ファイルシステムにOracle GoldenGateのバイナリおよびファイルをインストールします。

- DSN=[hfs dsn]

- DISP=(NEW,CATLG,DELETE)

- SPACE =

- DCB=DSORG=PO,DSNTYPE=HFS
BPXPRM UNIX PARMLIBメンバーを更新したIPLで新規ファイルを自動的にマウントします。BPXPRM PARMLIBメンバーでHFSに対するMOUNT FILESYSTEMパラメータがNOSETUIDに設定されていないことを確認します。次のようにファイルをマウントします。

MOUNT FILESYSTEM([hfs dsn]') TYPE(HFS) MODE(RDWR)

MOUNTPOINT('[/u/ggs]')

- Oracle GoldenGate証跡(作業用データが含まれているファイル)をホストするシステムに追加で1GBのディスク領域が必要です。証跡によって消費される領域は処理されるデータ量に応じて異なるため、これとは多少異なる容量が必要となる場合があります。Oracle GoldenGateの管理for Windows and UNIXで証跡のサイズのガイドラインを確認してください。

1.2.4 ネットワーク要件

Oracle GoldenGateには、次のネットワーク・リソースが必要です。

- DNSを含むTCP/IPサービスを使用するようシステムを構成します。Oracle GoldenGateはIPv4とIPv6をサポートし、これらのプロトコルのいずれか、または両方ともがサポートされるシステムで稼働します。

- Oracle GoldenGateのプロセスをホストし、Oracle GoldenGateの接続先となるすべてのシステムのホスト名またはIPアドレスを使用してネットワークを構成します。ホスト名を使用する方が簡単です。

- Oracle GoldenGateでは、予約されていない制限なしのTCP/IPポートが必要とされます。必要な数は、構成内のプロセスの数とタイプによって異なります。必要なポートに対応するようManagerプロセスを構成する方法の詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。

- Oracle GoldenGateに割り当てたポートを記録します。Managerプロセスの構成時にパラメータを使用してそれらを指定します。

- Oracle GoldenGateのポートを介した接続を受け入れるようにファイアウォールを構成します。

1.2.5 他のオペレーティング・システム要件

Oracle GoldenGateをサポートするには、次のオペレーティング・システムの追加機能が使用可能である必要があります。

- Oracle GoldenGateユーザー・イグジットを使用するには、C/C++コンパイラをインストールします。これによって、必要な共有オブジェクトまたはDLLにプログラムが作成されます。

- 最適な結果を得るには、次のツールをシステムに用意します。

- Oracle GoldenGateインストール・ファイルを解凍するGzip。そうでない場合、PC上でWindowsベースの製品を使用してインストールを解凍し、z/OSマシンにFTP送信する必要があります。

- RACFコマンド・プロセッサまたは相当するセキュリティ・パッケージ(このドキュメントに、RACFの推奨事項と例を示します。)

- 許可されたTSO/Eコマンドを含むTime Sharing Option Extensions (TSO/E)コマンド・プロセッサ

- 最適な結果を得るには、IBM社から推奨されているとおり、HIPERメンテナンスを定期的に適用して現在のメンテナンス・リリースから1年以内になるようにします。HIPERプロセスは、データの可用性や整合性に影響を及ぼす可能性のある不具合を識別します。DB2およびz/OSに見つかった不具合を修正するProgram Temporary Fixes (PTF)がIBM社から提供されます。

1.2.6 オペレーティング・システム権限

表1-1に、Oracle GoldenGateを使用するために必要なオペレーティング・システム権限を示します。

表1-1 オペレーティング・システム権限

ユーザーの権限

Manager

Extract

Replicat

OMVSセグメントを持つResource Access Control Facility (RACF)アカウント(または、それに相当するもの)脚注 1

X

ローカルDB2サブシステムへのCONNECT脚注 2

X

X

ブートストラップ・データ・セット(BSDS)へのACCESS(READ)

X脚注 3

CLASS(FACILITY)のリソースBPX.FILEATTR.APFへのACCESS(READ)脚注 4

X

Oracle GoldenGateディレクトリのサブディレクトリに対するchmod +rw

X

X

X

脚注 1 Managerプロセスを起動するユーザーは、通常他のOracle GoldenGateプロセスを実行するユーザーです。

脚注 2 ODBC初期化ファイルのMVSATTACHTYPE値に応じて、CAFまたはRRSAFで保護されたDSNR RACFリソース・クラス内のアクセス・プロファイルへのアクセスが必要です。

脚注 3 非データ共有のみ。

脚注 4 Extractプログラムをインストールするユーザーに必要です。

1.3 データベース要件

この項には、z/OS上のDB2データベースに固有のOracle GoldenGate要件が含まれます。

1.3.1 データベース構成

Oracle GoldenGateをサポートするには、次のデータベース・コンポーネントを構成します。

- DB2 ODBCドライバをインストールします。Oracle GoldenGate ExtractおよびReplicatプロセスは、ODBC (Open Database Connectivity)を使用してDB2サブシステムに接続します。ODBCの詳細は、『DB2 for z/OS ODBC Guide and Reference』を参照してください。

- DB2 ODBC動的ロード・ライブラリをインストールして構成します。

- Oracle GoldenGateに、ODBC初期化ファイルに指定されているプラン(デフォルトはDSNACLI)に対するEXECUTE権限を付与します。

- ローカルDB2サブシステムの名前を、リモートDB2サーバーの場所を含むSYSIBM.LOCATIONS表に挿入する必要がある場合があります。次のような文を使用します(この例では、DB2Aという名前を使用します)。

INSERT INTO SYSIBM.LOCATIONS (LOCATION, PORT) VALUES ('DB2A', '446');

1.3.2 Oracle GoldenGateプロセスのデータベース・ユーザー

Oracle GoldenGateには、データベース・ユーザー・アカウントが必要です。次のガイドラインに従ってこのアカウントを作成し、権限を割り当てます。

- デフォルトでは、Managerプロセスを起動したユーザーが、そのOracle GoldenGateインスタンスでユーザーが起動したすべてのOracle GoldenGateプロセスのデフォルトDB2 1次許可IDになります。JCLまたはUNIX変数を使用して別のユーザーをプロセスに割り当てることができます。

- Oracle GoldenGateの処理を正確に監視するには、他のアプリケーションまたはプロセスがOracle GoldenGateユーザーとして動作することを許可しないでください。

- 表1-2にリストしたDB2の権限を、ExtractおよびReplicatを実行するユーザー(デフォルトはManagerを起動するユーザー)に割り当てます。これらは、DB2 ODBCで必要な権限以外に必要なものです。記載がないかぎり、すべてのExtract権限は、初期ロードおよびログベースのExtractプロセスに適用されます。

表1-2 z/OS上のDB2用Oracle GoldenGateに必要な権限

ユーザーの権限

Extract

Replicat

MONITOR2

(初期ロードExtractには非適用)

X

次のSYSIBM表に対するSELECT ON:

SYSTABLES

SYSCOLUMNS

SYSTABLEPART

SYSKEYS

SYSINDEXES

SYSCOLAUTH

SYSDATABASE

SYSFOREIGNKEYS

SYSPARMS

SYSRELS

SYSROUTINES

SYSSYNONYMS

SYSTABAUTH

SYSAUXRELS

X

X

ソース表に対するSELECT脚注 1

X

ターゲット表に対するINSERT、UPDATE、DELETE

X

CREATE TABLE脚注 2

X

ODBCプラン(デフォルトはDSNACLI)に対するEXECUTE

X

SQLEXECプロシージャまたは使用する問合せで必要とする権限脚注 3

X

X

脚注 1 表にLOB列が含まれている場合または初期ロードExtract(使用する場合)に対してのみ、ソース表に対するSELECTが必要です。

脚注 2 GGSCIでADD CHECKPOINTTABLEを使用してデータベースのチェックポイント機能を使用する場合に必要です。

脚注 3 SQLEXECによって、Oracle GoldenGateプロセスによるストアド・プロシージャおよび問合せの実行が可能になります。

1.4 サポートされているz/OS上のDB2のデータ型

この項には、z/OSプラットフォームでOracle GoldenGateによってサポートされるDB2のデータ型およびこのサポートの制限をリストします。

- Oracle GoldenGateは、マルチバイト・データを含む列の文字セットの変換を行いません。これには、GRAPHIC、VARGRAPHIC、DBCLOBの各データ型やENCODING_SCHEMEが'M'(複数CCSIDセットまたは複数エンコーディング方法)または'U' (Unicode)で定義された表のCHAR、VARCHARおよびCLOBがあります。これらのデータは、ソースとターゲットのシステムが同じCCSIDの場合にのみサポートされます。

- Oracle GoldenGateでは、ASCII、EBCDICおよびUnicodeデータ形式がサポートされます。Oracle GoldenGateは、ASCIIとEBCDICの間でデータを自動的に変換します。Unicodeは変換されません。

- Oracle GoldenGateでは、1.5項「サポートされていないz/OS上のDB2のデータ型」にリストされたもの以外のほとんどのDB2のデータ型がサポートされます。

サポートの制限

- 浮動小数点数の範囲と精度のサポートは、ホスト・マシンによって異なります。通常は有効桁数が16桁の精度ですが、データベースのドキュメントで想定されている近似について確認してください。サポートされる精度を超える場合、Oracle GoldenGateで丸めまたは切捨てが行われます。

- Oracle GoldenGateでは、サイズが4Kを超えるオブジェクトのフィルタリング、列マッピングや操作はサポートされません。Oracle GoldenGateのすべての機能は、4K以下のオブジェクトに対して使用できます。

- DECFLOATはReplicatによって完全にサポートされます。Extractはトランザクション・ログからはDECFLOATを取得しませんが、データベースからのフェッチによる取得はサポートします。

1.5 サポートされていないz/OS上のDB2のデータ型

この項には、z/OSプラットフォームでOracle GoldenGateによってサポートされないDB2のデータ型をリストします。サポートされないデータが、ソース・データとターゲット・データとの整合性に影響する場合があります。

- XML

- ユーザー定義型

- 負の日付

- TIMESTAMP WITH TIMEZONE

1.6 z/OS上のDB2に対してサポートされているオブジェクトと操作

この項には、Oracle GoldenGatでサポートされるデータベース・オブジェクトおよび操作のタイプをリストします。

- 最大512KBの長さの行を含むDB2 for z/OS表でのDML操作の抽出とレプリケーション。このサイズは、DB2の最大行サイズを超えています。

- IBM LOADユーティリティによるINSERT操作は、ユーティリティがLOG YESおよびSHRLEVEL CHANGEで実行されており、ロードされるソース表でDATA CAPTURE CHANGESが有効(Oracle GoldenGateで必要)で、この表がOracle GoldenGate Extract構成で指定されている場合、変更の取得でサポートされます。Oracle GoldenGateは、初期同期時のターゲット表のインスタンス化でLOADユーティリティによる初期ロードもサポートします。詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。

- Oracle GoldenGateでは、データベースによってサポートされている、1つの表当たりの最大列数がサポートされます。

- Oracle GoldenGateでは、データベースによってサポートされている最大列サイズがサポートされます。

- DB2のデータ圧縮(CREATE TABLESPACE COMPRESS YES)を使用して格納されたデータの抽出およびレプリケーション。

- TRUNCATE TABLEはサポートされていますが、このコマンドでは、行の削除を発行して切捨てを行うため、Oracle GoldenGate統計で削除として表示され、切捨て操作として表示されません。TRUNCATEをレプリケートするために、ReplicatはWHERE句を指定しないDELETEを使用します。

- TRUNCATESはDB2 for z/OSソースから必ず取得されますが、IGNORETRUNCATESパラメータがReplicatパラメータ・ファイルで使用されている場合、Replicatによって無視されます。

1.7 z/OS上のDB2に対してサポートされていないオブジェクトと操作

- DDL操作の抽出またはレプリケーション

- 表のクローニング

- 次のようなユーザー指定のDB2出口ルーチン内で実行されるデータ操作(圧縮など)

- 日付と時間のルーチン

- 編集ルーチン(CREATE TABLE EDITPROC)

- 検証ルーチン(CREATE TABLE VALIDPROC)

- Oracle GoldenGateセキュリティ機能におけるAES暗号化

2 Oracle GoldenGateのインストール

この章では、DB2 z/OSデータベース用のOracle GoldenGateのインストール方法を示します。ここで説明するインストール手順では、処理の実行および管理に必要なすべてのコンポーネント(ドライバやライブラリなどの、他のベンダーのコンポーネントは除く)がインストールされます。Oracle GoldenGateユーティリティもインストールされます。

この章の内容は次のとおりです。

- 2.1項「インストールの概要」

- 2.2項「DB2のインストール・システムの選択」

- 2.3項「Oracle GoldenGateのダウンロード」

- 2.4項「z/OSのUSSでのOracle GoldenGateのインストール」

- 2.5項「LinuxおよびUNIXでのOracle GoldenGateのインストール」

- 2.6項「WindowsでのOracle GoldenGateのインストール」

注意:

この手順は、Oracle GoldenGateを初めてインストールする場合の手順です。また、Oracle GoldenGateの新規バージョンのベース・リリースをダウンロードする場合のものでもあります。

後続のパッチをダウンロードしてベース・リリースにインストールするには、次のURLのMy Oracle Supportの「パッチと更新版」タブに移動します。

http://support.oracle.com

Oracle GoldenGateをあるバージョンから別のバージョンにアップグレードするには、次のアップグレード手順に従います。

http://www.oracle.com/technology/software/products/goldengate/index.html

2.1 インストールの概要

Oracle GoldenGateをインストールするには、次の手順が必要です。

- DB2のインストール・システムの選択

- Oracle GoldenGateのダウンロード

- z/OSのUSSでのOracle GoldenGateのインストール

- LinuxおよびUNIXでのOracle GoldenGateのインストール

- WindowsでのOracle GoldenGateのインストール

2.2 DB2のインストール・システムの選択

Oracle GoldenGateをインストールする場合、次のオプションがあります。

- DB2データを取得する場合、Oracle GoldenGateはz/OSソース・システムに直接インストールされます。z/OSプラットフォームでは、Oracle GoldenGateは、Open MVS (OMVS)とも呼ばれるUNIX System Services (USS)上でネイティブに実行されます。Extractは、ODBC (Open Database Connectivity)を使用してDB2サブシステムに接続します。

- DB2ターゲットにデータを適用するには、次の構成のいずれかを使用します。

- Oracle GoldenGateをz/OSターゲット・システムに直接インストールします。Replicatは、ODBC (Open Database Connectivity)を使用してDB2サブシステムに接続します。この構成を使用するには、2.4項「z/OSのUSSでのOracle GoldenGateのインストール」を参照してください。

- DB2ターゲット・システムへのリモート配信用にOracle GoldenGate DB2 RemoteをリモートのLinux、UNIXまたはWindowsシステムにインストールします。この構成では、Replicatは、DB2 Connectに含まれているODBC APIを使用してターゲットDB2データベースに接続します。この構成では、リモート・システムにDB2 LUWがインストールされている必要があります。次の手順を使用します。

注意:

DB2 for z/OSに対してサポートされるOracle GoldenGateの機能はすべて、DB2Connectによってサポートされます。また、ASCII文字データは、DB2 Connectによって自動的にEBCDICに変換されます。

DB2Connectを介したz/OSシステムへのリモート配信を使用する手順

1. 中間システムとして、DB2 for LUWデータベースに対してOracle GoldenGateでサポートされているLinux、UNIXまたはWindowsプラットフォームを選択します。これは、Oracle GoldenGateがインストールされるシステムです。

2. ReplicatプロセスでDB2 Connectドライバを使用できるよう、選択したリモート・システムにDB2 for LUWをインストールして実行します。

3. 次のDB2コマンドを使用して、リモート・システムのDB2 for LUWデータベースでDB2ターゲット・ノードを登録します。

catalog tcpip node db2_node_name remote DNS_name

server DB2_port-number

4. 次のDB2コマンドを使用して、中間システムのDB2 for LUWカタログにターゲットDB2ノードを追加します。

catalog db database_name as database_alias at node db_node_name

注意:

これらのコマンドの詳細は、IBM DB2 LUWのドキュメントを参照してください

5. 2.3項「Oracle GoldenGateのダウンロード」の手順に従って、選択したリモートのWindows、LinuxまたはUNIXプラットフォームに適したビルドをダウンロードします。DB2Remoteという名前のビルドを選択します。次の手順のうち適切な方に従って中間システムにOracle GoldenGateをインストールします。

- 2.5項「LinuxおよびUNIXでのOracle GoldenGateのインストール」

- 2.6項「WindowsでのOracle GoldenGateのインストール」

6. Oracle GoldenGateプロセスを構成する際、ReplicatのパラメータTARGETDBにDB2ターゲット・データベース名を指定します。

2.3 Oracle GoldenGateのダウンロード

Oracle GoldenGate構成に含まれる各システムにOracle GoldenGateの適切なビルドをダウンロードします。

1. http://edelivery.oracle.comに移動します。
「Oracle Software Delivery Cloud」ページが表示されます。

2. 「サインイン/登録」をクリックします。

注意:

まだログインしていない場合、「シングル・サインオン」ページが表示されます。Oracle IDとパスワードを入力し、「サインイン」をクリックします。

「条項および規制」ページが表示されます。

3. 「Oracle Software Delivery Cloudトライアル・ライセンス契約」および「輸出規制」を受諾し、「続行」をクリックします。
「メディア・パック検索」ページが表示されます。

4. 「メディア・パック検索」ページで次のようにします。

1. 製品パックを選択ドロップダウン・コントロールをクリックし、リストから「Oracle Fusion Middleware」を選択します。

2. 「プラットフォーム」ドロップダウン・コントロールをクリックし、リストからOracle GoldenGateをインストールするプラットフォームを選択します。

3. 「実行」をクリックします。

「結果」リストが拡張され、検索基準を満たす使用可能なメディア・パックがすべて表示されます。

5. 「結果」リストでダウンロードするメディア・パックを選択し、「続行」をクリックします。
メディア・パックのダウンロード・ページが表示されます。各データベースまたは各データベース・バージョン用のビルドなどの追加のダウンロード用選択肢が表示される場合があります。このページには、ダウンロード可能な各ファイルの部品番号とサイズが含まれていることに注意してください。

注意:

DB2 Connectを使用してWindowsまたはUNIXシステムからDB2ターゲットに接続するOracle GoldenGateをインストールするには、DB2Remoteという名前のビルドを選択します。DB2 z/OSターゲット・システムで実行されるOracle GoldenGateをダウンロードするには、そのデータベースとプラットフォームに適したビルドを選択します。(2.2項「DB2のインストール・システムの選択」を参照してください。)

6. ファイルを正常にダウンロードするには、まず「README」をクリックして メディア・パックReadmeでダウンロード手順と製品情報を確認します。Readmeには、現在の構成に影響を与える新機能、新要件またはバグ修正および他の既知の問題に関するリリース・ノートが含まれています。

7. ダウンロード・プロセスを開始するには、ダウンロードするOracle GoldenGateビルドの名前の横にある「ダウンロード」をクリックします。
「ファイル・ダウンロード」ダイアログ・ボックスが表示されます。

8. 「次で開く」または「ファイルの保存」を選択します。

処理

選択

メディア・パックをただちにインストール

「開く」を選択してファイル抽出ユーティリティを選択し、ファイル・システム上の指定した場所にファイルを抽出します。

ファイルを保存し、後でインストール

「保存」を選択し、ファイル・システム上の場所を指定します。

注意:

ソフトウェアをインストールする前に、リリース・ノートで、現在の構成に影響を与える新機能、新要件またはバグ修正について確認します。readmeファイルで既知の問題について確認します。

2.4 z/OSのUSSでのOracle GoldenGateのインストール

次の手順に従って、z/OSシステムのUNIX System ServicesでOracle GoldenGateをインストールします。

1. スーパーユーザーまたは"a"拡張属性を追加するz/OS許可を持つユーザーとしてログオンします。この種のユーザーとしてログオンできない場合、適切な許可を持つユーザーが後で"a"属性を設定する必要があります。これは、IFI IFCID 306という名前で権限APIを使用するExtractプロセスが特定の処理を行うために必要です。他の処理では通常のアプリケーション権限に戻ります。高い権限を必要とする処理は次のとおりです。

- ストレージ・キー0を使用してスーパーバイザ状態でAPIをコールします。

- Extended Common Storage Area (ECSA)メモリー・サブプール241(フェッチ保護されず、ページング可能)にストレージ・キー7で戻り領域を割り当てます。戻り領域のサイズは、返される最大DB2ログ・レコードの最小値に、DB2マクロDSNDQW04で定義された追加領域を加えた値です。

2. Oracle GoldenGateのインストール・ファイルを、Oracle GoldenGateをインストールするシステムおよびディレクトリに抽出します。

3. UNIXシェルで、DLLファイルに書込みモードが設定されていることを確認します。

ls -l *.dll

-rwxrwx---  a-s-  1 BSTPIER  IPGROUP  6127616 Apr 25 14:56 lib.dll

4. 書込みモードが設定されていない場合、次のコマンドを発行します。

chmod +w *.dll

5. UNIXシェルで、次のコマンドを発行し、ExtractとDLLファイルに"a"許可があることを確認します。

ls -E extract *.dll

出力で、次の例に示すようなAuthorized Program Facility (APF)の許可を示す"a"属性を確認します。

-rwxrwx---  a-s-  1 BSTPIER  IPGROUP  6127616 Apr 25 14:56 extract

6. ExtractとそのDLLファイルの両方に"a"属性が設定されていない場合(ビルド構成によっては、一方に設定されていて他方に設定されていない場合があります)、次のコマンドを発行してExtractとDLLファイルに許可を追加します。

extattr +a extract

extattr +a *.dll

7. コマンド・シェルを実行してディレクトリを新規Oracle GoldenGateディレクトリに変更します。

8. Oracle GoldenGateインストール・ディレクトリのパスが含まれるようにLIBPATH環境変数を設定します。

export LIBPATH=".:$(LIBPATH)"

"."は、現在のディレクトリです。この変更は、Oracle GoldenGateプロセスの起動前に行う必要があります。次の方法があります。

- システム全体

- 特定のユーザーに対してログイン時に

- Oracle GoldenGateが実行されるたびに手動で

9. Oracle GoldenGateディレクトリからGGSCIプログラムを実行します。

GGSCI

10. GGSCIで次のコマンドを発行して、Oracle GoldenGate作業ディレクトリを作成します。

CREATE SUBDIRS

11. 次のコマンドを発行して、GGSCIを終了します。

EXIT

2.5 LinuxおよびUNIXでのOracle GoldenGateのインストール

次の手順に従って、LinuxおよびUNIXシステムでOracle用のOracle GoldenGateをインストールします。

1. Oracle GoldenGateのインストール・ファイルを、Oracle GoldenGateをインストールするシステムおよびディレクトリに抽出します。

2. コマンド・シェルを実行します。

3. ディレクトリを新規Oracle GoldenGateディレクトリに変更します。

4. Oracle GoldenGateディレクトリからGGSCIプログラムを実行します。

GGSCI

5. GGSCIで次のコマンドを発行して、Oracle GoldenGate作業ディレクトリを作成します。

CREATE SUBDIRS

6. 次のコマンドを発行して、GGSCIを終了します。

EXIT

2.6 WindowsでのOracle GoldenGateのインストール

次の手順に従って次の作業を行います。

- WindowsシステムでOracle用のOracle GoldenGateをインストールします。

- DB2 for z/OSターゲット・システムへのリモート配信をサポートするために、WindowsシステムでOracle GoldenGate DB2Remoteをインストールします。z/OSシステムで直接インストールするには、2.4項「z/OSのUSSでのOracle GoldenGateのインストール」を参照してください。

2.6.1 WindowsクラスタへのOracle GoldenGateのインストール

1. クラスタ内のいずれかのノードにログインします。

2. Oracle GoldenGateのインストール場所のドライブを選択します。このドライブは、データベース・インスタンスが含まれる同じクラスタ・グループ内のリソースである必要があります。

3. このグループが、ログイン先のクラスタ・ノードによって所有されていることを確認します。

4. 次の手順に従ってOracle GoldenGateをインストールします。

2.6.2 Oracle GoldenGateファイルのインストール

1. WinZipまたは同等の圧縮ソフトを使用して、ダウンロードしたファイルを解凍します。

2. ファイルを、Oracle GoldenGateをインストールするドライブ上のフォルダに、バイナリ・モードで移動します。パスが引用符で囲まれている場合でも、名前に空白が含まれているフォルダにはOracle GoldenGateをインストールしないでください。例を次に示します。
C:\"Oracle GoldenGate"は無効です。

C:\Oracle_GoldenGateは有効です。

3. Oracle GoldenGateフォルダからGGSCIプログラムを実行します。

4. GGSCIで次のコマンドを発行して、Oracle GoldenGate作業ディレクトリを作成します。

CREATE SUBDIRS

5. 次のコマンドを発行して、GGSCIを終了します。

EXIT

2.6.3 カスタムManager名の指定

次のいずれかに該当する場合は、Managerプロセスにカスタム名を指定する必要があります。

- デフォルトのGGSMGR以外のManager名を使用します。

- 複数のManagerプロセスがWindowsサービスとしてこのシステムで実行されています。システム上の各Managerの名前を一意にする必要があります。先に進む前に、Managerのローカル・サービスの名前を確認してください。

カスタムManager名を指定する手順:

1. Managerプログラムが置かれているディレクトリからGGSCIを実行します。

2. 次のコマンドを発行します。

EDIT PARAMS ./GLOBALS

注意:

GLOBALSファイルはOracle GoldenGateインストール・ファイルのルートにあるため、このコマンドの./部分を使用する必要があります。

3. ファイルに次の行を追加します。nameは、1語からなるManagerサービスの名前です。

MGRSERVNAME name

4. ファイルを保存します。ファイルはGLOBALSという名前で自動的に保存されますが、ファイル拡張子は付きません。このファイルは移動しないでください。Windowsサービスのインストール時とデータ処理時に使用されます。

2.6.4 WindowsサービスとしてのManagerのインストール

デフォルトでは、Managerはサービスとしてインストールされず、ローカルまたはドメイン・アカウントで実行できます。ただし、この方法で実行した場合は、ユーザーがログアウトするとManagerは停止します。Managerをサービスとしてインストールすれば、ユーザー接続と無関係にManagerを操作でき、手動で起動するように構成することも、システム起動時に起動するように構成することもできます。

Windowsクラスタでは、Managerはサービスとしてインストールする必要がありますが、それ以外では任意です。

1. (推奨)システム管理者としてログオンします。

2. 「スタート」、「ファイル名を指定して実行」の順にクリックし、「ファイル名を指定して実行」ダイアログ・ボックスにcmdと入力します。

3. サービスとしてインストールするManagerプログラムを含むディレクトリから、次の構文でINSTALLユーティリティを実行します。

install option [...]

ここで、optionは次のいずれかです。

表2-1 INSTALLのオプション

オプション

説明

ADDEVENTS

Oracle GoldenGateイベントをWindowsイベント・マネージャに追加します。

ADDSERVICE

GLOBALSファイルのMGRSERVNAMEパラメータで指定された名前がある場合はその名前で、そうでない場合はデフォルトのGGSMGRで、Managerをサービスとして追加します。ADDSERVICEは、大部分のWindowsアプリケーションの標準であるローカル・システム・アカウントとして実行されるようにサービスを構成します。これにより、サービスをユーザー・ログインやパスワードの変更の影響を受けずに実行できるためです。特定のアカウントとしてManagerを実行するには、USERオプションおよびPASSWORDオプションを使用します。脚注 1

サービスがインストールされ、システム起動時に開始されます(AUTOSTARTを参照)。サービスをインストール後に開始するには、システムを再起動するか、コントロール パネルの「サービス」アプレットから手動でサービスを開始します。

AUTOSTART

ADDSERVICEで作成されたサービスが、システム起動時に開始されるように設定します。MANUALSTARTを使用しないかぎり、これがデフォルトです。

MANUALSTART

ADDSERVICEで作成されたサービスが、GGSCI、スクリプト、またはコントロール パネルの「サービス」アプレットを使用して手動で開始されるように設定します。デフォルトはAUTOSTARTです。

USER name

Managerを実行するドメイン・ユーザー・アカウントを指定します。nameには、ドメイン名とバックスラッシュとユーザー名を含めます。たとえば、HEADQT\GGSMGRなどです。

デフォルトでは、Managerサービスはローカル・システム・アカウントを使用するようにインストールされます。

PASSWORD password

USERで指定されたユーザーのパスワードを指定します。

脚注 1 ユーザー・アカウントは、Windowsコントロール パネルの「サービス」アプレットから「プロパティ」アクションを選択することで変更できます。

4. (Windows Server 2008) Windows User Account Control (UAC)が有効である場合、コンピュータへのプログラム・アクセスを許可するか、または拒否するかを尋ねるプロンプトが表示されます。「許可」を選択して、INSTALLユーティリティを実行できるようにします。
このINSTALLユーティリティにより、Managerサービスは管理者権限で実行されているローカル・システム・アカウントでインストールされます。Managerがサービスとしてインストールされていれば、これ以降実行時にUACプロンプトが表示されることはありません。

注意:

Managerがサービスとしてインストールされていない場合、Oracle GoldenGateユーザーがManagerをGGSCIコマンド・プロンプトから起動する際、Managerの権限昇格を確認するUACプロンプトが表示されます。Oracle GoldenGateの他のプログラムの実行でもプロンプトが表示されます。

3 Oracle GoldenGateのためのシステムの準備

この章には、Oracle GoldenGateをサポートするためのデータベースとシステムの準備のガイドラインが含まれます。

この章の内容は次のとおりです。

- 3.1項「処理のための表の準備」

- 3.2項「データベース接続の構成」

- 3.3項「ロード・モジュールへのアクセス」

- 3.4項「ジョブの名前と所有者の指定」

- 3.5項「WLMベロシティ目標の割当て」

- 3.6項「プロセスの監視」

- 3.7項「グローバリゼーション関数のサポート」

3.1 処理のための表の準備

Oracle GoldenGate環境で次の表属性に対処する必要があります。

トリガーおよびカスケード制約の無効化

行識別子の割当て

ROWID列の処理

3.1.1 トリガーおよびカスケード制約の無効化

ターゲット表で、トリガー、カスケード削除制約およびカスケード更新制約を無効にするか、Oracle GoldenGateデータベース・ユーザーが行った変更を無視するよう変更します。Oracle GoldenGateは、トリガーまたはカスケード制約から発生するDMLをレプリケートします。同じトリガーや制約がターゲット表でアクティブになると、レプリケートと重複し、データベースでエラーが返されます。次の例を検討してください。この例では、ソース表はemp_srcとsalary_srcで、ターゲット表はemp_targとsalary_targです。

- emp_srcに対して削除が発行されます。

- それによって、削除がsalary_srcにカスケードされます。

- Oracle GoldenGateは、両方の削除をターゲットに送信します。

- まず親削除が到着し、emp_targに適用されます。

- 親削除によって削除がsalary_targにカスケードされます。

- salary_srcのカスケードされた削除が、salary_targに適用されます。

- 行は手順5ですでに削除されているため検出できません。

3.1.2 行識別子の割当て

Oracle GoldenGateは、レプリケートされた更新や削除に対応する正しいターゲット行を検出するために、ソース表およびターゲット表に特定の形式の一意の行識別子を必要とします。

3.1.2.1 使用する行識別子の種類のOracle GoldenGateによる決定方法

TABLEまたはMAP文でKEYCOLS句が使用されないかぎり、Oracle GoldenGateは、使用する行識別子を次の優先順位に従って選択します。

1. 主キー

2. タイムスタンプまたはマテリアライズされていない計算結果列を含まない英数字順で最初の一意キー。

3. 前述のキー・タイプのいずれも存在しない場合(その他の種類のキーが表に定義されている場合でも)、Oracle GoldenGateは、データベースで一意キーでの使用を許可されているすべての列(キー内での使用がOracle GoldenGateでサポートされていない列やOracle GoldenGate構成から除外されている列は除く)で疑似キーを作成します。

注意:

表に使用できないその他のキーが存在する場合、または表にキーが存在しない場合、Oracle GoldenGateによって適切なメッセージがレポート・ファイルに記録されます。すべての列からキーを作成すると、ソース・システムのOracle GoldenGateのパフォーマンスが低下します。ターゲットでは、このキーはReplicatであまり効率的でないより大きいWHERE句が使用される原因となります。

3.1.2.2 KEYCOLSを使用したカスタム・キーの指定

前述のタイプの行識別子が表に存在しないか、または、それらの識別子を使用しない場合は、常に一意の値が含まれている列が表にあれば、代替キーを定義できます。ExtractのTABLEパラメータおよびReplicatのMAPパラメータ内にKEYCOLS句を含めることで、この代替キーを定義します。指定されたキーがOracle GoldenGateで検出される既存の主キーまたは一意なキーよりも優先されます。詳細は、Oracle GoldenGateリファレンスfor Windows and UNIXを参照してください。

3.1.3 ROWID列の処理

ROWID GENERATED ALWAYS(デフォルト)のデータ型の列を含むターゲット表に挿入しようとすると、次のODBCエラーで失敗します。

ODBC error: SQLSTATE 428C9 native database error -798. {DB2 FOR OS/390}{ODBC DRIVER}{DSN08015} DSNT408I SQLCODE = -798, ERROR: YOU CANNOT INSERT A VALUE INTO A COLUMN THAT IS DEFINED WITH THE OPTION GENERATED ALWAYS. COLUMN NAME ROWIDCOL.

次のいずれかを行って、ROWID列を含む表がOracle GoldenGateによって処理されるように準備します。

- ターゲット表のROWID列がGENERATED BY DEFAULTとして定義されていることを確認します。

- 表定義を変更できない場合、次の手順を使用して回避します。

ROWID GENERATE ALWAYSを回避する手順:

1. ソース表に対するExtract TABLE文を作成し、その文で、ROWID列を除外するCOLSEXCEPT句を使用します。例を次に示します。

TABLE tab1, COLSEXCEPT (rowidcol);

COLSEXCEPT句で、ROWID列が取得されてターゲット表にレプリケートされないようにします。

2. ターゲット表では、ReplicatがROWIDをキーとして使用しないようにします。これは、次のいずれかの方法で行えます。

- ターゲット表定義で主キーを指定します。

- キーを作成できない場合、表に対するReplicat MAPパラメータを作成し、その文にKEYCOLS句を使用してROWID列以外の一意の列を含めます。Replicatは、それらの列をキーとして使用します。例を次に示します。

MAP tab1, TARGET tab1, KEYCOLS (num, ckey);

KEYCOLSの詳細は、3.1.2項「行識別子の割当て」を参照してください。

3.2 データベース接続の構成

次のガイドラインでは、適切なODBCドライバがインストールされ、構成されているものとします。

初期化パラメータの設定

初期化ファイルのパスの指定

ODBC接続互換性の確認

接続スレッド数の指定

3.2.1 初期化パラメータの設定

次のDB2 for z/OS初期化パラメータがOracle GoldenGateに適用されます。Oracle GoldenGateプロセスを起動する前に適切に設定される必要があります。

- MVSDEFAULTSSID: DB2サブシステムに設定します。

- LOCATION: DB2ブートストラップ・データセットに格納されているDB2の場所の名前に設定します。

- MVSATTACHTYPE: RRSAF (Recoverable Resource Manager Services Attachment Facility)またはCAF (Call Attachment Facility)に設定します。IBM社は、RRSAFの使用を推奨しています。

- MULTICONTEXT:: RRSAFを使用する場合、1に設定します。

- PLANNAME: DB2プランに設定します。デフォルト・プラン名はDSNACLIです。

CURRENTAPPENSCH初期化パラメータ(キーワード)を使用しないでください。

注意:

CAF接続タイプを使用する場合、DB2に接続するExtractまたはReplicatプロセスのパラメータ・ファイルにOracle GoldenGate DBOPTIONSパラメータを含め、NOCATALOGCONNECTオプションを指定する必要があります。このパラメータによって、Oracle GoldenGateによる通常の試行が無効化され、DB2カタログに対して2つ目のスレッドが取得されなくなります。そうしない場合、ODBC operation failed: Couldn't connect to datasource for catalog queries.のようなエラー・メッセージを受信します。

3.2.2 初期化ファイルのパスの指定

次の例のように、z/OS UNIXプロファイルにDSNAOINI環境変数を設定し、ODBC初期化ファイルを指定します。

export DSNAOINI="/etc/odbc810.ini"

3.2.3 ODBC接続互換性の確認

DB2 ODBC初期化ファイルを正しく構成したことを確認するには、『DB2 UDB for z/OS ODBC Guide and Reference』のガイドラインに従います。重要な考慮事項の1つは、大カッコの開始と終了([および])のコーディングです。大カッコは、異なるコード化文字セットID (CCSID)で異なってエンコードされる可変文字ですが、ODBC初期化ファイルでは、IBM-1047 CCSIDのものである必要があります。DB2 ODBCは、他のCCSIDのカッコを認識しません。次の点に注意してください。

- 1つ目(開始)のカッコは、16進文字X'AD' (0xAD)を使用する必要があります。

- 2つ目(終了)のカッコは、16進文字X'BD' (0xBD)を使用する必要があります。

正しい大カッコのコードを設定するには、次のいずれかの方法を使用します。

- OEDITでhexコマンドを使用して、各文字の16進コードを適切に変更します。

- iconvユーティリティを使用してODBC初期化ファイルを変換します。たとえば、CCSID IBM-037からIBM-1047に変換するには、次のコマンドを使用します。

iconv -f IBM-037 -t IBM-1047 ODBC.ini > ODBC-1047.ini

mv ODBC-1047.ini ODBC.ini

- ファイルの作成または変更時、CCSID IBM-1047を使用するよう端末エミュレータまたは端末構成を変更します。

3.2.4 接続スレッド数の指定

各Oracle GoldenGateプロセスはデータベース接続を行います。使用するプロセスの数および想定する他のDB2接続の数に応じて、DSNTIPE DB2 Thread Managementパネルで次のDB2システム・パラメータを調整する必要があります。

- MAX USERS(マクロDSN6SYSP CTHREAD)

- MAX TSO CONNECT(マクロDSN6SYSP IDFORE)

- MAX BATCH CONNECT(マクロDSN6SYSP IDBACK)

RRSAFを使用する場合、次のように見込みます。

- 次のものに対するプロセスごとに2つのDB2スレッド

- Extract

- Replicat

- GGSCIコマンドDBLOGIN(データベースにログインします)

- DEFGENユーティリティ(列マッピングのデータ定義を生成します)

- IFIコールに対するExtract用に追加で1つのDB2スレッド。

- 各ExtractおよびReplicatプロセスによって発行されるSQLEXECパラメータ文ごとに追加で1つのDB2スレッド。SQLEXECの詳細は、Oracle GoldenGateリファレンスfor Windows and UNIXを参照してください。

CAFを使用する場合、Oracle GoldenGateプロセスごとにスレッドは1つのみです。

3.3 ロード・モジュールへのアクセス

Oracle GoldenGate USSアクセス権をSDSNLOADシステム・ロード・ライブラリおよびDSNHDECPロード・モジュールに付与します。次のいずれかにライブラリを含めます。

- z/OSシステム検索順序。

- Oracle GoldenGateユーザーのUSSプロファイル。次のようなUNIXコマンドを使用します。ここで、DSN810はDB2インストールのユーザー割当てデータ・セット接頭辞です。

export STEPLIB='DSN810.SDSNEXIT:DSN810.SDSNLOAD'

前述のコマンドによって、シェル・コマンドまたはOracle GoldenGateプロセスが実行されるたびに、USSでSTEPLIB DD文と同等の割当てが行われます。APFを使用する場合、STEPLIB連結のすべてのライブラリはAPF許可されている必要があります。

3.4 ジョブの名前と所有者の指定

デフォルトでは、USSは、すべてのOracle GoldenGateプロセスのジョブ名と所有者を、起動したユーザーのものに設定します。_BPX_JOBNAMEおよび_BPX_USERID環境変数を設定してジョブ名またはユーザーを変更できます。あるいは、Oracle GoldenGateプロセスに対してz/OSジョブまたは開始済タスク・プロシージャを作成できます。詳細は、『z/OS System Services Planning』を参照してください。

3.5 WLMベロシティ目標の割当て

Managerプロセスを起動するユーザーは、通常他のOracle GoldenGateプロセスを実行するユーザーです。Oracle GoldenGateの処理は、WLMサブシステム・タイプOMVSのフォークされた子プロセスとして表示されます。次のガイドラインに基づいて、Oracle GoldenGateプロセスにワークロード・マネージャ(WLM)ベロシティ目標を割り当てます。

- トランザクション・ログを読み取るExtractプロセスには、中程度(メインDB2アドレス空間のベロシティより下、ほとんどのオンライン・トランザクション、TSO/Eセッションおよびz/OSバッチ処理より上)のベロシティ目標を割り当てます。ベロシティ目標が高いほど、Extractが得るプロセッサ・パワーは多く、ラグは小さくなります。

- 初期ロードExtractプロセスにベロシティ目標を割り当てるか、通常のDB2バッチ・ジョブとして処理します。初期ロード・プロセスの詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。

- Replicatプロセスには、高いベロシティ目標を割り当てる必要があります。Replicatは通常のDB2バッチ・アプリケーションですが、バックログとレイテンシの発生を防ぐには、より多くの処理パワーが必要です。

- Oracle GoldenGateユーティリティ(DEFGEN、LOGDUMPなど)の実行はごくまれなため、他のUNIX端末向け処理と同様に実行できます。

- SQLEXECコマンドでストアド・プロシージャを実行する場合、Oracle GoldenGateのボトルネックにならないことを確認します。優先順位を、コール元のExtractまたはReplicatプロセスと同程度にします。WLMではその優先順位で実行されますが、z/OSシステムでは、DB2およびz/OSのシステム・プログラマによって定義されたストアド・プロシージャの優先順位で実行されます。

- Oracle GoldenGateをTSO/E OMVSコマンド下で実行する場合、Oracle GoldenGateプロセスは、システムとTSO/Eユーザー・アカウント(UNIXカーネルではなく)のWLM制限に依存します。端末入力に対するOMVSポーリング方法が原因で、最大20秒の非常に長いTSO/Eレスポンス時間(サービス消費が少ないことが多々ある)が、OMVSユーザーについて記録されることがあります。これは、レスポンス時間に基づいたWLM目標に影響を及ぼします。

複数のWLMサービス・クラスをOracle GoldenGateプロセスに対して使用できます。次に、相対優先順位が保持されるOracle GoldenGateとその他の処理の例を、優先順位の高いものから低いものの順に示します。

1. z/OSシステム・プロセス(UNIXカーネルとIRLMを含む)。

2. プライマリExtractグループに対するDB2 for z/OSアドレス空間。

3. オンラインまたはバッチの変更同期用に構成されているプライマリExtractグループと、それによってコールされるDB2ストアド・プロシージャ。

4. z/OSトランザクション・マネージャ(CICS、IMSなど)。

5. Extractデータ・ポンプ用Collector (Server)(使用されている場合)。

6. (証跡から読み取る)ローカルExtractデータ・ポンプ(使用されている場合)。

7. リモート証跡(リモート・サイトから受信されるファイル)用Collector。そのようなファイルには、NonStopシステムでExtract RMTBATCHパラメータによって作成されるQSAMファイルなどがあります。

8. オンラインReplicatグループとそれによってコールされるDB2ストアド・プロシージャ。

9. Managerプロセス(Oracle GoldenGateプロセスの起動と証跡のクリーンアップのためにのみ必要)。

10. GGSCIおよび他のユーザーのUNIXおよびTSO/E端末処理。

11. 初期ロードExtractとそれによってコールされるDB2ストアド・プロシージャ。

12. 初期ロードReplicatとそれによってコールされるDB2ストアド・プロシージャ。

13. 他のz/OSバッチ処理。

3.6 プロセスの監視

次に、z/OSシステムの機能を使用したOracle GoldenGateの監視に関する情報を示します。

Oracle GoldenGateメッセージの表示

Oracle GoldenGateプロセスの識別

更新操作の統計の解釈

更新操作の統計の解釈

3.6.1 Oracle GoldenGateメッセージの表示

システム・ログ・プロセス(syslogデーモンsyslogd)が実行されている場合、USSは、UNIXメッセージの優先順位に従って、構成されている宛先にOracle GoldenGateメッセージを転送します。syslogdの構成の詳細は、z/OS IP構成のドキュメントおよび『UNIX System Services Planning』を参照してください。

syslogdが実行されていない場合、Oracle GoldenGateは、コマンド出力、ステータス情報およびエラー・メッセージをシステム・コンソールに書き込みます。次のUNIXコマンドを使用して、コンソール・メッセージをOracle GoldenGate USSセッションおよびOracle GoldenGateレポート・ファイルにリダイレクトできます。

export _BPXK_JOBLOG=STDERR

3.6.2 Oracle GoldenGateプロセスの識別

システム管理機能(SMF)では、通常UNIXプロセス(Oracle GoldenGateプロセスを含む)ごとに別個のアカウンティング・レコードが作成されます。ただし、ユーザーがOMVSコマンドでデフォルトのSHAREASオプションを使用してUNIXシェルを起動した場合、またはユーザーが環境変数_BPX_SHAREASをYESに設定した場合、複数のプロセスが同じアドレス空間で実行される場合があります。SMFは、1つ目のプロセスにのみプロセスIDを付与しますが、リソース消費は、実行されているすべてのプロセスを対象に集計されます。Oracle GoldenGateの場合、これは、処理がManagerプロセス(mgrという名前)の下に記録される可能性が高いということです。

DB2アカウンティング・トレースがSMF宛先についてもアクティブな場合、DB2は、次のOracle GoldenGateプロセスごとにSMFアカウンティング・レコードを作成します。

- Extract

- Replicat

- Manager (Oracle GoldenGate表を保守する場合)。Oracle GoldenGate表の例としては、マーカー表やReplicatチェックポイント表があります。

- Oracle GoldenGate DBLOGINコマンドを発行してデータベースにログインするGGSCIセッション。

3.6.3 更新操作の統計の解釈

DB2データベースで実行されたDML操作の実際の数は、Oracle GoldenGateによってレポートされる、抽出されたDML操作の数と一致しない場合があります。更新文で行が物理的に変更されない場合、DB2はその更新文を記録しません。そのため、Oracle GoldenGateがそれを検出したり、統計に含めることはできません。

3.7 グローバリゼーション関数のサポート

Oracle GoldenGateでは、グローバリゼーション・サポートが提供されます。このサポートを使用する場合に考慮する必要のある事項を次に示します。

ASCIIとEBCDICの両方を含むソースからのレプリケート

オブジェクト名内のマルチバイト文字の指定

3.7.1 ASCIIとEBCDICの両方を含むソースからのレプリケート

DB2ソース・システムから異なる文字セットのターゲットにレプリケートする際、ASCIIデータとEBCDICデータが混在している場合は、DB2の文字データのエンコーディングになんらかの配慮が必要です。各Replicatによる文字セットの変換では、ソース・データが1つの文字セットのものである必要があります。

ソース文字セットは、証跡ヘッダーに指定されます。したがって、Oracle GoldenGate証跡には、ASCIIデータまたはEBCDICデータのいずれかを含むことができますが、両方を含むことはできません。Unicodeの表は特別な構成がなくても処理され、文字セットは1つという要件の対象外です。

両方の文字エンコーディング・タイプが含まれているソースについては、次のオプションがあります。

- すべての表に対して1つのExtractを使用し、 ASCIIまたはEBCDICのいずれかとして文字データを証跡に書き込ませます。

- 異なるExtract(ASCII文字データを証跡に書き込むExtractとEBCDIC文字データを別の証跡に書き込むExtract)を使用します。2つのデータ・ストリームが個別に処理されるよう、各証跡を独自のデータ・ポンプ・プロセスとReplicatプロセスに関連付けます。

いずれのシナリオでも正しい文字セットを出力するには、TRAILCHARSETASCIIおよびTRAILCHARSETEBCDICパラメータを使用します。デフォルトはTRAILCHARSETEBCDICです。これらのパラメータが使用されない場合、ASCIIおよびEBCDICデータはそのまま証跡に書き込まれます。これらのパラメータを使用する場合、次の点に注意してください。

- これらのパラメータがシングルバイトDB2サブシステムに対して使用される場合、Extractは、使用されているパラメータに応じて、接続先のサブシステムのASCIIまたはEBCDICのいずれかのシングルバイトCCSIDにすべての文字データを変換します(Unicodeは対象外で、Unicodeのまま処理されます)。

- マルチバイトDB2サブシステムに対して使用される場合、Extractは、ASCIIまたはEBCDICの表のみ(およびUnicode)を取得します。文字データは、Extractの接続先のDB2 z/OSサブシステムのASCIIまたはEBCDICのいずれか(使用されているパラメータに応じる)の混合CCSIDで書き込まれます。

3.7.2 オブジェクト名内のマルチバイト文字の指定

パラメータ・ファイル内のスキーマ、表、列またはストアド・プロシージャの名前にマルチバイト文字が含まれる場合、名前を二重引用符で囲む必要があります。オブジェクト名の指定の詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。

4 Oracle GoldenGateのためのDB2 for z/OSトランザクション・ログの準備

この章には、DB2トランザクション・ロギングを構成してOracle GoldenGate Extractによるデータ取得をサポートするために必要な情報が含まれます。

- 4.1項「ブートストラップ・データ・セットの指定」

- 4.2項「トランザクション・データを使用可能にする」

4.1 ブートストラップ・データ・セットの指定

ExtractプロセスはBSDSを使用して、非データ共有環境内のトランザクション・ログでの最初の位置を見つけます。Extractグループを作成する際、BSDSを指定します。BSDSは、Extractプロセスの接続先のDB2サブシステムのBSDSである必要があります。Oracle GoldenGateは、BSDSの指定の妥当性はチェックしません。

4.2 トランザクション・データを使用可能にする

Oracle GoldenGateは、アクティブ・ログとアーカイブ・ログからDB2トランザクション・データを抽出できます。次のガイドラインに従って、Extractがデータを取得できるようログを構成します。

変更の取得の有効化

ログ・レコードへのアクセスの有効化

ログのサイズ設定と保持

テープ上のアーカイブ・ログの使用

ログ・フラッシュの制御

4.2.1 変更の取得の有効化

次の手順に従って、CREATE TABLEおよびALTER TABLEコマンドのDATA CAPTURE CHANGES機能で提供される拡張形式でデータの変更が記録されるよう、DB2を構成します。この形式により、Oracle GoldenGateでは、更新文によって変更された行の変更前イメージと変更後イメージの全体を使用できます。

1. Oracle GoldenGateディレクトリからGGSCIを実行します。

2. ALTER TABLE権限を持つユーザーとしてGGSCIからDB2にログオンします。

DBLOGIN SOURCEDB DSN, USERID user[, PASSWORD password][, encryption_options]

3. 次のコマンドを発行します。tableは表の完全修飾名です。ワイルドカードを使用して複数の表の名前を指定できますが、所有者名には使用できません。

ADD TRANDATA table

デフォルトでは、ADD TRANDATAによって次のコマンドが発行されます。

ALTER TABLE name DATA CAPTURE CHANGES;

4.2.2 ログ・レコードへのアクセスの有効化

DB2 Monitor Trace Class 1をアクティブにし("TRACE(MONITOR) CLASS(1)")、DB2でExtractによるアクティブ・ログの読取りができるようにします。Oracle GoldenGateは宛先を使用しないため、OPXのデフォルトの宛先で十分です。

トレースを手動で開始する手順

1. TRACE権限、または最低でもSYSOPR権限を持つDB2ユーザーとしてDB2にログオンします。

2. 次のコマンドを発行します。

start trace(monitor) class(1) scope(group)

DB2の起動時に自動的にトレースを開始する方法

次のいずれかを行います。

- DSNTIPNインストール・トレース・パネルでMONITOR TRACEを"YES"に設定します。

- 『DB2 UDB Installation Guide』に記載されているように、DSNTIJUZインストール・ジョブで'DSN6SYSP MON=YES'を設定します。

注意:

ODBCプラン・エグゼキュータの1次許可IDまたはいずれかの2次許可IDにもMONITOR2権限がある必要があります。

4.2.3 ログのサイズ設定と保持

表がDATA CAPTURE CHANGESを使用して定義されている場合、DATA CAPTURE NONEを使用して定義されている場合より多くのデータが記録されます。次のいずれかに該当する場合、アクティブ・ログとアーカイブ・ログの数とサイズを増やす必要があります。

- アプリケーションで大量のDB2データを生成します。

- アプリケーションであまりコミットは発生しません。

- Extractを長時間停止することが想定されています。

- ネットワークが安定していないか、遅いです。

ログ保持を制御するには、DSNTIJUZインストール・ジョブでDSN6LOGP MAXARCHシステム・パラメータを使用します。

Extractを停止した後または計画外の停止の後、Extractがチェックポイントから再度起動できるように十分なログ・データを保持します。Extractは、コミットされていない最も古い作業単位の開始点を含むログ、およびそれ以降のすべてのログにアクセスできる必要があります。

処理時にExtractで必要なデータがオンラインまたはアーカイブのログに保存されていなかった場合、次のいずれかの修正処理が必要になる可能性があります。

- Extractを変更して、ログ・データが使用できる後の時点から取得します(さらにターゲットで起こり得るデータ損失を受け入れます)。

- ソース表とターゲット表を再同期してから、Oracle GoldenGate環境を再開します。

注意:

IBM社のドキュメントに、ログの読取りのパフォーマンスの改善に関する推奨が記載されています。特に、大規模なログ出力バッファ、大規模なアクティブ・ログおよびディスクへのアーカイブを使用できます。

4.2.4 テープ上のアーカイブ・ログの使用

Oracle GoldenGateはテープ上のDB2アーカイブ・ログを読み取ることはできますが、パフォーマンスは低下します。たとえば、DB2は、テープ上のアーカイブを1つのリカバリ・タスク用に確保します。その結果、リカバリが完了するまで、Extractは、表のリカバリに使用されるアーカイブ・テープを読み取ることができません。DFHSMまたは同様のツールを使用して、アーカイブ・ログをオンラインDASDストレージとテープとの間でシームレスに移動できますが、転送が完了するまでExtractは待機する必要があります。Extractの処理の遅れによってソース・データとターゲット・データとの間のレイテンシが増します。

4.2.5 ログ・フラッシュの制御

トランザクション・ログを読み取る際、Extractは、コミット・レコードを取得するまでトランザクションを処理しません。コミット・レコードが、一杯になっていないデータ・ブロックにある場合、さらにログ・アクティビティが生成されてブロックが一杯になるまでコミット・レコードは取得されません。Extractがログの読取りに使用するAPIでは、一杯になった物理データ・ブロックのみ取得されます。

コミットを含むブロックの取得の遅れによって、ソース・データとターゲット・データとの間でレイテンシが発生します。アプリケーションでブロックを一杯にするのに十分なログ・レコードが生成されない場合、Extractは、ブロックが一杯になって解放されるまで、SAVEPOINTおよびCOMMIT文を発行して独自のログ・レコードを生成します。

データ共有グループでは、各APIコールによって、DB2がすべてのアクティブなメンバーのデータ・ブロックをフラッシュし、Extractがフラッシュを行う必要がなくなります。

Extractでフラッシュが行われないようにするには、ExtractのパラメータTRANLOGOPTIONSのNOFLUSHオプションを使用します。

5 Oracle GoldenGateのアンインストール

この章には、システムからOracle GoldenGateを削除する場合のプラットフォーム固有の手順が含まれます。

内容は次のとおりです。

- 5.1項「LinuxまたはUNIX (USSを含む)からのOracle GoldenGateのアンインストール」

- 5.2項「WindowsクラスタからのOracle GoldenGateの削除」

- 5.3項「Windows(非クラスタ)からのOracle GoldenGateのアンインストール」

警告:

この手順は、Oracle GoldenGate証跡のデータが必要なくなり、現在のOracle GoldenGate環境を保持する必要がなくなった場合を前提としています。現在の環境およびデータを保持するには、この手順を開始する前にOracle GoldenGateディレクトリとすべてのサブディレクトリのバックアップを作成します。

5.1 LinuxまたはUNIX (USSを含む)からのOracle GoldenGateのアンインストール

次の手順に従って、IBM z/OSのソースまたはターゲット・システムから、またはz/OS上のDB2へのリモート配信に使用されるLinuxまたはUNIXシステムからOracle GoldenGateを削除します。

すべてのシステムで:

1. コマンド・シェルを実行します。

2. (推奨)システム管理者として、またはOracle GoldenGateコマンドを発行する権限とオペレーティング・システムからファイルおよびディレクトリを削除する権限を持つユーザーとしてログオンします。

3. ディレクトリをOracle GoldenGateのインストール・ディレクトリに変更します。

4. GGSCIを実行します。

5. すべてのOracle GoldenGateプロセスを停止します。

6. Managerプロセスを停止します。

ソース・システムで:

DBLOGINコマンドを使用してデータベースにログインし、DELETE TRANDATAコマンドを実行して表をDATA CAPTURE NONEに変更します。

Replicatチェックポイント表が存在する任意のシステムで:

DBLOGINコマンドを使用してデータベースにログインし、DELETE CHECKPOINTTABLEコマンドを実行してReplicatチェックポイント表を削除します。

すべてのシステムで:

1. すべてのプロセス(GGSCIを含む)が停止していることを確認します。

2. インストール・ディレクトリを削除してOracle GoldenGateファイルを削除します。

5.2 WindowsクラスタからのOracle GoldenGateの削除

次の手順に従って、IBM z/OSシステム上のDB2へのリモート配信に使用されるWindowsクラスタからOracle GoldenGateを削除します。

1. Managerリソースを含むクラスタ・グループを所有するクラスタのノードからGGSCIを実行し、まだ実行中のExtractおよびReplicatプロセスを停止します。

2. クラスタ・アドミニストレータ・ツールを使用してManagerリソースをオフラインにします。

3. リソースを右クリックし、「削除」を選択して削除します。

4. 「スタート」、「ファイル名を指定して実行」の順にクリックし、「ファイル名を指定して実行」ダイアログ・ボックスでcmdと入力して、コマンド・コンソールを開きます。

5. ディレクトリをOracle GoldenGateのインストール・ディレクトリに変更します。

6. 次の構文を使用してINSTALLユーティリティを実行し、Oracle GoldenGateイベントがWindowsのイベント・マネージャにレポートされないようにして、Managerサービスを削除します。

install deleteevents deleteservice

7. クラスタの次のノードにクラスタ・グループを移動し、手順4から繰り返します。

8. 5.3項「Windows(非クラスタ)からのOracle GoldenGateのアンインストール」の手順に従います。

5.3 Windows(非クラスタ)からのOracle GoldenGateのアンインストール

次の手順に従って、IBM z/OSシステム上のDB2へのリモート配信に使用されるWindowsシステムからOracle GoldenGateを削除します。

すべてのシステムで:

1. (推奨)システム管理者として、またはOracle GoldenGateコマンドを発行する権限とオペレーティング・システムからファイルおよびディレクトリを削除する権限を持つユーザーとしてログオンします。

2. Oracle GoldenGateインストール・フォルダからGGSCIを実行します。

3. すべてのOracle GoldenGateプロセスを停止します。

4. Managerプログラムまたはサービスを停止します。

5. 「スタート」、「ファイル名を指定して実行」の順にクリックし、「ファイル名を指定して実行」ダイアログ・ボックスでcmdと入力して、コマンド・コンソールを開きます。

6. ディレクトリをOracle GoldenGateのインストール・ディレクトリに変更します。

7. 次の構文を使用してINSTALLユーティリティを実行し、Oracle GoldenGateイベントがWindowsのイベント・マネージャにレポートされないようにして、Managerサービスを削除します。

install deleteevents deleteservice

ソース・システムで:

DBLOGINコマンドを使用してデータベースにログインし、DELETE TRANDATAコマンドを実行して表をDATA CAPTURE NONEに変更します。

Replicatチェックポイント表が存在する任意のシステムで:

DBLOGINコマンドを使用してデータベースにログインし、DELETE CHECKPOINTTABLEコマンドを実行してReplicatチェックポイント表を削除します。

すべてのシステムで:

すべてのプロセス(GGSCIを含む)が停止していることを確認し、インストール・ディレクトリを削除してOracle GoldenGateファイルを削除します。

A インストールされるOracle GoldenGateコンポーネント

この付録では、Oracle GoldenGateソフトウェアによってOracle GoldenGateインストール・ディレクトリで作成または使用されるプログラム、ディレクトリ、および他のコンポーネントについて説明します。特定のプラットフォームでは、ここに記載されていない追加ファイルがインストールされる場合があります。ここに記載されているファイルが、すべてのプラットフォームでインストールされるわけではありません。

この章の内容は次のとおりです。

- A.1項「Oracle GoldenGateプログラムおよびユーティリティ」

- A.2項「Oracle GoldenGateのサブディレクトリ」

- A.3項「その他のOracle GoldenGateのファイル」

- A.4項「Oracle GoldenGateチェックポイント表」

A.1 Oracle GoldenGateプログラムおよびユーティリティ

この項では、ルートのOracle GoldenGateインストール・ディレクトリにインストールされるプログラムについて説明します。

注意:

これらのプログラムがすべてのインストールに存在するとはかぎりません。たとえば、使用プラットフォーム用のOracle GoldenGateで取得または配信のみがサポートされている場合は、extractプログラムまたはreplicatプログラムが、それぞれインストールされません。同様に、特定のデータベースをサポートするための特別なファイルがインストールされる場合があります。

表A-1 インストールされるOracle GoldenGateプログラムおよびユーティリティ

プログラム

説明

convchk

チェックポイント・ファイルを新しいバージョンに変換します。

convprm

引用符で囲まれた名前およびリテラルについてSQL-92ルールを使用しないパラメータ・ファイルをSQL-92ルールを使用する更新されたパラメータ・ファイルに変換します。引用符で囲まれたオブジェクト名とリテラルに対するSQL-92形式は、Oracle GoldenGateのバージョン12cでデフォルトとして導入されました。

defgen

データ定義を生成します。この定義は、ソース表とターゲット表の定義が異なる場合にOracle GoldenGateのプロセスによって参照されます。

emsclnt

WindowsシステムまたはUNIXシステム上でCollectorおよびReplicatで作成されたイベント・メッセージを、NonStopシステム上のEMSに送信します。

extract

データベース表やトランザクション・ログからの取得を実行したり、ベンダー・アクセス・モジュールからトランザクション・データを受け取ります。

ggmxinstall

SQL/MXデータベース用のOracle GoldenGateインストール・スクリプト。

ggcmd

ggsciの関連プログラム。Oracle GoldenGate MonitorのJAGENTなどの外部アプリケーションを起動および監視します。それらのアプリケーションをggsci環境に統合します。

ggsci

コマンドの発行やパラメータ・ファイルの管理を行うためのOracle GoldenGateのユーザー・インタフェース。

ggsmgr.jcl

ggsmgr.proc

ggsmgrst.jcl

ggsmgrst.proc

z/OSシステムでバッチ・ジョブまたはオペレータ・コンソールからOracle GoldenGate Managerプロセスを起動します。DB2 z/OSデータベースをサポートするためにインストールされます。

install

Oracle GoldenGateをWindowsサービスとしてインストールし、他のWindowsベースのサービス・オプションを提供します。

keygen

データ暗号化鍵を生成します。

logdump

抽出証跡または抽出ファイルに格納される情報を表示および保存するためのユーティリティ。

mgr

(Manager)リソース管理、Oracle GoldenGateのプロセスの制御と監視、レポートおよびGGSCIインタフェースを使用したリクエストのルーティングに使用する制御プロセス。

oggerr

Oracle GoldenGateエラー・メッセージの管理。

replicat

ターゲット・データベース表にデータを適用します。

reverse

Replicatでターゲット表の変更を取り消して前の状態にリストアできるよう、トランザクション操作の順序を逆にするユーティリティ。

server

Collectorプロセス。リモート証跡にデータを書き込むExtract TCP/IPサーバー・コレクタ。

vamserv

TMF対応アプリケーションによって生成されたTMF監査証跡を読むために、Extractによって起動されます。NonStop SQL/MXデータベースをサポートするためにインストールされます。

A.2 Oracle GoldenGateのサブディレクトリ

この項では、Oracle GoldenGateインストール・ディレクトリのサブディレクトリとその内容について説明します。

注意:

これらのディレクトリがすべてのインストールに存在するとはかぎりません。

表A-2 Oracle GoldenGateのサブディレクトリ

ディレクトリ

説明

br

制限付きリカバリ機能用のチェックポイント・ファイルを格納します。

cfg

Oracle GoldenGate Monitorの構成に使用されるプロパティおよびXMLファイルを格納します。

dirdb

Oracle GoldenGate Monitorアプリケーションによって、またはOracle Enterprise Manager内で使用するためにOracle GoldenGateインスタンスから収集された情報の永続化に使用されるデータストアを格納します。

dirchk

ExtractおよびReplicatプロセスによって作成されたチェックポイント・ファイルを保持します。このファイルには、データの精度とフォルト・トレランスをサポートするため、現在の読取り位置と書込み位置が格納されます。Oracle GoldenGate内部形式で書かれます。

ファイル名の形式はgroup_name+sequence_number.extです。sequence_numberは古いファイルに付加される順序番号で、extはExtractのチェックポイント・ファイルのcpeまたはReplicatのチェックポイント・ファイルのcprです。

これらのファイルを編集しないでください。

例:

ext1.cpe

rep1.cpr

dircrd

資格証明ストア・ファイルを格納します。

dirdat

Extractプロセスによって作成されるOracle GoldenGateの証跡ファイルと抽出ファイルのデフォルトの場所。抽出されたデータをReplicatプロセスや他のアプリケーション、ユーティリティでさらに処理するために格納します。Oracle GoldenGate内部形式で書かれます。

ファイル名の形式は、ユーザーが定義した2文字の接頭辞の後に6桁の順序番号を続けたもの(証跡ファイル)か、ユーザーが定義した関連するExtractプロセス・グループの名前(抽出ファイル)です。

これらのファイルを編集しないでください。

例:

rt000001

finance

dirdef

異機種間の同期化環境で使用されるソース・データおよびターゲット・データの定義を保存するためにDEFGENユーティリティによって作成されるデータ定義ファイルのデフォルトの場所。外部ASCIIで書かれます。ファイル名の形式は、DEFGENパラメータ・ファイルで指定されたユーザー定義の名前です。

これらのファイルは、編集して、新規に作成された表の定義を追加できます。定義ファイルの編集方法がわからない場合は、Oracle GoldenGateのテクニカル・サポートに問い合せてください。

例:

defs.dat

dirdmp

内部アクティビティ・ロギング・メカニズムをサポートするトレース(ダンプ)・ファイルを格納します。

dirjar

Oracle GoldenGate MonitorをサポートするJava実行可能ファイルを格納します。

dirpcs

ステータス・ファイルのデフォルトの場所。ファイル名の形式は、group.extensionです。groupはグループの名前で、extensionはpce (Extract)、pcr (Replicat)、pcm (Manager)のいずれかです。

これらのファイルが作成されるのは、プロセスを実行している間だけです。ファイルにはプログラム名、プロセス名、ポート番号およびプロセスIDが示されます。

これらのファイルを編集しないでください。

例:

mgr.pcm

ext.pce

dirprm

Oracle GoldenGateプロセス・グループまたはユーティリティの実行時パラメータを格納する、Oracle GoldenGateユーザーによって作成されるOracle GoldenGateパラメータ・ファイルのデフォルトの場所。外部ASCII形式で書かれます。ファイル名の形式はgroup name/user-defined name.prmまたはmgr.prmです。

プロセスを停止した後、これらのファイルを編集して、Oracle GoldenGateパラメータ値を変更できます。テキスト・エディタから直接編集することも、GGSCIでEDIT PARAMSコマンドを使用して編集することもできます。

例:

defgen.prm

finance.prm

dirrec

Oracle GoldenGateでは使用されません。

dirrpt

実行される処理に関係のある統計情報を報告するために、Extract、Replicat、およびManagerプロセスによって作成されるプロセス・レポート・ファイルのデフォルトの場所。外部ASCII形式で書かれます。

ファイル名の形式は、group name+sequence number.rptです。sequence numberは古いファイルに付加される順序番号です。

これらのファイルを編集しないでください。

例:

fin2.rpt

mgr4.rpt

dirsql

triggenが非推奨になる前は、SQLスクリプトを格納するためにtriggenユーティリティにより使用されていました。現在は、Oracle GoldenGateをサポートするトレーニング・スクリプトおよびユーザーが作成したSQLスクリプトの格納に使用されます。

dirtmp

キャッシュ・マネージャに割り当てられているメモリー・サイズを超えた場合にトランザクション・データを格納するデフォルトの場所。これらのファイルを編集しないでください。

dirwlt

Oracle GoldenGateウォレット・ファイルを格納します。

UserExitExamples

ユーザー・イグジットの作成に便利なサンプル・ファイルを格納します。

A.3 その他のOracle GoldenGateのファイル

この項では、ルートのOracle GoldenGateインストール・ディレクトリに作成またはインストールされる、その他のファイル、テンプレートおよびオブジェクトについて説明します。

注意:

データベースおよびOSプラットフォームによっては、一部のファイルが使用環境にインストールされない場合があります。

表A-3 インストールされるその他のOracle GoldenGateのファイル

コンポーネント

説明

bcpfmt.tpl

Microsoft BCP/DTSバルク・ロード・ユーティリティの実行ファイルを作成する際、Replicatで使用するテンプレート。

bcrypt.txt

Blowfish暗号化ソフトウェア・ライセンス契約。

cagent.dll

Oracle GoldenGate Monitor CサブエージェントのWindowsダイナミック・リンク・ライブラリを格納します。

category.dll

INSTALLユーティリティによって使用されるWindowsダイナミック・リンク・ライブラリ。

chkpt_db_create.sql

ローカル・データベースにチェックポイント表を作成するスクリプト。データベース・タイプごとに異なるスクリプトがインストールされます。

db2cntl.tpl

IBM LOADUTILバルク・ロード・ユーティリティの制御ファイルを作成する際、Replicatで使用されるテンプレート。

ddl_cleartrace.sql

DDLトレース・ファイルを削除するスクリプト。(Oracleインストール)

ddl_ddl2file.sql

マーカー表からのDDLをファイルに保存するスクリプト。

ddl_disable.sql

Oracle GoldenGate DDLトリガーを無効にするスクリプト。(Oracleインストール)

ddl_enable.sql

Oracle GoldenGate DDLトリガーを有効にするスクリプト。(Oracleインストール)

ddl_filter.sql

Oracle GoldenGateでのDDLのフィルタリングをサポートするスクリプト。このスクリプトはプログラムで実行されます。手動で実行しないでください。

ddl_nopurgeRecyclebin.sql

Oracle GoldenGateのサポート・スタッフによって使用される空のスクリプト・ファイル。

ddl_ora11.sql

ddl_ora12.sql

Oracle GoldenGate DDLサポートの一部としてプログラムで実行されるスクリプト。これらのスクリプトは実行しないでください。

ddl_pin.sql

パフォーマンス向上のため、DDLトレース、DDLパッケージおよびDDLトリガーをピニングするスクリプト。(Oracleインストール)

ddl_purgeRecyclebin.sql

DDLレプリケーション機能をサポートするためにOracleのごみ箱をパージするスクリプト。

ddl_remove.sql

DDL抽出トリガーおよびパッケージを削除するスクリプト。(Oracleインストール)

ddl_session.sql

ddl_session1.sql

Oracle DDLオブジェクトのインストールをサポートします。このスクリプトはプログラムで実行されます。手動で実行しないでください。

ddl_setup.sql

Oracle GoldenGate DDL抽出およびレプリケーション・オブジェクトをインストールするスクリプト。(Oracleインストール)

ddl_status.sql

Oracle GoldenGate DDLサポート機能によって作成された各オブジェクトが存在し、正しく機能しているかを検証するスクリプト。(Oracleインストール)

ddl_staymetadata_off.sql

ddl_staymetadata_on.sql

Oracle DDLトリガーがメタデータを収集するかどうかを制御するスクリプト。このスクリプトはプログラムで実行されます。手動で実行しないでください。

ddl_trace_off.sql

ddl_trace_on.sql

DDLトレースがオンであるか、オフであるかを制御するスクリプト。

ddl_tracelevel.sql

DDLサポート機能のトレースのレベルを設定するスクリプト。(Oracleインストール)

debug files

トレースが有効だった場合に存在している可能性があるデバッグ・テキスト・ファイル。

demo_db_scriptname.sql

demo_more_db_scriptname.sql

チュートリアルおよび基本的なテストで使用するためのデモンストレーション表を作成し、移入するスクリプト。

.dmp files

トレースの目的でOracle GoldenGateのプロセスで作成されるダンプ・ファイル。

ENCKEYS

暗号化鍵を格納するユーザー作成ファイル。外部ASCII形式で書かれます。

exitdemo.c

ユーザー・イグジット例。

exitdemo_utf16.c

UTF16でエンコードされたデータを、ユーザー・イグジットとプロセスの間で交換される情報に対するコールバック構造で使用する方法を示すユーザー・イグジット例。

freeBSD.txt

FreeBSDのライセンス契約。

ggmessage.dat

Oracle GoldenGateプロセスによって返されるエラー・メッセージ、情報メッセージ、警告メッセージが含まれているデータ・ファイル。このファイルのバージョンは、プロセスの起動時にチェックされ、プロセスを動作させるためにはプロセスのバージョンと同一である必要があります。

ggserr.log

Oracle GoldenGateによって生成される、処理のイベント、メッセージ、エラーおよび警告を記録するファイル。

ggsmsg.dll

installプログラムによって使用されるWindowsダイナミック・リンク・ライブラリ。

GLOBALS

Oracle GoldenGateインスタンス全体に適用されるパラメータを格納するユーザー作成ファイル。

help.txt

GGSCIコマンド・インタフェースのヘルプ・ファイル。

icudtxx.dll

icuinxx.dll

icuucxx.dll

International Components for Unicode用のWindows共有ライブラリ。xxは、現在使用されているバージョンです。

jagent.bat

Oracle GoldenGate MonitorのJavaエージェントのWindowsバッチ・ファイル。

jagent.log

jagentjni.log

Oracle GoldenGate Monitorエージェントのログ・ファイル。

jagent.sh

Oracle GoldenGate MonitorのJavaエージェントのUNIXシェル・スクリプト。

LGPL.txt

Lesser General Public Licenseの条文。Free Software Foundationのフリー・ライブラリに適用されます。

libodbc.so

UNIX上のIngres 2.6用ODBCファイル。

libodbc.txt

libodbc.soのライセンス契約。

libxml2.dll

Oracle GoldenGate XMLプロシージャのXMLライブラリを含むWindowsダイナミック・リンク・ライブラリ。

libxml2.txt

libxml2.dllのライセンス契約。

marker.hist

NonStopソース・システムからマーカーが渡された場合にReplicatによって作成されるファイル。

marker_remove.sql

DDLマーカー表を削除するスクリプト。(Oracleインストール)

marker_setup.sql

Oracle GoldenGate DDLマーカー表をインストールするスクリプト。(Oracleインストール)

marker_status.sql

DDLマーカー表が正常にインストールされたことを確認するスクリプト。(Oracleインストール)

notices.txt

サードパーティ・ソフトウェアのライセンス・ファイル。

odbcinst.ini

UNIX上のIngres 2.6のODBC構成ファイル。

params.sql

DDLサポートのための構成可能なパラメータを含むスクリプト。(Oracleインストール)

pthread-win32.txt

pthread-VC.dllのライセンス契約。

pthread-VC.dll

Microsoft Windows用POSIXスレッド・ライブラリ。

prvtclkm.plb

Oracleの暗号化されたデータのレプリケーションをサポートします。

pw_agent_util.bat

pw_agent_util.sh

Oracle GoldenGate Monitorエージェントをサポートするスクリプト・ファイル。

role_setup.sql

Oracle GoldenGate DDLサポートに必要なデータベース・ロールを作成するスクリプト。(Oracleインストール)

sampleodbc.ini

UNIX上のIngres 2.6用サンプルODBCファイル。

sqlldr.tpl

Oracle SQL*Loaderバルク・ロード・ユーティリティの制御ファイルを作成する際、Replicatで使用されるテンプレート。

start.prm

stop.prm

Managerプロセスを起動および停止するz/OS paramlibメンバー。

startmgr

stopmgr

GGSCIからManagerプロセスを起動するz/OS UNIX System Servicesスクリプト。

startmgrcom

stopmgrcom

Managerプロセス用z/OSシステム入力コマンド。

tcperrs

TCP/IPエラーに対処するためのユーザー定義インストラクションが含まれているファイル。

usrdecs.h

ユーザー・イグジットAPI用のインクルード・ファイル。

xerces-c_2_8.dll

Apache XMLパーサー・ライブラリ。

zlib.txt

zlib圧縮ライブラリのライセンス契約。

A.4 Oracle GoldenGateチェックポイント表

データベース・チェックポイントを使用する場合、ADD CHECKPOINTTABLEコマンドを実行すると、Oracle GoldenGateによりユーザー定義名を使用してデータベースにチェックポイント表が作成されます。または、ユーザーがchkpt_db_create.sqlスクリプト(dbは、スクリプトでサポートされるデータベースのタイプの略号)を使用して表を作成することもできます。この表の詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2014, Oracle and/or its affiliates. All rights reserved.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.