Snom Mass Deployment V3.4 Frequently Asked Questions Manual
F REQUENTLY
A SKED
Q UESTION
Conguring snom phones
for Mass Deployment V3.4
Date: Sept-17-2004
Author: Sven Fischer
Document: faq-04-03-26-v3.4-sf
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 ]
Con guring snom phones for Mass Deployment V3.4 3
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
As stated in the FAQ „How can I update a snom phone?”, it is possible to congure your
snom phone with cong les, which consist of the following settings.
This release v3.4 is describing rmware settings beginning with version 3.4 ! In case you
are using an older rmware version please refer to v2.0 of this document.
Phone settings
Settings are non-volatile name/value pairs that are stored in the ash of the phone. They
include registration information, dialled numbers, network settings and other information that
should be available after rebooting. Settings can be made read only on a per setting basis.
This is useful in environments where an operator sets up the phones and wants to avoid users
changing settings that affect the stability of the phone. In this way, expensive trouble ticket
searching can be reduced and the total cost of ownership of the phone be minimized.
Settings Files
Setting les are ASCII-based les containing lines (terminated with newline or carriage
return/newline pairs). Comments start with a # or a < character. The < and > characters allow
easy integration of html tags. Names may consist of the characters a-z, A-Z, 0-9 and _.
Appending a name with an “!” character means that this setting becomes writable by the
user. Appending the name with an “&” states that the setting is read only (this is the default).
If a setting is marked writable, the value in the settings le is only written to the phone if
that setting has not yet been set up at the phone. In order to overwrite such settings, do not
append the setting name with “!”.
A sample le looks like this:
<html>
<pre>
#This is a settings le
#
phone_name: testphone
dns_domain: intern.snom.de
dns_server1!: 192.168.0.9
</pre>
<html>
Downloading procedure
Settings are downloaded from web servers. HTTP is a very powerful way to get conguration
information from anywhere in the world. The location of a le is described as a URL, i.e. it
begins with http://.
This is how the Settings are set up:
1. The settings that were stored in the ash memory are read.
2. Network and DNS is set up. This allows the phone to get settings from internet URLs.
3. It then checks the setting "setting_server” and loads the settings stored in the URL (e.g.
http://www.snomag.de/snom200/snom200.htm) provided. For a small description of
Con guring snom phones for Mass Deployment V3.4 3
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
the le format, see below. The setting_server URL can also consist of a {mac} statement
like http://www.snomag.de/snom200/snom200.php?mac={mac}. The MAC address is a
unique identication ID of Ethernet devices. snom devices have the form 000413xxxxxx,
where xxxxxx is a hexadecimal number identifying the snom device. The MAC address
is automatically replaced from the phone with its own mac address before using the
URL. So phone specic settings can be provided for each phone via this mechanism. The
“setting_server” setting can be set manually via webinterface or automatically via DHCP
(options 66 and 67) and through snom4S SIP proxy.
4. The de facto settings are added. These settings may differ from what has been set up
because DHCP may have changed them. The settings include:
• the IP address of the device,
• the net mask,
• the IP gateway,
• the hostname,
• the DNS domain, rst and second DNS server,
• the UTC offset in seconds,
• the time server,
• DHCP on or off
Each setting is described by its ‚Name:‘ which should be added to the cong le followed
by a colon and its specic value. Name is followed by ‚Valid values:‘ where the valid values are
described. Each possible value is bracketed in <>.The braces must be left out if you are using
the values stored in a cong le. ‚Default:‘ shows the value which is set by default after you
have removed all of the setting with a manual update or a reset values! Lastly, ‚Description’
gives brief details of each setting. See also the snom4S SIP proxy manual for PNP conguration
via the proxy. And see the FAQ “How to update a snom phone” for further details regarding the
update process.
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 ]
Con guring snom phones for Mass Deployment V3.4 5
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
Redirection
redirect_event
Valid values: <all>, <busy>, <none>,
<time> Default: none Description: Event
that causes redirection. <all> redirects
always, <none> never, <busy> when
the phone is in use and <time> after a
timeout.
redirect_time
Valid values: e.g. <15>
Default: blank
Description: Number of seconds after
which the phone will redirect the incoming
call.
redirect_number
Valid values: e.g. <tb,sf> or <sip:tb@sn
om.de;q=0.8,sf@snom.de;q=0.9>.
Default: blank
Description: The redirection target. If the
proxy executes the redirection, this may
be a comma-separated list of alternate
destinations (including probabilities).
redirect_busy_number
Valid values: e.g. <tb,sf> or <sip:tb@sn
om.de;q=0.8,sf@snom.de;q=0.9>.
Default: blank
Description: The redirection target when
the redirect_event is set to busy.
Basic
language
Valid values: <English>, <English(UK)>,
<Deutsch>, <Francais>, <Italiano>,
<Espanol>, <Cestina>, <Nederlands>,
<Polski>, <Portugues>, <Slovencina>,
<Suomi>, <Svenska>, <Dansk>,
<Japanese>, <Chinese>
Default: English
Description: Selects the language.
web_language
Valid values: <English>, <Deutsch>,
<Nederlands>, <Suomi>, <Dansk>
Default: English
Description: Selects the language for the
webinterface.
display_method
Valid values: <full_contact>, <display_
name>, <user_name>
Default: full_contact
Description: Selects the display style of
SIP URLs.
call_completion
Valid values: <true>, <false>
Default: false
Description: With <true> the phone
offers after a “busy” the option to wait
for the other party to become free again
and inform the user to make a new call
attempt.
auto_dial
Valid values: <off>, <2> , <5>, <10>,
<15>
Default: off
Description: Phone begins after 2, 5,
10 or 15 seconds to dial the number
already typed in.
block_url_dialing
Valid values: <true>, <false>
Default: false
Description: With <true> the user is not
anymore able to change the inputtype
for editing chars, it will remain numbers
only.
challenge_response
Valid values: <true>, <false>
Default: true
Description: <true> turns on displaying
challenge request on the display to the
user.
Con guring snom phones for Mass Deployment V3.4 5
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
broadsoft_call_control
Valid values: <true>, <false>
Default: false
Description: <true> turns on broadsoft
call control feature support.
cmc_feature
Valid values: <true>, <false>
Default: false
Description: When this setting (CMC -
Client Matter Code) is turned on, the user
is offered a softkey during a call; its use
sends a unique code to the server using
the INFO message in SIP. This code can
later be used for billing or book keeping
along with the call ID of that call.
call_waiting
Valid values: <true>, <false>
Default: false
Description: If call waiting indication
(CWI) is on (<true>), during a call
parallel incoming calls are signaled with
a knocking sound and the caller hears a
free signal. In case of <false> only one
incoming call in parallel can be handled
and the caller hears a busy signal.
cw_dialtone
Valid values: <true>, <false>
Default: false
Description: In case of holding a party
you will hear a free tone <true> or
nothing <false>
conf_hangup
Valid values: <true>, <false>
Default: false
Description: Someone maybe wants the
hookswitch to not cancel a call, then it
should be set to <false>.
transfer_on_hangup
Valid values: <true>, <false>
Default: true
Description: to switch off “transfer on
hook” functionality, set it to <false>.
contrast
Valid values: Between <0> and <15>
Default: 8
Description: Determines the display
contrast, but should not be used,
because each phone reacts differently
to it dependend by example from the
temperature etc. Its better to set it
manually.
use_backlight
Valid values: <true>, <false>
Default: true
Description: In case your phone has a
backlit display (snom105/220) the light
can be switched off completely with
<false>.
image_src
Valid values: <true>, <false>
Default: false
Description: The pictures for the internal
web interface are taken from the phone
(<false>) or loaded via the Internet
(<true>). Thus if you have a slow
connection to the remote phone, <true>
will signicantly speed up the displaying
of the phone‘s webpages.
guess_number
Valid values: <true>, <false>
Default: true
Description: Number guessing or auto
completion while typing in numbers to
dial.
deny_all_feature
Valid values: <true>, <false>
Default: true
Description: If set to <true>, the “Deny
All” option is offered on incoming calls.
Otherwise it is disabled.
6 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 ]
Con guring snom phones for Mass Deployment V3.4 7
[ F R E Q U E N T L Y A S K E D Q U E S T I O N ]
admin_mode
Valid values: <true>, <false>
Default: true
Description: Administrator mode
(all settings are accessible) or user
mode (only a few basic settings are
accessible).
admin_mode_password
Valid values: Numbers and character
strings of unspecied length, e.g.
<1234>, <0fg5gju>, <nhcndeve>
Default: 0000
Description: The password for entering
the Administrator mode on the snom
phone.
callpickup_dialoginfo
Valid values: <true>, <false>
Default: false
Description: If your phone should be able
to get informed of calls to be picked up
via the dialoginfo SIP message and to
pickup calls, set this setting to <true>.
SIP Line Settings
The SIP stack on the phone supports
seven lines, which are identied with
the numbers 1 through 7. Line-specic
settings are appended with the line
number.
user_realname[1-7]
Valid values: e.g. <Jim Testa>
Default: blank
Description: This is the real name of the
user that is displayed for line x.
user_name[1-7]
Valid values: e.g. for <sip:
abc@company.de>, the user_name[1-7]
would be abc.
Default: blank
Description: The account name for line x.
This is a mandatory setting to set up a
SIP line!
user_host[1-7]
Valid values: e.g. for <sip:
abc@company.de> the user_host would
be <company.de>.
Default: blank
Description: The registrar for line x. This
is also a mandatory setting to set up an
SIP line!
user_pass[1-7], user_hash[1-7]
Valid values:
e.g. <company, 456876, answerIs42, a6
4bd7c29de0f23ba64bd7c29de0f23b0>
Default: blank
Description: A setting for registrar
authentication. The username and the
password can usually be set up on the
proxy and registrar, user_hash is a MD5
encrypted password, which can be used
instead of user_pass.
user_q[1-7]
Valid values: Values between <0.0> and
<1.0>
Default: 1.0
Description: The probability of the
registration for line x. This probability
is used by some proxies to call the
registered phones one by one (sequential
and parallel forking proxy).
user_dp_str[1-7]
Valid values: dialplan regular expression,
see snom4S proxy manual
Default: blank
Description: dialplan per line
user_transport[1-7]
Valid values: <auto>, <udp>, <tcp>,
<tls> Default: auto Description:The IP
protocol which should be used for this
line.
Loading...