.. _sec-upgrade: Workflow: Upgrade Release ========================= Upgrade SeisComP release .. code-block:: sh ./gsm do-release-upgrade .. code-block:: text 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 `Upgrading SeisComP `_. .. _sec-downgrade: Workflow: Downgrade Release =========================== Downgrade SeisComP release (only >= SeisComP 4) .. code-block:: sh ./gsm do-release-downgrade .. code-block:: text 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 .. _sec-switch-os: 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. .. code-block:: sh ./gsm switch-os .. code-block:: text 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``: .. code-block:: sh ./gsm switch-os --to rhel/9/x86_64 .. code-block:: text 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 :ref:`sec-options` for the full ``--to`` reference, which also covers ``do-release-upgrade``/``do-release-downgrade``.