この項では、コントロール・センター・エージェント(CCA)を開始および停止する方法とcca_admin
ユーティリティを使用してCCAを管理する方法について説明します。CCAは、コード・テンプレートに基づいてマッピングのデプロイメントおよび実行を管理します。CCAはOracle Database内でホストされているコントロール・センター・サービスの一部ではありません。
この項では、次の項目について説明します。
関連項目:
|
この項では、CCAを起動および停止する方法について説明します。
ccastart
を初めて起動すると、OC4J管理者アカウントのパスワードを入力するように求められます。このアカウントのデフォルト・ユーザー名は、oc4jadmin
です。
CCAを起動するには:
UNIXの場合、OWB_HOME
/owb/bin/unix/
ディレクトリで、スクリプトccastart
を実行します。
Windowsの場合、OWB_HOME
\owb\bin\win32\
ディレクトリで、スクリプトccastart.bat
を実行します。
CCAを停止するには:
UNIXの場合、OWB_HOME
/owb/bin/unix/
ディレクトリで、スクリプトccashut
を実行します。このスクリプトでは、オプションの引数password
を受け入れます。
Windowsの場合、OWB_HOME
\owb\bin\win32\
ディレクトリで、スクリプトccashut.bat
を実行します。このスクリプトでは、オプションの引数password
を受け入ます。
このインストールのアーキテクチャ構造の図については、図1-5「コントロール・センター・エージェントのトポロジ」を参照してください。
インストールのデフォルトを変更する手順では、第7章「リポジトリ・ブラウザ、コントロール・センター・エージェント、およびその他のコンポーネントの構成」
cca_admin
ユーティリティを使用すると、ランタイム環境をいったん停止してから再起動しなくても、コントロール・センター・エージェント設定を動的に変更できます。cca_adminコマンドでは、様々な環境の属性の値を取得し、これらに新しい値を設定し、「JRTAdministratorMBean」の項で説明されているJRTAdministratorMBean
の操作を呼び出します。
通常のcca_admin
セッションは、次の手順で構成されます。
「cca_adminユーティリティの起動」の説明に従って、cca_admin
スクリプトを実行します。
「connect」で説明されているconnect
コマンドを使用してMBeanServerに接続します。
ランタイム環境属性を表示または更新するための1つ以上のコマンドを発行するか、「cca_adminコマンド」で説明されているcca_adminコマンドを起動します。
コマンドdisconnectまたはコマンドexitを使用してサーバーからの接続を解除する
cca_admin
ツールはLinux上のシェル・スクリプトまたはWindows上のバッチ・ファイルとして提供されます。
UNIXの場合、次のコマンドを使用します。
OWB_HOME
/owb/bin/unix/cca_admin
Windowsの場合、次のコマンドを使用します。
OWB_HOME
¥owb¥bin¥win32¥cca_admin.bat
JRTAdministratorMBean
をアクティブ化する前は、基本コマンドhelp
、connect
、disconnect
、およびexit
のみを使用することができます。MBeanサーバーに接続し、JRTAdministratorMBean
を使用して起動した後は、すべてのコマンドを使用できます。
この項では、以降にcca_admin
コマンドの完全なリストを示します。
このコマンドでは、startDate
からendDate
までと指定された期間に変更されたすべてのログ・ファイルを削除し、削除された合計ファイル数を返します。両方のパラメータはDD-MM-YYYY HH:MM:SS
の形式で表されます。startDate
がnull
に指定された場合、レコードは削除されません。endDate
がnull
に指定された場合、endDate
後に作成されたすべてのログ・ファイルはパージされます。
このコマンドでは、指定された数n
の古いログ・ファイルをシステムから削除し、実際に削除されたジョブ・ログ・ファイルの数を返します。
このコマンドでは、ユーザーをMBeanサーバーに接続します。
コマンドは、次のフォームです。ここで、host
はCCAの格納されているコンピュータで、port
はCCAにアクセスするポート番号、user
はCCAにアクセスするユーザー名、password
はユーザーのパスワード、connection_type
はRMI
、OPMN
、RMIS
、OPMN_RMIS
、OPMN_CLUSTER
、OPMN_CLUSTER_RMIS
のいずれかで、application_name
はOC4Jにデプロイしたアプリケーションの名前、また、instance
はCCAアプリケーションを含むOC4Jプロセスです。
connect host port user password connection_type application_name instance
このコマンドでは、インタラクティブ・モードで実行されているときに、cca_admin
シェルを終了します。MBeanサーバーへの接続が終了していない場合は、まず、接続を解除し、cca_admin
シェルを終了します。
このコマンドは、CCAでメモリー内ジョブ・ログ・キャッシュによって格納できるジョブ・ステータス・ログの最大数を制御する、数値型(整数)のMBean属性CacheJobStatusSize
の値を返します。この属性の値の範囲は1
から10000
、デフォルト値は3000
です。
このコマンドは、MBean属性CacheLogNo
の値を返します。この属性は、CCAでメモリー内ジョブ・ログ・キャッシュによって格納できるジョブ・ログの最大数を制御します。この数値が大きくなるほど、CCAが使用するメモリー量が増えます。この属性の値の範囲は1
から100
、デフォルト値は10
です。
このコマンドは、ct_permissions.properties
ファイルへのファイルシステム・パスであるMBean属性KmPermissionsFile
の値を返します。このパラメータをtrue
に設定すると、CCAはct_permissions.properties
を確認し、実行可能なシステム・コマンドを判断します。このパスには絶対パスと相対パスがあります。相対値の場合は、$OC4J_HOME
/j2ee/home
ディレクトリを示します。デフォルト値はconfig/ct_permissions.properties
です。
このコマンドは、CCAジョブ・ログ・ファイルを格納するディレクトリであるMBean属性LogRoot
の値を返します。属性値は絶対値または相対値です。相対値の場合、$OC4J_HOME
/j2ee/home
ディレクトリを示します。デフォルト値は$OC4J_HOME
/j2ee/home/log
です。
実行が中断されるまでの最大待機時間(秒単位)であるMBean属性MaxAbortTimeout
の値を返します。この属性の値の範囲は1
から60
、デフォルト値は60
です。
このコマンドは、任意のログ・ファイルの最大サイズ(MB
単位)であるMBean属性MaxRuntimeFileSizeMB
の値を返します。ログ・ファイルがこの制限を超えると、このログ・ファイルは閉じられ、新規ログ・ファイルが開かれます。この属性の値の範囲は1
MB
から15
MB
、デフォルト値は3
MB
です。
このコマンドは、ログ・ファイル・ディレクトリの最大サイズ(MB
単位)であるMBean属性MaxRuntimeLogSizeMB
の値を返します。ディレクトリがこの制限値を超えると、ログ・ファイルが古いものから順にパージされます。この属性の値の範囲は1
MB
から20
MB
、デフォルト値は10
MB
です。
このコマンドは、ログ・ファイルのキャラクタ・エンコーディングを指定するMBean属性RuntimeLogEncoding
の値を返します。デフォルト値はUTF-8
です。
このコマンドは、CCAジョブ・ログ・ファイルの名前であるMBean属性RuntimeLogFileLocation
(読取り専用属性)の値を返します。この値は$OC4J_HOME
/j2ee/home/log/
appName
.log
です。appName
はCCAアプリケーションの名前です。
このアプリケーションは、ランタイム・ログ出力のログ・レベルであるMBean属性RuntimeLogLevel
の値を返します。この属性の正規の値は、SEVERE
、WARNING
、INFO
、CONFIG
、FINE
、FINER
、FINEST
、ALL
(デフォルト)です。
このコマンドでは、指定された有効なcommand
に対してヘルプ情報が返されます。コマンドが指定されていない場合、有効なコマンドのリストが返されます。
このコマンドは、MBean属性KmSecurityNeeded
の値を返します。この属性により、CCAスクリプトによって呼び出されるシステム・コマンドに対してセキュリティが適用されるかどうかが決まります。この値がtrue
(デフォルト)である場合、CCAは使用可能なシステム・コマンドについてct_permissions.properties
ファイルを確認し、ALLOWED_CMD
に定義されているコマンドのみを実行します。この値がfalse
である場合、CCAはすべてのシステム・コマンドを実行します。
このコマンドは、監査表ロギングのオンとオフを切り替えるMBean属性LogToAuditTable
の値を返します。監査表ロギングは実行ジョブ・ログに対してのみ有効です。この属性値はtrue
またはfalse
のいずれかです。
このコマンドは、ODLロギングのオンとオフを切り替えるMBean属性LogToOdl
の値を返します。実行ジョブ・ログに対してのみ有効です。デプロイメントおよびWebサービスのログは、この設定値とは関係なく、常にODLログ形式で作成されます。この属性値はtrue
またはfalse
のいずれかです。
このコマンドは、MBean属性ShowRuntimeLoggerLogHostAddr
の値を返します。この属性により、CCAを実行しているホストのIPアドレスがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、MBean属性ShowRuntimeLoggerLogHostId
の値を返します。この属性により、CCAを実行しているホストのIDがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、MBean属性ShowRuntimeLoggerLogMsgClassPath
の値を返します。この属性により、メッセージが記録されるクラスのパスがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、MBean属性ShowRuntimeLoggerLogMsgLogLevel
の値を返します。この属性により、ログ・メッセージのログ・レベルがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、MBean属性ShowRuntimeLoggerLogUserId
の値を返します。この属性により、ユーザーのIDがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、MBean属性CacheJobStatusSize
の値を設定します。この属性は、CCAでメモリー内ジョブ・ログ・キャッシュに格納できるジョブ・ステータスの最大数を制御します。この属性の値は整数で、その範囲は1
から10000
、デフォルト値は3000
です。
このコマンドは、MBean属性CacheLogNo
の値を設定します。この属性は、CCAでメモリー内ジョブ・ログ・キャッシュに格納できるジョブ・ログの最大数を制御します。この属性の値は整数で、その範囲は1
から100
、デフォルト値は10
です。
このコマンドは、ct_permissions.properties
ファイルへのファイルシステム・パスであるMBean属性KmPermissionsFile
の値を設定します。この値をtrue
に設定すると、CCAはこのファイルを確認し、実行可能なシステム・コマンドを判断します。このパスには絶対パスと相対パスがあります。相対値の場合は、$OC4J_HOME
/j2ee/home
ディレクトリを示します。デフォルト値はconfig/ct_permissions.properties
です。
このコマンドは、MBean属性KmSecurityNeeded
の値を設定します。この属性により、CCAスクリプトから呼び出されるシステム・コマンドに対してセキュリティが適用されるかどうかが決まります。この値がtrue
(デフォルト)である場合、CCAは使用可能なシステム・コマンドについてct_permissions.properties
ファイルを確認し、ALLOWED_CMD
に定義されているコマンドのみを実行します。この値がfalse
である場合、CCAはすべてのシステム・コマンドを実行します。
このコマンドは、CCAジョブ・ログ・ファイルのディレクトリであるMBean属性LogRoot
の値を設定します。属性値は絶対値または相対値です。相対値の場合、$OC4J_HOME
/j2ee/home
ディレクトリを示します。デフォルト値は$OC4J_HOME
/j2ee/home/log
です。
このコマンドは、監査表ロギングのオンとオフを切り替えるMBean属性LogToAuditTable
の値を設定します。監査表ロギングは実行ジョブ・ログに対してのみ有効です。この属性値はtrue
またはfalse
のいずれかです。
このコマンドは、ODLロギングのオンとオフを切り替えるMBean属性LogToOdl
の値を設定します。これは実行ジョブ・ログに対してのみ有効であり、デプロイメントおよびWebサービスのログは、この設定とは関係なく、常にODLログ形式で作成されます。この属性値はtrue
またはfalse
のいずれかです。
このコマンドは、実行が中断されるまでの最大待機時間(秒単位)であるMBean属性MaxAbortTimeout
の値を設定します。この属性の値は整数で、その範囲は1
から60
(デフォルト)です。
このコマンドは、ディレクトリ内のログ・ファイルの最大サイズ(MB単位)であるMBean属性MaxRuntimeFileSizeMB
の値を設定します。ログ・ファイルがこの制限を超えると、このログ・ファイルは閉じられ、新規ログ・ファイルが開かれます。この属性は整数で、その値の範囲は1
MB
から15
MB
、デフォルト値は3
MB
です。
このコマンドは、ログ・ファイル・ディレクトリの最大サイズ(MB
単位)であるMBean属性MaxRuntimeLogSizeMB
の値を設定します。ディレクトリがこの制限値を超えると、ログ・ファイルが古いものから順にパージされます。この属性の値の範囲は1
MB
から20
MB
、デフォルト値は10
MB
です。
このコマンドは、ログ・ファイルのキャラクタ・セットのエンコーディングを指定するMBean属性RuntimeLogEncoding
の値を設定します。デフォルト値はUTF-8
です。
このコマンドは、ランタイム・ログ出力のログ・レベルであるMBean属性RuntimeLogLevel
の値を設定します。この属性の値は、SEVERE
、WARNING
、INFO
、CONFIG
、FINE
、FINER
、FINEST
、ALL
(デフォルト)です。
このコマンドは、MBean属性ShowRuntimeLoggerLogHostAddr
の値を設定します。この属性により、CCAホストのIPアドレスがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、MBean属性ShowRuntimeLoggerLogHostId
の値を設定します。この属性により、CCAホストのIDがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、MBean属性ShowRuntimeLoggerLogMsgClassPath
の値を設定します。この属性により、メッセージを記録したクラスのパスがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、MBean属性ShowRuntimeLoggerLogMsgLogLevel
の値を設定します。この属性により、ログ・メッセージのログ・レベルがランタイム・ログ・メッセージに含まれるかどうかが決まります。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドは、ユーザーのIDをランタイム・ログ・メッセージに含めるかどうかを決定する、MBean属性ShowRuntimeLoggerLogUserId
の値を設定します。この属性値はtrue
またはfalse
(デフォルト)のいずれかです。
このコマンドでは、CCA設定情報をString
に変換し、すべてのCCA設定を表示します。