Skip to content

docs: add IvorySQL 5.4 Pgpool-II integration guide - #296

Open
messere1 wants to merge 1 commit into
IvorySQL:v5.4from
messere1:codex/docs-pgpool-1118
Open

docs: add IvorySQL 5.4 Pgpool-II integration guide#296
messere1 wants to merge 1 commit into
IvorySQL:v5.4from
messere1:codex/docs-pgpool-1118

Conversation

@messere1

@messere1 messere1 commented Aug 9, 2026

Copy link
Copy Markdown

Summary

  • add bilingual Pgpool-II 4.7.2 integration documentation for IvorySQL 5.4
  • document source installation against IvorySQL client headers and libraries
  • provide a safe two-node streaming-replication and load-balancing configuration
  • cover monitoring roles, authentication, Oracle-compatible sessions, and production limitations
  • update both ecosystem overview tables and navigation trees

Why

Pgpool-II adds connection pooling, streaming-replication awareness, and read scaling in front of IvorySQL. The existing ecosystem documentation did not contain a tested IvorySQL-specific setup or explain the boundary between a minimal pooling configuration and a production failover design.

Fixes IvorySQL/IvorySQL#1118

Validation

Environment: Ubuntu 22.04 x86_64, IvorySQL 5.4 / PostgreSQL 18.4, Pgpool-II 4.7.2.

  • Pgpool-II configured and built successfully against the IvorySQL 5.4 installation prefix
  • two-node IvorySQL streaming-replication topology detected correctly
  • SHOW POOL_NODES reported both nodes up, with primary/standby roles and zero replication delay
  • with equal weights, 21 initial read queries were distributed 9 to the primary and 12 to the standby
  • SHOW POOL_PROCESSES confirmed backend connection-pool activity
  • a session switched to ivorysql.compatible_mode = oracle and queried through Pgpool-II successfully
  • both new AsciiDoc pages pass Asciidoctor with --failure-level WARN
  • git diff --check passes

User impact

Users gain a reproducible path to pool IvorySQL connections and scale reads. The guide intentionally disables automatic failover in the minimal example and lists the fencing, promotion, authentication, and consistency work required before production use.

Assisted-by: OpenAI:gpt-5
Copilot AI lite review requested due to automatic review settings August 9, 2026 12:36

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@github-actions
github-actions Bot temporarily deployed to pull request August 9, 2026 12:39 Inactive
@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown

🚀 IvorySQL-Docs Preview Ready

@jiaoshuntian

Copy link
Copy Markdown
Contributor

Thank you for your contribution. We will review it as soon as possible.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Ecosystem Integration: IvorySQL v5 + pgpool-ll

3 participants