2020-06-03 17:08:23 -04:00
---
stage: Enablement
group: Geo
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/#designated-technical-writers
type: howto
---
2019-07-08 04:50:38 -04:00
# Updating the Geo nodes **(PREMIUM ONLY)**
2019-05-05 12:08:21 -04:00
2019-09-05 00:02:06 -04:00
Updating Geo nodes involves performing:
1. [Version-specific update steps ](#version-specific-update-steps ), depending on the
version being updated to or from.
1. [General update steps ](#general-update-steps ), for all updates.
## Version specific update steps
Depending on which version of Geo you are updating to/from, there may be
different steps.
2020-04-27 11:10:16 -04:00
- [Updating to GitLab 12.9 ](version_specific_updates.md#updating-to-gitlab-129 )
2020-02-12 10:09:37 -05:00
- [Updating to GitLab 12.7 ](version_specific_updates.md#updating-to-gitlab-127 )
- [Updating to GitLab 12.2 ](version_specific_updates.md#updating-to-gitlab-122 )
2019-09-05 00:02:06 -04:00
- [Updating to GitLab 12.1 ](version_specific_updates.md#updating-to-gitlab-121 )
2020-03-03 19:07:52 -05:00
- [Updating to GitLab 12.0 ](version_specific_updates.md#updating-to-gitlab-120 )
- [Updating to GitLab 11.11 ](version_specific_updates.md#updating-to-gitlab-1111 )
2019-09-05 00:02:06 -04:00
- [Updating to GitLab 10.8 ](version_specific_updates.md#updating-to-gitlab-108 )
- [Updating to GitLab 10.6 ](version_specific_updates.md#updating-to-gitlab-106 )
- [Updating to GitLab 10.5 ](version_specific_updates.md#updating-to-gitlab-105 )
- [Updating to GitLab 10.3 ](version_specific_updates.md#updating-to-gitlab-103 )
- [Updating to GitLab 10.2 ](version_specific_updates.md#updating-to-gitlab-102 )
- [Updating to GitLab 10.1 ](version_specific_updates.md#updating-to-gitlab-101 )
- [Updating to GitLab 10.0 ](version_specific_updates.md#updating-to-gitlab-100 )
- [Updating from GitLab 9.3 or older ](version_specific_updates.md#updating-from-gitlab-93-or-older )
- [Updating to GitLab 9.0 ](version_specific_updates.md#updating-to-gitlab-90 )
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-06-25 05:08:57 -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.
1. [Update GitLab on the **primary** node using Omnibus ](https://docs.gitlab.com/omnibus/update/README.html ).
1. Log into each **secondary** node.
1. [Update GitLab on each **secondary** node using Omnibus ](https://docs.gitlab.com/omnibus/update/README.html ).
2020-06-25 05:08:57 -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.
2019-09-01 22:48:55 -04:00
If you encounter any issues, please consult the [Geo troubleshooting guide ](troubleshooting.md ).