diff options
author | Peter Eisentraut <peter_e@gmx.net> | 2018-03-25 09:17:07 -0400 |
---|---|---|
committer | Peter Eisentraut <peter_e@gmx.net> | 2018-03-25 14:58:21 -0400 |
commit | 8ad8d916f99d19e0be7800992c828c3c1a01b693 (patch) | |
tree | 89c1aa1e299c1f0b10cfe9db7f03ecefc4dbc7a6 /doc/src | |
parent | 3a2cb59887421a04b5ee158580198d731d115c61 (diff) |
initdb: Further polishing of --wal-segsize option
Extend documentation. Improve option parsing in case no argument was
specified.
Diffstat (limited to 'doc/src')
-rw-r--r-- | doc/src/sgml/ref/initdb.sgml | 22 |
1 files changed, 14 insertions, 8 deletions
diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml index 585665f1611..949b5a220f5 100644 --- a/doc/src/sgml/ref/initdb.sgml +++ b/doc/src/sgml/ref/initdb.sgml @@ -316,16 +316,22 @@ PostgreSQL documentation </varlistentry> <varlistentry> - <term><option>--wal-segsize=<replaceable>SEGSIZE</replaceable></option></term> + <term><option>--wal-segsize=<replaceable>size</replaceable></option></term> <listitem> <para> - Set the <firstterm>WAL segment size</firstterm>, in megabytes. This is - the size of each individual file in the WAL log. It may be useful - to adjust this size to control the granularity of WAL log shipping. - This option can only be set during initialization, and cannot be - changed later. - The default size is 16 megabytes. - The value must be a power of 2 between 1 and 1024 (megabytes). + Set the <firstterm>WAL segment size</firstterm>, in megabytes. This + is the size of each individual file in the WAL log. The default size + is 16 megabytes. The value must be a power of 2 between 1 and 1024 + (megabytes). This option can only be set during initialization, and + cannot be changed later. + </para> + + <para> + It may be useful to adjust this size to control the granularity of + WAL log shipping or archiving. Also, in databases with a high volume + of WAL, the sheer number of WAL files per directory can become a + performance and management problem. Increasing the WAL file size + will reduce the number of WAL files. </para> </listitem> </varlistentry> |