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
dee797ea
Commit
dee797ea
authored
Dec 20, 2017
by
James Ramsay
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add description of final state: geo not enabled
parent
c5b282b4
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
14 additions
and
14 deletions
+14
-14
doc/gitlab-geo/disaster-recovery.md
doc/gitlab-geo/disaster-recovery.md
+14
-14
No files found.
doc/gitlab-geo/disaster-recovery.md
View file @
dee797ea
# Disaster Recovery
#
GitLab Geo
Disaster Recovery
> **Note:** Disaster Recovery is in **Alpha** development. Do not use this as
> **Note:** Disaster Recovery is in **Alpha** development. Do not use this as
> your only Disaster Recovery strategy as you may lose data.
> your only Disaster Recovery strategy as you may lose data.
...
@@ -17,6 +17,9 @@ See [current limitations](README.md#current-limitations) for more information.
...
@@ -17,6 +17,9 @@ See [current limitations](README.md#current-limitations) for more information.
We don't provide yet an automated way to promote a node and do fail-over,
We don't provide yet an automated way to promote a node and do fail-over,
but you can do it manually if you have
`root`
access to the machine.
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.
It does not enable GitLab Geo on the newly promoted primary.
1.
Take down your
**primary**
node.
1.
Take down your
**primary**
node.
SSH into your primary node and stop GitLab.
SSH into your primary node and stop GitLab.
...
@@ -40,14 +43,14 @@ but you can do it manually if you have `root` access to the machine.
...
@@ -40,14 +43,14 @@ but you can do it manually if you have `root` access to the machine.
sudo -i
sudo -i
```
```
1.
Optional. Update the
DNS records and the
`external_url`
.
1.
Optional. Update the
primary domains 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
node will prevent the need to update all references to the primary domain
to the secondary domain, like changing Git remotes and API URLs.
to the secondary domain, like changing Git remotes and API URLs.
After updating the
DNS records, edit `/etc/gitlab/gitlab.rb` to reflect the
After updating the
primary domains DNS records to point to the secondary,
new URL:
edit `/etc/gitlab/gitlab.rb` on the the secondary to reflect the
new URL:
```
```
# Change the existing external_url configuration
# Change the existing external_url configuration
...
@@ -63,13 +66,6 @@ but you can do it manually if you have `root` access to the machine.
...
@@ -63,13 +66,6 @@ but you can do it manually if you have `root` access to the machine.
geo_secondary_role['enable'] = true
geo_secondary_role['enable'] = true
```
```
Add the following line:
```
## ADD THIS LINE
geo_primary_role['enable'] = true
```
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 node to the primary node.
...
@@ -87,6 +83,10 @@ but you can do it manually if you have `root` access to the machine.
...
@@ -87,6 +83,10 @@ but you can do it manually if you have `root` access to the machine.
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 propogated depending on the previous DNS records TTL.
not have yet propogated depending on the previous DNS records TTL.
To bring your old primary node back into use as a working secondary, you need to
## Add secondary nodes to a promoted primary
run
`gitlab-ctl reconfigure`
against the node and then follow the
[
setup instructions
](
README.md
)
again, as if for a secondary node, from step 3.
Promoting a secondary node to primary using the process above does not enable
GitLab Geo on the new primary.
To bring a new secondary node online, follow the
[
GitLab Geo 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