Download PDF
Download page データベースエージェントのインストール.
データベースエージェントのインストール
このページでは、データベースエージェントを手動でインストールする方法について説明します。または、[Download & Install Wizard] の手順に従うこともできます。これは、コントローラ UI のホームページからアクセスできます。ウィザードにより、インストールプロセスが容易になります。
権限の問題を回避するには、エージェントを実行するのと同じユーザ、またはホストマシンの管理者としてデータベースエージェントをインストールする必要があります。データベースエージェントを実行するには、ログ出力ディレクトリと、エージェント インストール ディレクトリにある conf
ディレクトリに対する書き込み権限が必要です。
エージェントソフトウェアのインストール
- AppDynamics ダウンロードセンター(http://download.appdynamics.com)から、ご使用の OS 環境に適したインストールパッケージのバージョンをダウンロードします。
- zip ファイルを宛先ディレクトリに展開します。エージェントのインストール先ディレクトリにはスペースを使用しないでください。
- データベースエージェントをインストールするマシンに管理者としてログオンします。
Windows
db-agent-x.x.x.zip
ファイルをダブルクリックし、ファイルを <db_agent_home>
に展開します。必要に応じて、次のように zip ファイルのブロックを解除してから展開することができます。zip ファイルを右クリックし、[Properties] を選択して [unblock] を選択します。
データベースエージェントには 2 つのバージョンがあります。1 つは 32 ビットで、もう 1 つは 64 ビット(4.5.2 以降)です。OS の要件に基づいてバージョンを選択します。
Linux
コマンドラインで次のコマンドを入力します。
unzip db-agent-x.x.x.zip -d <db_agent_home>
複数のデータベースエージェントの実行
同じマシン上の <db_agent_home>
ディレクトリで、複数のデータベースエージェントがエージェント jar を同時に実行できます。エージェントの使用方法によっては、システムプロパティが必要になる場合があります。
データベースエージェントのライセンス(オンプレミスのみ)
営業またはサポート担当者からデータベース モニタリング ライセンシングを使用して license.lic
ファイルを取得し、コントローラをインストールしたディレクトリにライセンスファイルを格納します。ライセンスをディレクトリに配置すると、コントローラは新しいライセンスを検出するまでに 1 ~ 2 分かかることがあります。コントローラを再起動すると、新しいライセンスの検出を強制できます。
エージェントの構成
コントローラのホスト名、ポート番号、およびアカウントアクセスキーのプロパティを構成するには、<db_agent_home>/conf/controller-info.xml
ファイルを使用するか、またはデータベースエージェントのスタートアップスクリプトにシステムプロパティを追加します。
コントローラホスト名
Configure using controller-info.xml: <controller_host>
Configure using System Properties: -Dappdynamics.controller.hostName
Required:はい
Default:なし
コントローラポート
Configure using controller-info.xml:<controller_port>
Configure using System Properties:-Dappdynamics.controller.port
Required:はい
Default:オンプレミスコントローラのインストールの場合、HTTP にポート 8090、HTTPS 通信に 8181 を使用。
SaaS コントローラサービスの場合:ポート 80(HTTP の場合)、443(HTTPS 通信の場合)。
アカウントアクセスキー
Configure using controller-info.xml:<account_access_key>
Configure using System Properties:-Dappdynamics.agent.accountAccessKey
Required:はい
Default:なし
オプション設定:
SSL を使用するようにエージェントを設定します。「コントローラとの通信のための SSL の有効化」を参照してください。
プロキシ設定を使用するようにエージェントを構成します。コントローラのプロキシ設定を参照してください。
- 複数のエージェントが必要な場合などに、コントローラに対して自身を一意に識別するようにエージェントを構成します。「複数のエージェント環境のプロパティ」を参照してください。
- 別のデータベースエージェントのバックアップとして動作するようにエージェントを構成します。「複数のエージェント環境のプロパティ」を参照してください。
- エージェント JVM で実行されているデータベースエージェントのログレベルを構成します。アタッチされたログファイルには、エージェントのロギングが INFO レベルに設定されている場合のエージェントログファイルの例が示されています。これがデフォルトです。ログファイルは、
<db_agent_home>\logs
にあります。
コントローラ イベント サービスの開始(オンプレミスのみ)
オンプレミス環境では、データベースをモニタするために、データベースエージェントを開始する前にコントローラ イベント サービスを開始する必要があります。
Linux
bin/platform-admin.sh start-events-service
Windows
bin\platform-admin.exe start-events-service
システムプロパティを使用したデータベースエージェントの起動
以下は、必要なすべてのパラメータが controller-info.xml
で指定されていることを前提としています。
方法 1:起動スクリプトを使用してエージェントを起動する
スクリプトを使用してエージェントを起動できます。これは推奨される方法です。
Linux
./start-dbagent -Xms<min_heap_size> -Xmx<max_heap_size> &
Windows
start-dbagent.bat -Xms<min_heap_size> -Xmx<max_heap_size>
または、Windows サービスとしてエージェントを起動することもできます(4.5.4 以降)。「Windows サービスとしてのデータベースエージェントのインストール」を参照してください。
方法 2:Java コマンドを使用してエージェントを起動する
または、次の Java コマンドを使用してエージェントを起動することもできます。
Linux
java -XX:+HeapDumpOnOutOfMemoryError -XX:OnOutOfMemoryError=“kill -9 %p” -jar db-agent.jar
Windows
C:\java -Djava.library.path="<db_agent_home>\auth\x64" -Ddbagent.name="Scarborough Network Database Agent" -jar <db_agent_home>\db-agent.jar
システムのプロパティ
データベースエージェント名
Configure using System Properties: -Ddbagent.name=<db_agent_name>
Type: スペースを含む ASCII 文字列。<db_agent_name>
にスペースが含まれている場合は、名前全体を二重引用符(" ")で囲む必要があります。
Required:複数のエージェントが同じコントローラにレポートしている場合は必須です。
Default:デフォルト データベース エージェント
Java ライブラリのパス
Configure using System Properties: -Djava.library.path=<db_agent_home>\auth\x64
Type: スペースを含む ASCII 文字列。 <db_agent_home>
にスペースが含まれている場合は、名前全体を二重引用符(" ")で囲む必要があります。
Required:はい(Windows の場合のみ)
Specify:
64 ビットシステムの場合:<db_agent_home>\auth\x64
32 ビットシステムの場合:<db_agent_home>\auth\x86
JVM メモリの増加
複数のデータベースをモニタするには、JVM のメモリ割り当てサイズを増やす必要がある場合があります。モニタリング対象のデータベースのアクティビティが増加すると、メモリ使用率が増加します。
次のいずれかのコマンドを使用して、エージェントを起動し、デフォルトの 64 MB ではなく、最初に 1536 MB をエージェントに割り当てます。
For Windows 64-bit
C:\java -Xmx1536m -Djava.library.path="<db_agent_home>\auth\x64" -jar <db_agent_home>\db-agent.jar
For Linux
% java -Xmx1536m -jar <db_agent_home>/db-agent.jar