Merge pull request #3713 from EnterpriseDB/release/2023-02-22

Release: 2023-02-22
EnterpriseDB · Feb 22, 2023 · 64f5822 · 64f5822 · github-actions · Feb 22, 2023
2 parents 7af8ba5 + 04bdc9d
commit 64f5822
Show file tree

Hide file tree

Showing 33 changed files with 480 additions and 140 deletions.
diff --git a/advocacy_docs/migrating/oracle/oracle_epas_comparison/app_devel_capabilities.mdx b/advocacy_docs/migrating/oracle/oracle_epas_comparison/app_devel_capabilities.mdx
@@ -57,6 +57,8 @@ EDB focuses on the most popular functions in packages. For some packages, not al
 | DBMS_SQL       | Permits the use of dynamic SQL in procedures to allow applications to run SQL statements with unknown parameters (such as table name) until runtime. |
 | DBMS_SESSION   | Functions with the ability to enable and disable roles. |
 | DBMS_UTILITY   | A collection of functions for getting information about various runtime operations and metadata from the database. |
+| HTF            | A collection of functions for generating HTML tags. |
+| HTP            | A collection of procedures for generating HTML tags. |
 | UTL_ENCODE     | Functions to perform Base64 encoding and decoding of data intended for transport between hosts. |
 | UTL_FILE       | Allows database procedures to read and write operating system text files in an I/O stream fashion. |
 | UTL_HTTP       | Functions that enable you to make HTTP calls to access information on web servers. |

diff --git a/advocacy_docs/migrating/oracle/oracle_epas_comparison/database_features.mdx b/advocacy_docs/migrating/oracle/oracle_epas_comparison/database_features.mdx
@@ -40,8 +40,9 @@ Data types provide ways for a DBMS to define, implement, and use information in
 
 | Data types           | Oracle Enterprise           | EDB Postgres Advanced Server   |
 |----------------------|-----------------------------|--------------------------------|
-| Type system          | Static + dynamic (through ANYDATA) | Static integer NUMBER NUMBER ✓, DEC , NUMERIC, SMALLINT (16-bit), INT, BINARY_INTEGER, PLS_INTEGER, INTEGER (32-bit), BIGINT (64 bit)|
-| Floating point       | BINARY_FLOAT, BINARY_DOUBLE | BINARY_FLOAT ✓, BINARY_DOUBLE ✓, FLOAT, REAL (32-bit), DOUBLE PRECISION (64-bit) |
+| Type system          | Static + dynamic (through ANYDATA) | Static                  |
+| Integer              | NUMBER                      | NUMBER ✓, DEC , NUMERIC, SMALLINT (16-bit), INT, BINARY_INTEGER, PLS_INTEGER, INTEGER (32-bit), BIGINT (64 bit)| 
+| Floating point       | BINARY_FLOAT, BINARY_DOUBLE | FLOAT, REAL (32-bit), DOUBLE PRECISION (64-bit) |
 | Decimal              | NUMBER                      | NUMBER ✓, DEC, DECIMAL, NUMERIC| 
 | String               | CHAR, VARCHAR2, CLOB, NCLOB, NVARCHAR2, NCHAR, LONG (deprecated) | CHAR ✓, VARCHAR ✓, CLOB ✓, NCLOB ✓, NVARCHAR2 ✓, NCHAR, CHARACTER, TEXT, CHAR, VARYING, CHARACTER VARYING, VARCHAR | 
 | Binary               | BLOB, RAW, LONG RAW (deprecated), BFILE | BLOB ✓, RAW ✓, LONG RAW ✓, BYTEA (no compatible type for BFILE) |

diff --git a/advocacy_docs/migrating/oracle/oracle_epas_comparison/notable_differences.mdx b/advocacy_docs/migrating/oracle/oracle_epas_comparison/notable_differences.mdx
@@ -6,7 +6,7 @@ A number of differences between Oracle and EDB Postgres Advanced Server are eith
 
 | Oracle Enterprise            | EDB Postgres Advanced Server |
 |------------------------------|------------------------------|
-| MERGE                        | No <br/> Postgres UPSERT statements can be used but have different syntax from MERGE. <br/> MERGE syntax planned for PostgreSQL 15 | 
+| MERGE                        | Yes <br/> EPAS 15 adds support for WHERE clauses to the UPDATE and INSERT of MERGE command to be more compatible with Oracle than community PostgreSQL. <br/> Additional Oracle compatible syntax planned for EPAS 16 | 
 | Advanced queuing             | Yes                          |
 | Nested procedures/functions  | Yes                          |
 | Pipelined functions          | No <br/> Pipelined functions are used for table functions. Table functions can be implemented in Postgres via SETOF returning functions. In Postgres, data is returned only after the function completes. |

diff --git a/advocacy_docs/migrating/oracle/oracle_epas_comparison/operational_capabilities.mdx b/advocacy_docs/migrating/oracle/oracle_epas_comparison/operational_capabilities.mdx
@@ -32,7 +32,7 @@ You can optimize database operations through various means to deliver higher per
 | Write scalabality                 | Yes <br/> RAC | No                           | 
 | Read scalability                 | Yes <br/> Using Active Data Guard or RAC |  Yes <br/> Achieved with read replicas |
 | In-memory database               | Yes                    | No                           | 
-| Multi-master read/write solution | Yes <br/> Using Advanced Replication, Streams, or GoldenGate | Yes <br/> PostgreSQL-BDR or Replication Server |
+| Multi-master read/write solution | Yes <br/> Using Advanced Replication, Streams, or GoldenGate | Yes <br/> EDB Postgres Distributed or Replication Server |
 | Columnar store                   | Yes <br/> Using in-memory column store | No                           |
 | CPU and I/O resource limits      | Yes                    | Yes                          |
 
@@ -53,9 +53,9 @@ Database security consists of many dimensions, including secure connections, pas
 | User/group/role support                                   | Yes                                                      | Yes ✓                        |
 | Virtual Private Database (VPD) / Row Level Security (RLS) | Yes                                                      | Yes                          |
 | View security barriers                                    | No                                                       | Yes                          |
-| Transparent Data Encryption                               | Yes                                                      | Yes <br/> Using Thales CipherTrust Transparent Encryption or OS/File System Encryption options |
-| Data masking                                              | Yes                                                      | No                                                                                             |
-| Data redaction                                            | Yes                                                      | Yes ✓                                                                                          |
+| Transparent Data Encryption                               | Yes                                                      | Yes                          |
+| Data masking                                              | Yes                                                      | No                           |
+| Data redaction                                            | Yes                                                      | Yes ✓                        |
 | Real Application Security                                 | Yes                                                      | Partial <br/> Only DBMS_RLS functionality                                                      |
 | Database Vault                                            | Yes                                                      | No                                                                                             |
 | Audit Vault and Database Firewall                         | Yes                                                      | Partial <br/> Database firewall only (SQL/protect)                                             |
@@ -83,6 +83,12 @@ Using DBMS_CRYPTO:
 -  MD4, MD5, and SHA-1 hash functions.
 -  Generate cryptographically strong random values.
 
+Using [EDB Transparent Data Encryption](https://www.enterprisedb.com/docs/tde/latest/):
+-  Encrypts all Postgres user data stored on disk.
+-  Prevents unauthorized viewing of data in operating system files on the database server and on backup storage
+-  No application changes or updated client drivers.
+-  Flexible Key Management architecture.
+
 Using disk partition encryption:
 -  File system disk partition is encrypted/decrypted by the OS.
 -  Protects all files in the database partition, including temporary files.

diff --git a/install_template/templates/platformBase/base.njk b/install_template/templates/platformBase/base.njk
@@ -20,6 +20,7 @@ Before you begin the installation process:
   Setting up the repository is a one-time task. If you have already set up your repository, you do not need to perform this step. 
 
   To set up the repository, go to [EDB repositories](https://www.enterprisedb.com/repos-downloads) and follow the instructions provided there.
+
 {% endblock pemprereq %}{% block prerequisites %}{% endblock prerequisites %}
 
 ## Install the package

diff --git a/install_template/templates/products/postgres-enterprise-manager-server/base.njk b/install_template/templates/products/postgres-enterprise-manager-server/base.njk
@@ -12,10 +12,23 @@ redirects:
   - pem/{{ product.version }}/installing_pem_server/pem_server_inst_linux/installing_pem_server_using_edb_repository/{{deploy.expand_arch[platform.arch]}}/pem_server_{{deploy.map_platform_old[platform.name]}}_{{platform.arch | replace(r/_?64/g, "")}}.mdx
 {% endblock frontmatter %}
 
-{% block prodprereq %}
-- Review the [prerequisites](/pem/latest/installing/prerequisites/).
+{% block prodprereq %}{% endblock prodprereq %}{% block pemprereq %}
+- Set up the repository
 
-{% endblock prodprereq %}{% block pemprereq %}{% endblock pemprereq %}{% block pemsetuprepo %}{% endblock pemsetuprepo %}
+  Setting up the repository is a one-time task. If you have already set up your repository, you do not need to perform this step. 
+
+  - To set up the EDB repository, go to [EDB repositories](https://www.enterprisedb.com/repos-downloads) and follow the instructions provided there.
+
+  - To set up the PostgreSQL community repository, go to [yum](https://www.postgresql.org/download/linux/redhat/) or [apt](https://wiki.postgresql.org/wiki/Apt).
+
+  !!! Note
+    The PostgreSQL community repository is required only if you are using PostgreSQL as the backend database for PEM server.
+
+- Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/installing/) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/).
+
+- Review [configuration and authentication requirements](/pem/latest/installing/prerequisites/) for PEM.
+
+{% endblock pemprereq %}{% block pemsetuprepo %}{% endblock pemsetuprepo %}
 {% block postinstall %}
 ## Initial configuration
 

diff --git a/product_docs/docs/biganimal/release/reference/api.mdx b/product_docs/docs/biganimal/release/reference/api.mdx
@@ -143,7 +143,7 @@ For example:
 {
   "access_token": "eyJhbGc.......1Qtkaw2fyho",
   "id_token": "eyJhbGci.......FBra7tA",
-  "refresh_token": "v3.MTvuZpu.......sbiionEhtTw",
+  "refresh_token": "v1.MTvuZpu.......sbiionEhtTw",
   "scope": "openid profile email offline_access",
   "expires_in": 86400,
   "token_type": "Bearer"
@@ -154,7 +154,7 @@ Store the access token and refresh token in environment variables for future use
 
 ```ini
 RAW_ACCESS_TOKEN="eyJhbGc.......1Qtkaw2fyho"
-REFRESH_TOKEN="v3.MTvuZpu.......sbiionEhtTw"
+REFRESH_TOKEN="v1.MTvuZpu.......sbiionEhtTw"
 ```
 
 !!!note
@@ -274,7 +274,7 @@ The response of this API call includes the `access_token`. For example:
   "expires_in": 86400,
   "scope": "openid offline_access",
   "id_token": "eyJ...0NE",
-  "refresh_token": "v3.Mjv..._2pRs",
+  "refresh_token": "v1.Mjv..._2pRs",
   "token_type": "Bearer"
 }
 ```
@@ -283,7 +283,7 @@ Store the access token and refresh token in environment variables for future use
 
 ```ini
 RAW_ACCESS_TOKEN="eyJhbGc.......1Qtkaw2fyho"
-REFRESH_TOKEN="v3.MTvuZpu.......sbiionEhtTw"
+REFRESH_TOKEN="v1.MTvuZpu.......sbiionEhtTw"
 ```
 
 The token you obtain from this step is the raw-access token. You need to exchange this token for a BigAnimal token. See [Exchange for BigAnimal token](#exchange-the-biganimal-token-using-curl) for more information.
@@ -345,11 +345,11 @@ xxxxxxxxxx
 To use the `get-token` script to refresh your token, use the script with the `--refresh  <refresh_token>` option. For example:
 
 ```shell
-./get-token.sh -o json --refresh v3.MVZ9_xxxxxxxx_FRs
+./get-token.sh -o json --refresh v1.MVZ9_xxxxxxxx_FRs
 __OUTPUT__
 {
-  "access_token": "xxxxxxxxxx",
-  "refresh_token": "xxxxxxxxxxxx",
+  "access_token": "eyJhbGc.......1Qtkaw2fyho",
+  "refresh_token": "v1.MVZ9_xxxxxxxx_FRs",
   "scope": "openid profile email offline_access",
   "expires_in": 86400,
   "token_type": "Bearer"

diff --git a/product_docs/docs/epas/14/connectors.mdx b/product_docs/docs/epas/14/connectors.mdx
@@ -0,0 +1,19 @@
+---
+title: Connecting to your database
+---
+
+We package and support a number of components to connect to your EDB Postgres Advanced Server database server. These EDB components are enhanced versions of the corresponding PostgreSQL components and are intended to support additional EDB Postgres Advanced Server capabilities.     
+
+The EDB components for connecting to your database include:
+
+  - [EDB JDBC Connector](/jdbc_connector/latest/) &mdash; provides connectivity between a Java application and a Postgres database server. 
+
+  - [EDB .NET Connector](/net_connector/latest/) &mdash; provides connectivity between a .NET client application and a Postgres database server
+
+  - [EDB OCL Connector](/jdbc_connector/latest/) &mdash; provides an API similar to the Oracle Call Interface that you can use to interact with a Postgres database server.
+
+  - [EDB ODBC Connector](/odbc_connector/latest/) &mdash; allows an ODBC-compliant client application to connect to a Postgres database server
+
+
+
+
diff --git a/product_docs/docs/epas/14/data_sources.mdx b/product_docs/docs/epas/14/data_sources.mdx
@@ -0,0 +1,15 @@
+---
+title: Connecting to external data sources
+---
+
+We package and support a number of open source components to connect your Postgres database server to external data sources. These EDB components are enhanced versions of the corresponding PostgreSQL components and are intended to support additional EDB Postgres Advanced Server capabilities. 
+
+The EDB components for connecting to external databases include:
+
+  - [EDB Hadoop Foreign Data Wrapper](/jdbc_connector/latest/installing/) &mdash;  accesses data that resides on a Hadoop file system from a Postgres database server
+
+  - [MongoDB Foreign Data Wrapper](/mongo_data_adapter/latest/) &mdash;  accesses data that resides on a MongoDB database from a Postgres database server
+
+  - [MySQL Foreign Data Wrapper](/mysql_data_adapter/latest/) &mdash;  accesses data that resides on a MySQL database from a Postgres database server
+
+
diff --git a/product_docs/docs/epas/14/index.mdx b/product_docs/docs/epas/14/index.mdx
@@ -9,15 +9,16 @@ navigation:
   - epas_limitations
   - "#Planning"
   - deployment_options
+  - components
   - "#Installing and Upgrading"
   - installing
   - upgrading
   - uninstalling
   - troubleshooting
-  - "#Quick Start Guides"
-  - epas_qs_linux_7
-  - epas_qs_linux_8
-  - epas_qs_windows
+  - "#Developing"
+  - connectors
+  - managing_connections
+  - data_sources
   - "#Oracle Compatibility Guides"
   - epas_compat_ora_dev_guide
   - epas_compat_reference
@@ -34,10 +35,15 @@ navigation:
   - epas_security_guide
   - epas_guide
   - edb_plus
+  - "#Quick Start Guides"
+  - epas_qs_linux_7
+  - epas_qs_linux_8
+  - epas_qs_windows
 legacyRedirectsGenerated:
   # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
   - "/edb-docs/p/edb-postgres-advanced-server/9.6"
   - "/edb-docs/p/edb-postgres-advanced-server/9.5"
 ---
 
-  With EDB Postgres Advanced Server, EnterpriseDB continues to lead as the only worldwide company to deliver innovative and low-cost, open-source-derived database solutions with commercial quality, ease of use, compatibility, scalability, and performance for small or large-scale enterprises.
+  With EDB Postgres Advanced Server, we continue to lead as the only worldwide company to deliver innovative and low-cost, open-source-derived database solutions with commercial quality, ease of use, compatibility, scalability, and performance for small or large-scale enterprises.
+
diff --git a/product_docs/docs/epas/14/managing_connections.mdx b/product_docs/docs/epas/14/managing_connections.mdx
@@ -0,0 +1,15 @@
+---
+title: Managing your database connections
+---
+
+We package and support a number of open source components to manage your connections to your EDB Postgres Advanced Server database server. These EDB components are enhanced versions of the corresponding PostgreSQL components and are intended to support additional EDB Postgres Advanced Server capabilities.  
+
+The EDB components for managing your database connections include:
+
+  - [EDB PgBouncer](/pgbouncer/latest/) &mdash; a lightweight connection pooling utility for Postgres installations
+
+  - [EDB Pgpool-II](/pgpool/latest/) &mdash; acts as middleware between client applications and a Postgres database server
+
+
+
+
diff --git a/product_docs/docs/epas/15/connectors.mdx b/product_docs/docs/epas/15/connectors.mdx
@@ -0,0 +1,19 @@
+---
+title: Connecting to your database
+---
+
+We package and support a number of components to connect to your EDB Postgres Advanced Server database server. These EDB components are enhanced versions of the corresponding PostgreSQL components and are intended to support additional EDB Postgres Advanced Server capabilities.     
+
+The EDB components for connecting to your database include:
+
+- [EDB JDBC Connector](/jdbc_connector/latest/) &mdash; provides connectivity between a Java application and a Postgres database server. 
+
+- [EDB .NET Connector](/net_connector/latest/) &mdash; provides connectivity between a .NET client application and a Postgres database server
+
+- [EDB OCL Connector](/jdbc_connector/latest/) &mdash; provides an API similar to the Oracle Call Interface that you can use to interact with a Postgres database server.
+
+- [EDB ODBC Connector](/odbc_connector/latest/) &mdash; allows an ODBC-compliant client application to connect to a Postgres database server
+
+
+
+
diff --git a/product_docs/docs/epas/15/data_sources.mdx b/product_docs/docs/epas/15/data_sources.mdx
@@ -0,0 +1,15 @@
+---
+title: Connecting to external data sources
+---
+
+We package and support a number of open source components to connect your Postgres database server to external data sources. These EDB components are enhanced versions of the corresponding PostgreSQL components and are intended to support additional EDB Postgres Advanced Server capabilities. 
+
+The EDB components to connect external data sources include:
+
+  - [EDB Hadoop Foreign Data Wrapper](/jdbc_connector/latest/installing/) &mdash;  accesses data that resides on a Hadoop file system from a Postgres database server
+
+  - [MongoDB Foreign Data Wrapper](/mongo_data_adapter/latest/) &mdash;  accesses data that resides on a MongoDB database from a Postgres database server
+
+  - [MySQL Foreign Data Wrapper](/mysql_data_adapter/latest/) &mdash;  accesses data that resides on a MySQL database from a Postgres database server
+
+
diff --git a/product_docs/docs/epas/15/index.mdx b/product_docs/docs/epas/15/index.mdx
@@ -14,6 +14,10 @@ navigation:
   - upgrading
   - uninstalling
   - troubleshooting
+  - "#Developing"
+  - connectors
+  - managing_connections
+  - data_sources 
   - "#Oracle Compatibility Guides"
   - epas_compat_ora_dev_guide
   - epas_compat_reference

diff --git a/product_docs/docs/epas/15/managing_connections.mdx b/product_docs/docs/epas/15/managing_connections.mdx
@@ -0,0 +1,15 @@
+---
+title: Managing your database connections
+---
+
+We package and support a number of open source components to manage your connections to your EDB Postgres Advanced Server database server. These EDB components are enhanced versions of the corresponding PostgreSQL components and are intended to support additional EDB Postgres Advanced Server capabilities.  
+
+The EDB components for managing your database connections include:
+
+- [EDB PgBouncer](/pgbouncer/latest/) &mdash; a lightweight connection pooling utility for Postgres installations
+
+- [EDB Pgpool-II](/pgpool/latest/) &mdash; acts as middleware between client applications and a Postgres database server
+
+
+
+