Skip to content

Commit 34b9357

Browse files
DyrconaDyrcona
committed
LP2083873: Remove obsolete PostgreSQL versions 10 through 12
Update the installation documentation to indicate that Pg 13 is the minimum and to remove the instructions for installing PostgreSQL version less than 13. Add release note about the required minimum PostgreSQL version and link to the PostgreSQL upgrade documentation. Signed-off-by: Jason Stephenson <[email protected]>
1 parent 82a738d commit 34b9357

File tree

9 files changed

+19
-177
lines changed

9 files changed

+19
-177
lines changed

‎Open-ILS/src/extras/Makefile.install‎

Lines changed: 0 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -85,12 +85,6 @@ ubuntu-jammy:
8585
fedora:
8686
@make -f $(DIR)/Makefile.fedora
8787

88-
postgres-server-debian-bookworm-10:
89-
@make -f $(DIR)/Makefile.debian-bookworm install_postgres_server_10
90-
postgres-server-debian-bookworm-11:
91-
@make -f $(DIR)/Makefile.debian-bookworm install_postgres_server_11
92-
postgres-server-debian-bookworm-12:
93-
@make -f $(DIR)/Makefile.debian-bookworm install_postgres_server_12
9488
postgres-server-debian-bookworm-13:
9589
@make -f $(DIR)/Makefile.debian-bookworm install_postgres_server_13
9690
postgres-server-debian-bookworm-14:
@@ -99,12 +93,6 @@ postgres-server-debian-bookworm-15:
9993
@make -f $(DIR)/Makefile.debian-bookworm install_postgres_server_15
10094
postgres-server-debian-bookworm-16:
10195
@make -f $(DIR)/Makefile.debian-bookworm install_postgres_server_16
102-
postgres-server-debian-bullseye-10:
103-
@make -f $(DIR)/Makefile.debian-bullseye install_postgres_server_10
104-
postgres-server-debian-bullseye-11:
105-
@make -f $(DIR)/Makefile.debian-bullseye install_postgres_server_11
106-
postgres-server-debian-bullseye-12:
107-
@make -f $(DIR)/Makefile.debian-bullseye install_postgres_server_12
10896
postgres-server-debian-bullseye-13:
10997
@make -f $(DIR)/Makefile.debian-bullseye install_postgres_server_13
11098
postgres-server-debian-bullseye-14:
@@ -113,12 +101,6 @@ postgres-server-debian-bullseye-15:
113101
@make -f $(DIR)/Makefile.debian-bullseye install_postgres_server_15
114102
postgres-server-debian-bullseye-16:
115103
@make -f $(DIR)/Makefile.debian-bullseye install_postgres_server_16
116-
postgres-server-debian-buster-10:
117-
@make -f $(DIR)/Makefile.debian-buster install_postgres_server_10
118-
postgres-server-debian-buster-11:
119-
@make -f $(DIR)/Makefile.debian-buster install_postgres_server_11
120-
postgres-server-debian-buster-12:
121-
@make -f $(DIR)/Makefile.debian-buster install_postgres_server_12
122104
postgres-server-debian-buster-13:
123105
@make -f $(DIR)/Makefile.debian-buster install_postgres_server_13
124106
postgres-server-debian-buster-14:
@@ -127,12 +109,6 @@ postgres-server-debian-buster-15:
127109
@make -f $(DIR)/Makefile.debian-buster install_postgres_server_15
128110
postgres-server-debian-buster-16:
129111
@make -f $(DIR)/Makefile.debian-buster install_postgres_server_16
130-
postgres-server-ubuntu-noble-10:
131-
@make -f $(DIR)/Makefile.ubuntu-noble install_postgres_server_10
132-
postgres-server-ubuntu-noble-11:
133-
@make -f $(DIR)/Makefile.ubuntu-noble install_postgres_server_11
134-
postgres-server-ubuntu-noble-12:
135-
@make -f $(DIR)/Makefile.ubuntu-noble install_postgres_server_12
136112
postgres-server-ubuntu-noble-13:
137113
@make -f $(DIR)/Makefile.ubuntu-noble install_postgres_server_13
138114
postgres-server-ubuntu-noble-14:
@@ -141,12 +117,6 @@ postgres-server-ubuntu-noble-15:
141117
@make -f $(DIR)/Makefile.ubuntu-noble install_postgres_server_15
142118
postgres-server-ubuntu-noble-16:
143119
@make -f $(DIR)/Makefile.ubuntu-noble install_postgres_server_16
144-
postgres-server-ubuntu-jammy-10:
145-
@make -f $(DIR)/Makefile.ubuntu-jammy install_postgres_server_10
146-
postgres-server-ubuntu-jammy-11:
147-
@make -f $(DIR)/Makefile.ubuntu-jammy install_postgres_server_11
148-
postgres-server-ubuntu-jammy-12:
149-
@make -f $(DIR)/Makefile.ubuntu-jammy install_postgres_server_12
150120
postgres-server-ubuntu-jammy-13:
151121
@make -f $(DIR)/Makefile.ubuntu-jammy install_postgres_server_13
152122
postgres-server-ubuntu-jammy-14:

‎Open-ILS/src/extras/install/Makefile.debian-bookworm‎

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -206,24 +206,6 @@ all:
206206
make -f $(DIR)/Makefile.common install_cpan_force
207207
make -f $(DIR)/Makefile.debian debian_sys_config
208208

209-
install_postgres_server_10:
210-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
211-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
212-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_10)"
213-
make -f $(DIR)/Makefile.common install_cpan_pgsql
214-
215-
install_postgres_server_11:
216-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
217-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
218-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_11)"
219-
make -f $(DIR)/Makefile.common install_cpan_pgsql
220-
221-
install_postgres_server_12:
222-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
223-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
224-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_12)"
225-
make -f $(DIR)/Makefile.common install_cpan_pgsql
226-
227209
install_postgres_server_13:
228210
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
229211
make -f $(DIR)/Makefile.debian debian_postgresql_repo

‎Open-ILS/src/extras/install/Makefile.debian-bullseye‎

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -206,24 +206,6 @@ all:
206206
make -f $(DIR)/Makefile.common install_cpan_force
207207
make -f $(DIR)/Makefile.debian debian_sys_config
208208

209-
install_postgres_server_10:
210-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
211-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
212-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_10)"
213-
make -f $(DIR)/Makefile.common install_cpan_pgsql
214-
215-
install_postgres_server_11:
216-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
217-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
218-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_11)"
219-
make -f $(DIR)/Makefile.common install_cpan_pgsql
220-
221-
install_postgres_server_12:
222-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
223-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
224-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_12)"
225-
make -f $(DIR)/Makefile.common install_cpan_pgsql
226-
227209
install_postgres_server_13:
228210
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
229211
make -f $(DIR)/Makefile.debian debian_postgresql_repo

‎Open-ILS/src/extras/install/Makefile.debian-buster‎

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -206,24 +206,6 @@ all:
206206
make -f $(DIR)/Makefile.common install_cpan_force
207207
make -f $(DIR)/Makefile.debian debian_sys_config
208208

209-
install_postgres_server_10:
210-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
211-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
212-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_10)"
213-
make -f $(DIR)/Makefile.common install_cpan_pgsql
214-
215-
install_postgres_server_11:
216-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
217-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
218-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_11)"
219-
make -f $(DIR)/Makefile.common install_cpan_pgsql
220-
221-
install_postgres_server_12:
222-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
223-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
224-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_12)"
225-
make -f $(DIR)/Makefile.common install_cpan_pgsql
226-
227209
install_postgres_server_13:
228210
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
229211
make -f $(DIR)/Makefile.debian debian_postgresql_repo

‎Open-ILS/src/extras/install/Makefile.ubuntu-jammy‎

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -210,24 +210,6 @@ all:
210210
make -f $(DIR)/Makefile.common install_cpan_pgsql
211211
make -f $(DIR)/Makefile.debian debian_sys_config
212212

213-
install_postgres_server_10:
214-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
215-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
216-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_10)"
217-
make -f $(DIR)/Makefile.common install_cpan_pgsql
218-
219-
install_postgres_server_11:
220-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
221-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
222-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_11)"
223-
make -f $(DIR)/Makefile.common install_cpan_pgsql
224-
225-
install_postgres_server_12:
226-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
227-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
228-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_12)"
229-
make -f $(DIR)/Makefile.common install_cpan_pgsql
230-
231213
install_postgres_server_13:
232214
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
233215
make -f $(DIR)/Makefile.debian debian_postgresql_repo

‎Open-ILS/src/extras/install/Makefile.ubuntu-noble‎

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -211,24 +211,6 @@ all:
211211
make -f $(DIR)/Makefile.common install_cpan_pgsql
212212
make -f $(DIR)/Makefile.debian debian_sys_config
213213

214-
install_postgres_server_10:
215-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
216-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
217-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_10)"
218-
make -f $(DIR)/Makefile.common install_cpan_pgsql
219-
220-
install_postgres_server_11:
221-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
222-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
223-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_11)"
224-
make -f $(DIR)/Makefile.common install_cpan_pgsql
225-
226-
install_postgres_server_12:
227-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
228-
make -f $(DIR)/Makefile.debian debian_postgresql_repo
229-
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_SERVER_DEBS_12)"
230-
make -f $(DIR)/Makefile.common install_cpan_pgsql
231-
232214
install_postgres_server_13:
233215
make -f $(DIR)/Makefile.debian DEBS="$(PGSQL_APT_REPO_DEBS)"
234216
make -f $(DIR)/Makefile.debian debian_postgresql_repo

‎docs/RELEASE_NOTES_NEXT/Architecture/min-postgresql.adoc‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
== New PostgreSQL Minimum Version ==
2+
3+
Evergreen 3.14 no longer supports new installations on PostgreSQL
4+
versions less than 13. Evergreen 3.14 is still compatible with
5+
PostgreSQL versions of 10 or higher. Existing installations may
6+
upgrade to Evergreen 3.14 without requiring a PostreSQL upgrade.
7+
8+
Compatibility with obsolete PostgreSQL database versions is not
9+
guaranteed in the next major Evergreen release. Users are encouraged
10+
to upgrade to a more recent PostgreSQL version if they are running
11+
PostgreSQL versions between 10 and 12.
12+
13+
The PostgreSQL community recommends a dump and restore from the older
14+
PostgreSQL database to the newer one when upgrading over major
15+
versions. For more information,
16+
https://www.postgresql.org/docs/current/upgrading.html#UPGRADING-VIA-PGDUMPALL[see the PostgreSQL upgrade documentation].
17+

‎docs/modules/installation/pages/server_installation.adoc‎

Lines changed: 1 addition & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ autoreconf -i
4949

5050
== Installing prerequisites ==
5151

52-
* **PostgreSQL**: The minimum supported version is 10.
52+
* **PostgreSQL**: The minimum supported version is 13.
5353
* **Linux**: Evergreen has been tested on
5454
Debian Bookworm (12),
5555
Debian Bullseye (11),
@@ -495,61 +495,6 @@ server packages, use the make target
495495
appropriate command below based on your operating system and desired
496496
PostgreSQL Version.
497497

498-
The first below will install PostgreSQL 10, the minimum supported
499-
version and the version recommended for production use of Evergreen:
500-
501-
[source, bash]
502-
------------------------------------------------------------------------------
503-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-10
504-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-10
505-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-10
506-
make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-10
507-
make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-10
508-
------------------------------------------------------------------------------
509-
510-
[WARNING]
511-
=========
512-
Evergreen support for PostgreSQL server versions greater than 10 is
513-
still exprimental. The use of the following is discouraged in
514-
production environments. The following are only recommended if you
515-
are willing to test newer PostgreSQL versions for performance and
516-
possible bugs.
517-
=========
518-
519-
To install PostgreSQL version 11, use the following command for your operating
520-
system:
521-
522-
[source, bash]
523-
------------------------------------------------------------------------------
524-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-11
525-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-11
526-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-11
527-
make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-11
528-
make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-11
529-
------------------------------------------------------------------------------
530-
531-
To install PostgreSQL version 12, use the following command for your operating
532-
system:
533-
534-
[WARNING]
535-
=========
536-
PostgreSQL 12+ includes a feature called "JIT" (Just-in-Time compilation).
537-
Do not turn on Postgres' JIT capabilities. Evergreen's queries, especially complex
538-
ones used for search, are intentionally tuned for non-JIT execution and JIT has
539-
been shown to be harmful in some circumstances.
540-
Recommended minimum tweak to postgresql.conf:
541-
jit_above_cost = -1
542-
=========
543-
544-
[source, bash]
545-
------------------------------------------------------------------------------
546-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bookworm-12
547-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-bullseye-12
548-
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-buster-12
549-
make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-jammy-12
550-
make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-noble-12
551-
------------------------------------------------------------------------------
552-
553498
To install PostgreSQL version 13, use the following command for your operating
554499
system:
555500

‎docs/modules/installation/pages/server_upgrade.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ All of the steps in this chapter are to be completed from the command line.
66

77
== Software Prerequisites ==
88

9-
* **PostgreSQL**: The minimum supported version is 10.
9+
* **PostgreSQL**: The minimum supported version is 13.
1010
* **Linux**: Evergreen 3.X.X has been tested on Debian Buster
1111
(10.0), Debian Bullseye (11.0), Debian Bookworm (11.0),
1212
Ubuntu Jammy Jellyfish (22.04), and Ubuntu Noble Numbat (24.04).

0 commit comments

Comments
 (0)