ヘッダーをスキップ

Oracle TimesTen In-Memory Database APIおよびSQLリファレンス・ガイド リリース6.0 B25770-01 |
| 目次 | 索引

前へ | 次へ |

## ttRepAdmin

説明

既存のレプリケーション定義を表示し、レプリケーション・ステータスを監視します。『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』で説明しているように、新しいリリースのTimesTenへのアップグレードにも、ttRepAdminユーティリティを使用できます。

アクセス制御

アクセス制御がTimesTenのインスタンスに対して有効である場合、このユーティリティではADMIN権限またはデータ・ストア・オブジェクトの所有権が必要です。接続文字列またはDSNに認証情報が指定されない場合、続行する前にユーザーIDおよびパスワードの入力が求められます。

構文

    ttRepAdmin [-h | -help]
    ttRepadmin [-V | -version]
    ttRepAdmin -self [-list] [-scheme [owner.]schemeName]
          {DSN | -connStr connectionString}

    ttRepAdmin -receiver [-name receiverName]
          [-host receiverHostName] [-state receiverState] [-reset]
          [-list] [-scheme [owner.]schemeName]
          {DSN | -connStr connectionString}

    ttRepAdmin -log {DSN | -connStr connectionString}
    ttRepAdmin -showstatus {DSN | -connStr connectionString}
    ttRepAdmin -showconfig {DSN | -connStr connectionString}
    ttRepAdmin -bookmark {DSN | -connStr connectionString}
    ttRepAdmin -wait [-name receiverName] [-host receiverHostName]
          [-timeout seconds] {DSN | -connStr connectionString}

    ttRepAdmin -duplicate -from srcDataStoreName
          -host srcDataStoreHost [-memcpy]
          [-setMasterRepStart [-localhost hostName]] [-ramLoad]
          [-delXla]
          [-UID userId] [-PWD pwd | -PWDCrypt encrypted-pwd]
          {destDSN | -connStr connectionString}
          [-drop { [owner.]table ... | [owner.]sequence |ALL }]
          [-truncate { [owner.]table ... | ALL }]
          [-compression 0 | 1] [-bandwidthmax maxKbytesPerSec]
          [[-keepCG [-cacheUid cacheUid [-cachePwd cachePwd]]]
          |[-noKeepCG]]

ttRepAdminの処理

ttRepAdminユーティリティは、多くのレプリケーション処理に使用できる多用途のレプリケーション・ユーティリティです。これらの処理は、次のカテゴリに分類されます。

- ヘルプおよびバージョン情報
- データ・ストア情報
- サブスクライバ・データ・ストア処理
- データ・ストアの複製
- 更新完了の待機
- レプリケーション・ステータス

### ヘルプおよびバージョン情報

次の形式でttRepAdminを使用すると、ヘルプおよびTimesTenの現在のバージョンを取得できます。

    ttRepAdmin [-h | -help]
    ttRepadmin [-V | -version]

    -h | -help
| ヘルプ情報を表示します。
    -V | -version
| TimesTenのバージョン情報を表示します。

### データ・ストア情報

次の形式でttRepAdminを使用すると、データ・ストアに関するサマリー情報を取得できます。

    ttRepAdmin -self [-list] [-scheme [owner.]schemeName]
    {DSN | -connStr connectionString} [-UID <uid>]
    [-PWD pwd | -PWDCrypt encrypted-pwd]

オプション

ttRepAdmin -selfには、次のオプションがあります。

    DSN
| マスター・データ・ストアまたはサブスクライバ・データ・ストアのデータソース名。
    -connStr
    connectionString
| マスター・データ・ストアまたはサブスクライバ・データ・ストアの接続文字列。
    -self
| 指定されたデータ・ストア。
    -list
| データ・ストア名、ホスト、ポート番号およびブックマークの位置を表示します。
    -scheme
    [owner.]schemeName]
| （2つ以上のスキームがある場合）レプリケーション・スキーム名。

例:

    ttRepAdmin -self -list my_dsn

    前述の構文によって、データ・ストアmy_dsnのレプリケーション定義に関する情報が表示されます。

### サブスクライバ・データ・ストア処理

次の形式のttRepAdminを使用すると、バックアップ、ステータスのチェックまたはサブスクライバ（受信側）・データ・ストアの状態の再設定を実行できます。

    ttRepAdmin -receiver [-name receiverName]
           [-host receiverHostName]
           [-state receiverState] [-backup dir] [-reset]
           [-list] [-scheme [owner.]schemeName]
           {DSN | -connStr connectionString}

オプション

ttRepAdmin -receiverには、次のオプションがあります。

    DSN
| マスター・データ・ストアのデータソース名。
    -connStr
    connectionString
| マスター・データ・ストアの接続文字列。
    -receiver
| マスター・データ・ストアから更新を受信するサブスクライバ・データ・ストア。-nameおよび-hostを使用すると、特定のサブスクライバ・データ・ストアを指定できます。
    -name receiverName
| 特定のサブスクライバ（受信側）・データ・ストア。receiverNameは、データ・ストア・パス名の最後の部分です。
    -host receiverHostName
| サブスクライバ・ホスト・マシンのホスト名またはTCP/IPアドレス。
    -state start
    -state stop
    -state pause
| サブスクライバのレプリケーションの状態を設定します。

- start: サブスクライバへのレプリケーションを開始します（デフォルト）。
- stop: サブスクライバへのレプリケーションを停止し、更新を破棄します。
- pause: レプリケーション・エージェントを一時停止し、更新を保持します。

詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のサブスクライバのレプリケーション状態の設定に関する項を参照してください。

    -reset

特定のサブスクライバに送信される最新のトランザクションに関する、マスター・データ・ストアのログのブックマークを消去します。このオプションは、たとえば、データ・ストアがttMigrateまたはttBulkCpを使用して再作成される場合のように、マスター・データ・ストアのトランザクションの番号が変更される場合にのみ、使用してください。マスター・データ・ストアがttBackupおよびttRestoreを使用して、保存およびリストアされる場合は、トランザクションの番号が保持されるため、このオプションは使用しないでください。

    -list

レプリケーション定義に関する情報を表示します。

    -scheme [owner.]schemeName]

2つ以上のスキームがある場合に、レプリケーション・スキーム名を指定します。

例:

    ttRepAdmin -receiver -list my_dsn

    前述の構文によって、マスター・データ・ストアmy_dsnのすべてのサブスクライバのレプリケーション情報が表示されます。

    ttRepAdmin -receiver -name rep_dsn -list my_dsn

    前述の構文によって、マスター・データ・ストアmy_dsnのrep_dsnサブスクライバのレプリケーション情報が表示されます。

    ttRepAdmin -receiver -name rep_dsn -reset my_dsn

    前述の構文によって、マスター・データ・ストアのrep_dsnサブスクライバに対するレプリケーションのブックマークが再設定されます。レプリケートされたデータ・ストアをttMigrateまたはttBulkCpで移行する場合にのみ使用してください。

    ttRepAdmin -receiver -name rep_dsn -state Start my_dsn

    前述の構文によって、マスター・データ・ストアmy_dsnに対してrep_dsnサブスクライバ・データ・ストアのレプリケーション状態がstartに再設定されます。

### データ・ストアの複製

次の形式のttRepAdminを使用すると、マスター・データ・ストアと同じコンテンツをもつ新しいデータ・ストアを作成できます。

ttRepAdmin -duplicateコマンドを実行する前に、ttStatusを使用して、レプリケーション・エージェントが起動していることを確認します。

    ttRepAdmin -duplicate -from srcDataStoreName
        -host srcDataStoreHost [-memcpy]
        [-setMasterRepStart [-localhost hostName]] [-ramLoad]
        [-delXla] DSN
        [-UID userId] [-PWD pwd | -PWDCrypt encrypted-pwd]
          [-drop { [owner.]table ... | [owner.]sequence |ALL }]
          [-truncate { [owner.]table ... | ALL }]
          [-compression 0 | 1] [-bandwidthmax maxKbytesPerSec]
          [[-keepCG [-cacheUid cacheUid -cachePwd cachePwd]]
          |[-noKeepCG]]

オプション

ttRepAdmin -duplicateには、次のオプションがあります。

    destDSN
| 新しいデータ・ストアのデータソース名を示します。
    -bandwidthmax
    maxKbytesPerSec
| 複製処理によってmaxKbytesPerSec KB/sを超えるデータがネットワークに送信されないように指定します。値0は、帯域幅に制限がないことを示します。デフォルトは0です。
    -compression 0 | 1
| 複製処理中の圧縮を有効または無効にします。デフォルトは0です（無効）。
    -connStr
    connectionString
| 新しいデータ・ストアの接続文字列を指定します。
    -drop { [owner.]table ... |
    [owner.]sequence | ALL
| -duplicate処理中にリストアされたものの、レプリケーション・スキームには含まれていない表または順序を破棄します。この表がキャッシュ・グループの表である場合、このオプションは無視されます。
    -duplicate
| コピーの作成によってデータ・ストアのリストアを自動化します。 詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のマスター・データ・ストアのサブスクライバへのコピーに関する項および障害のあったデータ・ストアのリカバリに関する項を参照してください。このオプションを使用する場合、キャッシュ・グループのTimesTenの表は、新しいデータ・ストアの通常のTimesTenの表として複製されます。新しいデータ・ストアで引き続きCache Connect機能を使用するには、キャッシュ・グループを再作成する必要があります。
    -from srcDataStoreName
| -duplicateとともに使用して、送信側データ・ストア（またはマスター・データ・ストア）の名前を指定します。srcDataStoreNameは、データ・ストア・パス名の最後の部分です。
    -host srcDataStoreHost
| 送信側データ・ストア（またはマスター・データ・ストア）のホスト名またはTCP/IPアドレスを定義します。
    -keepCG [-cacheUid cacheUid
    -cachePwd cachePwd] |
    -noKeepCG
| 指定したキャッシュ・グループの表をキャッシュ・グループの表として保持するか、通常の表に変換するかどうかを指定します。cacheUidはキャッシュ管理ユーザーのID、またcachePwdは関連付けられたパスワードです。パスワードを入力しなかった場合、ttRepAdminによってパスワードの入力が求められます。
    -memcpy
| ディスクレス・データ・ストアを複製する場合に-duplicateとともに使用して、リモート・データ・ストアがロックされている時間を短縮します。
    -setMasterRepStart
| -duplicateとともに使用した場合、このオプションは、新たに作成されたデータ・ストアのレプリケーション状態を、ネットワーク間でデータ・ストアがコピーされる直前にStartに設定します。これにより、複製処理の後、リモート・データ・ストアからのすべての更新を、新たに複製されたローカル・データ・ストアにレプリケートできるようになります。データ・ストアの不要なログ・ファイルは、削除されます。
    -localhost hostName
| -duplicateおよび-setMasterRepStartとともに使用して、ローカル・ホストの名前またはIPアドレスを明示的に指定します。
    -ramLoad
| 複製処理の完了時に、メモリー内にデータ・ストアを保持します。このオプションによって、大規模なデータ・ストアをコピーする場合にデータ・ストアのアンロードとリロードのサイクルが回避され、複製処理のパフォーマンスが改善されます。duplicateオプションの後に指定した場合、データ・ストアのramPolicyはmanualに設定されます。
    -delXla
| 複製処理の一部として、すべてのXLAブックマークを削除します。このオプションは、複製データ・ストアにブックマークをコピーしない場合に使用します。
    -truncate
    [owner.]table ... | ALL
| -duplicate処理の一部としてリストアされたものの、レプリケーション・スキームには含まれていない表を切り捨てます。この表がキャッシュ・グループの表である場合、このオプションは無視されます。
    -UID userid
| アクセス制御が有効な場合は、コピー対象のピアでADMIN権限を持つユーザーのユーザーIDを指定する必要があります。
    -PWD pwd
| アクセス制御が有効な場合、UIDオプションで指定されたユーザーのパスワードを指定します。
    -PWDCrypt encrypted-pwd
| アクセス制御が有効な場合、UIDオプションで指定されたユーザーの暗号化されたパスワードを指定します。

例:

    ttRepAdmin -duplicate -from srcDataStoreName -host srcDataStoreHost
    	[destDSN | -connStr connectionString]

    前述の構文によって、レプリケーションが可能なリモートの一時データ・ストアまたは永続データ・ストアのレプリカが作成されます。この処理は、バックアップ・データ・ストアの自動作成に使用できます。

    リモート・データ・ストアがディスクレスの場合は、この処理によって、リモートのソース・データ・ストアで行われるメモリー転送の期間全体に対してデータ・ストア・レベル・ロックが設定されます。これによって、複製処理時に他の接続がリモート・データ・ストアにアクセスできなくなります。

    前述のttRepAdminの構文の構成要素について説明します。

- destDSNは、ローカルのDSNです。
- connectionStringは、ローカルDSNへの接続文字列です。
- srcDataStoreNameは、リモートのソース・データ・ストア名です。この名前はデータ・ストア・パス名の最後の部分です。
- srcDataStoreHostは、リモートのソース・データ・ストアが配置されているマシンのTCP/IPホスト名です。

    ttRepAdmin -duplicate -from srcDataStoreName
     -host srcDataStoreHost -memcpy
     [destDSN | -connStr connectionString]

    リモート・データ・ストアがディスクレスの場合は、前述のとおりに-memcpyオプションを使用して、レプリケーションが可能なリモートの一時データ・ストアまたは永続データ・ストアのレプリカを作成できます。この追加のオプションを指定してディスクレス・モードでttRepAdmin -duplicateを実行すると、ネットワーク間でデータ・ストアのコピーが実行される前に、リモート・データ・ストアの中間コピーがメモリーに作成されます。リモート・データ・ストアは、メモリー間コピーの実行中にのみロックされます。このため、ディスクレス・モードでこの処理を行うとデータベースのロック時間が短くなります。リモート・マシンのメモリー間の帯域幅がリモート・マシンとローカル・マシン間のネットワーク・データの帯域幅を超えた場合は、リモート・マシンでのロック時間が短くなります。追加の要件として、追加のリモート・コピーで使用可能な十分なRAMがある必要があります。

    前述のttRepAdminの構文の構成要素について説明します。

- destDSNは、ローカルのDSNです。
- connectionStringは、ローカルDSNへの接続文字列です。
- srcDataStoreNameは、リモートのソース・データ・ストア名です。この名前はデータ・ストア・パス名の最後の部分です。
- srcDataStoreHostは、リモートのソース・データ・ストアが配置されているマシンのTCP/IPホスト名です。

    ttRepAdmin -duplicate -from srcDataStoreName
     -host srcDataStoreHost
     -setMasterRepStart -localhost localHostName -ramLoad
     [destDSN | -connStr connectionString]

    前述の構文では、-setMasterRepStartオプションによって、srcDataStoreNameデータ・ストアのレプリケーション状態がネットワーク間でコピーされる前にStart状態に設定にされ、メモリー内にデータ・ストアが保持されます。-localhostオプションを使用してローカル・ホストを明示的に指定できます。これは、ローカル・ホストでIPアドレスなどの標準以外の名前が使用されている場合に有効です。これらのオプションを使用すると、複製処理後に行われたすべての更新がリモート・データ・ストアから新しく作成またはリストアされたローカル・データ・ストアにレプリケートされます。

    前述のttRepAdminの構文の構成要素について説明します。

- destDSNは、ローカルのDSNです。
- connectionStringは、ローカルDSNへの接続文字列です。
- srcDataStoreNameは、リモートのソース・データ・ストア名です。この名前はデータ・ストア・パス名の最後の部分です。
- srcDataStoreHostは、リモートのソース・データ・ストアが配置されているマシンのホスト名またはTCP/IPアドレスです。
- localHostNameは、ローカル・マシンのホスト名またはTCP/IPアドレスです。

注意

このユーティリティでは、データ・ストアに一時表定義は複製できますが、インスタンスは複製できません。

### レプリケーション・ステータス

    次の形式のttRepAdminを使用すると、ログ・ファイルのサイズ、ブックマークの位置、またはマスター・データ・ストアのレプリケーション設定を確認できます。
    ttRepAdmin -log {DSN | -connStr connectionString}
    ttRepAdmin -showstatus {DSN | -connStr connectionString}
    ttRepAdmin -showconfig {DSN | -connStr connectionString}
    ttRepAdmin -bookmark {DSN | -connStr connectionString}

オプション

ttRepAdmin監視処理には、次のオプションがあります。

    DSN
| マスター・データ・ストアのデータソース名を示します。
    -connStr
    connectionString
| マスター・データ・ストアの接続文字列を指定します。
    -log
| 他のデータ・ストアに更新を転送するためにレプリケーションによって保持される、ログ・ファイルの数とサイズを表示します。
    -showconfig
| レプリケーションの設定すべてを表示します。詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のレプリケートしたデータ・ストアの設定の表示に関する項を参照してください。
    -showstatus
| 指定したレプリケートしたデータ・ストアの現在のステータスをレポートします。詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のレプリケーション・ステータスの表示に関する項を参照してください。
    -bookmark
| レプリケーションで読み取る必要のある最も古いログ順序番号、作成された最新のログ順序番号およびレコードがディスクにフラッシュされた最新のログ順序番号をレポートします。 詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のレプリケートされたログ・レコードの表示に関する項を参照してください。

例:

    ttRepAdmin -log DSN

    前述の構文によって、他のデータ・ストアに更新を転送するためにレプリケーションで保持されるログ・ファイルの数がレポートされます。レプリケーション・エージェントは、ログ・ファイル内のすべての更新が各サブスクライバ・データ・ストアに正常に転送されるまでそのログ・ファイルを保持します。

    ttRepAdmin -showconfig DSN

    前述の構文によって、レプリケーション設定全体がレポートされます。指定したDSNのすべてのサブスクライバ、レプリケートされている表の名前と詳細、およびすべてのサブスクリプションが表示されます。

    ttRepAdmin -showstatus DSN

    前述の構文によって、指定したDSNのデータ・ストアの現在の状態がレポートされます。出力には、レプリケートされたデータ・ストアのレプリケーション・エージェント内のすべてのスレッド、ブックマークの位置、ポート番号および通信プロトコルの状態が含まれます。

    ttRepAdmin -bookmark DSN

    前述の構文によって、レプリケーションで必要な最も古いログ・レコード、ディスクに書き込まれた最後のログ・レコードおよび最後に生成されたログ・レコードのログ順序番号が出力されます。

### 更新完了の待機

次の形式のttRepAdminを使用すると、コールが戻る前に、ログ内のすべての更新をすべてのサブスクライバにレプリケートできます。

    ttRepAdmin -wait [-name receiverName] [-host receiverHostName]
           [-timeout seconds] {DSN | -connStr connectionString}

オプション

ttRepAdmin -waitには、次のオプションがあります。

    DSN
| マスター・データ・ストアのデータソース名を示します。
    -connStr
    connectionString
| マスター・データ・ストアの接続文字列を指定します。
    -wait
| レプリケーションがカレントになるまで待機してから続行します。
    -name receiverName
| データ・ストアを識別します。datastorenameは、データ・ストア・パス名の最後の部分です。
    -host receiverHostName
| サブスクライバ・ホスト・マシンのホスト名またはTCP/IPアドレスを定義します。
    -timeout seconds
| タイムアウト値（秒）を指定します。サブスクライバ・データ・ストアがこの時間内に応答しない場合、TimesTenは別の接続を試みます。

例:

    ttRepAdmin -wait -name receiverName -host receiverHostName
            -timeout seconds -dsn DSN

    前述の構文によって、このプログラムの起動時にコミットされたすべての更新がサブスクライバreceiverNameに転送され、このサブスクライバによってそれらのすべての更新がサブスクライバ・データ・ストアで永続コミットされたことが確認されたことを確認する方法が提供されます。タイムアウトで待機時間（秒）が制限されます。

注意: すべての書込みトランザクション・アクティビティがストアで静止された後にttRepAdmin -waitが起動された場合（アクティブなトランザクションおよび開始済のトランザクションがない状態）、すべての更新がサブスクライバで永続的にコミットされていることを示す確認応答をサブスクライバが送信するまでに、60秒以上かかる可能性があります。

    ttRepAdmin -wait -dsn DSN

    前述の構文に示すとおり、タイムアウトおよびサブスクライバ名が指定されていない場合、ttRepAdminは、このプログラムの起動時にコミットされたすべての更新がすべてのサブスクライバに転送され、それらのすべての更新がサブスクライバ・データ・ストアで永続コミットされたことがすべてのサブスクライバによって確認されるまで戻されません。

注意

ttRepAdminユーティリティは、TimesTen Data Manager DSNに対してのみサポートされます。TimesTen Client DSNでは、サポートされません。

2つ以上のレプリケーション・スキームを指定する場合、または2つ以上のスキームが特定のデータ・ストアを含む場合、-schemeオプションを使用する必要があります。

SQLの構成を使用すると、同じデータ・ストアに複数のレプリケーション・スキームを作成できます。レプリケーション・スキームが1つしかない場合、ttRepAdminユーティリティは、自動的にスキームを検出します。2つ以上のスキームがある場合は、ttRepAdmin -schemeオプションを使用して、使用するスキームを指定する必要があります。

異なるホスト上の同じ名前のデータ・ストアにレプリケーションを構成する場合、-hostを使用して、どのデータ・ストアを処理するのかを指示できます。たとえば、すべてのサブスクライバがDATAという名前をもつ場合、ホストSW1のレプリケーション状態を設定するには、次のように実行します。

    ttRepAdmin -receiver -name DATA -host SW1 -state start DSN

関連項目

TimesTenレプリケーションの詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』を参照してください。

アップグレードの例は、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』のデータ・ストアのアップグレードに関する項を参照してください。