Commit a1f06dd9 authored by Mike Russo's avatar Mike Russo

Fix Vale issues in ./administration/geo/replication/troubleshooting.md

parent e4d3923c
...@@ -320,7 +320,7 @@ sudo gitlab-ctl \ ...@@ -320,7 +320,7 @@ sudo gitlab-ctl \
--backup-timeout=21600 --backup-timeout=21600
``` ```
This will give the initial replication up to six hours to complete, rather than This gives the initial replication up to six hours to complete, rather than
the default thirty minutes. Adjust as required for your installation. the default thirty minutes. Adjust as required for your installation.
### Message: "PANIC: could not write to file `pg_xlog/xlogtemp.123`: No space left on device" ### Message: "PANIC: could not write to file `pg_xlog/xlogtemp.123`: No space left on device"
...@@ -335,7 +335,7 @@ log data to build up in `pg_xlog`. Removing the unused slots can reduce the amou ...@@ -335,7 +335,7 @@ log data to build up in `pg_xlog`. Removing the unused slots can reduce the amou
``` ```
NOTE: NOTE:
Using `gitlab-rails dbconsole` will not work, because managing replication slots requires superuser permissions. Using `gitlab-rails dbconsole` does not work, because managing replication slots requires superuser permissions.
1. View your replication slots with: 1. View your replication slots with:
...@@ -358,13 +358,12 @@ Slots where `active` is `f` are not active. ...@@ -358,13 +358,12 @@ Slots where `active` is `f` are not active.
### Message: "ERROR: canceling statement due to conflict with recovery" ### Message: "ERROR: canceling statement due to conflict with recovery"
This error may rarely occur under normal usage, and the system is resilient This error occurs infrequently under normal usage, and the system is resilient
enough to recover. enough to recover.
However, under certain conditions, some database queries on secondaries may run However, under certain conditions, some database queries on secondaries may run
excessively long, which increases the frequency of this error. At some point, excessively long, which increases the frequency of this error. This can lead to a situation
some of these queries will never be able to complete due to being canceled where some queries never complete due to being canceled on every replication.
every time.
These long-running queries are These long-running queries are
[planned to be removed in the future](https://gitlab.com/gitlab-org/gitlab/-/issues/34269), [planned to be removed in the future](https://gitlab.com/gitlab-org/gitlab/-/issues/34269),
...@@ -505,7 +504,7 @@ Then reconfigure GitLab: ...@@ -505,7 +504,7 @@ Then reconfigure GitLab:
sudo gitlab-ctl reconfigure sudo gitlab-ctl reconfigure
``` ```
This will increase the timeout to four hours (14400 seconds). Choose a time This increases the timeout to four hours (14400 seconds). Choose a time
long enough to accommodate a full clone of your largest repositories. long enough to accommodate a full clone of your largest repositories.
### New LFS objects are never replicated ### New LFS objects are never replicated
...@@ -564,9 +563,8 @@ to start again from scratch, there are a few steps that can help you: ...@@ -564,9 +563,8 @@ to start again from scratch, there are a few steps that can help you:
1. _(Optional)_ Rename other data folders and create new ones 1. _(Optional)_ Rename other data folders and create new ones
WARNING: WARNING:
You may still have files on the **secondary** node that have been removed from **primary** node but You may still have files on the **secondary** node that have been removed from the **primary** node, but this
removal have not been reflected. If you skip this step, they will never be removed removal has not been reflected. If you skip this step, these files are not removed at all from the Geo node.
from this Geo node.
Any uploaded content like file attachments, avatars or LFS objects are stored in a Any uploaded content like file attachments, avatars or LFS objects are stored in a
subfolder in one of the two paths below: subfolder in one of the two paths below:
...@@ -661,12 +659,12 @@ Counts: ...@@ -661,12 +659,12 @@ Counts:
#### If you are promoting a Geo secondary site running on a single server #### If you are promoting a Geo secondary site running on a single server
`gitlab-ctl promotion-preflight-checks` will fail due to the existence of `gitlab-ctl promotion-preflight-checks` fails due to the existence of
`failed` rows in the `geo_design_registry` table. Use the `failed` rows in the `geo_design_registry` table. Use the
[previous snippet](#design-repository-failures-on-mirrored-projects-and-project-imports) to [previous snippet](#design-repository-failures-on-mirrored-projects-and-project-imports) to
determine the actual replication status of Design repositories. determine the actual replication status of Design repositories.
`gitlab-ctl promote-to-primary-node` will fail since it runs preflight checks. `gitlab-ctl promote-to-primary-node` fails since it runs preflight checks.
If the [previous snippet](#design-repository-failures-on-mirrored-projects-and-project-imports) If the [previous snippet](#design-repository-failures-on-mirrored-projects-and-project-imports)
shows that all designs are synced, then you can use the shows that all designs are synced, then you can use the
`--skip-preflight-checks` option or the `--force` option to move forward with `--skip-preflight-checks` option or the `--force` option to move forward with
...@@ -674,7 +672,7 @@ promotion. ...@@ -674,7 +672,7 @@ promotion.
#### If you are promoting a Geo secondary site running on multiple servers #### If you are promoting a Geo secondary site running on multiple servers
`gitlab-ctl promotion-preflight-checks` will fail due to the existence of `gitlab-ctl promotion-preflight-checks` fails due to the existence of
`failed` rows in the `geo_design_registry` table. Use the `failed` rows in the `geo_design_registry` table. Use the
[previous snippet](#design-repository-failures-on-mirrored-projects-and-project-imports) to [previous snippet](#design-repository-failures-on-mirrored-projects-and-project-imports) to
determine the actual replication status of Design repositories. determine the actual replication status of Design repositories.
...@@ -766,7 +764,7 @@ When ...@@ -766,7 +764,7 @@ When
you need to run the `gitlab-pg-ctl` command to promote the PostgreSQL you need to run the `gitlab-pg-ctl` command to promote the PostgreSQL
read-replica database. read-replica database.
In GitLab 12.8 and earlier, this command will fail with the message: In GitLab 12.8 and earlier, this command fails with the message:
```plaintext ```plaintext
sudo: gitlab-pg-ctl: command not found sudo: gitlab-pg-ctl: command not found
...@@ -825,7 +823,7 @@ If you notice for some reason there are more artifacts on the Geo ...@@ -825,7 +823,7 @@ If you notice for some reason there are more artifacts on the Geo
secondary node than on the Geo primary node, you can use the Rake task secondary node than on the Geo primary node, you can use the Rake task
to [cleanup orphan artifact files](../../../raketasks/cleanup.md#remove-orphan-artifact-files). to [cleanup orphan artifact files](../../../raketasks/cleanup.md#remove-orphan-artifact-files).
On a Geo **secondary** node, this command will also clean up all Geo On a Geo **secondary** node, this command also cleans up all Geo
registry record related to the orphan files on disk. registry record related to the orphan files on disk.
## Fixing sign in errors ## Fixing sign in errors
......
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