Snom 4S Administrator's Manual
Snom 4S Administrator's Manual

Snom 4S Administrator's Manual

Sip media server version 2.24
Hide thumbs Also See for 4S:

Advertisement

Administrator's
Manual
snom 4S
SIP Media Server
Version 2.24

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the 4S and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Snom 4S

  • Page 1 Administrator‘s Manual snom 4S SIP Media Server Version 2.24...
  • Page 2 © 2004 snom technology Aktiengesellschaft. All Rights Reserved. This document is supplied by snom technology AG for information purposes only to licensed users of the snom 4S media server and is supplied on an “AS IS” basis, that is, without any warranties whatsoever, express or implied.
  • Page 3: Table Of Contents

    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 ..............................
  • Page 5: Snom Technology Ag

    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...
  • Page 7: Foreword

    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.
  • Page 9: Introduction

    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.
  • Page 10: Response Times

    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 •...
  • Page 11: Hard Disks

    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...
  • Page 13: Installation

    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.
  • Page 18: Uninstalling In Windows

    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...
  • Page 21: Setup

    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.
  • Page 22: License Key

    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.
  • Page 23: System Settings

    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...
  • Page 24: Dns Identity

    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.
  • Page 25: Max Number Of Connections

    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...
  • Page 26: Http User And Password

    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...
  • Page 27: Sip Port

    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.
  • Page 28: Max-Forwards

    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...
  • Page 30: Representing User Input

    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.
  • Page 31: Dial Plan

    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.
  • Page 33: Mailbox Template

    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...
  • Page 35: Accounts

    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...
  • Page 36: Registering Accounts

    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.
  • Page 37: Outbound Proxy

    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.
  • Page 39: Specific Account Types

    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...
  • Page 40: Configuration Of The Moh Account

    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.
  • Page 41: Using The Mailbox Account

    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...
  • Page 42: Identity

    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.
  • Page 43: Time Difference

    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:...
  • Page 44: Auto Attendant

    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.
  • Page 45: Error-Information

    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...
  • Page 46: Playing Messages Using Sip

    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.
  • Page 47: Other Types

    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...
  • Page 49: Email-Support

    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.
  • Page 50: S N O M

    (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.
  • Page 51: Maintenance

    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...
  • Page 52: Open Calls

    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 ...
  • Page 54 AG snom 4S SIP Media Server Pascalstr. 10B Administrator Manual 10587 Berlin, Germany 28. Dec, 2004, Version 2.24 Phone: +49 (30) 39833-0 © 2004 snom technology AG mailto:info@snom.com All rights reserved. http://www.snom.com Subject to change without notice. sip:info@snom.com...

Table of Contents