emctl.logファイルを使用したトラブルシューティング

emctl.logファイルは、実行したすべてのEMCTLコマンドの結果が取得されるファイルです。管理エージェントでは、このログ・ファイルは管理エージェントの$AGENT_INSTANCE_HOME/sysman/logディレクトリにあり、OMSでは、このログ・ファイルは$OMS_INSTANCE_HOME/em/EMGC_OMS<n>/sysman/log/ディレクトリにあります。ファイルは、EMCTLコマンドを実行するたびに更新されます。なんらかの理由でEMCTLコマンドが失敗した場合は、このログ・ファイルにアクセスして問題を診断してください。

たとえば、管理エージェントのOracleホーム・ディレクトリから次のコマンドを実行して、そのステータスを確認します。

UNIXの場合:

<agent_instance_home>/bin/emctl status agent

Windowsの場合:

<agent_instance_home>\bin\emctl status agent

コマンドを実行した後、ログ・ディレクトリに移動して、emctl.logファイルで次の情報を確認します。

13809 :: 2024-12-03 07:54:26,158::Initializing the agent command locking system
13809 :: 2024-12-03 07:54:26,185::AgentLifeCycle.pm: Processing status agent
13809 :: 2024-12-03 07:54:26,185::AgentStatus.pm:Processing status agent
13809 :: 2024-12-03 07:54:28,608::AgentStatus.pm:emdctl status returned 3
13809 :: 2024-12-03 07:54:28,611::Cleaning up agent command lock
13809 :: 2024-12-03 07:54:28,611::AgentCommandLock:closed file handle of emctl lockfile

ここで、最初の列1114306は、ステータス確認のために使用されたPIDです。2番目の列には、コマンドを実行した日付と時刻が示されます。3番目の列には、コマンドに対して実行されたPerlスクリプトが示されます。最後の列にはコマンドの結果が示され、コマンドによる進行状況とコマンドによって戻された終了コードが示されます。この例では、終了コードは3です。これは管理エージェントが起動され、実行中であることを表しています。

同様に、OMSの場合、管理サービスのOracleホーム・ディレクトリから次のコマンドを実行して、ステータスを確認できます。

UNIXの場合:

<OMS_HOME>/bin/emctl status oms

Windowsの場合:

<OMS_HOME>\bin\emctl status oms

例7-1 OMSのログの内容例

2024-12-02 20:27:58,830 [main] INFO wls.OMSController - Executing emctl command : status
2024-12-02 20:28:05,023 [main] INFO commands.BaseCommand - Oracle Management Server is Up
2024-12-02 20:28:05,179 [main] INFO commands.BaseCommand - statusOMS message printed via new method for zdt apps.
2024-12-02 20:28:05,179 [main] INFO commands.BaseCommand - statusOMS finished with result: 0

別の例として、管理エージェントのOracleホーム・ディレクトリから次のコマンドを実行して、データをアップロードします。

UNIXの場合:

<Agent_Instance_Home>/bin/emctl upload agent

Windowsの場合:

<Agent_Instance_Home>\bin\emctl upload agent

コマンドを実行した後、ログ・ディレクトリに移動して、emctl.logファイルで次の情報を確認します。

14882 :: 2024-12-03 08:01:24,988::AgentLifeCycle.pm: Processing upload agent
14882 :: 2024-12-03 08:01:24,988::AgentStatus.pm:Processing upload agent
14882 :: 2024-12-03 08:01:26,801::AgentStatus.pm:emdctl status agent returned 3
14882 :: 2024-12-03 08:01:28,796::AgentStatus.pm:/u01/em/agt24/agent_24.1.0.0.0/bin/emdctl upload agent returned 0

ここで示されるエントリは最初の例と似ていますが、戻された終了コードは6です。つまり、なんらかの理由により、アップロード操作が失敗したことを表しています。

実行したemctlコマンドに応じて、終了コードが戻されます。一般に、終了コード「ゼロ」は成功を示し、ゼロ以外の終了コードは失敗を示します。失敗の原因の詳細は、エラー・メッセージを参照してください。