database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-04-25 21:42:33 +03:00
Code

pg_upgrade: improve docs about extension upgrades

Browse Source 
The previous wording was unclear about the steps needed to upgrade
extensions, and how to update them after pg_upgrade.

Reported-by: Dave Cramer

Discussion: https://postgr.es/m/CADK3HHKawwbOcGwMGnDuAf3-U8YfvTcS8jqDv3UM=niijs3MMA@mail.gmail.com

Backpatch-through: 9.6
This commit is contained in:
Bruce Momjian 2021-08-03 11:27:33 -04:00
parent 691272cae9
commit 5090d709f1
1 changed files with 21 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/src/sgml/ref/pgupgrade.sgml
View File

@ -299,17 +299,27 @@ make prefix=/usr/local/pgsql.new install
</step>
<step>
<title>Install custom shared object files</title>
<title>Install extension shared object files</title>
<para>
Install any custom shared object files (or DLLs) used by the old cluster
into the new cluster, e.g., <filename>pgcrypto.so</filename>,
whether they are from <filename>contrib</filename>
or some other source. Do not install the schema definitions, e.g.,
<command>CREATE EXTENSION pgcrypto</command>, because these will be upgraded
from the old cluster.
Also, any custom full text search files (dictionary, synonym,
thesaurus, stop words) must also be copied to the new cluster.
Many extensions and custom modules, whether from
<filename>contrib</filename> or another source, use shared object
files (or DLLs), e.g., <filename>pgcrypto.so</filename>. If the old
cluster used these, shared object files matching the new server binary
must be installed in the new cluster, usually via operating system
commands. Do not load the schema definitions, e.g., <command>CREATE
EXTENSION pgcrypto</command>, because these will be duplicated from
the old cluster. (Extensions with available updates can be processed
later using <literal>ALTER EXTENSION ... UPDATE</literal>.)
</para>
</step>
<step>
<title>Copy custom full-text search files</title>
<para>
Copy any custom full text search files (dictionary, synonym,
thesaurus, stop words) from the old to the new cluster.
</para>
</step>
@ -494,10 +504,10 @@ pg_upgrade.exe
</step>
<step>
<title>Install custom shared object files</title>
<title>Install extension shared object files</title>
<para>
Install the same custom shared object files on the new standbys
Install the same extension shared object files on the new standbys
that you installed in the new primary cluster.
</para>
</step>