Webserver Settings ............25 ............................4.3.1 HTTP and HTTPS port 4.3.2 HTTP User and Password ..........................SIP Settings ..............26 ................................4.4.1 Outbound Proxy 4.4.2 SIP Port ....................................4.4.3 Session Timer ................................................................. 4.4.4 Retry Timeout snom technology AG • 3...
Page 4
4 S M S N O M E D I A E R V E R A N U A L 4.4.5 Max-Forwards ................................................................4.4.6 MWI Attachents Codecs ............... 28 4.5.1 Representing Voice ........................................................4.5.2 Representing User Input 4.5.3 Codec Negotiation ..............................
A N U A L Logging Email Reception ..........50 Using Multiple Email Accounts ........50 Maintenance ..........51 Trace ................51 Open Calls ..............52 Logfile ................ 52 Memory Usage ............52 System Information ............. 52 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 6 • Table of Contents...
We believe that having a choice is good for you and therefore good for 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 issues that come up, we provide a list of frequently asked questions (FAQ) on out web site http://snom.com.
Page 8
4 S M S N O M E D I A E R V E R A N U A L We hope that you enjoy using the media server and it helps you setting up a great communication environment! Sincerely, Dr.
This is not intended to serve as introduction into VoIP and SIP in general. You find great introductions and numerous links in the Internet and in the literature. The snom 4S Proxy manual also gives a brief overview on SIP.
However, it is not a good idea to run the media server on a file server. This is the reason why snom offers the media server as a preconfigured product in a dedicated box. Although this box has limited resources compared to a modern PC, it can do a good job because the 10 •...
Operating systems usually keep files which have already been opened in the main memory until they are not used and are replaced with information which is needed more urgently. As long as a file stays cached there will be no problem. snom technology AG • 11...
Page 12
4 S M S N O M E D I A E R V E R A N U A L 12 • Introduction...
Tip: If you are doing an update, you need to stop and uninstall the old media server first (see below on how to do this). After double clicking on the setup executable, the installations program starts up. Press Next to begin the installation. snom technology AG • 13...
Page 14
4 S M S N O M E D I A E R V E R A N U A L At the beginning of the installation the setup program asks you to accept the license conditions. Please read them carefully, then select the “accept”...
Page 15
The settings in this mask can be changed later. You can continue installation even if some information is missing; however you should remember the http port, because otherwise you will have a hard time locating the web server of the product. 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 You can then select the location where the media server’s files will be put. The installation program proposes a reasonable location but if you want to you can change it.
Page 17
Check that the installation has been successful by checking the Services field of Windows. Open the services Window and look for “snom 4S 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.
3.1.2 Uninstalling in Windows To uninstall the media server, first stop it in the services window. Then go to the Software Window and click on “remove” for snom 4S Media Server. Linux After you have downloaded the desired RPM you may install it either with graphical front end of your distribution for installing additional software or as root via the command line.
Page 19
--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 • 19...
Page 20
4 S M S N O M E D I A E R V E R A N U A L 20 • Installation...
To do this, go to the Administration/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 on top of the page.
The media server checks the license by generating a hash sum over the hostnames and the expiration date, if present. Therefore, it is important that all hostnames that are provided by snom or one of its representatives are entered in the same sequence as reported.
Email about the new message or send the recording to the user directly. We use a very simple interface for this purpose: the media server writes one line for every recording that it does. A line consists of comma-separated values. snom technology AG • 23...
The DNS Identity is usually a fully qualified DNS name like mailbox. snom.com. If you have not DNS and want to hardcode the IP address of the media server, you can of course do so. It is also possible to include the port number, just separate the address and port with a colon.
The https port is similar to the http port, but it uses secure communication instead of plain text communication. If you are running the media server in an insecure environment, you should consider using the https port for controlling the media server. snom technology AG • 25...
first before they go to the final destination. In the SIP community, the “outbound proxy” has been widely adopted for this purpose. The snom 4S media server also supports this 26 • Setup...
SDP session and many implementers have chosen INFO messages inside the dialog. snom now went the same way. The session timer value now indicates the number of seconds after which the media server will send INFO messages inside the dialog.
4 S M S N O M E D I A E R V E R A N U A L is 500 ms, but in well performing networks this time may be reduced to make the media server more responsive. The setting is in milliseconds. 4.4.5 Max-Forwards Sometimes SIP messages get into a loop.
Page 29
“Offer/ Answer Full” requests the media server to express its preferences, but offer all available codecs that have been found in the offer. “Interoperable” 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 maximizes the interoperability even with non-standard compliant equipment. 4.5.2 Representing User Input DTMF (Double Tone Multiple Frequency) is another story from the history book of human communication.
RFC3264 says that the one who offers the codec defines the codec preference. The snom media server obeys this principle and in cases when the media server answers the call the settings for the codecs are not necessary.
Page 32
E D I A E R V E R A N U A L The patterns are similar like in the snom 4S proxy. The following special characters are recognized: • ‘?’ matches any character as long as there is one.
flexibility to create all needed mailboxes in just one go. Together with the new feature to set up a list of accounts it should be easy enough to set up mailbox accounts for mid-size companies. snom technology AG • 33...
Page 34
4 S M S N O M E D I A E R V E R A N U A L 34 • Setup...
The new media server also shows a short list of the accounts as links on the navigation bar. However, clicking on the accounts link will give you additional information and allows you to delete accounts from the list. 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 The list shows the name of the account, it’s type and if registration is provided, the SIP URI that the media server will register this account on.
We decided to use an additional, proprietary header that conveys the necessary parameters. This header has th name “P-MS-Flags” and it contains a list of comma separated parameter-name pairs like the WWW- Authenticate headers in SIP requests. For example, if you want to pass snom technology AG • 37...
Page 38
4 S M S N O M E D I A E R V E R A N U A L the value 403 to the variable error, you would use the header P-MS-Flags: error=403. According to the SIP specification, you can for example use the following URI to start a call to the media server: <sip:abc@media.
From a user perspective, the MOH account can be controlled with DTMF keys. You can set up ten different audio files that are selected by the respective DTMF key. They have the name moh0.wav in the music 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 folder of the audio directory. However, when there is no direct connection between the person which is on hold and the media server, the user will not be able to send DTMF digits to the media server.
This will give other parties which are also being called in parallel give a chance to pick up first. If you set this value to zero the media server will pick up immediately. The mailbox answers immediately by default. snom technology AG • 41...
4 S M S N O M E D I A E R V E R A N U A L If you register the mailbox with the highest probability and set an answer delay, the searching process will end after this answer delay. An alternative is to register the mailbox with a low priority and let the proxy decide when the mailbox should pick up.
Remote Initiation of Conferences The media server supports “third party call control” (3PCC), that 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:...
4 S M S N O M E D I A E R V E R A N U A L conf@media.company.com?conf_id=123”). In theory you can also initiate such a conference also manually; in this case you would have to tell all the participants the conference ID and they would have to call a SIP URL like the one above.
Of you use only this setting; you can set up one error-information account per message and then call the respective account directly. Otherwise, you must pass the error variable as a parameter in the request URI. snom technology AG • 45...
4 S M S N O M E D I A E R V E R A N U A L The error parameter can also be passed as a request-URI parameter, see the description above (Passing Variables). 6.5.1 Playing Messages using SIP To inform the error information account which error to play, you need to pass an error parameter in the To-header.
E R V E R A N U A L Other Types There are other types like the IVR tree or the queue available. These types are discussed in separate documents. See http://snom.com/ faq_en.php for more details. snom technology AG • 47...
Page 48
4 S M S N O M E D I A E R V E R A N U A L 48 • Specifi c Account Types...
Sending Emails Directly In small systems it is usually the easiest way to send the voicemail directly from the media server. The snom 4S Media Server includes a simple SMTP/POP3 client that allows sending emails with a WAV attachment. In order to use this feature, you must first set up the SMTP/POP3 connectivity.
(e.g. the snom 4S recorder). This method is the best choice if you have a large number of subscribers and you want to keep the messages and the associated data in a database.
Trace The media server also supports a simple method of tracing the SIP messages that went trough it. Just go to Status/Trace to see the last SIP messages that went trough the media server. snom technology AG • 51...
4 S M S N O M E D I A E R V E R A N U A L Open Calls To see how many calls are currently open on the media server, go to the Status/Open Calls web page. You will see the origin and the destination account as well as the call duration.
Page 53
Please send your comments and suggestions to: snom technology AG Attention: Marketing Department Pascalstr. 10B, 10587 Berlin, Germany Fax: +49 (30) 39833-111 Manual Name: snom 4S Media Server 2.24 Admin Manual (Dec 09, 2004) Excellent Good Fair Poor How would you rate the document ...
Need help?
Do you have a question about the 4S and is the answer not in the manual?
Questions and answers