SeisComP3 is distributed in the form of tar files:
Download these from http://www.seiscomp3.org/ . This section describes the installation of the binary packages of SeisComP3 on an openSUSE 11.1 64 bit system with KDE desktop profile.
The hardware requirements for a seismic system depend on the size of the station network to be operated.
Minimal requirements are:
| CPU | 1 |
| RAM | 2 GB |
| HDD | 20 GB |
| OS | SUSE 10.2/3 32/64bit, SUSE 11 32/64bit, (K)Ubuntu 7/8 32/64bit, Debian 5.0, CentOS 5.3 |
In case large networks (>100 stations) are operated, a distributed system is recommended. Normally a SeisComP3 system is separated in several subsystems. A separation of data acquisition, processing and graphical user interfaces is useful to permit stable performance.
The minimum specifications of the system should be:
Data acquisition system:
| CPU | 1 |
| RAM | 2 GB |
| HDD | Raid1/5/0+1 with >= 200GB |
Processing system:
| CPU | 2 |
| RAM | 4 GB |
| HDD | Raid1/5/0+1 with >= 100GB |
GUI system:
| CPU | 2 |
| RAM | 4 GB |
| HDD | > 50 GB |
The next steps describe the installation of SeisComP3 with the prepared tar.gz files.
Log in as user (e.g. sysop)
Copy one of the seiscomp3-seattle-[version]-[OS]-[arch].tar.gz files to your home directory. Take care which is the right package (32 or 64-bit) for your operating system.
Go to home directory
user@host:/tmp$ cd
Untar the SeisComP3 binary package
user@host:~$ tar xzf seiscomp3-seattle-[version]-[OS]-[arch].tar.gz
Untar the SeisComP3 map package into seiscomp3/share/maps
user@host:~$ tar xzf seiscomp3-maps.tar.gz
If desired, untar the documentation into seiscomp3/share/doc
user@host:~$ tar xzf seiscomp3-seattle-[version]-doc.tar.gz
Now everything is installed and the system can be configured. The next chapter chapter explains the first steps.
SeisComP3 depends on a number of additional packages shipped with each Linux distribution. The following table gives an overview:
| Package | SC3 component |
|---|---|
| flex | Seedlink (compilation only) |
| libxml2 | Seedlink, Arclink, trunk |
| libboost | trunk |
| libboost-dev | trunk (compilation only) |
| libncurses | trunk:scm (optional) |
| libncurses-dev | trunk:scm (compilation only, optional) |
| libmysqlclient | trunk (only if MYSQL is used) |
| libmysqlclient-dev | trunk (compilation only if enabled) |
| mysql-server | trunk (only if MYSQL is used locally) |
| libpq5 | trunk (only if PostgreSQL is used) |
| libpq-dev | trunk (compilation only if enabled) |
| libqt4 | trunk (only GUI should be used) |
| python-dev | trunk (compilation only) |
| festival | trunk (optional voice alert) |
First the environment has to be set up. The seiscomp tool comes with the command install-deps which installs required packages. To use MYSQL, give 'mysql-server' as parameter. If your distribution is not supported by install-deps, install the above packages or contact us to add support for your distribution.
user@host:~$ seiscomp3/bin/seiscomp install-deps base mysql-server
Distribution: Ubuntu 10.04
[sudo] password for sysop:
Reading package lists... Done
Building dependency tree
Reading state information... Done
...
For better performance with a MYSQL database, adjust the following parameters:
The location of the configuration can differ between distributions. For OpenSUSE it is in /etc/my.cnf whereas Ubuntu uses /etc/mysql/my.cnf respectively /etc/mysql/conf.d/*. Please read the documentation of your distribution .
After adjusting the parameters, MYSQL needs to be restarted. If you are running OpenSUSE you can run
$ sudo rcmysql restart
whereas Ubuntu requires
$ sudo restart mysql
To start MySQL automatically during boot set in OpenSUSE
user@host:~$ insserv mysql
The directory structure of the installed system is described with the following table.
| Directory | Description |
|---|---|
| bin | The user module binaries. |
| lib | The base library directory used by all modules. |
| lib/python | The pyton library directory. |
| man | The manual pages. |
| sbin | The system/service/server binaries such as seedlink. |
| var | Variable files whose content is expected to continually change. |
| var/log | Log files of started modules. Usually modules log either to syslog or ~/.seiscomp3/log. This directory contains the logs of the start of each module. |
| var/lib | Default directory for files created by modules such as the waveform ringbuffer of SeedLink or the waveform archive created by slarchive. |
| var/run | Contains the .run and .pid files of modules started by seiscomp. |
| include | SDK header files for all libraries. |
| share | Application data such as maps, cities.xml and others. |
| share/templates | Template files used by eg SeedLink to create its native configuration. |
| etc | Configuration directory. |
| etc/descriptions | Contains all XML module descriptions. |
| etc/defaults | The default configuration files. This directory is read as first when a module starts. |
| etc/init | Module init scripts called by seiscomp. |
| etc/key | Station configurations and module bindings. |