拡張インストール・オプションを使用したJVMDエージェントのインストール

JVMDアーキテクチャの概要

JVM診断は、Oracle Enterprise Manager Cloud Controlに統合されています。これにより、管理者は本番環境でのJavaアプリケーションのパフォーマンスの問題を診断できます。問題を再現する必要性がなくなることにより、こうした問題解決に必要な時間が短縮されるため、アプリケーションの可用性とパフォーマンスが向上されます。JVMDを使用すると、管理者は、パフォーマンスの問題をテスト環境または開発環境で再現することなく、本番環境で問題の根本原因を特定できます。

次の図に、JVMDのアーキテクチャを示します。

図15-1 JVMDアーキテクチャ

JVMDエンジンは、JVMDモニタリング・システムのコア分析エンジンです。Enterprise Manager 13c以降、JVMDエンジンは追加設定なしでEMGCドメイン上にエンタープライズ・アプリケーション・デプロイメント(earファイル)としてデプロイされます。JVMDエンジンは、OMSサーバーのEnterprise JavaBeans (EJB)テクノロジとして実行されます。JVMDエンジンは、OMSからの要求に応じてJVMDエージェントからランタイム・データを収集し、そのデータをリポジトリに保存します。複数のJVMDエンジンを構成できます。

JVMDエージェントは、ターゲットJVMのデータ・コレクタです。JVMDエージェントは管理アプリケーション・サーバーにデプロイされ、JVMスレッド、スタック、ヒープおよびCPU使用率などに関するJVMモニタリング・データを最小限のオーバーヘッドでリアルタイムに収集します。

JVMDエージェントは、ターゲットJVM (本番環境のWebLogic Serverを実行するJVM)にデプロイされます。リアルタイムのデータを収集し、JVM診断エンジンに転送します。このデータは管理リポジトリに保存され、収集された情報はEnterprise Manager Cloud Controlコンソールにモニタリング情報として表示されます。JVMDエンジンとJVMDエージェント間の通信は、セキュア(SSL)または非セキュアのどちらかになります。

クライアント(エージェントとも呼ばれる)とサーバー(マネージャ・サーバーまたはエンジンとも呼ばれる)との間のJVMD通信はHTTPSベースです。JVMDマネージャ・サーバーのホストおよびポートは、「エンジンおよびエージェント」ページで、「Enterprise Managerの設定」メニューの「ミドルウェア管理」オプションの下に表示されます。対応するJVMDマネージャ・ホストおよびポートについてプールを設定するには、SLBユーザー・ガイドを参照してください。JVMDエージェントのデプロイメントおよびダウンロードでは、SLBホストおよびポートを指定してHAをアーカイブする必要があります。

ほとんどのSLBでは、ソース・アドレス(つまり、クライアント・ホスト)ベースのアフィニティが確認されます。JVMD通信では、この目的のために使用できる、ヘッダー・フィールドFROM-AGENT-IDが挿入されます。構成手順は、SLBユーザー・ガイドを参照してください。

13.2GCでは、OMS管理対象サーバーで終了するようロード・バランサが構成されており、カスタム証明書を定義してある場合は、次のことを確認してください。

カスタム証明書ファイルが<EMAS plugin home>/archives/jvmd/certificatesディレクトリにある
カスタム証明書ファイルに.crt拡張子が付いている
カスタム証明書ファイルにWLSDemo_接頭辞がない
カスタム証明書ファイルが各OMSの上記の場所で提供される

注意:

README.txtファイルは、<EMAS plugin home>/archives/jvmd/certificatesディレクトリにあります。

JVMDエージェントのインストールを開始する前に

JVMDエージェントをインストールする前に、『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイド』の概要説明を確認してください。

JVMDエージェントをインストールするための前提条件

JVMDエージェントをインストールする前に、『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイド』で説明されている前提条件を満たしていることを確認してください。

拡張インストール・オプションを使用したJVMDエージェントのデプロイ

この項では、JVMDエージェントを手動でデプロイする方法について説明します。

注意:

いったんエージェントを削除した後で再びデプロイする場合は、デプロイする前にJVMを再起動する必要があります。

この項の内容は次のとおりです。

jamagent.warのダウンロードとデプロイによる手動でのJVMDエージェントのデプロイ

JVMDエージェントを手動でデプロイするには、次のステップを実行します。

注意:

JVMDエージェントの手動デプロイメントの方法として推奨されるのは、ステップ1jamagent.warをダウンロードします。
ステップ2「JVMDエージェントの手動でのデプロイ」の項は、jamagent.warのダウンロードが失敗した場合のみに適用されます。

jamagent.warをダウンロードします。

Cloud Controlを使用してjamagent.warをダウンロードするには、次のステップに従います。
1. Cloud Controlで、「設定」メニューから、「ミドルウェア管理」、「エンジンおよびエージェント」の順に選択します。
2. 「エンジンおよびエージェント」ページで、「JVMDエージェントのダウンロード」をクリックします。「JVM診断コンポーネントのダウンロード」ダイアログ・ボックスが表示されます。
3. 「JVMDコンポーネント」メニューから、jamagent.warをダウンロードするために「JVMDエージェント」を選択し、「OK」をクリックします。「JVM診断エージェントWeb xmlパラメータ」ダイアログ・ボックスが表示されます。
4. 「使用可能なエンジン」メニューで、リストからオプションを選択します。
  
  セキュアではない接続を使用して、JVMDエージェントがJVMDエンジンに接続するようにするには、HTTP URLを選択します。
  
  セキュアな接続を使用して、JVMDエージェントがJVMDエンジンに接続するようにするには、HTTPS URLを選択します。
  
  ロード・バランサまたはファイアウォールを介して、JVMDエージェントがJVMDエンジンに接続するようにするには、「カスタム」を選択します。JVMDエージェントを接続する必要のあるホスト名およびポートを指定します。
  
  次に例を示します。
  
  HTTP: http://sl1.us.example.com:3800
  
  HTTPS: https://sl1.us.example.com:3801 (セキュアな通信)
5. モニタリングを無効化した状態でエージェントをデプロイするには「モニタリングの有効化」を選択してチェック・ボックスの選択を解除します。「JVMターゲット」ホームページで「JVMターゲットの構成」ボタンを使用して、モニタリングを有効または無効にできます。
  
  ライブラリの場所: jvmdエージェント・ライブラリがデプロイメント中にコピーされるデフォルトの場所です。
6. 「ダウンロード」をクリックしてjamagent.warをダウンロードします。
JVMDエージェントの手動でのデプロイ

WebLogic ServerでのJVMDエージェントのデプロイ: WebLogic Server管理コンソールの使用
JVMDエージェントをWebLogic管理対象サーバーに手動でデプロイするには、次のステップを実行します。
1. WebLogic Server管理コンソールにログインします。
2. 「チェンジ・センター」で、そのボタンが有効になっている場合「ロックして編集」をクリックします。
3. 「ドメイン構造」の下で、「デプロイメント.」を選択します
4. 「デプロイメント」ページで「インストール」.をクリックします
5. 「インストール」をクリックします。
6. 古いjavadiagnosticagent.earまたはjamagent.warがある場合、削除します。
7. エージェントをアプリケーションとしてインストールするには、ウィザードの指示に従って、ドメイン内のすべてまたは一部のサーバーにターゲット指定し、他のすべてのオプションをデフォルトの設定のままにします。
8. まだ起動されていない場合はjamagentアプリケーションを起動します。
  
  サーバーの再起動は必要ありません(エージェントのアップグレードでない場合)。
9. EM CCに移動し、ServerName_jvmターゲットが作成されていることを確認してください。
WebLogic ServerへのJVMDエージェントのデプロイ

JVMDエージェントをWebLogic管理対象サーバーに手動でデプロイするには、次のステップを実行します。
1. jvmd.zipファイルにあるデプロイメント・プロファイルsample_jvmdagent_deploy.propertiesのコピーを作成します。javadiagnosticagent.earファイルの場所、WebLogicドメイン名およびサーバー情報を更新します。プロファイルをjvmdagent_deploy.propertiesとして保存します。
  
  パラメータの詳細は、jvmd.zipファイルのcustomprovフォルダにあるREADME.txtファイルを参照してください。
2. jvmd.zipファイルのcustomprovフォルダにあるperlのスクリプトを実行して、指定されたすべてのサーバーにJVMDエージェントをデプロイします。
  
  perl deploy_jvmdagent.pl
  
  注意:
  
  デプロイメント・プロファイルjvmdagent_deploy.propertiesとperlスクリプトが同じフォルダにあることを確認します。
GlassFishへのJVMDエージェントのデプロイ

JVMDエージェントをGlassFishサーバーに手動でデプロイするには、次のステップを実行します。
1. GlassFish管理コンソールにログインします。
2. 「共通タスク」セクションで、「アプリケーション」をクリックします。
3. 「デプロイ済みアプリケーション」セクションで、「デプロイ」をクリックします。
4. 「場所」には、「サーバーにアップロードされるパッケージ・ファイル」を選択し、jamagent.warのあるローカル・ホスト上の場所を指定します。
5. 「選択したターゲット」に、jamagent.warをデプロイするサーバーを追加します。
6. 「OK」をクリックします。
JBossへのJVMDエージェントのデプロイ

JVMDエージェントをJBossに手動でデプロイするには、次のステップを実行します。
1. JBoss管理コンソールにログインします。
2. 「アプリケーション」で「Webアプリケーション(WAR)」をクリックします。
3. 「新しいリソースを追加」をクリックします。
4. ローカル・ホストにあるjamagent.warへの絶対パスを入力します。
5. 「展開済をデプロイ」および「ファーム済をデプロイ」の両方に対して「いいえ」を選択します。
6. 「続行」.をクリックします
JVMDエージェントをJBossに手動でデプロイするには、次の手順も可能です。
1. 次の場所にjamagent.warを転送します。
  
  <JBOSS_HOME>/server/all/deploy
2. アプリケーション・サーバーを再起動します。
TomcatへのJVMDエージェントのデプロイ

JVMDエージェントをTomcatに手動でデプロイするには、次のステップを実行します。
1. 次の場所にjamagent.warを転送します。
  
  $CATALINA_BASE/webapps
2. アプリケーション・サーバーを再起動します。
  
  Tomcatの最新版では、$CATALINA_BASE/conf/server.xmlにおいてautoDeployフラグがtrueに設定されている場合、アプリケーション・サーバーを再起動する必要はありません。Tomcatは実行時にjamagent.warを選択します。
WebsphereへのJVMDエージェントのデプロイ

JVMDエージェントをWebsphereに手動でデプロイするには、次のステップを実行します。
1. WebSphere管理コンソールにログインします。
2. 「アプリケーション」を展開し、「新規アプリケーション」をクリックします。
3. 新規エンタープライズ・アプリケーションをクリックします。
4. 「新規アプリケーションへのパス」で「ローカル・ファイルシステム」を選択し、jamagent.warがあるローカル・ホスト上の場所を指定します。
5. jamagent.warのコンテキスト・ルートを指定します。
6. 構成を保存します。
7. アプリケーションを起動します。
OC4JへのJVMDエージェントのデプロイ

JVMDエージェントをOC4Jに手動でデプロイするには、次のステップを実行します。
1. OC4J管理コンソールにログインします。
2. 「アプリケーション」をクリックします。
3. 「デプロイ」をクリックします。
4. 「アーカイブはローカル・ホストに存在します」を選択します。「アーカイブの場所」で、jamagent.warがあるローカル・ホスト上の場所を指定します。「次へ」をクリックします。
5. 「アプリケーション名」にjamagentと入力します。「コンテキスト・ルート」には/jamagentと入力します。
6. 「デプロイ」をクリックします。
スタンドアロンJVMへのJVMDエージェントのデプロイ

JVMDエージェントは、web.xmlから入力を読み取るか、コマンドラインから入力を指定することによって、スタンドアロンJVMにデプロイできます。

すべての入力がweb.xmlから読み取られるようにして、JVMDエージェントをスタンドアロンJVMにデプロイするには、コマンドラインから次のコマンドを実行します。

java -cp <absolute_path_to_jamagent.war> jamagent.jamrun <java_class_with_a_main_method>

すべての入力をコマンドラインで指定することによって、JVMDエージェントをスタンドアロンJVMにデプロイするには、コマンドラインから次のコマンドを実行します。

java -cp <absolute_path_to_jamagent.war> jamagent.jamrun <java_class_with_a_main_method> jamconshost=<jvmd_engine_host> jamconsport=<jvmd_engine_listen_port> jamjvmid=<unique_jvmd_identifier> jamtimeout=<timeout_period_in_seconds> jamloglevel=<jvmd_agent_log_level>
注意:

jamagent.warがIBM Java Development Kit (JDK)を使用して実行する場合、ログに次の警告が表示されることがあります。
```
******can_tag_objects capability is not set.Copy library libjamcapability to another directory and restart Java with argument "-agentpath:<absolute_path_to_libjamcapability.so>" ******
```
この警告を解決するには、libjamcapability.soライブラリを含めて、IBM JVMを再起動します。

/scratch/IBM/WebSphere/AppServer/java/bin/java -agentpath:/scratch/libjamcapability.so -cp /scratch/jamagent.war jamagent.jamrun MyFirstProgram

deploy_jvmdagent.plを使用したJVMDエージェントの手動でのデプロイ

deploy_jvmdagent.plスクリプトを使用して、JVMDエージェントを手動でデプロイできます。このスクリプトはサイレント・モードでのみ実行できます。つまり、プロパティ・ファイルを使用してすべての入力の詳細を指定する必要があります。

deploy_jvmdagent.plを使用してJVMDエージェントを手動でデプロイするには、次のステップを実行します。

最新バージョンのjamagent.warがダウンロードされていることを確認します。

jamagent.warのダウンロード方法の詳細は、jamagent.warのダウンロードとデプロイによる手動でのJVMDエージェントのデプロイのステップ1を参照してください。
OMSホスト上の次の場所に移動します。

$<MIDDLEWARE_HOME>/plugins/oracle.sysman.emas.oms.plugin_13.3.0.0.0/archives/jvmd/deployment_Scripts/agent/jvmd/
README.txtファイルでdeploy_jvmdagent.plスクリプトの使用方法の情報を確認します。
すべての入力をプロパティ・ファイルに指定し、次のコマンドを使用します。

perl deploy_jvmdagent.pl [-appserver <server_type>] [-file <name_of_properties_file>]

例: perl deploy_jvmdagent.pl -appserver WLS -file wls_deploy.properties

deploy_jvmdagent.plを使用するJVMDエージェントは、WebLogic ServerおよびGlassFishのみでサポートされており、他のアプリケーション・サーバーではサポートされていません。-appserverパラメータは、JVMDエージェントをデプロイするアプリケーション・サーバーを定義します。JVMDエージェントをWebLogic管理対象サーバーにデプロイしている場合は、-appserverにWLSを指定します。JVMDエージェントをGlassFishサーバーにデプロイしている場合は、-appserverにGFを指定します。-appserverパラメータを指定しない場合は、デフォルトでWLSが割り当てられます。

-fileパラメータは、デプロイメント入力を含むプロパティ・ファイルの名前を定義します。このパラメータを指定しない場合で、-appserverにWLSを指定済の場合は、deploy_jvmdagent.plによって、スクリプトが含まれるフォルダでweblogic_deploy.propertiesというプロパティ・ファイルが検索されます。-fileパラメータを指定しない場合で、-appserverにGFを指定済の場合は、deploy_jvmdagent.plによって、スクリプトが含まれるフォルダでglassfish_deploy.propertiesというプロパティ・ファイルが検索されます。入力の詳細をプロパティ・ファイルに指定する方法は、サンプルのプロパティ・ファイルsample_weblogic_deploy.propertiesまたはsample_glassfish_deploy.propertiesをご覧ください。

高可用性を実現するJVMDエージェントのデプロイ

セットアップに複数のJVMDエンジンがあり、それらに対してロード・バランサを構成している場合、JVMDエージェントを個々のJVMDエンジンのいずれかではなくロード・バランサに接続するようにしてデプロイできます。こうすることでJVMDエージェントの可用性を高め、フェイルオーバー・メカニズムが作成されます。つまり、特定のJVMDエンジンがダウンしても、JVMDエージェントはアクティブを保持できます。SLBに対して複数のOMSの高可用性を構成する方法の詳細は、Enterprise Manager 13c Cloud Control: F5 BIG-IPローカル・トラフィック・マネージャを使用したOMSの高可用性の構成テクニカル・ホワイトペーパーを参照してください。

「エンジンおよびエージェント」ページを使用するか手動で高可用性を実現するJVMDエージェントをデプロイできます。

「エンジンおよびエージェント」ページを使用した高可用性を実現するJVMDエージェントのデプロイ

「エンジンおよびエージェント」ページを使用して高可用性を実現するJVMDエージェントをデプロイするには、次のステップを実行します。

『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイド』に記載のステップに従って、JVMDエージェントをデプロイします。

注意:

デフォルトでは、JVMDエージェントはHTTPSを使用してロード・バランサに接続します。
「JVMDエージェント構成」ページの「使用可能なJVMDエンジン」で、「その他」を選択します。ロード・バランサのホスト名とポートを指定します。

「次へ」をクリックします。
確認ページですべての情報を確認し、「デプロイ」をクリックします。

高可用性を実現するJVMDエージェントの手動でのデプロイ

高可用性を実現するJVMDエージェントを手動でデプロイするには、次のステップを実行します。

jamagent.warのダウンロードとデプロイによる手動でのJVMDエージェントのデプロイのステップ1で示したステップに従い、jamagent.war.をダウンロードします。
「JVM診断エージェントWeb xmlパラメータ」ダイアログ・ボックスが表示された場合、「使用可能なエンジン」メニューから「カスタム」を選択します。ロード・バランサのホスト名とポートを指定します。

「ダウンロード」をクリックします。
jamagent.warのダウンロードとデプロイによる手動でのJVMDエージェントのデプロイのステップ2で示されているようにJVMDエージェントをデプロイします。

JVMDエージェントのインストール後

JVMDエージェントをインストールした後、『Oracle Enterprise Manager Cloud Control基本インストレーション・ガイド』の概要説明のステップを実行します。