Workflow: Upgrade Release¶
Upgrade SeisComP release
./gsm do-release-upgrade
INSTALL [✓] core.db 17119/17119 00:00
If your SeisComP installation is not under version control, we recommend to make a backup before continuing.
Do you want to continue? [y/N]: y
BACKUP [✓] gsm 16/16 00:00
INFO The gsm backup has been saved under /home/sysop/install/gsm/.restore/gsm.tar.gz
Select a number from the list to choose the release:
1: nightly
Upgrade to Option: 1
Do you want to continue? [y/N]: y
ACCESS [✓] 4/4 00:00
GET [✓] quakelink 2026.212 15.7M/15.7M 00:00
CHECKSUM [✓] seiscomp-tools 2026.175 8.59k/8.59k 00:00
CHECKSUM [✓] seiscomp nightly 72.4M/72.4M 00:00
CHECKSUM [✓] quakelink 2026.212 15.7M/15.7M 00:00
CHECKSUM [✓] scanloc 2026.204 13.9M/13.9M 00:00
REMOVE [✓] 4/4 00:00
Please check your SeisComP environment settings in ~/.bashrc
SeedLink in SeisComP3 prior to 2020 uses a simplified buffer. Migrate the buffer using 'gempa-rename-seedlink-buffer' after upgrading.
Download the script here: https://data.gempa.de/packages/Public/tools/gempa-rename-seedlink-buffer.py
Recommendation: Run the script 'gempa-checkSCconfig' after upgrading to check the SeisComP configuration for deprecated parameters.
Install the script using ./gsm install seiscomp-tools or download from https://data.gempa.de/packages/Public/tools/gempa-checkSCconfig.py
Please also check your SeisComP environment settings in ~/.bashrc
ACCESS [✓] 4/4 00:00
CHANGELOG [✓] 4/4 00:00
CHECKGPG [✓] 4/4 00:00
INSTALL [✓] quakelink 2026.212 335/335 00:00
INSTALL [✓] quakelink license 2/2 00:00
INSTALL [✓] scanloc 2026.204 282/282 00:00
INSTALL [✓] scanloc license 2/2 00:00
INSTALL [✓] seiscomp nightly 2448/2448 00:00
INSTALL [✓] seiscomp-tools 2026.175 3/3 00:00
4/4 packages have been installed:
quakelink (2026.212) to /home/sysop/seiscomp: 335 file(s) (+2 License files), 26.6 MiB
scanloc (2026.204) to /home/sysop/seiscomp: 282 file(s) (+2 License files), 19.9 MiB
seiscomp (nightly) to /home/sysop/seiscomp: 2448 file(s), 173.2 MiB
seiscomp-tools (2026.175) to /home/sysop/seiscomp: 3 file(s), 41.0 KiB
Dependency name Package name Install script
----------------- -------------- ----------------------------
base seiscomp install-base.sh
fdsnws seiscomp install-fdsnws.sh
gui seiscomp install-gui.sh
iloc seiscomp install-iloc.sh
mariadb-server seiscomp install-mariadb-server.sh
postgresql-server seiscomp install-postgresql-server.sh
No further dependencies need to be installed for: quakelink, scanloc, seiscomp-tools
The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/10
Do you want install seiscomp-tools (gempa-checkSCconfig) ? [Y/n]: y
CHECKSUM [✓] seiscomp-tools 2026.175 8.59k/8.59k 00:00
ACCESS [✓] 1/1 00:00
CHANGELOG [✓] 1/1 00:00
CHECKGPG [✓] 1/1 00:00
INSTALL [✓] seiscomp-tools 2026.175 3/3 00:00
1/1 packages have been installed:
seiscomp-tools (2026.175) to /home/sysop/seiscomp: 3 file(s), 41.0 KiB
Workflow: Downgrade Release¶
Downgrade SeisComP release (only >= SeisComP 4)
./gsm do-release-downgrade
INSTALL [✓] core.db 17119/17119 00:01
Please downgrade releases only if you know what you are doing
Depending on the release, additional steps may be required, e.g.:
* Lower the database schema version
* Install additional modules which functionality is part of the newer SeisComP release
* Install required dependencies
If your SeisComP installation is not under version control, we recommend to make a backup before continuing.
Do you want to continue? [y/N]: y
BACKUP [✓] gsm 16/16 00:00
INFO The gsm backup has been saved under /home/sysop/install/gsm/.restore/gsm.tar.gz
Select a number from the list to choose the release:
1: 7
Downgrade to Option: 1
Do you want to continue? [y/N]: y
ACCESS [✓] 4/4 00:00
CHECKSUM [✓] seiscomp-tools 2026.175 8.59k/8.59k 00:00
CHECKSUM [✓] seiscomp 7.3.1 71.3M/71.3M 00:00
CHECKSUM [✓] quakelink 2026.212 15.7M/15.7M 00:00
CHECKSUM [✓] scanloc 2026.204 13.9M/13.9M 00:00
REMOVE [✓] 4/4 00:00
ACCESS [✓] 4/4 00:00
CHANGELOG [✓] 4/4 00:00
CHECKGPG [✓] 4/4 00:00
INSTALL [✓] quakelink 2026.212 335/335 00:00
INSTALL [✓] quakelink license 2/2 00:00
INSTALL [✓] scanloc 2026.204 282/282 00:00
INSTALL [✓] scanloc license 2/2 00:00
INSTALL [✓] seiscomp 7.3.1 2400/2400 00:00
INSTALL [✓] seiscomp-tools 2026.175 3/3 00:00
4/4 packages have been installed:
quakelink (2026.212) to /home/sysop/seiscomp: 335 file(s) (+2 License files), 26.6 MiB
scanloc (2026.204) to /home/sysop/seiscomp: 282 file(s) (+2 License files), 19.9 MiB
seiscomp (7.3.1) to /home/sysop/seiscomp: 2400 file(s), 171.1 MiB
seiscomp-tools (2026.175) to /home/sysop/seiscomp: 3 file(s), 41.0 KiB
Dependency name Package name Install script
----------------- -------------- ----------------------------
base seiscomp install-base.sh
fdsnws seiscomp install-fdsnws.sh
gui seiscomp install-gui.sh
iloc seiscomp install-iloc.sh
mariadb-server seiscomp install-mariadb-server.sh
postgresql-server seiscomp install-postgresql-server.sh
No further dependencies need to be installed for: quakelink, scanloc, seiscomp-tools
The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/10
Workflow: Switch OS¶
If the operating system is upgraded by a major version (e.g. Ubuntu 22 to 24), the packages have to be changed as well.
./gsm switch-os
INSTALL [✓] core.db 17119/17119 00:01
If your SeisComP installation is not under version control, we recommend making a backup before continuing.
Do you want to continue? [y/N]: y
BACKUP [✓] gsm 16/16 00:00
INFO The gsm backup has been saved under /home/sysop/install/gsm/.restore/gsm.tar.gz
Select a number from the list to choose the operating systems:
1: debian
2: rhel
3: ubuntu
Upgrade to Option (2):
Select a number from the list to choose the versions:
1: 10
2: 8
3: 9
Upgrade to Option (1):
Select a number from the list to choose the architectures:
1: x86_64
2: aarch64
Upgrade to Option (1):
Do you want to continue with the switch to OS: rhel/10 (x86_64) ? [y/N]: y
ACCESS [✓] 4/4 00:00
CHECKSUM [✓] seiscomp-tools 2026.175 8.59k/8.59k 00:00
CHECKSUM [✓] seiscomp 7.3.1 71.3M/71.3M 00:00
CHECKSUM [✓] quakelink 2026.212 15.7M/15.7M 00:00
CHECKSUM [✓] scanloc 2026.204 13.9M/13.9M 00:00
REMOVE [✓] 4/4 00:00
ACCESS [✓] 4/4 00:00
CHANGELOG [✓] 4/4 00:00
CHECKGPG [✓] 4/4 00:00
INSTALL [✓] quakelink 2026.212 335/335 00:00
INSTALL [✓] quakelink license 2/2 00:00
INSTALL [✓] scanloc 2026.204 282/282 00:00
INSTALL [✓] scanloc license 2/2 00:00
INSTALL [✓] seiscomp 7.3.1 2400/2400 00:00
INSTALL [✓] seiscomp-tools 2026.175 3/3 00:00
4/4 packages have been installed:
quakelink (2026.212) to /home/sysop/seiscomp: 335 file(s) (+2 License files), 26.6 MiB
scanloc (2026.204) to /home/sysop/seiscomp: 282 file(s) (+2 License files), 19.9 MiB
seiscomp (7.3.1) to /home/sysop/seiscomp: 2400 file(s), 171.1 MiB
seiscomp-tools (2026.175) to /home/sysop/seiscomp: 3 file(s), 41.0 KiB
Dependency name Package name Install script
----------------- -------------- ----------------------------
base seiscomp install-base.sh
fdsnws seiscomp install-fdsnws.sh
gui seiscomp install-gui.sh
iloc seiscomp install-iloc.sh
mariadb-server seiscomp install-mariadb-server.sh
postgresql-server seiscomp install-postgresql-server.sh
No further dependencies need to be installed for: quakelink, scanloc, seiscomp-tools
The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/10
Skip the selection prompts by specifying the target OS/version/arch directly
with --to:
./gsm switch-os --to rhel/9/x86_64
INSTALL [✓] core.db 17161/17161 00:01
If your SeisComP installation is not under version control, we recommend making a backup before continuing.
Do you want to continue? [y/N]: y
BACKUP [✓] gsm 16/16 00:00
INFO The gsm backup has been saved under /home/ralph/devel/gsm/.restore/gsm.tar.gz
Do you want to continue with the switch to OS: rhel/9 (x86_64) ? [y/N]: y
ACCESS [✓] 4/4 00:00
CHECKSUM [✓] seiscomp-tools 2026.175 8.59k/8.59k 00:00
CHECKSUM [✓] seiscomp 7.3.1 70.8M/70.8M 00:00
CHECKSUM [✓] quakelink 2026.212 15.6M/15.6M 00:00
CHECKSUM [✓] scanloc 2026.216 13.9M/13.9M 00:00
REMOVE [✓] 4/4 00:00
ACCESS [✓] 4/4 00:00
CHECKSUM [✓] quakelink 2026.212 15.6M/15.6M 00:00
CHECKSUM [✓] scanloc 2026.216 13.9M/13.9M 00:00
CHECKSUM [✓] seiscomp 7.3.1 70.8M/70.8M 00:00
CHECKSUM [✓] seiscomp-tools 2026.175 8.59k/8.59k 00:00
CHANGELOG [✓] 4/4 00:00
CHECKGPG [✓] 4/4 00:00
INSTALL [✓] quakelink 2026.212 335/335 00:00
INSTALL [✓] quakelink license 2/2 00:00
INSTALL [✓] scanloc 2026.216 282/282 00:00
INSTALL [✓] scanloc license 2/2 00:00
INSTALL [✓] seiscomp 7.3.1 2400/2400 00:00
INSTALL [✓] seiscomp-tools 2026.175 3/3 00:00
4/4 packages have been installed:
quakelink (2026.212) to /home/ralph/seiscomp: 335 file(s) (+2 License files), 26.8 MiB
scanloc (2026.216) to /home/ralph/seiscomp: 282 file(s) (+2 License files), 19.9 MiB
seiscomp (7.3.1) to /home/ralph/seiscomp: 2400 file(s), 171.0 MiB
seiscomp-tools (2026.175) to /home/ralph/seiscomp: 3 file(s), 41.0 KiB
Dependency name Package name Install script
----------------- -------------- ----------------------------
base seiscomp install-base.sh
fdsnws seiscomp install-fdsnws.sh
gui seiscomp install-gui.sh
iloc seiscomp install-iloc.sh
mariadb-server seiscomp install-mariadb-server.sh
mysql-server seiscomp install-mysql-server.sh
postgresql-server seiscomp install-postgresql-server.sh
No further dependencies need to be installed for: quakelink, scanloc, seiscomp-tools
The scripts are located under: /home/ralph/seiscomp/share/deps/rhel/9
The arch segment of --to is optional; if omitted, switch-os still
asks for it interactively. See Command-Line Options for the full --to
reference, which also covers do-release-upgrade/do-release-downgrade.