Repository navigation
Conversation
…itdb Oracle-compatible initialization installs the uuid-ossp extension, so a cluster cannot be initialized when the extension is missing. The failure surfaces halfway through initdb, after the data directory has been created, and initdb then removes that directory again -- which is easy to misread as a disk or permission problem. Document the prerequisite where the initdb command is given, together with the one-line check that tells whether the current installation has it, the configure option a source build needs, and the -m pg escape hatch. Per the maintainer's preference in #3192, this is handled as documentation rather than as an additional check inside initdb.
|
🚀 IvorySQL-Docs Preview Ready
|
qwer381
force-pushed
the
docs/installation-uuid-ossp
branch
from
November 13, 2026 05:53
2c04965 to
d50f9e3
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 IvorySQL/IvorySQL#3192
What this changes
Documents, in the installation guide, that Oracle-compatible initialization needs the
uuid-osspextension — and what to do when it is not there.Two files, 10 added lines each, no deletions:
CN/modules/ROOT/pages/master/installation_guide.adoc+10 −0EN/modules/ROOT/pages/master/installation_guide.adoc+10 −0The note is placed in
== Start Database→** Initializing database, right after theinitdbcommand — the only place in the page whereinitdbappears, and where the requirement is actually hit.Why documentation, not a check in
initdbIn IvorySQL/IvorySQL#3192 the maintainer preferred option 2:
So instead of adding a pre-flight check to
initdb(IvorySQL/IvorySQL#3193, closed), the requirement is stated where users configure and initialize a cluster. The branch behind IvorySQL/IvorySQL#3193 (fix/initdb-uuid-ossp-diagnostic) is kept, including the-Lhandling fix and the TAP case, should it ever be wanted.What the note says
initdbdefaults to Oracle-compatible mode (same as-m oracle), and that mode installsuuid-osspduring initialization; if the extension is unavailable,initdbfails withFATAL: extension "uuid-ossp" is not availableand removes the data directory it just created../configure ... --with-uuid=e2fs); without itconfigurestill succeeds butmakestops incontrib/uuid-osspwith#error "please use configure's --with-uuid switch to select a UUID library".SELECT name, default_version, installed_version FROM pg_available_extensions WHERE name = 'uuid-ossp';initdb ... -m pgis the way (PG mode does not install it).How this was verified
git apply --check,git apply,git apply --check -Ragainst7d4ad9d: all exit 0.@asciidoctor/core 4.2.1: heading/table/listing counts unchanged from the current page (h2=9, table=7, pre=29),0warnings, the[NOTE]renders as a singleadmonitionblock notewith no literal[NOTE]left behind.initdbfailure text and the#errortext were both taken from runs of PostgreSQL 18.6 (IvorySQL 5.6): an Oracle-modeinitdbwithout the extension, and a build configured without--with-uuid.uuid-ossp | 1.1 | 1.1; on a-m pginstance the same query finds the extension available but not installed.#350, the only other open PR touching this file (deb package names, lines 140–152): both merge orders apply cleanly.Checklist