diff --git a/product_docs/docs/postgis/3.2/installing/uninstalling.mdx b/product_docs/docs/postgis/3.2/installing/uninstalling.mdx index 4d653d51d93..f6055408ad7 100644 --- a/product_docs/docs/postgis/3.2/installing/uninstalling.mdx +++ b/product_docs/docs/postgis/3.2/installing/uninstalling.mdx @@ -10,33 +10,31 @@ legacyRedirectsGenerated: -This section walks you through the process of uninstalling PostGIS. - ## Uninstalling PostGIS on a CentOS/RHEL/Rocky Linux/AlmaLinux host -To uninstall PostGIS on a CentOS/RHEL host, assume the identity of the root user and invoke the following command: +To uninstall PostGIS on a CentOS/RHEL host, assume the identity of the root user and invoke the appropriate command. -On CentOS/RHEL 7 for EPAS version 13: +On CentOS/RHEL 7 for EDB Posgres Advanced Server version 13: ```shell yum -y erase edb-as13-postgis3* ``` -On CentOS/RHEL 7 for older versions of EPAS: +On CentOS/RHEL 7 for earlier versions of EDB Posgres Advanced Server: ```shell yum erase edb-as-postgis-* ``` -Where *<xx>* is the Advanced Server version and <y.y.y> is the PostGIS version you want to uninstall. +Where `` is the EDB Postgres Advanced Server version and `` is the PostGIS version you want to uninstall. -On Rocky Linux/AlmaLinux/RHEL 8 for EPAS version 13: +On Rocky Linux/AlmaLinux/RHEL 8 for EDB Posgres Advanced Server version 13: ```shell dnf -y erase edb-as13-postgis3* ``` -On Rocky Linux/AlmaLinux/RHEL 8 for older versions of EPAS: +On Rocky Linux/AlmaLinux/RHEL 8 for earlier versions of EDB Posgres Advanced Server: ```shell dnf erase edb-as-postgis-* @@ -44,17 +42,17 @@ dnf erase edb-as-postgis-* ## Uninstalling PostGIS on a Debian/Ubuntu host -To uninstall PostGIS on a Debian or Ubuntu host, invoke the following command: +To uninstall PostGIS on a Debian or Ubuntu host: ```shell apt-get remove edb-as-postgis-* ``` -Where *<xx>* is the Advanced Server version and <y.y> is the PostGIS version you want to uninstall +Where `` is the EDB Postgres Advanced Server version and `` is the PostGIS version you want to uninstall ## Uninstalling PostGIS on a SLES host -To uninstall PostGIS on a SLES host, assume the identity of the root user and invoke the following command: +To uninstall PostGIS on a SLES host, assume the identity of the root user and invoke: ```shell zypper remove edb-as12-postgis* @@ -62,14 +60,12 @@ zypper remove edb-as12-postgis* ## Uninstalling PostGIS on a Windows host -The PostGIS graphical installer creates an uninstaller that you can use to remove PostGIS. The uninstaller is created in the installation directory that you have specified while installing PostGIS (default is `C:\Program Files\edb\as13`). - -1. Navigate into the directory that contains the uninstaller and assume superuser privileges. Open the uninstaller and click `Yes` to begin uninstalling PostGIS: +The PostGIS graphical installer creates an uninstaller that you can use to remove PostGIS. The uninstaller is created in the installation directory that you specified while installing PostGIS. The default is `C:\Program Files\edb\as13`. -![The Uninstaller opens](../../images/uninstall1.png) -Fig. 9: The Uninstaller Confirmation Dialog +1. Navigate into the directory that contains the uninstaller and assume superuser privileges. -2. The uninstallation process begins. Click `OK` when the uninstallation completes: +1. To begin uninstalling PostGIS, open the uninstaller and select **Yes**. -![Uninstallation is Complete](../../images/uninstall4final.png) -Fig. 10: Uninstallation is Complete + The uninstallation process begins. + +1. When the uninstallation completes, select **OK**. diff --git a/product_docs/docs/postgis/3.2/installing/upgrading.mdx b/product_docs/docs/postgis/3.2/installing/upgrading.mdx index a73e0993e34..558756020ba 100644 --- a/product_docs/docs/postgis/3.2/installing/upgrading.mdx +++ b/product_docs/docs/postgis/3.2/installing/upgrading.mdx @@ -10,7 +10,7 @@ legacyRedirectsGenerated: -This section walks you through the following upgrade examples for RHEL/CentOS 7 platforms: +These examples show upgrading for RHEL/CentOS 7 platforms: - [Example 1: Upgrading from PostGIS version 3.1 to 3.2](/postgis/latest/installing/upgrading/#example-1-upgrading-from-postgis-version-31-to-32) - [Example 2: Upgrading from PostGIS versions 2.5 or later to 3.1.4 on the same EDB Postgres Advanced Server version](/postgis/latest/installing/upgrading/#example-2-upgrading-from-postgis-versions-25-or-later-to-314-on-the-same-edb-postgres-advanced-server-version) @@ -18,21 +18,21 @@ This section walks you through the following upgrade examples for RHEL/CentOS 7 ## Example 1: Upgrading from PostGIS version 3.1 to 3.2 -The following example walks you through upgrading from PostGIS version 3.1 to version 3.2 for EDB Postgres Advanced Server 14. +This example upgrades from PostGIS version 3.1 to version 3.2 for EDB Postgres Advanced Server 14. -To avoid accidental upgrades, PostGIS version 3.1 and 3.2 use different package names. So, upgrading to version 3.2 requires that you first uninstall version 3.1. Once you install version 3.2, you can upgrade the PostGIS extensions. +To avoid accidental upgrades, PostGIS versions 3.1 and 3.2 use different package names. So, upgrading to version 3.2 requires that you first uninstall version 3.1. After you install version 3.2, you can upgrade the PostGIS extensions. -1. Create the PostGIS extensions in PostGIS version 3.1, if you haven't already. For instructions, see [Creating extensions](/postgis/latest/02_creating_extensions/). +1. If you haven't already, create the PostGIS extensions in PostGIS version 3.1. For instructions, see [Creating extensions](/postgis/latest/02_creating_extensions/). 1. Uninstall PostGIS version 3.1. - For EPAS version 14: + For EDB Posgres Advanced Server version 14: ```shell yum -y erase edb-as14-postgis3 ``` - For older versions of EDB Postgres Advanced Server: + For earlier versions of EDB Postgres Advanced Server: ```shell yum erase edb-as-postgis3 @@ -44,7 +44,7 @@ To avoid accidental upgrades, PostGIS version 3.1 and 3.2 use different package 1. Install PostGIS version 3.2. For instructions, see [Installing PostGIS on RHEL 7/OL 7 x86](/postgis/latest/installing/linux_x86_64/postgis_rhel_7/). -1. Upgrade the PostGIS extensions using the following command: +1. Upgrade the PostGIS extensions: !!! Note If you first upgraded from a PostGIS version earlier than 2.5 to PostGIS version 3.1, then you must `DROP` the `postgis_raster extension` before executing the command. @@ -66,19 +66,19 @@ To avoid accidental upgrades, PostGIS version 3.1 and 3.2 use different package ## Example 2: Upgrading from PostGIS versions 2.5 or later to 3.1.4 on the same EDB Postgres Advanced Server version -The following example walks you through the process of upgrading from PostGIS version 2.5.5 to PostGIS version 3.1.4 for EDB Postgres Advanced Server version 12. +This example upgrades from PostGIS version 2.5.5 to PostGIS version 3.1.4 for EDB Postgres Advanced Server version 12. !!! Note - It is assumed that you have already created extensions for PostGIS version 2.5.5 as described in [Creating extensions](/postgis/latest/02_creating_extensions/) and EDB Advanced Server 12 service is running. + It's assumed that you already created extensions for PostGIS version 2.5.5 as described in [Creating extensions](/postgis/latest/02_creating_extensions/) and that the EDB Advanced Server 12 service is running. -1. To upgrade PostGIS version 2.5.5 to PostGIS version 3.1.4 for EDB Postgres Advanced Server 12, assume the superuser privileges and invoke the following command: +1. To upgrade PostGIS version 2.5.5 to PostGIS version 3.1.4 for EDB Postgres Advanced Server 12, assume superuser privileges and invoke: ```shell yum upgrade edb-as12-postgis-3.1.4 -y ``` -2. To update extensions, switch to `enterprisedb` user, connect to the database (where you have already created extensions) with the psql client application, and execute the following commands: +2. To update extensions, switch to the enterprisedb user, connect to the database where you already created extensions with the psql client application, and invoke: ```sql edb=# alter extension postgis update to '3.1.4'; @@ -107,7 +107,7 @@ The following example walks you through the process of upgrading from PostGIS ve ## Example 3: Upgrading from PostGIS versions earlier than 2.5 to 3.1.4 on a different EDB Postgres Advanced Server version -The following example walks you through the process of upgrading PostGIS version 2.4.6 for EDB Postgres Advanced Server 10 to PostGIS version 3.1.4 for EDB Postgres Advanced Server version 14: +This example upgrades PostGIS version 2.4.6 for EDB Postgres Advanced Server 10 to PostGIS version 3.1.4 for EDB Postgres Advanced Server version 14: - Step 1 — Upgrade to PostGIS 3.1.1. This is an intermediate step required to resolve dependency issues. @@ -116,7 +116,7 @@ The following example walks you through the process of upgrading PostGIS version - Step 3 — Upgrade EDB Postgres Advanced Server version 10 to 14. !!! Note - It is assumed that you have already created extensions for the PostGIS version earlier than 2.5.5 as described in [Creating extensions](/postgis/latest/02_creating_extensions) and EDB Advanced Server 10 service is running. + It's assumed that you already created extensions for the PostGIS version earlier than 2.5.5, as described in [Creating extensions](/postgis/latest/02_creating_extensions), and EDB Advanced Server 10 service is running. When the PostGIS data has a dependency on the raster functions, upgrading to PostGIS version 3.1.4 requires [dumping and reloading the data](https://www.postgresql.org/docs/current/app-pgdump.html). @@ -128,7 +128,7 @@ Step 1 — To upgrade PostGIS version 2.4.6 to 3.1.4, you need to upgrade it cd /usr/edb/as10/bin/ ``` -2. Assume the superuser privileges and invoke the following command to upgrade to PostGIS version 3.1.1: +2. Assume superuser privileges and upgrade to PostGIS version 3.1.1: ```shell yum upgrade edb-as10-postgis-3.1.1 -y @@ -137,7 +137,7 @@ Step 1 — To upgrade PostGIS version 2.4.6 to 3.1.4, you need to upgrade it !!! Note See the [Installing PostGIS on a Debian/Ubuntu Host section](/postgis/latest/installing/linux_x86_64/) for information about Debian platform commands. -3. To update extensions, switch to `enterprisedb` user, connect to the database (where you have already created extensions) with the psql client application, and execute the following commands: +3. To update extensions, switch to the enterprisedb user, connect to the database where you already created extensions with the psql client application, and execute the following commands: ```sql edb=# alter extension postgis update to '3.1.1'; @@ -173,7 +173,7 @@ Step 2 — Upgrade to PostGIS version 3.1.4: yum upgrade edb-as10-postgis-3.1.4 -y ``` -2. To update extensions, switch to `enterprisedb` user and execute the following commands: +2. To update extensions, switch to the enterprisedb user and invoke: ```sql edb=# alter extension postgis update to '3.1.4'; @@ -206,7 +206,7 @@ Step 2 — Upgrade to PostGIS version 3.1.4: ALTER EXTENSION ``` - Quit and re-open the psql client session: + Quit and reopen the psql client session: ```sql edb=# \q @@ -220,7 +220,7 @@ Step 2 — Upgrade to PostGIS version 3.1.4: Step 3 — Upgrade EDB Postgres Advanced Server version 10 to 14: -1. Assume the superuser privileges to stop the EDB Postgres Advanced Server 10 service: +1. Assume superuser privileges and stop the EDB Postgres Advanced Server 10 service: ```shell systemctl stop edb-as-10 @@ -232,7 +232,7 @@ Step 3 — Upgrade EDB Postgres Advanced Server version 10 to 14: yum install edb-as14-server -y ``` -3. Navigate to the bin directory of EDB Advanced Server 14 and initialize the cluster: +3. Navigate to the `/bin` directory of EDB Advanced Server 14 and initialize the cluster: ```shell cd /usr/edb/as14/bin/ @@ -240,26 +240,26 @@ Step 3 — Upgrade EDB Postgres Advanced Server version 10 to 14: ./edb-as-14-setup initdb ``` -4. Install the PostGIS version 3.1.4 for EDB Postgres Advanced Server version 14.0: +4. Install PostGIS version 3.1.4 for EDB Postgres Advanced Server version 14.0: ```shell yum install edb-as14-postgis3-3.1.4 -y ``` -5. Assume the superuser privileges to stop the EDB Postgres Advanced Server 14.0 service: +5. Assume superuser privileges and stop the EDB Postgres Advanced Server 14.0 service: ```shell systemctl stop edb-as-14 ``` -6. Switch to `enterprisedb` user and create a `temp` folder: +6. Switch to the enterprisedb user and create a `temp` folder: ```shell su enterprisedb cd $(mktemp -d) ``` -7. Execute the following commands to check cluster compatibility and consistency, as well as to perform the upgrade. +7. Check cluster compatibility and consistency and perform the upgrade: ```text bash-4.2$ /usr/edb/as14/bin/pg_upgrade -d /var/lib/edb/as10/data/ -D /var/lib/edb/as14/data/ -U enterprisedb -b /usr/edb/as10/bin/ -B /usr/edb/as14/bin/ -p 5444 -P 5445 -c @@ -349,7 +349,7 @@ Step 3 — Upgrade EDB Postgres Advanced Server version 10 to 14: ./delete_old_cluster.sh ``` -8. Assume the superuser privileges, navigate to the `bin` directory of EDB Postgres Advanced Server 14, and start the service: +8. Assume superuser privileges, navigate to the `bin` directory of EDB Postgres Advanced Server 14, and start the service: ```shell cd /usr/edb/as14/bin/ @@ -357,7 +357,7 @@ Step 3 — Upgrade EDB Postgres Advanced Server version 10 to 14: systemctl start edb-as-14 ``` -9. To update extensions, switch to `enterprisedb` user, connect to the database (where you have already created extensions) with the psql client application, and execute the following commands: +9. To update extensions, switch to the enterprisedb user, connect to the database where you already created extensions with the psql client application, and execute the following commands: ```sql su enterprisedb @@ -370,4 +370,3 @@ Step 3 — Upgrade EDB Postgres Advanced Server version 10 to 14: Upgrade completed, run SELECT postgis_full_version(); for details (1 row) ``` - diff --git a/product_docs/docs/postgis/3.2/installing/windows.mdx b/product_docs/docs/postgis/3.2/installing/windows.mdx index 17a6960fd7b..10148f3c982 100644 --- a/product_docs/docs/postgis/3.2/installing/windows.mdx +++ b/product_docs/docs/postgis/3.2/installing/windows.mdx @@ -5,62 +5,50 @@ redirects: - /postgis/latest/01a_installing_postgis/installing_on_windows/ --- -You must install Advanced Server before installing PostGIS. If you have used the graphical Setup wizard to install EDB Postgres Advanced Server, you can use StackBuilder Plus to add PostGIS to your installation. For details about using the graphical installer to install and configure Advanced Server, see the EDB Postgres Advanced Server Installation Guide for Windows. +You must install EDB Postgres Advanced Server before installing PostGIS. If you used the graphical wizard to install EDB Postgres Advanced Server, you can use StackBuilder Plus to add PostGIS to your installation. For details about using the graphical installer to install and configure EDB Postgres Advanced Server, see the [EDB Postgres Advanced Server documentation](/epas/latest). !!! Note - To install PostGIS version 3.1 on EDB Postgres Advanced Server version 10 on Windows, you need to upgrade it to the latest EDB Postgres Advanced Server minor version of 10.16.25 (or later), and then proceed with PostGIS 3.1 installation. + To install PostGIS version 3.1 on EDB Postgres Advanced Server version 10 on Windows, you need to upgrade it to the latest EDB Postgres Advanced Server minor version of 10.16.25 or later, and then proceed with PostGIS 3.1 installation. -1. Open StackBuilder Plus and select your Advanced Server installation from the drop-down list on the `Welcome` window. Click `Next` to continue to the application selection page. +1. Open StackBuilder Plus and select your EDB Postgres Advanced Server installation from the list on the Welcome window. Select **Next** to continue to the application selection page. ![The StackBuilder Plus Welcome window](../images/SBP_welcome.png) - Fig. 1: The StackBuilder Plus Welcome window -2. Expand the `Spatial Extensions` node, and check the box next to the PostGIS version. Click `Next` to continue. +2. Expand the **Spatial Extensions** node, and select the check box next to the PostGIS version. Select **Next**. -3. The selected packages and the default download directory are displayed; change the locations if required. Click `Next`. +3. The selected packages and the default download directory are displayed. If requried, change the locations. Select **Next**. ![The Installation Directory window](../images/postgis_installation.png) - Fig. 2: The Installation Directory window -4. Once you have downloaded the installation files, a confirmation message is displayed. Click `Next` to start the PostGIS installation. +4. After you download the installation files, a confirmation message is displayed. Select **Next** to start the PostGIS installation. ![Installing Postgis](../images/SBP_Installation_Files_Downloaded.png) - Fig. 3: Installing Postgis -5. Select an installation language and click `OK`. +5. Select an installation language and select **OK**. -6. The PostGIS welcome screen is displayed. Click `Next`. +6. The PostGIS welcome screen is displayed. Select **Next**. ![The Postgis welcome window](../images/postgis_welcome.png) - Fig. 4: The Postgis welcome window -7. Use the `Installation Directory` field to specify the directory you wish to install the PostGIS software. Click `Next` to continue. +7. Use the **Installation Directory** field to specify the directory where you want to install the PostGIS software. Select **Next**. -8. Use fields on the `EDB Postgres Advanced Server Installation Details` window to provide connection information for the Advanced Server host: +8. Use fields on the EDB Postgres Advanced Server Installation Details window to provide connection information for the EDB Postgres Advanced Server host: - - Use the `Host` field to identify the system on which Advanced Server resides. + - Use the **Host** field to identify the system on which EDB Postgres Advanced Server resides. - - Provide the name of the role that PostGIS will use for connections to the server in the `User Name` field. + - In the **User Name** field, provide the name of the role for PostGIS to use for connections to the server. - - Provide the password associated with the role in the `Password` field. + - In the **Password** field, provide the password associated with the role. - - Use the `Port` field to identify the listener port that Advanced Server monitors for client connections. + - Use the **Port** field to identify the listener port that EDB Postgres Advanced Server monitors for client connections. - Click `Next` to continue. + Select **Next**. ![The Advanced Server installation details window](../images/advanced_server_installation_details.png) - Fig. 5: The Advanced Server installation details window -9. The `Ready to Install` window notifies you when the installer has all of the information needed to install PostGIS on your system. Click `Next`. +9. The Ready to Install window notifies you when the installer has all of the information needed to install PostGIS on your system. Select **Next**. - ![The ready to install window](../images/ready_to_install.png) - Fig. 6: The ready to install window +10. Progress bars inform you as the installation progresses. Select **Finish** to exit the installer when the PostGIS installation completes. -10. Progress bars inform you as the installation progresses. Click `Finish` to exit the installer when the PostGIS installation completes. - - ![The installation is complete](../images/installattion_complete.png) - - Fig. 7: The installation is complete - - StackBuilder Plus will install PostGIS and create the `template_postgis` database and PostGIS functions. + StackBuilder Plus installs PostGIS and creates the `template_postgis` database and PostGIS functions.