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
4855987a
Commit
4855987a
authored
Mar 13, 2018
by
Gabriel Mazetto
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Use NOTE: CAUTION: markup
parent
87433f2f
Changes
4
Show whitespace changes
Inline
Side-by-side
Showing
4 changed files
with
28 additions
and
24 deletions
+28
-24
doc/administration/geo/replication/configuration.md
doc/administration/geo/replication/configuration.md
+4
-4
doc/administration/geo/replication/configuration_source.md
doc/administration/geo/replication/configuration_source.md
+3
-3
doc/administration/geo/replication/database.md
doc/administration/geo/replication/database.md
+11
-9
doc/administration/geo/replication/database_source.md
doc/administration/geo/replication/database_source.md
+10
-8
No files found.
doc/administration/geo/replication/configuration.md
View file @
4855987a
# Geo configuration
# Geo configuration
>
**Note:**
NOTE:
**Note:**
This is the documentation for the Omnibus GitLab packages. For installations
This is the documentation for the Omnibus GitLab packages. For installations
from source, follow the
[
**Geo nodes configuration for installations
from source, follow the
[
**Geo nodes configuration for installations
from source**
][
configuration-source
]
guide.
from source**
][
configuration-source
]
guide.
## Configuring a new secondary node
## Configuring a new secondary node
>
**Note:**
NOTE:
**Note:**
This is the final step in setting up a secondary Geo node. Stages of the
This is the final step in setting up a secondary Geo node. Stages of the
setup process must be completed in the documented order.
setup process must be completed in the documented order.
Before attempting the steps in this stage,
[
complete all prior stages
][
setup-geo-omnibus
]
.
Before attempting the steps in this stage,
[
complete all prior stages
][
setup-geo-omnibus
]
.
...
@@ -20,9 +20,9 @@ You are encouraged to first read through all the steps before executing them
...
@@ -20,9 +20,9 @@ You are encouraged to first read through all the steps before executing them
in your testing/production environment.
in your testing/production environment.
> **Notes:**
> **Notes:**
-
**Do not**
setup any custom authentication in the secondary nodes, this will be
>
- **Do not** setup any custom authentication in the secondary nodes, this will be
handled by the primary node.
handled by the primary node.
-
Any change that requires access to the
**Admin Area**
needs to be done in the
>
- Any change that requires access to the **Admin Area** needs to be done in the
primary node, as the secondary node is a read-only replica.
primary node, as the secondary node is a read-only replica.
### Step 1. Manually replicate secret GitLab values
### Step 1. Manually replicate secret GitLab values
...
...
doc/administration/geo/replication/configuration_source.md
View file @
4855987a
# Geo configuration
# Geo configuration
>
**Note:**
NOTE:
**Note:**
This is the documentation for installations from source. For installations
This is the documentation for installations from source. For installations
using the Omnibus GitLab packages, follow the
using the Omnibus GitLab packages, follow the
[
**Omnibus Geo nodes configuration**
][
configuration
]
guide.
[
**Omnibus Geo nodes configuration**
][
configuration
]
guide.
## Configuring a new secondary node
## Configuring a new secondary node
>
**Note:**
NOTE:
**Note:**
This is the final step in setting up a secondary Geo node. Stages of the setup
This is the final step in setting up a secondary Geo node. Stages of the setup
process must be completed in the documented order. Before attempting the steps
process must be completed in the documented order. Before attempting the steps
in this stage,
[
complete all prior stages
][
setup-geo-source
]
.
in this stage,
[
complete all prior stages
][
setup-geo-source
]
.
...
@@ -20,7 +20,7 @@ You are encouraged to first read through all the steps before executing them
...
@@ -20,7 +20,7 @@ You are encouraged to first read through all the steps before executing them
in your testing/production environment.
in your testing/production environment.
>
**Notes:**
NOTE:
**Notes:**
-
**Do not**
setup any custom authentication in the secondary nodes, this will be
-
**Do not**
setup any custom authentication in the secondary nodes, this will be
handled by the primary node.
handled by the primary node.
-
**Do not**
add anything in the secondaries Geo nodes admin area
-
**Do not**
add anything in the secondaries Geo nodes admin area
...
...
doc/administration/geo/replication/database.md
View file @
4855987a
# Geo database replication
# Geo database replication
>
**Note:**
NOTE:
**Note:**
This is the documentation for the Omnibus GitLab packages. For installations
This is the documentation for the Omnibus GitLab packages. For installations
from source, follow the
from source, follow the
[
**database replication for installations from source**
][
database-source
]
guide.
[
**database replication for installations from source**
][
database-source
]
guide.
>
**Note:**
NOTE:
**Note:**
If your GitLab installation uses external PostgreSQL, the Omnibus roles
If your GitLab installation uses external PostgreSQL, the Omnibus roles
will not be able to perform all necessary configuration steps. Refer to the
will not be able to perform all necessary configuration steps. Refer to the
section on
[
External PostreSQL
][
external postgresql
]
for additional instructions.
section on
[
External PostreSQL
][
external postgresql
]
for additional instructions.
>
**Note:**
NOTE:
**Note:**
The stages of the setup process must be completed in the documented order.
The stages of the setup process must be completed in the documented order.
Before attempting the steps in this stage,
[
complete all prior stages
][
toc
]
.
Before attempting the steps in this stage,
[
complete all prior stages
][
toc
]
.
...
@@ -28,7 +28,7 @@ The GitLab primary node where the write operations happen will connect to
...
@@ -28,7 +28,7 @@ The GitLab primary node where the write operations happen will connect to
the primary database server, and the secondary nodes which are read-only will
the primary database server, and the secondary nodes which are read-only will
connect to the secondary database servers (which are also read-only).
connect to the secondary database servers (which are also read-only).
>
**Note:**
NOTE:
**Note:**
In database documentation you may see "primary" being referenced as "master"
In database documentation you may see "primary" being referenced as "master"
and "secondary" as either "slave" or "standby" server (read-only).
and "secondary" as either "slave" or "standby" server (read-only).
...
@@ -256,7 +256,8 @@ The following guide assumes that:
...
@@ -256,7 +256,8 @@ The following guide assumes that:
gitlab-ctl stop sidekiq
gitlab-ctl stop sidekiq
```
```
> **Note**: This step is important so we don't try to execute anything before the node is fully configured.
NOTE: **Note**:
This step is important so we don't try to execute anything before the node is fully configured.
1.
[
Check TCP connectivity
][
rake-maintenance
]
to the primary's PostgreSQL server:
1.
[
Check TCP connectivity
][
rake-maintenance
]
to the primary's PostgreSQL server:
...
@@ -264,7 +265,8 @@ The following guide assumes that:
...
@@ -264,7 +265,8 @@ The following guide assumes that:
gitlab-rake gitlab:tcp_check[1.2.3.4,5432]
gitlab-rake gitlab:tcp_check[1.2.3.4,5432]
```
```
> **Note**: If this step fails, you may be using the wrong IP address, or a firewall may
NOTE: **Note**:
If this step fails, you may be using the wrong IP address, or a firewall may
be preventing access to the server. Check the IP address, paying close
be preventing access to the server. Check the IP address, paying close
attention to the difference between public and private addresses and ensure
attention to the difference between public and private addresses and ensure
that, if a firewall is present, the secondary is permitted to connect to the
that, if a firewall is present, the secondary is permitted to connect to the
...
@@ -352,7 +354,7 @@ The directories used are the defaults that are set up in Omnibus. If you have
...
@@ -352,7 +354,7 @@ The directories used are the defaults that are set up in Omnibus. If you have
changed any defaults or are using a source installation, configure it as you
changed any defaults or are using a source installation, configure it as you
see fit replacing the directories and paths.
see fit replacing the directories and paths.
>
**Warning:**
CAUTION:
**Warning:**
Make sure to run this on the
**secondary**
server as it removes all PostgreSQL's
Make sure to run this on the
**secondary**
server as it removes all PostgreSQL's
data before running
`pg_basebackup`
.
data before running
`pg_basebackup`
.
...
@@ -368,7 +370,7 @@ data before running `pg_basebackup`.
...
@@ -368,7 +370,7 @@ data before running `pg_basebackup`.
name as shown in the commands below.
name as shown in the commands below.
1.
Execute the command below to start a backup/restore and begin the replication
1.
Execute the command below to start a backup/restore and begin the replication
>
**Warning:** Each Geo secondary must have its own unique replication slot name.
CAUTION:
**Warning:**
Each Geo secondary must have its own unique replication slot name.
Using the same slot name between two secondaries will break PostgreSQL replication.
Using the same slot name between two secondaries will break PostgreSQL replication.
```bash
```bash
...
...
doc/administration/geo/replication/database_source.md
View file @
4855987a
# Geo database replication
# Geo database replication
>
**Note:**
NOTE:
**Note:**
This is the documentation for installations from source. For installations
This is the documentation for installations from source. For installations
using the Omnibus GitLab packages, follow the
using the Omnibus GitLab packages, follow the
[
**database replication for Omnibus GitLab**
][
database
]
guide.
[
**database replication for Omnibus GitLab**
][
database
]
guide.
>
**Note:**
NOTE:
**Note:**
The stages of the setup process must be completed in the documented order.
The stages of the setup process must be completed in the documented order.
Before attempting the steps in this stage,
[
complete all prior stages
][
toc
]
.
Before attempting the steps in this stage,
[
complete all prior stages
][
toc
]
.
...
@@ -22,7 +22,7 @@ The GitLab primary node where the write operations happen will connect to
...
@@ -22,7 +22,7 @@ The GitLab primary node where the write operations happen will connect to
primary database server, and the secondary ones which are read-only will
primary database server, and the secondary ones which are read-only will
connect to secondary database servers (which are read-only too).
connect to secondary database servers (which are read-only too).
>
**Note:**
NOTE:
**Note:**
In many databases documentation you will see "primary" being referenced as "master"
In many databases documentation you will see "primary" being referenced as "master"
and "secondary" as either "slave" or "standby" server (read-only).
and "secondary" as either "slave" or "standby" server (read-only).
...
@@ -91,10 +91,11 @@ The following guide assumes that:
...
@@ -91,10 +91,11 @@ The following guide assumes that:
1.
Set up TLS support for the PostgreSQL primary server
1.
Set up TLS support for the PostgreSQL primary server
> **Warning**: Only skip this step if you **know** that PostgreSQL traffic
CAUTION: **Warning**:
> between the primary and secondary will be secured through some other
Only skip this step if you **know** that PostgreSQL traffic
> means, e.g., a known-safe physical network path or a site-to-site VPN that
between the primary and secondary will be secured through some other
> you have configured.
means, e.g., a known-safe physical network path or a site-to-site VPN that
you have configured.
If you are replicating your database across the open Internet, it is
If you are replicating your database across the open Internet, it is
**essential** that the connection is TLS-secured. Correctly configured, this
**essential** that the connection is TLS-secured. Correctly configured, this
...
@@ -141,6 +142,7 @@ The following guide assumes that:
...
@@ -141,6 +142,7 @@ The following guide assumes that:
hot_standby = on
hot_standby = on
```
```
NOTE: **Note**:
Be sure to set `max_replication_slots` to the number of Geo secondary
Be sure to set `max_replication_slots` to the number of Geo secondary
nodes that you may potentially have (at least 1).
nodes that you may potentially have (at least 1).
...
@@ -302,7 +304,7 @@ needed files for streaming replication.
...
@@ -302,7 +304,7 @@ needed files for streaming replication.
The directories used are the defaults for Debian/Ubuntu. If you have changed
The directories used are the defaults for Debian/Ubuntu. If you have changed
any defaults, configure it as you see fit replacing the directories and paths.
any defaults, configure it as you see fit replacing the directories and paths.
>
**Warning:**
CAUTION:
**Warning:**
Make sure to run this on the **secondary** server as it removes all PostgreSQL's
Make sure to run this on the **secondary** server as it removes all PostgreSQL's
data before running `pg_basebackup`.
data before running `pg_basebackup`.
...
...
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