エージェントの登録¶
各PEMエージェントは、PEMサーバーに*登録*する必要があります。登録プロセスは、エージェントと通信するために必要な情報をPEMサーバーに提供します。Windows用のPEMエージェントグラフィカルインストーラーは、エージェントの自己登録をサポートしています。エージェントがLinuxホスト上にある場合、エージェントを登録するには pemworker ユーティリティを使用する必要があります。
RPMインストーラーは、PEMエージェントを /usr/edb/pem/agent/bin ディレクトリに配置します。エージェントを登録するには、pemworkerユーティリティを呼び出すときに登録の詳細とともに --register-agent キーワードを含めます。
pemworker --register-agent
pemworker ユーティリティを呼び出すときに、コマンドラインオプションをコマンド文字列に追加します。各オプションの後には、対応する値が続く必要があります。
オプション |
説明 |
|---|---|
|
PEMバックエンドデータベースサーバーのIPアドレスを指定します。このパラメーターは必須です。 |
|
PEMバックエンドデータベースサーバーのポートを指定します。デフォルト値は5432です。 |
|
PEMバックエンドデータベースサーバーの（スーパーユーザー特権を持つ）データベースユーザーの名前を指定します。このパラメーターは必須です。 |
|
PEMサーバーバックエンドデータベースサーバーに接続するエージェントユーザーを指定します。 |
|
証明書が作成されるディレクトリへの完全なパスを指定します。パスを指定しない場合、証明書は次の場所に作成されます。Linuxでは〜/.pemWindowsでは％APPDATA％/pem |
|
構成ファイルを見つけることができるディレクトリパスを指定します。デフォルトは<pemworkerpath>/../etcです。 |
|
PEMBrowserツリーコントロールに表示されるエージェントのわかりやすい名前を指定します。デフォルトはシステムのホスト名です。 |
|
force_registration句を含めて、指定された引数でエージェントを登録するようにPEMサーバーに指示します。この句は、既存のエージェント構成をオーバーライドする場合に役立ちます。デフォルト値は``はい``です。 |
|
エージェントが表示されるグループの名前。 |
|
監視対象のデータベースサーバーにアクセスする必要がある、PEMバックエンドデータベースサーバー上のデータベースロールの名前。 |
|
エージェントを所有するPEMバックエンドデータベースサーバー上のデータベースユーザーの名前。 |
|
allow-server_restartパラメーターを有効にして、PEMが監視対象サーバーを再起動できるようにします。デフォルト値はTrueです。 |
|
allow-batch-probesパラメーターを有効にして、PEMがこのエージェントでバッチプローブを実行できるようにします。デフォルト値はFalseです。 |
|
バッチ/シェルスクリプトの実行に使用するオペレーティングシステムユーザーを指定します。デフォルト値はnoneです。このパラメーターを空白のままにした場合、または指定したユーザーが存在しない場合、スクリプトは実行されません。 |
|
enable-heartbeat-connectionパラメーターを有効にして、PEMエージェントとサーバー間に専用のハートビート接続を作成し、アクティブステータスを更新します。デフォルト値はFalseです。 |
|
enable-smtpパラメーターを有効にして、PEMエージェントがPEMサーバーに代わって電子メールを送信できるようにします。デフォルト値はFalseです。 |
|
enable-snmpパラメーターを有効にして、PEMエージェントがPEMサーバーに代わってSNMPトラップを送信できるようにします。デフォルト値はFalseです。 |
|
構成ファイルのオプションをオーバーライドするかどうかを指定します。 |
データベースサーバーの再起動がpemagentで必要なPEM機能（監査マネージャー、ログマネージャー、チューニングウィザードなど）を使用する場合は、 allow_server_restart の値を true に設定する必要があります agent.cfg ファイル内。
注釈
PEM7.11以降のバージョンがインストールされているPEMエージェントによって実行されるシェル/バッチスクリプトを構成する場合、 batch_script_user パラメーターのユーザーを指定する必要があります。root以外のユーザーを使用してスクリプトを実行することを強くお勧めします。rootユーザーを使用すると、データのセキュリティとオペレーティングシステムのセキュリティが低下する可能性があります。ただし、rootユーザーを使用してスクリプトを実行してpemagentを元の設定に復元する場合は、 batch_script_user パラメーター値を root に設定する必要があります。
PEM_SERVER_PASSWORD 環境変数を使用して、PEM管理ユーザーのパスワードを設定できます。 PEM_SERVER_PASSWORD が設定されていない場合、サーバーはPEMデータベースサーバーへの接続時に PGPASSWORD または .pgpass ファイルを使用します。
パスワードの入力に失敗すると、パスワード認証エラーが発生します。その他の必須だが省略された情報の入力を求められます。登録が完了すると、サーバーはエージェントが正常に登録されたことを確認します。
PEMエージェント構成パラメーターの設定¶
The PEM agent RPM installer creates a sample configuration file named
agent.cfg.sample in the /usr/edb/pem/agent/etc directory. When you
register the PEM agent, the pemworker program creates the actual agent
configuration file (named agent.cfg). You must modify the agent.cfg file,
adding the following configuration parameter:
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またはRHEL6.xシステムでは、次のコマンドを使用します。
/etc/init.d/pemagent
RHELまたはCentOS7.xまたは8.xホストで、systemctlを使用してサービスを開始します。
systemctl start pemagent
サービスは、エージェントを開始していることを確認します。エージェントが登録および起動されると、 Global Overview ダッシュボードおよびPEMWebインターフェイスのオブジェクトブラウザツリーコントロールに表示されます。
pemworkerユーティリティを使用してサーバーを登録する方法については、次のWebサイトで入手可能な*PEM管理者ガイド*を参照してください。
非ルートユーザーアカウントを使用してPEMエージェントを登録する¶
非rootユーザーを使用してPEMエージェントを登録するには、最初にPEMエージェントをrootユーザーとしてインストールする必要があります。インストール後、非ルートユーザーのID（たとえば、 edb ）を想定して、次の手順を実行します。
次のように
.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サービスファイルのユーザーの値を更新します。
RHELまたはCentOS6を使用している場合、
agent.cfgファイルの正しいパスを反映するようにpemagentサービスファイルを更新し、ユーザーsuをsu edbに変更します。RHELまたはCentOS7または8を使用している場合は、次のようにパラメーターを更新します。
User=edb
ExecStart=/usr/edb/pem/agent/bin/pemagent -c /home/edb/.pem/agent.cfg
以前に開始されたエージェントプロセスを停止し、次のように非ルートユーザーを使用してエージェントサービスを再起動します。
RHELまたはCentOS6を使用している場合、
sudo /etc/init.d/pemagent start/stop/restartRHELまたはCentOS7または8を使用している場合、
sudo systemctl start/stop/restart pemagent
PEMダッシュボードでエージェントのステータスを確認します。
