ホーム
Profiler と各種 J2EE Web/アプリケーションサーバーとの統合
ここでは、Profiler と各種の代表的な Web/アプリケーションサーバーを統合する方法を説明します。まず「サポートされている Java VM」の項目を参照して、Profiler が対応している JVM に関する重要な情報を確認してください。Web/アプリケーションサーバーを実行する JVM (Modified JDK 1.4.2 for Profiling、または標準の JDK 5/6 VM) によって、統合の手順は若干異なります。
使用する記号
ここでは、全体を通して次の記号を使用しています。
%NB_USERDIR%、$NB_USERDIR: NetBeans IDE ユーザーディレクトリへのパス (IDE のメインメニューから「ヘルプ」>「製品について」>「詳細」を選択すると確認できます)
%AS_HOME%、$AS_HOME: Web サーバーやアプリケーションサーバーがインストールされているディレクトリ
%MODJDK_HOME%、$MODJDK_HOME: Modified JDK 1.4.2 for Profiling へのパス。通常は「%NB_USERDIR%/modules/profiler-ea-vm」です。このパスは、IDE の「プロファイル」>「ヘルプ」>「Profiler について...」ダイアログで確認できます。
%PROFILER_LIBS%、$PROFILER_LIBS: Profiler Agent のネイティブライブラリがあるディレクトリ。通常は「%NB_INSTALLDIR%/profiler1/lib」です。
%AGENT_PORT%、$AGENT_PORT%: Profiler との通信に使用するポート
Linux と Solaris を使用している場合の注意: 構成の例では、環境変数の値の設定に「setenv」キーワードを使用しています。使用しているシェルによっては、代わりに「export」を使用する必要があります。
Profiler がサポートする J2EE Web/アプリケーションサーバー
このセクションでは、Profiler を以下の Web/アプリケーションサーバーと統合する方法について説明します。
これ以外の Web/アプリケーションサーバーでも、Profiler を統合することは簡単にできます。一般的な構成手順は次の項目で説明しています。
Tomcat 4.x との統合手順
実行中のサーバーに接続 (Modified JDK 1.4.2 for Profiling の場合のみ)
Windows の場合:
%AS_HOME%\bin\catalina.bat のコピーを作成します。- 作成したコピーの名前を「
catalina_nbprofiler.bat」に変更します。
catalina_nbprofiler.bat の先頭で、ヘルプテキストの直後に次の行を追加します。
set JAVA_HOME=%MODJDK_HOME%
Linux、Solaris の場合:
$AS_HOME/bin/catalina.sh のコピーを作成します。- 作成したコピーの名前を「
catalina_nbprofiler.sh」に変更します。
catalina_nbprofiler.sh の先頭で、ヘルプテキストの直後に次の行を追加します。
setenv JAVA_HOME=$MODJDK_HOME
NetBeans が付属している Tomcat を実行中に Profiler を接続するには、作業ディレクトリとして netbeans-install-dir/nb4.0/jakarta-tomcat-5.0.28/bin を使用します。
サーバーの起動時に接続 (直接接続)
Windows の場合:
%AS_HOME%\bin\catalina.bat のコピーを作成します。- 作成したコピーの名前を「
catalina_nbprofiler.bat」に変更します。
- Modified JDK 1.4.2 for Profiling の場合のみ:
catalina_nbprofiler.bat の先頭で、ヘルプテキストの直後に次の行を追加します。
set JAVA_HOME=%MODJDK_HOME%
set PATH=%PROFILER_LIBS%\deployed\jdk142\windows;%PATH%
- 「
:execCmd」ラベルの直後に、次の行を途中で改行せずに入力します。
Modified JDK 1.4.2 for Profiling の場合:
set JAVA_OPTS=-Xrunprofilerinterface:%PROFILER_LIBS%,%AGENT_PORT% %JAVA_OPTS%
JDK 5/6 の場合:
set JAVA_OPTS=-agentpath:%PROFILER_LIBS%\deployed\jdk15\windows\profilerinterface.dll= %PROFILER_LIBS%,%AGENT_PORT% %JAVA_OPTS%
Linux、Solaris の場合:
$AS_HOME/bin/catalina.sh のコピーを作成します。- 作成したコピーの名前を「
catalina_nbprofiler.sh」に変更します。
- Modified JDK 1.4.2 for Profiling の場合のみ:
catalina_nbprofiler.sh の先頭で、ヘルプテキストの直後に次の行を追加します。
setenv JAVA_HOME=$MODJDK_HOME
setenv LD_LIBRARY_PATH=$PROFILER_LIBS/deployed/jdk142/{OS}:$LD_LIBRARY_PATH
- この行のあとに、次の行を途中で改行せずに入力します。
Modified JDK 1.4.2 for Profiling の場合:
setenv JAVA_OPTS=-Xrunprofilerinterface:$PROFILER_LIBS,$AGENT_PORT $JAVA_OPTS
JDK 5/6 の場合:
setenv JAVA_OPTS=-agentpath:$PROFILER_LIBS/deployed/jdk15/{OS}/libprofilerinterface.so= $PROFILER_LIBS,$AGENT_PORT $JAVA_OPTS
ここでは、「{OS}」はオペレーティングシステムの種類を表します。linux、solaris-i386、solaris-sparc のいずれかになります。
上記の変更が完了したら、サーバーで実行中のアプリケーションに「接続」する方法で、プロファイルを行うことができます。
重要な注意:
Tomcat の起動には、変更済みの catalina_nbprofiler.bat または catalina_nbprofiler.sh を使用してください。startup.bat や startup.sh で Tomcat を起動している場合は、catalina_nbprofiler.bat または catalina_nbprofiler.sh を使用するよう設定を変更してください。
Tomcat 5.x との統合手順
Tomcat 5.x との統合手順は Tomcat 4.x の場合と同じです。
ただし、Tomcat 5.5 の場合、JDK 5.0 を実行する必要があります。Modified JDK 1.4.2 for Profiling を使用する場合は、Tomcat のダウンロードページから JDK 1.4 Compatability Package をダウンロードしてインストールする必要があります。
Sun Java System Application Server 7 との統合手順
実行中のサーバーに接続 (Modified JDK 1.4.2 for Profiling の場合のみ)
- サーバーで使用する
server.xml 構成ファイルを次のように指定します。
%AS_HOME%\domains\{YOUR_DOMAIN}\{YOUR_SERVER}\config\server.xml (Windows の場合)$AS_HOME/domains/{YOUR_DOMAIN}/{YOUR_SERVER}/config/server.xml (Linux、Solaris の場合)
{YOUR_DOMAIN} は具体的なドメインを表します。通常は「domain」です。
{YOUR_SERVER} は具体的なサーバーを表します。通常は「server」です。
- このファイルで、
<java-config> XML 要素の「java-home」属性を次のように変更します。
<java-config java-home="%MODJDK_HOME%" ...>
正しい JVM PID を指定します。Sun Java System Application Server の実行中には、各サーバードメインや仮想サーバーごとに複数の JVM を起動できます。しかし、実際にアプリケーションサーバーコードと Web/EJB アプリケーションを実行するJVM は、各ドメインにつき 1 つだけです。この JVM に対する PID がどれであるかはすぐには判別しづらいため、特定する必要があります。
アプリケーションサーバーコード JVM の PID を特定する (UNIX の場合のみ)
-
SJSAS の実行中に、サーバーインスタンスの logs ディレクトリ (SUN_AS_HOME/domains/domain1/server1/logs など) にある「pid」というファイルを開きます。このテキストファイルには、サーバーインスタンスの「監視」に使用する PID が含まれています。この PID を「prime_pid」と呼ぶことにします。
- 次の UNIX コマンドを実行します。
ptree prime_pid
出力結果は次のようになります。
5302 ./appservd-wdog -r /home/johnsmith/app-servers/sun/appserver7 -d /home/dmi
5303 appservd -r /home/johnsmith/app-servers/sun/appserver7 -d /home/johnsmith
5304 appservd -r /home/johnsmith/app-servers/sun/appserver7 -d /home/johnsmith
5306 /bin/sh /home/johnsmith/app-servers/sun/appserver7/imq/bin/imqbroker
5323 /home/johnsmith/hotspot/jdk/jre/bin/java -server -cp /home/johnsmith
必要な PID は上から 3 行目 (この例では行番号 5304) にあります。今回の例では、Profiler で指定するディレクトリは SUN_AS_HOME/domains/domain1/server1/config となります。ディレクトリを再確認するには、「kill -QUIT server_pid」コマンドを実行して、サーバーの server.log ファイルに出力されたスレッドダンプとディレクトリ名を確認します。
- サーバーのプロセス ID と起動ディレクトリを確認したあと、実行中の JVM に接続するための標準操作を行います。
セキュリティー許可の追加。実行中のアプリケーションサーバーで Java セキュリティーマネージャーが起動されている場合は、セキュリティーファイルを修正する必要があります。このファイルは通常、Java 起動ツールのコマンド行で -Djava.security.policy=<policy file> オプションにより指定されています。このポリシーファイルに、Profiler のクラスに対応するエントリを追加する必要があります。
grant codeBase "file:/home/johnsmith/.netbeans/3.6/lib/- {
permission java.security.AllPermission;
}
サーバーの起動時に接続 (直接接続)
- サーバーで使用する
server.xml 構成ファイルを次のように指定します。
%AS_HOME%\domains\{YOUR_DOMAIN}\{YOUR_SERVER}\config\server.xml (Windows の場合)$AS_HOME/domains/{YOUR_DOMAIN}/{YOUR_SERVER}/config/server.xml (Linux、Solaris の場合)
{YOUR_DOMAIN} は具体的なドメインを表します。通常は「domain」です。
{YOUR_SERVER} は具体的なサーバーを表します。通常は「server」です。
- Modified JDK 1.4.2 for Profiling の場合のみ: このファイルで、
<java-config> XML 要素の「java-home」属性を次のように変更します。
<java-config java-home="%MODJDK_HOME%" ...>
- 次のような
<profiler> 要素を、<java-config> の直後の、最初の <jvm-options> 要素より前の位置に挿入します。
Modified JDK 1.4.2 for Profiling の場合
- Windows の場合:
<profiler enabled="true" name="NetBeansProfiler"
native-library-path="%PROFILER_LIBS%/deployed/jdk142/windows">
<jvm-options>-Xrunprofilerinterface:%PROFILER_LIBS%,%AGENT_PORT%</jvm-options>
</profiler>
- Linux、Solaris の場合:
<profiler enabled="true" name="NetBeansProfiler"
native-library-path="$PROFILER_LIBS/deployed/jdk142/{OS}">
<jvm-options>-Xrunprofilerinterface:$PROFILER_LIBS,$AGENT_PORT</jvm-options>
</profiler>
JDK 5/6 の場合
- Windows の場合:
<profiler enabled="true" name="NetBeansProfiler">
<jvm-options>-agentpath:
%PROFILER_LIBS%/deployed/jdk15/windows/profilerinterface.dll=
%PROFILER_LIBS%,%AGENT_PORT%</jvm-options>
</profiler>
- Linux、Solaris の場合:
<profiler enabled="true" name="NetBeansProfiler">
<jvm-options>-agentpath:
$PROFILER_LIBS/deployed/jdk15/{OS}/libprofilerinterface.so=
$PROFILER_LIBS,$AGENT_PORT</jvm-options>
</profiler>
ここでは、「{OS}」はオペレーティングシステムの種類を表します。linux、solaris-i386、solaris-sparc のいずれかになります。
上記の変更が完了したら、サーバーで実行中のアプリケーションに「接続」する方法で、プロファイルを行うことができます。
Sun Java System Application Server 8 PE との統合手順
実行中のサーバーに接続 (Modified JDK 1.4.2 for Profiling の場合のみ)
- サーバーで使用する
asenv 構成ファイルを次のように指定します。
%AS_HOME%\config\asenv.bat (Windows の場合)
$AS_HOME/config/asenv.conf (Linux、Solaris の場合)
AS_JAVA エントリがある行を次のように修正します。
set AS_JAVA=%MODJDK_HOME% (Windows の場合)
AS_JAVA="$MODJDK_HOME" (Linux、Solaris の場合)
サーバーの起動時に接続 (直接接続)
- サーバーで使用する
asenv 構成ファイルを次のように指定します。
%AS_HOME%\config\asenv.bat (Windows の場合)
$AS_HOME/config/asenv.conf (Linux、Solaris の場合)
- Modified JDK 1.4.2 for Profiling の場合のみ:
AS_JAVA エントリがある行を次のように修正します。
set AS_JAVA=%MODJDK_HOME% (Windows の場合)
AS_JAVA="$MODJDK_HOME" (Linux、Solaris の場合)
- ドメインで使用する
domain.xml 構成ファイルを次のように指定します。
%AS_HOME%\domains\{YOUR_DOMAIN}\config\domain.xml (Windows の場合)
$AS_HOME/domains/{YOUR_DOMAIN}/config/domain.xml (Linux、Solaris の場合)
{YOUR_DOMAIN} は具体的なドメインを表します。通常は「domain1」です。
- このファイルの
<java-config> XML 要素の直後の、最初の<jvm-options> 要素より前の位置に、<profiler> 要素を次のように設定します。
Modified JDK 1.4.2 for Profiling の場合
- Windows の場合:
<profiler enabled="true" name="NetBeansProfiler"
native-library-path="%PROFILER_LIBS%/deployed/jdk142/windows">
<jvm-options>-Xrunprofilerinterface:%PROFILER_LIBS%,%AGENT_PORT%</jvm-options>
</profiler>
- Linux、Solaris の場合:
<profiler enabled="true" name="NetBeansProfiler"
native-library-path="$PROFILER_LIBS/deployed/jdk142/{OS}">
<jvm-options>-Xrunprofilerinterface:$PROFILER_LIBS,$AGENT_PORT</jvm-options>
</profiler>
JDK 5/6 の場合
- Windows の場合:
<profiler enabled="true" name="NetBeansProfiler">
<jvm-options>-agentpath:
%PROFILER_LIBS%/deployed/jdk15/windows/profilerinterface.dll=
%PROFILER_LIBS%,%AGENT_PORT%</jvm-options>
</profiler>
- Linux、Solaris の場合:
<profiler enabled="true" name="NetBeansProfiler">
<jvm-options>-agentpath:
$PROFILER_LIBS/deployed/jdk15/{OS}/libprofilerinterface.so=
$PROFILER_LIBS,$AGENT_PORT</jvm-options>
</profiler>
ここでは、「{OS}」はオペレーティングシステムの種類を表します。linux、solaris-i386、solaris-sparc のいずれかになります。
上記の変更が完了すると、サーバーで実行中のアプリケーションを「接続」方式でプロファイルできます。
重要な注意:
サーバーのインストールと実行を JDK 5.0 ですでに行っていて、Modified JDK 1.4.2 for Profiling でこのサーバーをプロファイルする場合は、サーバーをアンインストールしてから、JDK 1.4.2 を使用して再インストールする必要があります (Modified JDK 1.4.2 for Profiling が推奨される)。これは、このサーバーの内部機能として、サーバー上で最初にアプリケーションが実行されるときに、JDK 5.0 の javac コンパイラでコンパイルされたバイトコードが生成されるためです。これらのバイトコードのアンインストールは容易ではなく、さらに Modified JDK 1.4.2 for Profiling との互換性もありません。
JBoss 3.x との統合手順
実行中のサーバーに接続 (Modified JDK 1.4.2 for Profiling の場合のみ)
Windows の場合:
%AS_HOME%\bin\run.bat のコピーを作成します。- コピーの名前を「
run_nbprofiler.bat」に変更します。
run_nbprofiler.bat の先頭に、次の行を追加します。
set JAVA_HOME=%MODJDK_HOME%
Linux、Solaris の場合:
$AS_HOME/bin/run.sh のコピーを作成します。- コピーの名前を「
run_nbprofiler.sh」に変更します。
run_nbprofiler.sh の先頭に、次の行を追加します。
setenv JAVA_HOME=$MODJDK_HOME
サーバーの起動時に接続 (直接接続)
Windows の場合:
%AS_HOME%\bin\run.bat のコピーを作成します。- コピーの名前を「
run_nbprofiler.bat」に変更します。
run_nbprofiler.sh の先頭に、次の行を追加します。
Modified JDK 1.4.2 for Profiling の場合:
set JAVA_HOME=%MODJDK_HOME%
set PATH=%PROFILER_LIBS%\deployed\jdk142\windows;%PATH%
set JAVA_OPTS=-Xrunprofilerinterface:%PROFILER_LIBS%,%AGENT_PORT% %JAVA_OPTS%
JDK 5/6 の場合: 次の行を、途中で改行せずに入力します。
set JAVA_OPTS=
-agentpath:%PROFILER_LIBS%\deployed\jdk15\windows\profilerinterface.dll=
%PROFILER_LIBS%,%AGENT_PORT% %JAVA_OPTS%
Linux、Solaris の場合:
$AS_HOME/bin/run.sh のコピーを作成します。- コピーの名前を「
run_nbprofiler.sh」に変更します。
- Modified JDK 1.4.2 for Profiling の場合のみ:
run_nbprofiler.sh の先頭に、次の行を追加します。
setenv JAVA_HOME=$MODJDK_HOME
setenv LD_LIBRARY_PATH=$PROFILER_LIBS/deployed/jdk142/{OS}:$LD_LIBRARY_PATH
- 「
# setup JBOSS sepecific properties」ラベルの直前に、次の行を途中で改行せずに入力します。
Modified JDK 1.4.2 for Profiling の場合
setenv JAVA_OPTS=-Xrunprofilerinterface:$PROFILER_LIBS,$AGENT_PORT $JAVA_OPTS
JDK 5/6 の場合
setenv JAVA_OPTS=
-agentpath:$PROFILER_LIBS/deployed/jdk15/{OS}/libprofilerinterface.so=
$PROFILER_LIBS,$AGENT_PORT $JAVA_OPTS
「{OS}」はオペレーティングシステムの種類を表します。linux、solaris-i386、solaris-sparc のいずれかになります。
上記の変更が完了すると、サーバーで実行中のアプリケーションを「接続」方式でプロファイルできます。JBoss の起動には、更新済みの run_nbprofiler.bat または run_nbprofiler.sh を使用してください。
JBoss 4.x との統合手順
JBoss 4.x との統合手順は JBoss 3.x の場合と同じです。JBoss の新しいバージョンは、JDK 5.0 で実行するためにコンパイルすることができます。Modified JDK 1.4.2 for Profiling でプロファイルを行う必要のある場合には、JDK 5.0 の Java コンパイラで作成されたクラスファイルに 1.4.2 JVM との互換性がないために、問題が発生する場合があります。この問題を解決するには、JBoss を JDK 1.4.2 を使用して再コンパイルする必要があります (Modified JDK 1.4.2 for Profiling が推奨される)。
WebLogic 8.1 との統合手順
注: WebLogic 8.1 がサポートしているのは JDK 1.4 のみです。Modified JDK 1.4.2 for Profiling を使用したプロファイルのみが行えます。
実行中のサーバーに接続
Windows の場合:
- サーバーの起動スクリプトを指定します。
%WL_HOME%\{PATH_TO_YOUR_DOMAIN}\{STARTUP_SCRIPT}.cmd
「{PATH_TO_YOUR_DOMAIN}」は実際のドメインのパスを表します (「user_projects\domains\mydomain」など)。
「{STARTUP_SCRIPT}」は実際のサーバー起動スクリプトを表します。通常は「startWebLogic.cmd」です。
- スクリプトの名前を「
startWebLogic_nbprofiler.cmd」に変更します。
startWebLogic_nbprofiler.cmd で次の設定を検索し、次のように置換 (または追加) します。
set JAVA_VENDOR=Sun
set JAVA_HOME=%MODJDK_HOME%
Linux、Solaris の場合:
- サーバーの起動スクリプトを指定します。
$WL_HOME/{PATH_TO_YOUR_DOMAIN}/{STARTUP_SCRIPT}.sh
「{PATH_TO_YOUR_DOMAIN}」は実際のドメインのパスを表します (「user_projects/domains/mydomain」など)。
「{STARTUP_SCRIPT}」は実際のサーバー起動スクリプトを表します。通常は「startWebLogic.sh」です。
- スクリプトの名前を「
startWebLogic_nbprofiler.sh」に変更します。
startWebLogic_nbprofiler.sh で次の設定を検索し、次のように置換 (または追加) します。
JAVA_VENDOR=Sun
JAVA_HOME=$MODJDK_HOME
サーバーの起動時に接続 (直接接続)
Windows の場合:
- サーバーの起動スクリプトを指定します。
%WL_HOME%\{PATH_TO_YOUR_DOMAIN}\{STARTUP_SCRIPT}.cmd
「{PATH_TO_YOUR_DOMAIN}」は実際のドメインのパスを表します (「user_projects\domains\mydomain」など)。
「{STARTUP_SCRIPT}」は実際のサーバー起動スクリプトを表します。通常は「startWebLogic.cmd」です。
- スクリプトの名前を「
startWebLogic_nbprofiler.cmd」に変更します。
startWebLogic_nbprofiler.cmd で次の設定を検索し、次のように置換 (または追加) します。
set JAVA_VENDOR=Sun
set JAVA_HOME=%MODJDK_HOME%
set PATH=%PROFILER_LIBS%\deployed\jdk142\windows;%PATH%
「set JAVA_OPTIONS=...」という行のあとに、次の行を追加します。
set JAVA_OPTIONS=-Xrunprofilerinterface:%PROFILER_LIBS%,%AGENT_PORT% %JAVA_OPTIONS%
Linux、Solaris の場合:
- サーバーの起動スクリプトを指定します。
$WL_HOME/{PATH_TO_YOUR_DOMAIN}/{STARTUP_SCRIPT}.sh
「{PATH_TO_YOUR_DOMAIN}」は実際のドメインのパスを表します (「user_projects/domains/mydomain」など)。
「{STARTUP_SCRIPT}」は実際のサーバー起動スクリプトを表します。通常は「startWebLogic.sh」です。
- スクリプトの名前を「
startWebLogic_nbprofiler.sh」に変更します。
startWebLogic_nbprofiler.sh で次の設定を検索し、次のように置換 (または追加) します。
JAVA_VENDOR=Sun
JAVA_HOME=$MODJDK_HOME
setenv LD_LIBRARY_PATH=$PROFILER_LIBS/deployed/jdk142/{OS}:$LD_LIBRARY_PATH
「JAVA_OPTIONS=...」という行の後に、次の行を追加します。
JAVA_OPTIONS=-Xrunprofilerinterface:$PROFILER_LIBS,$AGENT_PORT $JAVA_OPTIONS
「{OS}」はオペレーティングシステムの種類を表します。linux、solaris-i386、solaris-sparc のいずれかになります。
上記の変更が完了すると、サーバーで実行中のアプリケーションを「接続」方式でプロファイルできます。JBoss の起動には、更新済みの startWebLogic_nbprofiler.cmd または startWebLogic_nbprofiler.sh を使用してください。
WebLogic 9.0 との統合手順
注: WebLogic 9.0 がサポートしているのは JDK 1.5 のみです。Sun の JDK 5.0_04 以降 (JDK 6.0 を含む) を使用したプロファイルのみが行えます。Modified JDK 1.4.2 for Profiling を WebLogic の実行に使用することはできないため、「サーバーの起動時に接続」のみが可能です。
サーバーの起動時に接続 (直接接続)
Windows の場合:
- サーバーの起動スクリプトを指定します。
%WL_HOME%\{PATH_TO_YOUR_DOMAIN}\{STARTUP_SCRIPT}.cmd
「{PATH_TO_YOUR_DOMAIN}」は実際のドメインのパスを表します (「user_projects\domains\base_domain」など)。
「{STARTUP_SCRIPT}」は実際のサーバー起動スクリプトを表します。通常は「startWebLogic.cmd」です。
- スクリプトの名前を「
startWebLogic_nbprofiler.cmd」に変更します。
startWebLogic_nbprofiler.cmd の「set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%」という行のあとで、次のように設定を置換 (または追加) します。
set JAVA_VENDOR=Sun
set JAVA_HOME=%SUN_JDK5/6_HOME% (未設定の場合)
set JAVA_OPTIONS=
-agentpath:%PROFILER_LIBS%\deployed\jdk15\windows\profilerinterface.dll=
%PROFILER_LIBS%,%AGENT_PORT% %JAVA_OPTIONS%
Linux、Solaris の場合:
- サーバーの起動スクリプトを指定します。
$WL_HOME/{PATH_TO_YOUR_DOMAIN}/{STARTUP_SCRIPT}.sh
「{PATH_TO_YOUR_DOMAIN}」は実際のドメインのパスを表します (「user_projects/domains/base_domain」など)。
「{STARTUP_SCRIPT}」は実際のサーバー起動スクリプトを表します。通常は「startWebLogic.sh」です。
- スクリプトの名前を「
startWebLogic_nbprofiler.sh」に変更します。
startWebLogic_nbprofiler.sh の「JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"」という行のあとで、次のように設定を置換 (または追加) します。
JAVA_VENDOR=Sun
JAVA_HOME=$MODJDK_HOME (未設定の場合)
JAVA_OPTIONS=
-agentpath:$PROFILER_LIBS/deployed/jdk15/{OS}/libprofilerinterface.so=
$PROFILER_LIBS,$AGENT_PORT $JAVA_OPTIONS
「{OS}」はオペレーティングシステムの種類を表します。linux、solaris-i386、solaris-sparc のいずれかになります。
上記の変更が完了すると、サーバーで実行中のアプリケーションを「サーバーの起動時に接続」方式でプロファイルできます。JBoss の起動には、更新済みの startWebLogic_nbprofiler.cmd または startWebLogic_nbprofiler.sh を使用してください。
一般的な Web/アプリケーションサーバーとの統合手順
実行中のサーバーに接続 (Modified JDK 1.4.2 for Profiling の場合のみ)
- この方式のプロファイルで必要な条件は、Modified JDK 1.4.2 for Profiling でサーバーが実行されていることだけです。通常は、システム/環境変数 JAVA_HOME を次のように変更します。
Windows の場合:
set JAVA_HOME=%MODJDK_HOME%
Linux、Solaris の場合:
setenv JAVA_HOME=$MODJDK_HOME
サーバーの起動時に接続 (直接接続)
Modified JDK 1.4.2 for Profiling の場合 :Web/アプリケーションサーバーと Profiler をこの接続方法で統合するためには、一般的には 3 段階の手順が必要です。
Modified JDK 1.4.2 for Profiling で実行するようサーバーを設定します。
set JAVA_HOME=%MODJDK_HOME% (Windows の場合)
setenv JAVA_HOME=$MODJDK_HOME (Linux、Solaris の場合)
Profiler Agent のネイティブライブラリを次のようにシステムパスに追加します。
set PATH=%PROFILER_LIBS%\deployed\jdk142\windows;%PATH% (Windows の場合)
setenv LD_LIBRARY_PATH=$PROFILER_LIBS/deployed/jdk142/{OS}:$LD_LIBRARY_PATH (Linux、Solaris の場合)
「{OS}」はオペレーティングシステムの種類を表します。linux、solaris-i386、solaris-sparc のいずれかになります。
Java 起動ツールにコマンド行の特殊パラメータを追加します。
set JAVA_OPTS=-Xrunprofilerinterface:%PROFILER_LIBS%,%AGENT_PORT% %JAVA_OPTS% (Windows の場合)
setenv JAVA_OPTS=-Xrunprofilerinterface:$PROFILER_LIBS,$AGENT_PORT $JAVA_OPTS (Linux、Solaris の場合)
JAVA_OPTS 変数は例として使用したもので、実際の変数名はサーバーによって異なります。
JDK 5/6 の場合: Web/アプリケーションサーバーと Profiler をこの接続方法で統合するために必要な操作は 1 つだけです。
Java 起動ツールにコマンド行の特殊パラメータを追加します。
Windows の場合: set JAVA_OPTS=
-agentpath:%PROFILER_LIBS%\deployed\jdk15\windows\profilerinterface.dll=
%PROFILER_LIBS%,%AGENT_PORT% %JAVA_OPTS%
Linux、Solaris の場合: setenv JAVA_OPTS=
-agentpath:$PROFILER_LIBS/deployed/jdk15/{OS}/libprofilerinterface.so=
$PROFILER_LIBS,$AGENT_PORT $JAVA_OPTS
JAVA_OPTS 変数は例として使用したもので、実際の変数名はサーバーによって異なります。
