Chat now with support
Chat with Support

SharePlex 12.2 - Release Notes

Resolved Issues and Enhancements

Resolved Issues in this Release

The following is a list of issues addressed in this release of SharePlex.

Issue ID Issues Source and Target Component/ Feature
SPO-25181 Users are unable to copy tables using the Copy command from an Oracle database on AIX to a PostgreSQL target on Linux when SharePlex is installed on the Linux server. Oracle to PostgreSQL Remote Capture
SPO-25168 When replication is configured with identical schema and table names on the remote post and remote capture components, the compare operation fails and displays the error: No objects to compare; no job started. PostgreSQL to PostgreSQL Compare
SPO-25167 During ora_setup and silent ora_setup selecting ‘N’ at the prompt Will the current setup for SID be used as source? causes SharePlex to treat the Oracle database as a target. As a result, it does not present the additional configuration steps that are required for an Oracle source system. Oracle to Oracle ora_setup
SPO-25161 Capture performance is slow during the processing of REDO records from a TDE-encrypted database. Oracle to Oracle Capture
SPO-25160 When users run a silent ora_setup using ASM credentials, SharePlex returns the message Error! Unable to login using the user name and password just entered. Oracle to Oracle ora_setup
SPO-25149 Deleting a batch does not report out-of-sync DML statements to the errlog.sql file. Oracle to PostgreSQL Out-of-sync
SPO-25145 The Analyze Config command encounters an internal error as it exits. Oracle to Oracle Analyze Config
SPO-25131 Capture cored with the error OCIStmtExecute failed with ORA-1403 while processing XML data. Oracle to Oracle Capture
SPO-25121 Compare/Repair fails with an error when the RAW data type is used as a primary key. Oracle to PostgreSQL Compare/Repair
SPO-25118 The Kafka JSON metadata field host is incorrectly displayed as unknown host in both the Kafka JSON format and File JSON format on the Oracle target. Oracle to Oracle JSON metadata
SPO-25109 When upgrading from a trial license to a perpetual license, SharePlex records the following message in the source event log: Error Cop: Invalid argument qui_calc_du: rewinddir(0x95ae0) failed. N/A License

Deprecated Platforms and Operating Systems

Platforms or operating systems that have been deprecated in SharePlex 12.2 version:

No platforms or operating systems are deprecated at this time.

Planned platform deprecation in future releases:

No platforms are anticipated to be deprecated at this time.

Basic system requirements

This chapter contains the basic system requirements for SharePlex. See also: Source and Target System Requirements and Data Types

System

Before installing SharePlex, ensure that your system meets the minimum hardware and software requirements.

  • SharePlex processes are all 64-bit and can exceed 4 GB.
  • Per process memory of greater than or equal to 256 MB is required. Depending on how you configure SharePlex, there can be one or more of the following processes on a system :
    • Capture
    • Read
    • Export
    • Import
    • Post
  • See the Preinstallation Checklist in the SharePlex Installation Guide for additional system and/or database requirements.

Communications Protocols

SSL/TLS

For TLS connections, SharePlex supports TLS 1.2 or 1.3 only.

Internet protocol

SharePlex supports IPv4 and IPv6 internet protocols. The following table shows the operating systems for which SharePlex was tested with IPv6.

Operating System

Source

Target

SharePlex versions

On-premises

Cloud

Linux RHEL 7

Link-Local IPV6

Link-Local IPV6

11.0 and above

Linux RHEL 8

Link-Local IPV6

Link-Local IPV6

11.0 and above

Linux RHEL 9

Link-Local IPV6

Link-Local IPV6

11.4 and above

HP UA

Link-Local IPV6

Link-Local IPV6

11.0 and above

HP IA

Link-Local IPV6

Link-Local IPV6

11.0 and above

SUN Sparc

Link-Local IPV6

Link-Local IPV6

11.0 and above

SUN Solaris

Link-Local IPV6

Link-Local IPV6

11.0 and above

AIX

Link-Local IPV6

Link-Local IPV6

11.0 and above

Interoperability Between Versions

Refer to the following guidelines if the system where you are installing SharePlex is in a configuration where one or more other systems will continue to use an older version of SharePlex. An example is when installing or upgrading SharePlex on a target, but the source will continue to use SharePlex 9.4.x/10.x.

Versions with interoperability for Oracle database as a source

The following SharePlex versions are interoperable for Oracle database as a source, including the Compare/Repair feature:

  • 9.4.x
  • 10.0.x
  • 10.1.x
  • 10.2

Notes:

  • SharePlex 10.2, as a source, and above versions are not interoperable with older versions than 10.2 as a target when using Extended Data Types and TLS 1.3.

  • For the supported features of SharePlex 11.0 and above , including its version interoperability, see SharePlex Features Interoperable with Versions 11.x and 12.2.

To support replication from a higher to a lower version, set the SP_SYS_TARGET_COMPATIBILITY parameter on the source system to the lower SharePlex version. If Capture is running, restart it.

Important: Downgrading from a higher to a lower version of SharePlex is not supported.

Notes:

  • The older version of the SP_SYS_TARGET_COMPATIBILITY parameter, SP_OCT_TARGET_COMPATIBILITY, was deprecated in version 9.0. If your source SharePlex is currently replicating to a lower SharePlex version on the target and you have SP_OCT_TARGET_COMPATIBILITY set to the lower version, SharePlex will continue to use that value after you upgrade to the current version.
  • If you upgrade the target to the current release at a future time, issue a reset for SP_OCT_TARGET_COMPATIBILITY on the source system to remove it from the SharePlex environment. Going forward, SharePlex will use the setting of the new SP_SYS_TARGET_COMPATIBILITY parameter, which defaults to the current version.

To reset SP_OCT_TARGET_COMPATIBILITY:

  1. Stop Capture.
    sp_ctrl> stop capture
  2. In sp_ctrl on the source system, issue the following command:
    sp_ctrl>reset param SP_OCT_TARGET_COMPATIBILITY

  3. Restart Capture.
    sp_ctrl>start capture

SharePlex Features Interoperable with Versions 11.x and 12.2

The below table provides a list of features with their SharePlex version compatibility details with supported source and target databases.

SharePlex feature Supported source database Supported target database SharePlex source version SharePlex target version
Ability to replicate PostgreSQL timestamp to Oracle Date Unidirectional replication PostgreSQL Oracle SharePlex 11.0 and above SharePlex 11.1 and above
Ability to replicate PostgreSQL timestamp to Oracle Date replication with BDR support PostgreSQL Oracle and PostgreSQL SharePlex 11.1 and above SharePlex 11.1 and above
Activate config with LSN using user provided LSN1 PostgreSQL PostgreSQL, Oracle, SQL Server, Kafka, Snowflake SharePlex 11.1 and above SharePlex 11.1 and above
show_last_posted utility1 PostgreSQL PostgreSQL SharePlex 11.1 and above SharePlex 11.1 and above
High Availability cluster environment with CrunchyData1 PostgreSQL PostgreSQL SharePlex 11.1 and above SharePlex 11.0 and above
PG2O-O2PG BDR - SharePlex prepared routines - !MostRecentRecord, !LeastRecentRecord, !UpdateUsingKeyOnly, !HostPriority, !UpdateUsingKeyOnly Oracle and PostgreSQL Oracle and PostgreSQL SharePlex 11.0 & Above SharePlex 11.0 & Above
Case sensitive column names PostgreSQL Oracle SharePlex 11.1 & Above SharePlex 11.1 and above
PostgreSQL Database as a Service as source PostgreSQL PostgreSQL, Oracle, SQL Server, Kafka, Snowflake SharePlex 11.1 and above SharePlex 11.0 & Above
Trigger scripts PostgreSQL PostgreSQL SharePlex  11.1 and above SharePlex  11.1 and above
SharePlex PostgreSQL - config.sql and build_config.sql scripts PostgreSQL Not target dependent SharePlex 11.1 and above

SharePlex 11.1 and above

Implementation of the BOOLEAN data type

PostgreSQL

 

PostgreSQL, Oracle, Kafka, Snowflake

 

SharePlex 11.1 & Above SharePlex 11.1 & Above
Implementation of the TIME data type PostgreSQL PostgreSQL, Kafka, Snowflake SharePlex 11.1 & Above SharePlex 11.1 & Above
Implementation of the BYTEA data type PostgreSQL PostgreSQL, Kafka, Oracle SharePlex 11.1 & Above SharePlex 11.1 & Above
Column name > 30 characters3 PostgreSQL, Oracle PostgreSQL, Oracle, SQL Server, Kafka, Snowflake SharePlex 11.1 and above SharePlex 11.1 and above
Kafka Partition key Oracle Kafka SharePlex 11.1 and above SharePlex 11.1 and above
Long table name Oracle PostgreSQL, Oracle, SQL Server, Kafka, Snowflake SharePlex 11.0 and above SharePlex 11.1 and above

PostgreSQL Compression Algorithm with Physical replication2

PostgreSQL PostgreSQL, Oracle, SQL Server, Kafka, Snowflake SharePlex 11.0 and above SharePlex 11.0 and above
PostgreSQL Compression Algorithm with Logical replication2 PostgreSQL PostgreSQL, Oracle, SQL Server, Kafka, Snowflake SharePlex 11.1 and above SharePlex 11.1 and above
Compare and Repair commands PostgreSQL PostgreSQL SharePlex 11.4 and above SharePlex 11.4 and above
Docker Container Oracle, PostgreSQL Oracle, PostgreSQL SharePlex 11.4 and above SharePlex 11.4 and above
Compare and Repair commands4 Oracle PostgreSQL SharePlex 12.0 and above SharePlex 12.0 and above
Ignore Port PostgreSQL PostgreSQL SharePlex 12.0 and above

SharePlex 12.0 and above

AVRO format 5 Oracle Confluent Kafka SharePlex 12.0 and above SharePlex 12.0 and above
Oracle Apache Kafka SharePlex 12.2 and above SharePlex 12.2 and above
Kubernetes PostgreSQL PostgreSQL SharePlex 12.0 and above

SharePlex 12.0 and above

Parquet file format 8 Oracle Parquet SharePlex 12.1 and above

SharePlex 12.1 and above

Copy/Append 7 Oracle PostgreSQL, Parquet file SharePlex 12.1 and above SharePlex 12.1 and above
Compare and Repair commands6 PostgreSQL Oracle SharePlex 12.1 and above SharePlex 12.1 and above
Logs and process monitoring using SpClient utility on Windows N/A N/A SharePlex 12.1 and above SharePlex 12.1 and above
High Availability (HA) Failover with Capture auto restart PostgreSQL All SharePlex 12.1 and above SharePlex 12.1 and above
Multiple concurrent Capture Connections to the Same Remote Oracle Database Oracle All SharePlex 12.2 and above N/A
Oracle ADB (only for autonomous transaction processing workload) as a target Oracle, PostgreSQL Oracle N/A SharePlex 12.2 and above
Trigger Script support for Oracle ATP Oracle, PostgreSQL Oracle SharePlex 12.2 and above SharePlex 12.2 and above
Compare/Repair on Windows Oracle PostgreSQL SharePlex 12.2 and above SharePlex 12.2 and above

Conditions of Support:

1. These features are available only with PostgreSQL physical replication and not with PostgreSQL Database as a Service.

2. Types of PostgreSQL Compression Algorithm:

  • pglz is supported with physical replication, where Capture receives data in compressed format and decompresses it.

  • pglz and lz4 are supported with logical replication, as decompression is done by the output plugin (pgoutput), and Capture receives data in decompressed format.

3. When a table or column name exceeds 30 characters, Oracle does not log key columns for each update operation in the Redo log, resulting insufficient key columns for SharePlex Poster to use, leading to an Out of Sync condition at the target.

It is recommended to set SP_OCT_USE_SUPP_KEYS = 0, which directs SharePlex to select the appropriate set of key columns for Poster to use.

Note: This may cause additional overhead during the identification of key columns in the SharePlex Read process and at the target during update transactions, potentially resulting in latency at the target.

4. The Compare and Repair commands for Oracle-to-PostgreSQL replication are certified for use with Oracle 18c, 19c, and 21c as well as all supported PostgreSQL platforms.

5. The AVRO format is supported only on the Linux operating system.

6. The Compare and Repair commands for PostgreSQL to Oracle are not supported on the Windows operating system. To refer to the additional conditions of support, see the Compare and Repair commands section in the SharePlex Reference Guide.

7. To refer to the conditions of support, see the Copy/Append commands section in theSharePlex Reference Guide.

8. Values in TIMESTAMP WITH LOCAL TIME ZONE columns at the Oracle source are replicated into the Parquet file without time zone conversion (unlike TIMESTAMP WITH TIME ZONE). If the database local time zone differs from UTC, the corresponding values in the Parquet file may appear different when fetched as UTC.

Source and Target System Requirements and Data Types

This chapter contains the requirements when capturing from various source databases and replicating to supported target databases.

Supported Source and Target Combinations

The following table provides information about the supported source and target database combinations.

Target databases Oracle (Source) PostgreSQL (Source) PostgreSQL Database as a Service (Source)
Azure Event Hub X X
File Output X X
JMS X X
Kafka
MariaDB X X
MySQL X X
Oracle
PostgreSQL
PostgreSQL Database as a Service
Snowflake
SQL Server
Parquet X X

Platform Support Matrix

Oracle as source & target All supported platforms1
Postgres as source Linux
Postgres as Target Linux, Windows
SQL Server Linux, Windows
My SQL Linux, Windows
SnowFlake Linux, Windows
MariaDB Linux
Kafka Linux
Event Hub Linux
JMS All supported platforms
File All supported platforms
Parquet Linux

1. Refer to the System Requirements section of the respective platform for detailed platform support information.

Compatibility Across Operating Systems (Remote Collection and Posting)

If users cannot or choose not to install SharePlex directly on the source and/or target server, they can use an intermediate server where SharePlex collects data from the source and/or posts data to the target remotely. In these situations, users must consider the operating system of both the intermediate server running SharePlex and the source and/or target database platform.

Shareplex Platform Database Platform

Oracle Linux 9.x, 8.x, and 7.x; RHEL 9.x, 8.x, and 7.x; Rocky Linux 8.x; SUSE SLES 12.x and 15.x; Ubuntu 22.04

AIX 7.3
Oracle Linux 9.x, 8.x, and 7.x; RHEL 9.x, 8.x, and 7.x; Rocky Linux 8.x; SUSE SLES 12.x and 15.x; Ubuntu 22.04
Sun Solaris Sparc 11.4
Sun Solaris Intel 11.4
Windows 2019, 2022, 2025*
AIX 7.3 AIX 7.3
Solaris Sparc 11.4 Solaris Sparc 11.4
Solaris intel 11.4 Solaris intel 11.4
Windows 2019, 2022, 2025 Windows 2019, 2022, 2025
HP-UX 11.31 Itanium HP-UX 11.31 Itanium

* SharePlex supports only the Oracle Capture feature when replicating data remotely from Linux to Windows platforms.

Notes:

  • SharePlex supports replication to and from Oracle RDS when it is installed on any of the supported operating systems (Windows, Linux, and Unix).

  • By using remote replication, database running on Solaris SPARC 11.1, 11.2, and 11.3 or Windows 2012, 2012 r2, and 2016 can leverage remote replication to capture and/or post data using SharePlex installed on Solaris SPARC 11.4, or Windows 2019, 2022, and 2025 respectively ensuring replication continues without the need for direct installation on the unsupported platform.

Feature to Operating System Support Mapping

Shareplex Features Source Operating Systems Target Operating Systems
Compare and Repair commands for Oracle to Oracle Windows, Linux, Unix Windows, Linux, Unix
Compare and Repair commands for Oracle to PostgreSQL Windows, Linux Windows, Linux
Compare and Repair commands for PostgreSQL to Oracle Linux Windows, Linux
Ignore Port Linux N/A
AVRO format N/A Linux
Parquet file format N/A Linux
Copy/Append for Oracle to Oracle Windows, Linux, Unix Windows, Linux, Unix
Copy/Append for Oracle to PostgreSQL Windows, Linux Windows, Linux
Copy/Append for Oracle to Parquet Windows, Linux Linux
Logs and process monitoring using SpClient utility Windows Windows
High Availability (HA) Failover with Capture auto restart Linux Linux
Multiple Capture Connections to the Same Remote Oracle Database Linux N/A
Oracle Autonomous Database (ADB) as a target N/A Windows, Linux, Unix
Remote Capture and Remote Poster Windows, Linux, Unix Windows, Linux, Unix
Nullsoft Scriptable Install System (NSIS) Installer Windows Windows

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating