管理エージェントのEMCTLコマンド

表27-3に、管理エージェントのEMCTLコマンドを示します。

表27-3 管理エージェントのEMCTLコマンド

EMCTLコマンド	説明
emctl start agent	管理エージェントを起動します。 大規模なメモリー構成を使用するIBM AIX環境で、管理エージェントによって多数のターゲットがモニタリングされている場合、エージェントが起動しないことがあります。この問題を防止するには、管理エージェントを起動する前に、共通の環境ファイルに次のパラメータを追加します。 LDR_CNTRL="MAXDATA=0x80000000"@NOKRTL AIXTHREAD_SCOPE=S LDR_CNTRL変数は、データ・セグメントのサイズを設定し、カーネル空間でのランタイム・ライブラリのロードを無効にします。AIXTHREAD_SCOPEパラメータは、AIXスレッドスコープのコンテキストを、デフォルトのP(プロセス全体)からS(システム全体)に変更します。これにより、mutexの競合が少なくなります。
emctl stop agent	管理エージェントを停止します。
emctl status agent	管理エージェントのステータスをリストします。 管理エージェントが実行中の場合、このコマンドで、エージェント・ホーム、プロセスIDおよび最後に成功した管理リポジトリへのアップロードの日時など、管理エージェントに関するステータス情報を表示します。 注意: コマンドの実行前にWindowsシステム上でディレクトリをAGENT_INSTANCE_HOMEディレクトリに変更します。
emctl status agent -secure	管理エージェントの保護ステータスおよび管理エージェントが実行している保護モード・ポートをリストします。また、OMSのセキュリティ・ステータスおよびポートもリストします。
emctl status agent scheduler	実行中、準備完了および計画のすべての収集スレッドをリストします。
emctl status agent jobs	現在管理エージェントで実行しているジョブのステータスをリストします。
emctl status agent target <target name>,<target type>,<metric>	指定されたターゲットの詳細ステータス(ターゲット名、ターゲット・タイプなど)をリストします。emctl status agentコマンドに特定のメトリック名を指定することで、ターゲットの特定のメトリックのステータスも取得できます。
emctl status agent mcache <target name>,<target type>,<metric>	メトリック・キャッシュに値が存在しているメトリックの名前をリストします。
emctl upload	アップロードが保留されている.xmlファイルをアップロード・ディレクトリのOMSにアップロードします。
emctl upload (agent)	管理対象ホストから管理サービスに対する現在の管理データの即時アップロードを強制実行するには、このコマンドを使用します。このコマンドは、次に予定されているデータのアップロードまで待てない場合に使用できます。
emctl reload (agent)	このコマンドは、emd.propertiesファイルを手動で変更した後に、変更を適用する場合に使用できます。たとえば、アップロード間隔を変更するには、emd.propertiesを変更した後、emctl reloadを実行できます。 注意: 手順が明確に文書化されている場合またはOracleサポートからユーザーに指示があった場合を除いて、手動によるtargets.xmlファイルの編集はサポートされていません。
emctl reload agent dynamicproperties [<Target_name>:<Target_Type>]...	ターゲットの動的プロパティを再計算し、表示します。
emctl pingOMS [agent]	OMSにpingを送信して、管理エージェントがOMSに接続できるかどうかを確認します。pingOMSが正常であることを確認できるように、管理エージェントはOMSからpingが返されるまで待機します。
emctl config agent getTZ	環境に設定したとおり現在のタイムゾーンを構成します。
emctl config agent getSupportedTZ	環境に設定されている値に基づいてサポートされているタイムゾーンを表示します。
emctl config console <fileloc> [<EM loc>]	ファイル<fileloc>に指定されている構成エントリに基づいてコンソールを構成します。 <EM loc>パラメータはオプションで、別のOracleホームで動作するために使用できます。
emctl config agent listtargets [<EM loc>]	管理エージェントによってモニターするすべてのターゲット名およびタイプ(targets.xmlファイルにあります)をリストします。 <EM loc>パラメータはオプションで、別のOracleホームで動作するために使用できます。
emctl control agent runCollection <target_name>:<target_type> <metric_name>	ターゲットの特定のメトリックの収集を手動で実行できます。 たとえば、emctl control agent runCollection myOracleHomeTargetName:oracle_home oracle_home_configです。
emctl control agent runCollection <targetName>:<targetType> <colletionItemName>	メトリック収集の即時再評価を実行します このコマンドを実行すると、メトリックの再評価された値が管理リポジトリにアップロードされ、メトリックがしきい値を超えた場合にアラートをトリガーします。 メトリックに関連付けられているメトリック名と収集項目名を特定するには、「EMCTLコマンドを使用したメトリック収集の再評価」を参照してください。
emctl resetTZ agent	管理エージェントのタイムゾーンをリセットします。現在のタイムゾーンを別のタイムゾーンに変更するには、管理エージェントを停止してから、このコマンドを実行します。その後、管理エージェントを起動します。 重要: 管理エージェントのタイムゾーンを変更する前に、管理エージェントで管理されているターゲットで現在実行中または実行予定のブラックアウトがあるかどうかを確認してください。ブラックアウトの確認方法については、「ブラックアウト/通知ブラックアウトの表示」を参照してください。 ブラックアウトが存在する場合は、Cloud Controlコンソールから、その管理エージェントでモニターされているすべてのターゲットでスケジュールされているブラックアウトおよび現在実行中のブラックアウトをすべて停止します。その後、管理エージェントのタイムゾーンを変更でき、さらに必要に応じてターゲットに新しいブラックアウトを作成できます。
emctl getversion agent	管理エージェントのバージョンを出力します。
emctl dumpstate agent <component> . . .	管理エージェントのダンプを生成します。このコマンドを使用すると、管理エージェントのメモリー/CPUに関する問題を分析できます。
emctl gensudoprops	管理エージェントのsudoプロパティを生成します。
emctl clearsudoprops	sudoプロパティをクリアします。
emctl clearstate	状態ディレクトリの内容をクリアします。このコマンドを実行すると、$ORACLE_HOME/sysman/emd/stateにあるファイルが削除されます。状態ファイルは、管理エージェントによって対応する.xmlファイルに変換されるのを待機しているファイルです。
emctl getemhome	管理エージェントのホーム・ディレクトリを出力します。
emctl start blackout <Blackoutname> [-nodeLevel] [<Target_name>[:<Target_Type>]].... [-d <Duration>]	ターゲットでブラックアウトを開始します。 パラメータ<Target_name:Target_type>を入力しないと、デフォルトとしてローカル・ノード・ターゲットが取得されます。<Blackoutname>の後に-nodeLevelパラメータを指定すると、ブラックアウトがすべてのターゲットに適用され、その後に続くターゲット・リストは無視されます。<Duration>は[days] hh:mmの形式で指定する必要があります。
emctl stop blackout <Blackoutname>	特定のターゲット上で開始されたブラックアウトを停止します。emctlを使用して停止できるのは、emctlツールによって開始されたブラックアウトのみです。このコマンドでは、コンソールまたはemcliユーティリティを使用して開始されたブラックアウトは停止できません。
emctl status blackout[<Target_name>[:<Target_Type>]]....	ターゲットのブラックアウトのステータスを示します。ステータスには、ブラックアウトのタイプ、ブラックアウトが1回のアクションか、繰返しか、またはスケジュール済のいずれであるかが含まれます。このコマンドは、ブラックアウトが開始または停止されているかどうかも指定します。
emctl secure agent [registration password] -emdWalletSrcUrl <url> -protocol <ssl|tls>	OMSで管理エージェントを保護します。コマンドで登録パスワードを指定しなかった場合は入力が求められるため、このパスワードは必須です。 -emdWalletSrcUrlパラメータは、エージェントを保護する必要があるOMSのURLを示します。 -protocolパラメータは、管理エージェントを保護するために使用するプロトコルを示します。使用できる値は、sslおよびtlsです。
emctl unsecure agent	管理エージェントの保護を解除します。このコマンドは、管理エージェントのポートをHTTPポートに変更します。このコマンドを実行した後、管理エージェントは、OMSのHTTPSアップロード・ポートではなく、HTTPアップロード・ポートに接続することによって、HTTPのOMSにアップロードできるようになります。
emctl verifykey	pingOMSの送信によって、OMSと管理エージェント間の通信を検証します。
emctl deploy agent [-s <install-password>] [-o <omshostname:consoleSrvPort>] [-S] <deploy-dir> <deploy-hostname>:<port> <source-hostname>	管理エージェントのみ作成およびデプロイします。 次に各パラメータについて説明します。 [-s <password>]: 管理エージェントを保護するためのインストール・パスワードを示します。 [-S ]: パスワードがSTDINで指定されることを示します。 [-o <omshostname:consoleSrvPort>]: OMSホスト名およびコンソール・サーブレット・ポートを示します。保護解除されたポートを選択します。 <deploy-dir>: 共有(状態のみ)のインストール・ポートを作成するためのディレクトリを示します。 <deploy-hostname:port>: 共有(状態のみ)インストールのホスト名およびポートを示します。未使用のポートを選択します。 <source-hostname>: ソース・インストールのホスト名を示します。通常、EMがインストールされているマシンです。ホスト名は、targets.xmlファイルで検索されるか、またはこのファイルで引数<deploy-hostname:port>で指定したホスト名と置き換えられます。 <sid>: リモート・データベースのインスタンスを示します。dbconsoleをデプロイする場合にのみ指定します。
emctl setproperty agent	管理エージェント構成ファイルで指定したプロパティ名および値を構成します。フラグallow_newは、管理エージェント構成ファイルに新しいプロパティが存在しない場合に挿入するオプションのフラグです。
emctl getproperty agent	管理エージェント構成ファイルから、指定したプロパティまたはプロパティのカテゴリを取得します。現在、このコマンドでは名前に空白を使用できません。フラグ-nameは、プロパティ名のリストを空白で区切って表示します。
emctl clear_property agent	管理エージェント構成ファイルで指定したプロパティの値を消去します。
emctl status agent verify	管理エージェントが稼働していることを確認します。