Skip to content

Commit

Permalink
Merge pull request #2117 from EnterpriseDB/release/2021-12-13
Browse files Browse the repository at this point in the history
Release: 2021-12-13
  • Loading branch information
drothery-edb authored Dec 13, 2021
2 parents 14ce8fc + 5fefbdf commit 69bdf24
Show file tree
Hide file tree
Showing 24 changed files with 342 additions and 95 deletions.
14 changes: 0 additions & 14 deletions product_docs/docs/eprs/6.2/01_introduction/01_whats_new.mdx

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@ title: "Certified and Supported Product Versions"

The following database product versions may be used with xDB Replication Server:

- PostgreSQL versions 9.6, 10, 11, 12, and 13
- Advanced Server versions 9.6, 10, 11, 12, and 13
- PostgreSQL versions 10, 11, 12, 13, and 14
- Advanced Server versions 10, 11, 12, 13, and 14
- 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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,13 @@ Oracle tables with the following data types can be used in snapshot-only publica
- `NCLOB`
- `RAW`

Columns with following data types cannot be added to a filter for a PostgreSQL or EDB Postgres Advanced Server database:

- `money`
- `bit`
- `bit varying`


## Restrictions on SQL Server Database Objects

SQL Server tables that include the following data types cannot be replicated:
Expand Down Expand Up @@ -82,27 +89,37 @@ PostgreSQL or EDB Postgres Advanced Server database tables that include the foll

- `JSON`
- `JSONB`
- Geometry data types
- `tsvector`, `tsquery`, `txid_snapshot`, `pg_lsn`
- `cidr`, `inet`, `mcaddress`, `mcaddress8`, `uuid`, `Date`
- `ENUM`, `ARRAY`, range data type (such as `int4range`, `tstzrange`, `numrange`, `daterange`)
- Any user-defined data type (that is, defined as `CREATE TYPE type_name`)


Postgres tables that include `OID` based large objects cannot be replicated. For information on `OID` based large objects see `pg_largeobject` in the PostgreSQL Core Documentation located at:

> <https://www.postgresql.org/docs/current/static/catalog-pg-largeobject.html>
Postgres tables that include `OID` based large objects cannot be replicated. For information on `OID` based large objects see [`pg_largeobject`](<https://www.postgresql.org/docs/current/static/catalog-pg-largeobject.html>) in the PostgreSQL Core Documentation.

Postgres tables that include any geometric data types such as POINT, POLYGON, etc., cannot be replicated to an Oracle subscription database.
Postgres tables that include any geometric data types such as POINT, POLYGON, etc., cannot be replicated to an Oracle subscription database.

Postgres tables that include the following data types cannot be replicated to a SQL Server subscription database:

- `ABSTIME`
- `ACLITEM`
- `CHKPASS`
- Geometric data types (such as `LINE`, `PATH`, `POLYGON`)
- `CIRCLE`
- `CUBE`
- `JSON`
- `JSON`
- `JSONB`
- `ROWID`
- `tsvector`, `tsquery`, `txid_snapshot`, `pg_lsn`
- `SEG`
- `Any ARRAY` data type (that is, defined as `data_type[]`)
- `ENUM`, composite type, range data type (such as `int4range`, `tstzrange`, `numrange`, `daterange`), `mcaddress8`
- Any user-defined data type (that is, defined as `CREATE TYPE type_name`)

!!! note
Tables containing columns of datatype `mcaddress8` can be replicated from PostgreSQL to PostgreSQL. However, replication from PostgreSQL to EDB Postgres Advanced Server and between EDB Postgres Advanced Servers is not supported.

**Restrictions on Range Data Types**

Postgres data types called range types were first supported in PostgreSQL version 9.2 and Advanced Server version 9.2. Built-in range types refer to the following built-in data types: `int4range, int8range, numrange, tsrange, tstzrange`, and `daterange`.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ To install any of the packages, invoke the following command as the root account

For example to install all xDB components, invoke the following:

`yum install ppas-xdb`
`yum install ppas-xdb --exclude edb-xdb`

To install only the xDB Replication Console and xDB Replication Server Command Line Interface, invoke the following:

Expand Down Expand Up @@ -126,12 +126,12 @@ gpgkey=file:///etc/pki/rpm-gpg/ENTERPRISEDB-GPG-KEY

The following syntax installs the xDB RPM package:

`yum install ppas-xdb`
`yum install ppas-xdb --exclude edb-xdb`

The following is an example:

```text
yum install ppas-xdb
yum install ppas-xdb --exclude edb-xdb
Loaded plugins: fastestmirror, langpacks
Loading mirror speeds from cached hostfile
* base: centos.excellmedia.net
Expand Down Expand Up @@ -271,8 +271,8 @@ Successful installation of xDB Replication Server results in the creation of dir

If you have an existing xDB RPM installation, you can use yum to upgrade your repository configuration file and update to a more recent product version. To update the `edb.repo` file, assume superuser privileges and enter:

> `yum upgrade edb-repo`
`yum upgrade edb-repo`

`yum` will update the `edb.repo` file to enable access to the current EDB repository, configured to connect with the credentials specified in your `edb.repo` file. Then, you can use yum to upgrade any installed packages:

> `yum upgrade ppas-xdb`
`yum upgrade ppas-xdb* --exclude edb-xdb*`
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: "Take a Multi-Master Snapshot (doMMRsnapshot)"
title: "Take a Multi-Master Snapshot (dommrsnapshot)"
---

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

**For MMR only:** The `doMMRsnapshot` command performs snapshot synchronization on the specified primary node in a multi-master replication system.
**For MMR only:** The `dommrsnapshot` command performs snapshot synchronization on the specified primary node in a multi-master replication system.

```text
-doMMRsnapshot pubname
-dommrsnapshot pubname
–repsvrfile pubsvrfile
-pubhostdbid dbid
[ -verboseSnapshotOutput { true | false } ]
Expand All @@ -17,26 +17,26 @@ Parameters

`pubname`

> The name of the publication for which the snapshot is to be taken.
The name of the publication for which the snapshot is to be taken.

`pubsvrfile`

> The file containing the publication server login information.
The file containing the publication server login information.

`dbid`

> The publication database ID of the target primary node for the snapshot replication.
The publication database ID of the target primary node for the snapshot replication.

`-verboseSnapshotOutput`

> Set this option to true if you want the output from the snapshot to be displayed. Set this option to false if you do not want the snapshot output displayed. If omitted, the default is true.
Set this option to true if you want the output from the snapshot to be displayed. Set this option to false if you do not want the snapshot output displayed. If omitted, the default is true.

Examples

In the following example snapshot replication is performed on publication `emp_pub` to the target primary node identified by publication database `ID 9`.

```text
$ java -jar edb-repcli.jar -doMMRsnapshot emp_pub \
$ java -jar edb-repcli.jar -dommrsnapshot emp_pub \
> -pubhostdbid 9 \
> -repsvrfile ~/pubsvrfile.prop
Performing snapshot...
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Synopsis
```text
-cleanshadowhistforpub pubname
–repsvrfile pubsvrfile
[ -MMRdbid dbid_1[,dbid_2 ] ...]
[ -mmrdbid dbid_1[,dbid_2 ] ...]
```

See [Cleaning Up Shadow Table History](#clean_shadow_table_history) for additional information on cleaning up shadow table history.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ The following table shows the combinations of source and target database server
| **Microsoft SQL Server** | No | No | Yes | Yes | Yes |
| **PostgreSQL** | Yes | Yes | Yes | Yes | Yes |
| **Advanced Server (Oracle compatible)** | Yes | Yes | No | Yes | No |
| **Advanced Server (PostgreSQL compatible)** | No | Yes | Yes | Yes | Yes |
| **Advanced Server (PostgreSQL compatible)** | Yes | Yes | Yes | Yes | Yes |


In the preceding table, the left hand column lists the possible source database server products including the possible Advanced Server compatibility configuration modes. The top row lists the same set of possible target database server products and Advanced Server compatibility configuration modes.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
title: "Version 6.2.16"
---


New features, enhancements, bug fixes, and other changes in EDB Postgres Replication Server 6.2.16 include the following:

| Type | Description |
| ----------- |------------ |
| Enhancement | Replication Server is certified to support PostgreSQL v14 and EDB Postgres Advanced Server v14. |
| Enhancement | Performance optimization for Synchronize operation when a MMR Publication has a SMR Subscription. [Support Ticket #74217] |
| Bug Fix | The `removepub` CLI command removes a Publication while it has one or more Subscriptions. This issue is fixed. [Support Ticket #72194] |
| Bug Fix | Fixed an issue where replication fails for the `UUID` data type in EDB Postgres Advanced Server to MS SQL Server permutation. [Support Ticket #73835] |
| Bug Fix | Fixed an issue where the Synchronize operation failed to replicate NULL for a BLOB type for EDB Postgres Advanced Server to Oracle. [Support Ticket #74057] |
| Bug Fix | Fixed case where wrong schema qualifier was picked up during history cleanup for EDB Postgres Advanced Server to Oracle and SQL Server permutations. [Support Ticket #72626] |
| Bug Fix | Fixed loading of Replication History on Replication Console after restart of Publication Services when SMR subscription is associated with a MMR Publication. [Support Ticket #74217] |
| Bug Fix | Fixed the upgrade issue related with the enhancement of shadow table triggers. [Support Ticket #74447] |
| Bug Fix | Fixed an issue where redundant INSERT conflicts were recorded when a new table was added in the MMR Publication. |
| Bug Fix | In a hybrid replication cluster, the cleanup shadow table routine is subject to remove unprocessed changes. This issue is fixed. |
| Bug Fix | The Synchronize replication fails while replicating changes for a multi-level List Partition table. This issue is fixed. |
| Bug Fix | Fixed the error where Snapshot fails for the third database in a MMR cluster. |
| Bug Fix | Fixed an error that prevented creation of a row-level Filter based on the `->` operator for JSONB data type. |
| Bug Fix | Fixed the issue related with the reporting of incorrect missing privileges while registering Oracle Publication database. |
| Bug Fix | In a hybrid cluster, batch is always applied using BUS (batch update using simple Statement) mode even when the user has opted for BUP mode (batch update using PreparedStatement). This issue is now fixed. |
| Bug Fix | Fixed an issue where an INSERT conflict in MMR Publication is subject to failure of Synchronize operation for a target SMR Subscription in a hybrid cluster. |
| Bug Fix | Fixed an issue so that a validation error is reported when the CLI command `createpub` is executed without registering a Publication database. |
| Bug Fix | Fixed the NoClassDefFoundError error (org/postgresql/replication/LogSequenceNumber) observed during data Snapshot operation for a RPM based installation on RHEL8/CENTOS8. |
| Bug Fix | Fixed the error `libpq JNI wrapper library is not available` that occured while adding a database for WAL based replication.

Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: "Version 6.2.15"
redirects:
- eprs_rel_notes
---


New features, enhancements, bug fixes, and other changes in EDB Postgres Replication Server 6.2.15 include the following:

| Type | Description |
| ---- |------------ |
| Enhancement | Postgres Replication Server is now certified to support Oracle 18c and 19c as the Publication and Subscription database. |
| Bug Fix | Fixed an issue where adding the non-MDN node in the MMR cluster fails as the Constraint OID value exceeds the INTEGER range. [Support Ticket #911176]|
| Bug Fix | After upgrading to version 6.2.13, frequent wal_sender_timeouts were observed causing slowness in the replication, this issue is fixed. [Support Ticket #1273404] |
| Bug Fix | The Snapshot operation takes too long to complete as it unnecessarily reloads an already failed table, this issue is fixed [Support Ticket #1280541]|
| Bug Fix | Fixed an issue where Snapshot fails for a Publication table that is named after a reserved keyword [Support Ticket #1292121] |
| Bug Fix | In a corner case, the conflict detection gets stuck when the target database has multiple conflicts. This issue is fixed [Support Ticket #1318732]|
| Bug Fix | Fixed an issue where Publication creation fails for EPAS 9.6. [Support Ticket #72306]|
| Bug Fix | Fixed an issue that caused Synchronize replication failure due to a non-escaped quote character in the control event. [Support Ticket #72614]|
| Bug Fix | In a corner case, the CDC changes were skipped when the SMR Subscription database was also part of the MMR cluster. This issue is resolved. [Support Ticket #72353]|
| Bug Fix | Fixed an issue that caused “addtablesintopub” operation failure in a corner case when database OID value exceeded INTEGER range. [Support Ticket #72694]|
| Bug Fix | In a hybrid replication setup where EDB Postgres Advanced Server was registered with no-redwood-compat option (as a controller database in MMR and Oracle was registered as a Publication database in SMR), the Publication removal operation failed to complete. This issue is fixed. [Support Ticket #72469]|
| Bug Fix | SSL root file opening issue that is caused by JDBC driver after upgrading from version 6.2.5 to 6.2.6, is resolved. [Support Ticket #899996]|
| Bug Fix | Rep CLI `createpub` command failed when the Filter index was greater than 9. This issue is fixed.|
| Bug Fix | Fixed an issue where Synchronize replication fails when Filter contains a modulus operator.|
| Bug Fix | Fixed an issue that caused `addtablesintopub` command failure for a table name with multiple $ characters.|
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
title: "Version 6.2.14"
---


New features, enhancements, bug fixes, and other changes in EDB Postgres Replication Server 6.2.14 include the following:

| Type | Description |
| ---- |------------ |
| Enhancement | Added support for replication of Oracle XMLType column. [Support Ticket #1129386] |
| Enhancement | Added support to allow an MMR (trigger-based) Publication to be Subscribed in a SMR cluster. |
| Enhancement | Improved replication processing to cater for a corner case when large transactions are rolled back in MMR trigger-based setup causing delay in replication speed. [Support Ticket #1247976] |
| Enhancement | Enhanced xDB to support Subscription for a table having name longer than 30 characters length from EDB Postgres Advanced Server to Oracle 12.2 or later versions. [Support Ticket #1280206] |
| Bug Fix | Fixed Java heap space error when performing sync for a single row containing data > 100MB. |
| Bug Fix | Fixed issue of replication failure when user modifies an Oracle table column that is part of a Filter and PK column is of DATE/TIMESTAMP type. [Support Ticket #1207460] |
| Bug Fix | Fixed replication failure caused by change in Oracle XMLType column value that is part of a Filter. |
| Bug Fix | Fixed a corner case that is subject to replication failure if PK column ordinal position is after a LOB column in an Oracle Publication table. |
| Bug Fix | Fixed NPE case when cleanup job is fired while no Publication is defined yet [Support Ticket #1007131]. |
| Bug Fix | Fixed an issue that causes Sync operation get stuck due to Thread Deadlock. |
| Bug Fix | [EPAS to Oracle] Fixed an issue related with Subscription failure when table contains boolean type column. [Support Ticket #1280206] |
| Bug Fix | [EPAS to Oracle] Fixed an issue related with Subscription failure when table contains XML/XMLType column. |
| Bug Fix | Fixed an issue when a non-reserved keyword as column name causes exception in WAL parsing. [Support Ticket #1281560] |
| Bug Fix | Corrected the behavior of useFastCopy flag that was always enabled even when user turned it off. |
| Bug Fix | Fixed the issue where in trigger-mode, the UPDATE operation is denied on an EPAS Publication table with XMLType column.
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "Version 6.2.13"
---


New features, enhancements, bug fixes, and other changes in EDB Postgres Replication Server 6.2.13 include the following:

| Type | Description |
| ----------- |------------ |
| Bug&nbsp;Fix | Fixed the issue where TRUNCATE operation is captured only for parent partition table. [Support Ticket #1140685] |
| Bug Fix | Fixed the issue where xDB process intermittently crashes on Windows due to invalid libpq connection. [Support Ticket #1165973] |
| Bug Fix | Fixed the issue where user is getting duplicate key violates unique constraint "xdb_mmr_pub_group_pkey" error in non-MDN database server log. [Support Ticket #1039627] |
| Bug Fix | Fixed a corner case where processed data might not be removed from shadow tables for Oracle to EPAS permutation. [Support Ticket #1038941] |
| Bug Fix | Fixed the issue where WAL based Publication table filter does not work with negative integer. |
| Bug Fix | Fixed the issue where xDB might skip CDC changes after Snapshot, when exported Snapshot id occurs around transaction wrap-around boundary value. |
| Bug Fix | Apache Commons Collections libraries are updated to cater for possible security risks. |




Loading

0 comments on commit 69bdf24

Please sign in to comment.