How To: Manage InterWorx Services at the CLI
============================================

.. note::

   ``/home/interworx/bin/iworx-ctl`` was introduced in version 8.2.14.

InterWorx consists of three internal services: 

- The internal Apache instance (``iworx-web``)
- The internal PHP-FPM service (which is connected to ``iworx-web``)
- The internal MariaDB instance (``iworxdb``)

These services can be managed at the CLI, using ``/home/interworx/bin/iworx-ctl {action}``, replacing ``{action}`` with the corresponding information. 

This can also be written as ``~iworx/bin/iworx-ctl {action}``.

Users who include InterWorx in their monitoring tools should use ``/home/interworx/bin/iworx-ctl {action}`` instead of ``service iworx {action}`` or ``systemctl {action} iworx``.

.. contents::

To Manage InterWorx
-------------------

This manages InterWorx, as a whole. 

- **Status**: ``/home/interworx/bin/iworx-ctl status``
- **Start**: ``/home/interworx/bin/iworx-ctl start``
- **Stop**: ``/home/interworx/bin/iworx-ctl stop``
- **Restart**: ``/home/interworx/bin/iworx-ctl restart``

Alternately:

- **Status**: ``~iworx/bin/iworx-ctl status``
- **Start**: ``~iworx/bin/iworx-ctl start``
- **Stop**: ``~iworx/bin/iworx-ctl stop``
- **Restart**: ``~iworx/bin/iworx-ctl restart``
  
Example:

.. code-block::

   [root@server ~]# ~iworx/bin/iworx-ctl status
   iworx-web is running...                                    [  OK  ]
   iworxphp82-php-fpm is running...                           [  OK  ]
   iworx-db is running...                                     [  OK  ]
   [root@server ~]#


To Manage the InterWorx Web Service
-----------------------------------

This manages both the internal Apache instance, as well as the internal PHP-FPM service. 

- **Start**: ``/home/interworx/bin/iworx-ctl startweb``
- **Stop**: ``/home/interworx/bin/iworx-ctl stopweb``
- **Restart**: ``/home/interworx/bin/iworx-ctl restartweb``

Alternately:

- **Start**: ``~iworx/bin/iworx-ctl startweb``
- **Stop**: ``~iworx/bin/iworx-ctl stopweb``
- **Restart**: ``~iworx/bin/iworx-ctl restartweb``

To Manage the InterWorx Database Service
----------------------------------------

This manages the internal MariaDB instance. 

- **Start**: ``/home/interworx/bin/iworx-ctl startdb``
- **Stop**: ``/home/interworx/bin/iworx-ctl stopdb``
- **Restart**: ``/home/interworx/bin/iworx-ctl restartdb``
  
Alternately:

- **Start**: ``~iworx/bin/iworx-ctl startdb``
- **Stop**: ``~iworx/bin/iworx-ctl stopdb``
- **Restart**: ``~iworx/bin/iworx-ctl restartdb``