既存のレプリケーション定義を表示し、レプリケーション・ステータスを監視します。『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 encryptedPwd] [-drop { [owner.]table ... | [owner.]sequence |ALL }] [-truncate { [owner.]table ... | ALL }] [-compression 0 | 1] [-bandwidthmax maxKbytesPerSec] [-keepCG [-cacheUid cacheUid [-cachePwd cachePwd]] | -noKeepCG] {destDSN | -connStr connectionString}
ttRepAdminユーティリティは、多くのレプリケーション処理に使用できる多用途のレプリケーション・ユーティリティです。これらの処理は、次のカテゴリに分類されます。
次の形式でttRepAdminを使用すると、ヘルプおよびTimesTenの現在のバージョンを取得できます。
次の形式でttRepAdminを使用すると、データ・ストアに関するサマリー情報を取得できます。
ttRepAdmin -self -listには、次のオプションがあります。
マスター・データ・ストアまたはサブスクライバ・データ・ストアのデータソース名。 |
|
マスター・データ・ストアまたはサブスクライバ・データ・ストアの接続文字列。 |
|
指定されたデータ・ストア。 |
|
データ・ストア名、ホスト、ポート番号およびブックマークの位置を表示します。 |
|
(2つ以上のスキームがある場合)レプリケーション・スキーム名。 |
次の形式のttRepAdminを使用すると、ステータスのチェックまたはサブスクライバ(受信側)・データ・ストアの状態の再設定を実行できます。
ttRepAdmin -receiver [-name receiverName] [-host receiverHostName] [-state receiverState] [-backup dir] [-reset] [-list] [-scheme [owner.]schemeName] {DSN | -connStr connectionString}
ttRepAdmin -receiverには、次のオプションがあります。
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] [-UID userId] [-PWD pwd | -PWDCrypt encryptedPwd] [-drop { [owner.]table ... | [owner.]sequence |ALL }] [-truncate { [owner.]table ... | ALL }] [-compression 0 | 1] [-bandwidthmax maxKbytesPerSec] [-keepCG [-cacheUid cacheUid [-cachePwd cachePwd]] |[-noKeepCG] {destDSN | -connStr connectionString}
ttRepAdmin -duplicateには、次のオプションがあります。
新しいデータ・ストアのデータソース名を示します。 |
|
複製処理によってmaxKbytesPerSec KB/sを超えるデータがネットワークに送信されないように指定します。値0は、帯域幅に制限がないことを示します。デフォルトは0です。 |
|
複製処理中の圧縮を有効または無効にします。デフォルトは0です(無効)。 |
|
新しいデータ・ストアの接続文字列を指定します。 |
|
-duplicate処理中にコピーされたものの、レプリケーション・スキームには含まれていない表または順序を破棄します。この表がキャッシュ・グループの表である場合、このオプションは無視されます。
| |
ネットワーク間でデータ・ストアの内容を転送するために、指定したデータ・ストアの複製をレプリケーションを使用して作成します。 詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のマスター・データ・ストアのサブスクライバへのコピーに関する項および障害のあったデータ・ストアのリカバリに関する項を参照してください。このオプションを使用すると、-keepCGを使用しないかぎり、キャッシュ・グループのTimesTenの表は、新しいデータ・ストアの通常のTimesTen tablesの表として複製されます。 |
|
-duplicateとともに使用して、送信側データ・ストア(またはマスター・データ・ストア)の名前を指定します。srcDataStoreNameは、データ・ストア・パス名の最後の部分です。 |
|
送信側データ・ストア(またはマスター・データ・ストア)のホスト名またはTCP/IPアドレスを定義します。 |
|
指定したキャッシュ・グループの表をキャッシュ・グループの表として保持するか、通常の表に変換するかどうかを指定します。cacheUidはキャッシュ管理ユーザーのID、またcachePwdは関連付けられたパスワードです。パスワードを入力しなかった場合、ttRepAdminによってパスワードの入力が求められます。 デフォルトは-nokeepです。 |
|
ディスクレス・データ・ストアを複製する場合に-duplicateとともに使用して、リモート・データ・ストアがロックされている時間を短縮します。 |
|
-duplicateとともに使用した場合、このオプションは、新たに作成されたデータ・ストアのレプリケーション状態を、ネットワーク間でデータ・ストアがコピーされる直前にStartに設定します。これにより、複製処理の後にソース・データ・ストアに行われたすべての更新を、新しく複製されたローカル・データ・ストアにレプリケートできるようになります。データ・ストアの不要なログ・ファイルは、削除されます。 |
|
-duplicateおよび-setMasterRepStartとともに使用して、ローカル・ホストの名前またはIPアドレスを明示的に指定します。 |
|
複製処理の完了時に、メモリー内にデータ・ストアを保持します。このオプションによって、大規模なデータ・ストアをコピーする場合にデータ・ストアのアンロードとリロードのサイクルが回避され、複製処理のパフォーマンスが改善されます。duplicateオプションの後に指定した場合、データ・ストアのRAMポリシーはmanualに設定されます。RAMポリシーに追加の変更を行うには、ttAdminユーティリティを使用します。 |
|
複製処理の一部として、すべてのXLAブックマークを削除します。このオプションは、複製データ・ストアにブックマークをコピーしない場合に使用します。 |
|
-duplicate処理の一部としてコピーされたものの、レプリケーション・スキームには含まれていない表を切り捨てます。この表がキャッシュ・グループの表である場合、このオプションは無視されます。 | |
アクセス制御が有効な場合は、コピー対象のピアでADMIN権限を持つユーザーのユーザーIDを指定する必要があります。 |
|
アクセス制御が有効な場合、UIDオプションで指定されたユーザーのパスワードを指定します。 |
|
アクセス制御が有効な場合、UIDオプションで指定されたユーザーの暗号化されたパスワードを指定します。 |
ttRepAdmin -duplicate -from srcDataStoreName -host srcDataStoreHost [destDSN | -connStr connectionString]前述の構文によって、レプリケーションが可能なリモートの一時データ・ストアまたは永続データ・ストアのレプリカが作成されます。この処理は、バックアップ・データ・ストアの自動作成に使用できます。
リモート・データ・ストアがディスクレスの場合は、この処理によって、リモートのソース・データ・ストアで行われるメモリー転送の期間全体に対してデータ・ストア・レベル・ロックが設定されます。これによって、複製処理時に他の接続がリモート・データ・ストアにアクセスできなくなります。
前述のttRepAdminの構文の構成要素について説明します。
ttRepAdmin -duplicate -from srcDataStoreName -host srcDataStoreHost -memcpy [destDSN | -connStr connectionString]リモート・データ・ストアがディスクレスの場合は、前述のとおりに-memcpyオプションを使用して、レプリケーションが可能なリモートの一時データ・ストアまたは永続データ・ストアのレプリカを作成できます。この追加のオプションを指定してディスクレス・モードでttRepAdmin -duplicateを実行すると、ネットワーク間でデータ・ストアのコピーが実行される前に、リモート・データ・ストアの中間コピーがメモリーに作成されます。リモート・データ・ストアは、メモリー間コピーの実行中にのみロックされます。このため、ディスクレス・モードでこの処理を行うとデータベースのロック時間が短くなります。リモート・マシンのメモリー間の帯域幅がリモート・マシンとローカル・マシン間のネットワーク・データの帯域幅を超えた場合は、リモート・マシンでのロック時間が短くなります。追加の要件として、追加のリモート・コピーで使用可能な十分なRAMがある必要があります。
前述のttRepAdminの構文の構成要素について説明します。
ttRepAdmin -duplicate -from srcDataStoreName -host srcDataStoreHost -setMasterRepStart -localhost localHostName -ramLoad [destDSN | -connStr connectionString]前述の構文では、-setMasterRepStartオプションによって、srcDataStoreNameデータ・ストアのレプリケーション状態がネットワーク間でコピーされる前にStart状態に設定にされ、メモリー内にデータ・ストアが保持されます。-localhostオプションを使用してローカル・ホストを明示的に指定できます。これは、ローカル・ホストでIPアドレスなどの標準以外の名前が使用されている場合に有効です。これらのオプションを使用すると、複製処理後に行われたすべての更新がリモート・データ・ストアから新しく作成またはリストアされたローカル・データ・ストアにレプリケートされます。
前述のttRepAdminの構文の構成要素について説明します。
このユーティリティでは、データ・ストアに一時表定義は複製できますが、インスタンスは複製できません。
次の形式のttRepAdminを使用すると、ログ・ファイルのサイズ、ブックマークの位置、またはマスター・データ・ストアのレプリケーション設定を確認できます。
ttRepAdmin -log {DSN | -connStr connectionString} ttRepAdmin -showstatus {DSN | -connStr connectionString} ttRepAdmin -showconfig {DSN | -connStr connectionString} ttRepAdmin -bookmark {DSN | -connStr connectionString}
ttRepAdmin監視処理には、次のオプションがあります。
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には、次のオプションがあります。
ttRepAdmin -wait -name receiverName -host receiverHostName -timeout seconds -dsn DSN前述の構文によって、このプログラムの起動時にコミットされたすべての更新がサブスクライバreceiverNameに転送され、このサブスクライバによってそれらのすべての更新がサブスクライバ・データ・ストアで永続コミットされたことが確認されたことを確認する方法が提供されます。タイムアウトで待機時間(秒)が制限されます。
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のレプリケーション状態を設定するには、次のように実行します。
TimesTenレプリケーションの詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』を参照してください。
アップグレードの例は、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』のデータ・ストアのアップグレードに関する項を参照してください。