ヘッダーをスキップ

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

前へ | 次へ |

## ユーティリティ・リスト

ユーティリティ | 参照先
--- | ---
ttAdmin | ttAdmin
ttBackup | ttBackup
ttBulkCp | ttBulkCp
ttCapture | ttCapture
ttCheck | ttCheck
ttDaemonAdmin | ttDaemonAdmin
ttDaemonLog | ttDaemonLog
ttDestroy | ttDestroy
ttIsql | ttIsql
ttMigrate | ttMigrate
ttmodinstall | ttmodinstall
ttRepAdmin | ttRepAdmin
ttRestore | ttRestore
ttSchema | ttSchema
ttSize | ttSize
ttStatus | ttStatus
ttSyslogCheck（UNIX） | ttSyslogCheck（UNIX）
ttTail | ttTail
ttTraceMon | ttTraceMon
ttuser | ttuser
ttVersion | ttVersion
ttXactAdmin | ttXactAdmin
ttXactLog | ttXactLog

##

## ttAdmin

説明

次のことを行うことができます。

- RAMからデータ・ストアを自動または手動でロードおよびアンロードするポリシーを指定する。
- 指定したデータ・ストアのレプリケーション・エージェントを自動または手動で開始および停止するポリシーを指定する。
- Oracle表からデータをキャッシュするために、TimesTenキャッシュ・エージェントの開始と停止を行う。キャッシュ・エージェントは、TimesTenデータ・ストアのために、Oracleデータベースへのアクセスを行うプロセスです。また、TimesTenデータ・ストア内のキャッシュ・グループのエージングと自動リフレッシュも行います。ある特定のTimesTenデータ・ストアのCache ConnectアドミニストレータのWebページが正しく表示されるようにするためには、対応するキャッシュ・エージェントが開始されている必要があります。これは、WebページのOracleメタデータへのアクセスもキャッシュ・エージェントが行うためです。いずれのキャッシュ機能も、キャッシュ・エージェントを開始してから使用する必要があります。

アクセス制御

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

構文

    ttAdmin [-h | -help]
    ttAdmin [-V | -version]
    ttAdmin [-ramPolicy always|manual|inUse] [-ramGrace secs]

[-ramLoad] [-ramUnload]
[-repPolicy always|manual|norestart]
[-repStart] [-repStop]
[[-cacheUidGet] |
[-cacheUidPwdSet -cacheUid uid -cachePwd pwd] |
[-cachePolicy always | manual] |
[-cacheStart] |
[-cacheStop [-stopTimeout seconds]]]
[-query]
{-connStr connection_string | DSN}
オプション

ttAdminには次のオプションがあります。

    -connStr
    connection_string
| データ・ストア名、サーバー名とDSN（必要に応じて）および関連する接続属性を含むODBC接続文字列。
    DSN
| 管理するデータ・ストアのODBCデータソース名を指定します。
    -h
    -help
| 使用方法のメッセージを出力して終了します。
    -cachePolicy
| データ・ストアに対してキャッシュ・エージェントを開始するタイミングを決定するために使用するポリシーを定義します。
    -cacheStart
| データ・ストアに対してキャッシュ・エージェントを開始します。
    -cacheStop
| データ・ストアに対するキャッシュ・エージェントを停止します。キャッシュ・グループを削除または変更した直後にキャッシュ・エージェントを停止せずに、少なくとも2分間待機してください。待機しないと、キャッシュ・エージェントは、AUTOREFRESH機能で使用されたOracleオブジェクトをクリーンアップすることができません。
    -cachePwd
| AUTOREFRESHキャッシュ・グループおよびASYNCHRONOUS WRITETHROUGHキャッシュ・グループの管理に使用されるキャッシュ管理ユーザーIDに関連付けられたパスワード。キャッシュ管理ユーザーは、拡張された権限を持っています。詳細は、『Oracle TimesTen Cache Connect to Oracle開発者および管理者ガイド』のOracleユーザーの作成と権限の設定に関する項を参照してください。
    -cacheUid
| キャッシュ管理ユーザーID。キャッシュ管理ユーザーは、AUTOREFRESHキャッシュ・グループおよびASYNCHRONOUS WRITETHROUGHキャッシュ・グループを管理します。キャッシュ管理ユーザーは、拡張された権限を持っています。詳細は、『Oracle TimesTen Cache Connect to Oracle開発者および管理者ガイド』のOracleユーザーの作成と権限の設定に関する項を参照してください。
    -cacheUidGet
| 指定されたデータ・ストアの現在のキャッシュ管理ユーザーIDを取得します。
    -cacheUidPwdSet
| 指定されたデータ・ストアのキャッシュ管理ユーザーIDとパスワードを設定します。-cacheUidおよび-cachePwdオプションとともに設定する必要があります。このオプションの注意事項は、次のとおりです。 キャッシュ管理ユーザーIDおよびパスワードは、新しいデータ・ストアそれぞれに一度だけ指定される必要があります。 キャッシュ・エージェントまたはレプリケーション・エージェントが実行されている場合は、キャッシュ管理ユーザーIDおよびパスワードを設定することができません。 データ・ストアにASYNCHRONOUS WRITETHROUGHキャッシュ・グループまたはAUTOREFRESHキャッシュ・グループ（OFFではない状態）がある場合は、キャッシュ管理ユーザーIDをリセットすることができません。 キャッシュ管理パスワードはいつでも変更できます。
    -query
| 名前付きデータ・ストアに対するポリシー設定のサマリーを表示します。
    -ramGrace secs
| RamPolicyがinUseに設定されている場合にのみ有効です。0（ゼロ）以外の場合は、最後のアプリケーションがデータ・ストアとの接続を切断した後、データ・ストアはアンロードされる前にさらにsecs秒間、RAMに保持されます。
    -ramLoad
| ramPolicyがmanualに設定されている場合にのみ有効です。これにより、データ・ストアがRAMにロードされます。
    -ramPolicy
| データ・ストアをシステムRAMにロードするタイミングを決定するために使用するポリシーを定義します。 always: データ・ストアは常時システムRAMに存在します。 manual: ユーザーがramLoadオプションを使用して明示的にロードする場合にのみ、データ・ストアはシステムRAMにロードされます。 inUse: （デフォルト）データ・ストアが使用中（アプリケーションの接続時など）にのみシステムRAMにロードされます。ramGraceオプションを使用して、このポリシーの動作を変更することもできます。 このオプションは一時データ・ストアでは使用できません。TimesTenでは、一時データ・ストアは手動でのみRAMにロードできます。ポリシーを設定しようとすると、警告が表示されます。
    -ramUnload
| ramPolicyがmanualに設定されている場合にのみ有効です。これにより、データ・ストアがRAMからアンロードされます。
    -repPolicy
| レプリケーション・エージェントを開始するタイミングを決定するために使用するポリシーを定義します。 always: エージェントはデータ・ストアに対して常時実行されます。このオプションによって、レプリケーション・エージェントがただちに開始され、デーモンが再起動すると、レプリケーション・エージェントは再び開始されます。 manual: （デフォルト）レプリケーション・エージェントを手動で開始、停止する必要があります。 norestart: エラーが発生した後、データ・ストアのレプリケーション・エージェントは再び開始されません。
    -repStart
| データ・ストアのレプリケーション・エージェントを開始します。TimesTenレプリケーションは、レプリケーション・エージェントを開始する前に、その表にローカル・マシンのためのエントリがあるかどうかを確認します。エントリがない場合は、ttAdminによって、レプリケーション・エージェントを開始できなかったことを示すメッセージが出力されます。データ・ストアがレプリケーション・スキームに関連しない場合、レプリケーション・エージェントは開始されません。
    -repStop
| データ・ストアのレプリケーション・エージェントを停止します。
    -stopTimeout seconds
| 指定した秒数内にキャッシュ・エージェントが停止しない場合は、TimesTenデーモンに強制終了するように指定します。0を設定すると、デーモンはキャッシュ・エージェントを無期限待機します。デフォルト値は100秒です。
    -V | -version
| ttAdminのリリース番号を出力し、終了します。

例

DSN SalesDataで参照されるデータ・ストアは、パフォーマンスを重視するアプリケーションによって使用されます。データ・ストアがディスクからRAMにロードされるのをアプリケーションが待機する必要がないように、このデータ・ストアは常時RAMに存在している必要があります。これを実現するには、次のコマンドを実行します。

    ttAdmin -ramPolicy always SalesData

    通常、SalesDataデータ・ストアは、RAMに常駐しています。ただし、これは常に使用されるわけではないため、アプリケーションが接続するときにのみロードすることをお薦めします。RAMポリシーを変更するには、次のコマンドを実行します。

    ttAdmin -ramPolicy inUse SalesData

    SalesDataデータ・ストアをRAMにロードするかどうかを手動で制御し、すぐにロードするには、次のコマンドを実行します。

    ttAdmin -ramPolicy manual -ramLoad SalesData

    SalesDataデータ・ストアをRAMから手動でアンロードし、そのデータ・ストアに新しいアプリケーションが接続しないようにするには、次のコマンドを実行します。

    ttAdmin -ramPolicy manual -ramUnload SalesData

    DSN Historyで参照されるデータ・ストアは、常に使用されているわけではありません。これを永続的にRAMにロードしていると、不必要にメモリーを使用します。このデータ・ストアは、長期にわたりアイドル状態にありますが、使用される場合は、連続して複数のユーザーから接続されます。パフォーマンスを向上させるには、アプリケーションからの接続時にデータ・ストアをRAMに格納し、最後のユーザーが切断した後、RAM内でそれを5分間（300秒間）保持するようにします。このRAMポリシーでは、アプリケーションがデータ・ストアに接続しているかぎり、データ・ストアはRAMに保持されます。

    ttAdmin -ramPolicy inUse -ramGrace 300 History

    DSN SalesDataで参照されるデータ・ストアは、Oracleデータのキャッシュに使用されます。次のttAdminコマンドを実行して、SalesData DSN用のOracleエージェントを開始します。

    ttAdmin -cacheStart SalesData

    また、-cachePolicyオプションを使用して、TimesTen Data Managerデーモンに、Data Manager自身が起動するたびにキャッシュ・エージェントを開始させるように設定できます。

    ttAdmin -cachePolicy always SalesData

    キャッシュ・エージェントの自動開始をオフにするには、次のコマンドを実行します。

    ttAdmin -cachePolicy manual SalesData

    キャッシュ管理ユーザーIDとパスワードを設定するには、ttAdminで-cacheUidPwdSetフラグを-cacheUidおよび-cachePwdオプションとともに使用します。たとえば、データ・ストアSalesDataのキャッシュ管理ユーザーIDとパスワードを、それぞれscottとtigerにするには、次のコマンドを実行します。

    ttAdmin -cacheUidPwdSet -cacheUid scott -cachPwd tiger SalesData

    SalesData DSNの現行のキャッシュ管理ユーザーIDを取得するには、次のコマンドを実行します。

    ttAdmin -cacheUidGet SalesData

    ttAdminによって、次のような出力が表示されます。

    Cache User Id: scott
    RAM Residence Policy: inUse
    Replication Agent Policy: manual
    Replication Manually Started: False
    Cache Agent Policy: manual
    Cache Agent Mannualy Started: False

注意

ユーザーが相対パスを使用してデータ・ストアに対してキャッシュ・エージェントを起動しようとすると、TimesTenは実行されている場所に対する相対パスでデータ・ストアを検索し、失敗します。たとえば、Windows上でデータ・ストアのパスをDataStore=./dsn1として指定し、コマンドttAdmin -cacheStart dsn1でキャッシュ・エージェントを起動しようとしても、キャッシュ・エージェントはinstall_dir\srv\dsn1でデータ・ストアを検索するため起動しません。UNIXの場合は、/var/TimesTen/instanceのディレクトリを検索します。

自動リフレッシュ（OracleからTimesTenへの自動伝播）またはASYNCHRONOUS WRITETHROUGHキャッシュ・グループを使用する場合は、キャッシュ管理ユーザーIDとパスワードを指定する必要があります。このユーザー・アカウントは、AUTOREFRESHおよびASYNCHRONOUS WRITETHROUGH処理の実行に使用されます。

Oracleデータをロードするには、TimesTenキャッシュ・エージェントが実行されている必要があります。このためには、ORACLE_HOME環境変数にOracleインストールのパスが設定されている必要があります。詳細は、『Oracle TimesTen Cache Connect to Oracle開発者および管理者ガイド』を参照してください。設定するその他の環境変数の詳細は、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』の環境の変更に関する項を参照してください。

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

ttAdminが-repstartを指定してコールされたときに、レプリケーション定義が見つからない場合、レプリケーション・エージェントは開始されず、ttAdminによってエラー・メッセージが出力されます。次に例を示します。

    $ ttAdmin -repStart rep1
    ttAdmin: Error from TimesTen daemon: Information about the local data
    store is unavailable; the replication schema may be empty or
    incomplete

    ttAdminに-ramPolicy alwaysを指定して使用すると、データ・ストアに永続的なシステム接続が作成されます。-ramPolicy alwaysは、共有データ・ストアに対してのみ指定できます。

    一時データ・ストアをサポートするramPolicyは、ramLoadを同時に使用したramPolicy manualのみです。

関連項目

ttStatus
ttCachePolicy
ttCacheUidGet
ttCacheUidPwdSet
ttCacheStart
ttCacheStop