Merge pull request #4423 from EnterpriseDB/release/2023-07-13

Release: 2023-07-13
EnterpriseDB · Jul 13, 2023 · 3e0b8ad · 3e0b8ad · github-actions · Jul 13, 2023
2 parents a283e64 + acc3aac
commit 3e0b8ad
Show file tree

Hide file tree

Showing 87 changed files with 955 additions and 311 deletions.
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/02-PartnerInformation.mdx b/advocacy_docs/partner_docs/PreciselyConnectCDC/02-PartnerInformation.mdx
@@ -0,0 +1,12 @@
+---
+title: 'Partner Information'
+description: 'Details of the partner'
+
+---
+| &nbsp;     | &nbsp; |
+| ----------- | ----------- |
+| **Partner Name**      | Precisely       |
+| **Partner Product**   |  Precisely Connect CDC (Change Data Capture)      |
+| **Web Site**      |  https://www.precisely.com/    |
+| **Version**   |  Precisely Connect CDC V5.8     |
+| **Product Description**      |  Precisely Connect CDC (Change Data Capture) provides real-time data replication and change data capture functionality. Integrate data seamlessly from legacy systems into next-gen cloud and data platforms with one solution. Seamless data access and collection, Precisely Connect CDC helps you take control of your data from mainframe to cloud. Integrate data through batch and real-time ingestion for advanced analytics, comprehensive machine learning and seamless data migration. Precisely Connect CDC leverages the expertise Precisely has built over decades as a leader in mainframe sort and IBM i data availability and security. Access to all your enterprise data for the most critical business projects is ensured by support for a wide range of sources and targets for all your ETL and change data capture (CDC) needs including EDB Postgres Advanced Server and PostgreSQL.   |
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/03-SolutionSummary.mdx b/advocacy_docs/partner_docs/PreciselyConnectCDC/03-SolutionSummary.mdx
@@ -0,0 +1,14 @@
+---
+title: 'Solution Summary'
+description: 'Explanation of the solution and its purpose'
+---
+
+Precisely Connect CDC (Change Data Capture) provides real-time data replication and change data capture functionality. Precisely Connect CDC real-time replication ensures that databases are in-sync for reporting, analytics, and data warehousing. You can replicate changes as they happen across hierarchical data stores (IMS, VSAM), relational databases, streaming frameworks, and the cloud.
+
+Precisely Connect CDC supports EDB Postgres Advanced Server and PostgreSQL databases in different modes as either a source or target database for real-time data replication and change data capture functionality.
+
+<p align="center">
+  <img src="Images/ConnectCDCSolutionSummary.png">
+</p>
+
+EDB Postgres Advanced Server and PostgreSQL can be either the Source Database or Target Database in the diagram dependent on your configuration.
diff --git a/...y_docs/partner_docs/PreciselyConnectCDC/04-Configuratingpreciselyconnectcdc.mdx b/...y_docs/partner_docs/PreciselyConnectCDC/04-Configuratingpreciselyconnectcdc.mdx
@@ -0,0 +1,50 @@
+---
+title: 'Configuration'
+description: 'Walkthrough on configuring the integration'
+---
+
+## Prerequisites
+
+Implementing Precisely Connect CDC with EDB Postgres Advanced Server requires the following components:
+
+!!! Note
+     The EDB Postgres Advanced Server, EDB Postgres Extended Server and PostgreSQL Server products will be referred to as Postgres Distribution. The specific Distribution type will be dependent upon customer need or preference.
+
+- Precisely supported source and target systems. The source, target or both can be your Postgres Distribution(s). In our example we will be using EDB Postgres Advanced Server for both the source and target database.
+- Precisely Connect CDC software.
+- PostgreSQL management tool such as pgAdmin or Postgres Enterprise Manager.  In our example we will use pgAdmin. This tool will be used to verify that the data is being replicated as expected.
+
+## Configuring your PostgreSQL Distribution
+
+These components are needed before integrating PostgreSQL Distribution with Precisely Connect CDC:
+
+1. Two running instances of EDB Postgres Advanced Server.
+
+2. pgAdmin must be installed on the Source and Target EDB Postgres Advanced Server instances.
+
+3. A running instance of Precisely Connect CDC.
+
+![Configuration of PostgreSQL Distribution](Images/configureepas.png)
+
+## Enable WAL Archiving
+
+The following steps demonstrate how to enable WAL Archiving on the Source EDB Postgres Advanced Server instance, which is required for Precisely Connect CDC’s replication functionality.
+
+1. Go to the installation directory of EDB Postgres Advanced Server (e.g `C:\Program Files\edb\as14\`).
+
+2. Go to the data directory and open the postgresql.conf file.
+
+3. Modify the following settings as per the given values.
+
+```yaml
+archive_mode = on
+wal_level = logical
+archive_command = 'copy "%p" "C:\\archive_wal_directory\\%f"'    
+max_replication_slots = 20
+
+```
+
+4. Restart the EDB Postgres Advanced Server Source instance.
+
+!!! Note
+     No configuration e.g WAL Archiving is required on Target EDB Postgres Advanced Server instance.
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/05-Usingpreciselyconnectcdc.mdx b/advocacy_docs/partner_docs/PreciselyConnectCDC/05-Usingpreciselyconnectcdc.mdx
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/06-CertificationEnvironment.mdx b/advocacy_docs/partner_docs/PreciselyConnectCDC/06-CertificationEnvironment.mdx
@@ -0,0 +1,10 @@
+---
+title: 'Certification Environment'
+description: 'Overview of the Certification Environment'
+---
+
+|  &nbsp;    | &nbsp; |
+| ----------- | ----------- |
+| **Certification Test Date**      | June 12, 2023       |
+| **EDB Postgres Advanced Server**      | 15,14,13,12      |
+| **Precisely Connect CDC**  |  5.8     |
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/07-Support.mdx b/advocacy_docs/partner_docs/PreciselyConnectCDC/07-Support.mdx
@@ -0,0 +1,42 @@
+---
+title: 'Support and Logging Details'
+description: 'Details of the Support process and logging information'
+---
+
+## Support
+
+Technical support for the use of these products is provided by both EDB and Precisely.  A proper support contract is required to be in place at both EDB and Precisely.  A support ticket can be opened on either side to start the process.  If it is determined through the support ticket that resources from the other vendor is required, the customer should open a support ticket with that vendor through normal support channels.  This will allow both companies to work together to help the customer as needed.
+
+## Logging
+
+**EDB Postgres Advanced Server Logs:**
+
+Navigate to the `Data` directory in your chosen EDB Postgres Advanced Server instance and from here you can navigate to `log`, `current_logfiles` or you can navigate to the `postgresql.conf` file where you can customize logging options or enable `edb_audit` logs.
+
+**PostgreSQL Logs**
+
+The default log directories for PostgreSQL logs vary depending on the operating system:
+
+- Debian-based system: `/var/log/postgresql/postgresql-x.x.main.log. X.x.`
+
+- Red Hat-based system: `/var/lib/pgsql/data/pg_log`
+
+- Windows: `C:\Program Files\PostgreSQL\9.3\data\pg_log`
+
+**Precisely Logs**
+
+To collect the logs from your Precisely Connect CDC instance:
+
+**Get logs with Connect CDC Director**
+
+1. Open Connect CDC Director.
+
+2. Click the Tools button.
+
+3. Log File name and location will be displayed under Log File.
+
+**Get logs with Connect CDC MonCon**
+
+1. Open Connect CDC MonCon.
+
+2. The Connect CDC MonCon log file is located in the Connect CDC program directory in the kernel subdirectory. The name of the file is moncon.log.
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/46.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/46.png
diff --git a/...cacy_docs/partner_docs/PreciselyConnectCDC/Images/ConnectCDCSolutionSummary.png b/...cacy_docs/partner_docs/PreciselyConnectCDC/Images/ConnectCDCSolutionSummary.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/PartnerProgram.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/PartnerProgram.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/Process.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/Process.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/availabletables.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/availabletables.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/configureepas.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/configureepas.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/confirmtablesontarget.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/confirmtablesontarget.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/connectcdc.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/connectcdc.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/copyrequest.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/copyrequest.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/datatransformation1.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/datatransformation1.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/datatransformation2.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/datatransformation2.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/distributetables.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/distributetables.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/distributionmodel.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/distributionmodel.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/distrmodel.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/distrmodel.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/doneprepareuserdatabase.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/doneprepareuserdatabase.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/idpassword.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/idpassword.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/idpassword1.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/idpassword1.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/installmetabase.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/installmetabase.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/metabasesucces.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/metabasesucces.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/modelcommit.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/modelcommit.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/newdistribution.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/newdistribution.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/newhost.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/newhost.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/newmodel.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/newmodel.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/newserver.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/newserver.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgAdmin.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgAdmin.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgAdmincopydone.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgAdmincopydone.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgAdmincopydone2.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgAdmincopydone2.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgAdmintargettables.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgAdmintargettables.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgadming.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/pgadming.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/prepareuserdatabase.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/prepareuserdatabase.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/prepareuserdatabase2.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/prepareuserdatabase2.png
diff --git a/...acy_docs/partner_docs/PreciselyConnectCDC/Images/prepareuserdatabasesuccess.png b/...acy_docs/partner_docs/PreciselyConnectCDC/Images/prepareuserdatabasesuccess.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/refreshtables.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/refreshtables.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/replicationrequest.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/replicationrequest.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/replicationrequest2.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/replicationrequest2.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/replicationrequest3.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/replicationrequest3.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/rpuserpassword.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/rpuserpassword.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/schema2.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/schema2.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/schematoreplicate.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/schematoreplicate.png
diff --git a/...cacy_docs/partner_docs/PreciselyConnectCDC/Images/selecttableforreplication.png b/...cacy_docs/partner_docs/PreciselyConnectCDC/Images/selecttableforreplication.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/successserver.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/successserver.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/tablemappings.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/tablemappings.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetmetabasecreated.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetmetabasecreated.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetpgadmin.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetpgadmin.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetserver.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetserver.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetserverlogin.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetserverlogin.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetserveruserpass.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetserveruserpass.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targettablescreen.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targettablescreen.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetuserpassword.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targetuserpassword.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targtemetbase.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/targtemetbase.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/tstconnection.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/tstconnection.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/userpassword.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/userpassword.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/validmodel.png b/advocacy_docs/partner_docs/PreciselyConnectCDC/Images/validmodel.png
diff --git a/advocacy_docs/partner_docs/PreciselyConnectCDC/index.mdx b/advocacy_docs/partner_docs/PreciselyConnectCDC/index.mdx
@@ -0,0 +1,14 @@
+---
+title: 'Precisely Connect CDC Implementation Guide'
+indexCards: simple
+directoryDefaults:
+    iconName: handshake
+---
+
+<p align="center">
+  <img  src="Images/PartnerProgram.png">
+</p>
+<h1 style="text-align: center;">EDB GlobalConnect Technology Partner Implementation Guide</h1>
+<h3 style="text-align: center;">Precisely Connect CDC</h3>
+
+<p style="text-align: center;">This document is intended to augment each vendor’s product documentation in order to guide the reader in getting the products working together. It is not intended to show the optimal configuration for the certified integration.</p>
diff --git a/product_docs/docs/edb_plus/41/02_release_notes/edbplus_41.1_rel_notes.mdx b/product_docs/docs/edb_plus/41/02_release_notes/edbplus_41.1_rel_notes.mdx
@@ -6,4 +6,4 @@ New features, enhancements, bug fixes, and other changes in EDB*Plus 41.1.0 incl
 
 | Type        | Description                                                    |
 | ----------- | -------------------------------------------------------------- | 
-| Enhancement | The `COLUMN` command in EDB\*Plus has been enhanced to provide support for the `NEW_VALUE` parameter. The `NEW_VALUE` parameter defines a variable to hold the column value in a given EDB*Plus session. |
+| Enhancement | The `COLUMN` command in EDB\*Plus now provides support for the `NEW_VALUE` parameter. The `NEW_VALUE` parameter defines a variable to hold the column value in a given EDB\*Plus session. |