エージェントの登録¶
各PEMエージェントは、PEMサーバーに*登録*する必要があります。登録プロセスは、エージェントと通信するために必要な情報をPEMサーバーに提供します。 Windows用のPEMエージェントグラフィカルインストーラーは、エージェントの自己登録をサポートしています。エージェントがLinuxホスト上にある場合、エージェントを登録するには pemworker ユーティリティを使用する必要があります。
RPMインストーラーはPEMエージェントを /usr/edb/pem/agent/bin ディレクトリに配置します。エージェントを登録するには、pemworkerユーティリティを呼び出すときに、登録の詳細とともに --register-agent キーワードを含めます。
pemworker -–register-agent
pemworkerユーティリティを呼び出すときに、コマンド文字列にコマンドラインオプションを追加します。各オプションの後には、対応する値が続く必要があります。
オプション |
説明 |
|---|---|
--pem-server |
PEMバックエンドデータベースサーバーのIPアドレスを指定します。このパラメーターは必須です。 |
–pem-port |
PEMバックエンドデータベースサーバーのポートを指定します。デフォルト値は5432です。 |
--pem-user |
PEMバックエンドデータベースサーバーのデータベースユーザー（スーパーユーザー特権を持つ）の名前を指定します。このパラメーターは必須です。 |
--pem-agent-user |
PEMサーバーバックエンドデータベースサーバーに接続するエージェントユーザーを指定します。 |
--cert-path |
証明書が作成されるディレクトリへの完全なパスを指定します。パスを指定しない場合、証明書は次の場所に作成されます。Linuxでは〜/ .pem Windowsでは％APPDATA％/ pem |
--config-dir |
構成ファイルが見つかるディレクトリパスを指定します。デフォルトは<pemworker path> /../etc。 |
–display-name |
PEM Browserツリーコントロールに表示されるエージェントのわかりやすい名前を指定します。デフォルトはシステムのホスト名です。 |
–force-registration |
force_registration句を含めて、指定された引数でエージェントを登録するようにPEMサーバーに指示します。この句は、既存のエージェント構成をオーバーライドする場合に役立ちます。デフォルト値は``はい``です。 |
–group |
エージェントが表示されるグループの名前。 |
–team |
監視対象データベースサーバーにアクセスする必要があるPEMバックエンドデータベースサーバー上のデータベースロールの名前。 |
–owner |
エージェントを所有するPEMバックエンドデータベースサーバー上のデータベースユーザーの名前。 |
--allow_server_restart |
allow-server_restartパラメーターを有効にして、PEMが監視対象サーバーを再起動できるようにします。デフォルト値はTrueです。 |
--allow-batch-probes |
allow-batch-probesパラメーターを有効にして、PEMがこのエージェントでバッチプローブを実行できるようにします。デフォルト値はFalseです。 |
--batch-script-user |
バッチ/シェルスクリプトの実行に使用するオペレーティングシステムユーザーを指定します。デフォルト値はnoneです。このパラメーターを空白のままにした場合、または指定したユーザーが存在しない場合、スクリプトは実行されません。 |
--enable-heartbeat-connection |
enable-heartbeat-connectionパラメーターを有効にして、PEMエージェントとサーバー間に専用のハートビート接続を作成し、アクティブステータスを更新します。デフォルト値はFalseです。 |
--enable-smtp |
enable-smtpパラメーターを有効にして、PEMエージェントがPEMサーバーの代わりに電子メールを送信できるようにします。デフォルト値はFalseです。 |
--enable-snmp |
enable-snmpパラメーターを有効にして、PEMエージェントがPEMサーバーに代わってSNMPトラップを送信できるようにします。デフォルト値はFalseです。 |
-o |
構成ファイルのオプションをオーバーライドするかどうかを指定します。 |
Audit Manager、Log Manager、Tuning Wizardなど、pemagentでデータベースサーバーの再起動が必要なPEM機能を使用する場合は、 allow_server_restart の値を true として設定する必要があります agent.cfg ファイル。
注釈
PEM 7.11以降のバージョンがインストールされているPEMエージェントによって実行されるシェル/バッチスクリプトを構成する場合、 batch_script_user パラメーターのユーザーを指定する必要があります。スクリプトの実行には、非rootユーザーを使用することを強くお勧めします。 rootユーザーを使用すると、データのセキュリティとオペレーティングシステムのセキュリティが低下する可能性があります。ただし、rootユーザーを使用してスクリプトを実行してpemagentを元の設定に復元する場合は、 batch_script_user パラメーター値を root に設定する必要があります。
PEM_SERVER_PASSWORD環境変数を使用して、PEM管理ユーザーのパスワードを設定できます。 PEM_SERVER_PASSWORDが設定されていない場合、サーバーはPEMデータベースサーバーへの接続時にPGPASSWORDまたはpgpassファイルを使用します。
パスワードの入力に失敗すると、パスワード認証エラーが発生します。他の必須だが省略された情報の入力を求められます。登録が完了すると、サーバーはエージェントが正常に登録されたことを確認します。
PEMエージェント構成パラメーターの設定¶
PEMエージェントRPMインストーラーは、 /usr/edb/pem/agent/etc ディレクトリに agent.cfg.sample という名前のサンプル構成ファイルを作成します。 PEMエージェントを登録すると、pemworkerプログラムは実際のエージェント構成ファイル（ agent.cfg という名前）を作成します。次の構成パラメーターを追加して、agent.cfgファイルを変更する必要があります。
heartbeat_connection = true
ca-bundle.crt ファイル（認証局）の場所も追加する必要があります。デフォルトでは、インストーラーは agent.cfg.sample ファイルで指定された場所に ca-bundle.crt ファイルを作成します。サンプルファイルからデフォルトのパラメーター値をコピーするか、別の場所に保存されている ca-bundle.crt ファイルを使用する場合は、その値を ca_file パラメーターに指定します。
ca_file=/usr/libexec/libcurl-pem7/share/certs/ca-bundle.crt
次に、プラットフォーム固有のコマンドを使用して、PEMエージェントサービスを開始します。サービスの名前は pemagent です。たとえば、CentOSまたはRHEL 6.xシステムでは、次のコマンドを使用します。
/etc/init.d/pemagent
CentOSまたはRHEL 7.xホストで、systemctlを使用してサービスを開始します。
systemctl start pemagent
サービスは、エージェントを開始していることを確認します。エージェントが登録および起動されると、 Global Overview ダッシュボードおよびPEM Webインターフェイスのオブジェクトブラウザツリーコントロールに表示されます。
pemworkerユーティリティを使用してサーバーを登録する方法については、次のWebサイトで入手可能な* PEM入門ガイド*を参照してください。
非ルートユーザーアカウントを使用してPEMエージェントを登録する¶
非rootユーザーを使用してPEMエージェントを登録するには、最初にPEMエージェントをrootユーザーとしてインストールする必要があります。インストール後、非rootユーザー（edbなど）のIDを想定して、以下の手順を実行します。
次のように
.pemディレクトリとlogsディレクトリを作成し、ファイルに読み取り、書き込み、実行のアクセス許可を割り当てます。
mkdir /home/<edb>/.pem
mkdir /home/<edb>/.pem/logs
chmod 700 /home/<edb>/.pem
chmod 700 /home/<edb>/.pem/logs
次のように
pemworkerユーティリティを使用して、エージェントをPEMサーバーに登録します。
./pemworker --register-agent --pem-server <172.19.11.230> --pem-user <postgres> --pem-port <5432> --display-name <non_root> --cert-path /home/<edb> --config-dir /home/<edb>
上記のコマンドは、 /home/edb/.pem ディレクトリにエージェント証明書とエージェント設定ファイル（ agent.cfg ）を作成します。次のコマンドを使用して、これらのファイルに読み取りおよび書き込み権限を割り当てます。
chmod -R 600 /home/edb/.pem/agent*
agent.cfgファイルのパラメーターを次のように変更します。
agent_ssl_key=/home/edb/.pem/agent<id>.key
agent_ssl_crt=/home/edb/.pem/agent<id>.crt
log_location=/home/edb/.pem/worker.log
agent_log_location=/home/edb/.pem/agent.log
pemagentサービスファイルのパスとユーザーの値を更新します。
CentOS 6を使用している場合、
agent.cfgファイルの正しいパスを反映するようにpemagentサービスファイルを更新し、ユーザーsuをsu edbに変更します。CentOS 7を使用している場合は、次のようにパラメーターを更新します。
User=edb
ExecStart=/usr/edb/pem/agent/bin/pemagent -c /home/edb/.pem/agent.cfg
前に開始されたエージェントプロセスを強制終了し、次のように非ルートユーザーを使用してエージェントサービスを再起動します。
sudo /etc/init.d/pemagent start/stop/restartPEMダッシュボードでエージェントのステータスを確認します。
