Enterprise Manager の起動または停止

インストールが完了したら、Enterprise Manager を起動して、エラー メッセージが表示されないかどうかを確認します。
apmdevops98jp
インストールが完了したら、Enterprise Manager を起動して、エラー メッセージが表示されないかどうかを確認します。
Windows での Enterprise Manager の手動による起動
Enterprise Manager は、以下の
いずれかの
方法で手動で起動できます。
  • [スタート]-[プログラム]-[CA APM]-[管理]-[CA APM]-[Enterprise Manager]に移動します。
  • <EM_Home>
    ディレクトリにある IntroscopeEnterpriseManager.exe を実行します。
  • Windows サービスを使用します。 Windows の[サービス]管理 GUI にある標準コントロールを使用します。
Enterprise Manager は、
<EM_Home>
/Introscope_Enterprise_Manager.lax のプロパティ設定に従って起動されます。
Windows サービスとしての Enterprise Manager の設定
Enterprise Manager を Windows サービスとして使用すると、その可用性が大きくなります。 Enterprise Manager を Windows サービスとして構成すると、それが動作するコンピュータが自動的に起動します。 コンピュータのシャットダウン時に、Enterprise Manager もシャットダウンします。
注:
Introscope は、Tanuki Software が提供するパブリック ドメインの Java Service Wrapper を使用して、Enterprise Manager を Windows サービスとして実行できるようにします。 Tanuki Wrapper の詳細については、「Configuration Property Overview」を参照してください。
以下の手順に従います。
注:
以下の説明は、読者がアプリケーションを Windows サービスで設定する作業に慣れており、かつ Windows の[サービス]コンソールの使用方法を理解していることを前提としています。
  1. Enterprise Manager がインストールされていることと、コンソール モードで正常に実行されることを確認します。
  2. Enterprise Manager を停止します。
  3. <
    EM_Home
    >/ ディレクトリに移動し、テキスト エディタで Introscope_Enterprise_Manager.lax ファイルを開きます。
  4. lax.stdin.redirect プロパティを空白に設定し、ファイルを保存します。
  5. <
    EM_Home
    >/config ディレクトリに移動し、テキスト エディタで IntroscopeEnterpriseManager.properties ファイルを開きます。
  6. introscope.enterprisemanager.disableInteractiveMode プロパティを true に設定し、ファイルを保存します。
  7. Enterprise Manager サービスに一意の名前を割り当てます。 デフォルトでは、サービス名は EMService.conf 内で割り当てられます。これは、
    <EM_Home>
    /bin ディレクトリにあります。 コンピュータ上で他のサービスを設定しない場合は、デフォルトのサービス名をそのまま使用できます。 それ以外の場合は、EMService.conf で、以下のプロパティを使用して、サービスの一意の名前および表示名を指定します。
    • wrapper.ntservice.name=<
      一意の EnterpriseManager 名
      >
    • wrapper.ntservice.displayname=<
      Enterprise Manager 表示名
      >
  8. ファイルを保存します。
  9. サービスとして Enterprise Manager インスタンスを登録するには、
    <EM_Home>
    /bin/EMCtrl32.bat register スクリプトを実行します。
    注:
    手順 9 は、Windows コンピュータ上で Introscope のデフォルト JVM システム パラメータに基づいて実行されている 1 つの Enterprise Manager に適用されます。
    Windows のサービス コンソールは、Enterprise Manager が Windows サービスとして設定されていることを示しています。
  10. 各 Enterprise Manager をサービスとして実行する以下の手順を繰り返します。
Enterprise Manager の Windows サービスの登録解除
Enterprise Manager サービスの登録を解除します。
  • EMService.conf プロパティ ファイルに変更を加えるとき
  • Enterprise Manager インスタンスをコンソール制御に戻すため
  • Enterprise Manager インスタンスをアンインストールする前
以下の手順に従います。
  1. Enterprise Manager サービスを停止し、Windows [サービス]管理 GUI をシャットダウンします。
  2. <EM_Home>
    /bin/EMCtrl32.bat unregister を実行します。
注:
サービスに削除対象の
マーク
が付けられるのは、Enterprise Manager サービスまたは Windows [サービス]管理 GUI のいずれかがアクティブな場合のみです。 これは Windows サービスの標準の動作です。この動作は、サービスが削除されないように Windows レジストリがロックされているために生じます。 コンピュータを再起動すると、サービスは削除されます。
UNIX での Enterprise Manager の手動による起動
UNIX 環境で Enterprise Manager を実行する場合は、Enterprise Manager を手動で起動できます。
以下の手順に従います。
  1. コマンド プロンプトを開きます。
  2. 以下のコマンドを入力します。
    '
    ./Introscope_Enterprise_Manager'
    Enterprise Manager は、
    <EM_Home>
    でのプロパティ設定に従って起動されます。
    Enterprise Manager の出力は、UNIX のシェルに表示されます。 Enterprise Manager を nohup モードで開始します。これによりシェルでユーザ入力が許可されます。
UNIX での nohup モードでの Enterprise Manager の実行
Enterprise Manager を nohup モードで起動できます。 UNIX の nohup コマンドは、HUP (ハングアップ)シグナルを無視してアクションを実行します。 コマンドを送出したユーザがログ アウトした後も、そのコマンドの実行が継続されます。 通常はターミナルに表示される出力が、nohup.out という名前のファイルに保存されるようになります。 UNIX シェルは、nohup モードで Enterprise Manager を起動した場合のみ、ユーザ入力を受け付けます。
以下の手順に従います。
  1. <
    EM_Home
    >/ ディレクトリに移動し、テキスト エディタで Introscope_Enterprise_Manager.lax ファイルを開きます。
  2. lax.stdin.redirect プロパティを空白に設定し、ファイルを保存します。
  3. <EM_Home>
    /config ディレクトリに移動し、テキスト エディタで IntroscopeEnterpriseManager.properties ファイルを開きます。
  4. introscope.enterprisemanager.disableInteractiveMode プロパティを true に設定し、ファイルを保存します。
  5. このコマンドでの Enterprise Manager を起動します。
    nohup Introscope_Enterprise_Manager&
注:
構成した後でのみ、Enterprise Manager を nohup モードで実行します。 それ以外の場合、Enterprise Manager が起動しないか、起動できてもシステム リソースの消費量が極端に大きくなる可能性があります。
UNIX でのコントロール スクリプトを使用した Enterprise Manager の管理
UNIX でコントロール スクリプトを実行して、Enterprise Manager を管理できます。 これらのスクリプトでは、サーバのアプリケーションのステータスを起動、停止、表示することができます。 EMCtrl.sh startup スクリプトを使用すると、./Introscope_Enterprise_Manager コマンドを実行しなくても、Enterprise Manager を起動および停止することができます。
以下の手順に従います。
  1. コマンド プロンプトを開きます。
  2. bin ディレクトリで以下のコマンドを実行します。
    • ./EMCtrl.sh start
      Enterprise Manager を起動します。
    • ./EMCtrl.sh stop
      Enterprise Manager を停止します。
    • ./EMCtrl.sh status
      Enterprise Manager のステータスが表示されます。
    • ./EMCtrl.sh help
      スクリプトでサポートされているオプションを表示します
別の JVM を使用するための Enterprise Manager の設定
デフォルトでは、Introscope コンポーネントはバンドルされている JVM を使用します。 別の JVM を使用するように Enterprise Manager を設定できます。 以下のオプションのいずれかを選択します。
  • Enterprise Manager を Introscope Enterprise Manager.exe で起動するには、lax.nl.current.vm プロパティを、目的の JVM 実行可能ファイルをポイントするように編集します。 このプロパティは Introscope_Enterprise_Manager.lax にあります。 
    • 実行可能ファイルの絶対パスまたは相対パスを使用できます。
    • Windows では円記号はエスケープします。また、JVM 実行可能ファイルは、「java」ではなく「java.exe」のように拡張子を含めて指定してください。
  • Enterprise Manager を Windows サービスとして実行する場合は、wrapper.java.command プロパティを、希望する JVM 実行可能ファイルをポイントするように編集します。 このプロパティは EMService.conf にあります。 
    • 絶対パスを使用することができます。円記号はエスケープする必要があります。
    • 相対パスを使用することもできます。 UNIX のスラッシュを使用して、ドットとスラッシュ(./)で開始することをお勧めします。
    • 実行可能ファイルは java です。java.exe ではありません。
  • AS/400 上で、Enterprise Manager を runem.sh スクリプトで起動する場合には、JAVA_HOME 変数を、希望する JVM のルート ディレクトリをポイントするように編集します。 この変数は runem.sh にあります。 
    • 実行可能ファイルへのパスは相対パスではなく絶対パスを使用してください。
各 Enterprise Manager の config ディレクトリの作成
Introscope の単一のインスタンスを使用して、複数の Enterprise Manager を実行することができます。 各 Enterprise Manager に対して個別の構成ディレクトリを作成します。 この設定により、次を実行できます。
  • Introscope の 1 つのインスタンス内にすべてのディレクトリを保持できます。
  • Enterprise Manager 別に config、logs、data、および traces ディレクトリを管理することができます。
以下の手順に従います。
  1. Enterprise Manager ごとに、config、logs、data、traces の各ディレクトリのコピーを作成します。
  2. config ディレクトリの各コピーで IntroscopeEnterpriseManager.properties ファイルを開き、以下のプロパティを変更します。
    introscope.enterprisemanager.directory.config=config
    デフォルトのディレクトリは、config です。 Introscope が最初にインストールされた場合、このディレクトリが作成されます。
  3. 以下のいずれかを使用して、このディレクトリの場所を変更します。
    • 絶対パス。 例: introscope.enterprisemanager.directory.config=C:\\Introscope\\em1\\config
    • Introscope インストール ディレクトリを基準にした相対パス。 例: config2。
    注:
    Windows 環境でパスを有効にするには、円記号を二重にしてエスケープする必要があります。
  4. ファイルを保存して閉じます。
  5. Introscope_Enterprise_Manager.lax ファイルを開き、以下のプロパティを変更します。
    lax.nl.java.option.additional
    このプロパティによって、Java のコマンド ラインが変更され、複数のプロパティを持てるようになります。 選択した config ファイルの場所を使用します。
    注:
    このプロパティでは、Enterprise Manager プロパティ ファイルのあるディレクトリ、または IntroscopeEnterpriseManager.properties ファイルを直接指定することができます。 これらの例を参照してください。
    -Dcom.wily.introscope.em.properties=C:\Introscope\em1\config
    -Dcom.wily.introscope.em.properties=C:\Introscope\em1\config\IntroscopeEnterpriseManager.properties
  6. ファイルを保存して閉じます。
  7. Enterprise Manager を再起動します。
Enterprise Manager のシェルおよびターミナル ウィンドウのコマンドの使用
Enterprise Manager の実行中は、シェルおよびターミナル ウィンドウのコマンドを使用できます。
以下の手順に従います。
  1. Enterprise Manager プロパティ ファイルで、introscope.enterprisemanager.disableInteractiveMode を false に設定します。
  2. lax.stdin.redirect をコンソールに設定します。
  3. Enterprise Manager のターミナル ウィンドウまたはシェルで、以下のコマンドのいずれかを入力します。
コマンド
結果
iscopehelp
ヘルプ画面を表示します。
iscopeshutdown
Enterprise Manager をシャットダウンします
Enterprise Manager ログ ファイル
Introscope_Enterprise_Manager.log ファイルは、
<EM_Home>
/logs ディレクトリ内にあります。 このファイルには、たとえば以下のような、Introscope、CA CEM、および APM データベースの実行状況とエラー状態が記録されます。
  • 起動およびシャットダウンに関するメッセージ
  • 特定のタイプの超過したオーバーヘッド
  • サードパーティ ライブラリ
  • Enterprise Manager との CA CEM の通信
  • 特定の Introscope および CA CEM のプロパティに関するデータ
Enterprise Manager ログのプロパティを設定することができます。
日付またはサイズによる Enterprise Manager ログのロール
日付またはサイズに基づいて Enterprise Manager ログをロールできます。 ログをロールすると、指定日数の情報を保持し、残りをパージすることができます。
以下の手順に従います。
  1. <EM_Home>
    \config ディレクトリにある IntroscopeEnterpriseManager.properties ファイルを開きます。
  2. 「Logging Configuration」セクションを見つけます。
  3. 必要なログ ロールが実行されるよう、以下のプロパティを設定します。
    • 日単位または日付を指定してログ ファイルをロールするには、以下のプロパティを変更します。
      log4j.appender.logfile=com.wily.org.apache.log4j.DailyRollingFileAppender
      log4j.appender.logfile.DatePattern
      2 つのプロパティが連携し、日付に基づいて Enterprise Manager ログ ファイルがロールされます。 log4j.appender.logfile.DatePattern プロパティによって、log4j.appender.logfile=com.wily.org.apache.log4j.DailyRollingFileAppender プロパティが実行されるログ ロール期間が定義されます。
      たとえば、以下の構成では、ログ ファイルは毎日ロールされます。
      log4j.appender.logfile=com.wily.org.apache.log4j.DailyRollingFileAppender
      log4j.appender.logfile.DatePattern='.'yyyy-MM-dd
    • 時間間隔でログ ファイルをロールするには、プロパティ log4j.appender.logfile.DatePattern を変更します。 この Enterprise Manager プロパティは、Enterprise Manager がログ ファイルをロールする時刻を設定します。
      以下に 2 つの例を示します。
      以下の構成では、ログ ファイルが毎時間ロールされます。
      log4j.appender.logfile.DatePattern='.'yyyy-MM-dd-hh
      以下の構成では、ログ ファイルが毎日午前 0 時にロールされます。
      log4j.appender.logfile=com.wily.org.apache.log4j.DailyRollingFileAppender
      log4j.appender.logfile.DatePattern='.'yyyy-MM-dd
    • ログのサイズや数によってログ ファイルをロールするには、以下のプロパティを変更します。
      log4j.appender.logfile.MaxBackupIndex
      このプロパティによって、Enterprise Manager で保持されるバックアップ ログ ファイルの数が決定します。
      log4j.appender.logfile.MaxFileSize
      このプロパティによって、ログ ファイルの最大サイズが決定します。
      たとえば、以下の構成では、最大 3 つのバックアップ/ロールされた Enterprise Manager ログが保持され、各ログが最大 2 KB になります。
      log4j.appender.logfile.MaxBackupIndex=3
      log4j.appender.logfile.MaxFileSize=2KB
  4. IntroscopeEnterpriseManager.properties ファイルを保存して閉じます。
Enterprise Manager の停止
Enterprise Manager を停止する場合、以下が実行されます。
  • エージェントはデータのレポーティングを停止します。
  • SmartStor はデータを保存しなくなります。
  • ユーザは Workstation からログアウトします。
  • EnterpriseManager に接続していたユーザ全員の接続が切断されます。
注:
ディスク領域の不足によるディスク書き込みエラーを検出すると、Enterprise Manager は自動的にシャットダウンします。 フェールオーバが設定されていれば、エージェントによるほかの Enterprise Manager へのフェールオーバが可能です。 詳細については、「CA APM Java エージェント実装ガイド」または「CA APM .NET エージェント実装ガイド」を参照してください。
以下の手順に従います。
  1. Enterprise Manager のシャットダウン権限があることを確認します。
  2. 以下のいずれかの方法を使用します。
    • ターミナル ウィンドウで、以下を実行します。
      1. Enterprise Manager プロパティ ファイルで、introscope.enterprisemanager.disableInteractiveMode を false に設定します。
      2. ターミナル ウィンドウで、次のように入力します:
        iscopeshutdown
    • 管理モジュール エディタ ウィンドウの Workstation から、[Manager]-[Shut Down Enterprise Manager]の順に選択します。
予期しないシャットダウン後の再起動
重要:
この情報は CA APM のみに適用されます。 この情報は、スタンドアロン CA Introscope (Tim なし)には適用されません。
ほとんどの状況では、Enterprise Manager を再起動するのは、起動するのと同じです。 ただし、計画されたシャットダウンではなく、エラー状態で Enterprise Manager が停止した場合は、再起動前にいくつかのファイルの削除が必要になることがあります。
シャットダウンは、過負荷やファイル処理エラーが原因で発生します。 Enterprise Manager がシャットダウン(クラッシュ)した場合、未処理のファイルが、
<EM_Home>
/cem/tess/badfiles ディレクトリに残っていることがあります。 これらのファイルが残っている状態で Enterprise Manager を再起動すると、再起動時にファイルが処理されます。 これらのファイルが原因でシャットダウンした場合、Enterprise Manager は再起動時にこれらのファイルを処理するため、再起動後すぐにもう一度クラッシュが発生する可能性があります。 これを解決するには、Enterprise Manager を再起動する前に、ディレクトリからファイルを削除します。
以下の手順に従います。
重要:
これらのファイルを削除すると、一部のデータが失われる場合があります。 失われる可能性があるのは、最新の障害詳細、カスタマ エクスペリエンス メトリック、および統計です。
  1. TIM コレクション サービスが実行されている Enterprise Manager 上で、<
    EM_Home
    >/cem/tess/badfiles ディレクトリ内のファイルを削除します。
    削除対象のファイルは XML ファイルで、btstats-2010-01-05-23_26_13-172.16.252.20.xml や defect-12627339680000057712-172.16.252.20.xml などの名前が付いています。
  2. Enterprise Manager を起動します。