SCRUG-NA/2025
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[installation] Change to nightly

Browse Source
This commit is contained in:
Dirk Rössler
2025-10-30 12:04:59 +01:00
parent 2ff097f9d1
commit a31bc45cce
1441 changed files with 60368 additions and 56360 deletions
Download Patch File Download Diff File Expand all files Collapse all files

93
share/doc/seiscomp/html/base/tutorials/postinstall.html
View File

@@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Installation on Ubuntu &#8212; SeisComP Release documentation</title>
<title>Installation on Ubuntu &#8212; SeisComP Development 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/pygments.css?v=72bcf2f2" />
@@ -12,12 +12,12 @@
<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css?v=eafc0fe6" />
<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 data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js?v=744d344a"></script>
<script src="../../_static/doctools.js?v=888ff710"></script>
<script src="../../_static/sphinx_highlight.js?v=4825356b"></script>
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="Upgrading SeisComP" href="upgrading.html" />
<link rel="next" title="Updating/Upgrading SeisComP" href="upgrading.html" />
<link rel="prev" title="Tutorials" href="../tutorials.html" />
</head>
<body>
@@ -25,8 +25,8 @@
<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">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@@ -43,7 +43,7 @@
</a>
</li>
<li class="right">
<a href="upgrading.html" title="Upgrading SeisComP"
<a href="upgrading.html" title="Updating/Upgrading SeisComP"
accesskey="N">
next
</a>
@@ -73,11 +73,14 @@
<span id="tutorials-postinstall"></span><h1>Installation on Ubuntu<a class="headerlink" href="#installation-on-ubuntu" title="Permalink to this heading"></a></h1>
<p>You will …</p>
<ul class="simple">
<li><p>Make a basic <cite>SeisComP</cite> installation</p></li>
<li><p>Make a basic <cite>SeisComP</cite> installation of SeisComP in version 4.0.0 on Ubuntu 20.04</p></li>
<li><p>Make an initial configuration</p></li>
<li><p>Perform function tests</p></li>
</ul>
<p>Pre-requisites for this tutorial:</p>
<ul class="simple">
<li><p>Internet access</p></li>
<li><p><a class="reference internal" href="../installation.html#installation"><span class="std std-ref">Documentation of installation</span></a></p></li>
</ul>
<p>Afterwards/Results/Outcomes:</p>
<ul class="simple">
@@ -90,7 +93,7 @@
</ul>
<p>Related tutorial(s):</p>
<ul class="simple">
<li><p><a class="reference internal" href="upgrading.html#tutorials-upgrade"><span class="std std-ref">Upgrading SeisComP</span></a></p></li>
<li><p><a class="reference internal" href="upgrading.html#tutorials-upgrade"><span class="std std-ref">Updating/Upgrading SeisComP</span></a></p></li>
<li><p><a class="reference internal" href="addstation.html#tutorials-addstation"><span class="std std-ref">Add a new station</span></a></p></li>
<li><p><a class="reference internal" href="geofon_waveforms.html#tutorials-geofon-waveforms"><span class="std std-ref">Add real-time stations from GEOFON</span></a></p></li>
</ul>
@@ -113,12 +116,18 @@ $<span class="w"> </span>sudo<span class="w"> </span>addgroup<span class="w"> </
$<span class="w"> </span>sudo<span class="w"> </span>usermod<span class="w"> </span>-a<span class="w"> </span>-G<span class="w"> </span>admin,adm,audio<span class="w"> </span>sysop
</pre></div>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Adding a new user is not mandatory. You can install under an existing user
directory. Creating a new user is recommended as it allows an easy cleanup
of the system later simply by removing the new user if needed.</p>
</div>
</li>
<li><p>Check the size and the architecture. This is espcially required when installing
<a class="reference internal" href="#tutorials-postinstall-package"><span class="std std-ref">pre-compiled packages</span></a>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ df -h
$ cat /etc/issue
$ uname -m
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>df<span class="w"> </span>-h
$<span class="w"> </span>cat<span class="w"> </span>/etc/issue
$<span class="w"> </span>uname<span class="w"> </span>-m
</pre></div>
</div>
<p>Compare the available disk space with the requirements given in
@@ -130,32 +139,43 @@ if you see ‘x86_64’, you have 64-bit.</p>
</section>
<section id="install-from-source-code">
<span id="tutorials-postinstall-compile"></span><h2>Install from source code<a class="headerlink" href="#install-from-source-code" title="Permalink to this heading"></a></h2>
<p>To compile SeisComP from the source code follow the
<a class="reference internal" href="../build.html#build"><span class="std std-ref">instructions in the development section</span></a>. You may later download and add
maps as described below in the <a class="reference internal" href="#tutorials-postinstall-package"><span class="std std-ref">package section</span></a>.</p>
<p>To compile <cite>SeisComP</cite> from the source code follow the
<a class="reference internal" href="../build.html#build"><span class="std std-ref">instructions in the development section</span></a>. You may later download
and add maps as described below in the
<a class="reference internal" href="../installation.html#installation"><span class="std std-ref">Documentation of installation</span></a>.</p>
</section>
<section id="install-pre-compiled-release-packages">
<span id="tutorials-postinstall-package"></span><h2>Install pre-compiled release packages<a class="headerlink" href="#install-pre-compiled-release-packages" title="Permalink to this heading"></a></h2>
<p>You may download and installed pre-compile SeisComP binary package, maps and documentation.</p>
<p>You may install the <cite>SeisComP</cite> packages in either way:</p>
<ul class="simple">
<li><p><a class="reference internal" href="../installation.html#installation-gsm"><span class="std std-ref">gsm</span></a> (recommended) a package manager provided by
<span id="id1"><em>gempa GmbH</em> [<a class="reference internal" href="../references.html#id147" title="gempa GmbH. The SeisComP development and maintenance company. URL: https://www.gempa.de.">31</a>]</span>,</p></li>
<li><p><a class="reference internal" href="../installation.html#installation-manual"><span class="std std-ref">manually by extracting packages</span></a>.</p></li>
</ul>
<p>Here we refer to the manual extraction of packages. More details are given
in section <a class="reference internal" href="../installation.html#installation"><span class="std std-ref">SeisComP Installation</span></a>.</p>
<p>You may download and installed pre-compile <cite>SeisComP</cite> binary package, maps and
documentation.</p>
<ol class="arabic">
<li><p>Download the appropriate <cite>SeisComP</cite> binary package taking into
account your Linux distribution and the architecture.
Get the package from the download site of <cite>SeisComP</cite> <span id="id1">[<a class="reference internal" href="../references.html#id257" 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.">67</a>]</span> or from
<span id="id2"><em>Public download site of gempa</em> [<a class="reference internal" href="../references.html#id124" title="Public download site of gempa. URL: https://data.gempa.de/packages/Public/seiscomp/.">20</a>]</span>. Packages are available for Ubuntu and other Linux
Get the package from the download site of <cite>SeisComP</cite> <span id="id2">[<a class="reference internal" href="../references.html#id290" 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.">76</a>]</span> or from
<span id="id3"><em>Public download site of gempa</em> [<a class="reference internal" href="../references.html#id149" title="Public download site of gempa. URL: https://data.gempa.de/packages/Public/seiscomp/.">21</a>]</span>. Packages are available for Ubuntu and other Linux
flavors such as RHEL/CentOS and Debian.</p></li>
<li><p>When downloading the <cite>SeisComP</cite> binary packages you should also download</p>
<ul>
<li><p>maps for <cite>SeisComP</cite></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>wget<span class="w"> </span><span class="s2">&quot;https://www.seiscomp.de/downloader/seiscomp-maps.tar.gz&quot;</span>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>wget<span class="w"> </span><span class="s2">&quot;https://www.seiscomp.de/downloader/seiscomp-maps.tar.gz&quot;</span>
</pre></div>
</div>
</li>
<li><p>the documentation package. Make sure, the documentation matches your
SeisComP version.</p>
<cite>SeisComP</cite> version.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The <cite>SeisComP</cite> packages received from gempa GmbH contain the documentation
for the respective version and no separate download is required.</p>
<p>The <cite>SeisComP</cite> packages received from <span id="id4"><em>Public download site of gempa</em> [<a class="reference internal" href="../references.html#id149" title="Public download site of gempa. URL: https://data.gempa.de/packages/Public/seiscomp/.">21</a>]</span> contain the
documentation for the respective version and no separate download is
required.</p>
</div>
</li>
</ul>
@@ -276,12 +296,12 @@ system the output from the command</p>
the <a class="reference internal" href="../../apps/seiscomp.html#seiscomp"><span class="std std-ref">seiscomp</span></a> command will be added to your shell’s path.</p>
<div class="admonition hint">
<p class="admonition-title">Hint</p>
<p>If, when you attempt to run a SeisComP command such as <a class="reference internal" href="../../apps/scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> or
<p>If, when you attempt to run a <cite>SeisComP</cite> command such as <a class="reference internal" href="../../apps/scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> or
<a class="reference internal" href="../../apps/scolv.html#scolv"><span class="std std-ref">scolv</span></a>, you receive an error message like</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scconfig:<span class="w"> </span><span class="nb">command</span><span class="w"> </span>not<span class="w"> </span>found
</pre></div>
</div>
<p>then the most likely explanation is that you have not set your SeisComP
<p>then the most likely explanation is that you have not set your <cite>SeisComP</cite>
environment variables correctly.</p>
<p>Run the <cite>seiscomp</cite> command with the full path to
where you installed.
@@ -300,7 +320,7 @@ fields, you can always accept the default values.</p>
Datacenter ID. These are used for Arclink and Seedlink, and in the information
describing data model objects such as origins and events.</p>
</li>
<li><p>The <cite>seiscomp</cite> command is a wrapper, which controls the SeisComP modules.
<li><p>The <cite>seiscomp</cite> command is a wrapper, which controls the <cite>SeisComP</cite> modules.
See <a class="reference internal" href="../management.html#system-management"><span class="std std-ref">System management</span></a>.
Run something by typing seiscomp followed by a command</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="w"> </span>$<span class="w"> </span>seiscomp<span class="w"> </span><span class="nb">help</span>
@@ -317,12 +337,17 @@ Use<span class="w"> </span><span class="s1">&#39;help [command]&#39;</span><span
</pre></div>
</div>
</li>
<li><p>Start <a class="reference internal" href="../../apps/scmaster.html#scmaster"><span class="std std-ref">scmaster</span></a>.
<li><p>Start and test <a class="reference internal" href="../../apps/scmaster.html#scmaster"><span class="std std-ref">scmaster</span></a>.
As described in the <a class="reference internal" href="../overview.html#overview"><span class="std std-ref">Overview</span></a>, these are needed for
communication between the SeisComP database and the individual
SeisComP modules.</p>
communication between the <cite>SeisComP</cite> database and the individual
<cite>SeisComP</cite> modules.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>seiscomp<span class="w"> </span>start<span class="w"> </span>scmaster
starting<span class="w"> </span>scmaster
$<span class="w"> </span>seiscomp<span class="w"> </span>status<span class="w"> </span>scmaster
</pre></div>
</div>
<p>In case errors are reported you should understand the full debug log:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>scmaster<span class="w"> </span>--debug
</pre></div>
</div>
</li>
@@ -337,10 +362,10 @@ starting<span class="w"> </span>scmaster
</div>
<p>Learn more about <a class="reference internal" href="../../apps/scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> in this documentation.
You should see a screen/window like this.</p>
<figure class="align-center" id="id3">
<figure class="align-center" id="id5">
<a class="reference internal image-reference" href="../../_images/postinstall_scconfig.png"><img alt="../../_images/postinstall_scconfig.png" src="../../_images/postinstall_scconfig.png" style="width: 16cm;" /></a>
<figcaption>
<p><span class="caption-text">First view of <a class="reference internal" href="../../apps/scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> configurator.</span><a class="headerlink" href="#id3" title="Permalink to this image"></a></p>
<p><span class="caption-text">First view of <a class="reference internal" href="../../apps/scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> configurator.</span><a class="headerlink" href="#id5" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</li>
@@ -348,7 +373,7 @@ You should see a screen/window like this.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>seiscomp<span class="w"> </span><span class="nb">exec</span><span class="w"> </span>scrttv
</pre></div>
</div>
<p>After seeing the SeisComP splash screen,
<p>After seeing the <cite>SeisComP</cite> splash screen,
you’ll likely get an error message “Could not read inventory (NULL)”.
After a new installation, that’s okay.
Click that box away, and you’ll see a screen with
@@ -356,10 +381,10 @@ Click that box away, and you’ll see a screen with
To see stations and data you will later need to
<a class="reference internal" href="addstation.html#tutorials-addstation"><span class="std std-ref">add inventory</span></a> and
<a class="reference internal" href="geofon_waveforms.html#tutorials-geofon-waveforms"><span class="std std-ref">waveforms</span></a> to your system.</p>
<figure class="align-center" id="id4">
<figure class="align-center" id="id6">
<a class="reference internal image-reference" href="../../_images/postinstall_scrttv.png"><img alt="../../_images/postinstall_scrttv.png" src="../../_images/postinstall_scrttv.png" style="width: 14.6cm;" /></a>
<figcaption>
<p><span class="caption-text">First view of the <a class="reference internal" href="../../apps/scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> configuration tool.</span><a class="headerlink" href="#id4" title="Permalink to this image"></a></p>
<p><span class="caption-text">First view of the <a class="reference internal" href="../../apps/scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> configuration tool.</span><a class="headerlink" href="#id6" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</li>
@@ -406,7 +431,7 @@ To see stations and data you will later need to
<div>
<h4>Next topic</h4>
<p class="topless"><a href="upgrading.html"
title="next chapter">Upgrading SeisComP</a></p>
title="next chapter">Updating/Upgrading SeisComP</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
@@ -427,7 +452,7 @@ To see stations and data you will later need to
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.