Review koji-builder-setup SOP

Signed-off-by: Michal Konečný <mkonecny@redhat.com>

modules/sysadmin_guide/nav.adoc

@@ -60,7 +60,7 @@
 ** xref:kickstarts.adoc[Kickstart Infrastructure - SOP]
 ** xref:koji.adoc[Koji Infrastructure - SOP]
 ** xref:koji-archive.adoc[Koji Archive - SOP]
-** xref:koji-builder-setup.adoc[koji-builder-setup - SOP in review ]
+** xref:koji-builder-setup.adoc[Setup Koji Builder - SOP]
 ** xref:koschei.adoc[koschei - SOP in review ]
 ** xref:layered-image-buildsys.adoc[layered-image-buildsys - SOP in review ]
 ** xref:librariesio2fedmsg.adoc[librariesio2fedmsg - SOP in review ]

modules/sysadmin_guide/pages/koji-builder-setup.adoc

@@ -2,8 +2,10 @@
 
 == Contents
 
-* Setting up a new koji builder
-* Resetting/installing an old koji builder
+* <<_builder_setup>>
+** <<_network_overview>>
+** <<_setup_overview>>
+** <<_resettinginstalling_an_old_koji_builder>>
 
 == Builder Setup
 
@@ -13,17 +15,16 @@ Setting up a new koji builder involves a goodly number of steps:
 
 [arabic]
 . First get an instance spun up following the kickstart sop.
-. {blank}
-+
-Define a hostname for it on the 125 network and a $hostname-nfs name::
-  for it on the .127 network.
+. Define a hostname for it on the 125 network and a $hostname-nfs name
+for it on the .127 network.
 . make sure the instance has 2 network connections:
 * eth0 should be on the .125 network
 * eth1 should be on the .127 network
 +
-____
-For VM eth0 should be on br0, eth1 on br1 on the vmhost.
-____
+[NOTE]
+=====
+For VM _eth0_ should be on _br0_, _eth1_ on _br1_ on the vmhost.
+=====
 
 === Setup Overview
 
@@ -45,7 +46,7 @@ virt-install -n $builder_fqdn -r $memsize \
 * disable selinux on the machine in /etc/sysconfig/selinux
 * reboot
 * setup ssl cert into private/builders - use fqdn of host as DN
-** login to fas01 as root
+** login to _fas01_ as root
 ** `cd /var/lib/fedora-ca`
 ** `./kojicerthelper.py normal --outdir=/tmp/  \ --name=$fqdn_of_the_new_builder  --cadir=. --caname=Fedora`
 ** info for the cert should be like this:
@@ -59,7 +60,7 @@ Organizational Unit Name (eg, section) []:Fedora Builders
 Common Name (eg, your name or your servers hostname) []:$fqdn_of_new_builder
 Email Address []:buildsys@fedoraproject.org
 ....
-** scp the file in `/tmp/$\{fqdn}_key_and_cert.pem` over to batcave01
+** scp the file in `/tmp/$\{fqdn}_key_and_cert.pem` over to _batcave01_
 ** put file in the private repo under `private/builders/$dn}.pem`
 ** `git add` + `git commit`
 ** `git push`
@@ -75,7 +76,7 @@ koji add-host $fqdnr i386 x86_64
 === Resetting/installing an old koji builder
 
 * disable the builder in koji (ask a koji admin)
-* halt the old system (halt -p)
+* halt the old system (`halt -p`)
 * undefine the vm instance on the buildvmhost:
 +
 ....
@@ -111,8 +112,8 @@ virsh autostart $builder_fqdn
 ....
 * when the guest comes up
 ** login via ssh using the temp root password
-** python /root/tmp/setup-nfs-network.py
+** python `/root/tmp/setup-nfs-network.py`
 ** change root password
-** disable selinux in /etc/sysconfig/selinux
-** reboot
+** disable selinux in `/etc/sysconfig/selinux`
+** `reboot`
 ** ask a koji admin to re-enable the host