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::

  platform@VOSS:~$ app status
  cluster v24.2.0 (2024-11-25 15:34)
  insights-api v24.2.0 (2024-11-25 15:35)
     |-api                   running
  insights-voss-sync v24.2.0 (2024-11-25 15:38)
     |-full-sync             disabled
     |-real-time             running (completed)
     |-database              running (healthy)
     |-delta-sync            scheduled
     |-full-transaction      scheduled
     |-multivendor           scheduled
  license-service v24.2.0 (2024-11-25 15:25)
     |-license-service       running (healthy)
  mongo-upgrade v0.0.0
  mongodb v24.2.0 (2024-11-25 15:36)
     |-arbiter               running
     |-database              running
  nginx v24.2.0 (2024-11-25 15:36)
     |-proxy                 running
  platform v24.2.0 (2024-11-25 15:37)
  security v24.2.0 (2024-11-25 15:37)
  selenium v24.2.0 (2024-11-25 15:37)
     |-gui_orchestration     running
  selfservice v24.2.0 (2024-11-25 15:26)
     |-node                  running
  services v24.2.0 (2024-11-25 15:37)
     |-logs                  running
     |-scheduler             running
     |-mount                 running
     |-wsgi                  running
     |-syslog                running (completed)
     |-time                  running (completed)
     |-firewall              running (completed)
  snmp v24.2.0 (2024-11-25 15:37)
     |-daemon                running (completed)
     |-traps                 running (completed)
  support v24.2.0 (2024-11-25 15:37)
  template_runner v24.2.0 (2024-11-25 15:37)
  vmware v24.2.0 (2024-11-25 15:37)
  voss-deviceapi v24.2.0 (2024-11-25 15:40)
     |-voss-cnf_collector    running
     |-voss-risapi_collector running
     |-voss-monitoring       running
     |-voss-queue            running
     |-voss-wsgi             running
  voss-portal v24.2.0 (2024-11-25 15:30)
     |-gui                   running



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 by default disabled or is not licensed.
* ``scheduled`` indicates that the application is scheduled to run.