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

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

Oracle GoldenGateソフトウェアによってOracle GoldenGateインストール・ディレクトリで作成または使用されるプログラム、ディレクトリ、および他のコンポーネントについて説明します。

内容は次のとおりです。

Classic Architectureのコンポーネントの理解

親トピック: コンポーネントおよびその他の環境の理解

11.1 Classic Architectureのコンポーネントの理解

トピック:

親トピック: インストールされるOracle GoldenGateのコンポーネント

11.1.1 Oracle GoldenGate Classic Architectureのプログラムとユーティリティ

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

注意:

これらのプログラムがすべてのインストールに存在するとはかぎりません。たとえば、ご使用のプラットフォームで取得または配信のみがOracle GoldenGateによってサポートされる場合には、ExtractプログラムまたはReplicatプログラムはそれぞれインストールされません。

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

プログラム	説明
`convchk`	チェックポイント・ファイルを新しいリリースに変換します。
`convprm`	引用符で囲まれた名前およびリテラルにSQL-92ルールを使用しないパラメータ・ファイルを、SQL-92ルールを使用する更新されたパラメータ・ファイルに変換します。引用符で囲まれたオブジェクト名およびリテラルのSQL-92形式がデフォルトとしてOracle GoldenGateの12cリリースに導入されています。
`defgen`	データ定義が生成され、この定義は、ソース表とターゲット表の定義が異なる場合にOracle GoldenGateのプロセスによって参照されます。
`extract`	データベース表またはトランザクション・ログからキャプチャを実行するか、ベンダーのアクセス・モジュールからトランザクション・データを受信します。
`ggcmd`	`ggsci`のプログラムに関連付けられています。Oracle GoldenGate MonitorのJAgentなどの外部アプリケーションを起動して監視します。これらのアプリケーションをGGSCI環境に統合します。
`ggsci`	コマンドの発行やパラメータ・ファイルの管理に使用するOracle GoldenGateへのユーザー・インタフェース。
`install`	Oracle GoldenGateをWindowsサービスとしてインストールし、Windowsベースのその他のサービス・オプションを提供します。
`keygen`	データ暗号化キーを生成します。
`logdump`	抽出証跡または抽出ファイルに格納される情報を表示および保存するためのユーティリティ。
`mgr`	リソース管理、Oracle GoldenGateのプロセスの制御と監視、レポートおよびGGSCIインタフェース経由のリクエストのルーティングに使用する(Manager)制御プロセス。
`oggerr`	Oracle GoldenGateのエラー・メッセージを管理します。
`replicat`	データをターゲット・データベースの表に適用します。
`reverse`	トランザクション操作の順序を保持するユーティリティ。これによって、Replicatを使用してターゲット表の変更を取り消し、それらの表を前の状態に復元できるようになります。
`server`	Collectorプロセス。これは、データをリモート証跡に書き込むExtract TCP/IPサーバー・コントローラです。

親トピック: Classic Architectureのコンポーネントの理解

11.1.2 Oracle GoldenGateのサブディレクトリ

Oracle GoldenGate Classic Architectureインストール・ディレクトリのサブディレクトリについて説明します。これはOracle GoldenGate Microservices Architectureには適用されません。

表11-2 Oracle GoldenGate Classic Architectureのインストール・サブディレクトリ

ディレクトリ	説明
`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`	Replicatプロセスまたは別のアプリケーションやユーティリティによる追加処理に抽出されたデータを保存するためにExtractプロセスによって作成される、Oracle GoldenGateの証跡ファイルおよび抽出ファイルのデフォルトの場所です。Oracle GoldenGateの内部形式で書き込まれます。ファイル名形式は、ユーザー定義の2文字の接頭辞とそれに続く6桁の順序番号(証跡ファイル)または関連付けられたExtractプロセス・グループ(抽出ファイル)です。これらのファイルは編集しないでください。例: `rt000001` `finance`
`dirdef`	`DEFGEN`ユーティリティで作成される、異機種同期環境で使用されるソースまたはターゲットのデータ定義を保持するデータ定義ファイルのデフォルトの場所。外部ASCIIで書き込まれます。ファイル名の形式は、`DEFGEN`パラメータ・ファイルで指定されたユーザー定義の名前です。これらのファイルを編集して、新たに作成された表の定義を追加できます。定義ファイルの編集方法がわからない場合には、Oracle GoldenGateのテクニカル・サポートに問い合せてください。例: `defs.dat`
`dirdmp`	内部アクティビティ・ロギング・メカニズムをサポートするトレースまたはダンプ、ファイルを格納します。このディレクトリはClassic Architectureのみに適用されます。「Oracle GoldenGate Classic Architectureの概要」を参照してください。
`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`	Oracle GoldenGateをサポートするトレーニング・スクリプトおよびユーザー作成のSQLスクリプトを格納します。
`dirtmp`	キャッシュ・マネージャに割り当てられたメモリー・サイズを上回る場合に、トランザクション・データを保存するデフォルトの場所です。これらのファイルは編集しないでください。
`dirwlt`	Oracle GoldenGateウォレット・ファイルを格納します。
`UserExitExamples`	ユーザー・イグジットの作成を支援するサンプル・ファイルが含まれます。

親トピック: Classic Architectureのコンポーネントの理解

11.1.3 その他のOracle GoldenGateのファイル

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

表11-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トリガーを無効にするスクリプト。
`ddl_enable.sql`	Oracle GoldenGateのDDLトリガーを有効にするスクリプト。
`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トリガーを固定するスクリプト。
`ddl_purgeRecyclebin.sql`	DDLのレプリケーション機能のサポートでOracleのごみ箱をパージするスクリプト。
`ddl_remove.sql`	DDL抽出トリガーおよびパッケージを削除するスクリプト。
`ddl_session.sql` ddl_session1.sql	OracleのDDLオブジェクトのインストールをサポートします。このスクリプトはプログラムで実行されるため、手動で実行しないでください。
`ddl_setup.sql`	Oracle GoldenGateのDDL抽出オブジェクトおよびレプリケーション・オブジェクトをインストールするスクリプト。
`ddl_status.sql`	Oracle GoldenGateのDDLサポート機能によって作成される各オブジェクトが存在し、正しく機能するかどうかを確認するスクリプト。
`ddl_staymetadata_off.sql` `ddl_staymetadata_on.sql`	OracleのDDLトリガーでメタデータを収集するかどうかを制御するスクリプト。このスクリプトはプログラムで実行されるため、手動で実行しないでください。
`ddl_trace_off.sql` `ddl_trace_on.sql`	DDLのトレースをオンにするかオフにするかを制御するスクリプト。
`ddl_tracelevel.sql`	DDLサポート機能のトレース・レベルを設定するスクリプト。
`debug files`	トレースがオンになった場合に存在する可能性があるデバッグ・テキスト・ファイル。
demo_`db`_`scriptname`.sql demo_`more`_`db`_`scriptname`.sql	チュートリアルや基本のテストで使用するデモンストレーション表を作成および移入するスクリプト。
`.dmpファイル`	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のJAgent用のWindowsバッチ・ファイル。
`jagent.log` `jagentjni.log`	Oracle GoldenGate Monitorエージェントのログ・ファイル。
`jagent.sh`	Oracle GoldenGate MonitorのJAgent用の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_remove.sql`	DDLマーカー・ファイルを削除するスクリプト。
`marker_setup.sql`	Oracle GoldenGateのDDLマーカー表をインストールするスクリプト。
`marker_status.sql`	DDLマーカー表が正常にインストールされたことを確認するスクリプト。
`notices.txt`	サード・パーティ・ソフトウェアのライセンス・ファイル。
`odbcinst.ini`	UNIX上のIngres 2.6のODBC構成ファイル。
`params.sql`	DDLサポートの構成可能なパラメータを含むスクリプト。
`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サポートに必要なデータベース・ロールを作成するスクリプト。
`sampleodbc.ini`	UNIX上のIngres 2.6用サンプルODBCファイル。
`sqlldr.tpl`	Oracle SQL*Loader一括ロード・ユーティリティに制御ファイルを作成する際にReplicatで使用するテンプレート。
`tcperrs`	TCP/IPエラーに対応するユーザー定義の指示を含むファイル。
`usrdecs.h`	ユーザー・イグジットAPI。
`xerces-c_2_8.dll`	Apache XMLのパーサー・ライブラリ。
`zlib.txt`	`zlib`圧縮ライブラリのライセンス契約。

親トピック: Classic Architectureのコンポーネントの理解