データベースエージェントのインストール

このページでは、データベースエージェントを手動でインストールする方法について説明します。または、Download & Install Wizard の手順に従うこともできます。これは、コントローラ UI のホームページからアクセスできます。ウィザードにより、インストールプロセスが容易になります。

権限の問題を回避するには、エージェントを実行するのと同じユーザ、またはホストマシンの管理者としてデータベースエージェントをインストールする必要があります。データベースエージェントを実行するには、ログ出力ディレクトリと、エージェント インストール ディレクトリにある conf ディレクトリに対する書き込み権限が必要です。

エージェントソフトウェアのインストール

1. AppDynamics ダウンロードセンター（http://download.appdynamics.com）から、ご使用の OS 環境に適したインストールパッケージのバージョンをダウンロードします。
2. zip ファイルを宛先ディレクトリに展開します。エージェントのインストール先ディレクトリにはスペースを使用しないでください。 
3. データベースエージェントをインストールするマシンに管理者としてログオンします。

Windows

dbagent-x.x.x.zip ファイルをダブルクリックし、ファイルを <db_agent_home> に展開します。必要に応じて、次のように zip ファイルのブロックを解除してから展開することができます。zip ファイルを右クリックし、[Properties] を選択して [unblock] を選択します。 

データベースエージェントには 2 つのバージョンがあります。1 つは 32 ビットで、もう 1 つは 64 ビット（4.5.2 以降）です。OS の要件に基づいてバージョンを選択します。

Linux

コマンドラインで次のコマンドを入力します。

unzip dbagent-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 通信を有効化を参照してください。

• プロキシ設定を使用するようにエージェントを構成します。コントローラのプロキシ設定を参照してください。

• マシンが Linux または Windows で起動したときに自動的に実行されるようにエージェントを構成します。

• 複数のエージェントが必要な場合などに、コントローラに対して自身を一意に識別するようにエージェントを構成します。「複数のエージェント環境のプロパティ」を参照してください。
• 別のデータベースエージェントのバックアップとして動作するようにエージェントを構成します。「複数のエージェント環境のプロパティ」を参照してください。
• エージェント JVM で実行されているデータベースエージェントのログレベルを構成します。アタッチされたログファイルには、エージェントのロギングが INFO レベルに設定されている場合のエージェントログファイルの例が示されています。これがデフォルトです。ログファイルは、<db_agent_home>\logs にあります。

コントローラ イベント サービスの開始（オンプレミスのみ）

オンプレミス環境では、データベースをモニタするために、データベースエージェントを開始する前にコントローラ イベント サービスを開始する必要があります。

Linux

以下は、必要なすべてのパラメータが 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

システムのプロパティ

データベースエージェント名

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 をエージェントに割り当てます。 

C:\java -Xmx1536m -Djava.library.path="<db_agent_home>\auth\x64" -jar <db_agent_home>\db-agent.jar

% java -Xmx1536m -jar <db_agent_home>/db-agent.jar