Move troubleshooting sync errors

* Add link to appropriate modules which could cause the need to
  troubleshoot
* Fix chown command based on man page: you split user and group by colon
* Rename file/anchor/title
* Use attributes in favor of Katello server

Fixes #1191

Author: maximiliankolb

guides/common/modules/proc_synchronizing-repositories.adoc

@@ -49,3 +49,6 @@ $ hammer repository synchronize \
 --organization "_My_Organization_" \
 --product "_My_Product_"
 ----
+
+.Additional resources
+* xref:troubleshooting-synchronization-errors[]

guides/common/modules/ref_troubleshooting-sync-errors.adoc renamed to guides/common/modules/ref_troubleshooting-synchronization-errors.adoc

@@ -1,13 +1,13 @@
 :_mod-docs-content-type: REFERENCE
 
-[id="Troubleshooting_Sync_Errors_{context}"]
-= Troubleshooting sync errors
+[id="troubleshooting-synchronization-errors"]
+= Troubleshooting synchronization errors
 
 "[Errno 1] Operation not permitted: ..." during repository syncing::
 
 [options="nowrap" subs="+quotes,attributes"]
 ----
-# chown --recursive pulp.pulp /var/lib/pulp/media/
+# chown --recursive pulp:pulp /var/lib/pulp/media/
 ----
 
 "{"policy":[""" is not a valid choice."]}" during Debian repository syncing::
@@ -19,14 +19,14 @@
 
 500 API error during syncing with "cryptography.fernet.InvalidToken" in /var/log/messages traceback::
 
-Run this on the Katello server and every smart proxy.
+Run this on your {ProjectServer} and all {SmartProxyServers}:
 +
 [options="nowrap" subs="+quotes,attributes"]
 ----
 # sudo -u pulp PULP_SETTINGS='/etc/pulp/settings.py' pulpcore-manager datarepair-2327 --dry-run
 ----
 +
-If you see values greater than 0 returned from the dry-run:
+If you see values greater than 0, repair the content:
 +
 [options="nowrap" subs="+quotes,attributes"]
 ----

guides/doc-Installing_Server/master.adoc

@@ -67,11 +67,6 @@ endif::[]
 
 :numbered!:
 
-ifdef::katello[]
-[appendix]
-include::common/modules/ref_troubleshooting-sync-errors.adoc[leveloffset+=1]
-endif::[]
-
 [appendix]
 include::common/modules/proc_restoring-manual-changes-overwritten-by-a-puppet-run.adoc[leveloffset=+1]
 

guides/doc-Managing_Content/master.adoc

@@ -77,6 +77,11 @@ endif::[]
 [appendix]
 include::common/modules/ref_required-red-hat-repositories.adoc[leveloffset=+1]
 
+ifdef::katello[]
+[appendix]
+include::common/modules/ref_troubleshooting-synchronization-errors.adoc[leveloffset+=1]
+endif::[]
+
 [appendix]
 include::common/modules/proc_using-an-nfs-share-for-content-storage.adoc[leveloffset=+1]
 endif::[]