|
51 | 51 | <para>To upgrade from a <productname>Postgres Pro</productname> version based on
|
52 | 52 | any previous <productname>PostgreSQL</productname> major release, you can perform a dump/restore using
|
53 | 53 | <xref linkend="app-pg-dumpall">, or use the <xref linkend="pgupgrade"> utility.
|
54 |
| - The first option is safer, while the second is faster and can |
| 54 | + The first option is safer, while the second is faster and can significantly |
55 | 55 | speed up the upgrade process for large databases.
|
56 | 56 | </para>
|
57 | 57 | <para>To upgrade from a <productname>Postgres Pro</productname> version
|
58 | 58 | based on the same <productname>PostgreSQL</productname> major release,
|
59 |
| - the <literal>pgpro_upgrade</literal> script provided |
60 |
| - in this distribution is required: |
61 |
| - <itemizedlist> |
62 |
| - <listitem> |
63 |
| - <para>If you are upgrading your <productname>Postgres Pro</productname> |
64 |
| - installation from a binary package, the <literal>pgpro_upgrade</literal> script |
65 |
| - is run automatically, or you are prompted to run it manually. |
66 |
| - </para> |
67 |
| - </listitem> |
68 |
| - <listitem> |
69 |
| - <para>If you have compiled <productname>Postgres Pro</productname> |
70 |
| - from source code or created your database in a non-default location, |
71 |
| - you must always run the <literal>pgpro_upgrade</literal> script manually. |
72 |
| - Before running the script, you should stop postgres service. |
73 |
| - Script should be run on behalf of the user owning the database |
74 |
| - (typically postgres) and PGDATA environment variable should be |
75 |
| - set to the directory where database resides. |
76 |
| - </para> |
77 |
| - </listitem> |
78 |
| - </itemizedlist> |
| 59 | + a dump/restore is not required. Instead of the <literal>pg_upgrade</literal>, |
| 60 | + you must use the <literal>pgpro_upgrade</literal> script provided |
| 61 | + in this distribution. This script updates metadata information to |
| 62 | + handle catalog number format change introduced in |
| 63 | + <productname>Postgres Pro</productname> 9.6.4.1. If you are upgrading your |
| 64 | + <productname>Postgres Pro</productname> installation from a binary package, the |
| 65 | + <literal>pgpro_upgrade</literal> script is run automatically, or you |
| 66 | + are prompted to run it manually. |
| 67 | + </para> |
| 68 | + <important> |
| 69 | + <para> |
| 70 | + If you run <literal>pgpro_upgrade</literal> manually, |
| 71 | + you must stop postgres service. |
| 72 | + The script must be run on behalf of the user owning the database |
| 73 | + (typically postgres) and PGDATA environment variable should be |
| 74 | + set to the directory where database resides. Running <literal>pgpro_upgrade</literal> |
| 75 | + as root will result in an error. |
| 76 | + </para> |
| 77 | + </important> |
| 78 | + <para>If you have compiled <productname>Postgres Pro</productname> |
| 79 | + from source code or created your database in a non-default location, |
| 80 | + you must run the <literal>pgpro_upgrade</literal> script manually. |
| 81 | + </para> |
79 | 82 | <note>
|
80 | 83 | <para>On RPM-based Linux distributions, if you are upgrading from
|
81 | 84 | version 9.6.2.1 or lower, make sure to move the data directory from
|
82 | 85 | <filename>pgsql</filename> to the <filename>pgpro</filename>
|
83 | 86 | directory before running the <literal>pgpro_upgrade</literal> script.
|
84 |
| - Besides, after you upgrade to a newer version, you will have to use |
85 |
| - the <literal>systemd</literal> service manager. |
86 | 87 | </para>
|
87 | 88 | </note>
|
88 |
| - </para> |
89 | 89 | <para>To migrate from vanilla PostgreSQL 9.6.x, perform a dump/restore using
|
90 | 90 | <xref linkend="app-pg-dumpall">.
|
91 | 91 | </para>
|
|
0 commit comments