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
c6fc582f
Commit
c6fc582f
authored
May 03, 2021
by
Suzanne Selhorn
Committed by
Achilleas Pipinellis
May 04, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Fixed Vale future tense issues
parent
9bf53bbc
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
10 additions
and
12 deletions
+10
-12
doc/administration/geo/disaster_recovery/index.md
doc/administration/geo/disaster_recovery/index.md
+10
-12
No files found.
doc/administration/geo/disaster_recovery/index.md
View file @
c6fc582f
...
@@ -62,8 +62,7 @@ must disable the **primary** node.
...
@@ -62,8 +62,7 @@ must disable the **primary** node.
-
If you do not have SSH access to the
**primary**
node, take the machine offline and
-
If you do not have SSH access to the
**primary**
node, take the machine offline and
prevent it from rebooting by any means at your disposal.
prevent it from rebooting by any means at your disposal.
Since there are many ways you may prefer to accomplish this, we will avoid a
You might need to:
single recommendation. You may need to:
-
Reconfigure the load balancers.
-
Reconfigure the load balancers.
-
Change DNS records (for example, point the primary DNS record to the
-
Change DNS records (for example, point the primary DNS record to the
...
@@ -240,11 +239,11 @@ an external PostgreSQL database, as it can only perform changes on a **secondary
...
@@ -240,11 +239,11 @@ an external PostgreSQL database, as it can only perform changes on a **secondary
node with GitLab and the database on the same machine. As a result, a manual process is
node with GitLab and the database on the same machine. As a result, a manual process is
required:
required:
1.
Promote the replica database associated with the
**secondary**
site. This
will
1.
Promote the replica database associated with the
**secondary**
site. This
set the database to read-write. The instructions vary depending on where your database is hosted:
set
s
the database to read-write. The instructions vary depending on where your database is hosted:
-
[
Amazon RDS
](
https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html#USER_ReadRepl.Promote
)
-
[
Amazon RDS
](
https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html#USER_ReadRepl.Promote
)
-
[
Azure PostgreSQL
](
https://docs.microsoft.com/en-us/azure/postgresql/howto-read-replicas-portal#stop-replication
)
-
[
Azure PostgreSQL
](
https://docs.microsoft.com/en-us/azure/postgresql/howto-read-replicas-portal#stop-replication
)
-
For other external PostgreSQL databases, save the following script in you
-
For other external PostgreSQL databases, save the following script in you
r
secondary node, for example
`/tmp/geo_promote.sh`
, and modify the connection
secondary node, for example
`/tmp/geo_promote.sh`
, and modify the connection
parameters to match your environment. Then, execute it to promote the replica:
parameters to match your environment. Then, execute it to promote the replica:
...
@@ -292,7 +291,7 @@ required:
...
@@ -292,7 +291,7 @@ required:
### Step 4. (Optional) Updating the primary domain DNS record
### Step 4. (Optional) Updating the primary domain DNS record
Updating the DNS records for the primary domain to point to the
**secondary**
node
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 to the
to
prevent the need to update all references to the primary domain to the
secondary domain, like changing Git remotes and API URLs.
secondary domain, like changing Git remotes and API URLs.
1.
SSH into the
**secondary**
node and login as root:
1.
SSH into the
**secondary**
node and login as root:
...
@@ -311,7 +310,7 @@ secondary domain, like changing Git remotes and API URLs.
...
@@ -311,7 +310,7 @@ secondary domain, like changing Git remotes and API URLs.
```
```
NOTE:
NOTE:
Changing
`external_url`
won'
t prevent access via the old secondary URL, as
Changing
`external_url`
does no
t prevent access via the old secondary URL, as
long as the secondary DNS records are still intact.
long as the secondary DNS records are still intact.
1.
Reconfigure the
**secondary**
node for the change to take effect:
1.
Reconfigure the
**secondary**
node for the change to take effect:
...
@@ -326,7 +325,7 @@ secondary domain, like changing Git remotes and API URLs.
...
@@ -326,7 +325,7 @@ secondary domain, like changing Git remotes and API URLs.
gitlab-rake geo:update_primary_node_url
gitlab-rake geo:update_primary_node_url
```
```
This command
will use
the changed
`external_url`
configuration defined
This command
uses
the changed
`external_url`
configuration defined
in
`/etc/gitlab/gitlab.rb`
.
in
`/etc/gitlab/gitlab.rb`
.
1.
For GitLab 11.11 through 12.7 only, you may need to update the
**primary**
1.
For GitLab 11.11 through 12.7 only, you may need to update the
**primary**
...
@@ -334,7 +333,7 @@ secondary domain, like changing Git remotes and API URLs.
...
@@ -334,7 +333,7 @@ secondary domain, like changing Git remotes and API URLs.
To determine if you need to do this, search for the
To determine if you need to do this, search for the
`gitlab_rails["geo_node_name"]`
setting in your
`/etc/gitlab/gitlab.rb`
`gitlab_rails["geo_node_name"]`
setting in your
`/etc/gitlab/gitlab.rb`
file. If it is commented out with
`#`
or not found at all, then you
will
file. If it is commented out with
`#`
or not found at all, then you
need to update the
**primary**
node's name in the database. You can search for it
need to update the
**primary**
node's name in the database. You can search for it
like so:
like so:
...
@@ -444,7 +443,7 @@ and after that you also need two extra steps.
...
@@ -444,7 +443,7 @@ and after that you also need two extra steps.
Now we need to make each
**secondary**
node listen to changes on the new
**primary**
node. To do that you need
Now we need to make each
**secondary**
node listen to changes on the new
**primary**
node. To do that you need
to
[
initiate the replication process
](
../setup/database.md#step-3-initiate-the-replication-process
)
again but this time
to
[
initiate the replication process
](
../setup/database.md#step-3-initiate-the-replication-process
)
again but this time
for another
**primary**
node. All the old replication settings
will b
e overwritten.
for another
**primary**
node. All the old replication settings
ar
e overwritten.
## Promoting a secondary Geo cluster in GitLab Cloud Native Helm Charts
## Promoting a secondary Geo cluster in GitLab Cloud Native Helm Charts
...
@@ -479,8 +478,7 @@ must disable the **primary** site:
...
@@ -479,8 +478,7 @@ must disable the **primary** site:
-
If you do not have access to the
**primary**
Kubernetes cluster, take the cluster offline and
-
If you do not have access to the
**primary**
Kubernetes cluster, take the cluster offline and
prevent it from coming back online by any means at your disposal.
prevent it from coming back online by any means at your disposal.
Since there are many ways you may prefer to accomplish this, we will avoid a
You might need to:
single recommendation. You may need to:
-
Reconfigure the load balancers.
-
Reconfigure the load balancers.
-
Change DNS records (for example, point the primary DNS record to the
-
Change DNS records (for example, point the primary DNS record to the
...
...
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