Merge pull request #1509 from EnterpriseDB/release/2021-06-28

Release/2021 06 28

Former-commit-id: 70589be

Author: drothery-edb

product_docs/docs/efm/3.10/efm_pgpool_ha_guide/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: "EDB Postgres High Availability & Horizontal Read Scaling Architecture"
+title: "High Availability & Scalability Guide"
 
 #legacyRedirectsGenerated:
   # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.

product_docs/docs/efm/3.10/efm_user/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: "EDB Failover Manager"
+title: "EDB Failover Manager User Guide"
 
 ---
 

product_docs/docs/efm/3.10/index.mdx

@@ -1,12 +1,16 @@
 ---
 title: "EDB Postgres Failover Manager"
-productStub: true
+#productStub: true
 directoryDefaults:
   description: "EDB Postgres Failover Manager Version 3.10 Documentation and release notes. PostgreSQL replication and failover manager for achieving high availability."
-
+navigation:
+  - "#Getting Started"
+  - efm_quick_start
+  - "#Guides"
+  - efm_pgpool_ha_guide
+  - efm_user
 legacyRedirectsGenerated:
   # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
   - "/edb-docs/p/edb-postgres-failover-manager/3.10"
 ---
 
-<StubCards product='efm' version='3.10' />

product_docs/docs/postgis/1.0/01_installing_postgis.mdx

@@ -16,20 +16,20 @@ After installing PostGIS, create a PostGIS database and the extensions in each d
     ./psql -d edb -U enterprisedb -h 127.0.0.1
     ```
 
-2.  Then, to create a privileged role, invoke the following command:
+2.  Invoke the following command to create a privileged role:
 
     ```text
     CREATE ROLE gisadmin LOGIN PASSWORD 'password' SUPERUSER;
     ```
 
-3.  Log out of psql, then connect as `gisadmin`:
+3.  Log out of psql and connect as `gisadmin`:
 
     ```text
     edb=# \q
     ./psql -d edb -U gisadmin -h 127.0.0.1
     ```
 
-4.  Use the following commands to create the `postgis` database owned by `gisadmin`:
+4.  Invoke the following command to create the `postgis` database owned by `gisadmin`:
 
     ```text
     CREATE DATABASE postgis;

product_docs/docs/postgis/1.0/02_creating_extensions.mdx

@@ -8,26 +8,26 @@ legacyRedirectsGenerated:
 
 <div id="upgrade" class="registered_link"></div>
 
-This section walks you through the following upgrade examples:
+This section walks you through the following upgrade examples for RHEL/CentOS 7 platforms:
 
 - Example 1 - Explains how to Upgrade from PostGIS version 2.4.6 to PostGIS version 3.1.1 for EDB Postgres Advanced Server version 9.6.
-- Example 2 - Explains how to upgrade from PostGIS version 2.4.6 for EDB Postgres Advanced Server version 9.6 to PostGIS version 3.1.1 for EDB Postgres Advanced Server version 13.
+- Example 2 - Explains how to upgrade from PostGIS version 2.4.6 for EDB Postgres Advanced Server version 9.6 to PostGIS version 3.1.2 for EDB Postgres Advanced Server version 13.
 
 ## Example 1
 
 The following example walks you through the process of upgrading PostGIS version 2.4.6 to PostGIS version 3.1.1 for EDB Postgres Advanced Server version 9.6.
 
 !!! Note
 
-    It is assumed that you have created extensions for PostGIS version 2.4.6 already and EDB Advanced Sever 9.6 service is running.
+    It is assumed that you have already created extensions for PostGIS version 2.4.6, and EDB Advanced Server 9.6 service is running.
 
-1.  To upgrade PostGIS version 2.4.6 to PostGIS version 3.1.1 for EDB Postgres Advanced Server 9.6, assume the superprivilges and execute the following command:
+1.  To upgrade PostGIS version 2.4.6 to PostGIS version 3.1.1 for EDB Postgres Advanced Server 9.6, assume the superuser privileges and invoke the following command:
 
     ```text
-    yum upgrade edb-as96-postgis* -y
+    yum upgrade edb-as96-postgis-3.1.1 -y
     ```
 
-2. To update extensions, switch to an `enterprisedb` user, connect to the database (where you have already added extensions) with the psql client application, and execute the following commands:
+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:
 
     ```text
     edb=# alter extension postgis update to '3.1.1';
@@ -56,39 +56,38 @@ The following example walks you through the process of upgrading PostGIS version
 
 ## Example 2
 
-The following example walks you through the process of upgrading PostGIS version 2.4.6 for EDB Postgres Advanced Server 9.6 to PostGIS version 3.1.1 for EDB Postgres Advanced Server version 13:
+!!! Note    
+   
+    It is assumed that you have already created extensions for PostGIS version 2.4.6, and EDB Advanced Server 9.6 service is running.
 
-!!! Note
+    When the PostGIS data has a dependency on the raster functions, upgrading to PostGIS version 3.1.2 requires [dumping and reloading the data](https://www.enterprisedb.com/edb-docs/d/postgresql/reference/manual/13.1/app-pgdump.html)
+
+The following example walks you through the process of upgrading PostGIS version 2.4.6 for EDB Postgres Advanced Server 9.6 to PostGIS version 3.1.2 for EDB Postgres Advanced Server version 13:
+
+- Step 1 - Upgrade to PostGIS 3.1.1 - This is an intermediate step required to resolve dependency issues.
+
+- Step 2 - Upgrade to PostGIS 3.1.2
 
-    You can upgrade to the PostGIS latest version only for the EDB Postgres Advanced Server version greater than or equal to 9.6.
+- Step 3 - Upgrade EDB Postgres Advanced Server version 9.6 to to 13
+
+Step 1 - To upgrade PostGIS version 2.4.6 to 3.1.2, you need to upgrade it to 3.1.1 first.
 
 1.  Navigate to the bin directory of EDB Advanced Server 9.6:
 
     ```text
     cd /usr/edb/as9.6/bin/
     ```
 
-    !!! Note
-
-        It is assumed that you have created extensions for PostGIS version 2.4.6 already and EDB Advanced Sever 9.6 service is running.
-
-2.  To upgrade PostGIS version 2.4.6 to PostGIS version 3.1.1 for EDB Postgres Advanced Server 9.6, assume the superprivilges and execute the following command:
+2.  Assume the superuser privileges and invoke the following command to upgrade to PostGIS version 3.1.1:
 
     ```text
-    yum upgrade edb-as96-postgis*
+    yum upgrade edb-as96-postgis-3.1.1 -y
     ```
 
-3. To update extensions, switch to an `enterprisedb` user, connect to the database (where you have already added extensions) with the psql client application, and execute the following commands:
-
     !!! Note
+        See the [Installing PostGIS on a Debian/Ubuntu Host section](https://www.enterprisedb.com/docs/postgis/latest/01_installing_postgis/) for information about Debian platform commands.
 
-        The `enterprisedb` user is the default user created when you install the EDB Postgres Advanced Server. If you have created a new user for your database, you can switch to that user.
-
-    ```text
-    su enterprisedb
-
-    ./psql -d edb -p 5444
-    ```
+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:
 
     ```text
     edb=# alter extension postgis update to '3.1.1';
@@ -115,40 +114,101 @@ The following example walks you through the process of upgrading PostGIS version
     (1 row)
     ```
 
-4. Assume the superuser priviliges to stop the EDB Postgres Advanced Server 9.6 service:
+Step 2 - Upgrade to PostGIS version 3.1.2
+
+1.  To upgrade PostGIS version 3.1.1 to 3.1.2, invoke the following command for EDB Postgres Advanced Server 9.6:
+
+    ```text
+    yum upgrade edb-as96-postgis-3.1.2 -y
+    ```
+
+2. To update extensions, switch to `enterprisedb` user and execute the following commands:
+
+    ```text
+    edb=# alter extension postgis update to '3.1.2';
+    WARNING: unpackaging raster
+    WARNING: PostGIS Raster functionality has been unpackaged
+    HINT: type `SELECT postgis_extensions_upgrade();` to finish the upgrade. After upgrading, if you want to drop raster, run: DROP EXTENSION postgis_raster;
+    ALTER EXTENSION
+    ```
+
+   With PostGIS version 3.1.2, the return type of the raster functions has changed, which requires dropping and creating the raster extension as part of the upgrade process. 
+    
+    ```text
+    edb=# drop extension postgis_raster;
+    DROP EXTENSION
+    ```
+
+    ```text
+    edb=# SELECT postgis_extensions_upgrade();
+    NOTICE: Updating extension postgis_sfcgal from 3.1.1 to 3.1.2
+    NOTICE: Updating extension postgis_topology from 3.1.1 to 3.1.2
+    NOTICE: Updating extension postgis_tiger_geocoder from 3.1.1 to 3.1.2
+              postgis_extensions_upgrade           
+    -------------------------------------------------------------------
+     Upgrade completed, run SELECT postgis_full_version(); for details
+    (1 row)
+    ```
+
+    ```text
+    edb=# alter extension address_standardizer update to '3.1.2';
+    ALTER EXTENSION
+    ```
+
+    Quit and re-open the psql client session:
+
+    ```text
+    edb=# \q
+    ./psql -d edb -p 5444
+    ```
+
+    ```text
+    edb=# create extension postgis_raster;
+    CREATE EXTENSION
+    ```
+
+Step 3 - Upgrade EDB Postgres Advanced Server version 9.6 to to 13:
+
+1. Assume the superuser privileges to stop the EDB Postgres Advanced Server 9.6 service:
 
     ```text
     systemctl stop edb-as-9.6
     ```
 
-5.  Install the EDB Postgres Advanced Server version 13:
+2.  Install the EDB Postgres Advanced Server version 13:
 
     ```text
     yum install edb-as13-server -y
     ```
 
-6.  Navigate to the bin directory of EDB Advanced Server 13 and initialize the cluster:
+3.  Navigate to the bin directory of EDB Advanced Server 13 and initialize the cluster:
 
     ```text
     cd /usr/edb/as13/bin/
 
     ./edb-as-13-setup initdb
     ```
 
-7. Install the PostGIS version 3.1.1 for EDB Postgres Advanced Server version 13.0:
+4. Install the PostGIS version 3.1.2 for EDB Postgres Advanced Server version 13.0:
 
     ```text
-    yum install edb-as13-postgis3 -y
+    yum install edb-as13-postgis3-3.1.2 -y
     ```
 
-8. Switch to an `enterprisedb` user and create a `temp` folder:
+5. Assume the superuser privileges to stop the EDB Postgres Advanced Server 13.0 service:
+
+    ```text
+    systemctl stop edb-as-13
+    ```
+
+6. Switch to `enterprisedb` user and create a `temp` folder:
 
     ```text
     su enterprisedb
     cd $(mktemp -d)
     ```
 
-9.  Execute the following commands to check cluster compatibility and consistency, as well as to perform the upgrade.
+7.  Execute the following commands to check cluster compatibility and consistency, as well as to perform the upgrade.
 
     ```text
     bash-4.2$ /usr/edb/as13/bin/pg_upgrade -d /var/lib/edb/as9.6/data/ -D /var/lib/edb/as13/data/ -U enterprisedb -b /usr/edb/as9.6/bin/ -B /usr/edb/as13/bin/ -p 5444 -P 5445 -c
@@ -238,24 +298,23 @@ The following example walks you through the process of upgrading PostGIS version
     ./delete_old_cluster.sh
      ```
 
-10. Assume the superuser priviliges, navigate to the `bin` directory of EDB Postgres Advanced Server 13, and start the service:
+8. Assume the superuser privileges, navigate to the `bin` directory of EDB Postgres Advanced Server 13, and start the service:
 
     ```text
     cd /usr/edb/as13/bin/
 
     systemctl start edb-as-13
-
     ```
 
-11. To update extensions, switch to an `enterprisedb` user, connect to the database (where you have already added extensions) with the psql client application, and execute the following commands:
+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:
 
     ```text
     su enterprisedb
     ./psql -d edb -p 5444
     edb=# SELECT PostGIS_Extensions_Upgrade();
-    NOTICE: Updating extension postgis 3.1.1
+    NOTICE: Updating extension postgis 3.1.2
           postgis_extensions_upgrade
     -------------------------------------------------------------------
     Upgrade completed, run SELECT postgis_full_version(); for details
     (1 row)
-    ```
+    ```

product_docs/docs/postgis/1.0/03_upgrading_postgis.mdx

@@ -16,7 +16,7 @@ The following command creates a table named `roads` table that will hold GIS dat
 CREATE  TABLE roads ( ID int4, NAME varchar(128) );
 ```
 
-Then, use the PostGIS `AddGeometryColumn` function to add a column to the table:
+Use the PostGIS `AddGeometryColumn` function to add a column to the table:
 
 ```text
 SELECT AddGeometryColumn( 'roads', 'geom', -1, 'GEOMETRY', 2 );

product_docs/docs/postgis/1.0/04_using_postgis.mdx

@@ -15,6 +15,33 @@ EDB PostGIS is a PostgreSQL extension that allows you to store Geographic Inform
 
 The complete documentation for PostGIS is added to your system during the installation and is available online at the [PostGIS project site](https://postgis.net/documentation/).
 
+## What's New ##
+
+This release contains a merge with upstream, which includes the following bug fixes:
+
+- Improved handling of more complex compound coordinate systems.
+- The SRID in TopoGeometry is fixed for empty geometry objects.
+- Improved message when no zip code is provided for `postgis_tiger_geocoder`.
+- Axis flips are now done for a CRS when `Lat` is set as the first column. In other cases, EPSG database order is used.
+- Support recent Proj versions that have removed `pj_get_release`.
+- The tolerance is now adjusted to improve geodetic calculations.
+- Fix on improper conversion of negative geographic azimuth to positive.
+- Allow DBSCAN cluster to form when recordset length equal to minPoints.
+- Ensure bounding boxes are refreshed after coordinate transforms.
+- Fix raster issues related to PostgreSQL 14 tablefunc changes.
+- Update to support Tiger 2020.
+- Change Proj cache lifetime to last as long as connection.
+
+For more information, please refer to the [Upstream release notes](https://postgis.net/docs/manual-3.1/release_notes.html#idm41899).
+
+!!! Note
+    To upgrade from PostGIS version 2.5.4 (or lower) to 3.1.2, you must perform the following  actions:
+     -  Since the return type of the raster functions have changed, you must drop and re-create the raster extension as part of the upgrade process. 
+     - Before upgrading to version 3.1.2,  you must upgrade to 3.1.1 first as an intermediate step.
+     - When the PostGIS data has a dependency on the raster functions, upgrading to PostGIS 3.1.2 requires dumping and reloading the data.
+
+    See the [upgrade section](https://www.enterprisedb.com/docs/postgis/latest/03_upgrading_postgis/) for details.
+
 <div class="toctree" maxdepth="3">
 
 installing_postgis creating_extensions upgrading_postgis using_postgis uninstalling_postgis conclusion