Snom 4S SIP Proxy Manuel d'utilisation et d'entretien
Administrator‘s
Manual
snom 4S
SIP Proxy
Version 2.44
snom 4S Proxy Version 2.44 Administrator Manual
3. Edition 2005 (Version 2.44.6)
© 2005 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 Proxy and is supplied on an “AS IS” basis, that is, without any warranties
whatsoever, express or implied.
Information in this document is subject to change without notice and does not represent any
commitment on the part of snom technology AG. The software described in this document
is furnished under a license agreement and may be used only in accordance with the terms
of that license agreement. It is against the law to copy or use this software except as
specifically allowed in the license. No part of this document may be reproduced, republished
or retransmitted in any form or by any means whatsoever, whether electronically or
mechanically, including, but not limited to, by way of photocopying, recording, information
recording or through retrieval systems, without the express written permission of snom
technology AG.
snom technology AG • 3
Table of Contents
1 Foreword .......................................................7
1.1 Software Updates from 2.42 ............................................ 7
1.2 Software Updates from 2.2x ............................................ 8
1.3 Additional Information .................................................... 8
2 Installation ...................................................9
2.1 Windows ....................................................................... 9
2.1.1 Installation .............................................................................................................................................................................. 9
2.1.2 Uninstalling in Windows ................................................................................................................................... 13
2.2 Linux .......................................................................... 13
2.3 Command Line Options ................................................. 14
2.4 Migrating 2.42 Files ...................................................... 15
2.7 DNS Setup .................................................................. 15
2.7.1 DNS Example .................................................................................................................................................................. 16
2.7.2 Using the Proxy without DNS ................................................................................................................... 17
3 Domains ......................................................19
3.1 Creating a domain ....................................................... 20
3.2 Deleting a domain ........................................................ 20
3.3 Edit a domain .............................................................. 21
3.4 Going to a domain context ............................................ 21
3.5 Determining the Domain Context ................................... 21
3.5.1 Purpose .................................................................................................................................................................................... 21
3.5.2 Usage .......................................................................................................................................................................................... 22
3.6 Backup ....................................................................... 22
4 Login ...........................................................25
4.1 Sessions ..................................................................... 25
4.2 Login .......................................................................... 25
4.3 Creation of Accounts .................................................... 26
4.4 Logout ........................................................................ 27
5 System Settings ..........................................29
4 • Table of Contents
[ S N O M 4S PR O X Y M A N U A L ]
5.1 License ....................................................................... 29
5.2 Port Bindings ............................................................... 30
5.2.1 Binding to the right address ...................................................................................................................... 30
5.2.2 Receiving forwarded packets .................................................................................................................... 31
5.2.3 SIP, HTTP and RADIUS Port ....................................................................................................................... 32
5.2.4 STUN Settings ................................................................................................................................................................ 32
5.3 System Settings .......................................................... 33
5.3.1 Logging .................................................................................................................................................................................... 33
5.3.2 Caches ....................................................................................................................................................................................... 34
5.3.3 Subscription Size ....................................................................................................................................................... 35
5.3.4 Unavailable Hosts ..................................................................................................................................................... 35
5.3.5 Agents ....................................................................................................................................................................................... 36
5.3.6 Number Guessing ..................................................................................................................................................... 36
5.3.7 Directories ........................................................................................................................................................................... 36
5.3.8 Email ............................................................................................................................................................................................ 37
5.3.9 Configuration in XML ............................................................................................................................................ 38
5.4 Security Settings ......................................................... 38
5.4.1 https/http Access ...................................................................................................................................................... 38
5.4.2 Administrator Access ........................................................................................................................................... 40
5.4.3 Importing Certificates ......................................................................................................................................... 40
5.5 Billing Settings ............................................................ 41
5.5.1 RADIUS Settings ........................................................................................................................................................ 42
5.5.2 RADIUS Scripting ...................................................................................................................................................... 43
5.6 Domain Determination/Administration ............................ 45
5.7 Routing Settings .......................................................... 45
5.7.1 Max Forwards ................................................................................................................................................................. 45
5.7.2 ENUM Suffix ...................................................................................................................................................................... 46
5.7.3 Route Other Requests ........................................................................................................................................ 46
5.7.4 Loose Routing ................................................................................................................................................................. 46
5.7.5 Loose Routing Flag .................................................................................................................................................. 47
5.7.6 Always Record-Route ........................................................................................................................................... 47
5.7.7 Record-Route for SUBSCRIBE ................................................................................................................. 47
5.7.8 Symmetric Responses ........................................................................................................................................ 48
5.8 Redundancy ................................................................ 48
5.8.1 Shutting servers down ....................................................................................................................................... 49
5.8.2 DNS considerations ................................................................................................................................................ 49
5.8.3 Refresh rate considerations ........................................................................................................................ 50
5.8.4 How Replication Works ...................................................................................................................................... 50
5.8.5 Exceptions ........................................................................................................................................................................... 51
5.8.6 Settings ................................................................................................................................................................................... 51
5.8.7 Security ................................................................................................................................................................................... 52
snom technology AG • 5
[ S N O M 4S PR O X Y M A N U A L ]
5.9 Appearance ................................................................. 52
6 System Status .............................................55
6.1 Server Log .................................................................. 55
6.2 Call Log ...................................................................... 55
6.3 Current Calls ............................................................... 56
6.4 SIP Trace .................................................................... 57
6.5 Replication Trace .......................................................... 58
6.6 Unavailable Hosts ........................................................ 58
6.7 Memory Usage ............................................................ 58
6.8 System Information ..................................................... 59
7 Domain Settings ..........................................61
7.1 Settings ...................................................................... 61
7.1.1 Similar Settings ........................................................................................................................................................... 61
7.1.2 Emergency Location Information ....................................................................................................... 61
7.1.3 Authorization ................................................................................................................................................................... 62
7.1.4 Canonical Names ....................................................................................................................................................... 63
7.2 Registration Preferences ............................................... 63
7.2.1 Self-Setup ............................................................................................................................................................................ 63
7.2.2 Min/Max Registry Time ..................................................................................................................................... 64
7.2.3 Default Probability ................................................................................................................................................... 64
7.3 Dial Plan ..................................................................... 64
7.3.1 How it works .................................................................................................................................................................... 64
7.3.2 Call Pickup ........................................................................................................................................................................... 67
7.3.4 DND Feature Codes ................................................................................................................................................ 67
7.3.5 Example 1: North American Dial Plan ......................................................................................... 68
7.3.6 Example 2: Do not allow cell phone numbers to certain users ............... 68
7.4 Controlling .................................................................. 69
7.4.1 Defining Rates ............................................................................................................................................................... 69
7.4.2 Defining Groups ........................................................................................................................................................... 70
7.4.3 Controlling Data .......................................................................................................................................................... 70
7.5 Address Books ............................................................. 71
7.5.1 Number Guessing ..................................................................................................................................................... 71
7.5.2 Defining Address Book Groups .............................................................................................................. 71
7.5.3 Setting Up an Address Book ...................................................................................................................... 72
7.6 Error-Information ......................................................... 72
7.7 Script ......................................................................... 73
7.8 Account Administration ................................................. 73
7.8.1 Purpose .................................................................................................................................................................................... 73
7.8.2 Setting up an account from the web interface ............................................................... 74
6 • Table of Contents
[ S N O M 4S PR O X Y M A N U A L ]
7.8.3 Setting up a hunt group and pickup group .......................................................................... 76
7.8.4 Changing Normal User Settings ........................................................................................................... 77
7.8.4.1 Authentication Name ............................................................................................................................................ 77
7.8.4.2 Single Registration .................................................................................................................................................. 77
7.8.4.3 3rd Party Registration ........................................................................................................................................ 77
7.8.4.3 User-Visible Settings ............................................................................................................................................ 78
7.8.5 Importing a list of users .................................................................................................................................. 78
7.8.6 Account List ....................................................................................................................................................................... 80
7.8.7 Storing information ................................................................................................................................................ 80
7.9 Plug and Play .............................................................. 81
7.9.1 Server Detection ........................................................................................................................................................ 81
7.9.2 Setting Groups .............................................................................................................................................................. 82
7.9.3 MAC Addresses ............................................................................................................................................................. 83
7.9.4 Settings ................................................................................................................................................................................... 83
7.9.5 Software Version ........................................................................................................................................................ 84
7.10 Registered Users .......................................................... 84
7.11 Other Status Information .............................................. 85
7.12 LED Notifications .......................................................... 85
7.12.1 Dialog-State Notifications ............................................................................................................................. 86
7.12.2 Domain State Notification ............................................................................................................................. 88
7.12.3 Call Pickup and Takeover ................................................................................................................................. 89
8 Call Hunting ................................................91
8.1 Defining Stages ........................................................... 91
8.2 Defining the Algorithm .................................................. 92
8.3 Default Actions ............................................................ 93
snom technology AG • 7
1 Foreword
Before you start using the proxy and continue with the rest of this
manual please read the following important notes.
1.1 Software Updates from 2.42
There are some important changes in version 2.44 that you
should consider when updating the software version.
First of all, the license model has changed. Instead of keeping the
number of currently registered users, the proxy now counts the number of
known users. The number of registrations does not matter. This reduces
the load for license counting on the proxy significantly and solves many
problems that we had with the old license model.
Second, we decided to remove the double-directory mechanism
that was found in the 2.42 version. This double-layered directory
structure caused many problems in the scanning of the directory and the
programmability of the first directory layer caused problems when the
program was changed.
Several features were removed. This step simplified the proxy
significantly and increased its stability. For example, the welcome message
is not supported in the default configuration of the proxy. Message store-
and-forward has also been removed.
On the other hand, the 2.44 version of the proxy comes with a
scriptable RADIUS support at its core and a simple hot-standby support
without the need to a redundant file system. Compared with the 2.42
version, there are several new features like pickup groups. Detailed
information about the changes between the release can be found in the
proxy release notes.
1
8 • Foreword
[ S N O M 4S PR O X Y M A N U A L ]
1.2 Software Updates from 2.2x
The 2.3x edition of the proxy uses the same license keys as the
previous versions. However, because of the domain concept, the license
checking algorithm had to be changed and the new proxy now checks
the hostnames directly against the found IP address. Therefore, the list
of hostnames should now include the IP address of the host. If you have
problems with this, please contact mailto:[email protected], please include
the old license information. We will give you a new license key in this
case.
The proxy keeps many of the proven concepts of the previous
versions, however introduces scripting and domains which makes it hard
for the installation process to automatically convert the configuration data
from the 2.2x proxy versions into the new version. Some of the settings
need manual update.
Therefore, if you update the proxy, we ask you to save old
configuration information for later reference. You can do this easily by
storing the web content of the relevant configuration pages to a file (the
downloading of XML-Files is described below).
You can always find information about the changes at our web
site, http://snom.com/download/proxy-release-notes.pdf.
1.3 Additional Information
This manual does not cover all topics that are related to the
usage of the proxy. We keep a list of frequently asked questions (FAQ) on
our website at http://snom.com/white_papers.html for specialized topics
such as remote management via shell script. They also contain topics that
affect other SIP components like the media server or the phones. These
FAQ will be kept up-do-date on a higher frequency than this manual.
We also keep a list of bug fixes in the release notes, which is
available at the software download site at http://snom.com/down4s.html.
Before you make a software update, you may check this document if the
update is necessary or not.
1
snom technology AG • 9
2 Installation
2.1 Windows
2.1.1 Installation
Tip: If you are doing an update, you need to stop and uninstall
the old proxy 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.
2
10 • Installation
[ S N O M 4S PR O X Y M 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” button and press “next” to accept the conditions. If you decline,
the installation will be aborted.
After accepting the license agreement, the next screen asks you
to enter a few basic installation settings. You should have received the list
of the hostnames and the matching license code with the purchase of this
product, please enter this into the respective fields.
You need to define on which ports the proxy will operate. This is
important because otherwise it will be hard for you to find the right port.
The http port defines where the web server of the proxy 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 choice.
Otherwise, choose a free port and write the port number down somewhere
so you don’t have to search for it. If you don’t fill in any data or cancel the
2
Ce manuel convient aux modèles suivants
1
Table des matières
Autres manuels Snom VoIP
