debian-mirror-gitlab/doc/administration/geo/replication/updating_the_geo_nodes.md

stage	group	info	type
Enablement	Geo	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments	howto

Updating the Geo nodes (PREMIUM SELF)

WARNING: Read these sections carefully before updating your Geo nodes. Not following version-specific update steps may result in unexpected downtime. If you have any specific questions, contact Support.

Updating Geo nodes involves performing:

1. Version-specific update steps, depending on the version being updated to or from.
2. General update steps, for all updates.

General update steps

NOTE: These general update steps are not intended for high-availability deployments, and will cause downtime. If you want to avoid downtime, consider using zero downtime updates.

To update the Geo nodes when a new GitLab version is released, update primary and all secondary nodes:

1. Optional: Pause replication on each secondary node.
2. Log into the primary node.
3. Update GitLab on the primary node using Omnibus's Geo-specific steps.
4. Log into each secondary node.
5. Update GitLab on each secondary node using Omnibus's Geo-specific steps.
6. If you paused replication in step 1, resume replication on each secondary
7. Test primary and secondary nodes, and check version in each.

Check status after updating

Now that the update process is complete, you may want to check whether everything is working correctly:

1. Run the Geo Rake task on all nodes, everything should be green:

   sudo gitlab-rake gitlab:geo:check
   

2. Check the primary node's Geo dashboard for any errors.

3. Test the data replication by pushing code to the primary node and see if it is received by secondary nodes.

If you encounter any issues, see the Geo troubleshooting guide.