.. _status:

System status
=============

The HemiStereo NX software is shipped as docker images and the runtime is controlled
through the docker daemon. It might happen, that the docker update process of
images or the re-starting of crashed containers does not work as expected. In these
situations, the following commands (from the HemiStereo NX shell) might help
to examine the situation, start or stop faulty containers or file a comprehensive 
support request.


The apps are managed through the *hemistereo-appmanager*, which consists of several
scripts for docker operations. The current status an a short log of the last operations
can be aquired using:

.. code-block:: bash

    sudo hemistereo_apps_list
    sudo hemistereo_apps_status 

For enabling, disabling, starting and stopping apps, the following commands can be used:

.. code-block:: bash

    sudo hemistereo_app_enable <appname>
    sudo hemistereo_app_run <appname>
    sudo hemistereo_app_stop <appname>
    sudo hemistereo_app_disable <appname>

Logs of individual apps can be optained via commandline as well. The options are using
docker commands directly or a hemistereo-wrapper script:

.. code-block:: bash

    sudo hemistereo_app_logs <appname>
    docker logs [-f] <container-name>

The *-f* enables the *follow* mode, which keeps the log output attached to the
container process (live view). The container name is reported by e.g. the status
command.