.. _sec-commands: Commands ======== You may run :program:`gsm` with commands and additional command-line parameters. This section describes the commands. Parameters are listed in section :ref:`sec-options`. The general syntax is .. code-block:: sh ./gsm [options] [command] Read the command-line help for the full list of commands and command-line parameters .. code-block:: sh ./gsm -h check ----- **Syntax:** gsm check signature [module1...moduleN] args Checks the gpg signature for a package(s) .. code-block:: sh ./gsm check signature seiscomp .. code-block:: sh INFO : Verification successfully for file '/home/sysop/install/gsm/packages/seiscomp-6.7.9-rhel-9-x86_64.tar.gz'. clean ----- **Syntax:** gsm clean args Delete the sync folder .. code-block:: sh ./gsm clean dbcache .. code-block:: sh CLEAN : dbcache ... OK: disk space saved: (/home/sysop/install/gsm/sync, 6.5 MiB) Delete all downloaded files .. code-block:: sh ./gsm clean packages .. code-block:: sh CLEAN : packages ... OK: disk space saved: (/home/sysop/install/gsm/packages, 13.8 GiB Delete all backup files .. code-block:: sh ./gsm clean backup .. code-block:: sh CLEAN : backup ... OK: disk space saved: (/home/data/gsm/backup, 18.3 GiB Delete dbcache + packages .. code-block:: sh ./gsm clean all .. code-block:: sh CLEAN : dbcache ... OK: disk space saved: (/home/sysop/install/gsm/sync, 6.5 MiB) CLEAN : packages ... OK: disk space saved: (/home/sysop/install/gsm/packages, 13.8 GiB do-release-upgrade ------------------ See :ref:`sec-upgrade` do-release-downgrade -------------------- See :ref:`sec-downgrade` hold ---- **Syntax:** gsm hold [module1...moduleN] Sometimes it is useful to keep the version of a package fixed. This can be done by setting the package to *hold*. Add packages to hold .. code-block:: sh ./gsm hold seiscomp .. code-block:: sh INFO : Set package seiscomp on hold Add files to hold .. code-block:: sh ./gsm hold files ~/seiscomp/etc/global.cfg .. code-block:: sh INFO : Set file /home/sysop/seiscomp/etc/global.cfg on hold info ---- **Syntax:** gsm info [module1...moduleN] args Show installed modules .. code-block:: sh ./gsm info .. code-block:: sh OS: rhel/9 (x86_64) Install path: /home/sysop/seiscomp Package DB path: /home/sysop/install/gsm/local Installed packages Version Valid until Updates until ------------------ ------- ----------- ------------- gsm 1.6.7 None None seiscomp 6.7.9 None None Show installed modules (only package names) .. code-block:: sh ./gsm info short .. code-block:: sh OS: rhel/9 (x86_64) Install path: /home/sysop/seiscomp Package DB path: /home/sysop/install/gsm/local Installed packages: seiscomp Show detailed information about an installed module .. code-block:: sh ./gsm info seiscomp .. code-block:: sh seiscomp ---------- Release : 6 Version : 6.7.9 Documentation : https://docs.gempa.de/seiscomp/current Architecture : x86_64 Licenses : None Description : SeisComP including data acquisition, processing, distribution and interactive analysis, version >=4.0.0 (public) Filename : seiscomp-6.7.9-rhel-9-x86_64.tar.gz Download size : 62.3 MiB Installed size : 196.8 MiB SHA256 : 2d1ef42fe1ebe80e193f1216c8f2b311fdc8b610beaf12380dfc336d303f7833 Build date : 2025-07-04 07:43:04 UTC Package type : app Install date : 2025-07-14 06:19:28 UTC Show all available dependencies (only installed modules) .. code-block:: sh ./gsm info deps seiscomp .. code-block:: sh 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 The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/9 install ------- **Syntax:** gsm install [module1...moduleN] args Install or update packages. To install a specific package run, e.g.,install gds=2019.287. If no module is provided, all installed modules will be updated. .. code-block:: sh ./gsm install seiscomp .. code-block:: sh CHECKING [✓] : ACCESS (1/1) : 100%|########################################| 1/1 [00:00<00:00, 5.57it/s] GET [✓] : seiscomp 6.7.9 : 100%|########################################| 62.3M/62.3M [00:02<00:00, 32.0MB/s] CHECKSUM [✓] : seiscomp 6.7.9 : 100%|########################################| 62.3M/62.3M [00:00<00:00, 343MB/s] CHECKING [✓] : CHANGELOG (1/1) : 100%|########################################| 1/1 [00:00<00:00, 4.03it/s] INSTALL : seiscomp Do you want to continue? [Y/n]: y INSTALL [✓] : seiscomp 6.7.9 : 100%|########################################| 2793/2793 [00:01<00:00, 2333.30it/s] 1/1 packages have been installed: seiscomp (6.7.9) to /home/sysop/seiscomp: 2535 file(s), 196.8 MiB 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 The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/9 Install or update the licenses .. code-block:: sh ./gsm install licenses scanloc .. code-block:: sh GET [✓] : scanloc.crt : 100%|###############################| 15.8k/15.8k [00:00<00:00, 11.5MB/s] GET [✓] : scanloc-license.txt : 100%|###############################| 10.4k/10.4k [00:00<00:00, 8.07MB/s] INSTALL [✓] : scanloc license : 100%|###############################| 2/2 [00:00<00:00, 567.41it/s] migrate ------- Update config schema .. code-block:: sh ./gsm migrate .. code-block:: sh Running Migration step 0.1 --> 0.2 reinstall --------- **Syntax:** gsm reinstall [module1...moduleN] args Reinstall packages. If no module is provided, all installed modules will be reinstalled. .. code-block:: sh ./gsm reinstall seiscomp .. code-block:: sh CHECKING [✓] : ACCESS (1/1) : 100%|##################################| 1/1 [00:00<00:00, 5.45it/s] CHECKSUM [✓] : seiscomp 6.7.9 : 100%|##################################| 62.3M/62.3M [00:00<00:00, 354MB/s] CHECKING [✓] : CHANGELOG (1/1) : 100%|##################################| 1/1 [00:00<00:00, 4.40it/s] INSTALL : seiscomp=6.7.9 Do you want to continue? [Y/n]: y INSTALL [✓] : seiscomp 6.7.9 : 100%|##################################| 2793/2793 [00:01<00:00, 2312.00it/s] 1/1 packages have been installed: seiscomp (6.7.9) to /home/sysop/seiscomp: 2535 file(s), 196.8 MiB 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 The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/9 remove ------ **Syntax:** gsm remove [module1...moduleN] args Uninstall packages .. code-block:: sh ./gsm remove seiscomp .. code-block:: sh REMOVE : seiscomp Do you want to continue? [y/N]: y REMOVE [✓] : DONE (1/1) : 100%|########################################| 1/1 [00:00<00:00, 7.98it/s] 1/1 packages have been removed: seiscomp (6.7.9) from /home/sysop/seiscomp: 2559 file(s), 196.8 MiB search ------ **Syntax:** gsm search arg Search the package list for a regex pattern .. code-block:: sh ./gsm search scan .. code-block:: sh scanloc - Local earthquake monitoring based on clustering and P and S phase picks (commercial) .. code-block:: sh ./gsm search evaluation .. code-block:: sh gaps-frontends-all - Web frontends for GAPS server including OriginLocatorView (commercial) kappa - Event classification GUI (commercial) npeval - Seismic network performance evaluation (commercial) sceval - Origin evaluation in real time (commercial setup ----- Run initial setup (required when using for the first time) See :ref:`sec-setup` show ---- **Syntax:** gsm show [module1...moduleN] args Show all availible packages .. code-block:: sh ./gsm show .. code-block:: sh Available packages Description ------------------------ ----------- bathymetry Bathymetry files for TOAST (commercial) caps-dataview CAPS DataView web application featuring 24h plots, spectrograms, spectra, filtered or unfiltered waveforms (commercial) ... caps-plugins Collection of plugins for CAPS (commercial) caps-tools Client tools for CAPS, e.g., capstool or rifftest (commercial) ccloc Event detector based on cross-correlation with template waveforms (commercial) deepc Deep Learning Phase Classifier Plugin, uses TorchScript models to classify picks (commercial) dlbase base package for deep learning packages (public) dlmodels-class Deep Learning classification models (commercial) dlmodels-pick Deep Learning picker models (commercial) dlpick Deep Learning Phase Picker, uses TorchScript models to pick on record streams (commercial) ... seiscomp SeisComP including data acquisition, processing, distribution and interactive analysis, version >=4.0.0 (public) ... Show all packages available in your own repo (not availible in offline mode) .. code-block:: sh ./gsm show own .. code-block:: sh Package URL: https://data.gempa.de/packages/xxx Available packages Description ------------------------ ----------- dlbase base package for deep learning packages (public) elevation GEBCO_2024 global coverage grids (public) gsm gempa Software Management tool (public) scrtdd A module for real-time double difference relocation of events (public) sed-eew Earthquake early warning modules by SED (public) seiscomp SeisComP including data acquisition, processing, distribution and interactive analysis, version >=4.0.0 (public) seiscomp-debug SeisComP including data acquisition, processing, distribution and interactive analysis, version >=4.0.0 (public) seiscomp-tools tools by gempa GmbH for public use Show all public packages .. code-block:: sh ./gsm show public .. code-block:: sh Package URL: https://data.gempa.de/packages/Public Available packages Description ------------------------ ----------- dlbase base package for deep learning packages (public) elevation GEBCO_2024 global coverage grids (public) gsm gempa Software Management tool (public) scrtdd A module for real-time double difference relocation of events (public) sed-eew Earthquake early warning modules by SED (public) seiscomp SeisComP including data acquisition, processing, distribution and interactive analysis, version >=4.0.0 (public) seiscomp-debug SeisComP including data acquisition, processing, distribution and interactive analysis, version >=4.0.0 (public) seiscomp-tools tools by gempa GmbH for public use Show available SeisComP releases .. code-block:: sh ./gsm show releases .. code-block:: sh SeisComP releases: nightly 6* 5 4 Show module changelog .. code-block:: sh ./gsm show seiscomp changelog .. code-block:: sh # Change Log All notable changes to SeisComP are documented here. ## 6.7.9 - trunk - Fix crash if a transfer function is created from a poles and zeros response with either empty poles or empty zeros caused by a certain compiler version and configuration. ... ... Press any button to continue or (Ctrl+C) to cancel.... Show all packages on hold .. code-block:: sh ./gsm show hold .. code-block:: sh Packages on hold: seiscomp (6.7.9) Show possible updates .. code-block:: sh ./gsm show updates .. code-block:: sh The following packages can be updated: seiscomp (6.7.8) --> 6.7.9 switch-os --------- See :ref:`sec-switch-os` sync ---- **Syntax:** gsm sync args Synchronize the package index from the source repo .. code-block:: sh ./gsm sync .. code-block:: sh GET [✓] : core.db : 100%|#############################| 1.81M/1.81M [00:00<00:00, 10.4MB/s] INSTALL [✓] : core.db : 100%|#############################| 9131/9131 [00:00<00:00, 11072.79it/s] unhold ------ **Syntax:** gsm unhold [module1...moduleN] Remove packages from hold .. code-block:: sh ./gsm unhold seiscomp .. code-block:: sh INFO : The package seiscomp was removed from hold Remove files from hold .. code-block:: sh ./gsm unhold files ~/seiscomp/etc/global.cfg .. code-block:: sh INFO : The file /home/sysop/seiscomp/etc/global.cfg was removed from hold update ------ **Syntax:** gsm update args Synchronize the package index from the source repo and show possible updates .. code-block:: sh ./gsm update .. code-block:: sh INSTALL [✓] : core.db : 100%|########################################| 9131/9131 [00:00<00:00, 11407.04it/s] The following packages can be updated: seiscomp (6.7.8) --> 6.7.9 Do you want to install packages which can be updated? [y/N]: y CHECKING [✓] : ACCESS (1/1) : 100%|########################################| 1/1 [00:00<00:00, 5.58it/s] GET [✓] : seiscomp 6.7.9 : 100%|########################################| 62.3M/62.3M [00:02<00:00, 32.0MB/s] CHECKSUM [✓] : seiscomp 6.7.9 : 100%|########################################| 62.3M/62.3M [00:00<00:00, 379MB/s] CHECKING [✓] : CHANGELOG (1/1) : 100%|########################################| 1/1 [00:00<00:00, 4.86it/s] INSTALL [✓] : seiscomp 6.7.9 : 100%|########################################| 2793/2793 [00:01<00:00, 2336.24it/s] 1/1 packages have been installed: seiscomp (6.7.9) to /home/sysop/seiscomp: 2535 file(s), 196.8 MiB