# HG changeset patch
# User Ben Prescott <bprescott@gitlab.com>
# Date 1628842303 -3600
#      Fri Aug 13 09:11:43 2021 +0100
# Node ID 04190ba1263d0682c69f7e7bcb017bd6c7cff7ff
# Parent  3e0e79eb7b6316f32fa9b3bff2a6e5d24d7675a3
Version 14 Redis config changes and link across notes

diff --git a/doc/update/gitlab_14_changes.md b/doc/update/gitlab_14_changes.md
--- a/doc/update/gitlab_14_changes.md
+++ b/doc/update/gitlab_14_changes.md
@@ -64,3 +64,19 @@
 
 1. Ensure the installation is using [PostgreSQL 12](../settings/database.md#upgrade-packaged-postgresql-server)
 1. If using repmgr, [convert to using patroni](https://docs.gitlab.com/ee/administration/postgresql/replication_and_failover.html#switching-from-repmgr-to-patroni)
+
+### Redis configuration changes
+
+Two configuration options for Redis were deprecated in GitLab 13 and removed in GitLab 14:
+
+- `redis_slave_role` is replaced with `redis_replica_role`
+- `redis['client_output_buffer_limit_slave']` is replaced with `redis['client_output_buffer_limit_replica']`
+
+Redis Cache nodes being upgraded from GitLab 13.12 to 14.0 that still refer to `redis_slave_role`
+in `gitlab.rb` will encounter an error in the output of `gitlab-ctl reconfigure`:
+
+```plaintext
+There was an error running gitlab-ctl reconfigure:
+
+The following invalid roles have been set in 'roles': redis_slave_role
+```
diff --git a/doc/update/index.md b/doc/update/index.md
--- a/doc/update/index.md
+++ b/doc/update/index.md
@@ -40,6 +40,7 @@
 Updating to major versions might need some manual intervention. For more information,
 check the version your are updating to:
 
+- [GitLab 14](gitlab_14_changes.md)
 - [GitLab 13](gitlab_13_changes.md)
 - [GitLab 12](gitlab_12_changes.md)
 - [GitLab 11](gitlab_11_changes.md)