.. _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 [module1] [module2] ... A command is required, only :option:`-h` and :option:`-V` work without one. Read the command-line help for the full list of commands and command-line parameters .. code-block:: sh ./gsm -h The entries of a single command are shown by .. code-block:: sh ./gsm -h commands install alias ----- **Syntax:** gsm alias create|remove name Manage gsm aliases. Aliases allow users to manage any number of installations using a single gsm instance. A new alias can be created as follows: .. code-block:: sh ./gsm alias create toast .. code-block:: text ==================================================================== Package manager setup ==================================================================== This initializes the configuration of your package manager. If you already made adjustments to the configuration file then your current settings will be suggested as default values and may be confirmed simply by pressing enter. The configuration file is only written after the setup is completed entirely. SeisComP release [7]: 7 Operating system [rhel]: rhel Operating system version [10]: 10 System architecture [x86_64]: x86_64 Do you want to use your private repository with gempa modules? Otherwise use the public SeisComP without gempa modules. [Y/n]: y Username [xxx]: xxx Password [xxx]: xxx Repository URL [https://data.gempa.de/packages/xxx]: https://data.gempa.de/packages/xxx Download dir [/home/sysop/install/gsm/packages]: /home/sysop/install/gsm/packages Install path [/home/sysop/seiscomp-toast]: /home/sysop/seiscomp-toast Data path [/home/data]: /home/data Number of days before the license expires message is displayed: [30]: 30 Do you want to validate the downloaded packages using gnupg?: [Y/n]: n Do you want to backup the downloaded packages: [y/N]: n Would you like to create a link to /home/sysop/.local/bin: [y/N]: y The alias toast (gsm-toast) was created. .. code-block:: sh ./gsm alias remove toast .. code-block:: text Do you really want to remove the alias toast (gsm-toast)? [y/N]: y check ----- **Syntax:** gsm check signature module1 [module2 ... moduleN] Checks the GPG signature for packages .. code-block:: sh ./gsm check signature seiscomp .. code-block:: text INFO Verification successfully for file '/home/sysop/install/gsm/var/packages/seiscomp-7.3.1-rhel-10-x86_64.tar.gz'. clean ----- **Syntax:** gsm clean dbcache|packages|backup|restore|all Exactly one target is required. Delete the sync folder .. code-block:: sh ./gsm clean dbcache .. code-block:: text CLEAN dbcache ... OK: disk space saved: (/home/sysop/install/gsm/var/sync, 6.5 MiB) Delete all downloaded files .. code-block:: sh ./gsm clean packages .. code-block:: text CLEAN packages ... OK: disk space saved: (/home/sysop/install/gsm/var/packages, 13.8 GiB) Delete all backup files .. code-block:: sh ./gsm clean backup .. code-block:: text CLEAN backup ... OK: disk space saved: (/home/data/gsm/backup, 18.3 GiB) Delete all restore files .. code-block:: sh ./gsm clean restore .. code-block:: text CLEAN restore ... OK: disk space saved: (/home/sysop/install/gsm/.restore, 0 Bytes) Delete dbcache + packages .. code-block:: sh ./gsm clean all .. code-block:: text CLEAN dbcache ... OK: disk space saved: (/home/sysop/install/gsm/var/sync, 6.5 MiB) CLEAN packages ... OK: disk space saved: (/home/sysop/install/gsm/var/packages, 13.8 GiB) do-release-upgrade ------------------ See :ref:`sec-upgrade` do-release-downgrade -------------------- See :ref:`sec-downgrade` hold ---- **Syntax:** gsm hold [module1 module2 ... moduleN] | gsm hold files [file1 ... fileN] 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:: text INFO Set package seiscomp on hold Add files to hold .. code-block:: sh ./gsm hold files ~/seiscomp/etc/global.cfg .. code-block:: text INFO Set file /home/sysop/seiscomp/etc/global.cfg on hold info ---- **Syntax:** gsm info [short] [deps] [module1 module2 ... moduleN] Show installed modules .. code-block:: sh ./gsm info .. code-block:: text OS: rhel/10 (x86_64) Install path: /home/sysop/seiscomp Package DB path: /home/sysop/install/gsm/local Installed packages Version Valid until Updates until Install date ------------------ -------- ----------- ------------- ------------------- gsm 1.7.3 None None N/A quakelink 2026.212 2027-01-01 2027-01-01 2026-08-05 07:18:17 scanloc 2026.204 2027-01-01 2027-01-01 2026-08-05 06:16:57 seiscomp 7.3.1 None None 2026-08-05 07:18:51 seiscomp-tools 2026.175 None None 2026-08-05 06:16:58 world-6 1.3 None None 2026-07-24 07:19:22 Show installed modules (only package names) .. code-block:: sh ./gsm info short .. code-block:: text OS: rhel/10 (x86_64) Install path: /home/sysop/seiscomp Package DB path: /home/sysop/install/gsm/local Installed packages: quakelink scanloc seiscomp seiscomp-tools world-6 Show detailed information about an installed module .. code-block:: sh ./gsm info seiscomp .. code-block:: text seiscomp ---------- Release : 7 Version : 7.3.1 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-7.3.1-rhel-10-x86_64.tar.gz Download size : 71.3 MiB Installed size : 171.1 MiB SHA256 : 65dbc6dec5fd9ce09daea9102ba154a14e3d356cd155c41e7fafb135fb2a463d Build date : 2026-07-30 12:24:51 UTC Package type : app Install date : 2026-08-05 07:18:51 UTC Show all available dependencies (only installed modules) .. code-block:: sh ./gsm info deps seiscomp .. code-block:: text 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 The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/10 install ------- **Syntax:** gsm install [licenses] [module1 module2 ... moduleN] Install or update packages. To install a specific version 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:: text ACCESS [✓] 1/1 00:00 CHECKSUM [✓] seiscomp 7.3.1 71.3M/71.3M 00:00 CHANGELOG [✓] 1/1 00:00 CHECKGPG [✓] 1/1 00:00 INSTALL seiscomp Do you want to continue? [Y/n]: y INSTALL [✓] seiscomp 7.3.1 2400/2400 00:00 1/1 packages have been installed: seiscomp (7.3.1) to /home/sysop/seiscomp: 2400 file(s), 171.1 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 postgresql-server seiscomp install-postgresql-server.sh The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/10 Install or update the licenses .. code-block:: sh ./gsm install licenses scanloc .. code-block:: text INSTALL [✓] scanloc license 2/2 00:00 localinstall ------------ **Syntax:** gsm localinstall file1 [file2 ... fileN] Install packages from local files instead of the repository. The package description file (:file:`.dsc`) is expected next to the archive. Packages built for another release, operating system or architecture are skipped. Use :option:`-f` to install a version older than the installed one. .. code-block:: sh ./gsm localinstall var/packages/quakelink-2026.212-seiscomp-7-rhel-10-x86_64.tar.gz .. code-block:: text CHECKSUM [✓] quakelink 2026.212 15.7M/15.7M 00:00 CHANGELOG [✓] 1/1 00:00 CHECKGPG [✓] 1/1 00:00 INSTALL quakelink Do you want to continue? [Y/n]: y INSTALL [✓] quakelink 2026.212 335/335 00:00 INSTALL [✓] quakelink license 2/2 00:00 1/1 packages have been installed: quakelink (2026.212) to /home/sysop/seiscomp: 335 file(s) (+2 License files), 26.6 MiB No further dependencies need to be installed for: quakelink migrate ------- **Syntax:** gsm migrate Update config schema .. code-block:: sh ./gsm migrate .. code-block:: text Running Migration step 0.1 --> 0.2 print ----- **Syntax:** gsm print nagios crontab|output Print GSM Nagios crontab entry / Print nagios output .. code-block:: sh ./gsm print nagios crontab .. code-block:: text 20 5 * * * /home/sysop/install/gsm/gsm sync .. code-block:: sh ./gsm print nagios output .. code-block:: text gsm_updates (gsm) All packages are up to date | updates=0;;;; .. code-block:: text gsm_updates (gsm) 1 updates available: seiscomp | updates=1;;;; **Syntax:** gsm print env Print the shell tab-completion setup hint .. code-block:: sh ./gsm print env .. code-block:: text To enable tab completion for './gsm', add this line to your ~/.bashrc: source "/home/sysop/install/gsm/share/shell-completion/gsm.bash" Then reload it once with: source ~/.bashrc reinstall --------- **Syntax:** gsm reinstall [module1 module2 ... moduleN] args Reinstall packages. If no module name is provided, all installed modules will be reinstalled. .. code-block:: sh ./gsm reinstall seiscomp .. code-block:: text ACCESS [✓] 1/1 00:00 CHECKSUM [✓] seiscomp 7.3.1 71.3M/71.3M 00:00 CHANGELOG [✓] 1/1 00:00 CHECKGPG [✓] 1/1 00:00 INSTALL seiscomp=7.3.1 Do you want to continue? [Y/n]: y INSTALL [✓] seiscomp 7.3.1 2400/2400 00:00 1/1 packages have been installed: seiscomp (7.3.1) to /home/sysop/seiscomp: 2400 file(s), 171.1 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 postgresql-server seiscomp install-postgresql-server.sh The scripts are located under: /home/sysop/seiscomp/share/deps/rhel/10 remove ------ **Syntax:** gsm remove [module1 module2 ... moduleN] Uninstall packages. If no module is provided, all installed packages are selected; the gsm package itself is always kept. .. warning:: Together with :option:`-y` the confirmation is skipped, so ``./gsm remove -y`` uninstalls every package without asking. .. code-block:: sh ./gsm remove seiscomp .. code-block:: text REMOVE seiscomp Do you want to continue? [y/N]: y REMOVE [✓] 1/1 00:00 1/1 packages have been removed: seiscomp (7.3.0) from /home/sysop/seiscomp: 2420 file(s), 171.1 MiB search ------ **Syntax:** gsm search pattern1 [pattern2 ... patternN] Search the package list for a regex pattern .. code-block:: sh ./gsm search scan .. code-block:: text scanloc - Local earthquake monitoring based on clustering and P and S phase picks (commercial) .. code-block:: sh ./gsm search evaluation .. code-block:: text 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 ----- **Syntax:** gsm setup [options] Run initial setup (required when using for the first time). With :option:`-y` the setup runs non-interactively and takes all values from the command-line parameters, see ``./gsm -h setup``. See :ref:`sec-setup` show ---- **Syntax:** gsm show [subcommand] [module1 module2 ... moduleN] Show all available packages .. code-block:: sh ./gsm show .. code-block:: text 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 the latest package of single modules .. code-block:: sh ./gsm show seiscomp scanloc Show all packages available in your own repository (not available in offline mode) .. code-block:: sh ./gsm show own .. code-block:: text 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:: text 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, optionally for another distribution or, with ``all``, for every operating system .. code-block:: sh ./gsm show releases .. code-block:: text SeisComP releases: nightly 6* 5 4 Show module changelog .. code-block:: sh ./gsm show changelog seiscomp .. code-block:: text # Change Log All notable changes to SeisComP are documented here. ## 7.3.1 ... ... Press any button to continue or (Ctrl+C) to cancel... Show all packages on hold .. code-block:: sh ./gsm show hold .. code-block:: text Packages on hold: seiscomp (7.3.1) Show possible updates .. code-block:: sh ./gsm show updates .. code-block:: text The following packages can be updated: scanloc (2026.203) --> 2026.204 Show history .. code-block:: sh ./gsm show history seiscomp .. code-block:: text 2026-03-24 07:45:56 - seiscomp was deinstalled in version 7.2.1 checksum: 5ec7c18584636a5184307faf1ac307613dec9cfff412b53f98a9f2f31419115d download_size: 74579316 build_date: 2026-03-12 09:57:54 file_name: seiscomp-7.2.1-rhel-10-x86_64.tar.gz 2026-03-24 07:46:02 - seiscomp was installed in version nightly checksum: e5574eb839885b5a5214ace3e05dbfa65937af8473fa800400e29930e6c8c103 download_size: 74627794 build_date: 2026-03-20 23:43:27 Press any button to continue or (Ctrl+C) to cancel...Interrupted (Ctrl+C) switch-os --------- See :ref:`sec-switch-os` sync ---- **Syntax:** gsm sync Synchronize the package index from the source repo .. code-block:: sh ./gsm sync .. code-block:: text GET [✓] core.db 3.59M/3.59M 00:00 INSTALL [✓] core.db 17119/17119 00:01 unhold ------ **Syntax:** gsm unhold [module1 module2 ... moduleN] | gsm unhold files [file1 ... fileN] Remove packages from hold .. code-block:: sh ./gsm unhold seiscomp .. code-block:: text INFO The package seiscomp was removed from hold Remove files from hold .. code-block:: sh ./gsm unhold files ~/seiscomp/etc/global.cfg .. code-block:: text INFO The file /home/sysop/seiscomp/etc/global.cfg was removed from hold update ------ **Syntax:** gsm update Synchronize the package index from the source repository and show possible updates .. code-block:: sh ./gsm update .. code-block:: text INSTALL [✓] core.db 17119/17119 00:01 The following packages can be updated: seiscomp (7.3.0) --> 7.3.1 Do you want to install packages which can be updated? [y/N]: y ACCESS [✓] 1/1 00:00 GET [✓] seiscomp 7.3.1 71.3M/71.3M 00:02 CHECKSUM [✓] seiscomp 7.3.1 71.3M/71.3M 00:00 CHANGELOG [✓] 1/1 00:00 CHECKGPG [✓] 1/1 00:00 UPDATE [✓] seiscomp 7.3.1 2400/2400 00:00 1/1 packages have been updated: seiscomp (7.3.1) to /home/sysop/seiscomp: 2400 file(s), 171.1 MiB