Modularize administering foreman guide (theforeman#945)

Author: maximiliankolb

guides/common/assembly_migrating-from-internal-databases-to-external-databases.adoc

@@ -1,37 +1,6 @@
 ifdef::context[:parent-context: {context}]
 
-[id="migrating-from-internal-databases-to-external-databases_{context}"]
-= Migrating from Internal {Project} Databases to External Databases
-
-ifdef::foreman-el,katello[]
-For Red Hat systems only.
-endif::[]
-
-When you install {ProjectName}, the *{foreman-installer}* command installs PostgreSQL databases on the same server as {Project}.
-If you are using the default internal databases but want to start using external databases to help with the server load, you can migrate your internal databases to external databases.
-
-To confirm whether your {ProjectServer} has internal or external databases, you can query the status of your databases:
-
-For PostgreSQL, enter the following command:
-[options="nowrap" subs="+quotes,attributes"]
-----
-# {foreman-maintain} service status --only postgresql
-----
-
-ifdef::satellite[]
-Red Hat does not provide support or tools for external database maintenance.
-This includes backups, upgrades, and database tuning.
-You must have your own database administrator to support and maintain external databases.
-endif::[]
-
-To migrate from the default internal databases to external databases, you must complete the following procedures:
-
-. xref:preparing-a-host-for-external-databases_{context}[].
-Prepare a {RHEL} 7 server to host the external databases.
-. xref:installing-postgresql_{context}[].
-Prepare PostgreSQL with databases for {Project}, Pulp and Candlepin with dedicated users owning them.
-. xref:migrating-to-external-databases_{context}[].
-Edit the parameters of `{foreman-installer}` to point to the new databases, and run `{foreman-installer}`.
+include::modules/con_migrating-from-internal-databases-to-external-databases.adoc[]
 
 include::modules/con_postgresql-as-an-external-database-considerations.adoc[leveloffset=+1]
 

guides/common/modules/con_migrating-from-internal-databases-to-external-databases.adoc

@@ -0,0 +1,32 @@
+[id="Migrating_from_Internal_Databases_to_External_Databases_{context}"]
+= Migrating from Internal {Project} Databases to External Databases
+
+ifdef::foreman-el,katello[]
+For Red Hat systems only.
+endif::[]
+
+When you install {ProjectName}, the *{foreman-installer}* command installs PostgreSQL databases on the same server as {Project}.
+If you are using the default internal databases but want to start using external databases to help with the server load, you can migrate your internal databases to external databases.
+
+To confirm whether your {ProjectServer} has internal or external databases, you can query the status of your databases:
+
+For PostgreSQL, enter the following command:
+[options="nowrap" subs="+quotes,attributes"]
+----
+# {foreman-maintain} service status --only postgresql
+----
+
+ifdef::satellite[]
+Red Hat does not provide support or tools for external database maintenance.
+This includes backups, upgrades, and database tuning.
+You must have your own database administrator to support and maintain external databases.
+endif::[]
+
+To migrate from the default internal databases to external databases, you must complete the following procedures:
+
+. xref:preparing-a-host-for-external-databases_{context}[].
+Prepare a {RHEL} 7 server to host the external databases.
+. xref:installing-postgresql_{context}[].
+Prepare PostgreSQL with databases for {Project}, Pulp and Candlepin with dedicated users owning them.
+. xref:migrating-to-external-databases_{context}[].
+Edit the parameters of `{foreman-installer}` to point to the new databases, and run `{foreman-installer}`.