Skip to content

Commit

Permalink
Merge pull request #4924 from EnterpriseDB/docs/edits_to_nongenerated…
Browse files Browse the repository at this point in the history 
…_installs_postgis

edits_to_nongenerated_install_postgis
  • Loading branch information
@nidhibhammar
nidhibhammar authored Oct 18, 2023
2 parents d3be82b + 5aa9b79 commit f7c97b1
Show file tree
Hide file tree
Showing 3 changed files with 58 additions and 75 deletions.
34 changes: 15 additions & 19 deletions product_docs/docs/postgis/3.2/installing/uninstalling.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,66 +10,62 @@ legacyRedirectsGenerated:

<div id="uninstalling_postgis" class="registered_link"></div>

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<xx>-postgis-*<y.y.y>
```

Where *&lt;xx>* is the Advanced Server version and &lt;y.y.y> is the PostGIS version you want to uninstall.
Where `<xx>` is the EDB Postgres Advanced Server version and `<y.y.y>` 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<xx>-postgis-*<y.y.y>
```

## 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<xx>-postgis-<y.y>*
```

Where *&lt;xx>* is the Advanced Server version and &lt;y.y> is the PostGIS version you want to uninstall
Where `<xx>` is the EDB Postgres Advanced Server version and `<y.y>` 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*
```

## 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**.
51 changes: 25 additions & 26 deletions product_docs/docs/postgis/3.2/installing/upgrading.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,29 +10,29 @@ legacyRedirectsGenerated:

<div id="upgrade" class="registered_link"></div>

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)
- [Example 3: Upgrading from PostGIS versions earlier than 2.5 to 3.1.4 on a different EDB Postgres Advanced Server version](/postgis/latest/installing/upgrading/#example-3-upgrading-from-postgis-versions-earlier-than-25-to-314-on-a-different-edb-postgres-advanced-server-version)

## 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<xx>-postgis3
Expand All @@ -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.
Expand All @@ -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';
Expand Down Expand Up @@ -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 &mdash; Upgrade to PostGIS 3.1.1. This is an intermediate step required to resolve dependency issues.

Expand All @@ -116,7 +116,7 @@ The following example walks you through the process of upgrading PostGIS version
- Step 3 &mdash; 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).

Expand All @@ -128,7 +128,7 @@ Step 1 &mdash; 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
Expand All @@ -137,7 +137,7 @@ Step 1 &mdash; 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';
Expand Down Expand Up @@ -173,7 +173,7 @@ Step 2 &mdash; 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';
Expand Down Expand Up @@ -206,7 +206,7 @@ Step 2 &mdash; 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
Expand All @@ -220,7 +220,7 @@ Step 2 &mdash; Upgrade to PostGIS version 3.1.4:

Step 3 &mdash; 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
Expand All @@ -232,34 +232,34 @@ Step 3 &mdash; 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/

./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
Expand Down Expand Up @@ -349,15 +349,15 @@ Step 3 &mdash; 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/

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
Expand All @@ -370,4 +370,3 @@ Step 3 &mdash; Upgrade EDB Postgres Advanced Server version 10 to 14:
Upgrade completed, run SELECT postgis_full_version(); for details
(1 row)
```

48 changes: 18 additions & 30 deletions product_docs/docs/postgis/3.2/installing/windows.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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.

1 comment on commit f7c97b1

@github-actions
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎉 Published on https://edb-docs-staging.netlify.app as production
🚀 Deployed on https://653001abc2feb50c4d1790fc--edb-docs-staging.netlify.app

Please sign in to comment.