<?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. The following
    sections provide some hints how to achieve this on the various Linux
    distributions. All these operations must be executed as root.</para>


    <note>
      <title>Wireshark Patches</title>
      <para>The SIMtrace patch has been upstreamed. Wireshark 1.7.1 was released
      on April the 6th 2012 and is the first development release to support SIMtrace
      out of the box. Wireshark 1.8 will be the first stable version.
      </para>
    </note>

    <section id="install_ubuntu_natty">
        <title>Installation Ubuntu Natty, Ubuntu Oneiric</title>
        <para>Ubuntu Natty and Oneiric 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>

        <note><para>The wireshark will only be installed if it is newer than the version
        provided by Ubuntu. Please verify that the above command installed a version
        coming from the PPA.</para>
        </note>

    </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>

        <section>
            <title>openSUSE 11.3</title>
            <screen>
$ <command>zypper</command> addrepo http://download.opensuse.org/repositories/home:/zecke23/openSUSE_11.3/home:zecke23.repo
$ <command>zypper</command> refresh
$ <command>zypper</command> install wireshark simtrace
            </screen>
        </section>

        <section>
            <title>openSUSE 11.4</title>
            <screen>
$ <command>zypper</command> addrepo http://download.opensuse.org/repositories/home:/zecke23/openSUSE_11.4/home:zecke23.repo
$ <command>zypper</command> refresh
$ <command>zypper</command> install wireshark simtrace
            </screen>
        </section>
        <section>
            <title>openSUSE 12.1</title>
            <screen>
$ <command>zypper</command> addrepo http://download.opensuse.org/repositories/home:/zecke23/openSUSE_11.4/home:zecke23.repo
$ <command>zypper</command> refresh
$ <command>zypper</command> install wireshark simtrace
            </screen>
        </section>
    </section>

    <section id="install_fedora">
        <title>Installation Fedora</title>
        <section>
            <title>Fedora 14</title>
            <screen>
$ cd /etc/yum/repos.d/
$ wget http://download.opensuse.org/repositories/home:zecke23/Fedora_14/home:zecke23.repo
$ yum install wireshark simtrace
            </screen>
        </section>

        <section>
            <title>Fedora 15</title>
            <screen>
$ cd /etc/yum/repos.d/
$ wget http://download.opensuse.org/repositories/home:zecke23/Fedora_15/home:zecke23.repo
$ yum install wireshark simtrace
            </screen>
        </section>

        <section>
            <title>Fedora 16</title>
            <screen>
$ cd /etc/yum/repos.d/
$ wget http://download.opensuse.org/repositories/home:zecke23/Fedora_16/home:zecke23.repo
$ yum install wireshark simtrace
            </screen>
        </section>

    </section>

    <section id="install_centos">
        <title>Installation CentOS</title>
        <section>
            <title>CentOS 5</title>
            <screen>
$ cd /etc/yum/repos.d/
$ wget http://download.opensuse.org/repositories/home:zecke23/CentOS_CentOS-5/home:zecke23.repo
$ yum install wireshark simtrace
            </screen>
        </section>

        <section>
            <title>CentOS 6</title>
            <screen>
$ cd /etc/yum/repos.d/
$ wget http://download.opensuse.org/repositories/home:zecke23/CentOS_CentOS-6/home:zecke23.repo
$ yum install wireshark simtrace
            </screen>
        </section>
    </section>

    <section id="install_mandriva">
        <title>Mandriva</title>

        <section>
            <title>Mandriva 2010.1</title>
            <screen>
$ urpmi.addmedia home:zecke23 http://download.opensuse.org/repositories/home:zecke23/Mandriva_2010.1/
$ urpmi.update -a
$ urpmi wireshark simtrace
            </screen>
        </section>

        <section>
            <title>Mandriva 2011</title>
            <screen>
$ urpmi.addmedia home:zecke23 http://download.opensuse.org/repositories/home:zecke23/Mandriva_2011/
$ urpmi.update -a
$ urpmi wireshark simtrace
            </screen>
        </section>
    </section>

    <section id="installation_from_source">
        <title>Installation from Source</title>
        <para>Please see the <xref linkend="chapter_building"/></para>
    </section>
</chapter>
