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を参照してください。