# Installation

SIMtrace will need a patched version of wireshark and the `simtrace` 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.

## Wireshark Patches

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.

## Installation Ubuntu Natty, Ubuntu Oneiric

Ubuntu Natty and Oneiric users can use the holger+lp/osmocom PPA to install SIMtrace 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.

    $ sudo add-apt-repository 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

The next step is to update the package database and install or upgrade the wireshark application.

    $ sudo apt-get update
    ...
    $ sudo apt-get install wireshark simtrace
    ...

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.

## Installation OpenSUSE

The installation on OpenSUSE uses zypper. The repository must be added via the `zypper` application and then the binary packages can be installed.

### openSUSE 11.3

    $ zypper addrepo http://download.opensuse.org/repositories/home:/zecke23/openSUSE_11.3/home:zecke23.repo
    $ zypper refresh
    $ zypper install wireshark simtrace

### openSUSE 11.4

    $ zypper addrepo http://download.opensuse.org/repositories/home:/zecke23/openSUSE_11.4/home:zecke23.repo
    $ zypper refresh
    $ zypper install wireshark simtrace

### openSUSE 12.1

    $ zypper addrepo http://download.opensuse.org/repositories/home:/zecke23/openSUSE_11.4/home:zecke23.repo
    $ zypper refresh
    $ zypper install wireshark simtrace

## Installation Fedora

### Fedora 14

    $ cd /etc/yum/repos.d/
    $ wget http://download.opensuse.org/repositories/home:zecke23/Fedora_14/home:zecke23.repo
    $ yum install wireshark simtrace

### Fedora 15

    $ cd /etc/yum/repos.d/
    $ wget http://download.opensuse.org/repositories/home:zecke23/Fedora_15/home:zecke23.repo
    $ yum install wireshark simtrace

### Fedora 16

    $ cd /etc/yum/repos.d/
    $ wget http://download.opensuse.org/repositories/home:zecke23/Fedora_16/home:zecke23.repo
    $ yum install wireshark simtrace

## Installation CentOS

### CentOS 5

    $ cd /etc/yum/repos.d/
    $ wget http://download.opensuse.org/repositories/home:zecke23/CentOS_CentOS-5/home:zecke23.repo
    $ yum install wireshark simtrace

### CentOS 6

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

## Mandriva

### Mandriva 2010.1

    $ urpmi.addmedia home:zecke23 http://download.opensuse.org/repositories/home:zecke23/Mandriva_2010.1/
    $ urpmi.update -a
    $ urpmi wireshark simtrace

### Mandriva 2011

    $ urpmi.addmedia home:zecke23 http://download.opensuse.org/repositories/home:zecke23/Mandriva_2011/
    $ urpmi.update -a
    $ urpmi wireshark simtrace

## Installation from Source

Please see the