obs_ag_installation_and_configuration: wordsmithing "Back-end Install…

…ation"

Signed-off-by: Nathan Cutler <[email protected]>

xml/obs_ag_installation_and_configuration.xml

@@ -98,13 +98,7 @@
       Read more about configuring the backend in <xref linkend="_distributed_setup"/>.
     </para>
    </note>
-   <para>The back-end consists of a number of services that are controlled via systemctl.
-    Basically you can enable/disable the service during booting the system and
-    start/stop/restart it in a running system. For more information, see
-    <link xlink:href="https://www.freedesktop.org/software/systemd/man/systemctl.html#Commands">the systemctl man page</link>.
-    For example, to restart the repository server, do:
-   </para>
-   <screen>systemctl restart obsrepserver.service</screen>
+   <para>The back-end consists of a number of systemd units (services):</para>
    <table frame="all" rowsep="1" colsep="1">
     <title>Services</title>
     <?dbhtml table-width="75%"?>
@@ -279,13 +273,25 @@
      </tbody>
     </tgroup>
    </table>
-   <para>At start time, <emphasis>obssrcserver.service</emphasis> (the source
-    server) must be started first, and <emphasis>obsrepservice.service</emphasis>
-    second. The remaining services can be started in any order. When installing
-    manually, you will need to first enable the services with</para>
+    <para>These services are controlled via <emphasis>systemctl</emphasis>.
+    Basically, you can enable/disable a service to start when the system
+    boot, and you can start/stop/restart it in a running system as well.
+    For more information, see
+    <link xlink:href="https://manpages.opensuse.org/Tumbleweed/systemd/systemctl.1.en.html#COMMANDS">the systemctl man page</link>.
+    For example, to restart the repository server, do:
+   </para>
+   <screen>systemctl restart obsrepserver.service</screen>
+   <para>When starting the various services, <emphasis>obssrcserver.service</emphasis>
+    (the source server) must be started first, and <emphasis>obsrepservice.service</emphasis>
+    (the repository server) second, followed by the remaining services in
+    any order. When installing manually, you will need to first enable the
+    services with</para>
    <screen>systemctl enable &lt;name&gt;</screen>
-   <para>so they start automatically at boot (the start order is enforced via
-    the respective systemd unit files) and then you can start them:</para>
+   <para>so they start automatically at boot. In this case, the start order
+    will be enforced via the respective systemd unit files. Should you want to
+    start the services manually, you will need to ensure the correct ordering
+    yourself, by starting the source server first and the repository server
+    second, like so:</para>
    <screen>systemctl start obssrcserver.service
 systemctl start obsrepserver.service
 </screen>