beautypg.com

Http administration, 3. kannel http administration commands – Nokia WAP and SMS gateway User Manual

Page 30

background image

Chapter 3. Using the gateway

The state can be changed via HTTP administration interface (see below), and shutdown can also be
initiated via TERM or INT signal from terminal. In addition, the bearerbox can be started already in
suspended or isolated state with -S or -I command line option, see above.

HTTP administration

Kannel can be controlled via an HTTP administration interface. All commands are done as normal HTTP
queries, so they can be easily done from command line like this:

lynx -dump "http://localhost:12345/shutdown?password=bar"

...in which the ’12345’ is the configured admin-port in Kannel configuration file (see above). For most
commands, admin-password is required as a argument as shown above. In addition, HTTP administration
can be denied from certain IP addresses, as explained in configuration chapter.

Note that you can use these commands with WAP terminal, too, but if you use it through the same
Kannel, replies to various suspend commands never arrive nor can you restart it via WAP anymore.

Table 3-3. Kannel HTTP Administration Commands

status or status.txt

Get the current status of the gateway in a text

version. Tells the current state (see above) and
total number of messages relied and queueing in
the system right now. Also lists the total number of
smsbox and wapbox connections. No password
required, unless

status-password

set, in which

case either that or main admin password must be
supplied.

status.html

HTML version of status

status.xml

XML version of status

status.wml

WML version of status

store-status or store-status.txt

Get the current content of the store queue of the

gateway in a text version. No password required,
unless

status-password

set, in which case

either that or main admin password must be
supplied.

store-status.html

HTML version of store-status

store-status.xml

XML version of store-status

suspend

Set Kannel state as ’suspended’ (see above).

Password required.

isolate

Set Kannel state as ’isolated’ (see above).

Password required.

resume

Set Kannel state as ’running’ if it is suspended or

isolated. Password required.

23