プライマリ・コンテンツに移動
Oracle® Enterprise Manager Cloud Control Oracle Fusion Middlewareマネージメント・ガイド
リリース12.1.0.8
B66835-11
  目次へ移動
目次
索引へ移動
索引

前
 
次
 

A ADP構成ディレクトリおよびファイル

この付録では、ADPで使用可能なファイルおよびディレクトリの一覧を示し、定義します。内容は次のとおりです。

A.1 構成ディレクトリ

ADPをインストールすると、アプリケーション・パッケージのコンポーネントはすべてEMGC_ADPMANAGER1ディレクトリ内に置かれます。このディレクトリはGCドメイン・ホームにあります(次の例を参照)。

/net/abcdef1234/scratch/jdoe/view_storage/jdoe_aug21/work/user_projects/domains/EMGC_DOMAIN/EMGC_ADPMANAGER1

A.1.1 ディレクリ構造

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

そのディレクトリ構造は次のとおりです。


ADPManager.ear/
ADPManager.ear/APP-INF/
ADPManager.ear/APP-INF/lib/
ADPManager.ear/META-INF/
ADPManager.ear/ADPManager.war/
ADPManager.ear/ADPManager.war/bin/
ADPManager.ear/ADPManager.war/config/
ADPManager.ear/ADPManager.war/mcconfig/
ADPManager.ear/ADPManager.war/deploy/
ADPManager.ear/ADPManager.war/lib/
ADPManager.ear/ADPManager.war/lib/bea/
ADPManager.ear/ADPManager.war/lib/oracle/
ADPManager.ear/ADPManager.war/META-INF/
ADPManager.ear/ADPManager.war/WEB-INF/

表A-1 ADPマネージャのディレクトリ

ディレクリ 説明

bin

ADPの起動および停止、エージェントおよびADP EJBのデプロイヤの実行、エクスポート・ユーティリティの実行のためのすべての実行可能ファイルが含まれます。

config

実行ロジック、ADPのスキーマ有効化、ADP GUI機能、サービス・レベル目標値の定義、エクスポート・ロジックなどを制御する、すべてのADPランタイム構成パラメータが含まれます。

deploy

エージェント・ライブラリと構成ファイルが、ADP EJBおよびADP Admin Webアプリケーションと同様に含まれます。これらのコンポーネントはADPパッケージのbinディレクトリ内にあるデプロイヤ・ユーティリティを使用して、リモート・ホスト(Webまたはアプリケーションのサーバー)でデプロイされます。

lib

ADPの適切な機能性に必要なすべてのライブラリがあります。

mcconfig

内部的なベースとなるインスツルメンテーション構成が含まれます。これらのファイルは変更しないでください。


A.1.2 configディレクトリ

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(「構成」タブ)から適用された定義によって完全に制御されています。

A.1.3 deployディレクトリ

/deployディレクトリには、構成ファイル、ならびに対応するライブラリを含めたADP Javaエージェントの分散可能ファイルが含まれます。これらのファイルは、デプロイヤ・ユーティリティの実行時に管理対象サーバーをホスティングするターゲット・システムにコピーされます。このディレクトリ内の構成ファイルの変更が必要になるユーザーはほとんどいません。ただし、ファイルを変更した場合、それらは単一のサーバー/クラスタ内のすべてのターゲットに分散されることには注意してください。

A.2 Acsera.propertiesファイル

acsera.propertiesファイルには、ADPマネージャの操作を定義するグローバルな構成パラメータが含まれます。

A.2.1 ログ・ファイルの管理

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

ログ・ファイルはログ・ディレクトリに格納されます。

A.2.2 マルチドメインの監視構成

ユーザーは、リソース制限パラメータを次のように設定することで監視対象のドメイン数を制限できます: ConfigurationManager.ResourceLimit=4

例A-2 マルチドメインの監視構成

ConfigurationManager.ResourceLimit=4

A.2.3 ADPのRMIポート割当て

ADPはエージェントとの通信にRMIポートを使用して、特定のRMIポートから受信パフォーマンス・メトリックを収集します。RMIポートはデフォルトで、ADPをホスティングしているマシンと同じマシンに設定されています。ホストがマルチホームで構成されており(多くのネットワーク・インタフェースがある場合や、IPv6アドレスを使用している場合など)、ADPで特定のインタフェースの着信トラフィックを確実にリスニングする必要がある場合、RMI.Registry.Hostのコメントを解除し、localhost以外の値を指定する必要があります。

デフォルトの51099のポート番号が他のアプリケーションに割り当てられている場合、RMI.Registry.Portの値の変更が必要になる場合があります。また、ADPがマルチインスタンス・モードで稼働している場合、ポート番号は個々のインスタンスで異なります。

例A-3 ADPのRMIポート割当て

#RMI.Registry.Host = localhost
RMI.Registry.Port = 51099

A.2.4 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行をコメント解除してください。

A.2.5 実行中の受信メトリックの集計

ADPはデフォルトで複数のクラスタ・メンバーから受信するデータをアプリケーション別に集計することで、データ・リポジトリへの挿入の割合を最小限に抑えます。これによって、非常に負荷の高い環境におけるADPのパフォーマンスが大幅に向上します。

このアプローチの副次的な作用として、ユーザーはインスツルメンテーションのメトリック(プロセスおよびポータル)をサーバー・レベルごとに参照できなくなります。これを有効にすることが必要な場合は、JavaMIP.AggregateInsertsをfalseに設定します。

A.2.6 監視対象または監視対象外とするアプリケーションのリスト

アプリケーションの不必要な監視によるオーバーヘッドを避けるため、どのアプリケーションを監視するか、またはどのアプリケーションを監視から除外するかを明示的に示すことができます。

ユーザーは対象のアプリケーションの名前をComponentProvider.Application.Excludeプロパティに追加する必要があります。

例A-4 監視するアプリケーションの指定

# Control which applications to analyze
#
ComponentProvider.Application.Exclude=WLI System EJBs,WLI-AI 
Design-time,B2BDefaultWebAppApplication,WLI 
Worklist,JWSQueueTransport,Deployer,BEA_WLS_DBMS_ADK,
Acsera,ClearApp,HttpDeployer,ServiceBus_Console,em

A.2.7 ファイアウォールの緩和(内部RMIポートの場合)

ADPマネージャと監視対象アプリケーション・サーバーの間にファイアウォールが存在する場合、特に複数のリソースが構成されるようなケースでは、その間のポートが開かれていることが必要です。たとえば、2つのリソースが構成され、最初のリソースがポートとして55006を使用する場合、次のリソースはポートとして55007を使用する必要があります。リソースが追加されるたびにポートは1ずつ増分されます。

アプリケーション・サーバーのJMXアクセス・ポートに加えて、Acsera.propertiesの次の2つのプロパティがADPで特に使用されているポートを示します。

  • RMI.Registry.Port(デフォルトは51099)

  • RMI.JavaProvider.ServerPort(デフォルトは55003)

A.2.8 SLOの減衰機能

SLO違反がある期間の間ずっと続くようなときに、繰り返し送られる通知の数を意図的に減らすことを想定する局面があります。短期間に発生する同じ違反の通知を抑制するため、ADPはSLOの減衰機能を備えています。この機能を有効にすると、SLO違反が発生して短期間に数回繰り返されるような場合、ADPではSLO.RearmDelayで定義された期間にSLO違反通知が発行されません。この機能を無効にするには、このパラメータの値を0に設定します。

SLO.SuppressDelayedAssertsは、ADPの期限が切れた後も違反が続く場合にSLO通知を発行するかどうかを示します。たとえば、デフォルトはfalseで通知を発行することを示しています。

例A-5 SLOの減衰機能

# The following property is specified in units of
# minutes (m), hours (h) or days (d)
SLO.RearmDelay = 15m
SLO.SuppressDelayedAsserts = false

A.3 UrlMap.properties

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