This is an automated email from the ASF dual-hosted git repository. github-merge-queue[bot] pushed a commit to branch gh-readonly-queue/dev/pr-12888-2bc9d0eab71168dba624ed784d7ab5e89ab9bab0 in repository https://gitbox.apache.org/repos/asf/seatunnel.git
commit 1e9373184cf0f50f2cfbb7f846901940ef67e128 Author: Jast <[email protected]> AuthorDate: Mon Oct 19 12:44:21 2026 +0000 [Docs][Zeta] Document Oracle JDBC secure random blocking (#12888) Co-authored-by: Daniel Carter <[email protected]> --- docs/en/faq.md | 11 +++++++++++ docs/zh/faq.md | 11 +++++++++++ 2 files changed, 22 insertions(+) diff --git a/docs/en/faq.md b/docs/en/faq.md index 9743ad3c25..5cd23f2ba4 100644 --- a/docs/en/faq.md +++ b/docs/en/faq.md @@ -66,6 +66,17 @@ Use `generate_sink_sql = true` with `database`, `table`, and usually `primary_ke ## Does SeaTunnel support exactly-once consistency? SeaTunnel supports exactly-once consistency for some data sources, such as MySQL and PostgreSQL, ensuring data consistency during integration. Note that exactly-once consistency depends on the capabilities of the underlying database. +## Why does an Oracle JDBC job fail during login with `Connection reset by peer` and `Authentication lapse`? +On some Java 8 hosts, the Oracle JDBC driver can block while obtaining secure random data for login authentication. If the operating system entropy supply is low, the client may not send the final authentication response before Oracle or an intermediate network device closes the connection. + +This is usually an environment problem rather than a SeaTunnel configuration error. For Zeta jobs, add the following option to the JVM that opens the Oracle connection: + +```text +-Djava.security.egd=file:/dev/./urandom +``` + +For a job submitted with `seatunnel.sh`, start with `$SEATUNNEL_HOME/config/jvm_client_options`; if the connection is opened by an engine process, also update the corresponding server JVM options. See [Configure The JVM Options](./engines/zeta/user-command.md#configure-the-jvm-options). Restoring the host entropy supply, for example with the operating system's `rngd` service, is also recommended. `connection_check_timeout_sec` does not control this login phase. + ## Can SeaTunnel execute scheduled tasks? You can use Linux cron jobs to achieve periodic data integration, or leverage scheduling tools like Apache DolphinScheduler or Apache Airflow to manage complex scheduled tasks. diff --git a/docs/zh/faq.md b/docs/zh/faq.md index d8cb49850e..f999c9bd02 100644 --- a/docs/zh/faq.md +++ b/docs/zh/faq.md @@ -72,6 +72,17 @@ SeaTunnel 支持增量数据同步。例如通过 CDC 连接器实现对数据 ## SeaTunnel 是否支持精确一致性管理？ SeaTunnel 支持一部分数据源的精确一致性，例如支持 MySQL、PostgreSQL 等数据库的事务写入，确保数据在同步过程中的一致性，另外精确一致性也要看数据库本身是否可以支持 +## 为什么 Oracle JDBC 任务登录时报 `Connection reset by peer` 和 `Authentication lapse`？ +在部分 Java 8 主机上，Oracle JDBC 驱动会在登录认证阶段等待安全随机数。如果操作系统熵供给不足，客户端可能迟迟没有发出最终认证响应，直到 Oracle 或中间网络设备关闭连接。 + +这通常是运行环境问题，不是 SeaTunnel 任务配置错误。对于 Zeta 任务，可以在实际建立 Oracle 连接的 JVM 中加入： + +```text +-Djava.security.egd=file:/dev/./urandom +``` + +使用 `seatunnel.sh` 提交任务时，优先检查 `$SEATUNNEL_HOME/config/jvm_client_options`；如果连接由引擎服务进程建立，还需要同步调整对应的服务端 JVM 参数。详见[配置 JVM 参数](./engines/zeta/user-command.md#配置jvm参数)。同时建议按操作系统方式恢复主机熵供给，例如启用 `rngd`。`connection_check_timeout_sec` 不控制这个登录认证阶段。 + ## SeaTunnel 可以定期执行任务吗？ 您可以通过使用 linux 自带 cron 能力来实现定时数据同步任务，也可以结合 DolphinScheduler 等调度工具实现复杂的定时任务管理。
