Embedthis Appweb 3.4.0
Home > Users Guide > Running as a System Service

Quick Nav

See Also

Running as a System Service or Daemon

After installation, Appweb is started automatically as a system service or daemon. You can change this behavior and only start Appweb manually if you wish.

This page gives platform-specific information about starting and stopping the Appweb service.

Windows Instructions

On Windows, Appweb is managed by two programs:

The Appweb Angel is a guardian over Appweb. It is a windows service that starts, manages and restarts Appweb. If Appweb fails, the Angel will automatically restart it.

Windows services run in the background with little interaction with the user. So to provide more convenient access to manage Appweb, the Appweb Monitor program runs and is accessible from the windows system tray (taskbar notification area). You can start and stop Appweb using either the Angel or Monitor programs.

Appweb Angel Service

You can interface with the Angel via the Windows Services Applet. To invoke the applet, select:

Start -> Control Panel -> Administrative Tools -> Services

Then select and double click on the Embedthis Appweb service. A dialog panel will be displayed from which you can start and stop the AppwebAngel process.

When started or stopped, the Angel will first do the same operation on the real Appweb instance. Pausing the Angel will have no effect on Appweb, but will pause the Angel itself.

Removing Appweb as a Service

To permanently stop Appweb running as a Windows Service either remove the software or uninstall the Angel via the following command:

appwebAngel --uninstall

To re-instate the Angel as a Windows Service, run the following command:

appwebAngel --install

Once installed, you will need to start the service via the Services control applet.

Appweb Monitor

The Windows Appweb Monitor is launched when you log in. It a quick and easy way to start, stop and restart Appweb. You can also launch a browser to display the documentation or the Appweb management console (future feature).

When you select stop Appweb, you actually stop the Angel process which in turn stops Appweb. Similarly, when you select start Appweb, you are really starting the Angel which detects that Appweb is not running and automatically launches it.

Linux Instructions

To stop Appweb running as a Daemon, on a Red Hat / Fedora system run the following command:

/sbin/service appweb stop

To re-start Appweb to run as a daemon, run the following command:

/sbin/service appweb start

On a Debian (Ubuntu) based system, run the following commands

/sbin/invoke-rc.d appweb start
/sbin/invoke-rc.d appweb stop

Removing Appweb as a Daemon

To permanently remove Appweb from running as a Daemon on a Red Hat / Fedora system, run the following command:

/sbin/chkconfig --del appweb 

To reinstall Appweb to run as a daemon, run the following command:

/sbin/chkconfig --add appweb
/sbin/chkconfig --level 5 appweb on
/sbin/service appweb start

To permanently remove Appweb from running as a Daemon on a Debian (Ubuntu) based system, run the following command:

update-rc.d appweb remove

To reinstall Appweb to run as a daemon, run the following command:

update-rc.d appweb defaults

Mac Instructions

When Appweb runs on MAC OS X 10.5 (Leopard) it does not use the Appweb Angel or Appweb Monitor programs. Rather it uses the MAC launchd service. Launchd offers similar capabilities to that of the Appweb Angel. It starts, manages and restarts Appweb. If Appweb fails, launchd will automatically restart it. Launchd is the preferred way to manage Daemons on a MAC.

To stop Appweb running as a Daemon on a Mac, run the following command:

launchctl unload -w /Library/LaunchDaemons/com.embedthis.appweb

To restart Appweb as a daemon, run the following command:

launchctl load -w /Library/LaunchDaemons/com.embedthis.appweb

© Embedthis Software LLC, 2003-2012. All rights reserved. Embedthis, Ejscript and Appweb are trademarks of Embedthis Software LLC.