Commit 4d81fca1 authored by Craig Norris's avatar Craig Norris

Remove please from docs

Removes several instances of please from the docs.
parent 2e7870be
...@@ -13,10 +13,10 @@ info: To determine the technical writer assigned to the Stage/Group associated w ...@@ -13,10 +13,10 @@ info: To determine the technical writer assigned to the Stage/Group associated w
#### Connection refused #### Connection refused
If you are getting `Connection Refused` errors when trying to connect to the If you're getting `Connection Refused` error messages when attempting to
LDAP server please double-check the LDAP `port` and `encryption` settings used by connect to the LDAP server, review the LDAP `port` and `encryption` settings
GitLab. Common combinations are `encryption: 'plain'` and `port: 389`, OR used by GitLab. Common combinations are `encryption: 'plain'` and `port: 389`,
`encryption: 'simple_tls'` and `port: 636`. or `encryption: 'simple_tls'` and `port: 636`.
#### Connection times out #### Connection times out
...@@ -649,8 +649,7 @@ ldapsearch -D "cn=admin,dc=ldap-testing,dc=example,dc=com" \ ...@@ -649,8 +649,7 @@ ldapsearch -D "cn=admin,dc=ldap-testing,dc=example,dc=com" \
Note that the `bind_dn`, `password`, `port`, `host`, and `base` are all Note that the `bind_dn`, `password`, `port`, `host`, and `base` are all
identical to what's configured in the `gitlab.rb`. identical to what's configured in the `gitlab.rb`.
Please see [the official For more information, see the [official `ldapsearch` documentation](https://linux.die.net/man/1/ldapsearch).
`ldapsearch` documentation](https://linux.die.net/man/1/ldapsearch) for more.
### Using **AdFind** (Windows) ### Using **AdFind** (Windows)
...@@ -675,15 +674,15 @@ adfind -h ad.example.org:636 -ssl -u "CN=GitLabSRV,CN=Users,DC=GitLab,DC=org" -u ...@@ -675,15 +674,15 @@ adfind -h ad.example.org:636 -ssl -u "CN=GitLabSRV,CN=Users,DC=GitLab,DC=org" -u
### Rails console ### Rails console
CAUTION: **Caution:** CAUTION: **Caution:**
Please note that it is very easy to create, read, modify, and destroy data on the It is very easy to create, read, modify, and destroy data with the rails
rails console, so please be sure to run commands exactly as listed. console. Be sure to run commands exactly as listed.
The rails console is a valuable tool to help debug LDAP problems. It allows you to The rails console is a valuable tool to help debug LDAP problems. It allows you to
directly interact with the application by running commands and seeing how GitLab directly interact with the application by running commands and seeing how GitLab
responds to them. responds to them.
Please refer to [this guide](../../operations/rails_console.md#starting-a-rails-console-session) For instructions about how to use the rails console, refer to this
for instructions on how to use the rails console. [guide](../../operations/rails_console.md#starting-a-rails-console-session).
#### Enable debug output #### Enable debug output
......
...@@ -134,7 +134,10 @@ Note the following when promoting a secondary: ...@@ -134,7 +134,10 @@ Note the following when promoting a secondary:
1. Promote the **secondary** node to the **primary** node. 1. Promote the **secondary** node to the **primary** node.
DANGER: **Warning:** DANGER: **Warning:**
In GitLab 13.2 and 13.3, promoting a secondary node to a primary while the secondary is paused fails. Do not pause replication before promoting a secondary. If the node is paused, please resume before promoting. This issue has been fixed in GitLab 13.4 or later. In GitLab 13.2 and 13.3, promoting a secondary node to a primary while the
secondary is paused fails. Do not pause replication before promoting a
secondary. If the node is paused, be sure to resume before promoting. This
issue has been fixed in GitLab 13.4 and later.
CAUTION: **Caution:** CAUTION: **Caution:**
If the secondary node [has been paused](../../geo/index.md#pausing-and-resuming-replication), this performs If the secondary node [has been paused](../../geo/index.md#pausing-and-resuming-replication), this performs
...@@ -171,7 +174,10 @@ perform changes on a **secondary** with only a single machine. Instead, you must ...@@ -171,7 +174,10 @@ perform changes on a **secondary** with only a single machine. Instead, you must
do this manually. do this manually.
DANGER: **Warning:** DANGER: **Warning:**
In GitLab 13.2 and 13.3, promoting a secondary node to a primary while the secondary is paused fails. Do not pause replication before promoting a secondary. If the node is paused, please resume before promoting. This issue has been fixed in GitLab 13.4 or later. In GitLab 13.2 and 13.3, promoting a secondary node to a primary while the
secondary is paused fails. Do not pause replication before promoting a
secondary. If the node is paused, be sure to resume before promoting. This
issue has been fixed in GitLab 13.4 and later.
CAUTION: **Caution:** CAUTION: **Caution:**
If the secondary node [has been paused](../../geo/index.md#pausing-and-resuming-replication), this performs If the secondary node [has been paused](../../geo/index.md#pausing-and-resuming-replication), this performs
......
...@@ -228,7 +228,10 @@ perform changes on a **secondary** with only a single machine. Instead, you must ...@@ -228,7 +228,10 @@ perform changes on a **secondary** with only a single machine. Instead, you must
do this manually. do this manually.
DANGER: **Warning:** DANGER: **Warning:**
In GitLab 13.2 and 13.3, promoting a secondary node to a primary while the secondary is paused fails. Do not pause replication before promoting a secondary. If the node is paused, please resume before promoting. This issue has been fixed in GitLab 13.4 or later. In GitLab 13.2 and 13.3, promoting a secondary node to a primary while the
secondary is paused fails. Do not pause replication before promoting a
secondary. If the node is paused, be sure to resume before promoting. This
issue has been fixed in GitLab 13.4 and later.
CAUTION: **Caution:** CAUTION: **Caution:**
If the secondary node [has been paused](../../../geo/index.md#pausing-and-resuming-replication), this performs If the secondary node [has been paused](../../../geo/index.md#pausing-and-resuming-replication), this performs
......
...@@ -197,7 +197,10 @@ For information on how to update your Geo nodes to the latest GitLab version, se ...@@ -197,7 +197,10 @@ For information on how to update your Geo nodes to the latest GitLab version, se
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/35913) in [GitLab Premium](https://about.gitlab.com/pricing/) 13.2. > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/35913) in [GitLab Premium](https://about.gitlab.com/pricing/) 13.2.
DANGER: **Warning:** DANGER: **Warning:**
In GitLab 13.2 and 13.3, promoting a secondary node to a primary while the secondary is paused fails. Do not pause replication before promoting a secondary. If the node is paused, please resume before promoting. This issue has been fixed in GitLab 13.4 or later. In GitLab 13.2 and 13.3, promoting a secondary node to a primary while the
secondary is paused fails. Do not pause replication before promoting a
secondary. If the node is paused, be sure to resume before promoting. This
issue has been fixed in GitLab 13.4 and later.
CAUTION: **Caution:** CAUTION: **Caution:**
Pausing and resuming of replication is currently only supported for Geo installations using an Pausing and resuming of replication is currently only supported for Geo installations using an
......
...@@ -164,7 +164,7 @@ replicating data from those features will cause the data to be **lost**. ...@@ -164,7 +164,7 @@ replicating data from those features will cause the data to be **lost**.
If you wish to use those features on a **secondary** node, or to execute a failover If you wish to use those features on a **secondary** node, or to execute a failover
successfully, you must replicate their data using some other means. successfully, you must replicate their data using some other means.
| Feature | Replicated (added in GitLab version) | Verified (added in GitLab version) | Object Storage replication (please see [Geo with Object Storage](object_storage.md)) | Notes | | Feature | Replicated (added in GitLab version) | Verified (added in GitLab version) | Object Storage replication (see [Geo with Object Storage](object_storage.md)) | Notes |
|:---------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------|:----------------------------------------------------------|:-------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |:---------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------|:----------------------------------------------------------|:-------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Application data in PostgreSQL](../../postgresql/index.md) | **Yes** (10.2) | **Yes** (10.2) | No | | | [Application data in PostgreSQL](../../postgresql/index.md) | **Yes** (10.2) | **Yes** (10.2) | No | |
| [Project repository](../../..//user/project/repository/) | **Yes** (10.2) | **Yes** (10.7) | No | | | [Project repository](../../..//user/project/repository/) | **Yes** (10.2) | **Yes** (10.7) | No | |
......
...@@ -43,8 +43,8 @@ In any case, you require: ...@@ -43,8 +43,8 @@ In any case, you require:
- A working GitLab **secondary** node. - A working GitLab **secondary** node.
- A Route53 Hosted Zone managing your domain. - A Route53 Hosted Zone managing your domain.
If you have not yet setup a Geo **primary** node and **secondary** node, please consult If you haven't yet set up a Geo _primary_ node and _secondary_ node, see the
[the Geo setup instructions](../index.md#setup-instructions). [Geo setup instructions](../index.md#setup-instructions).
## Create a traffic policy ## Create a traffic policy
......
...@@ -72,7 +72,7 @@ If you are using Google Cloud Storage, consider using ...@@ -72,7 +72,7 @@ If you are using Google Cloud Storage, consider using
Or you can use the [Storage Transfer Service](https://cloud.google.com/storage-transfer/docs/), Or you can use the [Storage Transfer Service](https://cloud.google.com/storage-transfer/docs/),
although this only supports daily synchronization. although this only supports daily synchronization.
For manual synchronization, or scheduled by `cron`, please have a look at: For manual synchronization, or scheduled by `cron`, see:
- [`s3cmd sync`](https://s3tools.org/s3cmd-sync) - [`s3cmd sync`](https://s3tools.org/s3cmd-sync)
- [`gsutil rsync`](https://cloud.google.com/storage/docs/gsutil/commands/rsync) - [`gsutil rsync`](https://cloud.google.com/storage/docs/gsutil/commands/rsync)
...@@ -720,7 +720,8 @@ GitLab cannot find or doesn't have permission to access the `database_geo.yml` c ...@@ -720,7 +720,8 @@ GitLab cannot find or doesn't have permission to access the `database_geo.yml` c
In an Omnibus GitLab installation, the file should be in `/var/opt/gitlab/gitlab-rails/etc`. In an Omnibus GitLab installation, the file should be in `/var/opt/gitlab/gitlab-rails/etc`.
If it doesn't exist or inadvertent changes have been made to it, run `sudo gitlab-ctl reconfigure` to restore it to its correct state. If it doesn't exist or inadvertent changes have been made to it, run `sudo gitlab-ctl reconfigure` to restore it to its correct state.
If this path is mounted on a remote volume, please check your volume configuration and that it has correct permissions. If this path is mounted on a remote volume, ensure your volume configuration
has the correct permissions.
### An existing tracking database cannot be reused ### An existing tracking database cannot be reused
......
...@@ -8,7 +8,9 @@ type: howto ...@@ -8,7 +8,9 @@ type: howto
# Updating the Geo nodes **(PREMIUM ONLY)** # Updating the Geo nodes **(PREMIUM ONLY)**
CAUTION: **Warning:** CAUTION: **Warning:**
Please ensure you read these sections carefully before updating your Geo nodes! Not following version-specific update steps may result in unexpected downtime. Please [contact support](https://about.gitlab.com/support/#contact-support) if you have any specific questions. Read these sections carefully before updating your Geo nodes. Not following
version-specific update steps may result in unexpected downtime. If you have
any specific questions, [contact Support](https://about.gitlab.com/support/#contact-support).
Updating Geo nodes involves performing: Updating Geo nodes involves performing:
...@@ -47,4 +49,4 @@ everything is working correctly: ...@@ -47,4 +49,4 @@ everything is working correctly:
1. Test the data replication by pushing code to the **primary** node and see if it 1. Test the data replication by pushing code to the **primary** node and see if it
is received by **secondary** nodes. is received by **secondary** nodes.
If you encounter any issues, please consult the [Geo troubleshooting guide](troubleshooting.md). If you encounter any issues, see the [Geo troubleshooting guide](troubleshooting.md).
...@@ -249,9 +249,9 @@ gitlab_rails['shared_path'] = '/gitlab-nfs/gitlab-data/shared' ...@@ -249,9 +249,9 @@ gitlab_rails['shared_path'] = '/gitlab-nfs/gitlab-data/shared'
gitlab_ci['builds_directory'] = '/gitlab-nfs/gitlab-data/builds' gitlab_ci['builds_directory'] = '/gitlab-nfs/gitlab-data/builds'
``` ```
Run `sudo gitlab-ctl reconfigure` to start using the central location. Please Run `sudo gitlab-ctl reconfigure` to start using the central location. Be aware
be aware that if you had existing data you will need to manually copy/rsync it that if you had existing data, you'll need to manually copy or rsync it to
to these new locations and then restart GitLab. these new locations, and then restart GitLab.
### Bind mounts ### Bind mounts
...@@ -399,8 +399,8 @@ Additionally, this configuration is specifically warned against in the ...@@ -399,8 +399,8 @@ Additionally, this configuration is specifically warned against in the
>system semantics, this can cause reliability problems. Specifically, delayed (asynchronous) writes >system semantics, this can cause reliability problems. Specifically, delayed (asynchronous) writes
>to the NFS server can cause data corruption problems. >to the NFS server can cause data corruption problems.
For supported database architecture, please see our documentation on For supported database architecture, see our documentation about
[Configuring a Database for GitLab HA](postgresql/replication_and_failover.md). [configuring a database for replication and failover](postgresql/replication_and_failover.md).
<!-- ## Troubleshooting <!-- ## Troubleshooting
......
...@@ -46,4 +46,4 @@ If it finds a reply key, it will be able to leave your reply as a comment on ...@@ -46,4 +46,4 @@ If it finds a reply key, it will be able to leave your reply as a comment on
the entity the notification was about (issue, merge request, commit...). the entity the notification was about (issue, merge request, commit...).
For more details about the `Message-ID`, `In-Reply-To`, and `References headers`, For more details about the `Message-ID`, `In-Reply-To`, and `References headers`,
please consult [RFC 5322](https://tools.ietf.org/html/rfc5322#section-3.6.4). see [RFC 5322](https://tools.ietf.org/html/rfc5322#section-3.6.4).
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment