サーバーの登録

PEMでサーバーを管理または監視する前に、サーバーをPEMに登録し、エージェントをバインドする必要があります。サーバーはリモートエージェント（別のホストに存在するエージェント）にバインドできますが、エージェントが同じホストに存在しない場合、インスタンスに関するすべての統計情報にアクセスできません。

サーバーの手動登録

PEMを使用してサーバーを管理または監視するには、次のことを行う必要があります。

• AdvancedServerまたはPostgreSQLサーバーをPEMサーバーに登録します。

• サーバーをPEMエージェントにバインドします。

Create - Server ダイアログを使用して、サーバーの登録情報を提供し、PEMエージェントをバインドし、サーバーをPEMクライアントツリーコントロールに表示できます。 Create - Server ダイアログを開くには、 Object メニュー（またはサーバーグループのコンテキストメニュー）の Create オプションをナビゲートし、 Server… を選択します。

``サーバーの作成``ダイアログへのアクセス

注釈

登録するPostgresサーバーの pg_hba.conf ファイルが接続を試みる前にPEMクライアントのホストからの接続を許可していることを確認する必要があります。

[作成-サーバー]ダイアログの[全般]タブ

サーバーの一般的なプロパティを説明するには、 General タブのフィールドを使用します。

• Name フィールドを使用して、サーバーのわかりやすい名前を指定します。指定された名前は、PEM Browser ツリーコントロールでサーバーを識別します。

• グループを使用して、ツリーコントロールでサーバーとエージェントを整理できます。グループを使用すると、多数のサーバーをより簡単に管理できます。たとえば、運用グループ、テストグループ、またはLAN固有のグループが必要な場合があります。 Group ドロップダウンリストボックスを使用して、新しいサーバーが表示されるサーバーグループを選択します。

• Team フィールドを使用して、Postgresロール名を指定します。このロールのメンバーである、サーバーを最初に作成した、またはPEMサーバーでスーパーユーザー特権を持つPEMユーザーのみが、PEMにログオンしたときにこのサーバーを表示します。このフィールドを空白のままにすると、すべてのPEMユーザーにサーバーが表示されます。

• Background カラーセレクターを使用して、サーバーに保存されているデータベースオブジェクトの背後にあるPEMツリーコントロールに表示される色を選択します。

• Foreground カラーセレクターを使用して、サーバーに保存されているオブジェクトのPEMツリーコントロールのラベルのフォントの色を選択します。

• Check the box next to Connect now? to instruct PEM to attempt a server connection when you click the Save button. Leave Connect now? unchecked if you do not want the PEM client to validate the specified connection parameters until a later connection attempt.

• Comments フィールドにサーバーに関するメモを入力します。

[作成-サーバー]ダイアログの[接続]タブ

Connection tab のフィールドを使用して、サーバーの接続の詳細を指定します。

• サーバーホストのIPアドレス、または Host name/address フィールドに完全修飾ドメイン名を指定します。Unixベースのシステムでは、ローカルマシンでデフォルトのPostgreSQLUnixドメインソケットを使用するためにアドレスフィールドを空白のままにするか、PostgreSQLソケットを含む代替パスに設定できます。パスを入力する場合、パスは/"//"で始まる必要があります。

• Port フィールドにホストのポート番号を指定します。

• Use the Maintenance database field to specify the name of the initial database that PEM will connect to, and that will be expected to contain pgAgent schema and adminpack objects installed (both optional). On PostgreSQL 8.1 and above, the maintenance DB is normally called postgres; on earlier versions template1 is often used, though it is preferrable to create a postgres database to avoid cluttering the template database.

• サーバーで認証するときに使用される名前を Username フィールドに指定します。

• 指定したユーザーに関連付けられたパスワードを Password フィールドに入力します。

• Save password? の横のボックスをオンにして、後で再利用できるように、パスワードを暗号化形式でPEMバックエンドデータベースに保存するようにPEMに指示します。パスワードはサーバーごとにユーザーごとに保存されるため、他のチームメンバーとは共有されません。PEMは保存されたパスワードを使用して、次回データベースサーバーに接続します。保存したパスワードを削除するには、最初にデータベースサーバーを切断してから、[オブジェクト/コンテキスト]メニューの[保存したパスワードをクリア]メニュー項目を使用します。

• Role フィールドを使用して、サーバーへの接続後にクライアントが使用する必要がある特権が割り当てられているロールの名前を指定します。これにより、1つの役割として接続し、接続が確立されたときに別の役割（このフィールドで指定した役割）の許可を引き受けることができます。接続する役割は、指定された役割のメンバーでなければなりません。

[作成-サーバー]ダイアログの[SSL]タブ

SSLを構成するには、 SSL タブのフィールドを使用します:

• SSL mode フィールドのドロップダウンリストボックスを使用して、サーバーが使用するSSL接続のタイプを選択します。SSL暗号化の使用の詳細については、次のPostgreSQLドキュメントを参照してください。

  https://www.postgresql.org/docs/current/static/libpq-ssl.html

プラットフォーム固有の File マネージャーダイアログを使用して、SSL暗号化をサポートするファイルをサーバーにアップロードできます。ファイルマネージャーにアクセスするには、次の各フィールドの右側にあるアイコンをクリックします。

• Client certificate フィールドを使用して、クライアントSSL証明書を含むファイルを指定します。PEMがデスクトップモードでインストールされている場合、このファイルはデフォルトの ~/.postgresql/postgresql.crt ファイルを置き換え、PEMがWebモードでインストールされている場合は <STORAGE_DIR>/<USERNAME>/.postgresql/postgresql.crt を置き換えます。SSL接続が確立されない場合、このパラメーターは無視されます。

• Client certificate キーフィールドを使用して、クライアント証明書に使用される秘密キーを含むファイルを指定します。PEMがデスクトップモードでインストールされている場合、このファイルはデフォルトの ~/.postgresql/postgresql.key を置き換え、PEMがWebモードでインストールされている場合は <STORAGE_DIR>/<USERNAME>/.postgresql/postgresql.key を置き換えます。SSL接続が確立されない場合、このパラメーターは無視されます。

• Root certificate フィールドを使用して、SSL認証局を含むファイルを指定します。このファイルはデフォルトの ~/.postgresql/root.crt ファイルを置き換えます。SSL接続が確立されない場合、このパラメーターは無視されます。

• Certificate revocation list フィールドを使用して、SSL証明書失効リストを含むファイルを指定します。このリストは、 ~/.postgresql/root.crl にあるデフォルトのリストを置き換えます。SSL接続が確立されない場合、このパラメーターは無視されます。

• SSL compression? をTrueに設定すると、SSL接続を介して送信されるデータは圧縮されます。デフォルト値は False です（圧縮は無効です）。SSL接続が確立されない場合、このパラメーターは無視されます。

警告

証明書、秘密キー、および失効リストは、PEMサーバープロセスが実行されるユーザーアカウントが所有するサーバー上のユーザーごとのファイルストレージ領域に格納されます。これは、サーバーの管理者がこれらのファイルにアクセスできることを意味します。この機能の使用を選択する前に、適切な注意を払う必要があります。

[作成-サーバー]ダイアログの[SSHトンネル]タブ

SSHトンネリングを設定するには、 SSH Tunnel タブのフィールドを使用します。トンネルを使用して、データベースサーバーを（中間プロキシホストを介して）クライアントが直接接続できないネットワーク上にあるサーバーに接続できます。

• 指定したサーバーに接続するときにPEMがSSHトンネルを使用するように指定するには、 Use SSH tunneling を Yes に設定します。

• Tunnel host フィールドに、SSHホストの名前またはIPアドレス（クライアント接続が転送される）を指定します。

• Tunnel port フィールドにSSHクライアントのポート（クライアント接続が転送される）を指定します。

• Username フィールドにSSHホストのログイン特権を持つユーザーの名前を指定します。

• SSHホストに接続するときに使用される認証のタイプを Authentication フィールドに指定します。

• Password を選択して、PEMがSSHホストへの認証にパスワードを使用することを指定します。これがデフォルトです。

• 接続時にPEMが秘密鍵ファイルを使用することを指定するには、 Identity file を選択します。

• SSHホストが認証用の秘密鍵ファイルを予期している場合、 Identity file フィールドを使用して鍵ファイルの場所を指定します。

• SSHホストがパスワードを要求している場合、 Password フィールドを使用してパスワードを指定するか、IDファイルを使用している場合はパスフレーズを指定します。

[作成-サーバー]ダイアログの[詳細設定]タブ

Advanced タブのフィールドを使用して、サーバーの管理に使用される詳細を指定します。

• Host Address1 フィールドにサーバーホストのIPアドレスを指定します。

• DB restriction フィールドを使用して、pg_database<http://www.postgresql.org/docs/current/interactive/catalog-pg-database.html>`__テーブルに対して使用されるSQL制限を指定しますツリーコントロールに表示されるデータベースを制限します。たとえば、 `'live_db'`` 、 'test_db' と入力して、PEMブラウザに live_db および test_db データベースのみを表示するように指示します。`pg_namespace<http://www.postgresql.org/docs/current/interactive/catalog-pg-namespace.html>`に対する制限を入力することにより、データベースプロパティダイアログからデータベースに表示されるスキーマを制限することもできます。__。

• Use the Password file field to specify the location of a password file (.pgpass). The .pgpass file allows a user to login without providing a password when they connect. It must be present on the PEM Server. For more information, see the Postgres documentation at:

  http://www.postgresql.org/docs/current/static/libpq-pgpass.html

注釈

パスワードファイルの使用は、PEMがlibpqv10.0以降を使用してサーバーに接続している場合にのみサポートされます。

• データベースサービスプロセスを制御するパラメーターを指定するには、 Service ID フィールドを使用します。EnterpriseManagerディレクトリに保存されているサーバーの場合、サービスIDを入力します。Windowsマシンでは、これはWindowsサービスの識別子です。Linuxマシンでは、サーバーの起動に使用されるinitスクリプトの名前は /etc/init.d で、サーバーを起動するsystemdスクリプトの名前はsystemctlです。たとえば、AdvancedServer10サービスの名前は edb-as-10 です。ローカルサーバーの場合、設定はオペレーティングシステムに依存します。

  • PEMクライアントがWindowsマシンで実行されている場合、十分なアクセス権があれば、ポストマスターサービスを制御できます。サービスの名前を入力します。リモートサーバーの場合、マシン名を先頭に追加する必要があります（例:PSE1/pgsql-8.0 ）。PEMは、ローカルマシンで実行されているサービスを自動的に検出します。

  • PEMクライアントがLinuxマシンで実行されている場合、十分なアクセス権があれば、ローカルマシンで実行されているプロセスを制御できます。 pg_ctl プログラムにアクセスするためのフルパスと必要なオプションを提供します。サービス制御機能を実行すると、PEMはこれにstatus/start/stopキーワードを追加します。例:

  sudo /usr/pgsql-x/bin/pg_ctl -D /var/lib/pgsql/x/data ここで、 x はPostgreSQLデータベースサーバーのバージョンです。

• サーバーがFailoverManagerクラスターのメンバーである場合、PEMを使用してクラスターの状態を監視し、必要に応じてマスターノードを交換できます。PEMがフェールオーバーマネージャーを監視できるようにするには、 EFM cluster name フィールドを使用してクラスター名を指定します。クラスター名は、FailoverManagerクラスタープロパティファイルの名前のプレフィックスです。たとえば、クラスタープロパティファイルの名前が efm.properties の場合、クラスター名は efm です。

• PEMを使用してFailoverManagerクラスターのステータスを監視している場合、 EFM installation path フィールドを使用してFailoverManagerバイナリファイルの場所を指定します。デフォルトでは、フェイルオーバーマネージャーのバイナリファイルは /usr/edb/efm-x.x/bin にインストールされます。 x.x はフェイルオーバーマネージャーのバージョンを指定します。

[作成-サーバー]ダイアログの[PEMエージェント]タブ

PEM Agent タブのフィールドを使用して、PEMエージェントの接続の詳細を指定します。

• Bound agent ラベルの右側にあるドロップダウンリストボックスを使用して、EnterpriseManagerエージェントを選択します。1つのエージェントで複数のPostgresサーバーを監視できます。

• Remote monitoring? スライダーを Yes に移動して、PEMエージェントが監視対象サーバーと同じホストにないことを示します。リモート監視が有効になっている場合、監視対象サーバーのエージェントレベルの統計はカスタムチャートとダッシュボードで利用できず、一部のPEMユーティリティ（AuditManager、CapacityManager、LogManager、PostgresExpertなど）からリモートサーバーにアクセスできませんチューニングウィザード）。

• データベースサーバーに接続するときにエージェントが使用するIPアドレスまたはソケットパスを Host フィールドに入力します。デフォルトでは、エージェントは General タブに表示されるホストアドレスを使用します。Unixサーバーでは、ソケットパスを指定できます。 /tmp

• サーバーに接続するときにエージェントが使用する Port 番号を入力します。デフォルトでは、エージェントは Properties タブで定義されたポートを使用します。

• SSL動作モードを指定するには、 SSL フィールドのドロップダウンリストボックスを使用します。require、prefer、allow、disable、verify-ca、またはverify-fullを指定します。SSL暗号化の使用の詳細については、次のPostgreSQLドキュメントを参照してください。

  https://www.enterprisedb.com/edb-docs/d/postgresql/reference/manual/12.1/libpq-ssl.html

• Database フィールドを使用して、エージェントが最初に接続するデータベースの名前を指定します。

• User name フィールドに、サーバーに接続するときにエージェントが使用するロールの名前を指定します。指定されたロールがデータベースのスーパーユーザーでない場合、一部の機能が期待どおりに機能しないことに注意してください。指定したロールがデータベースのスーパーユーザーでない場合に機能しない機能のリストについては、 :ref:`エージェント権限<non_root_user>`を参照してください。

If you are using Postgres version 10 or above, you can use the pg_monitor role to grant the required privileges to a non-superuser. For information about pg_monitor role, see:

https://www.postgresql.org/docs/current/default-roles.html

• サーバーに接続するときにエージェントが使用するパスワードを Password フィールドに指定し、 Confirm password フィールドにもう一度入力して確認します。パスワードを指定しない場合、エージェントの認証を手動で構成する必要があります。たとえば、 .pgpass ファイルを使用できます。このファイルは、エージェントがインストールされているシステム上に存在し、アクセス可能でなければなりません。

• Allow takeover? スライダーを Yes に設定して、サーバーが別のエージェントに引き継がれるように指定します。この機能により、エージェントは、たとえば、高可用性フェイルオーバープロセスの一環としてサーバーが別のホストに移動された場合に、データベースサーバーの監視を行うことができます。

[サーバーの作成]ダイアログ（BART-[全般]タブ）

BART タブの下の General タブのフィールドを使用して、PEMサーバーにマップするBARTサーバーの一般的なプロパティを説明します。

• BART server フィールドを使用して、BARTサーバー名を選択します。PEMコンソールで設定されたすべてのBARTサーバーがこのドロップダウンリストにリストされます。

• Server name フィールドを使用して、BARTサーバーを使用してバックアップするデータベースサーバーの名前を指定します。この名前は、BART構成ファイルに保存されます。

• データベースサーバーのバックアップに割り当てるユーザー定義名のテンプレートを指定するには、 Backup name フィールドを使用します。バックアップ名テンプレートを指定しない場合、バックアップは、BARTに割り当てられた整数のバックアップ識別子によってのみ、BARTサブコマンドで参照できます。

• Host address フィールドを使用して、バックアップ用に構成するデータベースサーバーのIPアドレスを指定します。

• Port フィールドを使用して、バックアップするデータベースに使用するポートを指定します。

• User フィールドを使用して、PEMコンソールからBARTを使用してバックアップするデータベースのユーザーを指定します。このデータベースサーバーの増分バックアップを有効にする場合、ユーザーはスーパーユーザーである必要があります。

• Password フィールドを使用して、バックアップするデータベースのユーザーのパスワードを指定します。

• Cluster Owner フィールドを使用して、データベースクラスターを所有するLinuxオペレーティングシステムのユーザーアカウントを指定します。これは通常、Oracleデータベース互換モードでインストールされたAdvancedServerデータベースクラスターの場合は enterprisedb 、PostgreSQLデータベース互換モードでインストールされたPostgreSQLデータベースクラスターおよびAdvancedServerデータベースクラスターの場合は postgres です。

• Archive command フィールドを使用して、 bart.cfg ファイルで使用するアーカイブコマンド文字列の形式を指定します。アーカイブコマンドに入力すると、データベースサーバーの Postgresql.conf ファイルが上書きされます。サーバーが追加されると、データベースサーバーが再起動されるか、データベース構成が再読み込みされます。

• Allow incremental backup? スイッチを使用して、このデータベースサーバーで増分バックアップを有効にするかどうかを指定します。

• Setup passwordless SSH? スイッチを使用して、データベースサーバーとBARTサーバー間のパスワードレスログインを許可するSSH証明書を作成するかどうかを指定します。パスワードレスSSH認証をセットアップする前に、PEMエージェントをバインドしてください。パスワードなしのSSHは、PEMエージェントによってリモートで監視されているデータベースサーバーでは機能しません。

[作成-サーバー]ダイアログ（BART-[その他]タブ）

BART タブの下の Misc タブのフィールドを使用して、BARTServerのその他のプロパティを説明します。

• Override default configuration? スイッチを使用して、特定のデータベースサーバー構成でBARTサーバー構成を上書きするかどうかを指定します。

• Xlog メソッドを使用して、 pg_basebackup の実行中にトランザクションログを収集する方法を指定します。

• Retention policy フィールドを使用して、バックアップの保持ポリシーを指定します。これにより、アクティブなバックアップが廃止としてマークされ、削除の候補となるタイミングが決定されます。保持ポリシーは、バックアップの数または期間（日、週、または月）で指定できます。

• WAL compression スイッチを使用して、アーカイブされたXlog/WALファイルをGzip形式で圧縮するかどうかを指定します。WAL圧縮を有効にするには、gzip圧縮プログラムがBARTユーザーアカウントのPATHに存在する必要があります。増分バックアップを作成する必要があるデータベースサーバーでは、wal_compression設定を有効にしないでください。

• Copy WALs during restore フィールドを使用して、RESTORE操作を呼び出すときにアーカイブされたWALファイルを収集する方法を指定します。データベースサーバーのアーカイブリカバリの前に、アーカイブされたWALファイルをBARTバックアップカタログから<restore_path>/archived_walsディレクトリにコピーするには、有効に設定します。無効に設定すると、データベースサーバーのアーカイブリカバリ中にBARTバックアップカタログからアーカイブされたWALファイルを直接取得します。

• Thread count フィールドを使用して、ブロックをコピーするスレッドの数を指定します。 pg_basebackup ユーティリティでバックアップを取りたい場合は、 1 を 1 に設定する必要があります。

• Batch size フィールドを使用して、変更されたブロックのコピーに使用されるメモリのブロック数を指定します。これは増分バックアップにのみ適用されます。

• Scan interval フィールドを使用して、WALスキャナーが新しいWALファイルをスキャンするまでの秒数を指定します。

• MBM scan timeout フィールドを使用して、タイムアウトまでMBMファイルを待機する秒数を指定します。これは増分バックアップにのみ適用されます。

サーバーのプロパティを表示するには、PEMクライアントツリーコントロールでサーバー名を右クリックし、コンテキストメニューから Properties… オプションを選択します。サーバーのプロパティを変更するには、 Properties ダイアログを開く前にサーバーから切断します。

自動サーバー検出

監視したいサーバーが監視エージェントと同じホストにある場合、 Auto Discovery ダイアログを使用して登録とバインドのプロセスを簡素化できます。

特定のエージェントの自動検出を有効にするには、 Server Auto Discovery プローブを有効にする必要があります。ManageProbesタブにアクセスするには、PEMクライアントツリーコントロールでPEMエージェントの名前を強調表示し、 Management メニューから Manage Probes... を選択します。 Manage Probes タブが開いたら、 Enabled? 列のスライダーコントロールが Yes に設定されていることを確認します。

Auto Discovery ダイアログを開くには、PEMクライアントツリーコントロールでPEMエージェントの名前を強調表示し、 Management メニューから Auto Discovery... を選択します。

PEM自動検出ダイアログ

Auto Discovery ダイアログが開くと、 Discovered Database Servers ボックスに現在PEMエージェントによって監視されていないサーバーのリストが表示されます。サーバー名の横にあるチェックボックスをオンにして、 Server Connection Details ボックスにサーバーに関する情報を表示し、 Agent Connection Details ボックスにエージェントの接続プロパティを表示します。

表示されたすべてのサーバーの横にあるボックスを選択するには Check All ボタンを使用し、サーバー名の左側にあるすべてのボックスの選択を解除するには Uncheck All を使用します。

Server Connection Details ボックスのフィールドは、PEMが監視するサーバーに関する情報を提供します:

• Name フィールドで監視対象サーバーの名前を受け入れるか変更します。指定した名前は、PEMクライアントのツリーコントロールに表示されます。

• Server group ドロップダウンリストボックスを使用して、サーバーがPEMクライアントツリーコントロールに表示されるサーバーグループを選択します。

• 監視対象サーバーのIPアドレスを指定するには、 Host name/address フィールドを使用します。

• Port フィールドには、サーバーによって監視されているポートが表示されます。このフィールドは変更できません。

• Service ID フィールドにサービスの名前を入力します。一部のPEM機能を有効にするには、サービス名を指定する必要があることに注意してください。

• By default, the Maintenance database field indicates that the selected server uses a Postgres maintenance database. Customize the content of the Maintenance database field for your installation.

Agent Connection Details ボックスのフィールドは、サーバーへの接続時にPEMエージェントが使用するプロパティを指定します。

• Host フィールドには、PEMエージェントのバインドに使用されるIPアドレスが表示されます。

• User name フィールドには、選択したサーバーに接続するときにPEMエージェントが使用する名前が表示されます。

• Password フィールドには、指定されたユーザー名に関連付けられたパスワードが表示されます。

• SSL mode フィールドのドロップダウンリストボックスを使用して、SSL接続設定を指定します。

監視用にバインドしているサーバーの接続プロパティの指定が終了したら、 OK ボタンをクリックしてサーバーを登録します。変更を保存せずに終了するには、 Cancel をクリックします。

登録済みサーバー

OK ボタンをクリックすると、新しく登録されたサーバーがPEMツリーコントロールに表示され、PEMサーバーによって監視されます。

pemworkerユーティリティを使用してサーバーを登録する

You can use the pemworker utility to register a server for monitoring by the PEM server or to unregister a database server. During registration, the pemworker utility will bind the new server to the agent that resides on the system from which you invoked the registration command. To register a server:

Linuxホストでは、次のコマンドを使用します。

pemworker --register-server

Windowsホストでは、次のコマンドを使用します。

pemworker.exe REGISTER-SERVICE

pemworker ユーティリティを呼び出すときに、コマンドラインオプションをコマンド文字列に追加します。各オプションの後には、対応する値が続く必要があります。

オプション	説明
--pem-user	PEM管理ユーザーの名前を指定します。必須です。
--server-addr	サーバーホストのIPアドレス、または完全修飾ドメイン名を指定します。Unixベースのシステムでは、ローカルマシンでデフォルトのPostgreSQLUnixドメインソケットを使用するためにアドレスフィールドを空白のままにするか、PostgreSQLソケットを含む代替パスに設定できます。パスを入力する場合、パスは/で始まる必要があります。必須です。
--server-port	ホストのポート番号を指定します。必須です。
--server-database	サーバーが接続するデータベースの名前を指定します。必須です。
--server-user	サーバーのモニター時にエージェントが使用するユーザーの名前を指定します。必須です。
--server-service-name	登録されるサーバーでの操作（STOP、START、RESTARTなど）を制御するデータベースサービスの名前を指定します。オプション。
--remote-monitoring	--remote-monitoring句とno（デフォルト）の値を含めて、サーバーがPEMエージェントと同じマシンにインストールされていることを示します。リモート監視が有効（yes）の場合、監視対象サーバーのエージェントレベルの統計はカスタムチャートおよびダッシュボードで利用できず、一部のPEMユーティリティ（AuditManager、CapacityManager、LogManager、PostgresExpertandTuningWizard）。必須です。
--efm-cluster-name	サーバーを監視するフェールオーバーマネージャークラスターの名前を指定します（該当する場合）。オプション。
--efm-install-path	フェールオーバーマネージャーのインストールディレクトリへの完全なパスを指定します（該当する場合）。オプション。
--asb-host-name	エージェントが接続しているホストの名前を指定します。
--asb-host-port	データベースに接続するときにエージェントが使用するポート番号を指定します。
--asb-host-db	エージェントが接続するデータベースの名前を指定します。
--asb-host-user	データベースで認証するときにエージェントが提供するデータベースユーザー名を指定します。
--asb-ssl-mode	接続に使用されるSSL認証のタイプを指定します。サポートされる値には、prefer、require、disable、verify-CA、verify-fullなどがあります。
--group	サーバーが表示されるグループの名前を指定します。
--team	サーバーへのアクセスを許可されるグループロールの名前を指定します。
--owner	監視対象サーバーを所有する役割の名前を指定します。

環境変数 PEM_SERVER_PASSWORD を設定してPEMサーバーのパスワードを提供し、pemworkerがPEM管理ユーザーとして接続できるようにします。

環境変数 PEM_MONITORED_SERVER_PASSWORD を設定して、pemagentによって登録および監視されるデータベースサーバーのパスワードを指定します。

パスワードの入力に失敗すると、パスワード認証エラーが発生します。PEMサーバーは、サーバーが適切に登録されたことを確認します。

pemworkerユーティリティを使用してサーバーの登録を解除する

You can use the pemworker utility to unregister a database server; to unregister a server, invoke the pemworker utility:

Linuxホストでは、次のコマンドを使用します。

pemworker --unregister-server

Windowsホストでは、次のコマンドを使用します。

pemworker.exe UNREGISTER-SERVICE

pemworker ユーティリティを呼び出すときに、コマンドラインオプションをコマンド文字列に追加します。各オプションの後には、対応する値が続く必要があります。

オプション	説明
--pem-user	PEM管理ユーザーの名前を指定します。必須です。
--server-addr	サーバーホストのIPアドレス、または完全修飾ドメイン名を指定します。Unixベースのシステムでは、ローカルマシンでデフォルトのPostgreSQLUnixドメインソケットを使用するためにアドレスフィールドを空白のままにするか、PostgreSQLソケットを含む代替パスに設定できます。パスを入力する場合、パスは/で始まる必要があります。必須です。
--server-port	ホストのポート番号を指定します。必須です。

環境変数PEM_SERVER_PASSWORDを設定してPEMサーバーのパスワードを提供し、pemworkerがPEM管理ユーザーとして接続できるようにします。

パスワードの入力に失敗すると、パスワード認証エラーが発生します。PEMサーバーは、サーバーが登録解除されたことを確認します。

接続とバインドの検証

登録すると、新しいサーバーはPEMの Browser ツリーコントロールに追加され、 Global Overview に表示されます。

グローバル概要ダッシュボード

When initially connecting to a newly bound server, the Global Overview dashboard may display the new server with a status of “unknown” in the server list; before recognizing the server, the bound agent must execute a number of probes to examine the server, which may take a few minutes to complete depending on network availability.

数分以内に、 Global Overview ダッシュボードの棒グラフに、エージェントが正常に接続されたことが表示され、新しいサーバーが Postgres Server Status リストに追加されます。

5分経過しても Global Overview ダッシュボードに新しいサーバーが表示されない場合は、監視エージェントのログファイルを確認してエラーを確認する必要があります。ツリーコントロールでエージェントの名前を右クリックし、コンテキストメニューの Dashboards サブメニューから Probe Log Analysis オプションを選択します。