initdb - creating clusters

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: gazzatav(at)gmail(dot)com
Subject: initdb - creating clusters
Date: 2020-07-09 15:25:14
Message-ID: 159430831443.16535.11360317280100947016@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/10/creating-cluster.html
Description:

I'm searching for what a cluster is and how to create one. The
documentation tells me to use initdb -D path/to/cluster. I am told that
this is installed when I installed postgresql. I try to run it with no
success. Searching for an answer I find that I'm supposed to use
pg_createcluster because initdb is version dependent and not made
executable. It seems like there is an omission here as the documentation on
this page also mentions pg_ctl which my system (Ubuntu 18.04) knows nothing
about using the 'which' command. I can imagine that someone might argue
that this is system dependent - I don't know whether that is true or not. I
have generally found the documentation excellent and certainly not inward
looking. For instance the documentation on replication strategies includes
proprietary solutions.

I would suggest that you include a paragraph stating that various operating
systems use other commands to avoid version conflict and suggest the reader
search for '<user-system> pg_ctl'. I can understand why you might not want
to link to external sites in your documentation. (While writing this I have
searched to make sure I'm not writing rubbish and already understand that
pg_createcluster is a Debian solution/variant.)

Thanks for all you do

Gary

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Geoghegan 2020-07-09 22:32:20 Re: Default setting for enable_hashagg_disk
Previous Message Stephen Frost 2020-07-09 14:03:30 Re: Default setting for enable_hashagg_disk