.. _sec-offline:

Workflow: Offline
=================

Please **ignore** the offline workflow if your target machine has internet access!

Sometimes a user or an organization has the requirement that downloaded packages be virus-checked before installation,
or that the actual installation be done on a machine without internet access.
We here describe a basic offline workflow using gsm (gempa software manager) enabling this.
Note that on some systems, the command `gsm` has to be replaced by `./gsm`.
Replace the exemplary packages *seiscomp* and *tools* by your actual packages.


First time
----------

On **online** machine

Download and install the gsm as described in :ref:`sec-inst`.

Install required |scname| or |gempa| packages in **download-only mode**, e.g.:

.. code-block:: sh

   ./gsm install -d seiscomp


On **offline** machine

.. code-block:: sh

   cd ~
   mkdir install
   cd ~/install


Copy gsm directory from **online** machine

.. code-block:: sh

   scp -r user1@online-machine:~/install/gsm user2@offline-machine:~/install


Install required packages in **offline mode**

.. code-block:: sh

   ./gsm install -o seiscomp


Subsequent times
----------------

On **online** machine

Go to gsm directory:

.. code-block:: sh

   cd ~/install/gsm


Remove files in packages directory to reduce virus-checking effort:

.. code-block:: sh

   ./gsm clean packages


Perform update via gempa repository:

.. code-block:: sh

   ./gsm update


Install required packages in **download-only mode**, e.g.:

.. code-block:: sh

   ./gsm install -d seiscomp


On **offline** machine

Go to gsm directory:

.. code-block:: sh

   cd ~/install/gsm


Clean *sync* and *packages* directories:

.. code-block:: sh

   ./gsm clean all


Copy directories `gsm/sync` and `gsm/packages` from online machine to offline machine using memory stick or scp


Install latest version of gsm (don't force reinstall if already latest):

.. code-block:: sh

   ./gsm install -o gsm


Install new versions of all previously installed packages in **offline mode**:

.. code-block:: sh

   ./gsm install -o