update

Author: Cary Huang

docs/en/user-guide/configure_olr.md

@@ -0,0 +1,67 @@
+# Configure Openlog Replicator for Oracle
+
+## **Overview**
+
+In addition to LogMiner-based replication, **SynchDB** supports **Openlog Replicator (OLR)** as a data source for Oracle connectors. This integration enables low-latency, redo log–based change data capture from Oracle databases via a standalone replication server.
+
+This guide details the configuration steps necessary to associate an Oracle connector with an OLR endpoint using `synchdb_add_olr_conninfo()` and `synchdb_del_olr_conninfo()`.
+
+## **Requirements**
+
+- **Openlog Replicator Version**: `1.3.0` (verified compatibility for Debezium 2.7.x)
+- Oracle instance with redo logs accessible to OLR
+- Openlog Replicator must be configured and running
+- An existing Oracle connector in SynchDB (created using `synchdb_add_conninfo()`)
+
+Refer to this [external guide](https://highgo.atlassian.net/wiki/external/OTUzY2Q2OWFkNzUzNGVkM2EyZGIyMDE1YzVhMDdkNWE) for details on deploying Openlog Replicator via Docker.
+
+
+## **`synchdb_add_olr_conninfo()`**
+
+Registers an Openlog Replicator endpoint for an existing Oracle connector.
+
+**Signature:**
+
+```sql
+synchdb_add_olr_conninfo(
+    conn_name TEXT,     -- Name of the connector
+    olr_host TEXT,      -- Hostname or IP of the OLR instance
+    olr_port INT,       -- Port number exposed by OLR (typically 7070)
+    olr_source TEXT     -- Oracle source name as configured in OLR
+)
+```
+
+**Example:**
+
+This instructs SynchDB to stream changes for the connector `oracleconn` from the Openlog Replicator instance running at 10.55.13.17:7070, using the Oracle source identifier ORACLE. Call `synchdb_start_engine_bgw` to start this connector.
+
+```sql
+SELECT synchdb_add_olr_conninfo('oracleconn', '10.55.13.17', 7070, 'ORACLE');
+
+```
+
+## **synchdb_del_olr_conninfo**
+
+Removes the OLR configuration for a specific connector, reverting it to use LogMiner.
+
+**Signature:**
+
+```sql
+synchdb_del_olr_conninfo(conn_name TEXT)
+
+```
+
+**Example:**
+
+This command disables the use of OLR for oracleconn. Starting the connector with `synchdb_start_engine_bgw` will fall back to the default logmining strategy.
+
+```sql
+SELECT synchdb_del_olr_conninfo('oracleconn');
+
+```
+
+## **Behavior Notes**
+
+* When both LogMiner and OLR configurations exist, SynchDB defaults to using Openlog Replicator for change capture.
+* Restarting the connector is required after modifying its OLR configuration.
+* The Oracle instance and OLR must remain synchronized in SCN progression and resetlogs identity for consistency.

docs/zh/user-guide/configure_olr.md

@@ -0,0 +1,66 @@
+# 为 Oracle 配置 Openlog Replicator
+
+## **概述**
+
+除了基于 LogMiner 的复制功能外，**SynchDB** 还支持将 **Openlog Replicator (OLR)** 作为 Oracle 连接器的数据源。此集成功能支持通过独立的复制服务器从 Oracle 数据库捕获低延迟、基于重做日志的变更数据。
+
+本指南详细介绍了使用 `synchdb_add_olr_conninfo()` 和 `synchdb_del_olr_conninfo()` 将 Oracle 连接器与 OLR 端点关联的配置步骤。
+
+## **要求**
+
+- **Openlog Replicator 版本**：`1.3.0`（已验证与 Debezium 2.7.x 的兼容性）
+- 具有可供 OLR 访问的重做日志的 Oracle 实例
+- Openlog Replicator 必须已配置并正在运行
+- SynchDB 中现有的 Oracle 连接器（使用 `synchdb_add_conninfo()` 创建）
+
+有关通过 Docker 部署 Openlog Replicator 的详细信息，请参阅此[外部指南](https://highgo.atlassian.net/wiki/external/OTUzY2Q2OWFkNzUzNGVkM2EyZGIyMDE1YzVhMDdkNWE)。
+
+## **`synchdb_add_olr_conninfo()`**
+
+为现有的 Oracle 连接器注册 Openlog Replicator 端点。
+
+**签名：**
+
+```sql
+synchdb_add_olr_conninfo(
+	conn_name TEXT, -- 连接器名称
+	olr_host TEXT, -- OLR 实例的主机名或 IP
+	olr_port INT, -- OLR 公开的端口号（通常为 7070）
+	olr_source TEXT -- OLR 中配置的 Oracle 源名称
+)
+```
+
+**示例：**
+
+这将指示 SynchDB 使用 Oracle 源标识符 ORACLE，从运行于 10.55.13.17:7070 的 Openlog Replicator 实例流式传输连接器 `oracleconn` 的变更。调用 `synchdb_start_engine_bgw` 启动此连接器。
+
+```sql
+SELECT synchdb_add_olr_conninfo('oracleconn', '10.55.13.17', 7070, 'ORACLE');
+
+```
+
+## **synchdb_del_olr_conninfo**
+
+删除特定连接器的 OLR 配置，将其恢复为使用 LogMiner。
+
+**签名：**
+
+```sql
+synchdb_del_olr_conninfo(conn_name TEXT)
+
+```
+
+**示例：**
+
+此命令禁用 oracleconn 使用 OLR。使用 `synchdb_start_engine_bgw` 启动连接器将恢复为默认的日志挖掘策略。
+
+```sql
+SELECT synchdb_del_olr_conninfo('oracleconn');
+
+```
+
+## **行为说明**
+
+* 当 LogMiner 和 OLR 配置同时存在时，SynchDB 默认使用 Openlog Replicator 进行更改捕获。
+* 修改连接器的 OLR 配置后，需要重新启动连接器。
+* Oracle 实例和 OLR 必须在 SCN 进程和 resetlogs 标识方面保持同步，以保持一致性。

mkdocs.yml

@@ -84,6 +84,7 @@ plugins:
             JVM Memory Usage: Uso de memoria de JVM
             Attribute View: Vista de atributos
             JMX Exporter Settings: Configuración del exportador JMX
+            Configure Openlog Replicator for Oracle Connector: Configurar Openlog Replicator para Oracle Connector
         - locale: zh
           name: 中文
           site_name: SynchDB 文档
@@ -126,7 +127,8 @@ plugins:
             JMX Monitor Settings: JMX 监视器设置
             JVM Memory Usage: JVM内存使用情况
             Attribute View: 属性视图
-            JMX Exporter Settings: JMX exporter 设置：
+            JMX Exporter Settings: JMX exporter 设置
+            Configure Openlog Replicator for Oracle Connector: 为 Oracle Connector 配置 Openlog Replicator
   - mike:
       version_selector: true
       css_dir: css
@@ -179,6 +181,7 @@ nav:
    - Secured Connection: user-guide/secured_connection.md
    - Configure Error Strategies: user-guide/configure_error_strategies.md
    - Configure Replication Offset: user-guide/set_offset.md
+   - Configure Openlog Replicator for Oracle Connector: user-guide/configure_olr.md
    # - Utility Functions: user-guide/utility_functions.md
  - Changelog: changelog.md
  # - Homepage: https://www.synchdb.com