Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
fc6025d4
Commit
fc6025d4
authored
Dec 21, 2017
by
James Ramsay
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Remove confusing language similar to HA nodes
parent
d2272139
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
22 additions
and
23 deletions
+22
-23
doc/gitlab-geo/disaster-recovery.md
doc/gitlab-geo/disaster-recovery.md
+22
-23
No files found.
doc/gitlab-geo/disaster-recovery.md
View file @
fc6025d4
...
@@ -9,35 +9,34 @@ fail-over with minimal effort, in a disaster situation.
...
@@ -9,35 +9,34 @@ fail-over with minimal effort, in a disaster situation.
See
[
current limitations
](
README.md#current-limitations
)
for more information.
See
[
current limitations
](
README.md#current-limitations
)
for more information.
## Promoting a secondary
node
## Promoting a secondary
geo replica
> **Warning:** Disaster Recovery does not yet support systems with multiple
> **Warning:** Disaster Recovery does not yet support systems with multiple
> secondary
nodes (3-node systems or greater
).
> secondary
geo replicas (e.g. one primary and two or more secondaries
).
We don't
provide yet an automated way to promote a node and do fail-over,
We don't
currently provide an automated way to promote a geo replica and do a
but you can do it manually if you have
`root`
access to the machine.
fail-over,
but you can do it manually if you have
`root`
access to the machine.
This process promotes a secondary
node to a primary node by the shortest path
.
This process promotes a secondary
geo replica to a primary in the least steps
.
It does not enable GitLab Geo on the newly promoted primary.
It does not enable GitLab Geo on the newly promoted primary.
1.
Take down your
**primary**
node.
1.
SSH into your
**primary**
and stop disable GitLab.
SSH into your primary node and stop GitLab.
```
```
sudo gitlab-ctl stop
sudo gitlab-ctl stop
```
```
If you do not have SSH access to your primary
node take the machine
If you do not have SSH access to your primary
take the machine offline.
offline. Depending on the nature of your primary node this may mean
Depending on the nature of your primary this may mean physically
physically disconnecting the machine, stopping a virtual server,
disconnecting the machine, stopping a virtual server, reconfiguring load
reconfiguring load
balancers, or changing DNS records (see next step).
balancers, or changing DNS records (see next step).
Preventing the original primary from coming online during this process is
Preventing the original primary from coming online during this process is
necessary to ensure data isn't added to the original primary that will not
necessary to ensure data isn't added to the original primary that will not
be replicated to the newly promoted primary.
be replicated to the newly promoted primary.
1.
SSH in to your
**secondary**
node
and login as root:
1.
SSH in to your
**secondary**
and login as root:
```
```
sudo -i
sudo -i
...
@@ -46,8 +45,8 @@ It does not enable GitLab Geo on the newly promoted primary.
...
@@ -46,8 +45,8 @@ It does not enable GitLab Geo on the newly promoted primary.
1.
Optional: Update the primary domain's DNS record.
1.
Optional: Update the primary domain's DNS record.
Updating the DNS records for the primary domain to point to the secondary
Updating the DNS records for the primary domain to point to the secondary
node will prevent the need to update all references to the primary domain
will prevent the need to update all references to the primary domain to the
to the
secondary domain, like changing Git remotes and API URLs.
secondary domain, like changing Git remotes and API URLs.
After updating the primary domain's DNS records to point to the secondary,
After updating the primary domain's DNS records to point to the secondary,
edit `/etc/gitlab/gitlab.rb` on the the secondary to reflect the new URL:
edit `/etc/gitlab/gitlab.rb` on the the secondary to reflect the new URL:
...
@@ -57,7 +56,7 @@ It does not enable GitLab Geo on the newly promoted primary.
...
@@ -57,7 +56,7 @@ It does not enable GitLab Geo on the newly promoted primary.
external_url 'https://gitlab.example.com'
external_url 'https://gitlab.example.com'
```
```
1.
Edit
`/etc/gitlab/gitlab.rb`
to reflect its new status as primary
node
.
1.
Edit
`/etc/gitlab/gitlab.rb`
to reflect its new status as primary.
Remove the following line:
Remove the following line:
...
@@ -68,9 +67,9 @@ It does not enable GitLab Geo on the newly promoted primary.
...
@@ -68,9 +67,9 @@ It does not enable GitLab Geo on the newly promoted primary.
A new secondary should not be added at this time. If you want to add a new
A new secondary should not be added at this time. If you want to add a new
secondary, do this after you have completed the entire process of promoting
secondary, do this after you have completed the entire process of promoting
the secondary
node to the primary node
.
the secondary
to the primary
.
1.
Promote the secondary
geo node to primary node
. Execute:
1.
Promote the secondary
to primary
. Execute:
```
```
gitlab-ctl promote-to-primary-node
gitlab-ctl promote-to-primary-node
...
@@ -78,15 +77,15 @@ It does not enable GitLab Geo on the newly promoted primary.
...
@@ -78,15 +77,15 @@ It does not enable GitLab Geo on the newly promoted primary.
1.
Verify you can connect to the newly promoted primary using the URL used
1.
Verify you can connect to the newly promoted primary using the URL used
previously for the secondary.
previously for the secondary.
1.
Success! The secondary
node has now been promoted to primary node
.
1.
Success! The secondary
has now been promoted to primary
.
If you updated the DNS records for the primary domain, these changes may
If you updated the DNS records for the primary domain, these changes may
not have yet propagated depending on the previous DNS records TTL.
not have yet propagated depending on the previous DNS records TTL.
## Add secondary
node
s to a promoted primary
## Add secondary
geo replica
s to a promoted primary
Promoting a secondary
node
to primary using the process above does not enable
Promoting a secondary to primary using the process above does not enable
GitLab Geo on the new primary.
GitLab Geo on the new primary.
To bring a new secondary
node online, follow the
[
GitLab Geo setup
To bring a new secondary
online, follow the
[
GitLab Geo setup instructions
](
instructions
](
README.md#setup-instructions
)
.
README.md#setup-instructions
)
.
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment