1. Visit the **primary** node's **Admin Area ➔ Settings**
1. Visit the **primary** node's **Admin Area ➔ Settings**
(`/admin/application_settings`) in your browser
(`/admin/application_settings`) in your browser
...
@@ -149,25 +125,12 @@ Using hashed storage significantly improves Geo replication - project and group
...
@@ -149,25 +125,12 @@ Using hashed storage significantly improves Geo replication - project and group
renames no longer require synchronization between nodes - so we recommend it is
renames no longer require synchronization between nodes - so we recommend it is
used for all GitLab Geo installations.
used for all GitLab Geo installations.
### Step 5. Enabling the secondary GitLab node
### Step 4. Enabling the secondary GitLab node
1. SSH into the **secondary** node and login as root:
```
sudo -i
```
1. Get the contents of `id_rsa.pub` key that was pre-generated by Omnibus GitLab
and copy them:
```
sudo -u git cat /var/opt/gitlab/.ssh/id_rsa.pub
```
1. Visit the **primary** node's **Admin Area ➔ Geo Nodes** (`/admin/geo_nodes`)
1. Visit the **primary** node's **Admin Area ➔ Geo Nodes** (`/admin/geo_nodes`)
in your browser.
in your browser.
1. Add the secondary node by providing its full URL and the public SSH key
1. Add the secondary node by providing its full URL. **Do NOT** check the box
you created previously. **Do NOT** check the box 'This is a primary node'.
'This is a primary node'.
1. Added in GitLab 9.5: Choose which namespaces should be replicated by the secondary node. Leave blank to replicate all. Read more in [selective replication](#selective-replication).
1. Added in GitLab 9.5: Choose which namespaces should be replicated by the secondary node. Leave blank to replicate all. Read more in [selective replication](#selective-replication).
1. Click the **Add node** button.
1. Click the **Add node** button.
1. Restart GitLab on the secondary:
1. Restart GitLab on the secondary:
...
@@ -175,11 +138,14 @@ used for all GitLab Geo installations.
...
@@ -175,11 +138,14 @@ used for all GitLab Geo installations.
```
```
gitlab-ctl restart
gitlab-ctl restart
```
```
---
---
After the **Add Node** button is pressed, the primary node will start to notify
After the **Add Node** button is pressed, the secondary will start automatically
changes to the secondary. Make sure the secondary instance is running and
replicating missing data from the primary in a process known as backfill.
accessible.
Meanwhile, the primary node will start to notify changes to the secondary, which
will act on those notifications immediately. Make sure the secondary instance is
running and accessible.
The two most obvious issues that replication can have here are:
The two most obvious issues that replication can have here are:
...
@@ -187,23 +153,15 @@ The two most obvious issues that replication can have here are:
...
@@ -187,23 +153,15 @@ The two most obvious issues that replication can have here are:
1. Instance to instance notification not working. In that case, it can be
1. Instance to instance notification not working. In that case, it can be
something of the following:
something of the following:
- You are using a custom certificate or custom CA (see the
- You are using a custom certificate or custom CA (see the
Read more in [additional info for SSH key pairs](#additional-information-for-the-ssh-key-pairs).
1. Get the contents of `id_rsa.pub` the was just created:
```
sudo -u git cat /home/git/.ssh/id_rsa.pub
```
1. Visit the **primary** node's **Admin Area ➔ Geo Nodes** (`/admin/geo_nodes`)
1. Visit the **primary** node's **Admin Area ➔ Geo Nodes** (`/admin/geo_nodes`)
in your browser.
in your browser.
1. Add the secondary node by providing its full URL and the public SSH key
1. Add the secondary node by providing its full URL. **Do NOT** check the box
you created previously. **Do NOT** check the box 'This is a primary node'.
'This is a primary node'.
1. Added in GitLab 9.5: Choose which namespaces should be replicated by the secondary node. Leave blank to replicate all. Read more in [selective replication](#selective-replication).
1. Added in GitLab 9.5: Choose which namespaces should be replicated by the secondary node. Leave blank to replicate all. Read more in [selective replication](#selective-replication).
1. Click the **Add node** button.
1. Click the **Add node** button.
1. Restart GitLab on the secondary:
```
gitlab-ctl restart
```
---
---
After the **Add Node** button is pressed, the primary node will start to notify
After the **Add Node** button is pressed, the secondary will start automatically
changes to the secondary. Make sure the secondary instance is running and
replicating missing data from the primary in a process known as backfill.
accessible.
Meanwhile, the primary node will start to notify changes to the secondary, which
will act on those notifications immediately. Make sure the secondary instance is
running and accessible.
The two most obvious issues that replication can have here are:
The two most obvious issues that replication can have here are:
...
@@ -188,20 +150,12 @@ The two most obvious issues that replication can have here are:
...
@@ -188,20 +150,12 @@ The two most obvious issues that replication can have here are: