Oracle® GoldenGate Application Adapters

Oracle GoldenGateアダプタのインストール

リリース12c (12.1.2.1.1)

E67384-01(原本部品番号:E61859-01)

2015年5月

このドキュメントでは、Oracle GoldenGateアダプタの新しいインスタンスのインストール方法について説明します。

このドキュメントの内容は次のとおりです。

- 1項「インストールの準備」

- 2項「Oracle GoldenGateアダプタのインストール」

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

1 インストールの準備

正しいバージョンのJavaがインストールされ、環境変数が正しく設定および構成されていることを確認して、Java環境を準備します。

1.1 Javaのインストール

Oracle GoldenGateアダプタは、Java 1.7で動作保証されています。Oracle GoldenGate for Javaをインストールおよび実行する前に、Java (JDKまたはJRE)バージョン1.7以降をインストールする必要があります。Java Runtime Environment (JRE)または完全なJava Development Kit (JREに付属)を使用できます。

1.2 環境変数の設定

Oracle GoldenGate for JavaのJava環境を構成する手順:

- Java Runtimeを検索できるようにPATH環境変数を構成する必要があります。

- 共有(動的にリンクされた) Java仮想マシン(JVM)ライブラリも特定する必要があります。

Windowsでは、これらの環境変数をシステム変数として設定し、Linux/UNIXでは、グローバルまたはOracle GoldenGateプロセスを実行しているユーザーに設定する必要があります。WindowsおよびUNIX/Linuxでこれらの環境変数を設定する例は、次のとおりです。

注意:
Javaのインストール時にインストールされるJVMのバージョンは2つあり、1つはJAVA_HOME/.../client、もう1つはJAVA_HOME/.../serverにあります。パフォーマンスの改善のために、サーバー・バージョンが利用可能な場合は使用します。Windowsでは、(JDKではなく) JREのみがインストールされている場合に、クライアントJVMがそこに存在する可能性があります。

1.2.1 Windows上のJava

Javaをインストールしたら、JREおよびJVM DLL (jvm.dll)を特定できるようにPATHを構成します。

例1 WindowsでのJavaのパスの構成

set JAVA_HOME=C:\Program Files\Java\jdk1.7.0
set PATH=%JAVA_HOME%\bin;%PATH%
set PATH=%JAVA_HOME%\jre\bin\server;%PATH%

前述の例では、ディレクトリ%JAVA_HOME%\jre\bin\serverにファイルjvm.dll.が含まれるようにしてください。

コマンド・プロンプトを開いて、Javaバージョンをチェックし、環境設定を確認します。

C:\> java -version
java version "1.7.0_30" Java(TM) SE Runtime Environment (build 1.7.0_30-b13)

1.2.2 Linux/UNIX上のJava

PATHでJREを特定できるように環境を構成し、システムの適切な環境変数を使用してJVM共有ライブラリを構成します。たとえば、Linux (およびSolarisなど)では、次のように、JVM共有ライブラリを格納するディレクトリが含まれるようにLD_LIBRARY_PATHを設定します(sh/ksh/bash)。

例2 LinuxでのJavaのパスの構成

export JAVA_HOME=/opt/jdk1.7
export PATH=$JAVA_HOME/bin:$PATH
export LD_LIBRARY_PATH=$JAVA_HOME/jre/lib/i386/server:$LD_LIBRARY_PATH

前述の例では、ディレクトリ$JAVA_HOME/jre/lib/i386/serverにファイルlibjvm.soが含まれるようにしてください。JVMライブラリを格納する実際のディレクトリは、OSおよび使用するJVMが32ビットか64ビットかによって異なります。

コマンド・プロンプトを開いて、Javaバージョンをチェックし、環境設定を確認します。

$ java -version
java version "1.7.0_30"
Java(TM) SE Runtime Environment (build 1.7.0_30-b02)

2 Oracle GoldenGateアダプタのインストール

Oracle GoldenGateアダプタをインストールするには、オペレーティング・システムおよびプラットフォームのビルドのzipファイルをダウンロードし、インストール手順に従います。

2.1 インストールの概要

この項では、インストールの内容およびOracle GoldenGateアダプタで使用されるOracle GoldenGateインスタンスの概要について説明します。

2.1.1 インストールzipファイルの内容

Oracle GoldenGateアダプタのインストールzipファイルの内容は次のとおりです。

- Oracle GoldenGate Javaアダプタ

- Oracle GoldenGateフラット・ファイル・アダプタ。

- アダプタの実行用に設計されたOracle GoldenGateのバージョン。このバージョンは、データベース固有ではなく、プラットフォーム依存であるため、汎用のラベルが付いている場合があります。

2.1.2 Oracle GoldenGateの汎用ビルドの使用

JMS取得の場合、JavaアダプタはOracle GoldenGateの汎用ビルドで実行する必要があります。ただし、証跡データをターゲットに配信するのにアダプタを使用する場合、汎用ビルドは不要です。この場合、Oracle GoldenGateフラット・ファイルまたはJavaアダプタを任意のデータベース・バージョンのOracle GoldenGateで使用できます。

2.1.3 Oracle GoldenGateの非汎用インスタンスを使用する場合の考慮事項

非汎用のOracle GoldenGateインスタンスにアダプタをインストールする場合、メリットとデメリットの両方があります。また、アダプタのリリースと互換性のあるOracle GoldenGateコアのリリースにも制限があります。

メリット

- 非汎用のインスタンスでは、メタデータのデータベースにログインするようにExtractを構成できます。これにより、ソース・データベースDDLと同期する必要のあるソース定義ファイルを使用する必要がなくなります。

- また、データベースの取得およびJMS配信を同じサーバーで実行する場合に、個別の2つのバージョンのOracle GoldenGateを管理する必要もありません。

デメリット

- Oracle GoldenGateコア・インスタンスにパッチを適用する必要がある場合は、パッチを適用した新しいOracle GoldenGateのインストールにアダプタをコピーする必要もあります。

- Oracle GoldenGateアダプタは、汎用バージョンのOracle GoldenGateコアでのみテストおよび動作保証されます。コアの新しいパッチにより、互換性がなくなる場合があります。

制限事項

- Oracle GoldenGateアダプタは、同じメジャー・リリースのOracle GoldenGateインスタンスでのみインストールできます。したがって、11.1.xリリースのアダプタは、11.1.xリリースのOracle GoldenGate (11.2.xの場合は11.2.x、12.1.2.xの場合は12.1.2.x)にのみインストールできます。

- これは、VAMをロードできるExtractのバージョンのみであるため、汎用ビルドはJMS取得で使用する必要があります。

- DEFGENユーティリティは、アダプタに付属していません。ソース定義を生成するには、データベース・タイプに専用に構築されたOracle GoldenGateのバージョンが必要です。

2.1.4 Oracle GoldenGateの非汎用インスタンスのへのインストール

Javaユーザー・イグジットをOracle GoldenGateの非汎用インスタンスにインストールする場合は、最初に一時的な場所に解凍してから、アダプタ・ファイルをOracle GoldenGateインストールの場所にコピーします。

これを行うには、次の手順に従います。

1. Oracle GoldenGateインストールのzipファイルを一時ディレクトリに解凍します。

2. Oracle GoldenGateインストールのzipファイルをOracle GoldenGateのインストール・ディレクトリに解凍します。

3. 一時ディレクトリのggjavaサブディレクトリからOracle GoldenGateのインストール・ディレクトリにファイルをコピーまたは移動します。

4. 一時的な場所からOracle GoldenGateのインストール・ディレクトリに共有ライブラリをコピーまたは移動します。

5. オプションで、Gendefおよびflatfilewriter.soまたはflatfilewriter.dllをコピーすることもできます。(汎用ビルドでのみ動作するため、共有ライブラリggjava_vamをコピーする必要はありません。)

6. 一時ディレクトリを削除します。

2.2 Oracle GoldenGateアダプタのダウンロード

Oracle GoldenGateアダプタは、Windows、LinuxおよびUNIX (32および64ビット)で使用できます。ダウンロードするには、最初にOracleサポート・サイトにアクセスし、使用するオペレーティング・システムおよびアーキテクチャに利用できるパッチがあるかどうかを確認します。

注意:
インストールに含まれる汎用ビルドを使用しない場合は、ダウンロードするOracle GoldenGateアダプタのビルドのメジャー・リリースが、一緒に使用するOracle GoldenGateインスタンスのメジャー・リリースに一致する(互換性がある)ことを確認します。

1. http://support.oracle.comに移動します。

2. Oracle IDとパスワードでサインインします。

3. 「Patches and Upgrades」タブを選択します。

4. 「Search」タブで、「Product or Family」をクリックします。

5. 「Product」フィールドに、「Oracle GoldenGate Application Adapters」と入力します。

6. 「リリース」ドロップダウン・リストから、ダウンロードするリリースのバージョンを選択します。

7. 次のフィールドに「Platform」がデフォルトで表示されていることを確認したら、ドロップダウン・リストからプラットフォームを選択します。

8. 最後のフィールドは空のままにします。

9. 「Search」をクリックします。

10. 「Advanced Patch Search Results」リストで、指定した基準を満たす使用可能なビルドを選択します。

11. 「File Download」ダイアログ・ボックスで、zipファイルをクリックしてダウンロードを開始します。

利用可能なパッチがサポート・サイトにない場合は、リリースのダウンロード用のOracle配信サイトにアクセスします。

1. http://edelivery.oracle.comに移動します。

2. Oracle IDとパスワードでサインインします。

3. 「Terms and Restrictions」ページで、次のようにします。

- 「トライアル・ライセンス契約」を受諾します(永久ライセンスを所有している場合も受諾)。

- 「輸出規制」を受諾します。

- 「Continue」をクリックします。

4. 「メディア・パック検索」ページで次の操作を実行します。

- 「Oracle Fusion Middleware」製品パックを選択します。

- ソフトウェアをインストールするプラットフォームを選択します。

- 「Go」をクリックします。

5. 「Results List」で、次のようにします。

- 使用するOracle GoldenGate Applications Adaptersメディア・パックを選択します。

- 「Continue」をクリックします。

6. 「Download」ページで、次のようにします。

- Readmeファイルを表示します。

- 該当する各コンポーネントの「Download」をクリックします。自動ダウンロード・プロセスに従って、zipファイルをシステムに転送します。

注意:
リリース・ノートがダウンロードに付属している場合もありますが、付属していない場合もあります。そうない場合は、Oracle Technical Network (OTN)のドキュメント・ライブラリで確認できます。Readmeにリリース・ノートのリンクがあるはずです。

2.3 ディレクトリ構造

次の表は、インストール・ファイルを解凍してサブディレクトリを作成した場合のサブディレクトリおよびファイルを含むサンプルです。次の表記規則が使用されています。

- サブディレクトリは、角カッコ([])で囲まれてています。

- レベルは、パイプとハイフン(|-)で示されます。

- 内部の表記は、変更できない読取り専用のディレクトリを示します。

- テキスト・ファイル(*.txt)はリストに含まれていません。

- Defgen、Logdump、KeygenなどのOracle GoldenGateユーティリティは、リストには含まれていません。

表1 サンプルのインストール・ディレクトリ構造

ディレクトリ

説明

[gg_install_dir]

C:/ggs (Windows)または/home/user/ggs (UNIX)などのOracle GoldenGateインストール・ディレクトリ。

|-ggsci

プロセスの起動。停止および管理に使用されるコマンドライン・インタフェース。

|-mgr

Managerプロセス。

|-extract

Javaアプリケーションまたはフラット・ファイル・ライターを起動するExtractプロセス。

|-[AdapterExamples]

Javaユーザー・イグジット、Java API、フラット・ファイル・ライターおよびJMS取得アダプタのサンプルの構成ファイル。

|-[UserExitExamples]

サンプルのCプログラミング言語ユーザー・イグジット・コードの例。

|-[dirprm]

ユーザーによって作成されるすべてのパラメータ・ファイルおよびプロパティ・ファイルを保持するサブディレクトリ。例:

javaue.prm
javaue.properties
jmsvam.prm
jmsvam.properties
ffwriter.prm

|-[dirdef]

証跡のメタデータを定義するソール定義ファイル(*.def)を保持するサブディレクトリ。

- ユーザー・イグジット証跡データ用にDefgenコア・ユーティリティによって作成されます。

- VAMメッセージの取得用にGendefアダプタ・ユーティリティによって作成されます。

|-[dirdat]

VAM Extractによって生成、またはユーザー・イグジットExtractによって読み取られる証跡ファイルを保持するサブディレクトリ。

|-[dirrpt]

ログおよびレポート・ファイルを保持するサブディレクトリ。

|-[dirchk]

内部: チェックポイント・ファイルを保持するサブディレクトリ。

|-[dirpcs]

内部: 処理ステータス・ファイルを保持するサブディレクトリ。

|-[dirjar]

内部: Oracle GoldenGate Monitor jarファイルを保持するサブディレクトリ。

|-[ggjava]

内部: Java jarのインストール・ディレクトリ。読取り専用のため、変更しないでください。

|-|-ggjava.jar

クラス・パスおよび依存性を定義するメインのJavaアプリケーションjar。

|-|-[resources]

すべてのggjava.jar依存性を格納するサブディレクトリ。次のサブディレクトリを含みます。

- [class] - プロパティおよびリソース

- [lib] - ggjava.jarで必要なアプリケーションjar

|-ggjava_ue.dll

ユーザー・イグジット共有ライブラリ。UNIXではlibggjava_ue.soになります。

|-ggjava_vam.dll

VAM共有ライブラリ。UNIXではibggjava_vam.soになります。

|-gendef

JMSメッセージ入力のメタデータを格納するアダプタ・ソース定義ファイルを生成するためのユーティリティ。これは、証跡の入力メタデータを格納するソース定義を作成するOracle GoldenGate Defgenユーティリティとは異なるので注意してください。

|-flatfilewriter.dll

Oracle GoldenGateフラット・ファイル・アダプタ用のWindows dllまたはUNIX soライブラリ。

|-. . .

インストールに含まれるか、後で作成されるその他のサブディレクトリおよびファイル。

2.4 インストール手順

次の手順を実行して、Oracle GoldenGateアダプタをインストールします。

1. 名前に空白のないインストール・ディレクトリを作成します。次に、zipファイルを新しいインストール・ディレクトリに解凍します。例:

Shell> mkdir installation_directory
Shell> cp path/to/installation_zip installation_directory
Shell> cd installation_directory
Shell> unzip installation_zip

LinuxまたはUNIXの場合は、次のようにもします。

Shell> tar -xf installation_tar

これにより、2.3項「ディレクトリ構造」の複数のサブディレクトリに、ファイルがダウンロードされます。

2. インストール・ディレクトリで、GGSCIを起動して、残りのサブディレクトリをインストールの場所に作成します。

3. Shell> ggsci
GGSCI> CREATE SUBDIRS

4. Managerパラメータ・ファイルを作成します。

GGSCI> EDIT PARAM MGR

5. エディタを使用して、Managerパラメータ・ファイルに行を追加し、リスニングするManagerのポートを指定します。例:

PORT 7801

6. WindowsでManagerをサービスとして実行している場合は、jvm.dllが含まれるようにシステム変数PATHを設定し、Managerサービスを削除して再追加します。

7. GGSCIに移動して、Managerを起動し、実行されていることを確認します。

GGSCI>START MGR
GGSCI>INFO MGR

注意:
実行時にJVMを特定する場合に環境変数の問題をチェックする手順:

- パラメータGETENV(PATH) (Windows)またはGETENV(LD_LIBRARY_PATH) (UNIX)をExtractパラメータ・ファイルに追加します。

- Extractプロセスを起動します。

- GGSCIコマンドSEND EXTRACT group_name REPORTを使用して、レポートの出力をチェックします。

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

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

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アダプタ・リリース12c (12.1.2.1.1)のインストール

E67384-01

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

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

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

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

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.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(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の登録商標です。

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

オラクル社の法律上の注意点について

コピーライトについて

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

商標と登録商標について

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の登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

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

保証免責

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

制限付権利

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

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.

危険な用途への使用について

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

第三者のコンテンツ、製品、サービスに対する免責事項

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

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。