| Oracle Enterprise Manager管理 10gリリース5（10.2.0.5） B56251-01 |
|
 戻る |
 次へ |
この章では、コマンドライン・ユーティリティ（emctl）を使用して、管理サービス、管理エージェント、Grid Controlコンソール、Application Server ControlコンソールおよびDatabase Controlを起動および停止する方法について説明します。
また、この章では、様々なemctlコマンドと終了コード、およびログ情報を使用したemctlのトラブルシューティング方法も説明します。
この章では次の項について説明します。
次の項では、Enterprise Managerコマンドライン・ユーティリティ（emctl）を使用してOracle Management Agentを制御する方法を説明します。
UNIXシステム上の管理エージェントの起動、停止またはステータス確認を行う手順は、次のとおりです。
ディレクトリをAGENT_HOME/binディレクトリに変更します。
表9-1内の該当するコマンドを使用します。
たとえば、管理エージェントを停止するには次のコマンドを入力します。
$PROMPT> cd AGENT_HOME/bin
$PROMPT> ./emctl stop agent
表9-1 管理エージェントの起動、停止およびステータス確認
| コマンド | 目的 |
|---|---|
|
管理エージェントを起動します。 |
|
|
管理エージェントを停止します。 |
|
|
管理エージェントが実行中の場合、このコマンドで、エージェント・ホーム、プロセスIDおよび最後に成功した管理リポジトリへのアップロードの日時など、管理エージェントに関するステータス情報を表示します。 |
$PROMPT> ./emctl status agent Oracle Enterprise Manager 10g Release 10.2.0.5.0 Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. ----------------------------------------------------------------- Agent Version : 10.2.0.5.0 OMS Version : 10.2.0.5.0 Protocol Version : 10.2.0.5.0 Agent Home : /scratch/OracleHomesX/agent10g Agent binaries : /scratch/OracleHomesX/agent10g Agent Process ID : 17604 Parent Process ID : 17587 Agent URL : https://stadj32.us.oracle.com:3872/emd/main/ Repository URL : https://stadj32.us.oracle.com:1159/em/upload Started at : 2009-09-13 01:31:11 Started by user : test Last Reload : 2009-09-13 01:31:11 Last successful upload : 2009-09-13 01:39:01 Total Megabytes of XML files uploaded so far : 0.28 Number of XML files pending upload : 0 Size of XML files pending upload(MB) : 0.00 Available disk space on upload filesystem : 8.36% Last successful heartbeat to OMS : 2009-09-13 01:38:51 --------------------------------------------------------------- Agent is Running and Ready $PROMPT>
大規模なメモリー構成を使用するIBM AIX環境で、管理エージェントによって多数のターゲットが監視されている場合、エージェントが起動しないことがあります。この問題を回避するには、管理エージェントを起動する前に、シェル内で次の変数を設定します。
LDR_CNTRL="MAXDATA=0x80000000"@NOKRTL AIX_THREADSCOPE=S
LDR_CNTRL変数は、データ・セグメントのサイズを設定し、カーネル空間でのランタイム・ライブラリのロードを無効にします。AIX_THREADSCOPEパラメータは、AIXスレッドスコープのコンテキストを、デフォルトのP（プロセス全体）からS（システム全体）に変更します。これにより、mutexの競合が少なくなります。
WindowsシステムにOracle Management Agentをインストールすると、インストール時に3つの新規サービスが「サービス」コントロール パネルに作成されます。
「サービス」コントロール パネルにアクセスする手順は、使用しているMicrosoft Windowsのバージョンによって異なります。たとえばWindows 2000では、「スタート」メニューから「設定」→「管理ツール」を選択して「サービス」コントロール パネルに移動します。
|
注意: 「UNIX上の管理サービスの制御」に記載されているemctlユーティリティは、管理エージェントをインストールしたOracleホームのbinサブディレクトリで使用可能です。しかし、管理エージェントの起動および停止をWindowsシステム上で行う場合は「サービス」コントロール パネルの使用をお薦めします。 |
表9-2に、管理エージェントを制御する場合に使用するWindowsサービスを示します。
表9-2 管理エージェントをWindowsにインストールする場合にインストールおよび構成されるサービスのサマリー
| コンポーネント | サービス名の書式 | 説明 |
|---|---|---|
|
Oracle Management Agent |
Oracle<agent_home>Agent 例: OracleOraHome1Agent |
これを使用して管理エージェントを起動および停止します。 |
Oracle<oracle_home>SNMPPeerEncapsulator 例: OracleOraHome1PeerEncapsulator |
このサービスは、Simple Network Management Protocol（SNMP）の高度な機能を使用する場合にのみ使用します。 詳細は、『Oracle Enterprise Manager SNMPサポート・リファレンス・ガイド』を参照してください。 |
|
Oracle<oracle_home>SNMPPeerMasterAgent 例: OracleOraHome1PeerMasterAgent |
このサービスは、Simple Network Management Protocol（SNMP）の高度な機能を使用する場合にのみ使用します。 詳細は、『Oracle Enterprise Manager SNMPサポート・リファレンス・ガイド』を参照してください。 |
次の項では、Oracle Management Serviceを制御する方法を説明します。
Oracle Management ServiceをUNIXシステム上で起動および停止するには、2つの方法があります。 Oracle Process Management and Notification（OPMN）ユーティリティを使用するか、一連のemctlコマンドを使用できます。
次の項では、管理サービスを制御するこの2つの方法、およびGrid Controlコンソールでも必要となるOracleAS Web Cacheの起動および停止方法を説明します。
管理サービスを起動および停止する方法の1つとして、Oracle Process Management and Notification（OPMN）ユーティリティを使用する方法があります。OPMNユーティリティ（opmnctl）は、Oracle Application Serverインスタンスのコンポーネントを起動および停止するために使用される標準的なコマンドです。
管理サービスは、Application Server内のOracle Application Server Containers for J2EE（OC4J）インスタンスで実行されるJ2EEアプリケーションです。このため、次のコマンドによって、OC4J_EMインスタンスおよび管理サービス・アプリケーションを含むOracle Application Serverインスタンスのすべてのコンポーネントが起動します。
$PROMPT> cd opmn/bin $PROMPT> ./opmnctl startall
同様に、次のコマンドによってOracle Application Serverインスタンスのすべてのコンポーネントが停止します。
$PROMPT> ./opmnctl stopall
管理サービスの実行に必要なコンポーネントのみを起動する場合は、Enterprise Managerコマンドライン・ユーティリティを使用します。
Enterprise Managerコマンドライン・ユーティリティを使用した管理サービスの起動、停止またはステータス確認を行う手順は、次のとおりです。
ディレクトリを管理サービス・ホームのORACLE_HOME/binディレクトリに変更します。
表9-3内の該当するコマンドを使用します。
たとえば、管理サービスを停止するには、次のコマンドを入力します。
$PROMPT> cd bin $PROMPT> ./emctl stop oms
表9-3 管理サービスの起動、停止およびステータス確認
| コマンド | 目的 |
|---|---|
|
管理サービスJ2EEアプリケーションの実行に必要なOracle Application Serverコンポーネントを起動します。具体的にはこのコマンドによってOPMN、Oracle HTTP Server、および管理サービスがデプロイされているOC4J_EMインスタンスが起動します。 注意: Oracle Application Server Web Cacheは、 |
|
|
管理サービスを停止します。 このコマンドを使用して、Oracle Process Manager and Notification Server（OPMN）ユーティリティによって管理される他のプロセスを停止することはできません。Oracle HTTP ServerやOracle Application Server Web Cacheなどの他のOracle Application Serverコンポーネントを停止する方法は、「Oracle Enterprise Manager 10g Grid Controlの起動および停止」を参照してください。 |
|
|
管理サービスが実行中かどうかを示すメッセージを表示します。 |
デフォルトでは、Oracle Enterprise Manager 10gをインストールすると、Oracle Application Server Web Cacheを使用するようにGrid Controlコンソールが構成されます。
|
関連項目: Oracle Application Server Web Cacheの詳細は、『Oracle Application Server Web Cache管理者ガイド』を参照してください。 |
Oracle Application Server Web CacheではGrid Controlコンソールのパフォーマンスが改善されるのみでなく、Enterprise Manager Webアプリケーションのエンドユーザー・パフォーマンスの測定も可能になります。
Oracle Application Server Web Cacheを使用してGrid Controlコンソールを表示するには、Oracle Enterprise Manager 10gのインストール時に割り当てられた標準ポート番号を使用してGrid Controlコンソールにアクセスします。このデフォルトのポート番号（通常は7777）はsetupinfo.txtファイルに記述されており、このファイルはEnterprise Managerのインストール時に次のディレクトリにコピーされます。
AS_HOME/Apache/Apache
Oracle Application Server Web Cacheが実行されていない場合、デフォルトのポート番号を使用してGrid Controlコンソールにアクセスしようとすると、次のようなエラー・メッセージが表示されます。
HTTP 500 - Internal server error
Oracle Application Server Web Cacheを起動する手順は、次のとおりです。
表9-4内の該当するコマンドを使用します。
たとえば、Oracle Application Server Web Cacheを停止するには、次のコマンドを入力します。
$PROMPT> cd opmn/bin $PROMPT> ./opmnctl stopproc ias-component=WebCache
WindowsシステムにOracle Management Serviceをインストールすると、インストール時に3つの新規サービスが「サービス」コントロール パネルに作成されます。
「サービス」コントロール パネルにアクセスする手順は、使用しているMicrosoft Windowsのバージョンによって異なります。たとえばWindows 2000では、「スタート」メニューから「設定」→「管理ツール」を選択して「サービス」コントロール パネルに移動します。
|
注意: 「UNIX上の管理サービスの制御」に記載されているemctlユーティリティは、管理サービスをインストールしたOracleホームのbinサブディレクトリで使用可能です。しかし、管理サービスの起動および停止をWindowsシステム上で行う場合は「サービス」コントロール パネルの使用をお薦めします。 |
表9-5に、Oracle Management Serviceを制御する場合に使用するWindowsサービスを示します。
表9-5 Oracle Management ServiceをWindowsにインストールする場合にインストールおよび構成されるサービスのサマリー
| コンポーネント | サービス名の書式 | 説明 |
|---|---|---|
Oracle<oracle_home>ASControl 例: OracleOraHome1ASControl |
このサービスは、管理サービスJ2EEアプリケーションをデプロイするためにインストールおよび構成されたOracle Application Serverインスタンスに対するApplication Server Controlを起動および停止する場合に使用します。 |
|
Oracle<oracle_home>ProcessManager 例: OracleOraHome1ProcessManager |
このサービスは、管理サービスJ2EEアプリケーションをデプロイするためにインストールおよび構成されたOracle Application Serverインスタンスのすべてのコンポーネントを起動および停止する場合に使用します。 このサービスは、Grid Controlコンソールにアクセスするためにデフォルトで稼働する必要がある管理サービスおよびすべての関連コンポーネント（OC4J、Oracle HTTP ServerおよびOracleAS Web Cacheなど）を起動および停止する場合に使用します。 |
Application Server Controlは、すべてのOracle Application Serverインストールの一部としてインストールされるOracle Enterprise Manager 10gのコンポーネントです。次の項では、Application Server Controlを起動および停止する方法を説明します。
|
関連項目: 次の手順の詳細は、『Oracle Application Server管理者ガイド』を参照してください。
|
UNIXシステム上のApplication Server Controlコンソールを制御するには、Oracle Application Serverのインストール後にIAS_HOME/binディレクトリで使用可能なemctlコマンドライン・ユーティリティを使用します。
Application Server Controlコンソールを起動するには、ディレクトリをIAS_HOME/binディレクトリに変更し、次のコマンドを入力します。
$PROMPT> ./emctl start iasconsole
Application Server Controlコンソールを停止するには、次のコマンドを入力します。
$PROMPT> ./emctl stop iasconsole
Windowsシステム上のApplication Server Controlを起動または停止する手順は、次のとおりです。
「サービス」コントロール パネルを開きます。
たとえばWindows NTでは、「スタート」→「設定」→「コントロール パネル」を選択して「サービス」アイコンをダブルクリックします。
Windows 2000では、「スタート」→「管理ツール」→「サービス」を選択します。
サービス・リストでApplication Server Controlを探します。
このサービスの名前は通常Oracleで始まり、インストール時に指定したホーム・ディレクトリ名が続き、ASControlで終わります。たとえば、AS10gをOracleホームとして指定した場合、サービス名は次のようになります。
OracleAS10gASControl
サービスの場所を確認した後、「サービス」コントロール パネルを使用してApplication Server Controlサービスを起動または停止できます。
デフォルトでは、Application Server Controlサービスは、システムの起動時に自動的に起動するように構成されています。
また、NET START Oracleoms10gASControlを使用して、Windows上でOracle Application Server Controlコンソール（iasconsole）を起動することもできます。
Windows上でOracle Application Server Controlコンソール（iasconsole）を停止するには、NET STOP Oracleoms10gASControlを使用します。
Oracle Enterprise Manager 10g Database Controlコンソールは、すべてのOracle Database 10gインストールの一部としてインストールされるOracle Enterprise Manager 10gのコンポーネントです。
Database Controlを制御するには、Oracle Database 10gのインストール後にORACLE_HOME/binディレクトリで使用可能なemctlコマンドライン・ユーティリティを使用します。
Database Control、およびDatabase Controlに関連付けられている管理エージェントと管理サービスを起動する手順は、次のとおりです。
Database Control、およびDatabase Controlに関連付けられている管理エージェントと管理サービスを停止する手順は、次のとおりです。
Windowsシステム上のDatabase Controlを起動および停止する手順は、次のとおりです。
「サービス」コントロール パネルを開きます。
たとえばWindows NTでは、「スタート」→「設定」→「コントロール パネル」を選択して「サービス」アイコンをダブルクリックします。
Windows 2000では、「スタート」→「管理ツール」→「サービス」を選択します。
サービス・リストでDatabase Controlを探します。
このサービスの名前は通常Oracleで始まり、インストール時に指定したホーム・ディレクトリ名およびデータベース・システム識別子（SID）が続き、DBControlで終わります。たとえば、DB10gをOracleホームとして指定した場合、サービス名は次のようになります。
OracleDB10gDBControl
サービスの場所を確認した後、「サービス」コントロール パネルを使用してDatabase Controlサービスを起動または停止できます。
デフォルトでは、Database Controlサービスは、システムの起動時に自動的に起動するように構成されています。
「UNIX上のDatabase Controlの停止」で説明しているように、emctl stop dbconsoleを使用して、Windows上でDatabase Controlを起動することもできます。
Oracle Enterprise Manager 10gコンポーネントは、各種のOracleソフトウェア製品の管理に使用されます。たとえば、Oracle Application Server 10g（9.0.4）インスタンスをインストールすると、Application Server Controlもインストールされます。同様に、Oracle Database 10gをインストールするたびに、Database Controlがインストールされます。また、Database Controlによってシステムを集中管理する場合は、監視対象の各ホスト上に管理エージェントもインストールされています。
本番環境では、ソフトウェア・リソースのパフォーマンスおよび可用性を向上させるため、複数のホスト間にデータベースおよびアプリケーション・サーバー・インスタンスを分散させる場合がほとんどです。ただし、同一ホスト上に複数のアプリケーション・サーバーまたはデータベースをインストールする必要がある場合は、次のガイドラインを参考にしてください。
Application Server Control、管理エージェントまたはDatabase Controlを起動すると、Enterprise Managerはホストおよびその管理対象ターゲットに関する重要な監視データの収集を即時に開始します。ホスト上のコンポーネントの起動プロセスを開発する際は、このことを念頭に置いてください。
特に、次のプロセスが起動処理を開始する前に各Enterprise Managerプロセスが確実に起動できるように、起動プロセスの時間をずらすことを考慮してください。
たとえば、同一ホスト上にOracleAS Infrastructure 10g、J2EE and Web Cacheアプリケーション・サーバー・インストール・タイプおよび管理エージェントをインストールしていると仮定します。（システムの再起動の後などに）すべてのコンポーネントを起動する場合は、次のようなプロセスを使用します。
opmnctl startallコマンドを使用して、OracleAS Infrastructure 10gホーム・ディレクトリ内のすべてのOPMN管理プロセスを起動します。
15秒間待ちます。
emctl start iasconsoleコマンドを使用して、OracleAS Infrastructure 10gホーム・ディレクトリ内のApplication Server Controlを起動します。
15秒間待ちます。
opmnctl startallコマンドを使用して、J2EE and Web Cacheホーム・ディレクトリ内のすべてのOPMN管理プロセスを起動します。
15秒間待ちます。
emctl start iasconsoleコマンドを使用して、J2EE and Web Cacheホーム・ディレクトリ内のApplication Server Controlを起動します。
15秒間待ちます。
emctl start agentコマンドを使用して、ホストの管理エージェントを起動します。
前述の例のような時間差をおく起動手順を使用することによって、各コンポーネントのCPU集中型の起動段階において、リソースに対するプロセスの競合が回避されます。
前述の項で説明したように、Oracle Management Service、Oracle Management Agent、およびGrid Controlが依存するOracle Application Serverコンポーネントを制御するには、別々のコマンドを使用します。
次の項では、Oracle Enterprise Manager 10g Grid Controlコンソールのインストール時にインストールされるすべてのGrid Controlコンポーネントを停止および起動する方法を説明します。
この手順を使用して、システムの再起動後にすべてのフレームワーク・コンポーネントを起動することや、システム・メンテナンスのためにシステムを停止する前にすべてのコンポーネントを停止することができます。
次の手順には、Grid Controlのすべてのコンポーネントの起動に必要なステップがまとめられています。たとえば、ホスト・コンピュータを再起動し、Grid Controlのすべてのコンポーネントがそのホスト上にインストールされている場合は、この手順を使用します。
ホスト上のすべてのGrid Controlコンポーネントを起動する手順は、次のとおりです。
Oracle Management Repositoryがホスト上にある場合は、管理リポジトリをインストールした対象のデータベースのOracleホームにディレクトリを変更し、データベースおよびそのデータベースのNet Listenerを起動します。
ORACLE_HOME環境変数を管理リポジトリ・データベースのホーム・ディレクトリに設定します。
ORACLE_SID環境変数を管理リポジトリ・データベースのSID（デフォルトはasdb）に設定します。
Net Listenerを起動します。
$PROMPT> $ORACLE_HOME/bin/lsnrctl start
ORACLE_HOME/bin/sqlplus /nolog
SQL> connect SYS as SYSDBA
SQL> startup
SQL> quit
|
関連項目: Oracle Databaseの起動および停止の詳細は、『Oracle Database管理者ガイド』を参照してください。 |
Oracle Management Serviceを起動します。
$PROMPT> ORACLE_HOME/bin/emctl start oms
OracleAS Web Cacheを起動します。
$PROPMT> $ORACLE_HOME/opmn/bin/opmnctl startproc ias-component=WebCache
ディレクトリをOracle Management Agentのホーム・ディレクトリに変更し、管理エージェントを起動します。
$PROMPT> AGENT_HOME/bin/emctl start agent
|
注意: emctl start agentコマンドは、管理サービスのホーム・ディレクトリではなく、必ずOracle Management Agentのホーム・ディレクトリで実行してください。 |
オプションで、管理サービスをデプロイするOracle Application Serverインスタンスの管理に使用される、Application Server Controlコンソールを起動します。
$PROMPT> $ORACLE_HOME/bin/emctl start iasconsole
次の手順には、Grid Controlのすべてのコンポーネントの停止に必要なステップがまとめられています。たとえば、ホスト・コンピュータを停止または再起動する対象のホストと同じホストに、Grid Controlのすべてのコンポーネントをインストールしている場合は、この手順を使用します。
ホスト上のすべてのGrid Controlコンポーネントを停止する手順は、次のとおりです。
Oracle Management Serviceを停止します。
$PROMPT> $ORACLE_HOME/bin/emctl stop oms
必要に応じて、管理サービスをデプロイするOracle Application Serverインスタンスの管理に使用される、Application Server Controlコンソールを停止します。
$PROMPT> $ORACLE_HOME/bin/emctl stop iasconsole
Oracle HTTP ServerやOracleAS Web CacheなどのすべてのOracle Application Serverコンポーネントを停止します。
$PROMPT> $ORACLE_HOME/opmn/bin/opmnctl stopall
|
関連項目: 『Oracle Application Server管理者ガイド』 |
ディレクトリをOracle Management Agentのホーム・ディレクトリに変更し、管理エージェントを停止します。
$PROMPT> AGENT_HOME/bin/emctl stop agent
|
注意: emctl stop agentコマンドは、Oracle Application Serverのホーム・ディレクトリではなく、必ずOracle Management Agentのホーム・ディレクトリで実行してください。 |
Oracle Management Repositoryが同一ホスト上にある場合は、管理リポジトリをインストールした対象のデータベースのOracleホームにディレクトリを変更し、データベースおよびそのデータベースのNet Listenerを停止します。
ORACLE_HOME環境変数を管理リポジトリ・データベースのホーム・ディレクトリに設定します。
ORACLE_SID環境変数を管理リポジトリ・データベースのSID（デフォルトはasdb）に設定します。
データベース・インスタンスを停止します。
$PROMPT> ORACLE_HOME/bin/sqlplus /nolog SQL> connect SYS as SYSDBA SQL> shutdown SQL> quit
|
関連項目: Oracle Databaseの起動および停止の詳細は、『Oracle Database管理者ガイド』を参照してください。 |
Net Listenerを停止します。
$PROMPT> $ORACLE_HOME/bin/lsnrctl stop
次の項では、管理エージェントの制御に使用できる、その他のemctlコマンドについて説明します。
通常の環境では、管理対象ターゲットについての情報は管理エージェントによって管理サービスへ定期的にアップロードされます。
ただし、管理サービスへのデータの即時アップロードや、管理エージェント・ホーム・ディレクトリに保存されているターゲットの定義および属性のリロードを、強制的に実行できる2つのEnterprise Managerコマンドがあります。
このコマンドを使用するには、ディレクトリをAGENT_HOME/binディレクトリ（UNIX）またはAGENT_HOME\binディレクトリ（Windows）に変更し、表9-6の該当するコマンドを入力します。
表9-6 手動による管理データのリロードおよびアップロード
| コマンド | 目的 |
|---|---|
|
管理対象ホストから管理サービスに対する現在の管理データの即時アップロードを強制実行するには、このコマンドを使用します。このコマンドは、次に予定されているデータのアップロードまで待てない場合に使用できます。 |
|
|
このコマンドは、 注意: 手順が明確に文書化されている場合またはOracleサポートからユーザーに指示があった場合を除いて、手動による |
データベース・ターゲットのパフォーマンスを監視するため、Enterprise Managerはデータベースのユーザー名およびパスワードを使用してデータベースに接続されます。このユーザー名とパスワードの組合せが、データベースの監視資格証明と呼ばれます。
Oracle9iデータベース・ターゲットを最初に追加したとき、または管理エージェントのインストール時に追加されたとき、Enterprise Managerでは監視資格証明として、DBSNMPデータベース・ユーザー・アカウントとDBSNMPアカウントのデフォルト・パスワードが使用されます。
Oracle Database 10gをインストールする際、データベースのインストール手順でDBSNMP監視パスワードを指定します。
このため、DBSNMPデータベース・ユーザー・アカウントのパスワードが変更されている場合は、データベース・ターゲットのプロパティを変更して、Enterprise Managerが引き続きデータベースに接続して構成およびパフォーマンス・データを収集できるようにする必要があります。
同様に、Grid Controlに新規のOracle Database 10gターゲットを追加したらすぐに、データベースのインストール時に定義したDBSNMPパスワードを認識するようにターゲットを構成する必要があります。このように構成しない場合、データベースのホームページに監視データが何も表示されず、データベースのステータスにメトリック収集エラーが示される可能性があります。
Oracle Enterprise Manager 10g Grid ControlコンソールまたはEnterprise Managerコマンドライン・ユーティリティ（emctl）を使用して、Enterprise Managerの監視資格証明を変更できます。
Oracle Enterprise Manager 10g Grid ControlコンソールでDBSNMPアカウントのパスワードを変更する手順は、次のとおりです。
Grid Controlコンソールで、「ターゲット」タブをクリックします。
「データベース」サブタブをクリックして、監視しているデータベース・ターゲットをリストします。
データベースを選択して「構成」をクリックします。
Enterprise Managerに「データベースの構成: プロパティ」ページが表示されます。
「モニター・パスワード」フィールドにDBSNMPアカウントの新しいパスワードを入力します。
「接続のテスト」をクリックして、監視資格証明が正しいことを確認します。
接続に成功したら、データベース構成ウィザードの最後まで進み、「発行」をクリックします。
Enterprise Managerコマンドライン・ユーティリティで新しい監視資格証明を入力する手順は、次のとおりです。
ディレクトリを、AGENT_HOME/binディレクトリ（UNIX）またはAGENT_HOME\binディレクトリ（Windows）に変更します。
次のコマンドを入力して、新しい監視資格証明を指定します。
$PROMPT>./emctl config agent credentials [Target_name[:Target_Type]]
正しいターゲット名およびターゲット・タイプを決定する方法は、「管理対象ホスト上のターゲットのリスト表示」を参照してください。
例9-2に、プロンプトと、コマンドから返される出力の例を示します。
$PROMPT>./emctl config agent credentials emrep10.acme.com:oracle_database Oracle Enterprise Manager 10g Release 10.1.0.2.0 Copyright (c) 2002, 2003 Oracle Corporation. All rights reserved. Name = emrep10.us.oracle.com, Type = oracle_database Want to change for "UserName" (y/n):n Want to change for "password" (y/n):y Enter the value for "password" :******* EMD reload completed successfully
管理している特定のターゲットの名前およびタイプを提供することが必要な場合があります。たとえば、ターゲットの監視資格証明を設定するときは、ターゲットの名前およびタイプを知っておく必要があります。
特定の管理エージェントで現在監視されている、各ターゲットの名前およびタイプをリストする手順は、次のとおりです。
ディレクトリを、AGENT_HOME/binディレクトリ（UNIX）またはAGENT_HOME\binディレクトリ（Windows）に変更します。
次のコマンドを入力して、新しい監視資格証明を指定します。
$PROMPT>./emctl config agent listtargets [AGENT_HOME]
例9-3に、標準的なコマンド出力を示します。
例9-3 管理対象ホスト上のターゲットのリスト表示
./emctl config agent listtargets Oracle Enterprise Manager 10g Release 10.1.0.2.0 Copyright (c) 2002, 2003 Oracle Corporation. All rights reserved. [usunnab08.us.oracle.com, host] [LISTENER_usunnab08.us.oracle.com, oracle_listener] [EnterpriseManager.usunnab08.us.oracle.com_HTTP Server, oracle_apache] [EnterpriseManager.usunnab08.us.oracle.com_home, oc4j] [EnterpriseManager.usunnab08.us.oracle.com_Web Cache, oracle_webcache] [EnterpriseManager.usunnab08.us.oracle.com, oracle_ias] [EnterpriseManager.usunnab08.us.oracle.com_OC4J_EM, oc4j] [EnterpriseManager.usunnab08.us.oracle.com_OC4J_Demos, oc4j] [EM_Repository, oracle_emrep] [usunnab08.us.oracle.com:1813, oracle_emd] [EM Website, website] [emrep10.us.oracle.com, oracle_database]
ブラックアウトを使用すると、Enterprise Managerのユーザーは、管理データ収集アクティビティを1つ以上の管理対象ターゲットで一時停止できます。たとえば、予定されているメンテナンスや緊急の操作の間、データ収集が行われないようにするため管理者が使用します。
|
関連項目: Enterprise Managerのブラックアウトの詳細は、『Oracle Enterprise Manager概要』の「システムの監視」を参照してください。 |
ブラックアウトは、Oracle Enterprise Manager 10g Grid ControlコンソールまたはEnterprise Managerコマンドライン・ユーティリティ（emctl）から制御できます。ただし、コマンドラインでターゲットのブラックアウトを制御している場合は、同じブラックアウトをGrid Controlコンソールでは制御しないでください。同様に、Grid Controlコンソールでターゲットのブラックアウトを制御している場合は、そのブラックアウトをコマンドラインでは制御しないでください。
|
関連項目: Grid Controlコンソールからブラックアウトを制御する方法の詳細は、Enterprise Managerオンライン・ヘルプのブラックアウトの作成、編集および表示に関する項を参照してください。 |
コマンドラインでは、次のブラックアウト機能を実行できます。
即時ブラックアウトの開始
即時ブラックアウトの停止
即時ブラックアウトのステータス確認
|
注意: コマンドラインでブラックアウトを開始すると、ブラックアウトされるターゲットに対して実行を予定されているEnterprise Managerジョブは、すべて予定どおりに実行されます。Grid Controlコンソールを使用してブラックアウトを制御する場合は、オプションで、ブラックアウトされるターゲットに対してジョブが実行されないようにできます。 |
Enterprise Managerコマンドライン・ユーティリティを使用してブラックアウトを制御する手順は、次のとおりです。
ディレクトリを、AGENT_HOME/binディレクトリ（UNIX）またはAGENT_HOME\binディレクトリ（Windows）に変更します。
表9-7内の該当するコマンドを入力します。
|
注意: ブラックアウトを開始する際、ブラックアウトの影響を受けるターゲットを指定する必要があります。正しいターゲット名およびターゲット・タイプを取得する方法は、「管理対象ホスト上のターゲットのリスト表示」を参照してください。 |
表9-7 ブラックアウト・コマンドのサマリー
Enterprise Managerコマンドラインからのブラックアウトの制御について、より詳しく学ぶために、次の例を使用します。
データベースdb1およびdb2とOracle Listener ldb2に対して、bk1というブラックアウトを開始する場合は、次のコマンドを入力します。
$PROMPT> emctl start blackout bk1 db1 db2 ldb2:oracle_listener -d 5 02:30
ブラックアウトがすぐに開始され、5日間と2時間30分の間、その状態が続きます。
管理対象ホスト上のすべてのブラックアウトのステータスを確認する場合:
$PROMPT> emctl status blackout
ブラックアウトbk2をすぐに停止する場合:
$PROMPT> emctl stop blackout bk2
ホスト上のすべてのターゲットに対して即時ブラックアウトbk3を開始する場合:
$PROMPT> emctl start blackout bk3 -nodeLevel
データベースdb1に対して30分間の即時ブラックアウトbk3を開始する場合:
$PROMPT> emctl start blackout bk3 db1 -d 30
データベースdb2に対して5時間の即時ブラックアウトbk3を開始する場合:
$PROMPT> emctl start blackout bk db2 -d 5:00
管理エージェントをアップグレード後、最初に構成された時のタイムゾーンと異なることが検知されると、起動しない場合があります。
Enterprise Managerリリース10.1.0.2および10.1.0.3のRACの管理エージェント・インストールには不具合があり、管理エージェントがUTCタイムゾーンで構成されます。
次のコマンドを使用して、管理エージェントで使用されるタイムゾーンを修正できます。
emctl resetTZ agent
このコマンドは、管理エージェント側のタイムゾーンを修正し、管理リポジトリ側で値を修正するために実行される追加のコマンドを指定します。
|
重要: 管理エージェントのタイムゾーンを変更する前に、管理エージェントで管理されているターゲットで現在実行中または実行予定のブラックアウトがあるかどうかを確認してください。 |
ブラックアウトを確認する手順は、次のとおりです。
Grid Controlコンソールで、「ターゲット」タブの「すべてのターゲット」に移動し、ターゲットのリストで管理エージェントを探します。管理エージェントの名前をクリックします。これにより、管理エージェントのホームページが表示されます。
管理エージェントで監視されているターゲットのリストが、「監視ターゲット」セクションに表示されます。
リスト内の各ターゲットについて、次の操作を実行します。
ターゲット名をクリックします。これにより、ターゲットのホームページが表示されます。
ホームページの「関連リンク」セクションで、「ブラックアウト」リンクをクリックします。これにより、このターゲットに対して現在実行中または実行予定のブラックアウトを確認できます。
そのようなブラックアウトが存在する場合は、次の操作を実行します。
Grid Controlコンソールから、その管理エージェントで監視されているすべてのターゲットについて現在実行中のブラックアウトをすべて停止します。
Grid Controlコンソールから、その管理エージェントで監視されているすべてのターゲットについて実行予定のブラックアウトをすべて停止します。
現在実行中および実行予定のブラックアウトをすべて停止した後、emctl resetTZ agentコマンドを実行して、管理エージェントのタイムゾーンを変更できます。管理エージェントのタイムゾーンの変更後、必要に応じて、ターゲットに対して新しいブラックアウトを作成します。
リリース10.2の管理エージェントを実行している場合、次のコマンドを使用して、メトリック収集の即時再評価を実行できます。
emctl control agent runCollection <targetName>:<targetType> <colletionItemName>
<collectionItemName>は、メトリックを収集する収集項目の名前です。
このコマンドを実行すると、メトリックの再評価された値が管理リポジトリにアップロードされ、メトリックがしきい値を超えた場合にアラートをトリガーします。
通常、関連メトリックはともに収集されます。ともに収集された一連のメトリックはメトリック収集と呼ばれます。各メトリック収集は独自の名前を持ちます。メトリックを再評価する場合、まずそれが属しているメトリック収集の名前を判別し、次にそのメトリック収集の収集項目を判別する必要があります。
前述のコマンドを実行してメトリックを再評価すると、同じメトリック収集および収集項目に含まれているその他のメトリックもすべて再評価されます。
次の手順を実行して、メトリックに対するメトリック収集名および収集項目名を判別します。
$ORACLE_HOME/sysman/admin/metadataディレクトリに移動します。$ORACLE_HOMEは管理エージェントのOracleホームです。
ターゲット・タイプのXMLファイルを探します。たとえば、「使用可能なファイルシステム領域(%)」というホスト・メトリックを対象とする場合は、host.xmlファイルを探します。
XMLファイル内で、対象とするメトリックを探します。メトリックとして認識しているものは、実際にはメトリックの表示名です。メトリック名には、次で始まるタグが先頭に含まれます。
<Label NLSID=
たとえば、host.xmlファイルでは、「使用可能なファイルシステム領域(%)」のメトリックには、次のようなエントリが含まれます。
<Label NLSID="host_filesys_pctAvailable">Filesystem Space Available (%) </Label>
XMLファイル内でメトリックを検索すると、そのエントリがより大きなエントリの一部であることがわかります。このエントリの先頭は次のとおりです。
<Metric NAME=
Metric NAMEに定義されている値を記録します。これがメトリック収集の名前です。たとえば、「使用可能なファイルシステム領域(%)」メトリックの場合、エントリは次のようになります。
<Metric NAME="Filesystems"
したがって、「使用可能なファイルシステム領域(%)」メトリックの場合、メトリック収集の名前はFilesystemsです。
次に、このメトリック収集の収集項目を判別する必要があります。$ORACLE_HOME/sysman/admin/default_collectionディレクトリに移動します。$ORACLE_HOMEは管理エージェントのOracleホームです。
このディレクトリでは、ターゲット・タイプの収集ファイルを探します。この例では、これはhost.xmlです。
メトリック収集がそれ自体によって収集される場合は、同じ名前の単一の収集項目が収集ファイル内に存在します。メトリック収集にこれが該当するかどうかを判別するには、収集ファイル内で、次で始まるエントリを探します。
<CollectionItem NAME=
CollectionItem NAMEに割り当てられている値は、手順4のMetric NAMEと一致します。
「使用可能なファイルシステム領域(%)」メトリックの場合、収集ファイル内のエントリは次のようになります。
<CollectionItem NAME = "Filesystems"
そのようなエントリが見つかった場合、CollectionItem NAMEに割り当てられている値が、emctlコマンドで使用可能な収集項目の名前です。
見つからない場合、メトリック収集は、単一の収集項目下の他のメトリック収集とともに収集されることを意味します。メトリック収集の収集項目を見つけるには、まず、メトリック収集を探します。次のタグが先頭に含まれます。
<MetricColl NAME=
見つかったら、その上のファイル内で<CollectionItem NAME=を探します。
CollectionItem NAMEと関連する値は、emctlコマンドで使用する収集項目の名前です。
たとえば、「オープン・ポート」というホスト・メトリックを再評価する場合は、前述の手順を使用して次の操作を実行します。
$ORACLE_HOME/sysman/admin/metadataディレクトリに移動します。$ORACLE_HOMEは管理エージェントのOracleホームです。host.xmlファイルを探し、そのファイル内で<Metric NAME="openPorts"を探します。
$ORACLE_HOME/sysman/admin/default_collectionディレクトリに移動します。host.xmlファイルを探し、そのファイル内で<CollectionItem NAME="openPorts"を探します。
見つからなかった場合は、<MetricColl NAME="openPorts"を探します。
そのファイル内で、このエントリより前の部分で<CollectionItem NAME=文字列、および<CollectionItem NAME="oracle_security"を探します。
oracle_securityという収集項目名が、emctlコマンドを使用して「オープン・ポート」メトリックを再評価する際に使用されます。
この項では、Enterprise Managerエージェント用のemctlコマンドについて説明します。
表9-8 emctlコマンド
| emctlコマンド | 説明 |
|---|---|
|
emctl start | stop agent |
エージェントを起動または停止します。 |
|
emctl start | stop | status subagent |
サブエージェントを起動または停止します。 |
|
emctl status agent |
エージェントのステータスをリストします。 |
|
emctl status agent -secure [-omsurl <http://<oms-hostname>:<oms-unsecure-port>/em/*>] |
エージェントのセキュア・ステータス、エージェントがセキュア・モードで実行しているポート、および指し示されているエージェントのOMSセキュリティ・ステータスをリストします。このコマンドでは、OMSセキュア・ポートも戻されます。次に出力の例を示します。 bash-3.00$ emctl status agent -secure Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. Checking the security status of the Agent at location set in /ade/aime_cpap4_ ag/oracle/sysman/config/emd.properties... Done. Agent is secure at HTTPS Port 1838. Checking the security status of the OMS at http://staxe05.us.oracle.com:7654/em/upload/... Done. OMS is secure on HTTPS Port 4473 bash-3.00$ |
|
emctl status agent scheduler |
実行中、準備完了および定期収集のすべてのスレッドをリストします。 |
|
emctl status agent jobs |
現在エージェントで実行しているジョブのステータスをリストします。次に出力の例を示します。 bash-3.00$ emctl status agent jobs Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. ------------------------------------------------- step id typ pid stat command line ------- --- --- ---- ------------ ------------------------------------------------- Agent is Running and Ready |
|
emctl status agent target <target name>,<target type>,<metric> |
指定されたターゲットの詳細ステータスをターゲット名、ターゲット・タイプの順にリストします。次に、oracle_databaseターゲットの例を示します。emctlコマンドに特定のメトリック名を指定することで、ターゲットの特定のメトリックのステータスも取得できます。 bash-3.00$ emctl status agent target database,oracle_database Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. ------------------------------------------------- Target Name : database Target Type : oracle_database Current severity state ---------------------- Metric Column name Key State Timestamp ------------------------------------------------- DeferredTrans errortrans_count n/a CLEAR 2009-07-09 02:38:07 DeferredTrans deftrans_count n/a CLEAR 2009-07-09 02:38:07 ha_recovery missing_media_files n/a CLEAR 2009-07-09 02:28:57 ha_recovery corrupt_data_blocks n/a CLEAR 2009-07-09 02:28:57 ha_recovery datafiles_need_recovery n/a CLEAR 2009-07-09 02:28:57 Response Status n/a CLEAR 2009-07-09 02:38:04 Response userLogon n/a CLEAR 2009-07-09 02:38:04 Response State n/a CLEAR 2009-07-09 02:38:04 OCMInstrumentation NeedToInstrument n/a CLEAR 2009-07-09 02:31:55 health_check Status n/a CLEAR 2009-07-09 02:40:00 health_check Unmounted n/a CLEAR 2009-07-09 02:40:00 health_check Mounted n/a CLEAR 2009-07-09 02:40:00 health_check Unavailable n/a CLEAR 2009-07-09 02:40:00 health_check Maintenance n/a CLEAR 2009-07-09 02:40:00 sql_response time n/a CLEAR 2009-07-09 02:38:50 sga_pool_wastage java_free_pct n/a CLEAR 2009-07-09 02:28: 58 UserAudit username DBSNMP_staxe05 CLEAR 2009-07-09 02:32:48 ------------------------------------------------------- Agent is Running and Ready |
|
emctl status agent mcache <target name>,<target type>,<metric> |
メトリック・キャッシュに値が存在しているメトリックの名前をリストします。次に、単純なホスト・ターゲットの例を示します。 bash-3.00$ emctl status agent mcache staxe05.us.oracle.com,host Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. ------------------------------------------------------- Metric cache contains value for following metrics at 2009-07-09 02:54:47 CPUUsage DiskActivity FileMonitoring LPAR Performance on AIX Load Network PagingActivity ------------------------------------------------------- Agent is Running and Ready ここにリストされているメトリックは、メトリック・キャッシュに値が存在しているメトリックです。 |
|
emctl status agent cpu |
エージェント・スレッドのCPU使用率を.trcファイルにダンプします。このファイルには、現在実行中のすべてのスレッドとそれらのCPU使用率のリストが含まれています。次に、emctl status agent cpuの出力の例を示します。 bash-3.00$ emctl status agent cpu Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. ------------------------------------------------------- Agent Thread CPU Snapshot available in file: /ade/aime_ |
|
emctl status agent mutex |
各スレッドのエージェントmutex競合の詳細ステータスを示します。このコマンドは、各スレッドのmutexの取得、解放および待機時間を示します。次に出力の例を示します。
bash-3.00$ emctl status agent mutex
Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0.
Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved.
-------------------------------------------------------
Mutex status at 2009-07-09 03:03:46 (prev : 2009-07-09 03:03:13)
Addr Name : TotAcq TotRel TotWT LSAcq LSRel LSWT MxWt OwnerTid
2346a578 CollState : 14 14 18 0 0 0 1 NULL-thread
232e7628 CollState : 0 0 0 0 0 0 0 NULL-thread
23386638 CollState : 0 0 0 0 0 0 0 NULL-thread
2329fd28 CollState : 0 0 0 0 0 0 0 NULL-thread
239521c8 CollItem : 0 0 0 0 0 0 0 NULL-thread
2328cd98 CollState : 0 0 0 0 0 0 0 NULL-thread
23a54948 CollItem : 0 0 0 0 0 0 0 NULL-thread
232d8b68 CollItem : 1 1 1 0 0 0 1 NULL-thread
2358ce38 MetricCacheItem : 2 2 2 0 0 0 1 NULL-thread
|
|
emctl status agent memory |
エージェント・メモリーのデバッグに使用されます。メモリー・プロファイリング・エージェントに対して、emd.propertiesで“enableMemoryTracing=TRUE”を設定する必要があります。 |
|
emctl status agent memclean |
メモリー・ハッシュ表をクリアします。デフォルトでは、メモリー・トレースはエージェントによって有効化されていません。このため、メモリー・トレースが有効になっていない場合、emctl status agent memcleanはハッシュ表をクリアしません。メモリー・トレースを有効にするには、エージェントのemd.propertiesでenableMemoryTracing=trueを設定し、エージェントをリロードする必要があります。次に出力の例を示します。 bash-3.00$ emctl status agent memclean Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. ------------------------------------------------------- Memory hashtable cleared. ------------------------------------------------------ Agent is Running and Ready |
|
emctl reload [agent] |
emd.propertiesファイルとtargets.xmlファイルを再読取りしてエージェントをリロードします。emd.propertiesファイルでいずれかのプロパティを変更した場合、たとえばemd.propertiesでtracelevel.collector=DEBUGに変更して（デフォルトはWARN）コレクタのトレース・レベルを変更した場合などには、この変更をエージェントに反映させるためにエージェントをリロードする必要があります。リロードを正常に実行するには、エージェントが起動され、実行中である必要があります。 |
|
emctl reload agent dynamicproperties [<Target_name>:<Target_Type>]... |
ターゲットの動的プロパティを再計算して、ターゲットの動的プロパティを生成します。次に、oracle_databaseの出力の例を示します。 bash-3.00$ emctl reload agent dynamicproperties database:oracle_database Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. ------------------------------------------------------- EMD recompute dynprops completed successfully |
|
emctl upload |
アップロードが保留されているxmlファイルをOMSのアップロード・ディレクトリにアップロードします。 |
|
emctl pingOMS [agent] |
OMSにpingを送信して、エージェントがOMSに接続できるかどうかを確認します。エージェントはOMSからpingが返されるまで待機して、pingOMSが正常であることを通知します。 |
|
emctl config agent <options> |
指定されたオプションに基づいてエージェントを構成します。 |
|
emctl config agent updateTZ |
emd.propertiesファイル内のエージェントの現在のタイムゾーンを更新します。 |
|
emctl config agent getTZ |
エージェントの現在のタイムゾーンを出力します。 |
|
emctl config agent credentials [<Target_name>[:<Target_Type>]] |
特定のターゲットの資格証明を変更するオプションを指定します。これにより、そのターゲットのユーザー名およびパスワードを変更できます。このコマンドの実行時に、ユーザー名またはパスワードを変更するかどうかを確認するメッセージが表示されます。yesを選択した場合、構成するターゲットの新しいユーザー名とパスワードを入力する必要があります。これにより、エージェントがリロードされます。次に、oracle_databaseの出力の例を示します。 bash-3.00$ emctl config agent credentials database Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. Name = database, Type = oracle_database Want to change for "UserName" (y/n): Want to change for "password" (y/n): EMD reload completed successfully |
|
emctl config agent getSupportedTZ |
エージェントでサポートされているタイムゾーンを出力します。 |
|
emctl config console <fileloc> [<EM loc>] |
ファイル<fileloc>に指定した構成エントリに基づいて、コンソールを構成できます。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] addtarget [-f|-force] <fileloc> [<EM loc>] |
エージェントを構成できます。 <fileloc>には、追加するターゲットの定義を指定し、-fまたは-forceは既存のターゲットを上書きできることを指定します。-fまたは-forceが指定されていない場合、既存のターゲットは上書きされません。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] addtargets [-f|-force] <fileloc> [<EM loc>] |
エージェントを構成できます。 <fileloc>には、追加するターゲットの定義を指定し、-fまたは-forceは既存のターゲットを上書きできることを指定します。-fまたは-forceが指定されていない場合、既存のターゲットは上書きできません。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] modifytarget <fileloc> [<EM loc>] [<EM State>] [-mergeProps] |
エージェントを構成できます。 <fileloc>には、変更するターゲットの定義を指定し、-mergePropsはターゲット・プロパティのみを更新する場合に使用します。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] deletetarget <type> <name> [<EM loc>] |
ターゲットを削除できます。 <type>は、削除するターゲットのタイプ、<name>はその名前を指定します。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] listtargets [<EM loc>] |
targets.xmlに含まれているすべてのターゲットをリストします。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config agent listtargetsfully [<EM loc1>] [<EM loc2>] ... |
Enterprise Managerの指定された場所のtargets.xmlに含まれているすべてのターゲットをリストします。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] listcentralagents [<EM loc>] |
このホームが関連付けられているセントラル・エージェントをリストします。 centralagentコマンドは、エージェントのみのホームには適用されません。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] addcentralagent <centralAgentHomePath> [<EM loc>] |
このホームを新しいセントラル・エージェントに関連付けます。 centralagentコマンドは、エージェントのみのホームには適用されません。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] removecentralagent <centralAgentHomePath> [<EM loc>] |
このホームとセントラル・エージェントのアソシエーションを削除します。 centralagentコマンドは、エージェントのみのホームには適用されません。 <EM loc>はオプションで、これを使用すると別のOracleホームでこの操作を実行できます。 |
|
emctl config [agent] upgradecentralagent <centralAgentHomePathOld> [<centralAgentHomePathNew>] |
このセントラル・エージェントによって監視されているすべての製品のホームをアップグレードします。 centralagentコマンドは、エージェントのみのホームには適用されません。 |
|
emctl config [agent] setcentralagents <centralAgent1> [<centralAgent2> ...] |
このホームが関連付けられているセントラル・エージェントのリストを設定します。 centralagentコマンドは、エージェントのみのホームには適用されません。 |
|
emctl config agent addTargetsToRepository <uploadFile> <update_on_dup (true | false)> |
ターゲットをリポジトリに追加します。 uploadFileには、ターゲットの定義を指定し、update_on_dupは重複したターゲットを更新するかどうかを指定します。この機能は、セントラル・エージェント向けです。 |
|
emctl config agent addAssociationsToRepository <uploadFile> |
アソシエーションをリポジトリに追加します。 uploadFileには、アソシエーションの定義を指定します。この機能は、セントラル・エージェント向けです。 |
|
emctl config agent getLocalHost |
エージェントが実行しているローカル・ホストを出力します。 |
|
emctl control agent runCollection <target_name>:<target_type> <metric_name> |
ターゲットの特定のメトリックの収集を手動で実行できます。次に出力の例を示します。 bash-3.00$ emctl control agent runCollection staxe05.us.oracle.com:host CPUUsage Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. ------------------------------------------------------- EMD runCollection completed successfully |
|
emctl getcurdir agent |
現在の作業ディレクトリ（pwd）を出力します。 |
|
emctl resetTZ agent |
エージェントのタイムゾーンをリセットします。最初にエージェントを停止し、このコマンドを実行して現在のタイムゾーンを別のタイムゾーンに変更します。その後、エージェントを起動します。 |
|
emctl resettzhost <hostname> <override_timezone> |
エージェントが実行しているホストのタイムゾーン設定をリセットします。 |
|
emctl getversion |
エージェントのバージョンを出力します。次に出力の例を示します。
bash-3.00$ emctll getversion
bash: emctll: command not found
bash-3.00$ emctl getversion
Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0.
Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved.
--- Standalone agent
Enterprise Manager 10g Agent Version 10.2.0.5.0
|
|
emctl dumpstate agent <component> . . . |
エージェントのダンプを生成します。このコマンドを使用して、エージェントのメモリーおよびCPUに関する問題を分析できます。次に出力の例を示します。 bash-3.00$ emctl dumpstate agent Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. dump file generated: /ade/aime_cpap4_ag/oracle/sysman/dump/emagent_1654792_20090709042448.diagtrc bash-3.00$ |
|
emctl gensudoprops |
エージェントのsudoプロパティを生成します。 |
|
emctl clearsudoprops |
sudoプロパティをクリアします。 |
|
emctl clearstate |
状態ディレクトリの内容をクリアします。このコマンドを実行すると、$ORACLE_HOME/sysman/emd/stateにあるファイルが削除されます。状態ファイルは、エージェントが対応するxmlファイルに変換できるファイルです。 |
|
emctl getemhome |
エージェントのホーム・ディレクトリを出力します。次に出力の例を示します。 bash-3.00$ emctl getemhome Oracle Enterprise Manager 10g Release 5 Grid Control 10.2.0.5.0. Copyright (c) 1996, 2009 Oracle Corporation. All rights reserved. EMHOME=/ade/aime_cpap4_ag/oracle |
|
emctl start blackout <Blackoutname> [-nodeLevel] [<Target_name>[:<Target_Type>]].... [-d <Duration>] |
ターゲット上のブラックアウトを開始します。 指定されていない場合、<Target_name:Target_type>にはデフォルトでローカル・ノード・ターゲットが設定されます。<Blackoutname>の後に-nodeLevelが指定されている場合は、ブラックアウトはすべてのターゲットに適用され、後続のすべてのターゲット・リストは無視されます。期間は[days] hh:mmの書式で指定されます。 |
|
emctl stop blackout <Blackoutname> |
特定のターゲット上で開始されたブラックアウトを停止します。emctlを使用して停止できるのは、emctlツールによって開始されたブラックアウトのみです。このコマンドでは、コンソールまたはemcliを使用して開始されたブラックアウトは停止できません。 |
|
emctl status blackout [<Target_name>[:<Target_Type>]].... |
ターゲットのブラックアウトのステータスを示します。ステータスには、ブラックアウトのタイプ、つまり、ブラックアウトが1度のみ、繰返し、またはスケジュール済のいずれであるかが含まれます。このコマンドは、ブラックアウトが開始または停止されているかどうかも指定します。 |
|
emctl secure agent <registration password> [-passwd_file <abs file loc>] |
OMSに対してエージェントを保護します。登録パスワードを入力する必要があります。 |
|
emctl unsecure agent |
エージェントを非保護にします。これにより、エージェントが非保護になり、エージェントのポートがHTTPポートに変更されます。 |
|
emctl verifykey |
pingOMSの送信によって、OMSとエージェント間の通信を検証します。 |
|
emctl deploy agent [-s <install-password>] [-o <omshostname:consoleSrvPort>] [-S] <deploy-dir> <deploy-hostname>:<port> <source-hostname> |
agentにより、エージェントのみが作成およびデプロイされます。 [-s <password>]: エージェントを保護するためのインストール・パスワードです。 [-S ]: パスワードはSTDINで提供されます。 [-o <omshostname:consoleSrvPort>]: OMSホスト名とコンソール・サーブレット・ポートです。非保護のポートを選択してください。 <deploy-dir> : 共有（状態のみ）インストール・ポートを作成するディレクトリです。 <deploy-hostname:port> : 共有（状態のみ）インストールのホスト名およびポートです。未使用のポートを選択してください。 <source-hostname>: ソース・インストールのホスト名です。通常は、EMがインストールされているマシンです。これは、<deploy-hostname:port>引数に指定されたホスト名を使用してtargets.xmlで検索および置換されます。 <sid>: リモート・データベースのインスタンスです。dbconsoleをデプロイする場合にのみ指定します。 |
|
emctl deploy dbconsole [-s <install-password>] <deploy-dir> <deploy-hostname>:<port> <source-hostname> <sid> |
dbconsoleにより、エージェントとdbconsoleの両方が作成およびデプロイされます。 [-s <password>]: エージェントを保護するためのインストール・パスワードです。 <deploy-dir> : 共有（状態のみ）インストール・ポートを作成するディレクトリです。 <deploy-hostname:port> : 共有（状態のみ）インストールのホスト名およびポートです。未使用のポートを選択してください。 <source-hostname>: ソース・インストールのホスト名です。通常は、EMがインストールされているマシンです。これは、<deploy-hostname:port>引数に指定されたホスト名を使用してtargets.xmlで検索および置換されます。 <sid>: リモート・データベースのインスタンスです。dbconsoleをデプロイする場合にのみ指定します。 |
|
emctl ilint |
エージェントのilintサポートを可能にします。 |
emctl.logファイルは、実行したすべてのemctlコマンドの結果が取得されるファイルです。このログ・ファイルは管理エージェントの$ORACLE_HOME/sysman/logディレクトリ内にあり、emctlコマンドを実行するたびに更新されます。なんらかの理由でemctlコマンドが失敗した場合は、このログ・ファイルにアクセスして問題を診断してください。
たとえば、管理エージェントのOracleホーム・ディレクトリから次のコマンドを実行して、そのステータスを確認します。
<Oracle_Home>emctl status agent
コマンドを実行した後、ログ・ディレクトリに移動して、emctl.logファイルで次の情報を確認します。
1114306 :: Wed Jun 10 02:29:36 2009::AgentLifeCycle.pm: Processing status agent 1114306 :: Wed Jun 10 02:29:36 2009::AgentStatus.pm:Processing status agent 1114306 :: Wed Jun 10 02:29:37 2009::AgentStatus.pm:emdctl status returned 3
ここで、最初の列1114306は、ステータス確認のために使用されたスレッドです。2番目の列には、コマンドを実行した日付と時刻が示されます。3番目の列には、コマンドに対して実行されたPerlスクリプトが示されます。最後の列にはコマンドの結果が示され、コマンドによる進行状況とコマンドによって戻された終了コードが示されます。この例では、終了コードは3です。これは管理エージェントが起動され、実行中であることを表しています。
別の例として、管理エージェントのOracleホーム・ディレクトリから次のコマンドを実行して、データをアップロードします。
<Oracle_Home>emctl upload agent
コマンドを実行した後、ログ・ディレクトリに移動して、emctl.logファイルで次の情報を確認します。
1286220 :: Tue Jun 9 07:13:09 2009::AgentStatus.pm:Processing upload 1286220 :: Tue Jun 9 07:13:10 2009::AgentStatus.pm:emdctl status agent returned 3 1286220 :: Tue Jun 9 07:13:41 2009::AgentStatus.pm: emdctl upload returned with exit code 6
ここで示されるエントリは最初の例と似ていますが、戻された終了コードは6です。つまり、なんらかの理由により、アップロード操作が失敗したことを表しています。
表9-9に、emctlコマンドの各種の終了コードを示します。
表9-9 終了コードの説明
| 終了コード | 説明 |
|---|---|
|
0 |
操作は正常に実行されました。アクションは必要ありません。 |
|
1 |
管理エージェントへの接続に失敗しました。管理エージェントが実行されていない可能性があります。管理エージェントを再起動して、emctlコマンドを再試行してください。 |
|
2 |
管理エージェントへの接続中にタイムアウトしました。管理エージェントがハングしている可能性があります。管理エージェントを再起動して、emctlコマンドを再試行してください。 |
|
3 |
管理エージェントは起動され、実行中です。アクションは必要ありません。 |
|
4 |
管理エージェントは起動されていますが、まだ準備中です。しばらく待ってから、emctlコマンドを再試行してください。 |
|
5 |
管理エージェント関連リクエストの送信中または管理エージェント関連レスポンスの受信中に入出力エラーが発生しました。 |
|
6 |
アップロードできません。管理エージェントのステータスを確認して、emctlコマンドを再試行してください。 |
|
7 |
管理エージェントは異常な状態です。管理エージェントのステータスを確認して、emctlコマンドを再試行してください。 |
|
8 |
操作は完了しませんでした。コマンドがタイムアウトした可能性があります。再試行してください。 |
|
9 |
使用状況のエラーです。実行しているコマンドを確認し、正しいコマンドを使用して再試行してください。 |
|
10 |
管理エージェントとの通信中にSSLハンドシェイク・エラーが発生しました。管理エージェントを保護して、emctlコマンドを再試行してください。 |
|
11 |
管理エージェントとの通信中にキーの不一致が発生しました。管理エージェントを保護して、emctlコマンドを再試行してください。 |
|
255 |
一時ファイルをオープンできません。emctlコマンドを再試行してください。 |
