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) GGSCIインタフェースを使用してリソース管理、Oracle GoldenGateプロセスの制御と監視、レポート作成、およびリクエストのルーティングを行う制御プロセス。
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システム・サービス・スクリプト。
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を参照してください。