Application Control and Status
--------------------------------

The functioning system is comprised of applications.  Each application has a
name and a version number.  An application may have multiple processes running
within and each process has its own state.



Application Status
...................

.. index:: app;app status

The command **app status** is used to display the status of the system.  
When the command is executed, it requests an up-to-date status of every
application and process, and hence may take a few seconds to return.

A typical app status screen from the command line interface::

    selfservice v19.3.1 (2019-11-13 14:38)
       |-node                  running
    voss-deviceapi v19.3.1 (2019-11-13 14:40)
       |-voss-cnf_collector    running
       |-voss-monitoring       running
       |-voss-queue            running
       |-voss-risapi_collector running
       |-voss-wsgi             running
    cluster v19.3.1 (2019-11-13 14:39)
    template_runner v19.3.1 (2019-11-13 14:42)
    mongodb v19.3.1 (2019-11-13 14:39)
       |-arbiter               running
       |-database              running
    support v19.3.1 (2019-11-13 14:42)
    selenium v19.3.1 (2019-11-13 14:46)
       |-gui_orchestration     running
    platform v19.3.1 (2019-11-13 14:40)
    nginx v19.3.1 (2019-11-13 14:40)
       |-proxy                 running
    services v19.3.1 (2019-11-13 14:41)
       |-wsgi                  running
       |-logs                  running
       |-firewall              running
       |-mount                 running
       |-scheduler             running
       |-syslog                running (completed)
       |-time                  running (completed)
    voss-portal v19.3.1 (2019-11-13 14:48)
       |-gui                   running
    security v19.3.1 (2019-11-13 14:43)
    snmp v19.3.1 (2019-11-13 14:42)
       |-daemon                running (completed)
       |-traps                 running (completed)
    vmware v19.3.1 (2019-11-13 14:42)

Applications can have multiple processes running within it - each with its state displayed.    
The following states are defined:

* ``running`` indicates that the process is running correctly.
* ``completed`` indicates that the process ran to completion successfully.
* ``suspended`` indicates that the process is suspended while waiting for
  another process.
* ``stopped`` indicates that the process is not running. An error message
  indicates that the process stopped for an unexpected reason.
* ``disabled`` indicates that the application is not licensed.