Upgrading the Geo sites

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

Upgrading Geo sites involves performing:

  1. Version-specific upgrade steps, depending on the version being upgraded to or from.
  2. General upgrade steps, for all upgrades.

General upgrade steps

note
These general upgrade steps are not intended for multi-site deployments, and cause downtime. If you want to avoid downtime, consider using zero downtime upgrades.

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

  1. Optional: Pause replication on each secondary sites.
  2. SSH into each node of the primary site.
  3. Upgrade GitLab on the primary site.
  4. SSH into each node of secondary sites.
  5. Upgrade GitLab on each secondary site.
  6. If you paused replication in step 1, resume replication on each secondary
  7. Test primary and secondary sites, and check version in each.

Check status after upgrading

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

  1. Run the Geo Rake task on an application node for the primary and secondary sites. Everything should be green:

    sudo gitlab-rake gitlab:geo:check
    
  2. Check the primary site’s Geo dashboard for any errors.
  3. Test the data replication by pushing code to the primary site and see if it is received by secondary sites.

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