# 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.

## Installation Ubuntu Natty

Ubuntu Natty 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
    ...

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

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

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

### Fedora 15

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

## Mandriva 2010.1

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

## Installation from Source

Please see the