Page 1
F REQUENTLY
A SKED
Q UESTION
Automatic Setup of
Registration and Mailbox
Date: Dec-05-2002
Author: Christian Stredicke
Document: faq-02-12-05-cs
Page 2
2 snom technology AG
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
Automatic Setup of Registration and Mailbox 3
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
Problem Statement
When consumers install a VoIP phone out of the box, they expect the phone to start
working immediately without any further setup. The plug and play mechanisms of the
snom VoIP phones allow this and the remote controlling capabilities of the snom 4S
components can be used to set up the necessary accounts.
This FAQ is intended as a template for ITSP.
It can be extended and modied to the specic needs of the ITSP. See the FAQ on cControlling
the snom 4S from a Linux Shell and conguring the snom100 for mass deployment.
In this FAQ, we use PHP for answering the requests from the phone during the boot phase.
However, any other mechanism to generate web content dynamically can be used.
For large deployments, the setup needs to integrate a database. This can be done upon
request by snom. However, in this FAQ we use the le system to keep track of the system
setup.
Redirection
This FAQ redirects the phone’s setting URL to a php le with the MAC address as argument.
The le content of snom200.htm is therefore:
<!DOCTYPE HTML PUBLIC „-//W3C//DTD HTML
4.0 Transitional//EN">
<html>
<pre>
# Redirect all phones to the php script
setting_server: http://snomag.de/snom200/
snom200.php?mac={mac}
hw_test: done
</pre>
</html>
Page 3
Automatic Setup of Registration and Mailbox 3
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
PHP script
The PHP script generates an html page that could come from a manual conguration
setup.
The MAC address of the phone is provided as argument to the page url and the script puts
this into the variable number. The type of phone is dened in the variable type.
To avoid overwriting already existing mailbox setup, the script rst checks whether a
mailbox has already been set up by checking for a le. This le is created when the mailbox has
been set up at the end of the mailbox setup part of the script.
In this example, the script converts the hex MAC number into a telephone-like number. It
is important that the function does not generate the same number for different MAC addresses.
Typically, this part should be replaced with a database lookup. Here the script could also check
whether the phone has been registered for this service (for example at the point of sale).
The mailbox creation and setup are done with a curl system call. See the FAQ on Controlling
the 4S for details on this.
After this, the necessary settings are printed using the echo instruction of PHP. Here, too,
we set the address of the music on hold server so that callers can hear music when they are
put on hold.
The settings are writable (exclamation mark) so that the user may change them if desired.
Whether this is made stricter depends upon the operator’s policy.
Page 4
4 snom technology AG
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
© 2004 snom technology AG
All rights reserved.
Europe & ROW:
snom technology AG
Pascalstr. 10B
10587 Berlin, Germany
Phone: +49 (30) 39833-0
mailto:info@snom.com
http://www.snom.com
sip:info@snom.com
PHP-Source-code:
Page 5
© 2004 snom technology AG
All rights reserved.
Europe & ROW:
snom technology AG
Pascalstr. 10B
10587 Berlin, Germany
Phone: +49 (30) 39833-0
mailto:info@snom.com
http://www.snom.com
sip:info@snom.com
India and SAARC:
snom technology (India) Pvt Ltd.
No. 417, International Trade Tower
Nehru Place, New Delhi-110019
Phone: +91 11 26234097
Fax: +91 11 26234079
http://www.snomindia.com
mailto:info@snomindia.com
sip:india@snom.com
USA and Americas:
snom USA Representation
ABP International, Inc.
1203 Crestside Dr.
Coppell, Texas 75019, USA
Phone: +1-972-831-0280
mailto:usa@snom.de
sip:usa@snom.com
Loading...