Appendix C. Setting up a test environment for Push Proxy Gateway
Using Nokia Toolkit as a part of a developing
environment
This chapter describes a developing environment using Nokia Toolkit instead of
test_http_server
program.
You cannot use a real phone for testing a push server. Sending random messages to a phone does not
work, because its only feedback (if it works properly) in error situations is dropping the offending
message.
Nokia Toolkit, instead, displays push headers, decompiles tokenised documents and outputs debugging
information. It is not, of course, a carbon copy of a real phone. But it is still usefull for checking spec
conformance of push servers.
Toolkit runs on Windows, the first thing you must is to install a virtual machine (VMWare is one
possibility) in the machine where Kannel runs. Then you must configure Toolkit for working with a push
gateway.
Then start
bearerbox
and
wapbox
similar way as told before. You must set the correct client address
in the push document sended by
test_ppg
program. Use IP address of our virtual machine (easiest way
to get this is to ping your virtual machine name in the dos prompt window). Your bearer is in this case IP.
An example pap document follows:
<?xml version="1.0"?>
<!DOCTYPE pap PUBLIC "-//WAPFORUM//DTD PAP//EN"
"http://www.wapforum.org/DTD/pap_1.0.dtd">
<pap>
<push-message push-id="[email protected]"
deliver-before-timestamp="2001-09-28T06:45:00Z"
deliver-after-timestamp="2001-02-28T06:45:00Z"
progress-notes-requested="false">
<address address-value="WAPPUSH=192.168.214.1/[email protected]"/>
<quality-of-service priority="low"
delivery-method="unconfirmed"
</quality-of-service>
</push-message>
</pap>
Note address-value format. It is contains type and value, because PAP protocol supports different address
formats.
You must use
test_ppg
’s -a and -c flags when pushing messages to Toolkit. -A defines the client
application handling pushes, right value for it is ua. -C defines the content type of your push message. SI
works with all Toolkits, wml only with some older versions.
Testing PAP protocol over HTTPS
When testing HTTPS connection to PPG, you probably want use test_ppg’s configuration file, because
number of required parameters is quite high. Here is a example test_ppg configuration file:
101
