diff --git a/doc/update/versions/gitlab_14_changes.md b/doc/update/versions/gitlab_14_changes.md index d58fbd348b536be7880d72c75f8234739ac43805..4399792392f2f8d53dd6054f6f7f205be3170a92 100644 --- a/doc/update/versions/gitlab_14_changes.md +++ b/doc/update/versions/gitlab_14_changes.md @@ -843,6 +843,10 @@ Other issues: ### Linux package installations +- The binaries for PostgreSQL 11 and repmgr have been removed. Before upgrading, you must: + 1. Ensure the installation is using [PostgreSQL 12](https://docs.gitlab.com/omnibus/settings/database.html#upgrade-packaged-postgresql-server). + 1. If using repmgr, [convert to using Patroni](../../administration/postgresql/replication_and_failover.md#switching-from-repmgr-to-patroni). + - In GitLab 13.0, `sidekiq-cluster` was enabled by default and the `sidekiq` service ran `sidekiq-cluster` under the hood. However, users could control this behavior using `sidekiq['cluster']` setting to run Sidekiq directly instead. Users could also run `sidekiq-cluster` separately using the various `sidekiq_cluster[*]` settings available in `gitlab.rb`. @@ -871,10 +875,6 @@ Other issues: For more information, see [Set up the initial password](https://docs.gitlab.com/omnibus/installation/index.html#set-up-the-initial-password). -- The binaries for PostgreSQL 11 and repmgr have been removed. Prior to upgrading, administrators of Linux package - installations must: - 1. Ensure the installation is using [PostgreSQL 12](https://docs.gitlab.com/omnibus/settings/database.html#upgrade-packaged-postgresql-server). - 1. If using repmgr, [convert to using Patroni](../../administration/postgresql/replication_and_failover.md#switching-from-repmgr-to-patroni). - Two configuration options for Redis were deprecated in GitLab 13 and removed in GitLab 14: - `redis_slave_role` is replaced with `redis_replica_role`. diff --git a/doc/update/versions/gitlab_15_changes.md b/doc/update/versions/gitlab_15_changes.md index 997397904dd0ca154ba5025669a74354daaab51c..9dfe00dae0ecebf332847dc7d9db4548df3826a9 100644 --- a/doc/update/versions/gitlab_15_changes.md +++ b/doc/update/versions/gitlab_15_changes.md @@ -790,7 +790,18 @@ A [license caching issue](https://gitlab.com/gitlab-org/gitlab/-/issues/376706) for Omnibus GitLab. This replaces `gitlab_shell['custom_hooks_dir']`. - PostgreSQL 13.6 is being shipped as the default version for fresh installs and 12.10 for upgrades. You can manually upgrade to PostgreSQL 13.6 following the - [upgrade docs](https://docs.gitlab.com/omnibus/settings/database.html#gitlab-150-and-later). + [upgrade docs](https://docs.gitlab.com/omnibus/settings/database.html#upgrade-packaged-postgresql-server) with: + + ```shell + sudo gitlab-ctl pg-upgrade -V 13 + ``` + + Until PostgreSQL 12 is removed, you may + [pin the PostgreSQL version](https://docs.gitlab.com/omnibus/settings/database.html#pin-the-packaged-postgresql-version-fresh-installs-only) + if needed for compatibility or test environment reasons. + + [Fault tolerant and Geo installations require additional steps and planning](../../administration/postgresql/replication_and_failover.md#upgrading-postgresql-major-version-in-a-patroni-cluster). + Because of underlying structural changes, the running PostgreSQL process **_must_** be restarted when it is upgraded before running database migrations. If automatic restart is skipped, you must run the following diff --git a/doc/update/versions/gitlab_16_changes.md b/doc/update/versions/gitlab_16_changes.md index e9b31458d3705f2ddfc0788b1fa4b637fa718329..8b872a96b526c411b7410d992be4832ea40c4da5 100644 --- a/doc/update/versions/gitlab_16_changes.md +++ b/doc/update/versions/gitlab_16_changes.md @@ -182,6 +182,17 @@ Specific information applies to installations using Geo: Specific information applies to Linux package installations: +- As of GitLab 16.2, PostgreSQL 13.11 and 14.8 are both shipped with the Linux package. + During a package upgrade, the database isn't upgraded to PostgreSQL 14. If you + want to upgrade to PostgreSQL 14, you must do it manually: + + ```shell + sudo gitlab-ctl pg-upgrade -V 14 + ``` + + PostgreSQL 14 isn't supported on Geo deployments and is [planned](https://gitlab.com/groups/gitlab-org/-/epics/9065) + for future releases. + - In 16.2, we are upgrading Redis from 6.2.11 to 7.0.12. This upgrade is expected to be fully backwards compatible. Redis is not automatically restarted as part of `gitlab-ctl reconfigure`.