From 5c3e033ac5f461f6d0c8e1e281cdd56166f39d59 Mon Sep 17 00:00:00 2001 From: Anastasia Alexandrova Date: Wed, 29 Nov 2023 17:07:27 +0100 Subject: [PATCH] DISTPG-633 Updated install instructions with renamed packages (#478) DISTPG-633 Updated package names for YUM install instructions modified: docs/apt.md modified: docs/solutions/postgis-deploy.md modified: docs/yum.md --- docs/apt.md | 14 +++++++------- docs/solutions/postgis-deploy.md | 19 ++++++++++--------- docs/yum.md | 24 ++++++++++++------------ 3 files changed, 29 insertions(+), 28 deletions(-) diff --git a/docs/apt.md b/docs/apt.md index 051d6598f..73d8ffbf9 100644 --- a/docs/apt.md +++ b/docs/apt.md @@ -38,7 +38,7 @@ Run all the commands in the following sections as root or using the `sudo` comma Percona provides [two repositories](repo-overview.md) for Percona Distribution for PostgreSQL. We recommend enabling the Major release repository to timely receive the latest updates. ```{.bash data-prompt="$"} - $ sudo percona-release setup ppg-16 + $ sudo percona-release setup ppg-{{pgversion}} ``` ### Install packages @@ -48,7 +48,7 @@ Run all the commands in the following sections as root or using the `sudo` comma The [meta package](repo-overview.md#percona-ppg-server){:target=”_blank”} enables you to install several components of the distribution in one go. ```{.bash data-prompt="$"} - $ sudo apt install percona-ppg-server-16 + $ sudo apt install percona-ppg-server-{{pgversion}} ``` === "Install packages individually" @@ -56,7 +56,7 @@ Run all the commands in the following sections as root or using the `sudo` comma 1. Install the PostgreSQL server package: ```{.bash data-prompt="$"} - $ sudo apt install percona-postgresql-16 + $ sudo apt install percona-postgresql-{{pgversion}} ``` 2. Install the components: @@ -64,13 +64,13 @@ Run all the commands in the following sections as root or using the `sudo` comma Install `pg_repack`: ```{.bash data-prompt="$"} - $ sudo apt install percona-postgresql-16-repack + $ sudo apt install percona-postgresql-{{pgversion}}-repack ``` Install `pgAudit`: ```{.bash data-prompt="$"} - $ sudo apt install percona-postgresql-16-pgaudit + $ sudo apt install percona-postgresql-{{pgversion}}-pgaudit ``` Install `pgBackRest`: @@ -97,7 +97,7 @@ Run all the commands in the following sections as root or using the `sudo` comma Install `pgAudit-set_user`: ```{.bash data-prompt="$"} - $ sudo apt install percona-pgaudit16-set-user + $ sudo apt install percona-pgaudit{{pgversion}}-set-user ``` Install `pgBadger`: @@ -109,7 +109,7 @@ Run all the commands in the following sections as root or using the `sudo` comma Install `wal2json`: ```{.bash data-prompt="$"} - $ sudo apt install percona-postgresql-16-wal2json + $ sudo apt install percona-postgresql-{{pgversion}}-wal2json ``` Install PostgreSQL contrib extensions: diff --git a/docs/solutions/postgis-deploy.md b/docs/solutions/postgis-deploy.md index 574b91f0b..e36700143 100644 --- a/docs/solutions/postgis-deploy.md +++ b/docs/solutions/postgis-deploy.md @@ -17,7 +17,7 @@ The following document provides guidelines how to install PostGIS and how to run As other components of Percona Distribution for PostgreSQL, PostGIS is available from Percona repositories. Use the [`percona-release`](https://docs.percona.com/percona-software-repositories/installing.html) repository management tool to enable the repository. ```{.bash data-prompt="$"} - $ sudo percona-release setup ppg16 + $ sudo percona-release setup ppg{{pgversion}} ``` 2. Install PostGIS packages @@ -45,27 +45,28 @@ The following document provides guidelines how to install PostGIS and how to run 1. Check the [Platform specific notes](../yum.md#for-postgis) and enable required repositories and modules for the dependencies relevant to your operating system. - 2. Enable Percona repository + 2. Enable Percona repository - As other components of Percona Distribution for PostgreSQL, PostGIS is available from Percona repositories. Use the [`percona-release`](https://docs.percona.com/percona-software-repositories/installing.html) repository management tool to enable the repository. + As other components of Percona Distribution for PostgreSQL, PostGIS is available from Percona repositories. Use the [`percona-release`](https://docs.percona.com/percona-software-repositories/installing.html) repository management tool to enable the repository. ```{.bash data-prompt="$"} - $ sudo percona-release setup ppg16 - ``` + $ sudo percona-release setup ppg{{pgversion}} + ``` - 3. Install the extension + 3. Install the extension ```{.bash data-prompt="$"} - $ sudo yum install percona-postgis33 percona-postgis33-client - ``` + $ sudo yum install percona-postgis33_{{pgversion}} percona-postgis33_{{pgversion}}-client + ``` - This installs the set of PostGIS extensions. To check what extensions are available, run the following query from the `psql` terminal: + This installs the set of PostGIS extensions. To check what extensions are available, run the following query from the `psql` terminal: ```sql SELECT name, default_version,installed_version FROM pg_available_extensions WHERE name LIKE 'postgis%' or name LIKE 'address%'; ``` + ## Enable PostGIS extension 1. Create a database and a schema for this database to store your data. A schema is a container that logically segments objects (tables, functions, views, and so on) for better management. Run the following commands from the `psql` terminal: diff --git a/docs/yum.md b/docs/yum.md index 58e534a8c..39cb8be6b 100644 --- a/docs/yum.md +++ b/docs/yum.md @@ -224,7 +224,7 @@ $ sudo yum -y install curl Percona provides [two repositories](repo-overview.md) for Percona Distribution for PostgreSQL. We recommend enabling the Major release repository to timely receive the latest updates. ```{.bash data-prompt="$"} - $ sudo percona-release setup ppg-16 + $ sudo percona-release setup ppg{{pgversion}} ``` ### Install packages @@ -234,7 +234,7 @@ $ sudo yum -y install curl The [meta package](repo-overview.md#percona-ppg-server){:target=”_blank”} enables you to install several components of the distribution in one go. ```{.bash data-prompt="$"} - $ sudo yum install percona-ppg-server16 + $ sudo yum install percona-ppg-server{{pgversion}} ``` === "Install packages individually" @@ -242,7 +242,7 @@ $ sudo yum -y install curl 1. Install the PostgreSQL server package: ```{.bash data-prompt="$"} - $ sudo yum install percona-postgresql16-server + $ sudo yum install percona-postgresql{{pgversion}}-server ``` 2. Install the components: @@ -250,13 +250,13 @@ $ sudo yum -y install curl Install `pg_repack`: ```{.bash data-prompt="$"} - $ sudo yum install percona-pg_repack16 + $ sudo yum install percona-pg_repack{{pgversion}} ``` Install `pgaudit`: ```{.bash data-prompt="$"} - $ sudo yum install percona-pgaudit + $ sudo yum install percona-pgaudit{{pgversion}} ``` Install `pgBackRest`: @@ -283,7 +283,7 @@ $ sudo yum -y install curl Install `pgAudit-set_user`: ```{.bash data-prompt="$"} - $ sudo yum install percona-pgaudit16_set_user + $ sudo yum install percona-pgaudit{{pgversion}}_set_user ``` Install `pgBadger`: @@ -295,13 +295,13 @@ $ sudo yum -y install curl Install `wal2json`: ```{.bash data-prompt="$"} - $ sudo yum install percona-wal2json16 + $ sudo yum install percona-wal2json{{pgversion}} ``` Install PostgreSQL contrib extensions: ```{.bash data-prompt="$"} - $ sudo yum install percona-postgresql16-contrib + $ sudo yum install percona-postgresql{{pgversion}}-contrib ``` Install HAProxy @@ -322,7 +322,7 @@ $ sudo yum -y install curl 2. Install the extension ```{.bash data-prompt="$"} - $ sudo yum install percona-pgpool-II-pg16 + $ sudo yum install percona-pgpool-II-pg{{pgversion}} ``` Some extensions require additional setup in order to use them with Percona Distribution for PostgreSQL. For more information, refer to [Enabling extensions](enable-extensions.md). @@ -332,13 +332,13 @@ $ sudo yum -y install curl After the installation, the default database storage is not automatically initialized. To complete the installation and start Percona Distribution for PostgreSQL, initialize the database using the following command: ```{.bash data-prompt="$"} -$ /usr/pgsql-16/bin/postgresql-16-setup initdb +$ /usr/pgsql-{{pgversion}}/bin/postgresql-{{pgversion}}-setup initdb ``` Start the PostgreSQL service: ```{.bash data-prompt="$"} -$ sudo systemctl start postgresql-16 +$ sudo systemctl start postgresql-{{pgversion}} ``` ### Connect to the PostgreSQL server @@ -367,4 +367,4 @@ To exit the `psql` terminal, use the following command: ```{.bash data-prompt="$"} $ \q -``` +``` \ No newline at end of file