“The number you have dialed is temporarily not available”. When you reach the auto attendant of a company, you will hear something like “Welcome to snom technology!” Audio messages are an important building block of modern telephony.
Page 4
We believe that having a choice is beneficial to you and therefore beneficial to us. This manual is the best way to get started with the snom 4S media server. However, because it’s hard to keep a manual up-to-date with all the new the issues that constantly come up, we provide a list of frequently asked questions (FAQ) on our web site http://snom.com.
................................................................................. Log Level Default SIP Domain ..................................Start RTP Port and End RTP Port ......................................................Max. Number of Connections HTTP port ........................................HTTP User and Password ........................................................Outbound Proxy and Initial Route snom technology AG • 5...
Page 6
4 S M S N O M E D I A E R V E R A N U A L SIP Port ............................................................................Follow RTP address Session Timer ......................................Retry Timeout ............................................................................ Max-Forwards Codecs ..................31 Representing User Input ................................
Page 7
Trace ..................53 Logfile..................54 Stored Messages ..............54 Open Calls ................54 snom technology AG • 7...
If you need to send a packet every 20 ms, you do not usually have the time to get audio data from a network server, and even accessing the local hard disk can degrade the quality. snom technology AG • 9...
4 S M S N O M E D I A E R V E R A N U A L Response Times A modern PC is an unbelievable workhorse. An off-the-shelf PC can process more than a billion operations per second and store easily a month of a conversation.
There is another reason to use a dedicated server for the media server: privacy. Remember that voicemails are normally strictly private, and therefore it makes sense to separate them from normal file access. There is nothing better than a physically separated server for this. snom technology AG • 11...
At the beginning of the installation the setup program asks you to accept the license conditions. Please read them carefully, and then select the “accept” button and press “next” to accept the conditions. If you decline, the installation will be aborted. snom technology AG • 13...
4 S M S N O M E D I A E R V E R A N U A L After accepting the license agreement, the next screen asks you to enter your personal information. Enter your name and the name of your organization. This information is not linked to the licensing, which is done after the installation 14 •...
Page 15
It is important that the directory already exists; the media server will not create this directory. snom technology AG • 15...
Page 16
4 S M S N O M E D I A E R V E R A N U A L Remember that for a good performance of the media server, the media directory should be on the local hard disk. In the next step you can select the installation type.
Page 17
The http port defines where the web server of the media server can be accessed. The default port for web servers is 80, and if you are not running any other web services on the computer, port 80 is a good snom technology AG • 17...
Check that the installation has been successful by checking the Services field of Windows. Open the services Window and look for “snom 4S SIP Media Server”. The status should be “Started”. If this is not the case you should invoke the media server by selecting “start”. In this case, we recommend rebooting the system to make sure that the media server is running after the reboot.
-i386-linux-2.20 The tarball includes a shell script with the name install.sh, which sets up the necessary files and links for you. snom technology AG • 19...
Page 20
4 S M S N O M E D I A E R V E R A N U A L ./install.sh The file /etc/rc.config (for SuSe Linux) and /etc/init.d/functions (for RedHat) are appended with the variable „START_MEDIASERVER“ and the MEDIASERVER_OPTS variable is set to a value depending on the html port that you specify.
Don’t run the process as daemon in the background, run it as normal process. --dir d: Specify the root directory for the media server. This is important, as the media server will search files in this directory. --version: Print the version number and exit. snom technology AG • 21...
Licensing web page and enter the host names and the license key that you received with the software (if you don’t have a license key, contact mailto:support@snom.de to get one). After saving this page, the license type and the number of currently registered users is displayed at the top of the page.
The media server checks the license by generating a hash sum over the hostnames and the expiry date, if present. It is therefore important that all hostnames that are provided by snom or one of its representatives are entered in the same sequence as reported.
This is similar to when the media server actually runs on the NAT gateway, but is physically located on a different device. In this case you may choose only one IP address or a private and a public snom technology AG • 25...
4 S M S N O M E D I A E R V E R A N U A L IP address. If you want to forward calls into the private network, you need to also specify a private IP address. The media server polls for IP address changes every minute.
Ports are allocated according to the round robin principle inside this area. This setting is important if the media server is sending RTP through a firewall. In this case you need to adjust these settings with your firewall. snom technology AG • 27...
4 S M S N O M E D I A E R V E R A N U A L Max. Number of Connections There are CPU limitations on the maximum number of media connections (see the FAQ on this topic). With this setting, you can tell the media server to reject additional connections.
In a stand-alone media server this would be port 5060, but as the media server is typically never called directly, you can also choose a different number. The media server will typically register its accounts with a proxy so that you don‘t have to remember odd port numbers. snom technology AG • 29...
4 S M S N O M E D I A E R V E R A N U A L If you run the proxy on the same host, you must choose another port. This is important, as the media server will not try another port if the port is not available.
G.711, GSM 6.10 and G.729A. You can see that voice compression only makes sense to a certain degree because the packet transport overhead is approximately 24 kBit/s if you are sending 50 IP packets per second. snom technology AG • 31...
Page 32
4 S M S N O M E D I A E R V E R A N U A L Codec Good G.711 ulaw Understood almost Requires 80 kBit/s (gross, 20 everybody ms packets) G.711 alaw Understood many, same Requires 80 kBit/s (gross, 20 quality as ulaw ms packets)
Registering Accounts Accounts are usually registered to a proxy. For this purpose, most accounts contain a setting called “register”. In this setting you can enter the URL that you want to snom technology AG • 35...
4 S M S N O M E D I A E R V E R A N U A L register. If you have defined a default proxy, you need only to enter the account number and the media server will automatically convert this into a valid URL.
You can use this mechanism to customize you entertainment, e.g. play some company information. You should register the MOH account with a proxy. In this way, calls can easily be routed to the media server without setting this up snom technology AG • 37...
4 S M S N O M E D I A E R V E R A N U A L explicitly on every phone. You should test the configuration of the media server by calling the music on hold account that you created directly. If everything works ok, you can continue with something more complex: the mailbox.
When the mailbox has new messages, it can send a message waiting indication (MWI) to the destination that is entered in this field. Like with the email setup, you may also provide this setting in the call setup message. snom technology AG • 39...
4 S M S N O M E D I A E R V E R A N U A L In addition to this, clients may explicitly subscribe for MWI events of the mailbox. In this case, they receive MWI notifications as well. Record Length Some callers tend to keep on talking.
Remote Initiation of Conferences The media server supports “third party call control” (3PCC), which means external devices like the snom 4S proxy may initiate conferences. For such conferences, the external device will provide a unique conference ID. This ID must be provided as parameter “conf_id” (for example, “sip: conf@media.company.com?conf_id=123”).
4 S M S N O M E D I A E R V E R A N U A L The registering and the password is the same as with the other account types. There is also a type of “early attendant”. This is the same as the auto attendant with the difference that this account type does not pick up the call but works in the early media phase of the dialog.
If you want to play other messages, just put the audio file into the audio directory of the media server. Please note that the filename must not contain any “..” for obvious reasons of security. snom technology AG • 43...
‘$’ like ‘?’ but only digits; • ‘*’ matches zero or more characters; • ‘%’ matches zero or more characters, but only digits; • ‘~’ matches the hostname as specified; • ‘[a-z]’ matches a character range. snom technology AG • 45...
Page 46
4 S M S N O M E D I A E R V E R A N U A L The flag “Create complete URL names” controls weather the complete To name is taken as an account name or just the user name (for example, when the to pattern is “sip:123@company.com”, the complete name would be “123@company.com”, while the user name would just be “123”).
Instant Mailbox setup. The instant mailbox is checked first; if the media server finds a match in the instant mailbox rule, it will create a mailbox and not try to establish a media bridge. snom technology AG • 47...
The calling card account type has the following parameters: Like all other account types, you may provide the calling card accounts with credentials (auth_* settings). For the calling card feature, this might be especially important, as this is a way to protect a snom technology AG • 49...
Page 50
The calling card account sends the message “there is one minute left on your account” when the last billing period is entered. This simplified billing approach can be easily changed with another account type. Please ask support@snom.de for more details. 50 • Calling Cards...
The web interface is intended for setting up a few accounts. If you need to set up a large number of accounts, you should use a script that uses a program to set accounts up automatically (for example, using curl). snom technology AG • 51...
Trace The media server also supports a simple method of tracing the SIP messages that went through it. Just go to Status/Trace to see the last SIP messages that went through the media server. snom technology AG • 53...
4 S M S N O M E D I A E R V E R A N U A L Logfile The logfile contains information about important events in the media server. Depending on the log level, you will see a greater or lesser amount of messages on this web page.
Page 55
Remote Initiation 41 Hard Disks 11 Credentials 36 HTTP 28 Audio Files 43 dialog state 47 dial plan Identity 39 Calling Card 50 iLBC. see Codec Directory 15 Initial Route 29 DMZ 26 Installation DTMF 33 snom technology AG • 55...
Page 56
4 S M S N O M E D I A E R V E R A N U A L Linux Error-Information 42 Automatic Starting 13 Stored Messages 54 Interoperability 3 MOH 37 IP Address 26 Configuration 37 How to use 37 Multiprocessing 10 Multitasking 10 License 13, 23...
Page 57
19 Response Times 10 Tasks 9 RFC2833 33 Third party call control (3PCC) Routing 29 RTP 32 Timeout 30 NAT 30 Trace 53 RTP address 30 transcoding 47 RTP Port 28 Scheduling 9 Uninstalling snom technology AG • 57...
Page 58
4 S M S N O M E D I A E R V E R A N U A L Windows 18 Update 20 Web Browser 18 wildcards 45 Windows 10 58 • Index...
Page 59
E R V E R A N U A L Reader‘s Feedback snom technology AG welcomes your evaluation of this manual and any suggestions you may have. These help us to improve the quality and usefulness of our documentation. Please send your comments and suggestions to:...
Page 60
USA and Americas: India and SAARC: Europe & ROW: snom 4S SIP Media Server Administrator Manual snom USA Representation snom technology (India) Pvt Ltd. snom technology AG 3 Nov, 2003, Version 2.20 ABP International, Inc. No. 417, International Trade Tower Pascalstr.
Need help?
Do you have a question about the 4S and is the answer not in the manual?
Questions and answers