Removing secondary Geo nodes
Secondary nodes can be removed from the Geo cluster using the Geo admin page of the primary node. To remove a secondary node:
- Navigate to Admin Area > Geo (
/admin/geo/nodes
). - Click the Remove button for the secondary node you want to remove.
- Confirm by clicking Remove when the prompt appears.
Once removed from the Geo admin page, you must stop and uninstall the secondary node:
-
On the secondary node, stop GitLab:
sudo gitlab-ctl stop
-
On the secondary node, uninstall GitLab:
# Stop gitlab and remove its supervision process sudo gitlab-ctl uninstall # Debian/Ubuntu sudo dpkg --remove gitlab-ee # Redhat/Centos sudo rpm --erase gitlab-ee
Once GitLab has been uninstalled from the secondary node, the replication slot must be dropped from the primary node’s database as follows:
-
On the primary node, start a PostgreSQL console session:
sudo gitlab-psql
Note: Usinggitlab-rails dbconsole
will not work, because managing replication slots requires superuser permissions. -
Find the name of the relevant replication slot. This is the slot that is specified with
--slot-name
when running the replicate command:gitlab-ctl replicate-geo-database
.SELECT * FROM pg_replication_slots;
-
Remove the replication slot for the secondary node:
SELECT pg_drop_replication_slot('<name_of_slot>');
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc