Oracle® Enterprise Manager Cloud Control Oracle Fusion Middlewareマネージメント・ガイド リリース12.1.0.8 B66835-11 |
|
前 |
次 |
この付録では、ADPで使用可能なファイルおよびディレクトリの一覧を示し、定義します。内容は次のとおりです。
ADPをインストールすると、アプリケーション・パッケージのコンポーネントはすべてEMGC_ADPMANAGER1ディレクトリ内に置かれます。このディレクトリはGCドメイン・ホームにあります(次の例を参照)。
/net/abcdef1234/scratch/jdoe/view_storage/jdoe_aug21/work/user_projects/domains/EMGC_DOMAIN/EMGC_ADPMANAGER1
ADPマネージャのインストール先のパスは次のようになります。
/scratch/Middleware0712/gc_inst/user_projects/domains/GCDomain/EMGC_ADPMANAGER1 where domain.home=/scratch/Middleware0712/gc_inst/user_projects/domains/GCDomain and ORACLE_HOME=/scratch/Middleware0712/oms
そのディレクトリ構造は次のとおりです。
表A-1 ADPマネージャのディレクトリ
ディレクリ | 説明 |
---|---|
bin |
ADPの起動および停止、エージェントおよびADP EJBのデプロイヤの実行、エクスポート・ユーティリティの実行のためのすべての実行可能ファイルが含まれます。 |
config |
実行ロジック、ADPのスキーマ有効化、ADP GUI機能、サービス・レベル目標値の定義、エクスポート・ロジックなどを制御する、すべてのADPランタイム構成パラメータが含まれます。 |
deploy |
エージェント・ライブラリと構成ファイルが、ADP EJBおよびADP Admin Webアプリケーションと同様に含まれます。これらのコンポーネントはADPパッケージのbinディレクトリ内にあるデプロイヤ・ユーティリティを使用して、リモート・ホスト(Webまたはアプリケーションのサーバー)でデプロイされます。 |
lib |
ADPの適切な機能性に必要なすべてのライブラリがあります。 |
mcconfig |
内部的なベースとなるインスツルメンテーション構成が含まれます。これらのファイルは変更しないでください。 |
configディレクトリには、構成が可能で、ADPを特定の方法で稼働するファイルが数多く含まれています。このディレクトリ内のファイルに変更を加えると、ADPサーバーの再起動が必要になります。
ほとんどのファイルはユーザーが直接操作することはありません。目的の効果を得るために手動で構成できる、3つの主なファイルを次に示します。
ファイル | 説明 |
---|---|
Acsera.properties | このファイルはメインのADP構成ファイルで、カスタマイズすることでADPのチューニングが促されます。 |
configuration.xml | このファイルでは、管理サーバーの場所とそれにアクセスするための資格証明を定義します。通常は、このファイルは操作しません。構成はすべてADP GUIによって行われます。 |
export.xml | このファイルには、適切なデータ・エクスポート・ロジックを動かす情報が含まれています。これは、ADPデータ・リポジトリからパフォーマンス・メトリックとイベント・データを手動および自動でエクスポートする際に使用されます。 |
UrlMap.properties | このファイルは、サーバー・アドレスのロード・バランサ・アドレスへのマッピングに使用されます。デフォルトではこのファイルは存在せず、ユーザーが作成する必要があります。 |
サービス・レベル目標値(SLO)の定義とSLOに関連するアクションは、それぞれslo.xmlおよびevent.xmlに記述されています。これらのファイルのコンテンツは、ADP GUI(「構成」タブ)から適用された定義によって完全に制御されています。
acsera.propertiesファイルには、ADPマネージャの操作を定義するグローバルな構成パラメータが含まれます。
Acsera.propertiesファイルのこのセクションは、ログのローテーション・ポリシーを定義します。Log.MaxFilesは指定した時間で使用可能なログ・ファイルの最大数を示し、Log.MaxFileSizeMBはログ・ファイルの最大サイズを示します。
例A-1 ログ・ファイルの管理セクション
Log.CopyOut = false Log.MaxFiles = 10 Log.MaxFileSizeMB = 30 Log.MergeLogs = true Debug.CopyOut = false Debug.LogLevel = all Debug.MaxFiles = 10 Debug.MaxFileSizeMB = 30
ログ・ファイルはログ・ディレクトリに格納されます。
ユーザーは、リソース制限パラメータを次のように設定することで監視対象のドメイン数を制限できます: ConfigurationManager.ResourceLimit=4
ADPはエージェントとの通信にRMIポートを使用して、特定のRMIポートから受信パフォーマンス・メトリックを収集します。RMIポートはデフォルトで、ADPをホスティングしているマシンと同じマシンに設定されています。ホストがマルチホームで構成されており(多くのネットワーク・インタフェースがある場合や、IPv6アドレスを使用している場合など)、ADPで特定のインタフェースの着信トラフィックを確実にリスニングする必要がある場合、RMI.Registry.Hostのコメントを解除し、localhost
以外の値を指定する必要があります。
デフォルトの51099のポート番号が他のアプリケーションに割り当てられている場合、RMI.Registry.Portの値の変更が必要になる場合があります。また、ADPがマルチインスタンス・モードで稼働している場合、ポート番号は個々のインスタンスで異なります。
ADPには、パフォーマンス・データの集計(または圧縮)に対する高度なマルチ階層ロジックがあります。これは、表示用のデータを問合せするときと、新規のパフォーマンス・メトリックを挿入するときの両方において、内部データ・リポジトリとの相互作用のパフォーマンスの最適化を促します。
さらに長い用語データを格納する予定のユーザーはAcsera.propertiesの次のセクションを参照してください。
######################### # Production setting # NOTE: use Model.GlobalSamplingRateSecs to configure Metric.Grain.0 ######################### Metric.Grain.0 0s Metric.TableInterval.0 = 4h Metric.DataLife.0 = 2d Metric.Grain.1 = 3m Metric.TableInterval.1 =1d Metric.DataLife.1 = 8d #Metric.Grain.2 = 30m #Metric.TableInterval.2 = 7d #Metric.DataLife.2 = 420d
そして、Metric.*.2 propertiesの最後の3行をコメント解除してください。
ADPはデフォルトで複数のクラスタ・メンバーから受信するデータをアプリケーション別に集計することで、データ・リポジトリへの挿入の割合を最小限に抑えます。これによって、非常に負荷の高い環境におけるADPのパフォーマンスが大幅に向上します。
このアプローチの副次的な作用として、ユーザーはインスツルメンテーションのメトリック(プロセスおよびポータル)をサーバー・レベルごとに参照できなくなります。これを有効にすることが必要な場合は、JavaMIP.AggregateInsertsをfalseに設定します。
アプリケーションの不必要な監視によるオーバーヘッドを避けるため、どのアプリケーションを監視するか、またはどのアプリケーションを監視から除外するかを明示的に示すことができます。
ユーザーは対象のアプリケーションの名前をComponentProvider.Application.Excludeプロパティに追加する必要があります。
ADPマネージャと監視対象アプリケーション・サーバーの間にファイアウォールが存在する場合、特に複数のリソースが構成されるようなケースでは、その間のポートが開かれていることが必要です。たとえば、2つのリソースが構成され、最初のリソースがポートとして55006を使用する場合、次のリソースはポートとして55007を使用する必要があります。リソースが追加されるたびにポートは1ずつ増分されます。
アプリケーション・サーバーのJMXアクセス・ポートに加えて、Acsera.propertiesの次の2つのプロパティがADPで特に使用されているポートを示します。
RMI.Registry.Port(デフォルトは51099)
RMI.JavaProvider.ServerPort(デフォルトは55003)
SLO違反がある期間の間ずっと続くようなときに、繰り返し送られる通知の数を意図的に減らすことを想定する局面があります。短期間に発生する同じ違反の通知を抑制するため、ADPはSLOの減衰機能を備えています。この機能を有効にすると、SLO違反が発生して短期間に数回繰り返されるような場合、ADPではSLO.RearmDelayで定義された期間にSLO違反通知が発行されません。この機能を無効にするには、このパラメータの値を0に設定します。
SLO.SuppressDelayedAssertsは、ADPの期限が切れた後も違反が続く場合にSLO通知を発行するかどうかを示します。たとえば、デフォルトはfalseで通知を発行することを示しています。
UrlMap.propertiesファイルはADPマネージャのconfigディレクトリで作成され、ロード・バランサとアプリケーション・サーバー間のアドレス・マッピングの提供に使用されます。このファイルの形式は次のようになります。
# Format: # $app_server_ip = $load_balancer_id # E.g: # http\://localhost\:7001 = http\://localhost\:7005 # # Note: ":" character need to be escaped with "\" # http\://192.168.128.53\:7002 = http\://192.168.3.187\:80 http\://192.168.128.53\:7003 = http\://192.168.3.187\:80 http\://192.168.128.54\:7005 = http\://192.168.128.54\:7011 http\://192.168.128.54\:7006 = http\://192.168.128.54\:7011