Merge pull request #1502 from EnterpriseDB/release/2021-06-23

Release/2021 06 23

Former-commit-id: 2f3d72e

product_docs/docs/efm/4.2/efm_user/07_using_efm_utility.mdx

@@ -4,7 +4,7 @@ title: "Using the efm Utility"
 
 <div id="using_efm_utility" class="registered_link"></div>
 
-Failover Manager provides the efm utility to assist with cluster management. The RPM installer adds the utility to the `/usr/edb/efm-42/bin` directory when you install Failover Manager.
+Failover Manager provides the efm utility to assist with cluster management. The RPM installer adds the utility to the `/usr/edb/efm-4.2/bin` directory when you install Failover Manager.
 
 **efm allow-node**
 

product_docs/docs/epas/12/epas_compat_sql/21_create_public_database_link.mdx

@@ -40,10 +40,9 @@ For information about high availability, load balancing, and replication for Pos
 <https://www.postgresql.org/docs/12/static/high-availability.html>
 
 !!! Note
-    For Advanced Server 12, the `CREATE DATABASE LINK` command is tested against and certified for use with Oracle version 10g Release 2 (10.2), Oracle version 11g Release 2 (11.2), and Oracle version 12c Release 1 (12.1).
-
-!!! Note
-    The `edb_dblink_oci.rescans` GUC can be set to `SCROLL` or `SERIALIZABLE` at the server level in `postgresql.conf` file. It can also be set at session level using the `SET` command, but the setting will not be applied to existing dblink connections due to dblink connection caching.
+    -  For Advanced Server 12, the `CREATE DATABASE LINK` command is tested against and certified for use with Oracle version 10g Release 2 (10.2), Oracle version 11g Release 2 (11.2), and Oracle version 12c Release 1 (12.1).
+    -  The `edb_dblink_oci.rescans` GUC can be set to `SCROLL` or `SERIALIZABLE` at the server level in `postgresql.conf` file. It can also be set at session level using the `SET` command, but the setting will not be applied to existing dblink connections due to dblink connection caching.
+    -  When executing `SELECT` on LOB data of more than 4000 characters, it is advisable to use `edb_dblink_oci.rescans=serializable` to free up the temporary PGA memory and avoid exceeding the `PGA_AGGREGATE_LIMIT`.
 
 The `edb_dblink_oci` supports both types of rescans: `SCROLL` and `SERIALIZABLE`. By default it is set to `SERIALIZABLE`. When set to `SERIALIZABLE`, `edb_dblink_oci` uses the `SERIALIZABLE` transaction isolation level on the Oracle side, which corresponds to PostgreSQL’s `REPEATABLE READ`.
 

product_docs/docs/epas/13/epas_compat_sql/21_create_public_database_link.mdx

@@ -40,10 +40,9 @@ For information about high availability, load balancing, and replication for Pos
 <https://www.postgresql.org/docs/current/static/high-availability.html>
 
 !!! Note
-    For Advanced Server 12, the `CREATE DATABASE LINK` command is tested against and certified for use with Oracle version 10g Release 2 (10.2), Oracle version 11g Release 2 (11.2), and Oracle version 12c Release 1 (12.1).
-
-!!! Note
-    The `edb_dblink_oci.rescans` GUC can be set to `SCROLL` or `SERIALIZABLE` at the server level in `postgresql.conf` file. It can also be set at session level using the `SET` command, but the setting will not be applied to existing dblink connections due to dblink connection caching.
+    -  For Advanced Server 12, the `CREATE DATABASE LINK` command is tested against and certified for use with Oracle version 10g Release 2 (10.2), Oracle version 11g Release 2 (11.2), and Oracle version 12c Release 1 (12.1).
+    -  The `edb_dblink_oci.rescans` GUC can be set to `SCROLL` or `SERIALIZABLE` at the server level in `postgresql.conf` file. It can also be set at session level using the `SET` command, but the setting will not be applied to existing dblink connections due to dblink connection caching.
+    -  When executing `SELECT` on LOB data of more than 4000 characters, it is advisable to use `edb_dblink_oci.rescans=serializable` to free up the temporary PGA memory and avoid exceeding the `PGA_AGGREGATE_LIMIT`.
 
 The `edb_dblink_oci` supports both types of rescans: `SCROLL` and `SERIALIZABLE`. By default it is set to `SERIALIZABLE`. When set to `SERIALIZABLE`, `edb_dblink_oci` uses the `SERIALIZABLE` transaction isolation level on the Oracle side, which corresponds to PostgreSQL’s `REPEATABLE READ`.
 

product_docs/docs/eprs/6.2/01_introduction/03_certified_supported_versions.mdx

@@ -9,6 +9,8 @@ The following database product versions may be used with xDB Replication Server:
 -   Oracle 10g Release 2 version 10.2.0.1.0 has been explicitly certified. Newer minor versions in the 10.2 line are supported as well.
 -   Oracle 11g Release 2 version 11.2.0.2.0 has been explicitly certified. Newer minor versions in the 11.2 line are supported as well.
 -   Oracle 12c version 12.1.0.2.0 has been explicitly certified. Newer minor versions in the 12.1 line are supported as well.
+-   Oracle 18c version 18.1.0.2.0 has been explicitly certified. Newer minor versions in the 18.1 line are supported as well.
+-   Oracle 19c version 19.1.0.2.0 has been explicitly certified. Newer minor versions in the 19.1 line are supported as well.
 -   SQL Server 2008 version 10.50.1617.0 has been explicitly certified. Newer minor versions in the 10.50 line are supported as well.
 -   SQL Server 2012 version 11.0.6020.0 has been explicitly certified. Newer minor versions in the 11.0 line are supported as well.
 -   SQL Server 2014 version 12.0.5000.0 has been explicitly certified. Newer minor versions in the 12.0 line are supported as well.

product_docs/docs/eprs/6.2/05_smr_operation/01_prerequisites/04_preparing_pub_database.mdx

@@ -70,13 +70,20 @@ GRANT CREATE ANY TRIGGER TO pubuser;
 GRANT LOCK ANY TABLE TO pubuser;
 ```
 
-**Step 5 (For Oracle 12c only):** Grant the privileges required to access tablespaces. The `GRANT UNLIMITED TABLESPACE` privilege must be granted to the publication database user. This requirement applies to both a pluggable database and a non-container database.
+**Step 5 (For Oracle 12c onward):** Grant the privileges required to access tablespaces. The `GRANT UNLIMITED TABLESPACE` privilege must be granted to the publication database user. This requirement applies to both a pluggable database and a non-container database.
 
 ```text
 GRANT UNLIMITED TABLESPACE TO pubuser;
 ```
+**Step 6 (For Oracle 19c onward):** `CREATE JOB` privilege is necessary for the publication database user to schedule a job.
 
-**Step 6:** The publication database user must be able to read the tables and views that are to be included in publications.
+This requirement applies to both pluggable as well as non-container databases.
+
+```text
+GRANT CREATE JOB TO pubuser;
+```
+
+**Step 7:** The publication database user must be able to read the tables and views that are to be included in publications.
 
 ```text
 GRANT SELECT ON edb.dept TO pubuser;
@@ -85,7 +92,7 @@ GRANT SELECT ON edb.jobhist TO pubuser;
 GRANT SELECT ON edb.salesemp TO pubuser;
 ```
 
-**Step 7 (Optional):** Create one or more `group` roles containing the required privileges to access the tables and views of the publications that will be needed by application users.
+**Step 8 (Optional):** Create one or more `group` roles containing the required privileges to access the tables and views of the publications that will be needed by application users.
 
 Using roles is convenient if you wish to add new application users who need privileges to `select, insert, update`, or `delete` from any of the publication tables. A role containing the required privileges can then be granted to the new users instead of granting each privilege individually to each user.
 

product_docs/docs/migration_portal/3.2.0/01_whats_new.mdx

@@ -0,0 +1,13 @@
+---
+title: "What's New"
+
+legacyRedirectsGenerated:
+  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
+  - "/edb-docs/d/edb-postgres-migration-portal/user-guides/user-guide/3.2.0/whats_new.html"
+---
+
+<div id="whats_new" class="registered_link"></div>
+
+The following is added to the Migration Portal for the release 3.2.0:
+
+- Enablement of Oracle 18c and 19c DDL extracts and schema assessments using Migration Portal

product_docs/docs/migration_portal/3.2.0/02_supported_platforms.mdx

@@ -0,0 +1,30 @@
+---
+title: "Supported Platforms"
+
+legacyRedirectsGenerated:
+  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
+  - "/edb-docs/d/edb-postgres-migration-portal/user-guides/user-guide/3.2.0/supported_versions.html"
+---
+
+<div id="supported_platforms" class="registered_link"></div>
+
+The Migration Portal supports assessment and migration from Oracle 11g, 12c, 18c, and 19c to EDB Postgres Advanced Server 10, 11, 12, or 13. Migration Portal is supported on the following browsers and operating systems:
+
+**Supported Browsers**
+
+For the best user experience, we recommend using the Google Chrome browser. Migration Portal is also supported on the following browsers:
+
+| **Browser**                  | **Supported Version** |
+| ---------------------------- | --------------------- |
+| Apple Safari on Macintosh OS | 11 and above          |
+| Google Chrome                | 68 and above          |
+| Microsoft Edge               | 42 and above          |
+| Mozilla Firefox              | 60 and above          |
+
+**Supported Operating Systems**
+
+| **Operating Systems** | **Supported Version** |
+| --------------------- | --------------------- |
+| Macintosh             | OS X Sierra           |
+| Windows               | 10                    |
+| Linux                 | CentOS 7              |

product_docs/docs/migration_portal/3.2.0/03_mp_using_portal/01_mp_overview_home.mdx

@@ -0,0 +1,44 @@
+---
+title: "Overview of the Migration Portal Home Page"
+
+legacyRedirectsGenerated:
+  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
+  - "/edb-docs/d/edb-postgres-migration-portal/user-guides/user-guide/3.2.0/mp_overview_home.html"
+---
+
+<div id="mp_overview_home" class="registered_link"></div>
+
+The Migration Portal home page provides quick access to migration tools.
+
+![The Migration Portal home page.](../images/mp_overview_home.png)
+
+*Figure 2-3: The Migration Portal home*
+
+The Migration Portal home page allows access to the following Migration Portal features:
+
+1.  **Projects**: The `Projects` panel displays a list of assessed projects.
+
+2.  **Create project**: Click `+ New` (the button located to the right of the `Projects` label) to create a new project.
+
+!!!Note
+    Uploading large DDL files might freeze or crash the browser (depending on the browser and the system resources in use). In this scenario, try running Migration Portal in a different browser or extracting fewer schemas and uploading that file on Migration Portal.
+
+3.  **Search projects**: Use the `Search` box to search for projects.
+
+4.  **Overview**: The `Overview` panel provides details about the selected project and displays the compatibility percentage after schema assessment.
+
+5.  **Migrate to**: Use the `Migrate to` button to either download an EDB Postgres Advanced Server compatible `.sql` file or migrate a schema to an EDB Postgres Advanced Server on-premise or on the cloud. For more information, see [Schema Migration](../04_mp_migrating_database/03_mp_schema_migration/#mp_schema_migration).
+
+6.  **Report**: Use the `Report` button to view and download the schema assessment report.
+
+7.  **Delete**: Use the `Delete` button to delete a selected project.
+
+8.  **Warning sign**: A warning message is displayed if a project or a schema is less than 70% compatible or any DDL doesn’t succeed after multiple attempts.
+
+9.  **Upload DDL file**: Use the `Upload new schema` button to upload a new or additional DDL file.
+
+10. **Schemas**: The `Schemas` panel displays the assessment result from an uploaded DDL file.
+
+11. **Quick help**: The `Quick help` panel contains quick handles to a few required resources.
+
+12. **Portal Wiki**: The `Portal Wiki` has links to product information and different help guides.

product_docs/docs/migration_portal/3.2.0/03_mp_using_portal/02_mp_overview_project.mdx

@@ -0,0 +1,51 @@
+---
+title: "Overview of the Migration Portal Projects Page"
+
+legacyRedirectsGenerated:
+  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
+  - "/edb-docs/d/edb-postgres-migration-portal/user-guides/user-guide/3.2.0/mp_overview_project.html"
+---
+
+<div id="mp_overview_project" class="registered_link"></div>
+
+The Migration Portal Projects page provides detailed information about your migration.
+
+![The Migration Portal Projects Page overview.](../images/mp_overview_project_numbered.png)
+
+*Figure 2-4: The Migration Portal Projects Page overview*
+
+Use the following resources to gather information about your migration projects:
+
+1.  **Compatible**: The `Compatible` gauge displays the color on the basis of the compatibility percentage of the assessed schema.
+
+2.  **Schema Count**: Displays the number of schemas in a project.
+
+3.  **Migrate to**: Use the `Migrate to` to migrate the schema to an *EDB Postgres Advanced Server* on-prmise or on cloud.
+
+4.  **Search objects**: Use the `Search` box to search for objects.
+
+5.  **Filters**: You can filter the system repaired and manual repaired objects from the left panel of the Projects page. In addition, you can select one or more filter combinations to refine the information.
+
+6.  **Objects**: Displays the objects for the selected schemas.
+
+7.  **Common Failures**: Displays the reason for the failed objects for the selected schemas.
+
+    ![Common Failures tab](../images/mp_whats_new_common_failures.png)
+
+    *Figure 2-5: Common Failures tab*
+
+    !!! Note
+        You can download a `CSV` file for the common failures for the project.
+
+8.  **Schema**: The `Schema` panel displays the result of the assessment.
+
+9.  **Tooltip**: Hover over a result set to display a tooltip with the number of passed, failed, and repaired objects.
+
+
+10. **Quick help**: The `Quick help` panel displays links to Knowledge base articles and repair handler documentation.
+
+11. **Search**: Use the `Search` box to search the `Knowledge base` entries or repair handler documentation for specific information.
+
+![Searching the Knowledge Base entry.](../images/mp_overview_project_kb.png)
+
+*Figure 2-6: Searching the Knowledge Base entry*

product_docs/docs/migration_portal/3.2.0/03_mp_using_portal/03_mp_overview_wiki.mdx

@@ -0,0 +1,25 @@
+---
+title: "Overview of the Migration Portal Wiki Page"
+
+legacyRedirectsGenerated:
+  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
+  - "/edb-docs/d/edb-postgres-migration-portal/user-guides/user-guide/3.2.0/mp_overview_wiki.html"
+---
+
+<div id="mp_overview_wiki" class="registered_link"></div>
+
+The Portal Wiki page provides quick access to:
+
+-   What’s New information
+-   Quick Start guide
+-   Migrating Schema
+-   Migrating Data
+-   DDL Extractor guide
+-   Knowledge Base
+-   Repair handlers
+-   Migration Portal User's Guide
+-   FAQs
+
+![The Migration Portal Wiki page.](../images/mp_overview_wiki.png)
+
+*Figure 2-7: The Migration Portal Wiki page*

product_docs/docs/migration_portal/3.2.0/03_mp_using_portal/index.mdx

@@ -0,0 +1,38 @@
+---
+title: "Using Migration Portal"
+
+legacyRedirectsGenerated:
+  # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
+  - "/edb-docs/d/edb-postgres-migration-portal/user-guides/user-guide/3.2.0/mp_using_portal.html"
+---
+
+<div id="mp_using_portal" class="registered_link"></div>
+
+Migration Portal allows you to easily migrate your database schema from Oracle to EDB Postgres Advanced Server. You can upload schemas for assessment and get immediate feedback and suggestions. The portal allows you to download assessed DDLs for all objects and create your EDB Postgres database on-premises or in the cloud.
+
+![The assessment and migration process](../images/mp_using_portal.png)
+
+*Figure 2-1: The assessment and migration process*
+
+!!! Note
+    Migration Portal currently does not have team collaboration features. We recommend collaborative meetings, screen sharing, and using the downloadable assessment report to share results.
+
+To access the Migration Portal:
+
+1.  Open a browser and navigate to <https://www.edbpostgres.com/>.
+
+2.  On the EnterpriseDB home page, click `Products` > `Migration Portal`.
+
+![Accessing the Migration Portal.](../images/mp_using_portal_accessing.png)
+
+*Figure 2-2: The assessment and migration process*
+
+3.  Click `Open Migration Portal`.
+
+4.  Log in using your credentials.
+
+<div class="toctree" maxdepth="3">
+
+mp_overview_home mp_overview_project mp_overview_wiki
+
+</div>