Installation and Update
=======================


.. _thor-sec-installation:

Installation
------------

**Recommended:** Download and install the package using *gsm*. This is the
simplest and the recommeded way.

#. Get and install gsm ::

      mkdir $HOME/install
      cd $HOME/install
      wget https://data.gempa.de/packages/Public/gsm/gempa-gsm.tar.gz
      tar xvf gempa-gsm.tar.gz
      rm gempa-gsm.tar.gz

#. Initial setup ::

      cd gsm
      ./gsm setup

   Follow the instructions.

#. Installation ::

      ./gsm update
      ./gsm install thor

**Manual installation (not preferred):** Download the package file and unpack it
from the directory above the $SEISCOMP_ROOT directory:

.. code-block:: sh

   cd $SEISCOMP_ROOT/..
   tar xvf <package-file-name>

Both procedures will result in a complete installation. However, *gsm*
remembers the installation. During updates with *gsm* only required files will be
kept while manual installations will eventually result in an accumulation of
old files, e.g. libraries.


Package update
--------------

For updating apply the same procedure as for
:ref:`installation <thor-sec-installation>`. We recommend to use *gsm* for
updating. Old files not required or provided with the new version will be
removed. Additionally restart the modules after installation ::

   gsm update
   seiscomp stop autothor
   gsm install thor
   seiscomp start autothor

.. note::

   * When unpacking using :program:`tar`, any updated module must be stopped
     before unpacking.
   * Stopping and starting of :program:`autothor` is optional.
   * During updates all files provided with the package are overwritten
     including default configurations. User-defined configurations will not be
     changed. In order to keep changes of files also provided by the installation
     package, give different names to the changed files.