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>
<step> <step>
<title>Install custom shared object files</title> <title>Install extension shared object files</title>
<para> <para>
Install any custom shared object files (or DLLs) used by the old cluster Many extensions and custom modules, whether from
into the new cluster, e.g., <filename>pgcrypto.so</filename>, <filename>contrib</filename> or another source, use shared object
whether they are from <filename>contrib</filename> files (or DLLs), e.g., <filename>pgcrypto.so</filename>. If the old
or some other source. Do not install the schema definitions, e.g., cluster used these, shared object files matching the new server binary
<command>CREATE EXTENSION pgcrypto</command>, because these will be upgraded must be installed in the new cluster, usually via operating system
from the old cluster. commands. Do not load the schema definitions, e.g., <command>CREATE
Also, any custom full text search files (dictionary, synonym, EXTENSION pgcrypto</command>, because these will be duplicated from
thesaurus, stop words) must also be copied to the new cluster. 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> </para>
</step> </step>
@ -494,10 +504,10 @@ pg_upgrade.exe
</step> </step>
<step> <step>
<title>Install custom shared object files</title> <title>Install extension shared object files</title>
<para> <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. that you installed in the new primary cluster.
</para> </para>
</step> </step>