Removing secondary Geo nodes (PREMIUM ONLY)
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:
bash
sudo gitlab-ctl stop
- On the secondary node, uninstall GitLab:
```bash # 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:
bash
sudo gitlab-psql
NOTE: Note:
Using gitlab-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
.
sql
SELECT * FROM pg_replication_slots;
- Remove the replication slot for the secondary node:
sql
SELECT pg_drop_replication_slot('<name_of_slot>');