From ebbc9bef4f0facbd3eb759c739e17e6105df20fe Mon Sep 17 00:00:00 2001
From: Holger Hans Peter Freyther <zecke@selfish.org>
Date: Tue, 19 Jul 2011 23:19:32 +0200
Subject: [PATCH] usermanual: Start writing some bits about the installation

---
 docs/chapters/installation.xml | 62 ++++++++++++++++++++++++++++++++++
 docs/usermanual.xml            |  2 ++
 2 files changed, 64 insertions(+)
 create mode 100644 docs/chapters/installation.xml

diff --git a/docs/chapters/installation.xml b/docs/chapters/installation.xml
new file mode 100644
index 0000000..fd659ce
--- /dev/null
+++ b/docs/chapters/installation.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="chapter_installation">
+    <title>Installation</title>
+    <para><application>SIMtrace</application> will need a patched version of
+    <application>wireshark</application> and the <command>simtrace</command>
+    host utility to fully operate. The installation might be possible from
+    binary packages or will require building from source.</para>
+
+    <section id="install_ubuntu_natty">
+        <title>Installation Ubuntu Natty</title>
+        <para>Ubuntu Natty users can use the holger+lp/osmocom PPA to install
+<application>SIMtrace</application> and upgrade wireshark. The PPA needs to
+        be added to the system, the package database needs to be refreshed
+        and the applications can be installed afterwards.</para>
+
+        <screen>
+$ <command>sudo</command> <command>add-apt-repository</command> ppa:holger+lp/osmocom
+[sudo] password for username:
+Executing: gpg --ignore-time-conflict --no-options --no-default-keyring --secret-keyring /etc/apt/secring.gpg --trustdb-name /etc/apt/trustdb.gpg --keyring /etc/apt/trusted.gpg --primary-keyring /etc/apt/trusted.gpg --keyserver hkp://keyserver.ubuntu.com:80/ --recv 84C86214C00BAF820F43585CCABF944FA2AD19FA
+gpg: requesting key A2AD19FA from hkp server keyserver.ubuntu.com
+gpg: Total number processed: 1
+gpg:              unchanged: 1
+        </screen>
+
+        <para>The next step is to update the package database and install or upgrade
+        the <application>wireshark</application> application.</para>
+
+        <screen>
+$ <command>sudo</command> <command>apt-get</command> update
+...
+$ <command>sudo</command> <command>apt-get</command> install wireshark simtrace
+...
+        </screen>
+    </section>
+
+    <section id="install_opensuse">
+        <title>Installation OpenSUSE</title>
+        <para>The installation on OpenSUSE uses zypper. The repository must be added
+        via the <command>zypper</command> application and then the binary packages
+        can be installed.</para>
+
+        <screen>
+$ <command>sudo</command> <command>zypper</command> ar http://download.opensuse.org/repositories/home:/zecke23/openSUSE_11.3/home:zecke23.repo
+$ <command>sudo</command> <command>zypper</command> install wireshark simtrace
+        </screen>
+    </section>
+
+    <section id="install_fedora">
+        <title>Installation Fedora</title>
+        <para></para>
+    </section>
+
+    <section id="install_centos">
+        <title>Installation CentOS</title>
+        <para></para>
+    </section>
+
+    <section id="installation_from_source">
+        <title>Installation from Source</title>
+        <para></para>
+    </section>
+</chapter>
diff --git a/docs/usermanual.xml b/docs/usermanual.xml
index 8ff39ad..1bc811a 100644
--- a/docs/usermanual.xml
+++ b/docs/usermanual.xml
@@ -6,6 +6,7 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
 <!ENTITY chapter-introduction SYSTEM "chapters/introduction.xml">
+<!ENTITY chapter-installation SYSTEM "chapters/installation.xml">
 <!ENTITY chapter-using SYSTEM "chapters/using.xml">
 <!ENTITY chapter-building SYSTEM "chapters/building.xml">
 <!ENTITY chapter-appendix SYSTEM "chapters/appendix.xml">
@@ -39,6 +40,7 @@
 
   <!-- Main chapters-->
   &chapter-introduction;
+  &chapter-installation;
   &chapter-using;
   &chapter-building;