ca apm 9(9.5)/ca introscope 9(9.5) agent設定手順 …

資料コード: B1X1-S011-03

CA APM 9(9.5)／CA Introscope 9(9.5)

Agent設定手順書（Interstage編）

（Windows/Linux/Solaris）

2014年3月第3版


まえがき

本書の目的

本書は、Interstage Application Server上で動作するアプリケーションを、CA APM／CA Introscopeで、監視するための設定方

法について説明しています。なお、本書は、Windows(x86/x64) /Linux(x86/x64)/Solaris 版を対象としています。

本書の構成

本書は、1章と2章から構成されています。

第1章製品概要

CA APM／CA Introscopeの概要について説明しています。

第2章導入

CA APM／CA Introscope AgentでInterstage Application Server上で動作するアプリケーションを監視する設定手順につい

て説明します。

本書の位置づけ

本書は、Interstage Application Server上で動作するアプリケーションをCA APM／CA Introscopeで監視を行う方を対象として

います。CA APM／CA Introscope AgentでInterstage Application Server上で動作するアプリケーションを監視する設定手順を

理解することができます。本書をお読みになるためには、Java、Interstage Application Serverについて理解していることを

前提としています。

注意事項

本書に記載されている例は断りがないかぎり、Windowsに標準的な設定でインストールしている場合について書かれています。

商標について

l CA APM、CA Introscope®は、米国およびその他の国における米国CA Technologies社の商標または登録商標です。

l Interstageは、富士通株式会社の登録商標です。

l Linuxは、Linus Torvalds氏の米国およびその他の国における商標または登録商標です。

l OracleとJavaは、Oracle Corporation およびその子会社、関連会社の米国およびその他の国における登録商標です。文中

の社名、商品名等は、各社の商標または登録商標である場合があります。

l Oracle Solarisは、Solaris、 Solaris Operating System、 Solaris OSと記載することがあります。

l Red Hatは、Red Hat, Inc.の米国およびその他の国における登録商標または商標です。

l Windowsは、米国Microsoft Corporationの米国およびその他の国における登録商標です。

その他、本資料に記載されているシステム名、製品名等には必ずしも商標表示(TM・ ®) を付記しておりません。

出版年月および版数

版数資料コード

2010年10月初版 B1X1-S011-01

2012年7月第2版 B1X1-S011-02

2014年3月第3版 B1X1-S011-03


目次第1章製品概要 ................................................................................................ 1 1.1 対応するInterstage製品 .................................................................................. 1 1.2 運用モデル .............................................................................................. 1

第2章導入 .................................................................................................... 2 2.1 Interstageでの設定 ...................................................................................... 2 2.2 IJServerワークユニットに対する監視設定 .................................................................. 2 2.3 IJServerクラスタに対する監視設定 ........................................................................ 4 2.4 IJServerクラスタ(Java EE 6)に対する監視設定 ............................................................. 8


第1章製品概要

CA APM／CA Introscopeは、Interstage上で動作するJavaアプリケーション内部のクラス・メソッドの呼び出し関係とその処理のリソ

ース使用率を見える化することで、アプリケーションの処理とICTインフラリソースの関係を把握し、問題箇所を特定できます。

1.1 対応するInterstage製品

● Interstage Application Server 9.0.0以降 (Windows[x86,x64]/Linux[x86,x64]/Solaris)

1.2 運用モデル

1. CA APM 9のInterstage環境における運用構成

2. CA Introscope 9のInterstage環境における運用構成

Agent

Javaアプリケーション

管理ｻｰﾊﾞ

監視対象

InterstageApplication Server

Agent


Agent


ﾈｯﾄﾜｰｸｽｲｯﾁ

Web ViewWily CEM console

TIMEnterprise Manager

ﾄﾗﾝｻﾞｸｼｮﾝ監視ｻｰﾊﾞ

管理クライアント

Workstation

性能DB性能DBAPM DBAPM DB

Webｺﾝｿｰﾙ

wwwwww



Agent


管理ｻｰﾊﾞ

監視対象


Agent


Agent


ﾈｯﾄﾜｰｸｽｲｯﾁ

Web ViewWily CEM console

TIMEnterprise Manager

ﾄﾗﾝｻﾞｸｼｮﾝ監視ｻｰﾊﾞ


Workstation


Webｺﾝｿｰﾙ

wwwwww



Agent


管理ｻｰﾊﾞ

監視対象


Agent


Agent


Web ViewEnterprise Manager


Workstation


Webｺﾝｿｰﾙ

wwwwww



Agent


管理ｻｰﾊﾞ

監視対象


Agent


Agent


Web ViewEnterprise Manager


Workstation


Webｺﾝｿｰﾙ

wwwwww



1

Copyright FUJITSU LIMITED 2010-2014


第2章導入

2.1 Interstageでの設定

CA APM／CA Introscope AgentをInterstage Application Server環境に導入する場合は、インストールおよびアップグレードガイド

に従ってAgentをインストールした後、以下の手順で設定を行ってください。

注意事項

・Agentをインストールするときのユーザは、監視対象とするアプリケーションサーバの実行ユーザと同じにしてください。

2.2 IJServerワークユニットに対する監視設定

※ログイン方法や、ワークユニットの起動停止方法などの詳細は、Interstage Application Serverのマニュアル「運用ガイド(基本

編)」を参照してください。

1. Interstage管理コンソールを起動しログインします。

例) https://localhost:12000/IsAdmin/

2



2. 左側のツリーで監視対象のワークユニットを選択し、環境設定タブを押下します。

3. 監視対象アプリケーションの”環境設定”タブを選択し、”ワークユニット設定”の[表示」を押下します。ワークユニットが

動作している場合は停止後に行なってください。

3



4. “JavaVMオプション”の設定に下記を追加し、”適用”ボタンを押下します。

例：<9.0の場合>

-javaagent:C:/CA/wily/Agent.jar -Dcom.wily.introscope.agentProfile=C:/CA/wily/IntroscopeAgent.profile

<9.1/9.5の場合>

-javaagent:C:/CA/wily/Agent.jar

-Dcom.wily.introscope.agentProfile=C:/CA/wily/core/config/IntroscopeAgent.profile

※上記は設定済みのJavaVMオプションに改行をせずに追加します。

※Agentは標準でInterstage配下に導入されます。Introscope Agentのインストール先にあわせて下線部分を変更してくださ

い。

5. エージェントプロファイル（手順4のパラメタで指定したIntroscopeAgent.profile）の中にある、管理サーバ

(EnterpriseManager)への下記定義が正しいかを確認してください。

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

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

※定義の詳細は、「CA APM Java エージェント実装ガイド」、「CA APM .NET エージェント実装ガイド」を参照してください。

6. ワークユニットを起動してください。

2.3 IJServerクラスタに対する監視設定

※ログイン方法やクラスタの起動停止方法などの詳細は、Interstage Application Serverのマニュアル「運用ガイド(基本編)」を参

照してください。

4



1. Interstage Java EE管理コンソールを起動しログインします。

例) https://localhost:12000/javaee_admin/

2. 左側のツリーで監視対象クラスタを選択し、右側の画面の”一般”タブにある設定の定義名（赤く丸で囲った部分)を押下しま

す。

5



3. JVM設定を押下します。

4. “JVMオプション”タブを表示し、下記の設定をそれぞれ追加し保存します。

例：<9.0の場合>


-Dcom.wily.introscope.agentProfile= C:/CA/wily/IntroscopeAgent.profile

<9.1/9.5の場合>




い。

6








6. クラスタを起動してください。クラスタが既に動作している場合は再起動してください。

7



2.4 IJServerクラスタ(Java EE 6)に対する監視設定

※CA APM 9(9.5)/CA Introscope 9(9.5)のみのサポートとなります。

※各コマンドの詳細は、Interstage Application Serverのマニュアル「Interstage Application Server/Interstage Web Server

Express Java EE運用ガイド(Java EE 6編)」を参照してください。

1. Interstage Application Serverのマシンにアプリケーションサーバを実行するユーザでログインします。

2. 以下のファイルをエディタで編集します。

3. asadminコマンドで監視対象のクラスタにJVMオプションを設定します。

例：




い。

■対象ファイル

Windowsの例）Java EE 6がC:¥Interstage¥F3FMisje6にインストールされている場合

C:¥Interstage¥F3FMisje6¥glassfish¥config¥osgi.properties

Linux/Solarisの例）Java EE 6が/opt/FJSVisje6にインストールされている場合

/opt/FJSVisje6/glassfish/config/osgi.properties

■修正箇所

org.osgi.framework.bootdelegation=${eclipselink.bootdelegation}, ¥

com.sun.btrace, com.sun.btrace.*, ¥

org.netbeans.lib.profiler, org.netbeans.lib.profiler.*

■修正内容

下線部分のIntroscopeのクラス情報を追記します。

org.osgi.framework.bootdelegation=${eclipselink.bootdelegation}, ¥

com.sun.btrace, com.sun.btrace.*, ¥

org.netbeans.lib.profiler, org.netbeans.lib.profiler.*, ¥

com.wily.introscope.agent, com.wily.introscope.agent.*

8








5. クラスタを起動してください。クラスタが既に動作している場合は再起動してください。

Linux/Solarisの例）Java EE 6が/opt/FJSVisje6、Agentが/home/isuser/wilyにインストールされていて、クラスタ名がCluster001

の場合

$ /opt/FJSVisje6/glassfish/bin/asadmin create-jvm-options --target Cluster001 -javaagent¥¥:/home/isuser/wily/Agent.jar

$ /opt/FJSVisje6/glassfish/bin/asadmin create-jvm-options --target Cluster001 ※改行なしで続けて入力

-Dcom.wily.introscope.agentProfile=/home/isuser/wily/core/config/IntroscopeAgent.profile

以下のコマンドで追加したパラメタが出力されるか確認します。

$ /opt/FJSVisje6/glassfish/bin/asadmin list-jvm-options --target Cluster001

:

-javaagent:/home/isuser/wily/Agent.jar

：

-Dcom.wily.introscope.agentProfile=/home/isuser/wily/core/config/IntroscopeAgent.profile

：

Windowsの例）Java EE 6がC:¥Interstage¥F3FMisje6、AgentがC:¥CA¥wilyにインストールされていて、クラスタ名がCluster001の

場合

C:¥Interstage¥F3FMisje6¥glassfish¥bin>asadmin.bat create-jvm-options --target Cluster001 ※改行なしで続けて入力

-javaagent¥:C¥:/CA/wily/Agent.jar

C:¥Interstage¥F3FMisje6¥glassfish¥bin>asadmin.bat create-jvm-options --target Cluster001 ※改行なしで続けて入力

-Dcom.wily.introscope.agentProfile=C¥:/CA/wily/core/config/IntroscopeAgent.profile

以下のコマンドで追加したパラメタが出力されるか確認します。

C:¥Interstage¥F3FMisje6¥glassfish¥bin>asadmin.bat list-jvm-options --target Cluster001

:


：


：

9



クラスタ名がCluster001の場合、再起動する手順例は以下となります。

Windowsの例）

C:¥Interstage¥F3FMisje6¥glassfish¥bin>asadmin.bat stop-cluster Cluster001

C:¥Interstage¥F3FMisje6¥glassfish¥bin>asadmin.bat start-cluster Cluster001

Linux/Solarisの例）

$ /opt/FJSVisje6/glassfish/bin/asadmin stop-cluster Cluster001

$ /opt/FJSVisje6/glassfish/bin/asadmin start-cluster Cluster001

注意事項

・クラスタインスタンスの停止に時間がかる場合、起動に失敗することがあります。以下のコマンドでインスタンス名（ここでは

Instance001）が表示されなくなったことを確認してから起動してください。

Windowsの例）

C:¥Interstage¥f3fmpcmi¥bin> pcmilistprocesses C:¥Interstage¥F3FMisje6¥var¥pcmi¥isje6

process PID status time

-------------------------------------------------------------------------

server 4236 monitoring 2014/01/15 16:05:32

Instance001 4804 stopping 2014/01/15 16:34:29 ←★インスタンス名は停止中

Command successfully.

Linux/Solarisの例)

$ /opt/FJSVpcmi/bin/pcmilistprocesses /opt/FJSVisje6/var/pcmi/isje6

process PID status time

-------------------------------------------------------------------------

server 17881 monitoring 2014/01/15 17:14:37 ←★インスタンス名がないため停止済

Command successfully.

10


ca apm 9(9.5)/ca introscope 9(9.5) agent設定手順 …

Documents