Linux systems¶
要件¶
Glibc 2.5以降
PostgresとBDR3レポート¶
ユーザーpostgresとして、Lassoバイナリをフォルダーにコピーします。
重要
Postgresサーバープロセスを実行するのと同じユーザーがコマンドを実行する必要があります。ユーザーは、現在の作業ディレクトリに書き込む権限を持っている必要があります。
標準のLassoランは以下で構成されます。
./lasso
Lassoは、現在の作業ディレクトリに出力ファイルを書き込みます。
警告
Lassoは一時ディレクトリからファイルを実行する必要があります。システムの一時ディレクトリが noexec フラグでマウントされている場合、次のエラーが発生します。
./lasso: error while loading shared libraries:
libz.so.1: failed to map segment from shared object:
Operation not permitted
その場合、 TMPDIR
環境変数を使用して、別の一時ファイルの場所を指定できます。
TMPDIR=/some/alternate/tmp/location ./lasso`
重要
ローカルインスタンスで実行する場合、 LassoにはPostgres 10以降で使用可能なpg_monitorロールに属するユーザーが必要です。 10より前は、スーパーユーザーとして実行する必要があります。詳細については、PostgreSQLドキュメントの Default Roles を参照してください。
Lassoは、サポートされているすべてのバージョンのEDB Postgres Distributed（PGD）およびpglogicalに関連する情報を透過的に収集します。
Barmanレポート¶
Lassoは、 Barmanがインストールされているシステムで実行できます。その場合、分析中に役立つバーマン関連の情報とシステム情報を収集します。
ユーザーbarmanとして、Lassoバイナリをフォルダーにコピーします。
重要
Barmanプロセスを実行するのと同じユーザーとしてコマンドを実行する必要があり、現在の作業ディレクトリに書き込むための十分な権限が必要です。 RPM/DEBパッケージを使用してBarmanをインストールした場合、 Barmanはユーザーbarmanとして実行するように構成されます。
Lassoがbarmanユーザーとして実行され、予想される場所、通常は/etc/barman.conf
で構成ファイルを探す場合、
Barmanレポートはデフォルトで有効になっています。詳細については、man 5 barman
と入力してください。
一般に、 EDB認定のRPMおよびDEBパッケージを使用してBarmanをインストールした場合、必要なのはbarmanユーザーとしてLassoを実行することだけです。
Barmanのカスタムインストールの管理¶
Barmanのカスタムインストールがある場合 、 --barman
オプションをLassoに渡すことで、 barmanレポートを有効にできます。
./lasso --barman
次のように--barman-configuration
オプションを使用して、特定のグローバル構成ファイルを指すこともできます。
./lasso --barman-configuration /opt/barman/barman.conf
Replication Manger（repmgr）レポート¶
Lassoは、 repmgrがインストールされているシステムで実行できます。その場合、repmgr関連の情報を収集します。
一般に、EDB認定のRPMおよびDEBパッケージを使用してrepmgrをインストールした場合、必要なのはLassoを実行することだけです。
Lassoがrepmgr構成ファイルを見つける方法¶
Lassoは、repmgr構成ファイルを識別しようとするときに次のアプローチを使用します。最初に見つけたものを使用します。
--repmgr-configurationオプションが指定されている場合、それを介して提供されたものを使用します。
2.パッケージが提供するパスを確認します。たとえば、CentOS /
RHELパッケージでは、構成ファイルは通常/etc/repmgr/<PG_VERSION>/repmgr.conf
の下に置かれます。
Lassoは、これらのフォルダーが存在する場合は降順で検査し、見つかった最初のrepmgr構成ファイルを使用します。
3.現在のディレクトリにrepmgr.conf
ファイルが存在するかどうかを確認します。
/etc/repmgr.confファイルが存在するかどうかを確認します。repmgr.confファイルのpg_config --sysconfdirで指定されたパスを確認します。systemctl cat <service_name>の出力を確認します。<service_name>は、名前にrepmgrが含まれるサービスです。サービスユニットファイルからrepmgr.confファイルを取得しようとします。アプローチ2と同じように、ユニットを降順でチェックし、最初に一致したものを使用します。
repmgrのカスタムインストールの管理¶
次のように--repmgr-configuration
オプションを使用して、特定のrepmgr構成ファイルをポイントできます。
./lasso --repmgr-configuration /opt/repmgr/repmgr.conf
Lassoが自動的に見つけようとするのではなく、正しいrepmgr構成ファイルを使用することが保証されるため、このアプローチが推奨されます。
Postres Enterprise Manager（PEM）レポート¶
Lassoは、PEMがインストールされているシステムで実行できます。その場合、いくつかの構成ファイルやサービスに関する情報など、PEM関連の情報も収集します。
Lassoは、構成ファイルの既知のパスと、既知のサービス名を検査します。カスタムPEMインストールがある場合、Lassoは関連情報を収集しません。
フェールオーバーマネージャー（EFM）レポート¶
Lassoは、EFMがインストールされているシステムで実行できます。その場合、EFM関連の情報を収集します。
一般に、EDB認定のRPMおよびDEBパッケージを使用してEFMをインストールした場合、必要なのはLassoを実行することだけです。
LassoがEFM構成ファイルを見つける方法¶
Lassoは、EFM構成ファイルを識別しようとするときに次のアプローチを使用します。最初に見つけたものを使用します。
--efm-configurationオプションが指定されている場合、それを介して提供されたものを使用します。
2.パッケージが提供するパスを確認します。構成ファイルは通常/etc/edb/efm-<EFM_VERSION>/efm.properties
の下に置かれます。
Lassoは、これらのフォルダーが存在する場合は降順で検査し、見つかった最初のEFM構成ファイルを使用します。
systemctl cat <service_name>の出力を確認します。<service_name>は、名前がedb-efm-で始まるサービスに置き換えられます。次に、サービスユニットファイルからefm.propertiesファイルを取得しようとします。アプローチ2と同じように、ユニットを降順でチェックし、最初に一致したものを使用します。
LassoがEFMバイナリを見つける方法¶
Lassoは、パッケージが提供するパスを検査します。バイナリファイルは通常/usr/edb/efm-<EFM_VERSION>/bin/efm
の下に置かれます。
Lassoは、これらのフォルダーが存在する場合は降順で検査し、検出した最初のEFMバイナリファイルを使用します。
EFMのカスタムインストールの管理¶
次のように--efm-configuration
オプションを使用して、特定のEFM構成ファイルをポイントできます。
./lasso --efm-configuration /opt/EFM/efm.properties
Lassoが自動的に見つけようとするのではなく、正しいEFM構成ファイルを使用することが保証されるため、このアプローチが推奨されます。
Replication Server（xDB）レポート¶
Lassoは、xDBがインストールされているシステムで実行できます。その場合、xDB関連の情報を収集します。
一般に、EDB認定のRPMパッケージまたはbitrockインストーラーを使用してxDBをインストールした場合、必要なのはLassoを実行することだけです。
LassoがxDB構成ファイルを見つける方法¶
Lassoは、xDB構成ファイルを識別しようとするときに次のアプローチを使用します。最初に見つけたものを使用します。
--xdb-pubserver-configurationおよび--xdb-subserver-configurationオプションが指定されている場合、それらを介して提供されたものを使用します。xDB 7 RPMパッケージとbitrockインストーラーによって提供されるパスを確認します。構成ファイルは通常
/etc/edb/xdb/etcの下に置かれます。 Lassoは、このフォルダーが存在する場合は検査し、そのフォルダーの下にあるxdb_pubserver.confおよびxdb_subserver.confファイルを使用します。xDB 6 RPMパッケージとbitrockインストーラーによって提供されるパスを確認します。通常、これはそれぞれ
/usr/ppas-xdb-<XDB_VERSION>/etcおよび/opt/PostgreSQL/EnterpriseDB-xDBReplicationServer/etcです。 Lassoはこれらのフォルダーを検査し、存在する場合は、フォルダーの下にあるxdb_pubserver.confおよびxdb_subserver.confファイルを使用します。 RPMパッケージの場合、フォルダーがたくさんある可能性があるため、最新のXDBバージョンから最も古いものまで検査されます。
LassoがxDBバイナリを見つける方法¶
Lassoは、xDBバイナリファイルを識別しようとしているときに、次のアプローチを使用します。最初に見つけたものを使用します。
xDB 7 RPMパッケージとbitrockインストーラーが提供するパスを確認します。バイナリファイルは通常
/etc/edb/xdb/binの下に置かれます。 Lassoは、このフォルダーが存在する場合は検査し、そのフォルダーの下にあるedb-repcli.jarファイルを使用します。xDB 6 RPMパッケージとbitrockインストーラー、通常はそれぞれ
/usr/ppas-xdb-<XDB_VERSION>/binと/opt/PostgreSQL/EnterpriseDB-xDBReplicationServer/binによって提供されるパスを確認します。 Lassoはこれらのフォルダーを検査し、存在する場合は、フォルダーの下にあるedb-repcli.jarファイルを使用します。 RPMパッケージの場合、フォルダーがたくさんある可能性があるため、最新のXDBバージョンから最も古いものまで検査されます。
EFMのカスタムインストールの管理¶
次のように--xdb-pubserver-configuration
および--xdb-subserver-configuration
オプションを使用して、特定のxDBパブリケーションまたはサブスクリプションサーバー構成ファイルをポイントできます。
./lasso --xdb-pubserver-configuration /opt/xDB/pubserver.conf --xdb-subserver-configuration /opt/xDB/subserver.conf
Lassoが自動的に見つけようとするのではなく、正しいxDB構成ファイルを使用することが保証されるため、このアプローチが推奨されます。
PgBouncerレポート¶
Lassoは、PgBouncerがインストールされているシステムで実行できます。その場合、PgBouncer関連の情報を収集します。
一般に、EDB認定のRPMおよびDEBパッケージを使用してPgBouncerをインストールし、PgBouncerインスタンスが稼働している場合、必要なのはLassoを実行することだけです。
LassoがPgBouncer構成ファイルを見つける方法¶
Lassoは、実行中のプロセスのリストを使用してPgBouncerプロセスを識別し、そこから取得した構成ファイルを使用します。
Lasso引数--pgbouncer-configuration
を介して、1つ以上のPgBouncer構成ファイルを指定することもできます。これは、主にPgBouncerインスタンスが実行されていないシナリオ、またはLassoがプロセスリストから構成ファイルを検出できない場合に役立ちます。
Lassoは、識別されたすべてのPgBouncerインスタンスから情報を収集します。
HARPレポート¶
Lassoは、 HARPがインストールされているシステムで実行できます。その場合、 HARP関連の情報を収集します。
一般に、EDB認定のRPMおよびDEBパッケージを使用してHARPをインストールした場合、必要なのはLassoを実行することだけです。
LassoがHARP構成ファイルを見つける方法¶
Lassoは、 HARP構成ファイルを識別しようとするときに次のアプローチを使用します。最初に見つけたものを使用します。
--harp-configurationオプションが指定されている場合、それを介して提供されたものを使用します。/etc/harp/config.ymlファイルが存在するかどうかを確認します。
HARPのカスタムインストールの管理¶
次のように--harp-configuration
オプションを使用して、特定のHARP構成ファイルをポイントできます。
./lasso --harp-configuration /opt/harp/config.yml
Lassoが自動的に見つけようとするのではなく、正しいHARP構成ファイルを使用することが保証されるため、このアプローチが推奨されます。
HARPプロキシノードでLassoを実行する¶
HARPプロキシノードは、アプリケーションからの接続のプロキシとしてのみ意図されているため、PostgresまたはEDB Postgres Advanced Serverサービスを実行していません。
Lassoを使用してHARPプロキシノードから情報を収集する場合、
--system-only
オプションを使用して、データベースサーバーに接続しようとしないようにする必要があります。
etcdレポート¶
Lassoは、etcdがインストールされているシステムで実行できます。その場合、etcd関連の情報を収集します。
Lassoがetcd構成ファイルを見つける方法¶
Lassoは、etcd構成ファイルを識別しようとするときに次のアプローチを使用します。最初に見つけたものを使用します。
--etcd-configurationオプションが指定されている場合、提供されたものを使用します。/etc/etcd/etcd.confファイルが存在するかどうかを確認します。
システムのみのレポート¶
Lassoは、PostgresまたはBarmanがインストールされていないシステムでも実行して、基になるオペレーティングシステムに関するすべての関連情報を収集することもできます。
次のコマンドを使用して、システムのみのレポートを実行できます。
./lasso --system-only
