Oracle TimesTen In-Memory Database APIリファレンス・ガイド

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

AUTOREFRESH（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 repl1

*** [TimesTen][TimesTen 7.0.3.0.0 ODBC Driver][TimesTen]TT8191:
This store (repl1 on my_host) is not involved in a replication scheme -- file "eeProc.c", lineno 11016, procedure "RepAdmin()"

*** ODBC Error = S1000, TimesTen Error = 8191

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

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

-repPolicy manual（デフォルト）または-repPolicy alwaysを指定してttAdminを使用する場合は、-ramPolicy alwaysオプションも使用する必要があります。これによって、障害発生後できるかぎり迅速にレプリケーション・エージェントでリカバリが開始されます。

ttAdmin

説明

アクセス制御

構文

オプション

例

注意

関連項目