public inbox for [email protected]  
help / color / mirror / Atom feed
From: Nathan Bossart <[email protected]>
To: [email protected]
Subject: pgsql: doc: Adjust note about pg_upgrade's --jobs option.
Date: Sat, 08 Mar 2025 20:29:30 +0000
Message-ID: <[email protected]> (raw)

doc: Adjust note about pg_upgrade's --jobs option.

Presently, this section lists a couple of parallelized parts of
pg_upgrade and suggests a starting point for setting the --jobs
option.  The list of parallelized tasks is not particularly
actionable, and the phrasing for the --jobs recommendation is
confusing to some readers.

This commit attempts to improve this section by eliminating the
list of parallelized tasks and instead highlighting that --jobs is
most useful for clusters with multiple databases or tablespaces.
Additionally, the recommendation for setting --jobs is simplified
to suggest starting with the number of CPU cores.

Reported-by: Magnus Hagander <[email protected]>
Reviewed-by: Daniel Gustafsson <[email protected]>
Reviewed-by: Magnus Hagander <[email protected]>
Discussion: https://postgr.es/m/Z8dBn_5iGLNuYiPo%40nathan

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/3c472a18296e473270b6ff611b898592263a6ed1

Modified Files
--------------
doc/src/sgml/ref/pgupgrade.sgml | 11 +++++------
1 file changed, 5 insertions(+), 6 deletions(-)



reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: pgsql: doc: Adjust note about pg_upgrade's --jobs option.
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox