Skip to content

Commit f6d9ae3

Browse files
pipetogreppipetogrep
authored
Merge pull request #1096 from EnterpriseDB/content/rs-eprs-6.2
EDB Replication Server 6.2 Former-commit-id: 80d7d1b
2 parents 6c6b9a2 + d771886 commit f6d9ae3

File tree

1,156 files changed

+21549
-21
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,156 files changed

+21549
-21
lines changed

‎product_docs/docs/eprs/6.2/01_introduction/01_whats_new.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: "What’s New"
3+
---
4+
5+
<div id="whats_new" class="registered_link"></div>
6+
7+
The following features have been added to xDB Replication Server version 6.1 to create xDB Replication Server version 6.2:
8+
9+
> - Registering your xDB Replication Server product with an EnterpriseDB product license key is no longer required. Thus, all components related to registering the product have been removed. The following are the removed components: 1) the Product Registration dialog box accessed from the xDB Replication Console Help menu, 2) the `license_key` parameter located in the xDB Replication Configuration file, and 3) the xDB Replication Server CLI `registerkey` command.
10+
> - Partitioned tables created using the declarative partitioning feature of PostgreSQL and Advanced Server version 10 and later can now be replicated in a log-based single-master or multi-master replication system. For more information, see [Replicating Postgres Partitioned Tables](../07_common_operations/10_replicating_postgres_partitioned_tables/#replicating_postgres_partitioned_tables).
11+
> - In a single-master replication system, removal of a table from a publication that has one or more existing subscriptions is now permitted as long as the table to be removed is not the parent referenced in a foreign key constraint from a child table that is not being removed as well. Previously, no tables from a publication in a single-master replication system could be removed if there are existing subscriptions. For more information, see [Removing Tables from a Publication](../07_common_operations/06_managing_publication/03_updating_pub/#remove_tables_from_pub).
12+
> - Versions 11 and 12 of PostgreSQL and Advanced Server are now supported.

‎product_docs/docs/eprs/6.2/01_introduction/02_conventions_used.mdx‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: "Conventions Used in this Guide"
3+
---
4+
5+
<div id="conventions_used" class="registered_link"></div>
6+
7+
The following is a list of other conventions used throughout this document.
8+
9+
- This guide applies to both Linux and Windows systems. Directory paths are presented in the Linux format with forward slashes. When working on Windows systems, start the directory path with the drive letter followed by a colon and substitute back slashes for forward slashes.
10+
- Much of the information in this document applies interchangeably to PostgreSQL and EDB Postgres Advanced Server. The term Postgres is used to generically refer to both PostgreSQL and Advanced Server. When a distinction needs to be made between these two database systems, the specific names, PostgreSQL or Advanced Server are used.
11+
- The installation directory path of the PostgreSQL or Advanced Server products is referred to as `POSTGRES_INSTALL_HOME`. For PostgreSQL Linux installations, this defaults to `/opt/PostgreSQL/x.x` for version `10` and earlier. For later versions, use the PostgreSQL community packages. For PostgreSQL Windows installations, this defaults to `C:\Program Files\PostgreSQL\x.x`. For Advanced Server Linux installations accomplished using the interactive installer for version 10 and earlier, this defaults to `/opt/PostgresPlus/x.xAS or /opt/edb/asx.x`. For Advanced Server Linux installations accomplished using an RPM package, this defaults to `/usr/ppas-x.x or /usr/edb/asx.x`. For Advanced Server Windows installations, this defaults to `C:\Program Files\PostgresPlus\x.xAS` or `C:\Program Files\edb\asx.x`. The product version number is represented by `x.x` or by `xx` for version `10` and later.

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

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
title: "Certified and Supported Product Versions"
3+
---
4+
5+
The following database product versions may be used with xDB Replication Server:
6+
7+
- PostgreSQL versions 9.6, 10, 11, 12, and 13
8+
- Advanced Server versions 9.6, 10, 11, 12, and 13
9+
- 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.
10+
- 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.
11+
- Oracle 12c version 12.1.0.2.0 has been explicitly certified. Newer minor versions in the 12.1 line are supported as well.
12+
- SQL Server 2008 version 10.50.1617.0 has been explicitly certified. Newer minor versions in the 10.50 line are supported as well.
13+
- SQL Server 2012 version 11.0.6020.0 has been explicitly certified. Newer minor versions in the 11.0 line are supported as well.
14+
- SQL Server 2014 version 12.0.5000.0 has been explicitly certified. Newer minor versions in the 12.0 line are supported as well.
15+
16+
Contact your EnterpriseDB Account Manager or [[email protected]](mailto:[email protected]) if you require support for other platforms.
17+
18+
**A Note Regarding Oracle RAC and Oracle Exadata**
19+
20+
xDB Replication server has not been tested and is not officially supported for use with Oracle RAC and Exadata, but may work when connected to a single persistent node. To determine its ability to work with RAC or Exadata, please contact your EDB representative.

‎product_docs/docs/eprs/6.2/01_introduction/04_supported_jdk_versions.mdx‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: "Supported JDK Versions"
3+
---
4+
5+
The xDB Replication Server is certified to work with the following Java platforms:
6+
7+
| **Operating Systems** | **JDK Versions** |
8+
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
9+
| `CentOS 7 and 8`<br /> | - Red Hat OpenJDK 7 <br /> - Red Hat OpenJDK 8 <br /> |
10+
| `PPCLE RHEL7` | <br /><br /><br />Red Hat OpenJDK 8<br /><br /> |
11+
| `RHEL 7`<br /> | - Red Hat OpenJDK 7 <br /> - Red Hat OpenJDK 8 <br /> - Oracle JDK 7 <br /> - Oracle JDK 8 <br /> |
12+
| `Windows 2012 R2, 2016, and 2019`<br /> | - Red Hat OpenJDK 7 <br /> - Red Hat OpenJDK 8 <br /> |
13+
| `Debian 10` | <br /><br /><br />Red Hat OpenJDK 11<br /><br /> |
14+
15+
**Certified Java Platforms**
16+
17+
!!! Note
18+
EDB Postgres Replication Server 6.2 is no longer supported on `CentOS/RHEL/OEL 6.x` platforms. It is strongly recommended that EDB products running on these platforms should be migrated to a supported platform.

‎product_docs/docs/eprs/6.2/01_introduction/index.mdx‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
---
2+
title: "Introduction"
3+
---
4+
5+
<div id="introduction" class="registered_link"></div>
6+
7+
This document describes the installation, configuration, architecture, and operation of the <span class="title-ref">EDB xDB Replication Server</span>. EDB xDB (cross database) Replication Server (referred to hereafter as <span class="title-ref">xDB Replication Server</span>) is an asynchronous replication system available for PostgreSQL and for EDB Postgres Advanced Server. The latter will be referred to simply as <span class="title-ref">Advanced Server</span>.
8+
9+
xDB Replication Server can be used to implement replication systems based on either of two different replication models – single-master (primary-to-secondary) replication or multi-master replication.
10+
11+
Regardless of the chosen replication model, xDB Replication Server is extremely flexible and easy to use.
12+
13+
For single-master replication, PostgreSQL, Advanced Server, Oracle, and Microsoft SQL Server are supported in an assortment of configurations (including cascading replication) allowing organizations to utilize it in multiple use cases with a variety of benefits.
14+
15+
The following are some combinations of cross database replications that xDB Replication Server supports for single-master replication:
16+
17+
- From Oracle to PostgreSQL
18+
- From Oracle to Advanced Server
19+
- From SQL Server to PostgreSQL
20+
- From SQL Server to Advanced Server
21+
- From Advanced Server to Oracle
22+
- From PostgreSQL to SQL Server
23+
- From Advanced Server to SQL Server
24+
- Between PostgreSQL and Advanced Server
25+
- From PostgreSQL to Oracle (WAL mode)
26+
- From PostgreSQL to Oracle (trigger mode)
27+
28+
!!! Note
29+
Oracle Real Application Clusters (RAC) and Oracle Exadata are not supported by xDB Replication Server. These Oracle products have not been evaluated nor certified with xDB Replication Server.
30+
31+
For multi-master replication, xDB Replication Server supports the following configurations:
32+
33+
- Between PostgreSQL database servers
34+
- Between PostgreSQL database servers and Advanced Servers in PostgreSQL compatible mode
35+
36+
The reader is assumed to have basic SQL knowledge and basic Oracle, SQL Server, or PostgreSQL database administration skills (whichever are applicable) so that databases, users, schemas, and tables can be created and database object privileges assigned.
37+
38+
- The remainder of Chapter 1 describes conventions used throughout this user’s guide along with suggested sections to read based upon your purpose for using this guide.
39+
- Chapter [Overview](../02_overview/#overview) provides an overview of xDB Replication Server including basic replication concepts and definitions, architecture and components of xDB Replication Server, and design guidelines for setting up a replication system.
40+
- Chapter [Installation and Uninstallation](../03_installation/#installation) gives instructions for installing and uninstalling xDB Replication Server.
41+
- Chapter [Introduction to the xDB Replication Console](../04_intro_xdb_console/#intro_xdb_console) provides an overview of the xDB Replication Console, the graphical user interface for using xDB Replication Server.
42+
- Chapter [Single-Master Replication Operation](../05_smr_operation/#smr_operation) gives instructions for the configuration and operation of xDB Replication Server for single-master replication systems.
43+
- Chapter [Multi-Master Replication Operation](../06_mmr_operation/#mmr_operation) gives instructions for the configuration and operation of xDB Replication Server for multi-master replication systems.
44+
- Chapter [Common Operations](../07_common_operations/#common_operations) describes operations that are common to both single-master and multi-master replication systems.
45+
- Chapter [xDB Replication Server Command Line Interface](../08_xdb_cli/#xdb_cli) describes the xDB Replication Server Command Line Interface, an alternative to the graphical user interface for xDB Replication Server configuration and management.
46+
- Chapter [Data Validator](../09_data_validator/#data_validator) gives instructions for configuration and usage of the Data Validator.
47+
- Chapter [Appendix](../10_appendix/#appendix) is an appendix containing troubleshooting tips, a list of error messages, their causes and resolutions, permitted combinations of database servers in a replication system, xDB Replication Server product upgrade procedures, and other miscellaneous technical information.
48+
49+
<div class="toctree" maxdepth="3">
50+
51+
whats_new conventions_used certified_supported_versions supported_jdk_versions
52+
53+
</div>

‎product_docs/docs/eprs/6.2/02_overview/01_why_replication/01_offloading_reporting_and_bi_queries.mdx‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: "Offloading Reporting and Business Intelligence Queries"
3+
---
4+
5+
<div id="offloading_reporting_and_bi_queries" class="registered_link"></div>
6+
7+
In this use case, users take all or just a subset of data from a production OLTP system and replicate it to another database whose sole purpose is to support reporting queries. This can have multiple benefits:
8+
9+
1. Reporting loads are removed from the OLTP system, improving transaction processing performance.
10+
2. Query performance improves as well without being subordinated to transactions on the system.
11+
3. In Oracle installations, the reporting server duties can be handled by a product like Advanced Server reducing licensing costs for a reporting server.

‎product_docs/docs/eprs/6.2/02_overview/01_why_replication/02_using_warm_standby.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: "Using Warm Standby Servers"
3+
---
4+
5+
<div id="using_warm_standby" class="registered_link"></div>
6+
7+
When many organizations wish to improve the availability of their data, a cost effective solution is often the use of warm standby servers. These are database servers kept up to date with the online system through replication that can be brought online quickly in the event of a failure in the production system. Warm standby servers can also be used for regular maintenance by gracefully switching over to the standby server so that the production server can be brought offline for regular maintenance.

‎product_docs/docs/eprs/6.2/02_overview/01_why_replication/03_testing_systems_in_parallel.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: "Testing Systems in Parallel"
3+
---
4+
5+
<div id="testing_systems_in_parallel" class="registered_link"></div>
6+
7+
Often times, upgrading or moving to a new database system requires that the old and new systems be up and running in parallel to allow for testing and comparing results in real time. Replication can be employed in this use case and is frequently used in development and testing environments.

‎product_docs/docs/eprs/6.2/02_overview/01_why_replication/04_migrating_data.mdx‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
title: "Migrating Data"
3+
---
4+
5+
<div id="migrating_data" class="registered_link"></div>
6+
7+
Similar to running in parallel, is the situation where data may be migrated from one system to another in a sort of *seeding* operation. Replication can be very effective in this situation by quickly copying data.
8+
9+
Some reasons to consider multi-master replication include the following:

‎product_docs/docs/eprs/6.2/02_overview/01_why_replication/05_write_availability.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: "Write Availability"
3+
---
4+
5+
<div id="write_availability" class="registered_link"></div>
6+
7+
In single-master replication, only the primary database is available for writes. The secondary databases are read-only for applications. If the replicated target databases must be available for write access as well, multi-master replication can be employed for the same use cases as outlined for single-master replication, but with the additional advantage of write access to the secondary.

0 commit comments

Comments
 (0)