aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2011-10-10 07:43:28 -0400
committerBruce Momjian <bruce@momjian.us>2011-10-10 07:44:11 -0400
commit0dc3f57ba0aa9a99308d3d097eeb2cbcbd5fb52c (patch)
tree6134c97d0e5878b5c0662f805ece31d9ddf52de2 /doc/src
parentc0f03aae0469e758964faac0fb741685170c39a5 (diff)
downloadpostgresql-0dc3f57ba0aa9a99308d3d097eeb2cbcbd5fb52c.tar.gz
postgresql-0dc3f57ba0aa9a99308d3d097eeb2cbcbd5fb52c.zip
In pg_upgrade, add -o/-O options to pass parameters to the servers, and
document its use for config-only directory installs.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/pgupgrade.sgml22
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml
index 0d084243a86..460d06b6e03 100644
--- a/doc/src/sgml/pgupgrade.sgml
+++ b/doc/src/sgml/pgupgrade.sgml
@@ -115,6 +115,20 @@
</varlistentry>
<varlistentry>
+ <term><option>-o</option> <replaceable class="parameter">options</replaceable></term>
+ <term><option>--old-options</option> <replaceable class="parameter">options</replaceable></term>
+ <listitem><para>options to be passed directly to the
+ old <command>postgres</command> command</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-O</option> <replaceable class="parameter">options</replaceable></term>
+ <term><option>--new-options</option> <replaceable class="parameter">options</replaceable></term>
+ <listitem><para>options to be passed directly to the
+ new <command>postgres</command> command</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-p</option> <replaceable>old_port_number</></term>
<term><option>--old-port=</option><replaceable>old_portnum</></term>
<listitem><para>the old cluster port number; environment
@@ -560,6 +574,14 @@ psql --username postgres --file script.sql postgres
</para>
<para>
+ If you are upgrading a pre-<productname>PostgreSQL</> 9.2 cluster
+ that uses a configuration-file-only directory, you must pass the
+ real data directory location to <application>pg_upgrade</>, and
+ pass the configuration directory location to the server, e.g.
+ <literal>-d /real-data-directory -o '-D /configuration-directory'</>.
+ </para>
+
+ <para>
If you want to use link mode and you don't want your old cluster
to be modified when the new cluster is started, make a copy of the
old cluster and upgrade that with link mode. To make a valid copy