前のトピック: CA APM for Web Servers のインストール準備次のトピック: Apache およびそのバリエーションでの統計の発行


Windows への CA APM for Web Servers コンポーネントのインストール

CA APM for Web Servers を Windows にインストールして設定するには、以下の手順を実行します。

手順 1: Windows での Enterprise Manager のメイン インストーラの実行

手順 2: Windows への CA APM for Web Servers エージェント コンポーネントのインストール

手順 3: Windows サービスとしての CA APM for Web Servers の登録

手順 4: Windows での AgentConfig.properties ファイルの設定

手順 5: Web サーバを設定して統計を発行

手順 6: 監視対象の Web サーバの定義

手順 7: 管理モジュールとダッシュボードの有効化

手順 8: (オプション) ApacheCustomMetrics.xml ファイルのカスタマイズ

手順 9: Windows 上での CA APM for Web Servers の起動

手順 10: Windows 上での CA APM for Web Servers の停止

手順 11: Windows サービスとしての CA APM for Web Servers の登録解除

以下のセクションで、これらの手順の詳細について説明します。

手順 1: Windows での Enterprise Manager インストーラの実行

Enterprise Manager インストーラを実行して、Enterprise Manager で CA APM for Web Servers をインストールします。

注: Enterprise Manager が別のエージェントによって使用されている場合は、すべての CA APM for Web Servers の Enterprise Manager コンポーネントが <IntroscopeHome>/examples ディレクトリにすでにインストールされています。 この手順を続行する必要はありません。Enterprise Manager の設定を続行できます。

Enterprise Manager インストーラは <IntroscopeHome>¥examples¥PowerPackForWebServers ディレクトリにファイルを配置します。 ¥examples ディレクトリ内の構成に基づいて、ファイルを正しい場所に移動させます。

Enterprise Manager インストーラの詳細および Enterprise Manager インストーラ実行可能ファイルの場所については、「CA APM インストールおよびアップグレード ガイド」を参照してください。

Enterprise Manager インストーラは Enterprise Manager ホスト上に以下のファイルを配置します。

<IntroscopeHome>¥examples¥PowerPackForWebServers¥config¥modules¥
PPWebServers_ManagementModule.jar

このファイルは CA APM for Web Servers 管理モジュールで、事前に設定されたダッシュボードが含まれます。

手順 2: Windows への CA APM for Web Servers エージェント コンポーネントのインストール

Standalone エージェント インストーラを実行し、CA APM for Web Servers エージェントの情報をインストールおよび設定します。 このインストーラは、Enterprise Manager ホストおよびポート番号でエージェントを設定します。

CA APM for Web Servers は、エージェントをインストールしてWeb サーバ データを収集しませんが、Enterprise Manager にデータをレポートするためにエージェントを使用します。

スタンドアロン エージェント インストーラは、インストーラ内のエントリに基づく以下のプロパティで config¥WebServerAgent.profile ファイルを設定します。

introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT

ホスト設定は、Enterprise Manager が設定されているホストのホスト名または IP アドレスのいずれかである必要があります。

introscope.agent.enterprisemanager.transport.tcp.port.DEFAULT

値は Enterprise Manager がエージェント接続をリスンするポートである必要があります。

デフォルトの設定は5001 です。

この設定で指定されたポートは、一致する各 Enterprise Manager の introscopeEnterpriseManager.properties ファイル内の設定 introscope.enterprisemanager.port.agentlistener で定義されたポートに一致する必要があります。

エージェントが Enterprise Manager に接続し、メトリック エージングを実行し、メトリック クランプを実行する方法を制御する、WebServerAgent.profile ファイル内のプロパティを定義できます。 エージェント プロパティの設定の詳細については、「CA APM Java Agent 実装ガイド」または「CA APM .NET Agent 実装ガイド」を参照してください。

スタンドアロン エージェント インストーラの実行の詳細については、「CA APM インストールおよびアップグレード ガイド」を参照してください。

Windows 上の CA APM for Web Servers エージェント ファイル

スタンドアロン エージェント インストーラはエージェント ホストの <PPWebServersHome> ディレクトリ内に以下のファイルを配置します。

AgentConfigTool.bat

エージェントのグローバル設定とトラストストア設定を設定するバッチ ファイル。

DeregisterWSService.bat

Windows サービスとしての CA APM for Web Servers を登録解除するバッチ ファイル。

RegisterWSService.bat

Windows サービスとしての CA APM for Web Servers を登録するバッチ ファイル。

ServerVersionFinder.bat

指定された HTTP または HTTPS Web サーバ URL のサーバ ヘッダを検索するバッチ ファイル。

UpdateMonitorConfigFile.bat

古い WebServerConfig.xml を新しい形式にアップグレードするバッチ ファイル。

.¥config¥AgentConfig.properties

CA APM for Web Servers エージェントのプロパティ。 これらのプロパティを設定するには、AgentConfigTool.bat ファイルを使用します。

.¥config¥ApacheCustomMetrics.xml

標準メトリック リストにカスタマイズされたメトリック リストをマップするカスタマイズ可能なファイル。 このマッピングは、Apache Web サーバおよび Apache ベース Web サーバにのみ適用されます。

.¥config¥DiscoveryConfig.xml

Web サーバをスキャンするサブネットを指定する設定ファイル。

.¥config¥WebServerAgent.profile

Web サーバ エージェントのプロファイル。

.¥config¥WebServerConfig.xml

監視する Web サーバを指定する設定ファイル。

.¥lib¥PPWebServers_ManagementModule.jar

CA APM for Web Servers 用の特殊なメトリック表示およびアラートをサポートする管理モジュール。

.¥lib¥commons-logging-1.1.jar

CA APM for Web Servers エージェントの依存 JAR ファイル。

.¥lib¥jline-0.9.9.jar

トラストストア パスワードをマスクするために使用される JAR ファイル。

.¥lib¥PPWebServers.jar

CA APM for Web Servers JAR ファイル。

.¥lib¥WebServerAgent.jar

Introscope Web サーバ エージェント。Enterprise Manager に Web サーバ統計を通知します。

.¥lib¥commons-codec-1.3.jar

CA APM for Web Servers エージェントの依存 JAR ファイル。

.¥lib¥ext¥Supportability-Agent.jar

CA サポート によるデバッグに使用される Introscope エージェント拡張機能。

.¥jsw-3.2.3¥*

このフォルダには、Windows サービスとしての CA APM for Web Servers エージェントの登録に使用される Java Service Wrapper ファイルが含まれます。 .¥jsw-3.2.3¥conf¥wrapper.conf ファイルのみを変更します。 このフォルダ内のほかのファイルは変更しません。

インストール中に[CA APM for Web Servers IIS]チェック ボックスをオンにすると、これらのファイルが抽出されます。

.¥IIS¥DeregisterVBScriptService.bat

Windows サービスとしての VB スクリプトを登録解除するバッチ ファイル。

.¥IIS¥PublishIISStats.vbs

IIS Web サーバから統計を収集するスクリプト。

.¥IIS¥RegisterVBScriptService.bat

Windows サービスとしての VB スクリプトを登録するバッチ ファイル。

.¥IIS¥VBScript.bat

PublishIISStats.vbs を起動し、統計ページに IIS メトリックを発行するバッチ ファイル。

.¥IIS¥WinService.exe

IIS Web サーバを監視する場合に、サービス コントロール マネージャでサービスとしての VB スクリプトを登録する実行可能ファイル。 IIS がインストールされているホストにこのファイルをコピーします。

手順 3: Windows サービスとしての CA APM for Web Servers の登録

IIS Web サーバ上で CA APM for Web Servers を実行している場合は、IIS Web サーバ ホスト上で RegisterVBScriptService.bat を実行します。

注: CA APM for Web Servers は自動的に起動しません。 手動で起動します。

詳細:

手順 9: Windows 上での CA APM for Web Servers の起動

手順 4: Windows での AgentConfig.properties ファイルの設定

AgentConfig.properties ファイルで CA APM for Web Servers のグローバル設定を指定できます。

重要: Web サーバが permissive モードで機能する場合、トラストストア プロパティを設定しません。

このファイルには以下のプロパティがあります。

AgentConfig.properties ファイルを編集するには AgentConfigTool.bat ファイルを使用します。

AgentConfig.properties ファイルで指定されたデフォルト プロパティを使用している場合は、AgentConfigTool.bat ファイルを実行しません。

Web サーバが Non-permissive モードで HTTPS を使用する場合は、Web サーバとの通信を確立するために使用される有効な証明書のトラストストア パスおよびトラストストア パスワードを設定します。 トラストストア設定を設定するには、AgentConfigTool.bat ファイルを使用して AgentConfig.properties ファイルを編集します。 これらの設定では、トラストストア パスワードが AgentConfig.properties ファイルに暗号化された形式で格納されるようにします。

AgentConfig.properties ファイルを設定する方法

  1. AgentConfigTool.bat ファイルをダブルクリックして実行します。

    コマンド プロンプト ウィンドウが表示されます。

  2. 編集するプロパティを選択します。
  3. 各プロパティの値を入力するように要求されます。
  4. コマンド プロンプトを終了するには、4 を入力して Enter キーを押します。

手順 5: Web サーバを設定して統計を発行

Introscope で Web サーバのパフォーマンス統計を表示するには、統計の発行を有効にします。