From d86d79ea98f30f853fe544d609eb956d322d52d1 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Thu, 20 Jan 2022 20:36:55 +0100 Subject: [PATCH 01/18] First sketch of a remote setup tutorial --- docs/debian_remote_quickstart.rst | 127 ++++++++++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 docs/debian_remote_quickstart.rst diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst new file mode 100644 index 0000000..2b2caf9 --- /dev/null +++ b/docs/debian_remote_quickstart.rst @@ -0,0 +1,127 @@ +.. _debian_remote_quickstart: + +Remote PoWA Quickstart on Debian +================================ + +.. warning:: + + The current version of PoWA is designed for PostgreSQL 9.4 and newer. If you + want to use PoWA on PostgreSQL < 9.4, please use the `1.x series + `_ + +The following describes the installation of a remote setup of PoWA: + * set up the repository + * set up the PoWA Web UI and nginx web server + * set up the collector + * set up a production PostgreSQL instance + * register the instance in PoWA + +.. note:: + + This document only shows how to set up a **remote PoWA setup** targeted to + monitor the activity of **multiple servers** and/or **standby servers**. It + only shows the set-up on a Debian system. + The document assumes that you use the PGDG repository to install PostgreSQL. + Please refer to https://wiki.postgresql.org/wiki/Apt for more informations. + +Install the PoWA repository +*************************** + +The PoWA repository is a PostgreSQL database that stores: + * the configuration of the remote PostgreSQL instances + * the metrics of the remote PostgreSQL instances + +First, install the required packages: + +.. code-block:: bash + + apt install postgresql-14 postgresql-client-14 postgresql-contrib-14 + apt install postgresql-14-powa postgresql-14-pg-qualstats postgresql-14-pg-stat-kcache postgresql-14-hypopg + +Second, set up an new instance, called powa, running PostgreSQL 14, listening on port 50000: + +.. code-block:: bash + + pg_createcluster 14 powa -p 50000 + +Next, add all required modules to `shared_preload_libraries` in the `postgresql.conf` of the +newly created instance: + +.. code-block:: ini + + shared_preload_libraries='pg_stat_statements,powa,pg_stat_kcache,pg_qualstats' + +Restart the instance, as root or using `sudo` : + +.. code-block:: bash + + systemctl restart postgresql@14-powa.service + +Log in to your PostgreSQL as a superuser and create a `powa` database: + +.. code-block:: sql + + CREATE DATABASE powa ; + +Create the required extensions in this new database: + +.. code-block:: sql + + \c powa + CREATE EXTENSION pg_stat_statements; + CREATE EXTENSION btree_gist; + CREATE EXTENSION powa; + CREATE EXTENSION pg_qualstats; + CREATE EXTENSION pg_stat_kcache; + +.. note:: + + If you also installed the pg_wait_sampling extension, don't forget to + create the extension too. + + +One last step is to create a role that has superuser privileges and is able to +login to the cluster (use your own credentials): + +.. code-block:: sql + + CREATE ROLE powa SUPERUSER LOGIN PASSWORD 'astrongpassword' ; + +The Web UI requires you to log in with a PostgreSQL role that has superuser +privileges as only a superuser can access to the query text in PostgreSQL. PoWA +follows the same principle. + +The PoWA repository is now up and running on the PostgreSQL-side. You still need to +set up the web interface, set up the collector and set up the remote instances +in order to access your history. + +Install and set up the UI (powa-web) +*************************************** + +First, install the PoWA web UI: +.. code-block:: bash + + apt install powa-web + + + +Now, install the Nginx Web Server: +.. code-block:: bash + + apt install nginx-full + + + +Install and set up the collector (powa-collector) +**************************************************** + +.. code-block:: bash + + apt install powa-collector + + +Install and set up a production PostgreSQL instance +*************************************************** + + + From e56ad4d10516597f83f02db97284e5aaabba556b Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Thu, 20 Jan 2022 20:38:13 +0100 Subject: [PATCH 02/18] fixes --- docs/debian_remote_quickstart.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 2b2caf9..017596d 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -99,6 +99,7 @@ Install and set up the UI (powa-web) *************************************** First, install the PoWA web UI: + .. code-block:: bash apt install powa-web @@ -106,6 +107,7 @@ First, install the PoWA web UI: Now, install the Nginx Web Server: + .. code-block:: bash apt install nginx-full From 7a018cc761dc0d4c19aae428cdacf122d54bb321 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 12:14:04 +0100 Subject: [PATCH 03/18] nginx + fixes --- docs/debian_remote_quickstart.rst | 56 ++++++++++++++++++++++++++++--- 1 file changed, 51 insertions(+), 5 deletions(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 017596d..e3ae33a 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -18,15 +18,28 @@ The following describes the installation of a remote setup of PoWA: .. note:: - This document only shows how to set up a **remote PoWA setup** targeted to + This document only shows how to set up **PoWA in remote mode** targeted to monitor the activity of **multiple servers** and/or **standby servers**. It only shows the set-up on a Debian system. The document assumes that you use the PGDG repository to install PostgreSQL. Please refer to https://wiki.postgresql.org/wiki/Apt for more informations. +Architecture +************ + +As the goal of this document is to present how to set up PoWA in remote mode with +multiple PostgreSQL servers monitored, here is the topology of our network : +Servers : + * powa, PoWA repository and Web Server for the UI + * pgsrv1, PostgreSQL database server #1 + * pgsrv2, PostgreSQL database server #2 + + Install the PoWA repository *************************** +This step is to be done on server named powa. + The PoWA repository is a PostgreSQL database that stores: * the configuration of the remote PostgreSQL instances * the metrics of the remote PostgreSQL instances @@ -98,32 +111,65 @@ in order to access your history. Install and set up the UI (powa-web) *************************************** +This step is to be done on server named powa. + First, install the PoWA web UI: .. code-block:: bash apt install powa-web - - Now, install the Nginx Web Server: .. code-block:: bash apt install nginx-full +Edit the default nginx server configuration, file `/etc/nginx/sites-enabled/default`. +Let's add a new location `/powa` in the `server` configuration. + +.. code-block:: ini + + server { + listen 80 default_server; + listen [::]:80 default_server; + (...) + location /powa { + include proxy_params; + proxy_pass http://localhost:9999; + } + (...) + +Check the new configuration: +.. code-block:: bash + + nginx -t + + +Reload nginx: +.. code-block:: bash + + systemctl reload nginx.service Install and set up the collector (powa-collector) **************************************************** +This step is to be done on server named powa. + .. code-block:: bash apt install powa-collector -Install and set up a production PostgreSQL instance -*************************************************** +Install and set up a PostgreSQL instance +**************************************** + +This step is to be done on server pgsrv1 + +Add another PostgreSQL instance +******************************* +This step is to be done on server pgsrv2 From 3a474cb3f7980dffe34a4469d55a911f61298775 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 12:14:51 +0100 Subject: [PATCH 04/18] Fix --- docs/debian_remote_quickstart.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index e3ae33a..d22694c 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -29,7 +29,7 @@ Architecture As the goal of this document is to present how to set up PoWA in remote mode with multiple PostgreSQL servers monitored, here is the topology of our network : -Servers : +Servers: * powa, PoWA repository and Web Server for the UI * pgsrv1, PostgreSQL database server #1 * pgsrv2, PostgreSQL database server #2 From 5f9a923b3b4fdd85f4ece751a897e65742702441 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 13:47:51 +0100 Subject: [PATCH 05/18] More steps --- docs/debian_remote_quickstart.rst | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index d22694c..9b1cefb 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -119,6 +119,25 @@ First, install the PoWA web UI: apt install powa-web +Let's edit `/etc/powa-web.conf` to point to the repository database: + +.. code-block:: python + servers={ + 'main': { + 'host': '/var/run/postgresql', + 'port': '50000', + 'database': 'powa', + 'query': {'client_encoding': 'utf8'} + } + } + cookie_secret="ed2xoow8shet3eiyai4Odo2OTama2y" + url_prefix="/powa" + port=9999 + address='127.0.0.1' + +The powa-web Web daemon will listen on localhost, on port 9999. The UI will be accessible +under `/powa`. + Now, install the Nginx Web Server: .. code-block:: bash @@ -145,12 +164,23 @@ Check the new configuration: nginx -t +It should give the following output: + +.. code-block:: + + nginx: the configuration file /etc/nginx/nginx.conf syntax is ok + nginx: configuration file /etc/nginx/nginx.conf test is successful Reload nginx: .. code-block:: bash systemctl reload nginx.service +Now, the UI throught can be accessed throught the following URL: http://powa/powa/ + +To log in, remind the previous creation of user `powa` with password `astrongpassword`. + + Install and set up the collector (powa-collector) **************************************************** From c69d978ad14068b32a551d15a1a5e5628db90f24 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 13:48:22 +0100 Subject: [PATCH 06/18] just one fix --- docs/debian_remote_quickstart.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 9b1cefb..5fc4129 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -172,6 +172,7 @@ It should give the following output: nginx: configuration file /etc/nginx/nginx.conf test is successful Reload nginx: + .. code-block:: bash systemctl reload nginx.service From 52de8442da89a5b4cc862a49b2aca917e6bfebe6 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 13:59:54 +0100 Subject: [PATCH 07/18] powa-collector config --- docs/debian_remote_quickstart.rst | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 5fc4129..cbb041a 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -30,7 +30,7 @@ Architecture As the goal of this document is to present how to set up PoWA in remote mode with multiple PostgreSQL servers monitored, here is the topology of our network : Servers: - * powa, PoWA repository and Web Server for the UI + * powasrv, PoWA repository and Web Server for the UI * pgsrv1, PostgreSQL database server #1 * pgsrv2, PostgreSQL database server #2 @@ -38,7 +38,7 @@ Servers: Install the PoWA repository *************************** -This step is to be done on server named powa. +This step is to be done on server named powasrv. The PoWA repository is a PostgreSQL database that stores: * the configuration of the remote PostgreSQL instances @@ -111,7 +111,7 @@ in order to access your history. Install and set up the UI (powa-web) *************************************** -This step is to be done on server named powa. +This step is to be done on server named powasrv. First, install the PoWA web UI: @@ -160,6 +160,7 @@ Let's add a new location `/powa` in the `server` configuration. (...) Check the new configuration: + .. code-block:: bash nginx -t @@ -177,7 +178,7 @@ Reload nginx: systemctl reload nginx.service -Now, the UI throught can be accessed throught the following URL: http://powa/powa/ +Now, the UI throught can be accessed throught the following URL: http://powasrv/powa/ To log in, remind the previous creation of user `powa` with password `astrongpassword`. @@ -186,12 +187,22 @@ To log in, remind the previous creation of user `powa` with password `astrongpas Install and set up the collector (powa-collector) **************************************************** -This step is to be done on server named powa. +This step is to be done on server named powasrv. .. code-block:: bash apt install powa-collector +Configure the collector to connect to our repository: + +.. code-block:: python + + { + "repository": { + "dsn": "postgresql://powa:astrongpassword@powasrv:50000/powa" + }, + "debug": false + } Install and set up a PostgreSQL instance **************************************** From 49a8a746bbec930f5e7736f1527a6643b6bf7554 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 14:37:01 +0100 Subject: [PATCH 08/18] More work --- docs/debian_remote_quickstart.rst | 96 +++++++++++++++++++++++++++++-- 1 file changed, 90 insertions(+), 6 deletions(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index cbb041a..4b498d0 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -29,10 +29,8 @@ Architecture As the goal of this document is to present how to set up PoWA in remote mode with multiple PostgreSQL servers monitored, here is the topology of our network : -Servers: * powasrv, PoWA repository and Web Server for the UI * pgsrv1, PostgreSQL database server #1 - * pgsrv2, PostgreSQL database server #2 Install the PoWA repository @@ -90,7 +88,7 @@ Create the required extensions in this new database: .. note:: If you also installed the pg_wait_sampling extension, don't forget to - create the extension too. + modify the shared_preload_libraries accordingly and create the extension too. One last step is to create a role that has superuser privileges and is able to @@ -204,14 +202,100 @@ Configure the collector to connect to our repository: "debug": false } +Now enable and restart the service: + +.. code-block:: bash + + systemctl enable powa-collector + systemctl restart powa-collector + +Please visit the configuration page of PoWA to check that the collector is connected: http://powasrv/powa/config/ + + Install and set up a PostgreSQL instance **************************************** This step is to be done on server pgsrv1 -Add another PostgreSQL instance -******************************* +First, install the required packages: + +.. code-block:: bash + + apt install postgresql-14 postgresql-client-14 postgresql-contrib-14 + apt install postgresql-14-powa postgresql-14-pg-qualstats postgresql-14-pg-stat-kcache postgresql-14-hypopg + +Second, set up an new instance, called powa, running PostgreSQL 14, listening on port 50000: + +.. code-block:: bash + + pg_createcluster 14 inst1 -p 30001 + +Next, add all required modules to `shared_preload_libraries` in the `postgresql.conf` of the +newly created instance: + +.. code-block:: ini + + shared_preload_libraries='pg_stat_statements,powa,pg_stat_kcache,pg_qualstats' + +Modify file `/etc/postgresql/14/inst1/pg_hba.conf` to permit access to the postgres database to +you powa. Add the following line at the end of the file: + +.. code-block:: ini + + host postgres powa /32 md5 + +Restart the instance, as root or using `sudo` : + +.. code-block:: bash + + systemctl restart postgresql@14-inst1.service + +Log in to your PostgreSQL as a superuser and create a `powa` database: + +.. code-block:: sql + +Create the required extensions in this new database: + +.. code-block:: sql + + \c postgres + CREATE EXTENSION pg_stat_statements; + CREATE EXTENSION btree_gist; + CREATE EXTENSION powa; + CREATE EXTENSION pg_qualstats; + CREATE EXTENSION pg_stat_kcache; + +One last step is to create a role that has superuser privileges and is able to +login to the cluster (use your own credentials): + +.. code-block:: sql + + CREATE ROLE powa SUPERUSER LOGIN PASSWORD 'astrongpassword' ; + +As a final step, get back on `powasrv`, register the instance: + +.. code-block:: bash + + psql -d powa -c "SELECT powa_register_server(hostname => 'pgsrv1', + port => 30001, + alias => 'inst1', + username => 'powa', + password => 'astrongpassword', + dbname => 'postgres', + retention => '7 days', + extensions => '{pg_stat_kcache,pg_qualstats}');" + +And finally, reload the collector: +.. code-block:: bash -This step is to be done on server pgsrv2 + systemctl reload powa-collector + +.. note:: + + If you also installed the pg_wait_sampling extension, don't forget to + modify the shared_preload_libraries accordingly and create the extension. + Don't forget to add the pg_wait_sampling extension in the extension list of + the register function call. +Repeat this steps for any other PostgreSQL instance you want to monitor with PoWA. From 61d0e113bbcaada1ef36a66edae6c52b555019e2 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 14:37:44 +0100 Subject: [PATCH 09/18] Fix --- docs/debian_remote_quickstart.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 4b498d0..0441934 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -286,6 +286,7 @@ As a final step, get back on `powasrv`, register the instance: extensions => '{pg_stat_kcache,pg_qualstats}');" And finally, reload the collector: + .. code-block:: bash systemctl reload powa-collector From 82a1739cc296892ec0dcc783202d3d499fda3f83 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 17:54:39 +0100 Subject: [PATCH 10/18] Moar fixes --- docs/debian_remote_quickstart.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 0441934..f30e219 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -10,11 +10,11 @@ Remote PoWA Quickstart on Debian `_ The following describes the installation of a remote setup of PoWA: - * set up the repository - * set up the PoWA Web UI and nginx web server - * set up the collector - * set up a production PostgreSQL instance - * register the instance in PoWA +* set up the repository +* set up the PoWA Web UI and nginx web server +* set up the collector +* set up a production PostgreSQL instance +* register the instance in PoWA .. note:: @@ -39,8 +39,8 @@ Install the PoWA repository This step is to be done on server named powasrv. The PoWA repository is a PostgreSQL database that stores: - * the configuration of the remote PostgreSQL instances - * the metrics of the remote PostgreSQL instances +* the configuration of the remote PostgreSQL instances +* the metrics of the remote PostgreSQL instances First, install the required packages: From efbebcf87fd87ddf076f82ce8a58f4ad51b6826a Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 17:54:48 +0100 Subject: [PATCH 11/18] Link to the new debian remote quickstart guide in the index. --- docs/index.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/index.rst b/docs/index.rst index 7088e2c..6d2da37 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -50,7 +50,9 @@ Main components * **Stat extensions** are the actual source of data. * **PoWA** is the whole project. -You should first take a look at the :ref:`quickstart` guide. +You should first take a look at the :ref:`quickstart` guide. If you're more interested +in setting up PoWA in remote mode, take a look at the :ref:`debian_remote_quickstart` +guide. .. toctree:: From f7eb8a3e23d8b80091080951c0a9ba50c4432eb6 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 17:55:35 +0100 Subject: [PATCH 12/18] Fix again ... --- docs/debian_remote_quickstart.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index f30e219..26018d8 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -28,7 +28,7 @@ Architecture ************ As the goal of this document is to present how to set up PoWA in remote mode with -multiple PostgreSQL servers monitored, here is the topology of our network : +multiple PostgreSQL servers monitored, here is the topology of our network: * powasrv, PoWA repository and Web Server for the UI * pgsrv1, PostgreSQL database server #1 From a64a8c6230f78c0d3c9e9a2365574ace01cf7345 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 17:56:01 +0100 Subject: [PATCH 13/18] Trying to fix the bullet list --- docs/debian_remote_quickstart.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 26018d8..b6f99d4 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -32,7 +32,6 @@ multiple PostgreSQL servers monitored, here is the topology of our network: * powasrv, PoWA repository and Web Server for the UI * pgsrv1, PostgreSQL database server #1 - Install the PoWA repository *************************** From d0d063443a37c19ecc6674a8bb6e040eb0f6f0bd Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 17:57:33 +0100 Subject: [PATCH 14/18] Fix port number --- docs/debian_remote_quickstart.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index b6f99d4..b0eced9 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -223,7 +223,7 @@ First, install the required packages: apt install postgresql-14 postgresql-client-14 postgresql-contrib-14 apt install postgresql-14-powa postgresql-14-pg-qualstats postgresql-14-pg-stat-kcache postgresql-14-hypopg -Second, set up an new instance, called powa, running PostgreSQL 14, listening on port 50000: +Second, set up an new instance, called powa, running PostgreSQL 14, listening on port 30001: .. code-block:: bash From 47041de04d38e3626e12cbb93b2ee747b5d04d72 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 17:58:25 +0100 Subject: [PATCH 15/18] Commit de la honte --- docs/debian_remote_quickstart.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index b0eced9..354a571 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -10,11 +10,11 @@ Remote PoWA Quickstart on Debian `_ The following describes the installation of a remote setup of PoWA: -* set up the repository -* set up the PoWA Web UI and nginx web server -* set up the collector -* set up a production PostgreSQL instance -* register the instance in PoWA + * set up the repository + * set up the PoWA Web UI and nginx web server + * set up the collector + * set up a production PostgreSQL instance + * register the instance in PoWA .. note:: From 7ea1cb224cb6de6972cabb1465ffb1d2d5dc925f Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 17:59:47 +0100 Subject: [PATCH 16/18] Edit --- docs/debian_remote_quickstart.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 354a571..4843b3e 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -5,7 +5,7 @@ Remote PoWA Quickstart on Debian .. warning:: - The current version of PoWA is designed for PostgreSQL 9.4 and newer. If you + _The current version of PoWA is designed for PostgreSQL 9.4 and newer. If you want to use PoWA on PostgreSQL < 9.4, please use the `1.x series `_ @@ -18,11 +18,11 @@ The following describes the installation of a remote setup of PoWA: .. note:: - This document only shows how to set up **PoWA in remote mode** targeted to + _This document only shows how to set up **PoWA in remote mode** targeted to monitor the activity of **multiple servers** and/or **standby servers**. It only shows the set-up on a Debian system. The document assumes that you use the PGDG repository to install PostgreSQL. - Please refer to https://wiki.postgresql.org/wiki/Apt for more informations. + Please refer to https://wiki.postgresql.org/wiki/Apt for more informations._ Architecture ************ @@ -292,10 +292,10 @@ And finally, reload the collector: .. note:: - If you also installed the pg_wait_sampling extension, don't forget to + _If you also installed the pg_wait_sampling extension, don't forget to modify the shared_preload_libraries accordingly and create the extension. Don't forget to add the pg_wait_sampling extension in the extension list of - the register function call. + the register function call._ Repeat this steps for any other PostgreSQL instance you want to monitor with PoWA. From bcb2eebf08f26c1cefa6c0153b41c15b5a2c0861 Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 18:00:14 +0100 Subject: [PATCH 17/18] Revert "Edit" This reverts commit 7ea1cb224cb6de6972cabb1465ffb1d2d5dc925f. --- docs/debian_remote_quickstart.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 4843b3e..354a571 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -5,7 +5,7 @@ Remote PoWA Quickstart on Debian .. warning:: - _The current version of PoWA is designed for PostgreSQL 9.4 and newer. If you + The current version of PoWA is designed for PostgreSQL 9.4 and newer. If you want to use PoWA on PostgreSQL < 9.4, please use the `1.x series `_ @@ -18,11 +18,11 @@ The following describes the installation of a remote setup of PoWA: .. note:: - _This document only shows how to set up **PoWA in remote mode** targeted to + This document only shows how to set up **PoWA in remote mode** targeted to monitor the activity of **multiple servers** and/or **standby servers**. It only shows the set-up on a Debian system. The document assumes that you use the PGDG repository to install PostgreSQL. - Please refer to https://wiki.postgresql.org/wiki/Apt for more informations._ + Please refer to https://wiki.postgresql.org/wiki/Apt for more informations. Architecture ************ @@ -292,10 +292,10 @@ And finally, reload the collector: .. note:: - _If you also installed the pg_wait_sampling extension, don't forget to + If you also installed the pg_wait_sampling extension, don't forget to modify the shared_preload_libraries accordingly and create the extension. Don't forget to add the pg_wait_sampling extension in the extension list of - the register function call._ + the register function call. Repeat this steps for any other PostgreSQL instance you want to monitor with PoWA. From f25a8e21d678974ede98e88ca3c83570c8b8badd Mon Sep 17 00:00:00 2001 From: Thomas Reiss Date: Fri, 21 Jan 2022 18:00:42 +0100 Subject: [PATCH 18/18] another one --- docs/debian_remote_quickstart.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/debian_remote_quickstart.rst b/docs/debian_remote_quickstart.rst index 354a571..9ce09d4 100644 --- a/docs/debian_remote_quickstart.rst +++ b/docs/debian_remote_quickstart.rst @@ -7,7 +7,7 @@ Remote PoWA Quickstart on Debian The current version of PoWA is designed for PostgreSQL 9.4 and newer. If you want to use PoWA on PostgreSQL < 9.4, please use the `1.x series - `_ + `. The following describes the installation of a remote setup of PoWA: * set up the repository