After installation, Appweb is normally started automatically as a
system service or system daemon. You can change this behavior and
only start Appweb manually if you wish.
This page gives information about starting and stopping Appweb manually. Before you can run Appweb manually, you must first stop it running as a system service. See Running as a service for how to stop Appweb running as a system service. The appweb
program may be run in the foreground or in the background as a
system service (daemon). On Windows, Appweb normally runs as a
windows application or a system service, however it may run also
be run explicitly as a console application via the "-c" switch.
|
Option |
Description |
-A |
Auto-scan for a free port. Port scanning
starts with the port specified by the -a switch or from 80
if running as super-user (administrator), or 1080 if
running unprivileged. |
-a IP:PORT | Specify the IP and port address to listen
on. You may omit the IP or the port portion. If the IP
portion is omitted, then all interfaces will be listened
to. If the port portion is omitted, then port 80 will be
used. |
-b |
Run appweb as a daemon in the
background. |
-D |
Set DEBUG mode on. This will disable all
timeouts and is useful for single-step
debugging. |
-d docRootDir | Specify the directory holding the web
documents to serve. |
-f configFile |
Specifies an alternative configuration file
instead of appweb.conf. |
-k |
Kill a currently running appweb. |
-l logSpec |
Specify a file to log messages. This will
override the ErrorLog directive in the configuration file.
The syntax is: -l
logName[,moduleName][:logLevel][.maxSize]. When the maximum
size is exceeded, the log file will be rotated to
logName.old and a new log file will be started. |
-r serverRootDir |
Specify the starting directory for the root
of the server. This directory contains Appweb configuration
file. |
-t numPoolThreads |
Specify the number of threads to allocate for the appweb thread pool. This overrides the ThreadLimit configuration file directive. |
-v |
Display the appweb version number |
On Windows, the appweb program also supports the following options:
-c |
Run as a console application. This will
create a console window. Currently this does not work when
invoked directly from a CYGWIN window. |
-i "service command
line" |
Install appweb as a windows service. The
argument to the -i option is a
appweb set of options to use when the Windows service
control manager starts appweb. The argument to -i is normal
"-d" to instruct appweb to run as a windows
service. |
-g |
Instruct appweb to go (start). |
-s |
Stop appweb. |
-u |
Uninstall appweb as a system
service. |