Move Gitaly and Gitaly Cluster troubleshooting to separate page

doc/administration/gitaly/faq.md

@@ -7,7 +7,8 @@ type: reference
 
 # Frequently asked questions **(FREE SELF)**
 
-The following are answers to frequently asked questions about Gitaly and Gitaly Cluster.
+The following are answers to frequently asked questions about Gitaly and Gitaly Cluster. For
+troubleshooting information, see [Troubleshooting Gitaly and Gitaly Cluster](troubleshooting.md).
 
 ## How does Gitaly Cluster compare to Geo?
 
@@ -87,4 +88,4 @@ There are no special requirements. Gitaly Cluster requires PostgreSQL version 11
 These tables are created per the [specific configuration section](praefect.md#postgresql).
 
 If you find you have an empty Praefect database table, see the
-[relevant troubleshooting section](index.md#relation-does-not-exist-errors).
+[relevant troubleshooting section](troubleshooting.md#relation-does-not-exist-errors).

doc/administration/gitaly/praefect.md

@@ -170,7 +170,7 @@ node, using `psql` which is installed by Omnibus GitLab.
 The database used by Praefect is now configured.
 
 If you see Praefect database errors after configuring PostgreSQL, see
-[troubleshooting steps](index.md#relation-does-not-exist-errors).
+[troubleshooting steps](troubleshooting.md#relation-does-not-exist-errors).
 
 #### PgBouncer
 
@@ -1212,7 +1212,7 @@ To migrate existing clusters:
 
    - If downtime is unacceptable:
 
-      1. Determine which Gitaly node is [the current primary](index.md#determine-primary-gitaly-node).
+      1. Determine which Gitaly node is [the current primary](troubleshooting.md#determine-primary-gitaly-node).
 
       1. Comment out the secondary Gitaly nodes from the virtual storage's configuration in `/etc/gitlab/gitlab.rb`
       on all Praefect nodes. This ensures there's only one Gitaly node configured, causing both of the election

doc/administration/reference_architectures/troubleshooting.md

@@ -207,7 +207,7 @@ To make sure your configuration is correct:
 ## Troubleshooting Gitaly
 
 For troubleshooting information, see Gitaly and Gitaly Cluster
-[troubleshooting information](../gitaly/index.md).
+[troubleshooting information](../gitaly/troubleshooting.md).
 
 ## Troubleshooting the GitLab Rails application