SharePlex 11.4 - インストールおよびセットアップガイド

OracleからPostgreSQLへのレプリケーションを設定する

注意: これらの説明は、特に断りのない限り、PostgreSQLのすべての実装に適用されます。

概要

SharePlexは、Open Database Connectivity（ODBC）インターフェイスを介して、レプリケートされたOracleデータをPostgreSQLターゲットデータベースにポストすることができます。SharePlexは、PostgreSQLオープンソースデータベースのすべての実装をサポートしています。

これらの説明書には、このターゲットに固有のセットアップ手順が含まれています。これらのセットアップ手順を実行する前に、本マニュアルの適切な指示に従って、SharePlexをソースとターゲットにインストールします。

SharePlexを使用してこのターゲットにレプリケートする場合、サポート対象のバージョン、データ型、操作については、『SharePlexリリースノート』を参照してください。

列名の確認

あるデータベースタイプのソースと別のデータベースタイプのターゲットとの間のレプリケーションをサポートするには、ソースとターゲットの列名の大文字と小文字を同じにする必要があります（両方の列名を小文字に、または両方の列名を大文字にするなど）。ソース列名とターゲット列名で大文字と小文字が異なる場合は、列マッピング機能を使って設定ファイルの列名をマッピングします。

SharePlexによる列マッピングの詳細については、『SharePlex管理ガイド』を参照してください。

ソース上のSharePlexの設定

Oracleソースシステム上でSharePlexとデータベースをセットアップする必要があります。詳細な設定手順については、「ソース上のSharePlexの設定ページを参照してください。

ターゲット上でのSharePlexの設定

以下の手順を実行して、ターゲット上でSharePlexを構成します。

1. データベースのセットアップが、「Open Targetチェックリストページの要件をすべて満たしていることを確認します。

2. PostgreSQLのデータベースセットアップ（pg_setup）を実行して、SharePlexのデータベースアカウントと接続情報を確立します。詳細については、「PostgreSQLのデータベースセットアップページを参照してください。

OracleからSAP HANAへのレプリケーションを設定する

概要

SharePlexは、Open Database Connectivity（ODBC）インターフェイスを通じて、レプリケートされたOracleデータをMySQLまたはHANAターゲットデータベースにポストすることができます。

これらの説明書には、このターゲットに固有のセットアップ手順が含まれています。これらのセットアップ手順を実行する前に、本マニュアルの適切な指示に従って、SharePlexをソースとターゲットにインストールします。

SharePlexを使用してこのターゲットにレプリケートする場合、サポート対象のバージョン、データ型、操作については、『SharePlexリリースノート』を参照してください。

列名の確認

あるデータベースタイプのソースと別のデータベースタイプのターゲットとの間のレプリケーションをサポートするには、ソースとターゲットの列名の大文字と小文字を同じにする必要があります（両方の列名を小文字に、または両方の列名を大文字にするなど）。ソース列名とターゲット列名で大文字と小文字が異なる場合は、列マッピング機能を使って設定ファイルの列名をマッピングします。

SharePlexによる列マッピングの詳細については、『SharePlex管理ガイド』を参照してください。

ソース上のSharePlexの設定

Oracleソースシステム上でSharePlexとデータベースをセットアップする必要があります。詳細な設定手順については、「ソース上のSharePlexの設定ページを参照してください。

ターゲット上でのSharePlexの設定

以下の手順を実行して、ターゲット上でSharePlexを構成します。

1. データベースのセットアップが、「Open Targetチェックリストページの要件をすべて満たしていることを確認します。

2. HANAのデータベースセットアップ（hana_setup）を実行し、SharePlexのデータベースアカウントと接続情報を確立します。「HANAのデータベースセットアップページを参照してください。
3. その他の設定オプションについては、targetおよびtypemapコマンドを参照してください。

Oracleからその他のOpen Targetへのレプリケーションを設定する

概要

SharePlexは、ODBC（Open Database Connectivity）をサポートしているデータベースに接続することができます。

これらの説明書には、このターゲットに固有のセットアップ手順が含まれています。これらのセットアップ手順を実行する前に、本マニュアルの適切な指示に従って、SharePlexをソースとターゲットにインストールします。

SharePlexを使用してこのターゲットにレプリケートする場合、サポート対象のバージョン、データ型、操作については、『SharePlexリリースノート』を参照してください。

列名の確認

あるデータベースタイプのソースと別のデータベースタイプのターゲットとの間のレプリケーションをサポートするには、ソースとターゲットの列名の大文字と小文字を同じにする必要があります（両方の列名を小文字に、または両方の列名を大文字にするなど）。ソース列名とターゲット列名で大文字と小文字が異なる場合は、列マッピング機能を使って設定ファイルの列名をマッピングします。

SharePlexによる列マッピングの詳細については、『SharePlex管理ガイド』を参照してください。

ソース上のSharePlexの設定

Oracleソースシステム上でSharePlexとデータベースをセットアップする必要があります。詳細な設定手順については、「ソース上のSharePlexの設定ページを参照してください。

ターゲット上でのSharePlexの設定

以下のようにターゲットシステム上でSharePlexを設定し、データベースを設定します。

注意: データベースのセットアップが、「Open Targetチェックリストページの要件をすべて満たしていることを確認します。

ODBCドライバのインストール

お使いのデータベースに適したODBCドライバをダウンロードしてください。

ODBCのセットアップ

1. ターゲットデータベースに適したODBCドライバをインストールし、テストします。SharePlexには、SharePlexがODBCに接続し、ODBC経由でポストする機能をテストするためのOTSユーティリティがあります。詳細については、『SharePlexリファレンスガイド』のOTSのドキュメントを参照してください。

2. ターゲットシステム上で、Postがターゲットデータベースに接続するために使用するODBC接続情報を設定します。この接続情報の設定には以下のオプションがあります。

   • UnixとLinuxでは、以下のどちらかを実行できます。

     • データベースに付属の説明書に従って、ターゲットシステム上でユーザまたはシステムDSNを設定します。DSNを使用し、ターゲットデータベースに接続してテストします。接続に成功したら、ODBC設定ファイルをSharePlexの変数データディレクトリのodbcサブディレクトリにコピーします。LD_LIBRARY_PATH環境変数をデータベースODBCドライバの場所に設定します。

       または…

     • Postの設定でODBC接続情報を設定します。「connectionコマンドによる接続情報の設定」を参照してください。

connectionコマンドによる接続情報の設定

connectionコマンドは以下の目的で使用します。

• DSNを作成した場合は、Postのユーザ名とパスワードを設定する。
• DSNがない場合は、すべてのODBC接続情報を設定する。

接続情報を設定するには:

1. ターゲットデータベースにSharePlex用のユーザアカウントを作成します。このアカウントには、接続、データベースのメタデータ構造へのクエリ、SharePlexデータベースまたはスキーマ内のテーブルの作成と更新、すべてのDMLおよびサポートされているDDL操作を実行する権限を付与する必要があります。このユーザがSharePlex外のODBC経由でデータベースに正常に接続できることを確認してください。
2. sp_ctrlを実行します。

3. connectionコマンドを、setオプションを指定してキーワードごとに1回ずつ実行します。

   connection r.database_name set keyword=value

オプション1: DSNが存在する場合の入力

オプション2: DSNが存在しない場合の入力（UnixおよびLinux）

オプション3: DSNが存在しない場合の接続文字列（UnixおよびLinux）

接続コマンドの例

DSNが存在する場合

connection r.mydb set user=myuser

connection r.mydb set password=mypassword

connection r.mydb set dsn=mydsn

DSNが存在しない場合

connection r.mydb set user=myuser

connection r.mydb set password=mypassword

connection r.mydb set port=1234

connection r.mydb set server=server1

connection r.mydb set driver=/database/ODBC/lib/databasedriver.so

DSNが存在しないため、接続文字列を使用

connection r.mydb set user=myuser

connection r.mydb set password=mypassword

connection r.mydb set connect_string=”driver=/database/ODBC/lib/databasedriver.so;server=server1;port=1234;uid=myuser;pwd=mypassword”

接続値の削除

SharePlexの接続設定を削除するには、resetオプションを指定してconnectionを使用します。

特定の接続値を削除するには:

connection r.database_name reset keyword

すべての接続値を削除するには:

connection r.database_name reset

例:

connection r.mydb reset port

connection r.mydb reset

接続値の表示

SharePlexの接続設定を表示するには、showオプションを指定してconnectionを使用します。

データベースの接続値を表示するには:

connection r.database_name show

すべてのローカルデータベースの接続設定を表示するには:

connection show all

データ型のマッピング

レプリケートされたOracle ALTER TABLEコマンドをOpen Targetターゲットの正しいデータ型に正確にポストするために、SharePlexは、Oracleデータ型をターゲットデータベースのデフォルトデータ型にマッピングします。このマッピングを表示および変更するには、typemapコマンドを使用します。

注意: DML操作については、SharePlexはレプリケートされたデータの適切なデータ型マッピングを決定するために、ターゲットデータベースに問い合わせます。

typemapコマンドの詳細については、『SharePlexリファレンスガイド』を参照してください。

OracleからJMSへのレプリケーションを設定する

概要

SharePlex Postプロセスは、JMS（Java Messaging Service）のキューやトピックに接続して書き込むことができます。データは、データ定義、操作タイプ、変更された列値を含むXMLレコードとして書き込まれる。このデータは、ソース上で発生した一連の操作として順次書き込まれ、ターゲットデータベースに順次ポストされるか、外部プロセスやプログラムによって消費されます。

これらの説明書には、このターゲットに固有のセットアップ手順が含まれています。これらのセットアップ手順を実行する前に、本マニュアルの適切な指示に従って、SharePlexをソースとターゲットにインストールします。

SharePlexを使用してこのターゲットにレプリケートする場合、サポート対象のバージョン、データ型、操作については、『SharePlexリリースノート』を参照してください。

ソース上のSharePlexの設定

Oracleソースシステム上でSharePlexとデータベースをセットアップする必要があります。詳細な設定手順については、「ソース上のSharePlexの設定ページを参照してください。

ターゲット上でのSharePlexの設定

この手順では、Javaプロバイダをターゲットで確立します。また、JMSプロバイダに接続するようSharePlex Postプロセスを設定します。

前提条件

Java Runtime Environment（JRE）1.8以降。JRE 1.8（またはそれ以降）は必須であり、以下のオペレーティングシステムを除き、SharePlexとともにインストールされます。

• CentOS Linux 7.xおよび8.x
• Oracle Linux 7.xと8.x
• RHEL Linux 7.xおよび8.x

これらのシステムにSharePlexをインストールする前に、JRE 1.8（またはそれ以降）がインストールされていることを確認してください。SharePlexをインストールした後、bridge設定ファイルを修正して、JREバイナリを指すようにします。以下の各手順の「カスタムJRE」の手順を参照してください。

1.8より後のバージョンのJREの使用。1.8より後のバージョンのJREでコンパイルされたJMS Providerライブラリを使用する場合は、そのバージョンのJREを使用し、そのJREバイナリを指すようにブリッジ（Linux/Unix）設定ファイルを修正します。以下の各手順の「カスタムJRE」の手順を参照してください。

JMSターゲット上でのSharePlexの設定

これらの手順では、JMSキューまたはトピックにポストするために、SharePlex Postプロセスを設定します。

この手順の例では、以下のディレクトリ命名規則を使用します。

JMSターゲットへのポストを設定するには、以下を行います。

1. SharePlex/lib/providersの下にProvider用のディレクトリを作成します。次などを考慮します。

   shareplex/lib/providers/provider_name

   ProviderがActive MQの場合、パスは以下のようになります:

   shareplex/lib/providers/amq

2. 必要なクライアント・ライブラリ・ファイルをprovider_nameディレクトリにコピーします。

   例えば、ProviderがActive MQの場合、以下のJARファイルをamqディレクトリにコピーします。

   shareplex/lib/providers/amq/activemq-all.jar

   shareplex/lib/providers/amq/slf4j.jar

3. (カスタムJRE) JREのバージョンが1.8より後の場合は、JAVA_HOMEとJRE_HOME変数の値をJREのホームディレクトリへのパスに設定します。さらに、JAVA_HOMEパスをPATH変数に追加します。

4. （カスタムJRE）SharePlexとともにインストールされたJRE（1.8.0_312）以外のJREを使用している場合（つまり、SharePlexによってJREがOSにインストールされなかったか、1.8より後のJREバージョンを使用しなければならない場合）、bridge.iniまたはbridgeファイルを修正して、使用するJREバイナリを指すようにします。

   以下の方法を使う:

   • LinuxまたはUnixの場合:

     1. bridgeファイルは以下のディレクトリにあります。

        SharePlex/.app-modules/openbridge

     2. SharePlexのインストール時にインストールされたJREは、以下のディレクトリにあります。

        SharePlex/.app-modules/openbridge/jre

     3. bridgeファイルで_jvmオプション（例<_jvm="jre/bin/java"）を探し、現在のパスを、使用するJREのフルパスに置き換えます。相対パスではなく、JREへの絶対パスを指定する必要があります。

5. sp_copを開始します。(まだ設定を有効にしないでください）。
6. sp_ctrlを実行します。

7. targetコマンドを発行して、JMSキューまたはトピックにポストするようPostを設定します。targetコマンドで設定した値は、ターゲット上でどのようにインスタンス化するかをSharePlexに指示します。以下の例では、ユーザ定義値はイタリック体で示されています。これらの値は、JMS Providerとプロバイダ固有のJMSライブラリに固有の値に置き換えてください。

   必要に応じて、次のコマンドを入力します。プロパティと値の詳細については、「JMS設定の表示と変更」を参照してください。targetコマンドの詳細については、『SharePlexリファレンスガイド』を参照してください。

   JMSキューに投稿する場合:

   sp_ctrl> target x.jms set jms factory_class=factory_class

   sp_ctrl> target x.jms set jms provider_url=url

   sp_ctrl> target x.jms set jms lib_location=path

   例えば、Active MQを使用する場合、次のように設定します。

   sp_ctrl> target x.jms set jms lib_location=shareplex/lib/providers/amq

   sp_ctrl> target x.jms set jms queuename=JMS_topic_queuename

   JMSトピックに投稿する場合:

   sp_ctrl> target x.jms set jms factory_class=factory_class

   sp_ctrl> target x.jms set jms provider_url=url

   sp_ctrl> target x.jms set jms lib_location=path

   例えば、Active MQを使用する場合、次のように設定します。

   sp_ctrl> target x.jms set jms lib_location=shareplex/lib/providers/amq

   sp_ctrl> target x.jms set jms destination=topic

   sp_ctrl> target x.jms set jms queuename=JMS_topic_queuename

JMSレプリケーションのログを有効にする

先にレガシーフレームワークで使用したものとは異なるアプローチで、ロギングメカニズムを実装する必要がある。現在のバージョンでは、-OB_debugToLog,-OB_debugToConsoleパラメーターを削除しました。これにより、log4j2.propertiesファイル内のプロパティをリセットすることによって、ログ詳細の生成と保持をさらに制御できるようになりました。

JMSのログを有効にするには、以下の手順に従ってください:

1. <Prod/Opt_Directory>/.app-modules/openbridge/configuration/に移動し、log4j2.propertiesファイル内の必要なパラメーターを更新します。
2. SharePlexを再起動します。
3. フルデバッグを有効にするには、rootLogger.levelをAllに設定します。rootLogger.levelには、他にも使用可能な値があり、log4j2.propertiesファイルにコメントの形で記載されています。
4. コンソールのロギングを有効にするには、appender.console.filter.threshold.levelをAllに設定します。appender.console.filter.threshold.levelには、他にも使用可能な値があり、log4j2.propertiesファイルにコメントの形で記載されています。

注意: 標準のlog4j2.properties構文に従って、他のパラメーターを変更することができます。詳細は、以下のリンクを参照してください。
https://logging.apache.org/log4j/2.x/manual/configuration.html#Properties

JMS設定の表示と変更

JMSへの出力に関する現在のプロパティ設定を表示するには、以下のコマンドを使用します。

target x.jms show

プロパティ設定を変更するには、以下のコマンドを使用します。

target x.jms [queue queuename] set jms property=value

ここで:

• queue queuenameはPostキューの名前です。複数のPostプロセスがある場合は、このオプションを使用します。
• プロパティと値を下表に示します。

表1: JMSターゲットプロパティ

リカバリオプションの設定

JMSプロセスが突然中断したり、実行中のマシンが中断したりすると、行の変更がJMSターゲットに2度書き込まれる可能性があります。これに対処するためには、重複を検出して破棄する必要があります。

トランザクション内のすべての行変更操作のレコードは、同じトランザクションIDを持ち、シーケンスIDも付けられています。これらの属性は、それぞれidとmsgIdxであり、XML出力のtxn要素の下にあります（「XMLフォーマットの表示」を参照）。

トランザクションIDは、トランザクションがコミットされた時点のSCNであり、シーケンスIDは、トランザクション内の変更行のインデックスです。この2つの値は、復旧時にJMSキューに書き直された場合、同じ値であることが保証されます。

必要であれば、以下のコマンドを使用して、行変更レコードごとに追加のメタデータを含めるようにターゲットを設定できます。

target target [queue queuename] set metadata property[, property]

表2: オプションのJMSメタデータプロパティ

例

target x.jms set metadata time, userid, trans, size

メタデータをリセットするには、以下を行います。

target x.jms [queue queuename] reset metadata

メタデータを表示するには、以下を行います。

target x.jms [queue queuename] show metadata

メモリ設定の制御

複数の名前付きPostキューを通してJMSへの大量のトランザクションを処理するようにPostを設定した場合、Post JMS bridgeへのメモリ割り当ての増加が必要になる可能性があります。デフォルト設定は256 MBと512 MBです。

JMSブリッジのメモリを増やす:

openbridge.iniファイルを開き、以下のパラメーターを表示されているフォーマットで設定します。

-Xms=512m

-Xmx=1024m

-XX:PermSize=512m

-XX:MaxPermSize=1024m

デバッグの設定

キューやトピックへの各書き込みが成功したか失敗したかをログに記録するよう、Postを設定することができます。これはデバッグ設定でコントロールします。

デバッグを有効にするには、以下を行います。

openbridge.iniファイルを開き、-OB_debugToLogパラメーターをtrueに設定します。

-OB_debugToLog=true

XMLフォーマットの表示

SharePlexがJMSに送信するレコードのXMLフォーマットを表示するには、『SharePlexリファレンスガイド』でtargetコマンドのドキュメントのformatカテゴリを参照してください。