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.

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:

[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