|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html >
|
|
|
<head>
|
|
|
<meta charset="utf-8" />
|
|
|
<title>SeisComP Installation — SeisComP Release documentation</title>
|
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
|
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
|
|
|
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
|
|
|
<script type="text/javascript" src="../_static/seiscomp.js"></script>
|
|
|
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
|
|
<script src="../_static/jquery.js"></script>
|
|
|
<script src="../_static/underscore.js"></script>
|
|
|
<script src="../_static/doctools.js"></script>
|
|
|
<script src="../_static/language_data.js"></script>
|
|
|
<link rel="shortcut icon" href="../_static/favicon.ico"/>
|
|
|
<link rel="index" title="Index" href="../genindex.html" />
|
|
|
<link rel="search" title="Search" href="../search.html" />
|
|
|
<link rel="next" title="Getting Started with SeisComP" href="getting-started.html" />
|
|
|
<link rel="prev" title="Change Log" href="changelog.html" />
|
|
|
</head>
|
|
|
<body>
|
|
|
<div class="header">
|
|
|
<div class="container">
|
|
|
<div class="brand">
|
|
|
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
|
|
|
<!-- span class="title">SeisComP Release</span -->
|
|
|
<span class="version">5.3.0</span>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="nav">
|
|
|
<div class="container">
|
|
|
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
|
|
|
|
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
|
|
<ul>
|
|
|
<li class="right">
|
|
|
<a href="../genindex.html" title="General Index"
|
|
|
accesskey="I">
|
|
|
index
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="getting-started.html" title="Getting Started with SeisComP"
|
|
|
accesskey="N">
|
|
|
next
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="changelog.html" title="Change Log"
|
|
|
accesskey="P">
|
|
|
previous
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="nav-item nav-item-0">
|
|
|
<a href="../index.html">Home</a>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="container">
|
|
|
<div class="fitted content" id="anchors-container">
|
|
|
<div class="body" role="main">
|
|
|
|
|
|
<div class="section" id="scname-installation">
|
|
|
<span id="installation"></span><h1><cite>SeisComP</cite> Installation<a class="headerlink" href="#scname-installation" title="Permalink to this headline">¶</a></h1>
|
|
|
<p><cite>SeisComP</cite> requires a modern Linux operating system as it is developed and tested
|
|
|
only under Linux. For production systems we recommend Linux distributions with
|
|
|
long-term support (LTS). The Linux flavors under which <cite>SeisComP</cite> has been tested
|
|
|
are given along with the <cite>SeisComP</cite> package names on the download sites of
|
|
|
<span id="id1">Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH [<a class="reference internal" href="references.html#id243" title="Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH. The SeisComP seismological software package. GFZ Data Services. 2008. URL: https://www.seiscomp.de, doi:10.5880/GFZ.2.4.2020.003.">61</a>]</span> and <span id="id2"><em>gempa GmbH</em> [<a class="reference internal" href="references.html#id113" title="gempa GmbH. The SeisComP development and maintenance company. URL: https://www.gempa.de/.">26</a>]</span>.</p>
|
|
|
<p>The software can be obtained and installed from</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>Officially released packages (TAR files) for different release versions,
|
|
|
Linux systems and architectures,</p></li>
|
|
|
<li><p><a class="reference internal" href="build.html#build"><span class="std std-ref">Source code available on GitHub</span></a>.</p></li>
|
|
|
</ul>
|
|
|
<p>Packages may include</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>Software for data acquisition, processing and <a class="reference internal" href="glossary.html#term-gui"><span class="xref std std-term">GUIs</span></a> for each
|
|
|
supported platform,</p></li>
|
|
|
<li><p>Maps. Maps from the <cite>SeisComP</cite> releases Seattle and Zurich also work
|
|
|
in later releases</p></li>
|
|
|
<li><p>Documentation,</p></li>
|
|
|
<li><p>Station configuration files (optional).</p></li>
|
|
|
</ul>
|
|
|
<p>Download these packages from <span id="id3">Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH [<a class="reference internal" href="references.html#id243" title="Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH. The SeisComP seismological software package. GFZ Data Services. 2008. URL: https://www.seiscomp.de, doi:10.5880/GFZ.2.4.2020.003.">61</a>]</span> or <span id="id4"><em>Public download site of gempa</em> [<a class="reference internal" href="references.html#id115" title="Public download site of gempa. URL: https://data.gempa.de/packages/Public/seiscomp/.">19</a>]</span>.</p>
|
|
|
<p>The next sections describe the installation of the binary packages of <cite>SeisComP</cite>
|
|
|
on</p>
|
|
|
<ul class="simple">
|
|
|
<li><p><strong class="program">Ubuntu 18</strong>, 64 bit system,</p></li>
|
|
|
<li><p><strong class="program">CentOS 7</strong>, 64 bit system.</p></li>
|
|
|
</ul>
|
|
|
<div class="section" id="hardware-requirements">
|
|
|
<h2>Hardware Requirements<a class="headerlink" href="#hardware-requirements" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>The hardware requirements for a seismic system depend on the size of the
|
|
|
station network to be operated.</p>
|
|
|
<p>Minimum requirements are:</p>
|
|
|
<table class="colwidths-given docutils align-left">
|
|
|
<colgroup>
|
|
|
<col style="width: 10%" />
|
|
|
<col style="width: 90%" />
|
|
|
</colgroup>
|
|
|
<tbody>
|
|
|
<tr class="row-odd"><td><p>CPU</p></td>
|
|
|
<td><p>2</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>RAM</p></td>
|
|
|
<td><p>4 GB</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>HDD</p></td>
|
|
|
<td><p>20 GB</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>OS</p></td>
|
|
|
<td><p>Ubuntu last 3 major LTS versions, 64bit, Debian 8.0 64bit, RHEL 7, CentOS 7 64bit</p></td>
|
|
|
</tr>
|
|
|
</tbody>
|
|
|
</table>
|
|
|
<p>In case large networks (>100 stations) are operated, a distributed system is
|
|
|
recommended. Normally a <cite>SeisComP</cite> system is separated in several subsystems.
|
|
|
A separation of data acquisition, processing and graphical user interfaces (GUI) is
|
|
|
useful to permit stable performance.</p>
|
|
|
<p>The minimum specifications of <cite>SeisComP</cite> systems depend on the setup and the
|
|
|
applications.</p>
|
|
|
<p>Data acquisition systems:</p>
|
|
|
<table class="docutils align-default">
|
|
|
<colgroup>
|
|
|
<col style="width: 7%" />
|
|
|
<col style="width: 93%" />
|
|
|
</colgroup>
|
|
|
<tbody>
|
|
|
<tr class="row-odd"><td><p>CPU</p></td>
|
|
|
<td><p>2</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>RAM</p></td>
|
|
|
<td><p>4 GB</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>HDD</p></td>
|
|
|
<td><p>Raid1/5/0+1 with >= 200GB</p></td>
|
|
|
</tr>
|
|
|
</tbody>
|
|
|
</table>
|
|
|
<p>Processing systems:</p>
|
|
|
<table class="docutils align-default">
|
|
|
<colgroup>
|
|
|
<col style="width: 7%" />
|
|
|
<col style="width: 93%" />
|
|
|
</colgroup>
|
|
|
<tbody>
|
|
|
<tr class="row-odd"><td><p>CPU</p></td>
|
|
|
<td><p>4</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>RAM</p></td>
|
|
|
<td><p>8 GB</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>HDD</p></td>
|
|
|
<td><p>Raid1/5/0+1 with >= 100GB</p></td>
|
|
|
</tr>
|
|
|
</tbody>
|
|
|
</table>
|
|
|
<p>GUI system:</p>
|
|
|
<table class="docutils align-default">
|
|
|
<colgroup>
|
|
|
<col style="width: 7%" />
|
|
|
<col style="width: 93%" />
|
|
|
</colgroup>
|
|
|
<tbody>
|
|
|
<tr class="row-odd"><td><p>CPU</p></td>
|
|
|
<td><p>2</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p>RAM</p></td>
|
|
|
<td><p>4 GB</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p>HDD</p></td>
|
|
|
<td><p>> 50 GB</p></td>
|
|
|
</tr>
|
|
|
</tbody>
|
|
|
</table>
|
|
|
</div>
|
|
|
<div class="section" id="installation-from-packages">
|
|
|
<span id="installation-packages"></span><h2>Installation from Packages<a class="headerlink" href="#installation-from-packages" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>This section describes the installation of <cite>SeisComP</cite> from compiled <cite>SeisComP</cite>
|
|
|
packages which ship as <code class="file docutils literal notranslate"><span class="pre">*.tar.gz</span></code> files.</p>
|
|
|
<div class="section" id="steps-to-take">
|
|
|
<h3>Steps to take<a class="headerlink" href="#steps-to-take" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>Simply follow a few steps to complete your installation of <cite>SeisComP</cite>:</p>
|
|
|
<ol class="arabic">
|
|
|
<li><p>Log in to your Linux system as user, e.g. sysop, the standard user in this
|
|
|
documentation.</p></li>
|
|
|
<li><p>Download the installation packages, e.g. from <span id="id5">Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH [<a class="reference internal" href="references.html#id243" title="Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH. The SeisComP seismological software package. GFZ Data Services. 2008. URL: https://www.seiscomp.de, doi:10.5880/GFZ.2.4.2020.003.">61</a>]</span> or
|
|
|
<span id="id6"><em>Public download site of gempa</em> [<a class="reference internal" href="references.html#id115" title="Public download site of gempa. URL: https://data.gempa.de/packages/Public/seiscomp/.">19</a>]</span>:</p>
|
|
|
<ul>
|
|
|
<li><p><code class="file docutils literal notranslate"><span class="pre">seiscomp-[version]-[OS]-[arch].tar.gz</span></code>: main <cite>SeisComP</cite> package with binaries, etc.
|
|
|
Ensure to download the right package matching your operating system (OS) and
|
|
|
hardware architecture (arch: 32 or 64-bit).</p></li>
|
|
|
<li><p><code class="file docutils literal notranslate"><span class="pre">seiscomp-[version]-doc.tar.gz</span></code>: <cite>SeisComP</cite> documentation.</p>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p>When receiving the packages from <span id="id7"><em>Public download site of gempa</em> [<a class="reference internal" href="references.html#id115" title="Public download site of gempa. URL: https://data.gempa.de/packages/Public/seiscomp/.">19</a>]</span>, the documentation is already
|
|
|
included in the main <cite>SeisComP</cite> package to match the installed version. In this
|
|
|
case, the documentation does not need to be downloaded and installed separately.</p>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p><code class="file docutils literal notranslate"><span class="pre">seiscomp-maps.tar.gz</span></code>: standard <cite>SeisComP</cite> maps available on the
|
|
|
download site of <span id="id8">Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH [<a class="reference internal" href="references.html#id243" title="Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH. The SeisComP seismological software package. GFZ Data Services. 2008. URL: https://www.seiscomp.de, doi:10.5880/GFZ.2.4.2020.003.">61</a>]</span>.</p></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
<li><p>Copy the downloaded files to your $HOME directory.</p></li>
|
|
|
<li><p>Navigate to the $HOME directory or any other place where to install <cite>SeisComP</cite></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:$ <span class="nb">cd</span>
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>Install the main <cite>SeisComP</cite> package into <code class="file docutils literal notranslate"><span class="pre">seiscomp</span></code></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ tar xzf seiscomp-<span class="o">[</span>version<span class="o">]</span>-<span class="o">[</span>OS<span class="o">]</span>-<span class="o">[</span>arch<span class="o">]</span>.tar.gz
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>Install the <cite>SeisComP</cite> map package into <code class="file docutils literal notranslate"><span class="pre">seiscomp/share/maps</span></code></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ tar xzf seiscomp-<span class="o">[</span>release<span class="o">]</span>-maps.tar.gz
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>Optional: Install the documentation package into <code class="file docutils literal notranslate"><span class="pre">seiscomp/share/doc</span></code></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ tar xzf seiscomp-<span class="o">[</span>version<span class="o">]</span>-doc.tar.gz
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
</ol>
|
|
|
<p>Unpacking these files creates the <cite>SeisComP</cite> <a class="reference internal" href="#directory-structure"><span class="std std-ref">directory structure</span></a>.</p>
|
|
|
</div>
|
|
|
<div class="section" id="directory-structure">
|
|
|
<span id="id9"></span><h3>Directory structure<a class="headerlink" href="#directory-structure" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>All installed files and directories are found below the <em>seiscomp</em> directory.
|
|
|
The directory structure of the installed system is described the table below.</p>
|
|
|
<table class="colwidths-given docutils align-left">
|
|
|
<colgroup>
|
|
|
<col style="width: 10%" />
|
|
|
<col style="width: 90%" />
|
|
|
</colgroup>
|
|
|
<thead>
|
|
|
<tr class="row-odd"><th class="head"><p>Directory</p></th>
|
|
|
<th class="head"><p>Description</p></th>
|
|
|
</tr>
|
|
|
</thead>
|
|
|
<tbody>
|
|
|
<tr class="row-even"><td><p><em>bin</em></p></td>
|
|
|
<td><p>The user module binaries.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p><em>lib</em></p></td>
|
|
|
<td><p>The base library directory used by all modules.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p><em>lib/python</em></p></td>
|
|
|
<td><p>The Python library directory.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p><em>man</em></p></td>
|
|
|
<td><p>The manual pages.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p><em>sbin</em></p></td>
|
|
|
<td><p>The system/service/server binaries such as <a class="reference internal" href="../apps/seedlink.html#seedlink"><span class="std std-ref">seedlink</span></a>.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p><em>var</em></p></td>
|
|
|
<td><p>Variable files whose content is expected to continually change.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p><em>var/log</em></p></td>
|
|
|
<td><p>Log files of started modules. Usually modules log either to syslog or ~/.seiscomp/log. This directory contains the logs of the start of each module.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p><em>var/lib</em></p></td>
|
|
|
<td><p>Default directory for files created by modules such as the waveform ringbuffer of <a class="reference internal" href="../apps/seedlink.html#seedlink"><span class="std std-ref">seedlink</span></a> or the waveform archive created by <a class="reference internal" href="../apps/slarchive.html#slarchive"><span class="std std-ref">slarchive</span></a>.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p><em>var/run</em></p></td>
|
|
|
<td><p>Contains the .run and .pid files of modules started by <strong class="program">seiscomp</strong>.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p><em>include</em></p></td>
|
|
|
<td><p>SDK header files for all libraries.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p><em>share</em></p></td>
|
|
|
<td><p>Application data such as maps, cities.xml and others.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p><em>share/templates</em></p></td>
|
|
|
<td><p>Template files used by e.g. <a class="reference internal" href="../apps/seedlink.html#seedlink"><span class="std std-ref">seedlink</span></a> to create its native configuration.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p><em>etc</em></p></td>
|
|
|
<td><p>Configuration directory.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p><em>etc/descriptions</em></p></td>
|
|
|
<td><p>Contains all XML module descriptions.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p><em>etc/defaults</em></p></td>
|
|
|
<td><p>The default configuration files. This directory is read as first when a module starts.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-odd"><td><p><em>etc/init</em></p></td>
|
|
|
<td><p>Module init scripts called by <strong class="program">seiscomp</strong>.</p></td>
|
|
|
</tr>
|
|
|
<tr class="row-even"><td><p><em>etc/key</em></p></td>
|
|
|
<td><p>Station configurations and module bindings.</p></td>
|
|
|
</tr>
|
|
|
</tbody>
|
|
|
</table>
|
|
|
</div>
|
|
|
<div class="section" id="software-dependencies">
|
|
|
<span id="id10"></span><h3>Software dependencies<a class="headerlink" href="#software-dependencies" title="Permalink to this headline">¶</a></h3>
|
|
|
<p><cite>SeisComP</cite> depends on a number of additional software packages shipped with each
|
|
|
Linux distribution.
|
|
|
After installation of <cite>SeisComP</cite> these packages can be installed using the
|
|
|
<strong class="program">seiscomp</strong>.
|
|
|
The <strong class="program">seiscomp</strong> tool comes with
|
|
|
the command <strong class="command">install-deps</strong> which installs required packages.
|
|
|
Read the section <a class="reference internal" href="management.html#system-management"><span class="std std-ref">System management</span></a> for more detailed instructions.
|
|
|
For example, to install the dependencies for using the MariaDB database,
|
|
|
give ‘mariadb-server’ as parameter.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ seiscomp/bin/seiscomp install-deps base mariadb-server
|
|
|
Distribution: Ubuntu <span class="m">18</span>.04
|
|
|
<span class="o">[</span>sudo<span class="o">]</span> password <span class="k">for</span> sysop:
|
|
|
Reading package lists... Done
|
|
|
Building dependency tree
|
|
|
Reading state information... Done
|
|
|
...
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>More options for systems with GUIs and FDSNWS are:</p>
|
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>user@host:~$ seiscomp/bin/seiscomp install-deps gui fdsnws
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>If your distribution is not supported by <strong class="command">install-deps</strong>,
|
|
|
install the above packages manually:</p>
|
|
|
<p><strong class="program">Ubuntu</strong> <cite>version</cite></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ <span class="nb">cd</span> seiscomp/share/deps/ubuntu/<span class="o">[</span>version<span class="o">]</span>
|
|
|
...
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p><strong class="program">CentOS</strong> <cite>version</cite></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ <span class="nb">cd</span> seiscomp/share/deps/centos/<span class="o">[</span>version<span class="o">]</span>
|
|
|
...
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>su root
|
|
|
bash install-mariadb-server.sh
|
|
|
bash install-postgresql-server.sh
|
|
|
bash install-base.sh
|
|
|
bash install-gui.sh
|
|
|
bash install-fdsnws.sh
|
|
|
...
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>or contact the <cite>SeisComP</cite> developers to add support for your distribution.</p>
|
|
|
<div class="admonition warning">
|
|
|
<p class="admonition-title">Warning</p>
|
|
|
<p>Either the MariaDB <strong>or</strong> the MySQL server can be installed; not both at the
|
|
|
same time. When replacing on by the other, ensure that all related files are
|
|
|
removed before installing the alternative server. For MySQL instead of MariaDB
|
|
|
use:</p>
|
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>root@host:~$ sh install-mysql-server.sh
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Preferably use MariaDB instead of MySQL as MariaDB is the default for the
|
|
|
supported Linux distributions!</p>
|
|
|
</div>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p>Linux systems develop dynamically and the installation of the dependencies
|
|
|
may be incomplete. <cite>SeisComP</cite> modules will stop and indicate the missing software.
|
|
|
They can be installed manually.</p>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="database-server-configuration">
|
|
|
<span id="database-configuration"></span><h1>Database Server Configuration<a class="headerlink" href="#database-server-configuration" title="Permalink to this headline">¶</a></h1>
|
|
|
<p><cite>SeisComP</cite> is typically operated with a <a class="reference internal" href="concepts/database.html#concepts-database"><span class="std std-ref">database</span></a> which
|
|
|
should be optimized. This section describes how to setup and optimize the
|
|
|
database server. For the setup of the database itself read the section
|
|
|
<a class="reference internal" href="getting-started.html#getting-started"><span class="std std-ref">Getting Started with SeisComP</span></a>.</p>
|
|
|
<div class="section" id="mariadb-mysql">
|
|
|
<span id="database-configuration-mysql"></span><h2>MariaDB / MySQL<a class="headerlink" href="#mariadb-mysql" title="Permalink to this headline">¶</a></h2>
|
|
|
<ul>
|
|
|
<li><p>For better performance with a MariaDB/MySQL database, adjust the memory pool size. Test
|
|
|
the default of the <strong>buffer_pool_size</strong> before making the change:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$ mysql -u root -p
|
|
|
show variables like <span class="s1">'innodb_buffer_pool_size'</span><span class="p">;</span>
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>The optimum <strong>buffer_pool_size</strong> depends on your system (RAM size) and only needs
|
|
|
to be set if required. Choose your preferred value:</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>Recommended value: 512M or more</p></li>
|
|
|
<li><p>Minimum value: 64M</p></li>
|
|
|
</ul>
|
|
|
<p>Additionally, reduce the database hard drive synchronization and make both adjustments
|
|
|
in the section [mysqld]:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="o">[</span>mysqld<span class="o">]</span>
|
|
|
<span class="nv">innodb_buffer_pool_size</span> <span class="o">=</span> <your value>
|
|
|
<span class="nv">innodb_flush_log_at_trx_commit</span> <span class="o">=</span> <span class="m">2</span>
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p>The location of the configuration file can differ between distributions.</p>
|
|
|
<p><strong class="program">Ubuntu</strong>:</p>
|
|
|
<p><code class="file docutils literal notranslate"><span class="pre">/etc/mysql/mariadb.conf.d/50-server.cnf</span></code></p>
|
|
|
<p><strong class="program">CentOS</strong>:</p>
|
|
|
<p><code class="file docutils literal notranslate"><span class="pre">/etc/my.cnf</span></code></p>
|
|
|
</div>
|
|
|
<p>Please read the documentation of your distribution. root privileges may
|
|
|
be required to make the changes.</p>
|
|
|
</li>
|
|
|
<li><p>To start MariaDB automatically during boot set</p>
|
|
|
<p><strong class="program">Ubuntu</strong></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ sudo systemctl <span class="nb">enable</span> mariadb
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p><strong class="program">CentOS</strong></p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ su root
|
|
|
root@host:~$ systemctl <span class="nb">enable</span> mariadb
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>If you make a fresh installation of MariaDB/MySQL, secure the database and set
|
|
|
a password for the root user</p>
|
|
|
<p><strong class="program">Ubuntu</strong></p>
|
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>user@host:~$ sudo mysql_secure_installation
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p><strong class="program">CentOS</strong></p>
|
|
|
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>user@host:~$ su root
|
|
|
root@host:~$ mysql_secure_installation
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<div class="admonition warning">
|
|
|
<p class="admonition-title">Warning</p>
|
|
|
<p>This step overrides database settings. Only execute the command</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>After a fresh installation or</p></li>
|
|
|
<li><p>If you are sure about the procedure.</p></li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>After adjusting the parameters, MariaDB needs to be restarted. One can run</p>
|
|
|
<p><strong class="program">Ubuntu</strong>:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ sudo systemctl restart mariadb
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p><strong class="program">CentOS</strong>:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>user@host:~$ su root
|
|
|
root@host:~$ systemctl restart mariadb
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
</ul>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p>Replace mariadb by mysql when using MySQL instead of MariaDB.</p>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="postgresql">
|
|
|
<span id="database-configuration-postgresql"></span><h2>PostgreSQL<a class="headerlink" href="#postgresql" title="Permalink to this headline">¶</a></h2>
|
|
|
<ul class="simple">
|
|
|
<li><p>When using PostgreSQL, the database server must be initialized and secured.</p></li>
|
|
|
<li><p>By default PostgresSQL does not allow to login with username and password which
|
|
|
leads to the fact that <strong class="program">scmaster</strong> can not connect to the database
|
|
|
after <cite>SeisComP</cite> database initialization. Here an example how to enable
|
|
|
user/password authentication for local and remote connections.</p></li>
|
|
|
</ul>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># TYPE DATABASE USER ADDRESS METHOD</span>
|
|
|
<span class="c1"># IPv4 local connections:</span>
|
|
|
host seiscomp sysop <span class="m">0</span>.0.0.0/0 md5
|
|
|
host all all <span class="m">127</span>.0.0.1/32 ident
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p>The order of the rules matters and the location of the configuration file
|
|
|
can differ between distributions.</p>
|
|
|
<p><strong class="program">Ubuntu</strong>:</p>
|
|
|
<p><code class="file docutils literal notranslate"><span class="pre">/etc/postgresql/10/main/pg_hba.conf</span></code></p>
|
|
|
<p><strong class="program">CentOS</strong>:</p>
|
|
|
<p><code class="file docutils literal notranslate"><span class="pre">/var/lib/pgsql/data/pg_hba.conf</span></code></p>
|
|
|
</div>
|
|
|
<ul>
|
|
|
<li><p>By default PostgresSQL accepts local connections only. If the database server
|
|
|
and clients are on different machines please change the listen address as
|
|
|
follows.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">listen_addresses</span> <span class="o">=</span> <span class="m">0</span>.0.0.0/0
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p>The location of the configuration file can differ between distributions.</p>
|
|
|
<p><strong class="program">Ubuntu</strong>:</p>
|
|
|
<p><code class="file docutils literal notranslate"><span class="pre">/etc/postgresql/10/main/postgresql.conf</span></code></p>
|
|
|
<p><strong class="program">CentOS</strong>:</p>
|
|
|
<p><code class="file docutils literal notranslate"><span class="pre">/var/lib/pgsql/data/postgresql.conf</span></code></p>
|
|
|
</div>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
<div class="section" id="next-steps">
|
|
|
<h2>Next Steps<a class="headerlink" href="#next-steps" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>Now everything is installed and the system can be configured. The
|
|
|
<a class="reference internal" href="getting-started.html#getting-started"><span class="std std-ref">next chapter</span></a> chapter explains the first steps.</p>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
<div id="anchors-bottom"></div>
|
|
|
</div>
|
|
|
|
|
|
<div class="sidebar" role="navigation" aria-label="main navigation">
|
|
|
<div id="anchors-top"></div>
|
|
|
<div id="anchors" class="content">
|
|
|
<div id="searchbox" style="display: none" role="search">
|
|
|
<h3 id="searchlabel">Quick search</h3>
|
|
|
<div class="searchformwrapper">
|
|
|
<form class="search" action="../search.html" method="get">
|
|
|
<input type="text" name="q" aria-labelledby="searchlabel" />
|
|
|
<input type="submit" value="Go" />
|
|
|
</form>
|
|
|
</div>
|
|
|
</div>
|
|
|
<script>$('#searchbox').show(0);</script>
|
|
|
<h3><a href="../index.html">Table of Contents</a></h3>
|
|
|
<ul>
|
|
|
<li><a class="reference internal" href="#"><cite>SeisComP</cite> Installation</a><ul>
|
|
|
<li><a class="reference internal" href="#hardware-requirements">Hardware Requirements</a></li>
|
|
|
<li><a class="reference internal" href="#installation-from-packages">Installation from Packages</a><ul>
|
|
|
<li><a class="reference internal" href="#steps-to-take">Steps to take</a></li>
|
|
|
<li><a class="reference internal" href="#directory-structure">Directory structure</a></li>
|
|
|
<li><a class="reference internal" href="#software-dependencies">Software dependencies</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
<li><a class="reference internal" href="#database-server-configuration">Database Server Configuration</a><ul>
|
|
|
<li><a class="reference internal" href="#mariadb-mysql">MariaDB / MySQL</a></li>
|
|
|
<li><a class="reference internal" href="#postgresql">PostgreSQL</a></li>
|
|
|
<li><a class="reference internal" href="#next-steps">Next Steps</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
|
|
|
<h4>Previous topic</h4>
|
|
|
<p class="topless"><a href="changelog.html"
|
|
|
title="previous chapter">Change Log</a></p>
|
|
|
<h4>Next topic</h4>
|
|
|
<p class="topless"><a href="getting-started.html"
|
|
|
title="next chapter">Getting Started with <cite>SeisComP</cite></a></p>
|
|
|
<div role="note" aria-label="source link">
|
|
|
<h3>This Page</h3>
|
|
|
<ul class="this-page-menu">
|
|
|
<li><a href="../_sources/base/installation.rst.txt"
|
|
|
rel="nofollow">Show Source</a></li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="footer">
|
|
|
<div class="container">
|
|
|
<div class="horizontal layout content">
|
|
|
<a class="fade-in" href="https://www.gempa.de" target="_blank">
|
|
|
<img class="brand" src="../_static/brands/gempa.svg"/>
|
|
|
</a>
|
|
|
<div class="stretched align-center fitted content">
|
|
|
<div>
|
|
|
Version <b>5.3.0</b> Release
|
|
|
</div>
|
|
|
<div class="copyright">
|
|
|
Copyright © gempa GmbH, GFZ Potsdam.
|
|
|
</div>
|
|
|
</div>
|
|
|
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
|
|
|
<img class="brand" src="../_static/brands/gfz.svg"/>
|
|
|
</a>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</body>
|
|
|
</html> |