Professional Documents
Culture Documents
OpenStage@Asterisk
Installation and Maintenance
Guide
Issue 1.0
Siemens Enterprise Communications GmbH & Co KG
Munich, 09/07/2010
Germany
Scope
This document provides a best practice guide on setting up, operating, servicing,
and troubleshooting OpenStage phone in an Asterisk environment.
19/03/2012, page 2
Contents
Scope
Contents
2
3
Preparation
Supplying Power for the Phones
Connecting OpenStage Phones to the IP Network
802.1x
LLDP-MED Configuration Options
DHCP Options
Plug & Play One Step Provisioning and Configuration
Single Phone Configuration (Local Menu, WBM)
4
4
6
6
6
7
7
8
Using OpenStage@Asterisk
Busy Lamp Function (BLF)
XML Applications
Send URL / Remote Server Control
Call Completion (CCBS/CCNR)
CTI for OpenStage - UACSTA
Changing the Caller Information PAI Header
Multi Address Appearance (MAA)
Automatic Call PickUp Using Alert Info Header
9
9
9
9
10
10
11
12
13
14
14
14
14
15
15
15
Limitations
17
References
17
Abbreviations
17
19/03/2012, page 3
Preparation
This chapter contains all information that is necessary to connect an OpenStage phone to an
Asterisk based communication system.
This includes the power supply options (PoE or external supply) for each OpenStage model
and its possible sidecar combinations. To enable a secure environment, 802.1x support for
OpenStage is specified.
For autoconfiguration, LLDP-MED and DHCP can be used. In addition to the standard DHCP
options, SEN proprietary enhancements allow for assigning the address of a provisioning
service at phone startup for easy Plug & Play installation. By means of the provisioning
interface (WPI), mass deployment scenarios and remote administration during the phones
lifecycle are supported.
To facilitate configuration of a single phone by the administrator or user, OpenStage phones
feature a web interface in addition to the phones local interface.
Feature
Legacy optiPoint
external Power
Supply (EU-, US- or
UK-plug)
New OpenStage
Power Supply (EU-,
US- or UK-plug)
OpenStage
15
Yes
(optional)
OpenStage
20E
OpenStage
20
OpenStage
20 G
Yes
(optional)
OpenStage
40
OpenStage
40 G
Yes
(optional)
OpenStage
60
OpenStage
60 G
Yes
(optional)
OpenStage
80
OpenStage
80 G
Yes
(optional)
Yes
Yes
Yes
Yes
Yes
(optional)
(optional)
(optional)
(optional)
(optional)
In line with the further development of our portfolio we are now able to offer
smaller and lighter power supplies for all OpenStage and optiPoint 410/ 420/
500 variants.
They feature a higher degree of efficiency leading to 14 - 19% lower power
consumption, depending on the connected devices.
Important: The new OpenStage power unit is a device of product category.
The protection concept of the power installation needs to achieve the
requirements of earth conductor (e.g. Schukostecker Typ F, country specific).
Yes
Yes
Yes
Yes
Yes
No
OS 15: 1
No
OS 20E : 1
OS 20 : 1
OS 20 G: 2
No
OS 40: 2
OS 40 G: 3
No
OS 60 : 3
OS 60 G: 3
No
OS 80 : 3
OS 80 G: 3
19/03/2012, page 4
During call
(handset)
2,9
2,0
2,9
2,3
3,2
3,9
4,1
2,2
3,1
2,2
3,1
2,5
3,4
4,1
4,3
1,8
1,9
2,6
2,8
1,8
2,4
2,6
3,5
2,0
2,7
2,8
3,6
2,9
4,0
3,4
4,4
2,1
3,0
3,1
4,2
3,4
4,4
4,6
5,1
2,3
3,2
3,8
4,9
4,1
5,2
5,2
5,8
2,1
3,0
2,6
3,7
2,9
3,8
4,2
4,6
2,4
3,3
5,6
6,9
5,8
7,1
6,8
7,9
2,6
3,5
6,2
7,6
6,5
7,9
7,6
8,5
2,8
3,7
6,9
8,3
7,1
8,6
8,3
9,3
2,3
3,2
6,3
7,7
6,5
7,9
7,6
8,6
2,5
3,4
7,0
8,5
7,2
8,7
8,4
9,4
2,6
3,6
7,6
9,2
7,9
9,5
9,1
10,2
2,0
Idle state
# of Key Modules
OpenStage 15
OpenStage 15 with
1 OpenStage Key
Module 15
(9 LEDs on)
OpenStage 20/20E
OpenStage 40
OpenStage 40 with
1 OpenStage Key
Module 40
OpenStage 40 with
OpenStage Key
Module 40
OpenStage 40 with
1 OpenStage Key
Module 15
(9 LEDs on)
OpenStage 60
OpenStage 60 with
1 OpenStage Key
Module 60
OpenStage 60 with
2 OpenStage Key
Module 60
OpenStage 80
OpenStage 80 with
1 OpenStage Key
Module 80
OpenStage 80 with
2 OpenStage Key
Module 80
Energy saving
mode
19/03/2012, page 5
4,7
4,9
5,1
5,3
5,8
4,9
5,1
3,6
4,4
5,1
5,9
5,3
7,0
7,7
4,7
5,6
6,4
7,3
6,6
8,7
9,3
4,0
4,7
5,5
6,3
5,6
7,4
8,3
5,0
5,9
6,8
7,7
7,0
9,0
10,0
4,5
5,2
6,2
6,9
6,4
OpenStage 60 G
7,8
9,3
Please see note *)
10,1
2
4,2 *)
5,3
8,4 *)
10,0
9,0 *)
10,7
*)
OpenStage 80 G
3,6
4,9
7,4
9,2
7,9
9,6
8,4
1
4,4
5,6
8,1
9,8
8,4
10,1
9,4
Please see note *)
10,3
2
4,5 *)
5,7
8,8 *)
10,6
9,2 *)
10,9
*)
*) These values are still within the 802.3af PD class 3, which allows up to 12,95 W, but they
are averaged, not maximum values. As soon as the USB interface is used, PD class 3 is
exceeded. Therefore, an external power supply has to be used for an OpenStage 60G/80G
with 2 Key Modules.
Ringing (max.
vol.)
During call
(handset)
3,6
3,8
4,0
4,1
4,6
3,8
4,0
1
-
Idle state
1
2
1
OpenStage 20 G
OpenStage 40 G
# of Key Modules
Energy saving
mode
5,3
6,3
7,4
7,9
7,4
9,4
10,3
11,0
10,0
10,6
11,5
19/03/2012, page 6
DHCP Options
The following parameters can be obtained by DHCP:
Basic Configuration
IP Address
Subnet Mask (option 1)
Optional Configuration
The vendor specific option (code 43), or alternatively, a vendor class, is used to provide the
phone with the location of an optional configuration/ provisioning service. By this means,
full Plug & Play is possible (see the following section). For further information, including an
example configuration for dhcp, please refer to the OpenStage Asterisk Admin Guide [3].
19/03/2012, page 7
parameters must be set or updated. When all these parameters have been sent to the phone,
it is ready for operation.
For further information, please refer to the WPI Developers Guide [8].
If a Firewall or NAT get in the Way
In case the phones and the provisioning service reside in different networks or subnets that
are separated by a firewall and/or NAT, it may be impossible for the provisioning service to
contact the phones.
To enable a solution for this problem, the phone can be configured to periodically poll
the provisioning service, or a special proxy, for new messages. Thus, provisioning service
driven interactions are possible even when the provisioning service is located behind a
firewall, or in a DMZ. For further information, please refer to the WPI Developers Guide [8],
Section 1.4.4.3, "Polling Request To Bridge A Firewall" and Section 3.1.2.2, "Provisioning
Service Located Behind A Firewall".
19/03/2012, page 8
Using OpenStage@Asterisk
This chapter contains some tips and tricks for operating OpenStage phones with Asterisk. It
is not intended to be exhaustive, but provides some major topics and solutions from
different successful customer projects.
XML Applications
OpenStage 60/80 phones feature a graphical user interface and an XML application platform,
which allows for developing custom applications based on HTTP/HTTPS. The phone acts as a
front-end for a server-side program. The interaction can be initiated by the phone or by the
server-side program. Besides displaying, modifying, and submitting data, XML applications
have the capability of starting calls on the phone. Possible uses for OpenStage XML
Applications might be
19/03/2012, page 9
19/03/2012, page 10
19/03/2012, page 11
MAA is automatically activated if line keys are configured at the phone. Line key
administration is done by the administrator; the user has no influence on these settings. The
phone operates as an MAA phone out of the box. Depending on the administrator settings,
the phone will react slightly different in basic user interactions.
Even if only one line key is configured, the phone changes into line presentation mode. The
line presentation mode helps the user to keep track of the different line statuses.
19/03/2012, page 12
19/03/2012, page 13
Basic Troubleshooting
For tracking network issues, the phone can execute ping and traceroute tests; these can be
controlled and viewed online using the WBM.
For elementary troubleshooting, the phone provides an overview about basic issues in the
user menu. The admin can ask the user to read that basic information to get a first hint
about the possible causes of an issue:
Problem Description
Network Problem No network connection
Not Initialised Waiting for data
Unable to use LAN 802.1x error
Unable to use LAN Physical connection missing
Unable to Register Server timeout
Unable to Register Server failed
Unable to Register Authentication failed
Unable to Register No number configured
Unable to Register No server configured
Unable to Register No registrar configured
Unable to Register No DNS domain configured
Unable to Register Rejected by server
Unable to Register No phone IP address set
Survivability Backup route active
Survivability Backup not configured
Survivability Backup timeout
Survivability Backup authentication failed
Error code
LI1
I1
LX1
LP1
RT2
RF2
RA2
RN2
RS2
RG2
RD2
RR2
RI2
B8
RS8
RT8
RA8
19/03/2012, page 14
19/03/2012, page 15
19/03/2012, page 16
Limitations
Not known yet :-)
References
[1] TIA-811-A: Performance and Interoperability Requirements for Voice-over-IP (VoIP)
Feature Telephones
(http://www.tiaonline.org/standards/technology/voip/documents/TIA-811-A-final-forglobal.pdf)
[2] Session Initiation Protocol (SIP)-Specific Event Notification: (RFC 3261)
[3] OpenStage Asterisk Admin Guide: (http://wiki.siemensenterprise.com/images/e/e1/Administration_Manual_OpenStage_Asterisk.pdf)
[4] WPI Guide: (http://wiki.siemensenterprise.com/images/c/c7/OpenStage_Provisioning_Interface_Developer%27s_Guide.p
df)
[5] Trace Guide Openstage SIP: http://wiki.siemensenterprise.com/images/1/1b/Service_Info_How_to_trace_OST_SIP.pdf
[6] Services for Computer Supported Telecommunications Applications (ECMA-269).
http://www.ecma-international.org/publications/standards/Ecma-269.htm
[7] Private Extensions to the Session Initiation Protocol (SIP) for Asserted Identity
within Trusted Networks: http://www.ietf.org/rfc/rfc3325.txt
[8] Provisioning Interface Developers Guide: http://wiki.siemensenterprise.com/images/c/c7/OpenStage_Provisioning_Interface_Developer%27s_Guide.p
df
[9] OpenStage XML Applications Developer's Guide: https://app-enterprise.siemensenterprise.com/gdmsproxy/retrieve?id=40776497
Abbreviations
AoR
Address of Record
BLA
Bridged Line Appearance
CCBS Call Completion Busy Subscriber
CCNR Call Completion No Reply
CTi
Computer Telephony Integration
FFK
Free Function Key
FPK
Free Programmable Key
HTTP Hypertext Transfer Protocol Overview
HTTPS HyperText Transfer Protocol Secure
MAA Multiple Address Appearance
MLA
Multiple Line Appearance
MSA
Multiple Station Appearance
MWI
Message Waiting Indication
SCA
Shared Call Appearance
SIP
Session Initiation Protocol
UA
User Agent
uaCSTA User Agent Computer Supported Telephony Application
19/03/2012, page 17