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

WhaTapデータベースモニタリングサービスを使用するための基本的なインストール方法について説明します。

プロジェクト作成

エージェントをインストールする前にプロジェクトを作成してください。

WhaTapモニタリングサービスにログインしてください。
左側のサイドメニューでプロジェクト全体 > + Project ボタンをクリックします。
商品選択画面でインストールする製品を選択します。
以下の項目を入力または選択します。
- プロジェクト名：プロジェクト名を入力します。
- データサーバーリージョン：データサーバーの設置されているリージョンを選択します。リージョンとは、クラウドサービスを提供するデータセンターの集合体です。選択したリージョンにユーザーデータが保存されます。
- プロジェクトタイムゾーン：アラートおよびレポート生成時の基準となる時刻を設定します。
- 通知言語の設定：アラート通知メッセージの言語を設定します。（韓国語、英語に対応）
- プロジェクトグループ：複数のプロジェクトをグループとしてまとめて管理できます。所属するグループがある場合は選択してください。
- プロジェクト説明：プロジェクトに関する補足説明や詳細情報を入力します。
すべての設定が完了したら、プロジェクトを作成するボタンをクリックします。

ノート

組織を選択してプロジェクトを追加する場合は、組織下位のグループを必須に設定する必要があります。

グループに関する詳細は、次のドキュメントを参照してください。

構成図の確認

Oracle Proモニタリングのためにデータベースサーバーにエージェントをインストールする構成です。

ファイアウォールの設定は必須であり、すべてのデータは暗号化されて送信されます。 WhaTap収集サーバーとの通信には6600ポートを使用します。

アカウント生成

データベースモニタリングをするために必要な権限を持つアカウントを作成します。root(admin) アカウントでログインしてアカウントを作成してください。

一般的な場合

SQL
create user {DB_User} identified by {DB_Password};
grant create session to {DB_User};
grant select any dictionary to {DB_User};

マルチテナントDB(Oracle 12c以降)で基本モニタリングを使用する場合: c##アカウント作成

SQL
create user c##{DB_User} identified by "{DB_Password}";
grant create session to c##{DB_User};
grant select any dictionary to c##{DB_User};
alter user c##{DB_User} set container_data = ALL container = CURRENT;

kill sessionを使用する場合
SQL
```
grant alter system to {DB_User}
```

ヒドゥンパラメータを照会する場合

SQL
create view sys.whatap_vw_ksppi as select * from sys.x$ksppi;
grant select on sys.whatap_vw_ksppi to {DB_User};  
create synonym {DB_User}.whatap_vw_ksppi for sys.whatap_vw_ksppi;

create view sys.whatap_vw_ksppcv as select * from sys.x$ksppcv;
grant select on sys.whatap_vw_ksppcv to {DB_User};
create synonym {DB_User}.whatap_vw_ksppcv for sys.whatap_vw_ksppcv;

権限による対応機能を確認する

基本権限外の権限は、ユーザーの環境によって付与する必要はありません。ただし、一部の機能が動作しないことがあります。

Privilege	Command (Single DB)	Command (Multitenant DB)	Feature	Description
基本権限	`grant create session to whatap;`	`grant create session to c##whatap;`	접속	-
	`grant select any dictionary to whatap;`	`grant select any dictionary to c##whatap;`	インスタンスモニタリング / マルチインスタンス / SQL統計	個別権限の付与時、次の表の内容を参照
	-	`alter user c##whatap set container_data = ALL container = CURRENT;`	インスタンスモニタリング / マルチインスタンス / SQL統計	マルチテナントDBを使用する場合(12C以降) pdb照会のための必須権限である
セッション中止	`grant alter system to whatap;`	`grant alter system to c##whatap container=all;`	アクティブセッション > セッション中止	-
ヒドゥンパラメータの照会	`create view sys.whatap_vw_ksppi as select * from sys.x$ksppi;` `grant select on sys.whatap_vw_ksppi to DB_User;` `create synonym DB_User.whatap_vw_ksppi for sys.whatap_vw_ksppi;`		パラメータ照会メニューにヒドゥンパラメータの内容を含む	ヒドゥンパラメータを照会するには、別のビュー/シノニムの生成および権限付与が必要
ヒドゥンパラメータの照会	`create view sys.whatap_vw_ksppcv as select * from sys.x$ksppcv;` `grant select on sys.whatap_vw_ksppcv to DB_User;` `create synonym DB_User.whatap_vw_ksppcv for sys.whatap_vw_ksppcv;`		パラメータ照会メニューにヒドゥンパラメータの内容を含む	ヒドゥンパラメータを照会するには、別のビュー/シノニムの生成および権限付与が必要

select any dictionaryの代わりに、次の権限を個別に付与しても構いません。

Privilege	Command (Single DB)	Command (Multitenant DB)
アクティブセッション / ロックツリー / メトリクス情報	`grant select on v_$sqlarea to whatap;`	`grant select on v_$sqlarea to c##whatap;`
	`grant select on v_$transaction to whatap;`	`grant select on v_$transaction to c##whatap;`
	`grant select on v_$instance to whatap;`	`grant select on v_$instance to c##whatap;`
	`grant select on v_$sysstat to whatap;`	`grant select on v_$sysstat to c##whatap;`
	`grant select on v_$lock to whatap;`	`grant select on v_$lock to c##whatap;`
	`grant select on v_$sesstat to whatap;`	`grant select on v_$sesstat to c##whatap;`
	`grant select on v_$event_name to whatap;`	`grant select on v_$event_name to c##whatap;`
	`grant select on v_$session to whatap;`	`grant select on v_$session to c##whatap;`
	`grant select on v_$sql to whatap;`	`grant select on v_$sql to c##whatap;`
	`grant select on v_$process to whatap;`	`grant select on v_$process to c##whatap;`
	`grant select on v_$statname to whatap;`	`grant select on v_$statname to c##whatap;`
	`grant select on v_$system_event to whatap;`	`grant select on v_$system_event to c##whatap;`
	`grant select on v_$osstat to whatap;`	`grant select on v_$osstat to c##whatap;`
	`grant select on v_$px_session to whatap;`	`grant select on v_$px_session to c##whatap;`
	`grant select on v_$sga to whatap;`	`grant select on v_$sga to c##whatap;`
	-	`grant select on v_$con_sysstat to c##whatap;`
パラメータ情報	`grant select on v_$parameter to whatap;`	`grant select on v_$parameter to c##whatap;`
Wait情報/Event情報	`grant select on v_$event_name to whatap;`	`grant select on v_$event_name to c##whatap;`
	`grant select on v_$system_event to whatap`	`grant select on v_$con_system_event to c##whatap;`
	`grant select on v_$system_wait_class to whatap;`	`grant select on v_$system_wait_class to c##whatap;`
	-	`grant select on v_$con_system_wait_class to c##whatap;`
Tablespace情報	`grant select on dba_data_files to whatap;`	`grant select on cdb_data_files to c##whatap;`
	`grant select on dba_free_space to whatap;`	`grant select on cdb_free_space to c##whatap;`
	`grant select on dba_temp_files to whatap;`	`grant select on v_$sort_segment to c##whatap;`
	`grant select on v_$temp_extent_pool to whatap;`	`grant select on v_$tempfile to c##whatap;`
	`grant select on v_$containers to whatap;` (12c以上)	`grant select on v_$containers to c##whatap;`

ノート

既に存在するアカウントを使用する場合は、DBユーザーファイルの作成に進みます。権限がない場合は、モニタリングを開始できません。
コード例でwhatapは、DBユーザーアカウント名です。ユーザーが利用するユーザーアカウント名に変更してください。

コード例のDB_Passwordには、ユーザーパスワードを入力します。

アクセスキーの確認

アクセスキーは、WhaTapサービスを有効にするための固有IDです。

インストール手順セクションでプロジェクトアクセスキーの発行ボタンをクリックします。 アクセスキーを自動的に発行した後、次のステップを進みます。

ノート

プロジェクトを作成すると、自動的にエージェントインストールページに移動します。エージェントインストールページが移動しない場合は、画面左側のメニューから管理 > エージェントインストールを選択します。

エージェントダウンロード

エージェントのインストール画面で、ユーザーの環境と一致するOracleバージョンを選択しダウンロードボタンを選択します。

ノート

セキュリティ設定によりTAR形式のファイルをダウンロードできないユーザーのためにZIP形式のファイルも一緒に提供します。インストール画面で.zip ダウンロードボタンを選択します。

エージェント設定

エージェントはOracleアカウントでのインストールを推奨し、Oracle接続環境変数が事前に設定されている必要があります。以下の手順でエージェント設定を進めてください。

ノート

Oracleアカウント以外のユーザーアカウントからインストールする場合

Oracleこの生成した共有メモリ(shared memory)の読み込み権限(read)が必要です。
ipcs -mコマンドを実行した結果でperms値が640の場合、同じグループに属する別のアカウントでエージェントをインストールできます。
ipcs -mコマンドを実行した結果でperms値が600でありながら、Oracle 12c R2以降であれば、次のようにパラメータを設定し、perms値を640に変更できます。変更事項を適用するには、DBを再起動する必要があります。
```
alter system set allow_group_access_to_sga=true scope=spfile;
```

whatap.conf設定

圧縮を解除したフォルダに移動し、whatap.confファイルを確認します。 whatap.conf ファイルに、プロジェクトのアクセスキー情報、WhaTapサーバー情報、ipckeyを入力します。

whatap.conf
license={AccessKey}
whatap.server.host=13.124.11.223/13.209.172.35 # WhaTap server information
ipckey={ipckey}

Tips

ipckeyオプション値は、ipcs -mコマンドを使用して取得できます。モニタリングするOracleのKey値(16進数)です。
1つのサーバーに複数のデータベースをインストールした場合は、次の文書を参照してipckeyを入力します。

初期設定ファイル作成

初期設定ファイルを作成するには、データベースにSYSアカウント(または同ランクのアカウント)にアクセスして情報を受け取り、処理します。アカウントとパスワードは保存されません。

BASH
./dmxinit.sh {sys_user} {sys_password}

コマンドを実行した後、次の5つのファイルが作成されます。

dmx.init、class.init、dbname.init、stat.init、event.init

ノート

sys_userとsys_passwordなしで接続できるのであれば(sqlplus '/as sysdba'接続のように)、sys_userとsys_passwordを引数として追加する必要はありません。
BASH
```
./dmxinit.sh
```
sys_userとsys_password文字列に特殊文字が含まれている場合は、各特殊文字の前にエスケープ文字(Escape Character、\)を追加します。
BASH
```
./dmxinit.sh whatap whatap\!\@pwd
```

DBユーザーの作成とパスワードの変更

データベース接続用に暗号化されたUIDを作成します。usernameとpasswordを入力し、シェルスクリプト(またはバッチファイル)を実行してください。

Tips

パスワードを変更する場合も、変更するパスワードを入力して同じ方法で進めてください。

BASH
./uid.sh {DB_USER} {DB_PASSWORD}

ノート

一度の設定で暗号化されたUIDを使用してモニタリング対象データベースサーバーからデータを収集します。
DBユーザーファイルを生成するには、プロジェクトアクセスキーをwhatap.confファイルに入力する必要があります。アクセスキーの確認
Azure Database環境の場合、DB_USERをDB_USER@DB_nameの形式で入力します。
DB_USERまたはDB_PASSWORDに特殊文字が含まれている場合、特殊文字の前にEscape Character(\)を入力します。
Example
```
./uid.sh whatap whatap\!pwd

# 特殊文字が2つ以上の場合、それぞれエスケープ文字を追加
./uid.sh whatap whatap\!\@pwd
```

モニタリングの開始

エージェントをインストールしたパスからシェルスクリプト(またはバッチファイル)を実行してください。

./start.sh

デーモンのように使用する場合、次のコマンドを実行してください。ただし、nohupをインストールした環境のみで動作します。

./startd.sh

次のステップ

インストールの点検

プロジェクトの作成やエージェントのインストール、基本エージェントのオプションまですべて適用した場合は、次の文書で点検事項を確認します。
インストール問題の解決

エージェントをインストールする際に発生する可能性がある問題と、これを解決するための具体的なガイドを提供します。詳細については、次の文書を参照してください。
エージェント設定

エージェント設定(whatap.conf)ファイルにオプションを適用して、モニタリングのための様々な機能を提供します。詳細については、次の文書を参照してください。

モニタリングの開始

すべての設定を完了したら、エージェントがデータベースサーバーのメトリクスに対する情報収集を開始します。まず、インスタンスリストメニューでモニタリングデータが収集されていることを確認します。インスタンスリストの詳細については、次の文書を参照してください。

プロジェクト作成​

構成図の確認​

アカウント生成​

アクセスキーの確認​

エージェントダウンロード​

エージェント設定​

whatap.conf設定​

初期設定ファイル作成​

DBユーザーの作成とパスワードの変更​

モニタリングの開始​

次のステップ​