Repository navigation
Conversation
The FAQ page answers general questions, but none of the behaviours that are specific to IvorySQL's two serving modes: which port gives which mode, what synchronous replication does to sync_state, why commits hang after pg_promote(), why initdb and make fail when uuid-ossp is missing, and what the container image requires at startup. Add 12 Q&A entries to both the Chinese and the English page. Every number, error message and GUC value quoted here was reproduced on PostgreSQL 18.6 (IvorySQL 5.6) in this environment; nothing is copied from other projects. No existing content is removed. Closes IvorySQL#393
|
🚀 IvorySQL-Docs Preview Ready
|
This was referenced Nov 12, 2026
Author
|
Note for reviewers: an identical pull request from the same patch (#398) was opened in the same second by a duplicate automation run. It has been closed, so this is the only thread to review. |
qwer381
force-pushed
the
docs/faq-common-pitfalls
branch
from
November 13, 2026 05:53
a21dcdb to
3ee1b96
Compare
|
🚀 IvorySQL-Docs Preview Ready
|
This branch was previously deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #393
What changed
master/contribution/faq.adoc, Chinese and English: twelve===Q&A entries appended to the existing page. +335 lines per language, zero deletions — the current content is untouched, and the section order matches between CN and EN.The twelve questions were picked from behaviours that are specific to IvorySQL and that are not described anywhere in
master/today:initdb -mdecides the stored mode;-m pgis the default in the TAP fixtures1521vs5432compatible_modeflips per portivorysql.portmust be set on each nodesync_stateFIRST 1 (…)→sync,ANY 1 (*)→quorumpg_promote()wait_event = SyncRep;statement_timeoutdoes not break it; clearsynchronous_standby_namesand reloadinitdbfails:extension "uuid-ossp" is not availablemakefails:#error "please use configure's --with-uuid switch …"--with-uuid=e2fs/bsd/osspis required forcontrib/uuid-osspinitdb -m pg, so Oracle-only objects are not exercisedIVORYSQL_PASSWORDis mandatory unlessPOSTGRES_HOST_AUTH_METHOD=trust5866in the imageivorysql.conf.sampleivorysql.*parametersHow it was verified
Every command, error message and value quoted in the answers was reproduced on
PostgreSQL 18.6 (IvorySQL 5.6)in this environment — two-node synchronous replication for #5/#6,initdbandmakeruns for #7/#8, theivorysql/ivorysql:5.6-ubi8container for #10/#11, and the installedinitdb/postgresbinaries for #1–#4. The transcripts were kept as evidence; nothing is quoted from another project or from memory.Rendering: both pages convert with
asciidoctor.js 4.2.1with zero warnings (CN: 1 h1 / 7 h2 / 12 h3 / 5 tables / 29 literal blocks; EN has the same skeleton).Checklist
contribution/faq.adoc(CN + EN) touched, nonav.adocchange