[install-guide] Filling out virtio logging section

[Pete Travis]

commit ce2701ccacb2730ce35b78932020889049ae2b71
Author: Pete Travis <immanetize at fedoraproject.org>
Date:   Thu Jan 31 22:58:16 2013 -0700

    Filling out virtio logging section

 en-US/logging-virtio.xml |   86 ++++++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 83 insertions(+), 3 deletions(-)
---
diff --git a/en-US/logging-virtio.xml b/en-US/logging-virtio.xml
index c767000..8d0a4fa 100644
--- a/en-US/logging-virtio.xml
+++ b/en-US/logging-virtio.xml
@@ -6,7 +6,87 @@
 
 <section id="anaconda_logging-virtio">
   <title>
-    Remote logging via virtio
+    Remote logging via <function>virtio</function>
   </title>
-  <para />
-</section>
\ No newline at end of file
+  <para>
+    The <productname>Anaconda</productname> installer can communicate with a <application>KVM</application> host when Fedora is installed as a virtual machine. By configuring the guest to use a <function>virtio char</function> device, logs are forwarded early in the installation and in real time. <productname>Anaconda</productname> will automatically use the port <filename>/dev/virtio-ports/org.fedoraproject.anaconda.log.0</filename> if available.
+  </para>
+  <section id="anaconda_logging-virtio_new">
+    <title>
+      <function>virtio</function> logging with <command>virt-install</command>
+    </title>
+    <para>
+      To create a log channel when creating a virtual machine with <command>virtio</command>, use the <function>--channel</function> option:
+      <screen>
+        <command>
+          --channel tcp,host=127.0.0.1:6080,mode=connect,target_type=virtio,name=org.fedoraproject.anaconda.log.0
+        </command>
+      </screen>
+    </para>
+  </section>
+  <section id="anaconda_logging-virtio_add">
+    <title>
+      Adding a <function>virtio</function> log channel with <command>virsh edit</command>
+    </title>
+    <para>
+      A log channel can be added to an existing virtual machine, such as one created using <application>virt-manager</application>, using the following process:
+    </para>
+    <procedure>
+      <title>
+        Adding a log channel with <command>virsh</command>
+      </title>
+      <step>
+        <para>
+          Identify the virtual machine name:
+          <screen>
+            <command>virsh list --all</command>
+          </screen>
+        </para>
+      </step>
+      <step>
+        <para>
+          Open the guest configuration for editing:
+          <screen>
+            <command>virsh edit <replaceable>new-fedora-guest</replaceable></command>
+          </screen>
+        </para>
+      </step>
+      <step>
+        <para>
+          Add the following information to the <function>&lt;devices&gt;</function> section:
+          <screen>
+<![CDATA[
+<channel type='tcp'>
+  <source mode='connect' host='127.0.0.1' service='6080'/>
+  <target type='virtio' name='org.fedoraproject.anaconda.log.0'/>
+</channel>
+]]>
+          </screen>
+        </para>
+      </step>
+    </procedure>
+  </section>
+  <section id="anaconda_logging-virtio_listening">
+    <title>
+      Listening for <function>virtio</function> logs
+    </title>
+    <para>
+      Start the listening <application>rsyslogd</application> on the host:
+      <screen>
+        <command>
+          eval `analog -p 6080 -o rsyslogd.conf -s <replaceable>/path/to/logdir</replaceable>`
+        </command>
+      </screen>
+      Or, view the raw logs using <application>nc</application>
+      <screen>
+        <command>
+          nc -l 0.0.0.0 6080
+        </command>
+      </screen>
+    </para>
+    <para>
+      <application>rsyslog</application> is also used in this way for <function>tcp</function> logging, but separate <application>rsyslog</application> instances must be used if logging by both methods.
+    </para>
+  </section>
+</section>
+