benjamin
/
seiscomp-training
1
0
Fork 0
Code Pull Requests Packages Projects Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
main
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '906e9ccf6b'
${ noResults }
seiscomp-training/share/doc/seiscomp/html/base/installation.html

582 lines
29 KiB
HTML
Raw Normal View History Unescape Escape

[installation] Initial commit with first config
1 year ago
<!DOCTYPE html>
<html >
<head>
<meta charset="utf-8" />
<title>SeisComP Installation &#8212; 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 (&gt;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 &gt;= 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 &gt;= 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>&gt; 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">&#39;innodb_buffer_pool_size&#39;</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> &lt;your value&gt;
<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 &copy; 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>