2020-06-03 17:08:23 -04:00
---
stage: Enablement
group: Geo
2020-11-26 01:09:20 -05:00
info: 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
2020-06-03 17:08:23 -04:00
type: howto
---
2019-07-08 04:50:38 -04:00
# Updating the Geo nodes **(PREMIUM ONLY)**
2019-05-05 12:08:21 -04:00
2020-08-24 08:10:17 -04:00
CAUTION: **Warning:**
2020-11-09 19:08:52 -05:00
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 ](https://about.gitlab.com/support/#contact-support ).
2020-08-24 08:10:17 -04:00
2019-09-05 00:02:06 -04:00
Updating Geo nodes involves performing:
2020-08-24 08:10:17 -04:00
1. [Version-specific update steps ](version_specific_updates.md ), depending on the
2019-09-05 00:02:06 -04:00
version being updated to or from.
1. [General update steps ](#general-update-steps ), for all updates.
2019-05-05 12:08:21 -04:00
## General update steps
2020-07-16 02:09:33 -04:00
NOTE: **Note:**
These general update steps are not intended for [high-availability deployments ](https://docs.gitlab.com/omnibus/update/README.html#multi-node--ha-deployment ), and will cause downtime. If you want to avoid downtime, consider using [zero downtime updates ](https://docs.gitlab.com/omnibus/update/README.html#zero-downtime-updates ).
2019-05-05 12:08:21 -04:00
2019-09-02 04:16:27 -04:00
To update the Geo nodes when a new GitLab version is released, update **primary**
2019-09-02 02:38:45 -04:00
and all **secondary** nodes:
2020-09-15 11:10:08 -04:00
1. **Optional:** [Pause replication on each **secondary** node. ](../index.md#pausing-and-resuming-replication )
2019-09-02 02:38:45 -04:00
1. Log into the **primary** node.
2020-09-30 08:09:53 -04:00
1. [Update GitLab on the **primary** node using Omnibus's Geo-specific steps ](https://docs.gitlab.com/omnibus/update/README.html#geo-deployment ).
2019-09-02 02:38:45 -04:00
1. Log into each **secondary** node.
2020-09-30 08:09:53 -04:00
1. [Update GitLab on each **secondary** node using Omnibus's Geo-specific steps ](https://docs.gitlab.com/omnibus/update/README.html#geo-deployment ).
2020-09-15 11:10:08 -04:00
1. If you paused replication in step 1, [resume replication on each **secondary** ](../index.md#pausing-and-resuming-replication )
2019-05-05 12:08:21 -04:00
1. [Test ](#check-status-after-updating ) **primary** and **secondary** nodes, and check version in each.
2019-08-05 02:45:43 -04:00
### Check status after updating
Now that the update process is complete, you may want to check whether
everything is working correctly:
2020-04-21 11:21:10 -04:00
1. Run the Geo Rake task on all nodes, everything should be green:
2019-08-05 02:45:43 -04:00
2020-01-30 10:09:15 -05:00
```shell
2019-08-05 02:45:43 -04:00
sudo gitlab-rake gitlab:geo:check
```
1. Check the **primary** node's Geo dashboard for any errors.
1. Test the data replication by pushing code to the **primary** node and see if it
is received by **secondary** nodes.
2020-11-09 19:08:52 -05:00
If you encounter any issues, see the [Geo troubleshooting guide ](troubleshooting.md ).