Table of Contents

Advertisement

Quick Links

Administrator's Guide for the
®
Polycom
®
®
SoundPoint
IP/SoundStation
IP
Family
SIP 3.1
August, 2008 Edition
1725-11530-310 Rev. A
SIP 3.1

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SIP 3.1 and is the answer not in the manual?

Questions and answers

Summary of Contents for Polycom SIP 3.1

  • Page 1 Administrator’s Guide for the ® Polycom ® ® SoundPoint IP/SoundStation Family SIP 3.1 August, 2008 Edition 1725-11530-310 Rev. A SIP 3.1...
  • Page 2 As between the parties, Polycom, Inc. retains title to, and ownership of, all proprietary rights with respect to the software contained within its products. The software is protected by United States copyright laws and international treaty provision.
  • Page 3: About This Guide

    For support or service, please contact your Polycom reseller or go to Polycom Technical Support at http://www.polycom.com/support/voice/. Polycom recommends that you record the phone model numbers, software (both the bootROM and SIP), and partner platform for future reference. SoundPoint IP / SoundStation IP models: ___________________________...
  • Page 4 Administrator’s Guide SoundPoint IP / SoundStation IP...
  • Page 5: Table Of Contents

    New Features in SIP 3.1 ........
  • Page 6 Administrator’s Guide SoundPoint IP / SoundStation IP Call Timer ..........4–3 Call Waiting .
  • Page 7 Contents Instant Messaging ......... . 4–30 Multilingual User Interface .
  • Page 8 Administrator’s Guide SoundPoint IP / SoundStation IP Custom Certificates ........4–81 Incoming Signaling Validation .
  • Page 9 Contents Directory <dir/> ......... . A–68 Presence <pres/>...
  • Page 10 Administrator’s Guide SoundPoint IP / SoundStation IP Transfer ........... B–9 Third Party Call Control .
  • Page 11: Introducing The Soundpoint Ip / Soundstation Ip Family

    1-6. SoundPoint IP Desktop Phones This section describes the current SoundPoint IP desktop phones. For individual guides, refer to the product literature available at http://www.polycom.com/support/voice/. Additional options are also available. For more information, contact your Polycom distributor. 1 - 1...
  • Page 12 Administrator’s Guide SoundPoint IP / SoundStation IP The currently supported desktop phones are: • SoundPoint IP 301 • SoundPoint IP 320/330 • SoundPoint IP 430 1 - 2...
  • Page 13 Introducing the SoundPoint IP / SoundStation IP Family • SoundPoint IP 501 • SoundPoint IP 550/560 • SoundPoint IP 600/601 1 - 3...
  • Page 14: Soundstation Ip Conference Phones

    SoundPoint IP 670 SoundStation IP Conference Phones This section describes the current SoundPoint IP conference phones. For individual guides, refer to the product literature available at http://www.polycom.com/support/voice/. Additional options are also available. For more information, contact your Polycom distributor. 1 - 4...
  • Page 15 Introducing the SoundPoint IP / SoundStation IP Family The currently supported conference phones are: • SoundStation IP 4000 • SoundStation IP 6000 • SoundStation IP 7000 1 - 5...
  • Page 16: Key Features Of Your Soundpoint Ip / Soundstation Ip Phones

    • Platform independent — Supports multiple protocols and platforms enabling standardization on one phone for multiple locations, systems and vendors — Polycom’s support of the leading protocols and industry partners makes it a future-proof choice • Field upgradeable — Upgrade SoundPoint IP / SoundStation IP as standards develop and protocols evolve —...
  • Page 17 Introducing the SoundPoint IP / SoundStation IP Family • Dual auto-sensing 10/100/1000baseT Ethernet ports — Leverages existing infrastructure investment — No re-wiring with existing CAT 5 cabling — Simplifies installation • Power over Ethernet (PoE) port — Unused pairs on Ethernet port pairs are used to deliver power to the phone via a wall adapter allowing fewer wires to desktop —...
  • Page 18 Administrator’s Guide SoundPoint IP / SoundStation IP 1 - 8...
  • Page 19: Overview

    Session Initiation Protocol Application Architecture • Available Features • New Features in SIP 3.1 To install your SoundPoint IP / SoundStation IP phones on the network, refer Setting up Your System on page 3-1. To configure your SoundPoint IP /...
  • Page 20: Where Soundpoint Ip / Soundstation Ip Phones Fit

    Administrator’s Guide SoundPoint IP / SoundStation IP System on page 4-1. To troubleshoot any problems with your SoundPoint IP / SoundStation IP phones on the network, refer to Troubleshooting Your SoundPoint IP / SoundStation IP Phones on page 5-1. Where SoundPoint IP / SoundStation IP Phones Fit The phones connect physically to a standard office twisted-pair (IEEE 802.3) 10/100 megabytes per second Ethernet LAN and send and receive all data using the same packet-based technology.
  • Page 21: Session Initiation Protocol Application Architecture

    Overview Session Initiation Protocol Application Architecture The software architecture of SIP application is made of 4 basic components: • BootROM—loads first when the phone is powered on • Application—software that makes the device a phone • Configuration—configuration parameters stored in separate files •...
  • Page 22: Application

    Administrator’s Guide SoundPoint IP / SoundStation IP 5. Download the master configuration file. This file is either called <MAC-address>.cfg or 000000000000.cfg . This file is used by the both the bootROM and the application for a list of other files that are needed for the operation of the phone.
  • Page 23: Configuration

    Overview 2. Controls all aspects of the phone after it has restarted. 3. Uploads log files. BootROM and Application Wrapper Both the bootROM and the application run on multiple platforms (meaning all previously released versions of hardware that are still supported). The file stored on the boot server is a wrapper, with multiple hardware specific images contained within.
  • Page 24 IP address of an application server. All phones in an installation usually share this category of files. Polycom recommends that you create another file with your organization’s modifications. If you must change any Polycom templates, back them up first.
  • Page 25: Resource Files

    Overview The following figure shows one possible layout of the central provisioning method. Manual Configuration When the manual configuration method is employed, any changes made are stored in a configuration override file. This file is stored on the phone, but a copy will also be uploaded to the central boot server if one is being used.
  • Page 26: Available Features

    Administrator’s Guide SoundPoint IP / SoundStation IP • Ring tones • Synthesized tones • Contact directories Available Features This section provides information the features available on the SoundPoint IP / SoundStation IP phones: • Basic User Features — Automatic Off-Hook Call Placement—Supports an optional automatic off-hook call placement feature for each registration.
  • Page 27 Overview — Customizable Audio Sound Effects—Audio sound effects used for incoming call alerting and other indications are customizable. — Directed Call Pick-Up Group Call Pick-Up—Calls to another phone can be picked up by dialing the extension of the other phone. Calls to another phone within a pre-defined group can be picked up without dialing the extension of the other phone.
  • Page 28 Administrator’s Guide SoundPoint IP / SoundStation IP — Missed Call Notification—The phone can display the number of calls missed since the user last looked at the Missed Calls list. — Soft Key Activated User Interface—The user interface makes extensive use of intuitive, context-sensitive soft key menus. —...
  • Page 29 Overview — Multiple Call Appearances—The phone supports multiple concurrent calls. The hold feature can be used to pause activity on one call and switch to another call. — Multiple Line Keys per Registration—More than one line key can be allocated to a single. —...
  • Page 30 Administrator’s Guide SoundPoint IP / SoundStation IP — Automatic Gain Control—Designed for hands-free operation, boosts the transmit gain of the local user in certain circumstances. — Background Noise Suppression—Designed primarily for hands-free operation, reduces background noise to enhance communication in noisy environments.
  • Page 31: New Features In Sip 3.1

    Note maintenance patch release of the SIP 2.1 software stream—currently SIP 2.1.3. Any new features introduced after SIP 2.1.3 are not supported. The following new features were introduced in SIP 3.1: • Access URL in SIP Message—Ability for the SoundPoint IP phones to be...
  • Page 32 Administrator’s Guide SoundPoint IP / SoundStation IP • Microbrowser—An XML API allows for the creation of more advanced applications. • Multilingual User Interface—Polish and Slovenian are now available as languages choices. Documentation of the newly released SoundPoint IP 560 and 670 desktop phones and SoundStation IP 6000 and 7000 conference phones has also been added.
  • Page 33: Setting Up Your System

    Configuration Files on page A-1. For installation and maintenance of Polycom SoundPoint IP / SoundStation IP phones, the use of a boot server is strongly recommended. This allows for flexibility in installing, upgrading, maintaining, and configuring the phone. Configuration, log, and directory files are normally located on this server.
  • Page 34: Setting Up The Network

    Basic network settings can be derived from DHCP, or entered manually using the phone’s LCD-based user interface, or downloaded from configuration files. Polycom recommends using DHCP where possible to eliminate repetitive manual data entry. The following table shows the manually entered networking parameters that...
  • Page 35 Setting up Your System Alternate Configuration File Local Parameter DHCP Option DHCP DHCP (application only) FLASH Refer to DHCP • • • boot server Menu on page address • • Note: This value SIP server address is configurable. SNTP server 42 then 4 •...
  • Page 36: Supported Provisioning Protocols

    Administrator’s Guide SoundPoint IP / SoundStation IP Supported Provisioning Protocols The bootROM performs the provisioning functions of downloading configuration files, uploading and downloading the configuration override file and user directory, and downloading the dictionary and uploading log files. The protocol that will be used to transfer files from the boot server depends on several factors including the phone model and whether the bootROM or SIP application stage of provisioning is in progress.
  • Page 37: Modifying The Network Configuration

    Setting up Your System Note Setting Option 66 to tftp://192.168.9.10 has the effect of forcing a TFTP download. Using a TFTP URL (for example, tftp://provserver.polycom.com) has the same effect. For downloading the bootROM and application images to the phone, the secure HTTPS protocol is not available.
  • Page 38 Administrator’s Guide SoundPoint IP / SoundStation IP Main Menu The following configuration parameters can be modified on the main setup menu: Name Possible Values Description DHCP Client Enabled, Disabled If enabled, DHCP will be used to obtain the parameters discussed in DHCP or Manual TCP/IP Setup on page 3-2.
  • Page 39 Setting up Your System Note A parameter value of “???” indicates that the parameter has not yet been set and saved in the phone’s configuration. Any such parameter should have its value set before continuing. The EM Power parameter is only available on SoundPoint IP 601 and 650 phones. To switch the text entry mode on the SoundPoint IP 330/320, press the #.
  • Page 40 Administrator’s Guide SoundPoint IP / SoundStation IP Possible Name Values Description Boot Server (continued) 1=Custom The phone will look for the option number specified by the Boot Server Option parameter (below), and the type specified by the Boot Server Option Type parameter (below) in the response received from the DHCP server.
  • Page 41 Setting up Your System Possible Name Values Description VLAN Discovery 0=Disabled No VLAN discovery through DHCP. (default) 1=Fixed Use predefined DHCP vendor-specific option values of 128, 144, 157 and 191. If this is used, the VLAN ID Option field will be ignored 2=Custom Use the number specified in the VLAN ID Option field as the...
  • Page 42 Administrator’s Guide SoundPoint IP / SoundStation IP Name Possible Values Description Server Address dotted-decimal IP address The boot server to use if the DHCP client is disabled, the DHCP server does not send a boot server option, or the domain name string Boot Server parameter is set to Static.
  • Page 43 1 = 10HD The default value is Auto. 2 = 10FD HD means half duplex and FD means full duplex. 3 = 100HD Note: Polycom recommends that you do not change this 4 = 100FD setting. 5 = 1000FD PC Port Mode 0 = Auto The network speed over the Ethernet.
  • Page 44: Setting Up The Boot Server

    Administrator’s Guide SoundPoint IP / SoundStation IP The syslog protocol is a very simplistic protocol: the syslog sender sends a small textual message (less than 1024 bytes) to the syslog receiver. The receiver is commonly called “syslogd”, “syslog daemon” or “syslog server”. Syslog messages can be sent through UDP, TCP, or TLS.
  • Page 45 Use this procedure as a recommendation if this is your first boot server setup. 1. Install boot server application or locate suitable existing server(s). Polycom recommends that you use RFC-compliant servers. 2. Create account and home directory. If the provisioning protocol requires an account name and password, the server Note account name and password must match those configured in the phones.
  • Page 46: Deploying Phones From The Boot Server

    Boot Server Security Policy You must decide on a boot server security policy. Polycom recommends allowing file uploads to the boot server where the security environment permits. This allows event log files to be uploaded and changes made by the phone user to the configuration (through the web server and local user interface) and changes made to the directory to be backed up.
  • Page 47 Setting up Your System Multiple boot servers can be configured by having the boot server DNS name map to multiple IP addresses. The default number of boot servers is one and the maximum number is eight. HTTPS, HTTP, and FTP are supported for redundant boot servers.
  • Page 48 For more information on why to create another configuration file, refer to the Note “Configuration File Management on SoundPoint IP Phones” whitepaper at www.polycom.com/support/voice/ For more information, especially on the SIP server address, refer to <SIP/> on page A-10.
  • Page 49 Setting up Your System Edit the CONFIG_FILES attribute of the <Ethernet address>.cfg files so that it references the appropriate sipXXXX.cfg file. For example, replace the reference to sip.cfg with sip650.cfg. Edit the LOG_FILE_DIRECTORY attribute of the <Ethernet address>.cfg files so that it points to the log file directory. Edit the CONTACT_DIRECTORY attribute of the <Ethernet address>.cfg files so that it points to the organization’s contact directory.
  • Page 50 Administrator’s Guide SoundPoint IP / SoundStation IP Provisioning SoundStation IP 7000 Phones Using CLink Normally the SoundStation IP family conference phone is provisioned over the Ethernet by the boot server. However, when two SoundStation IP family phones are daisy-chained together, the one that is not directly connected to the Ethernet can still be provisioned (known as the secondary).
  • Page 51: Upgrading Sip Application

    Setting up Your System Upgrading SIP Application You can upgrade the SIP application that is running on the SoundPoint IP and SoundStation IP phones in your organization. The exact steps that you perform are dependent on the version of the SIP application that is currently running on the phones and the version that want to upgrade to.
  • Page 52: Supporting Soundpoint Ip 300 And 500 Phones

    Mandatory changes must be made or the software may not behave as expected. For more information, refer to the “Configuration File Management on SoundPoint IP Phones” whitepaper at www.polycom.com/support/voice/ . 3. Save the new configuration files and images (such as sip.ld) on the boot server.
  • Page 53 Setting up Your System To upgrade your SIP application: 1. Do one of the following steps: Place the bootrom.ld file corresponding to BootROM revision 4.0.0 (or later) onto the boot server. Ensure that all phones are running BootROM 4.0.0 or later code. 2.
  • Page 54 Administrator’s Guide SoundPoint IP / SoundStation IP For more information, refer to “Technical Bulletin 35311: Supporting SoundPoint IP 300 and IP 500 Phones with SIP 2.2 and Later Releases“ at http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html 3 - 22...
  • Page 55: Configuring Your System

    Configuring Your System After you set up your SoundPoint IP / SoundStation IP phones on the network, you can allow users to place and answer calls using the default configuration, however, you may be require some basic changes to optimize your system for best results.
  • Page 56 Administrator’s Guide SoundPoint IP / SoundStation IP • Connected Party Identification • Context Sensitive Volume Control • Customizable Audio Sound Effects • Message Waiting Indication • Distinctive Incoming Call Treatment • Distinctive Ringing • Distinctive Call Waiting • Do Not Disturb •...
  • Page 57: Call Log

    Configuring Your System Call Log The phone maintains a call log. The log contains call information such as remote party identification, time and date, and call duration. It can be used to redial previous outgoing calls, return incoming calls, and save contact information from call log entries to the contact directory.
  • Page 58: Called Party Identification

    Administrator’s Guide SoundPoint IP / SoundStation IP Called Party Identification The phone displays and logs the identity of the remote party specified for outgoing calls. This is the party that the user intends to connect with. There are no related configuration changes. Calling Party Identification The phone displays the caller identity, derived from the network signalling, when an incoming call is presented, if the information is provided by the call...
  • Page 59: Connected Party Identification

    Configuring Your System Configuration changes can performed centrally at the boot server: Central Configuration file: Turn this feature on or off. (boot server) sip.cfg • For more information, refer to Feature <feature/> on page A-92. Configuration file: Specify per-registration whether all missed-call events or only phone1.cfg remote/server-generated missed-call events will be displayed.
  • Page 60: Message Waiting Indication

    Administrator’s Guide SoundPoint IP / SoundStation IP Note L16/16000 is not supported on SoundPoint IP 301 and SoundStation IP 4000 phones. L16/32000 and L16/48000 are only supported on SoundPoint IP 7000 phones. Note The alternate sampled audio sound effect files must be present on the boot server or the Internet for downloading at boot time.
  • Page 61: Distinctive Ringing

    Configuring Your System Distinctive Ringing There are three options for distinctive ringing: 1. The user can select the ring type for each line. This option has the lowest priority. 2. The ring type for specific callers can be assigned in the contact directory. For more information, refer to Distinctive Incoming Call Treatment, the...
  • Page 62: Do Not Disturb

    Administrator’s Guide SoundPoint IP / SoundStation IP Do Not Disturb A Do Not Disturb (DND) feature is available to temporarily stop all incoming call alerting. Calls can optionally be treated as though the phone is busy while DND is enabled. DND can be configured as a per-registration feature. Incoming calls received while DND is enabled are logged as missed.
  • Page 63: Local Contact Directory

    Only the SoundPoint IP 320, 330, 430, 550, 560, 650, and 670 desktop phones can be configured to use the electronic hookswitch. For more information, refer to “Technical Bulletin 35150: Using an Electronic Hookswitch with SountPoint IP Phones“at http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html Configuration changes can performed centrally at the boot server or locally: Central Configuration file: Enable or disable persistent headset mode.
  • Page 64 Administrator’s Guide SoundPoint IP / SoundStation IP Note If a user makes a change to the local contact directory, there is a five second timeout before it is uploaded to the boot server as <mac-address>-directory.cfg. Configuration changes can performed centrally at the boot server or locally: Central Configuration file: Set whether the directory uses volatile storage on the phone...
  • Page 65 Configuring Your System <ct>1001</ct> <sd>1</sd> <rt>1</rt> <dc/> <ad>0</ad> <ar>0</ar> <bw>0</bw> <bb>0</bb> </item> <item> <lb>Dr</lb> <ln>Smith</ln> <fn>Bill</fn> <ct>1003</ct> <sd>3</sd> <rt>3</rt> <dc/> <ad>0</ad> <ar>0</ar> <bw>0</bw> <bb>0</bb> </item> </item_list> </directory> Element Permitted Values Interpretation UTF-8 encoded string label of up to 40 bytes Note: In some cases, this will be less than 40 characters due to UTF-8’s variable length encoding.
  • Page 66: Local Digit Map

    Administrator’s Guide SoundPoint IP / SoundStation IP Element Permitted Values Interpretation Null, 1 to 9999 speed-dial index Associates a particular entry with a speed dial bin for one-touch dialing or dialing from the speed dial menu. Note: On the SoundPoint IP 330/320 and the SoundStation IP 6000 and 7000, the maximum speed-dial index is 99.
  • Page 67: Microphone Mute

    Configuring Your System Configuration changes can performed centrally at the boot server or locally: Central Configuration file: Specify impossible match behavior, trailing # behavior, digit map sip.cfg matching strings, and time out value. (boot server) • For more information, refer to Dial Plan <dialplan/>...
  • Page 68: Time And Date Display

    Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can performed centrally at the boot server or locally: Central XML file: The <sd>x</sd> element in the <Ethernet address>-directory.xml file links a directory entry to a speed dial resource within the phone. (boot server) <Ethernet Speed dial entries are mapped automatically to unused line keys (line...
  • Page 69: Idle Display Animation

    Configuring Your System Local Web Server Set the basic SNTP and daylight savings settings. (if enabled) Navigate to: http://<phoneIPAddress>/coreConf.htm#ti Changes are saved to local flash and backed up to <Ethernet address>-phone.cfg on the boot server. Changes will permanently override global settings unless deleted through the Reset Local Config menu selection and the <Ethernet address>-phone.cfg is removed from the boot server.
  • Page 70: Graphic Display Backgrounds

    Administrator’s Guide SoundPoint IP / SoundStation IP AC power adapter or can be line-powered (power supplied through the signaling or idle pairs of the LAN Ethernet cable). Line powering typically requires that the phone plugs directly into a dedicated LAN jack. Devices that do not require LAN power can then plug into the SoundPoint IP PC Ethernet port.
  • Page 71: Automatic Off-Hook Call Placement

    For images, select a filename. For example: bg.hiRes.gray.bm.3.name=”polycom.jpg” bg.hiRes.gray.bm.3.em.name=”polycomEM.jpg” bg.hiRes.gray.bm.3.adj=”0” The default size for images on a phone is 320 x 160. The default size for images on an Expansion Module is 160 x 320. Use a photo editor on a computer to adjust the image you want to display.
  • Page 72: Call Transfer

    Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can performed centrally at the boot server or locally: Central Configuration file: Specify whether RFC 2543 (c=0.0.0.0) or RFC 3264 (a=sendonly or sip.cfg a=inactive) outgoing hold signaling is used. (boot server) •...
  • Page 73: Local / Centralized Conferencing

    This feature requires a license key for activation on all phones except the SoundStation IP 7000. Using this feature may require purchase of a license key or activation by Polycom channels. For more information, contact your Certified Polycom Reseller. 4 - 19...
  • Page 74: Call Forward

    Administrator’s Guide SoundPoint IP / SoundStation IP The individual parties within a conference can be managed. New parties can be added and information about the conference participants can be viewed (for example, names, phone numbers, send/receive status or media flow, receive and transmit codecs, and hold status).
  • Page 75: Directed Call Pick-Up

    Configuring Your System The Diversion field with a SIP header is often used by the call server to inform the phone of a call’s history. For example, when a phone has been set to enable call forwarding, the Diversion header allows the receiving phone to indicate who the call was from, and from which phone number it was forwarded.
  • Page 76: Group Call Pick-Up

    Administrator’s Guide SoundPoint IP / SoundStation IP Group Call Pick-Up Calls to another phone within a pre-defined group can be picked up without dialing the extension of the other phone. This feature depends on support from a SIP server. Configuration changes can performed centrally at the boot server: Central Configuration file: Turn this feature on or off.
  • Page 77 Configuring Your System • Bridged Line Appearance • Busy Lamp Field • Customizable Fonts and Indicators • Instant Messaging • Multilingual User Interface • Downloadable Fonts • Synthesized Call Progress Tones • Microbrowser • Real-Time Transport Protocol Ports • Network Address Translation •...
  • Page 78: Configurable Feature Keys

    Administrator’s Guide SoundPoint IP / SoundStation IP Configurable Feature Keys All key functions can be changed from the factory defaults. The scrolling timeout for specific keys can be configured. Note No feature keys on the SoundStation IP 4000, 6000, or 7000 can be remapped. Since there is no Redial key on the SoundPoint IP 330/320 phone, the redial function cannot be remapped.
  • Page 79: Multiple Line Keys Per Registration

    Configuring Your System Multiple Line Keys per Registration More than one Line Key can be allocated to a single registration (phone number or line) on SoundPoint IP phones. The number of Line Keys allocated per registration is configurable. Configuration changes can performed centrally at the boot server or locally: Central Configuration file: Specify the number of line keys to assign per registration.
  • Page 80: Shared Call Appearances

    Administrator’s Guide SoundPoint IP / SoundStation IP Local Web Server Specify the default number of calls that can be active or on hold per line key and the number of calls per registration that can be active or (if enabled) on hold per line key assigned to that registration.
  • Page 81: Bridged Line Appearance

    Configuring Your System Configuration changes can performed centrally at the boot server or locally: Central Configuration file: Specify whether diversion should be disabled on shared lines. sip.cfg (boot server) • For more information, refer to Shared Calls <shared/> on page A-67.
  • Page 82: Busy Lamp Field

    Administrator’s Guide SoundPoint IP / SoundStation IP simultaneously. This feature is dependent on support from a SIP server that binds the appearances together logically and looks after the necessary state notifications and performs an access control function. For more information, refer to Bridged Line Appearance Signaling on page B-10.
  • Page 83: Customizable Fonts And Indicators

    In the SIP 3.1 release, the BLF feature is updated for the following: • Visual indication when a remote line is in an alerting state •...
  • Page 84: Instant Messaging

    Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can performed centrally at the boot server: Central (boot Configuration File: Specify fonts to overwrite existing ones or specify new fonts. server) sip.cfg • For more information, refer to Fonts <font/> on page A-72.
  • Page 85: Downloadable Fonts

    Configuring Your System The SoundPoint IP and SoundStation IP user interface is available in the following languages by default: Chinese (if displayable), Danish, Dutch, English, French, German, Italian, Japanese (if displayable), Korean (if displayable), Norwegian, Polish, Portuguese, Russian, Slovenian, Spanish, and Swedish.
  • Page 86: Synthesized Call Progress Tones

    Administrator’s Guide SoundPoint IP / SoundStation IP Synthesized Call Progress Tones In order to emulate the familiar and efficient audible call progress feedback generated by the PSTN and traditional PBX equipment, call progress tones are synthesized during the life cycle of a call. These call progress tones are easily configurable for compatibility with worldwide telephony standards or local preferences.
  • Page 87: Real-Time Transport Protocol Ports

    Configuring Your System Configuration changes can performed centrally at the boot server or locally: Central Configuration file: Specify the Application browser home page, a proxy to use, and size sip.cfg limits. (boot server) • For more information, refer to Microbrowser <mb/> on page A-95.
  • Page 88: Network Address Translation

    Corporate Directory Note This feature requires a license key for activation. Using this feature may require purchase of a license key or activation by Polycom channels. For more information, contact your Certified Polycom Reseller. 4 - 34...
  • Page 89 In the latter case, the sorting is performed on the phone. Polycom recommends using corporate directories that have server-side sorting. Polycom recommends that you consult your LDAP Administrator when making any configuration changes for this feature. The corporate directory can be browsed or searched. Entries retrieved from the LDAP server can be saved to the local contact directory on the phone.
  • Page 90 Administrator’s Guide SoundPoint IP / SoundStation IP This section contains the following information: • Corporate Directory LDAP Attributes • Browsing the Corporate Directory • Configuration File Example Corporate Directory LDAP Attributes The entry attributes in the corporate directory are mapped through sip.cfg configuration file attributes to the LDAP attributes first_name, last_name, phone_number, and others so the SIP application knows how to use them for searching, dialing, or saving to the local contact directory.
  • Page 91: Recording And Playback Of Audio Calls

    This feature requires a license key for activation. Using this feature may require Note purchase of a license key or activation by Polycom channels. For more information, contact your Certified Polycom Reseller. SoundPoint IP phones that have a USB port can be configured to allow recording of audio calls on a supported USB device.
  • Page 92: Daisy-Chaining Phones

    The user controls which calls are recorded and played back. For a list of supported USB devices, refer to “Technical Bulletin 38084: SoundPoint IP 650 and 670 Supported USB Devices for Recording“ at http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html . Configuration changes can be performed centrally at the boot server:...
  • Page 93: Provisioning Phones Over Clink

    Configuring Your System Instructions for daisy-chaining SoundStation IP family conference phones are available in the SoundStation IP 7000 User Guide. Provisioning Phones Over CLink Normally the SoundStation IP family conference phone is provisioned over the Ethernet by the boot server. However, when two SoundStation IP family phones are daisy-chained together, the one that is not directly connected to the Ethernet can still be provisioned (known as the secondary).
  • Page 94: Enhanced Feature Keys

    Note The Enhanced Feature Key feature from SIP 3.0 is compatible with Enhanced Feature Key feature from SIP 3.1 . However, improvements have been made, and Polycom recommends that existing configuration files be reviewed and updated. Customers replacing legacy telephony PBX or key system would like to get equivalent functionality from their new VoIP telephony system.
  • Page 95 The different blocks of the enhanced feature key definitions are uniquely identified by number following efk.efklist prefix (for example, efk.efklist.1.<suffix>). In SIP 3.1, a maximum of 50 element groups is supported, however, the exact Note number is dependent on available RAM and processing speed. The disabled elements are included in the total count.
  • Page 96 This element describes the behavior of the user prompts. The different blocks are uniquely identified by number following efk.efkprompt prefix (for example, efk.efkprompt.1.<suffix>). In SIP 3.0, a maximum of four user prompts were supported. In SIP 3.1, a Note maximum of ten user prompts are supported.
  • Page 97 If this parameter is omitted or has an invalid value (including Null), the enhanced feature key is disabled. Note In SIP 3.0, “1” is the only supported version. In SIP 3.1, “2” is the only supported version. Special Characters The following special characters are used to implement the enhanced feature key functionality: •...
  • Page 98 Administrator’s Guide SoundPoint IP / SoundStation IP Macro names and action strings cannot contain these characters. If they do, unpredictable results may occur. Macro Definition The action.string in the efklist element can be defined by either: • Macro Action • Prompt Macro Substitution •...
  • Page 99 • refer Note: Polycom recommends that you always define this field. If it is not defined, the supplied digits will be dialed using INVITE (if no active call) or DTMF (if an active call). The use of refer method is call server dependentand may require the addition of star codes.
  • Page 100 A sample configuration for this feature—including the enhanced feature keys definitions shown in the following section, Examples— may be included with the SIP 3.1 release. Create a new configuration file in the style of sip.cfg in order to make configuration changes.
  • Page 101 50 macro substitutions is reached). Examples For BroadWorks specific examples, refer to “Technical Bulletin 42250: Using Enhanced Feature Keys and Configurable Soft Keys on SoundPoint IP Phones with BroadWorks” at http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html For specific examples for other call servers, go to http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html...
  • Page 102 Administrator’s Guide SoundPoint IP / SoundStation IP Configuration File Changes You must make the the following changes to the <feature/> parameter that is defined in the sip.cfg configuration file: <feature feature.18.name="enhanced-feature-keys" feature.18.enabled="1"/> Action String Example The action string “$Changup$*444*$P1N4$$Tinvite$$Cwaitconnect$$P2N3$$Cpause2$$Tdt mf$$Changup$” is executed as follows: 1.
  • Page 103 Configuring Your System efk.efkprompt.1.userfeedback="visible" efk.efkprompt.1.type="numeric" efk.efkprompt.1.digitmatching="style1" /> Contact Directory Changes You must make the following contact directory changes for the definition of “Call Park”: <directory> <item_list> <item> <fn>Call Park</fn> <ct>!callpark</ct> <sd>2</sd> <rt>4</rt> <ad>0</ad> <ar>0</ar> <bw>0</bw> <bb>0</bb> </item> </item_list> </directory> To avoid users accidently deleting the definitions in the contact directory, make the Note contact directory read only.
  • Page 104: Configurable Soft Keys

    Administrator’s Guide SoundPoint IP / SoundStation IP To use the Call Park key during an active call: 1. When there is an active call on line 2233: Select the Call Park soft key. The Call Park screen appears. Enter the number where you want to park the active call, then select the Next soft key.
  • Page 105 Configuring Your System • Directly into an Enhanced Feature Key macro • Directly into a URL • A chained list of actions It is possible to disable the display of specific standard keys—the soft keys that are displayed on SoundStation IP and SoundStation IP phones—to make room for other soft keys that your organization wants displayed.
  • Page 106 Configuration File Examples For BroadWorks specific examples, refer to “Technical Bulletin 42250: Using Enhanced Feature Keys and Configurable Soft Keys on SoundPoint IP Phones with BroadWorks” at http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html For specific examples on other call servers, go to http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html To disable the New Call soft key: 1.
  • Page 107 Configuring Your System To map a chained list of actions to a soft key: 1. Configure speed dial index 2 in contact directory with a regular phone number. For example, enter “2900” in the contact field. 2. Configure speed dial index 1 in contact directory with “!2” in contact field.
  • Page 108: Voice Mail Integration

    Administrator’s Guide SoundPoint IP / SoundStation IP Voice Mail Integration The phone is compatible with voice mail servers. The subscribe contact and callback mode can be configured per user/registration on the phone. The phone can be configured with a SIP URL to be called automatically by the phone when the user elects to retrieve messages.
  • Page 109: Multiple Registrations

    Configuring Your System Multiple Registrations The SoundPoint IP 301, 320, 330, and 430 support a maximum of two registrations, the SoundPoint IP 501 supports three, the SoundPoint IP 550 and 560 supports four, and the SoundPoint IP 600, 601, and 650 support 6. Up to three SoundPoint IP Expansion Modules can be added to a single host SoundPoint IP 601 and 650 phone increasing the total number of buttons to 12 registrations on the SoundPoint IP 601 and 34 registrations on the SoundPoint...
  • Page 110: Automatic Call Distribution

    Administrator’s Guide SoundPoint IP / SoundStation IP Local Local Phone User Use the SIP Configuration menu to specify the local SIP signaling (continued) Interface port, a default SIP server to register to and registration information for up to twelve registrations (depending on the phone model). The SIP Configuration menu contains a sub-set of all the parameters available in the configuration files.
  • Page 111 (for example, shared lines, presence, and Message Waiting Indicator). Polycom phones support configuration of multiple servers per SIP registration for this purpose. In some cases, a combination of the two may be deployed.
  • Page 112 Administrator’s Guide SoundPoint IP / SoundStation IP SRV records will be tried, before falling back on A records if NAPTR and SRV records return no results. If no port is given, and none is found through DNS, 5060 will be used. Refer to http://www.ietf.org/rfc/rfc3263.txt for an example.
  • Page 113 Configuring Your System Hosted VoIP Service Provider Call Server 1B Call Server 1A Internet DNS Server VoIP SMB Customer Premise SIP Capable Router Server2 PSTN PSTN Gateway Phone Configuration The phones at the customer site are configured as follows: • Server 1 (the primary server) will be configured with the address of the service provider call server.
  • Page 114: Presence

    Administrator’s Guide SoundPoint IP / SoundStation IP until the registration is successful (for example, when the Internet link is once again operational). While the primary server registration is unavailable, the next highest priority server in the list will serve as the working server. As soon as the primary server registration succeeds, it will return to being the working server.
  • Page 115: Microsoft Live Communications Server 2005 Integration

    Any contacts added through the SoundPoint IP phone’s buddy list will appear in as Note a contact in Microsoft Office Communicator and Windows Messenger. Polycom recommends that the BLF not be used in conjunction with the Microsoft Live Communications Server 2005 feature. For more information, refer to Busy Lamp Field on page 4-28.
  • Page 116 Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can performed centrally at the boot server: Central Configuration file: Specify that support for Microsoft Live Communications Server 2005 sip.cfg is enabled. (boot server) • For more information, refer to SIP <SIP/> on page A-10.
  • Page 117 Configuring Your System Locate the voIpProt parameter. Set the voIpProt.server.x.transport attribute to TCPpreferred or TLS. Your selection depends on the LCS configuration. Note The TLS protocol is not supported on SoundPoint IP 300 and 500 phones. Set the voIpProt.server.x.address to the LCS address. For example, voIpProt.server.1.address = "lcs2005.local"...
  • Page 118 Administrator’s Guide SoundPoint IP / SoundStation IP To set up a dual registration with Microsoft Live Communications Server 2005 as the presence server: 1. (Optional) Modify the sip.cfg configuration file as follows: Open sip.cfg in an XML editor. Locate the feature parameter. For the feature.1.name = presence attribute, set feature.1.enabled to 1.
  • Page 119: Access Url In Sip Message

    Configuring Your System Set the roaming_privacy.reg element to the number corresponding to the LCS registration. For example, roaming_privacy.reg = 2 Refer to Roaming Privacy <roaming_privacy/> on page A-123. m Save the modified phone1.cfg configuration file. Access URL in SIP Message Introduced in SIP 2.2, this feature that allows information contained in incoming SIP signaling to refer to XHTML web content that can be rendered by the SoundPoint IP phone’s Microbrowser.
  • Page 120 Administrator’s Guide SoundPoint IP / SoundStation IP User Interface There are three user interface aspects to this feature: • Web content status indication • Web content retrieval (spontaneous and on-demand) • Settings menu item to control active versus passive behaviour Web Content Status Indication When valid web content (validity is determined through a SIP header parameter) is available for a SIP call, it is indicated by an icon that appears after...
  • Page 121 Currently only the HTTP scheme is supported. So an example header might look like: Access-URL: <http://server.polycom.com/content23456.xhtml> This header may be placed in SIP requests and responses, as appropriate so long as the messages are part of an INVITE-initiated dialog and the phone can associate them with an existing phone call.
  • Page 122: Static Dns Cache

    IP addresses. Unfortunately, some customer’s are unable to configure the DNS to take advantage of failover redundancy. The solution in SIP 3.1 is to provide the ability to statically configure a set of DNS NAPTR SRV and/or A records into the phone.
  • Page 123 Configuration File Examples Polycom recommends that you create another file with your organization’s modifications. If you must change any Polycom templates, back them up first. For more information, refer to the “Configuration File Management on SoundPoint IP Phones” whitepaper at www.polycom.com/support/voice/.
  • Page 124 Administrator’s Guide SoundPoint IP / SoundStation IP reg.1.server.1.transport="UDPOnly" reg.1.server.2.address="172.23.0.150" reg.1.server.2.port="5075" reg.1.server.2.transport="UDPOnly" When the static DNS cache is used, the sip.cfg configuration would look as follows: reg.1.address="1001" reg.1.server.1.address="sipserver.example.com" reg.1.server.1.port="5075" reg.1.server.1.transport="UDPOnly" reg.1.server.2.address="" reg.1.server.2.port="" reg.1.server.2.transport="" dns.cache.A.1.name="sipserver.example.com" dns.cache.A.1.ttl="3600" dns.cache.A.1.address="172.23.0.140" dns.cache.A.2.name="sipserver.example.com" dns.cache.A.2.ttl="3600" dns.cache.A.2.address="172.23.0.150" Note Above addresses are presented to SIP application in order, for example, dns.cache.A.1, dns.cache.A.2, and so on.
  • Page 125 Configuring Your System reg.1.server.2.address="" reg.1.server.2.port="" reg.1.server.2.transport="" dns.cache.SRV.1.name="_sip._udp.sipserver.example.com " dns.cache.SRV.1.ttl= "3600" dns.cache.SRV.1.priority="1" dns.cache.SRV.1.weight="1" dns.cache.SRV.1.port="5075" dns.cache.SRV.1.target="primary.sipserver.example.com" dns.cache.SRV.2.name="_sip._udp.sipserver.example.com " dns.cache.SRV.2.ttl= "3600" dns.cache.SRV.2.priority="2" dns.cache.SRV.2.weight="1" dns.cache.SRV.2.port="5075" dns.cache.SRV.2.target="secondary.sipserver.example.com Note The reg.1.server.1.port and reg.1.server.2.port values in this example are set to null to force SRV lookups. Example 3 This example shows how to configure static DNS cache where your DNS provides NAPTR and SRV records for server.X.address .
  • Page 126: Display Of Warnings From Sip Headers

    Administrator’s Guide SoundPoint IP / SoundStation IP dns.cache.NAPTR.1.preference="1" dns.cache.NAPTR.1.flag="s" dns.cache.NAPTR.1.service=" SIP+D2U" dns.cache.NAPTR.1.regexp="" dns.cache.NAPTR.1.replacement="_sip._udp.sipserver.example.com" dns.cache.SRV.1.name="_sip._udp.sipserver.example.com " dns.cache.SRV.1.ttl= "3600" dns.cache.SRV.1.priority="1" dns.cache.SRV.1.weight="1" dns.cache.SRV.1.port="5075" dns.cache.SRV.1.target="primary.sipserver.example.com" dns.cache.SRV.2.name="_sip._udp.sipserver.example.com " dns.cache.SRV.2.ttl= "3600" dns.cache.SRV.2.priority="2" dns.cache.SRV.2.weight="1" dns.cache.SRV.2.port="5075" dns.cache.SRV.2.target="secondary.sipserver.example.com dns.cache.A.1.name="primary.sipserver.example.com" dns.cache.A.1.ttl="3600" dns.cache.A.1.address="172.23.0.140" dns.cache.A.2.name="secondary.sipserver.example.com" dns.cache.A.2.ttl="3600" dns.cache.A.2.address="172.23.0.150" Note The reg.1.server.1.port, reg.1.server.2.port, reg.1.server.1.transport, and reg.1.server.2.transport values in this example are set to null to force NAPTR lookups.
  • Page 127: Setting Up Audio Features

    Configuring Your System For example, if a user parks a call, the following message appears on their phone: Configuration changes can be performed centrally at the boot server: Central Configuration file: Turn this feature on or off and specify which warnings are sip.cfg displayable.
  • Page 128: Low-Delay Audio Packet Transmission

    Administrator’s Guide SoundPoint IP / SoundStation IP • Dynamic Noise Reduction • Treble/Bass Controls Low-Delay Audio Packet Transmission The phone is designed to minimize latency for audio packet transmission. There are no related configuration changes. Jitter Buffer and Packet Error Concealment The phone employs a high-performance jitter buffer and packet error concealment system designed to mitigate packet inter-arrival jitter and out-of-order or lost (lost or excessively delayed by the network) packets.
  • Page 129: Dtmf Tone Generation

    Configuring Your System packets (also known as Silence Insertion Descriptor (SID) frames) and also decodes CN packets, efficiently regenerating a facsimile of the background noise at the remote end. Configuration changes can performed centrally at the boot server: Central Configuration file: Enable or disable VAD and set the detection threshold.
  • Page 130: Audio Codecs

    Administrator’s Guide SoundPoint IP / SoundStation IP When using the handset on any SoundPoint IP phones, AEC is not normally required. In certain situations, where echo is experienced by the far-end party, when the user is on the handset, AEC may be enabled to reduce/avoid this echo.
  • Page 131: Background Noise Suppression

    Configuring Your System Effective Sample audio Algorithm MIME Type Ref. Bit Rate Rate Frame Size bandwidth Siren14 SIREN14/ SIREN14 24 Kbps 32 Ksps 20ms - 80ms 14 KHz 16000 32 Kbps 48 Kbps Siren22 SIREN22/ SIREN22 32 Kbps 32 Ksps 20ms - 80ms 14 KHz 48000...
  • Page 132: Automatic Gain Control

    Administrator’s Guide SoundPoint IP / SoundStation IP systems. This feature uses noise synthesis techniques to smooth out the noise level in the direction toward the remote user, providing a more natural call experience. There are no related configuration changes. Automatic Gain Control Automatic Gain Control (AGC) is applicable to hands-free operation and is used to boost the transmit gain of the local talker in certain circumstances.
  • Page 133: Voice Quality Monitoring

    Note This feature requires a license key for activation. Using this feature may require purchase of a license key or activation by Polycom channels. For more information, contact your Certified Polycom Reseller. The SoundPoint IP phones can be configured to generate various quality metrics for listening and conversational quality.
  • Page 134: Dynamic Noise Reduction

    Administrator’s Guide SoundPoint IP / SoundStation IP A wide range of performance metrics are generated. Some are based on current values, such as jitter buffer nominal delay and round trip delay, while others cover the time period from the beginning of the call until the report is sent, such as network packet loss.
  • Page 135: Local User And Administrator Privilege Levels

    SSL Security menu on the phone to provide the URL of the custom certificate then select an option to use this custom certificate. Note For more information on using custom certificates, refer to “Technical Bulletin 17877: Using Custom Certificates With SoundPoint IP Phones” at http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_Technical_Bulle tins_pub.html 4 - 81...
  • Page 136: Incoming Signaling Validation

    VoIP phone calls to avoid interception and eavesdropping on phone calls. For detailed configuration instructions, refer to “Technical Bulletin 25751: Secure Real-Time Transport Protocol on SoundPoint IP Phones” at http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html Configuration File Encryption Configuration files (excluding the master configuration file), contact directories, and configuration override files can all be encrypted.
  • Page 137: Configuring Soundpoint Ip / Soundstation Ip Phones Locally

    The web server will issue an authentication challenge to all pages except for the home page. Credentials are (case sensitive): User Name: Polycom Password: The administrator password is used for this. Local Settings Some items in the Settings menu are locked to prevent accidental changes.
  • Page 138 Administrator’s Guide SoundPoint IP / SoundStation IP Passwords: Administrator Network Configuration password SIP Configuration required. SSL Security settings Reset to Default - local configuration, device settings, and file system format User password Reboot Phone required. Changes made through the web server or local user interface are stored internally as overrides.
  • Page 139: Troubleshooting Your Soundpoint Ip / Soundstation Ip Phones

    • Upgrading Review the latest Release Notes for the SIP application for known problems and possible workarounds. For the latest Release Notes and the latest version of this Administrator’s Guide, go to Polycom Technical Support at http://www.polycom.com/support/voice/. 5 - 1...
  • Page 140: Error Messages

    Administrator’s Guide SoundPoint IP / SoundStation IP If your problems is not listed in this chapter nor described in the latest Release Notes, contact your Certified Polycom Reseller for support. Error Messages There are several different error messages that can be displayed on the phone when it is booting.
  • Page 141: Application Error Messages

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones Error, application is not present! There is no application stored in flash memory and the phone cannot boot. A compatible SIP application must be downloaded into the phone using one of the supported provisioning protocols. You need to resolve the issue of connecting to the boot server.
  • Page 142: Status Menu

    Administrator’s Guide SoundPoint IP / SoundStation IP Status When the phone is unable to register with the call control server, the icon is shown (outline). Once the phone is registered, the icon shown (solid). On the SoundStation IP 7000, the icons are Blinking Time If the phone has not been able to contact the SNTP server or if one has not been configured, the date/time display will flash until this is fixed.
  • Page 143: Log Files

    DSP events. Logging levels are adjusted in the configuration files or via the web interface. You should not modify the default logging levels unless directed to by Polycom Technical Support. Inappropriate logging levels can cause performance issues on the phone.
  • Page 144 Administrator’s Guide SoundPoint IP / SoundStation IP There are other logging parameters that you may wish to modify. Changing these parameters does not have the same impact as changing the logging levels, but you should still understand how your changes will affect the phone and the network.
  • Page 145 Troubleshooting Your SoundPoint IP / SoundStation IP Phones The following figure shows an example of a configuration file and the resulting log file. Manual Log Upload If you want to look at the log files without having to wait for the phone to upload them (which could take as long as 24 hours or more), initiate an upload by pressing correct combination of keys on the phone.
  • Page 146: Reading A Boot Log

    Administrator’s Guide SoundPoint IP / SoundStation IP Reading a Boot Log The following figure shows a portion of a boot log file: Boot Failure Messages The following figure shows an example of “Application sip.ld is not compatible with this phone!” boot failure messages: 5 - 8...
  • Page 147: Reading An Application Log

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones Reading an Application Log The following figure shows a portion of an application log file: Testing Phone Hardware To obtain more detailed troubleshooting information, you can access certain menus on the SoundPoint IP and SoundStation IP phone that test the phone hardware.
  • Page 148: Power And Startup

    Administrator’s Guide SoundPoint IP / SoundStation IP Power and Startup Symptom Problem Corrective Action There are power issues. The SoundPoint IP / Do one of the following: SoundStation IP family SIP • Verify that no lights appear on the unit phone has no power.
  • Page 149: Controls

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones Controls Symptom Problem Corrective Action The dial pad does not work. The dial pad on the SoundPoint Do one of the following: IP / SoundStation IP family SIP • Check for a response from other phone does not respond.
  • Page 150: Access To Screens And Systems

    Administrator’s Guide SoundPoint IP / SoundStation IP Access to Screens and Systems Symptom Problem Corrective Action There is no response from The SoundPoint IP / Do one of the following: feature key presses. SoundStation IP family SIP • Press the keys more slowly. phone is not in active state.
  • Page 151: Calling

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones Calling Symptom Problem Corrective Action There is no dial tone. Power is not correctly applied to Do one of the following: the SoundPoint IP family SIP • Check that the display is illuminated. phone.
  • Page 152: Displays

    Administrator’s Guide SoundPoint IP / SoundStation IP Displays Symptom Problem Corrective Action There is no display. Power is not correctly applied to Do one of the following: the SoundPoint IP family SIP The display is incorrect. • Check that the display is illuminated. phone.
  • Page 153: Audio

    Troubleshooting Audio and Echo Issues • Echo on external calls ® on SoundPoint IP Phones” at through a gateway. http://www.polycom.com/usa/en/support/v • Internal calls (no gateway), oice/soundpoint_ip/VoIP_Technical_Bullet handsfree echo. ins_pub.html • Internal calls (no gateway), handset to handset echo.
  • Page 154 Administrator’s Guide SoundPoint IP / SoundStation IP 5 - 16...
  • Page 155 Configuration Files This appendix provides detailed descriptions of certain configuration files used by the Session Initiation Protocol (SIP) application. It is a reference for all parameters that are configurable when using the centralized provisioning installation model. This appendix contains information on: •...
  • Page 156: Master Configuration Files

    If a phone does not find its own <Ethernet address>.cfg file, it will use this one, and establish a baseline configuration. This file is part of the standard Polycom distribution of configuration files. It should be used as the template for the <Ethernet address>.cfg files.
  • Page 157 For more information, refer to the “Configuration File Management on SoundPoint IP Phones” whitepaper at www.polycom.com/support/voice/ If you have a requirement for different application loads on different phones on the same boot server, you can create a variable in the master configuration file that is replaced by the MAC address of each phone when it reboots.
  • Page 158: Application Configuration

    APP_FILE_PATH_SPIP500=”SPIP500.sip.ld” CONFIG_FILES_SPIP500=”phone1_SPIP500.cfg, sip_SPIP500.cfg” /> For more information, refer to “Technical Bulletin 35361: Overriding Parameters in Master Configuration File on SoundPoint IP Phones“ at http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html Application Configuration The configuration file sip.cfg contains SIP protocol and core configuration settings that would typically apply to an entire installation and must be set...
  • Page 159 Configuration Files server interface or local menu settings on the phone. These settings include the local port used for SIP signaling, the address and ports of a cluster of SIP application servers, voice codecs, gains, and tones, and other parameters. These parameters include: •...
  • Page 160: Protocol

    Soft Keys <softkey/> Polycom recommends that you create another file with your organization’s modifications. If you must change any Polycom templates, back them up first. For more information, refer to the “Configuration File Management on SoundPoint IP Phones” whitepaper at www.polycom.com/support/voice/.
  • Page 161 Configuration Files Server <server/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voIpProt.server.dhcp.available 0, 1 If set to 1, check with the DHCP server for SIP server IP address. If set to 0, do not check with DHCP server. voIpProt.server.dhcp.option 128 to 255 Null...
  • Page 162 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation voIpProt.server.x.transport DNSnaptr or DNSnapt If set to Null or DNSnaptr: TCPpreferre If voIpProt.server.x.address is a d or hostname and voIpProt.server.x.port is 0 or UDPOnly or Null, do NAPTR then SRV look-ups to try to TLS or discover the transport, ports and servers, as TCPOnly...
  • Page 163 Configuration Files Permitted Attribute Values Default Interpretation voIpProt.server.x.retryMaxCount Null or If set to 0 or Null, 3 is used. retryMaxCount non-negativ retries will be attempted before moving on to e integer the next available server. voIpProt.server.x.expires.lineSeize positive Requested line-seize subscription period. integer, minimum 10 voIpProt.server.x.lcs...
  • Page 164 Administrator’s Guide SoundPoint IP / SoundStation IP SIP <SIP/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voIpProt.SIP.useContactInReferTo 0, 1 If set to 0, the “To URI” is used in the REFER. If set to 1, the “Contact URI” is used in the REFER.
  • Page 165 Configuration Files Permitted Attribute Values Default Interpretation voIpProt.SIP.connectionReuse. 0, 1 If set to 0, this is the old behavior. useAlias If set to 1, phone uses the connection reuse draft which introduces "alias". voIpProt.SIP.sendCompactHdrs 0, 1 If set to 0, SIP header names generated by the phone use the long form, for example ‘From’.
  • Page 166 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation voIpProt.SIP.authOptimizedInFailover If set to 1, when failover occurs, the first new SIP request is sent to the server that sent the proxy authentication request. If set to 0, when failover occurs, the first new SIP request is sent to the server with the highest priority in the server list.
  • Page 167 Configuration Files Permitted Attribute Values Default Interpretation voIpProt.SIP.header.list.useFirst 0, 1 If set to 1 or Null, the first diversion header is displayed. If set to 0, the last diversion header is displayed. voIpProt.SIP.header.warning.codes. comma Null A list of accepted warning codes. accept separated If set to Null, all codes are accepted.
  • Page 168 Administrator’s Guide SoundPoint IP / SoundStation IP Outbound Proxy <outboundProxy/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voIpProt.SIP.outboundProxy.address dotted-deci Null IP address or host name and port of a SIP mal IP server to which the phone shall send all address or requests.
  • Page 169 Configuration Files Alert Information <alertInfo/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voIpProt.SIP.alertInfo.x.value string to Null Alert-Info fields from INVITE requests will be compare compared against as many of these against the parameters as are specified (x=1, 2, ..., N) value of and if a match is found, the behavior Alert-Info...
  • Page 170 “SUBSCRIBE” or “NOTIFY”. If set to Null, all events will be validated. voIpProt.SIP.requestValidation. A valid string Polycom Determines string used for Realm. digest.realm SPIP Special Events <specialEvent/> This configuration attribute is defined as follows:...
  • Page 171: Dial Plan

    Configuration Files Music on Hold <musicOnHold/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voIpProt.SIP.musicOnHold.uri string Null A URI that provides the media stream to play for the remote party on hold. If reg.x.musicOnHold is set to Null, this attribute is checked.
  • Page 172 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation dialplan.applyToUserSend 0, 1 This attribute covers the case when the user presses the Send soft key to send the dialed number. Value interpretation is the same as for dialplan.applyToCallListDial.
  • Page 173 Configuration Files — For example, if a customer dials 16092345678, a call is placed to 16002345678. • 911xxx.T— A period (".") which matches an arbitrary number, including zero, of occurrences of the preceding construct — For example: 91112 with waiting time to comply with T is a match 911123 with waiting time to comply with T is a match 9111234 with waiting time to comply with T is a match and the number can grow indefinitely given that pressing the next...
  • Page 174 Administrator’s Guide SoundPoint IP / SoundStation IP This configuration attribute is defined as follows: Attribute Permitted Values Default Interpretation dialplan.digitmap string compatible with the [2-9]11|0T| When this attribute is digit map feature of present, number-only dialing +011xxx.T| MGCP described in 2.1.5 during the setup phase of 0[2-9]xxxxxxxxx| of RFC 3435.
  • Page 175: Localization

    Configuration Files Server <server/> This configuration attribute is defined as follows: Attribute Permitted Values Default Interpretation dialplan.routing.server.x. dotted-decimal IP address Null IP address or host name and port of address or host name a SIP server that will be used for routing calls.
  • Page 176 Administrator’s Guide SoundPoint IP / SoundStation IP Multilingual <ml/> The multilingual feature is based on string dictionary files downloaded from the boot server. These files are encoded in standalone XML format. Several western European and Asian languages are included with the distribution. Attribute Permitted Values Interpretation...
  • Page 177 Configuration Files Attribute Permitted Values Interpretation lcl.ml.lang.clock.x.longFormat 0, 1 If attribute present, overrides lcl.datetime.date.longFormat. If 1, display the day and month in long format (Friday/November), otherwise use abbreviations (Fri/Nov). lcl.ml.lang.clock.x.dateTop 0, 1 If attribute present, overrides lcl.datetime.date.dateTop. If 1, display date above time, otherwise display time above date.
  • Page 178 Administrator’s Guide SoundPoint IP / SoundStation IP 4. Add a lcl.ml.lang.clock.menu.x attribute to the configuration file. 5. Add lcl.ml.lang.clock.x.24HourClock, lcl.ml.lang.clock.x.format, lcl.ml.lang.clock.x.longFormat and lcl.ml.lang.clock.x.dateTop attributes and set them according to the regional preferences. 6. (Optional) Set lcl.ml.lang to be the new language_region string. Basic character support includes the following Unicode character ranges Name...
  • Page 179: User Preferences

    Configuration Files Date and Time <datetime/> This configuration attribute is defined as follows: Permitted Attribute Values Interpretation lcl.datetime.time.24HourClock If set to 1, display time in 24-hour clock mode rather than a.m./p.m. lcl.datetime.date.format string which Controls format of date string. includes ‘D’, ‘d’ D = day of week and ‘M’...
  • Page 180 2 dB > 10 kHz. up.audioSetup.auxInput 0 - Other Null Auxiliary audio input. Input, If set to Null, default value is 2. 1 - Polycom Wireless Mic, 2 - off up.audioSetup.auxOutput 0 - Other Null Auxiliary audio output. Input, If set to Null, default value is 2.
  • Page 181: Tones

    Configuration Files Permitted Attribute Values Default Interpretation up.mwiVisible 0 - Disabled If set to 0 or Null, there is no MWI for 1 - Enabled registration x (SIP 2.1.0 and 2.1.1 behavior). If set to 1, msg.mwi.x.callBackMode is set to disabled.
  • Page 182 Administrator’s Guide SoundPoint IP / SoundStation IP Dual Tone Multi-Frequency <DTMF/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation tone.dtmf.level -33 to -3 Level of the high frequency component of the DTMF digit measured in dBm0; the low frequency tone will be two dB lower.
  • Page 183 Configuration Files Permitted Attribute Values Default Interpretation tone.dtmf.viaRtp 0, 1 If set to 1, encode DTMF in the active RTP stream, otherwise, DTMF may be encoded within the signaling protocol only when the protocol offers the option. Note: tone.dtmf.chassis.masking should be enabled when tone.dtmf.viaRtp is disabled.
  • Page 184: Sampled Audio For Sound Effects

    Administrator’s Guide SoundPoint IP / SoundStation IP In the following table, x is the chord-set number and cat is one of callProg, ringer, or misc. Permitted Attribute Values Interpretation tone.chord.cat.x.freq.y 0-1600 Frequency for this component in Hertz; up to four chord-set components can be specified (y=1, 2, 3, 4).
  • Page 185: Sound Effects

    12-24 Not used. Note In SIP 3.1, the SoundPoint IP welcome sound was removed from saf.1 . If you want the welcome sound to be played when a phone reboots or restarts, set saf.1 to SoundPointIPWelcome.wav . Sound Effects <se/>...
  • Page 186 Administrator’s Guide SoundPoint IP / SoundStation IP This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation se.stutterOnVoiceMail 0, 1 If set to 1, stuttered dial tone is used in place of normal dial tone to indicate that one or more messages (voice mail) are waiting at the message center.
  • Page 187 Configuration Files Note Currently, patterns that use the sampled instruction are limited to the following format: sampled followed by optional silence and optional branch back to the beginning. In the following table, x is the pattern number, y is the instruction number. Both x and y need to be sequential.
  • Page 188 Administrator’s Guide SoundPoint IP / SoundStation IP Call progress pattern number Use within phone alternate call waiting tone (distinctive) confirmation tone howler tone (off-hook warning) record warning message waiting tone alerting intercom announcement tone barge-in tone secondary dial tone Ringer Patterns The following table maps ringer pattern numbers to their default descriptions.
  • Page 189 Configuration Files Ringer pattern number Default description Sampled audio file 7 Sampled audio file 8 Sampled audio file 9 Sampled audio file 10 Sampled audio file 11 Note Silent Ring will only provide a visual indication of an incoming call, but no audio indication.
  • Page 190 Administrator’s Guide SoundPoint IP / SoundStation IP Ring type <rt/> Ring type is used to define a simple class of ring to be applied based on some credentials that are usually carried within the network protocol. The ring class includes attributes such as call-waiting and ringer index, if appropriate. The ring class can use one of four types of ring that are defined as follows: ring Play a specified ring pattern or call waiting indication.
  • Page 191: Voice Settings

    Configuration Files Note Modification of se.rt.modification.enabled and se.rt.x.name parameters through the user interface will be implemented in a future release. Voice Settings <voice/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voice.txPacketFilter 0, 1 Null Flag to determine whether or not narrowband Tx high-pass filtering should be enabled.
  • Page 192 Administrator’s Guide SoundPoint IP / SoundStation IP Voice Coding Algorithms <codecs/> The following voice codecs are supported: Sample Effective Audio Algorithm MIME Type Label Bit Rate Rate Frame Size Bandwidth G.711μ-law PMCU G711mu 64 Kbps 8 Ksps 10ms - 80ms 3.5 KHz G.711a-law PCMA...
  • Page 193 Configuration Files Permitted Attribute Values Default Interpretation voice.codecPref.IP_300.G711Mu Null, 1-3 Specifies the codec preferences for SoundPoint IP 301 models. Interpretation voice.codecPref.IP_300.G711A as above. voice.codecPref.IP_300.G729AB voice.codecPref.IP_650.G711Mu Null, 1-4 Specifies the codec preferences for the SoundPoint IP 550, 560, 650, and 670 voice.codecPref.IP_650.G711A platform.
  • Page 194 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation voice.codecPref.IP_7000.G711Mu Null, 1-16 Specifies the codec preferences for the SoundStation IP 7000 platform. voice.codecPref.IP_7000.G711A Interpretation as above. voice.codecPref.IP_7000.G722 voice.codecPref.IP_7000.G7221.16kbps Null voice.codecPref.IP_7000.G7221.24kbps Null voice.codecPref.IP_7000.G7221.32kbps voice.codecPref.IP_7000.G7221C. Null 24kbps voice.codecPref.IP_7000.G7221C. Null 32kbps voice.codecPref.IP_7000.G7221C.
  • Page 195 Configuration Files Codec Profiles <audioProfile/> The following profile attributes can be adjusted for each of the five supported codecs. In the table, x=G711Mu, G711A, G722, G7221, G7221C, and G729AB, Lin16, Siren14, and Siren22. Permitted Attribute Values Interpretation voice.audioProfile.x.payloadSize 10, 20, 30, ...80 Preferred Tx payload size in milliseconds to be provided in SDP offers and used in the absence of ptime negotiations.
  • Page 196 0, 1 Gains <gain/> The default gain settings have been carefully adjusted to comply with the TIA-810-A digital telephony standard. Polycom recommends that you do not change these values. Attribute Default voice.gain.rx.analog.handset voice.gain.rx.analog.headset voice.gain.rx.analog.chassis voice.gain.rx.analog.chassis.IP_300...
  • Page 197 Configuration Files Attribute Default voice.gain.rx.analog.ringer.IP_430 voice.gain.rx.analog.ringer.IP_601 voice.gain.rx.analog.ringer.IP_650 voice.gain.rx.analog.ringer.IP_6000 voice.gain.rx.analog.ringer.IP_7000 voice.gain.rx.digital.handset voice.gain.rx.digital.headset voice.gain.rx.digital.chassis voice.gain.rx.digital.chassis.IP_330 voice.gain.rx.digital.chassis.IP_430 voice.gain.rx.digital.chassis.IP_4000 voice.gain.rx.digital.chassis.IP_6000 voice.gain.rx.digital.chassis.IP_7000 voice.gain.rx.digital.chassis.IP_601 voice.gain.rx.digital.chassis.IP_650 voice.gain.rx.digital.ringer voice.gain.rx.digital.ringer.IP_330 voice.gain.rx.digital.ringer.IP_430 voice.gain.rx.digital.ringer.IP_4000 voice.gain.rx.digital.ringer.IP_601 voice.gain.rx.digital.ringer.IP_650 voice.gain.rx.digital.ringer.IP_6000 voice.gain.rx.digital.ringer.IP_7000 voice.gain.rx.analog.handset.sidetone voice.gain.rx.analog.headset.sidetone voice.gain.tx.analog.handset voice.gain.tx.analog.headset voice.gain.tx.analog.chassis voice.gain.tx.analog.chassis.IP_300 voice.gain.tx.analog.chassis.IP_330 A - 43...
  • Page 198 Administrator’s Guide SoundPoint IP / SoundStation IP Attribute Default voice.gain.tx.analog.chassis.IP_430 voice.gain.tx.analog.chassis.IP_601 voice.gain.tx.analog.chassis.IP_650 voice.gain.tx.analog.chassis.IP_6000 voice.gain.tx.analog.chassis.IP_7000 voice.gain.tx.digital.handset voice.gain.tx.digital.handset.IP_330 voice.gain.tx.digital.handset.IP_430 voice.gain.tx.digital.handset.IP_650 voice.gain.tx.digital.headset voice.gain.tx.digital.headset.IP_330 voice.gain.tx.digital.headset.IP_430 voice.gain.tx.digital.headset.IP_650 voice.gain.tx.digital.chassis voice.gain.tx.digital.chassis.IP_330 voice.gain.tx.digital.chassis.IP_430 voice.gain.tx.digital.chassis.IP_4000 voice.gain.tx.digital.chassis.IP_601 voice.gain.tx.digital.chassis.IP_650 voice.gain.tx.digital.chassis.IP_6000 voice.gain.tx.digital.chassis.IP_7000 voice.gain.tx.analog.preamp.handset voice.gain.tx.analog.preamp.headset voice.gain.tx.analog.preamp.chassis voice.gain.tx.analog.preamp.chassis.IP_601 voice.handset.rxag.adjust.IP_330 voice.handset.rxag.adjust.IP_430 voice.handset.rxag.adjust.IP_650 voice.handset.txag.adjust.IP_330 voice.handset.txag.adjust.IP_430 A - 44...
  • Page 199 Acoustic Echo Cancellation <aec/> These settings control the performance of the speakerphone acoustic echo canceller. Polycom recommends that you do not change these values. Attribute Default voice.aec.hs.enable voice.aec.hs.lowFreqCutOff voice.aec.hs.highFreqCutOff 7000 voice.aec.hs.erlTab_0_300 voice.aec.hs.erlTab_300_600 voice.aec.hs.erlTab_600_1500 voice.aec.hs.erlTab_1500_3500...
  • Page 200 7000 voice.aec.hf.erlTab_0_300 voice.aec.hf.erlTab_300_600 voice.aec.hf.erlTab_600_1500 voice.aec.hf.erlTab_1500_3500 voice.aec.hf.erlTab_3500_7000 Acoustic Echo Suppression <aes/> These settings control the performance of the speakerphone acoustic echo suppressor. Polycom recommends that you do not change these values. Attribute Default voice.aes.hs.enable voice.aes.hs.duplexBalance voice.aes.hd.enable voice.aes.hd.duplexBalance voice.aes.hf.enable voice.aes.hf.duplexBalance.0 voice.aes.hf.duplexBalance.1...
  • Page 201 Background Noise Suppression <ns/> These settings control the performance of the transmit background noise suppression feature. Polycom recommends that you do not change these values. Attribute Default voice.ns.hs.enable voice.ns.hs.signalAttn voice.ns.hs.silenceAttn voice.ns.hd.enable voice.ns.hd.signalAttn voice.ns.hd.silenceAttn A - 47...
  • Page 202 Automatic Gain Control <agc/> These settings control the performance of the transmit automatic gain control feature. Note Automatic Gain Control will be implemented in a future release. Polycom recommends that you do not change these values. Attribute Default voice.agc.hs.enable voice.agc.hd.enable voice.agc.hf.enable...
  • Page 203 Configuration Files Receive Equalization <rxEq/> These settings control the performance of the receive equalization feature. Polycom recommends that you do not change these values. Attribute Default voice.rxEq.hs.IP_330.preFilter.enable voice.rxEq.hs.IP_430.preFilter.enable voice.rxEq.hs.IP_500.preFilter.enable voice.rxEq.hs.IP_600.preFilter.enable voice.rxEq.hs.IP_601.preFilter.enable voice.rxEq.hs.IP_650.preFilter.enable voice.rxEq.hs.IP_330.postFilter.enable voice.rxEq.hs.IP_430.postFilter.enable voice.rxEq.hs.IP_500.postFilter.enable voice.rxEq.hs.IP_600.postFilter.enable voice.rxEq.hs.IP_601.postFilter.enable voice.rxEq.hs.IP_650.postFilter.enable voice.rxEq.hd.IP_330.preFilter.enable voice.rxEq.hd.IP_430.preFilter.enable voice.rxEq.hd.IP_500.preFilter.enable...
  • Page 204 Transmit Equalization <txEq/> These settings control the performance of the hands-free transmit equalization feature. Polycom recommends that you do not change these values. Attribute Default voice.txEq.hs.IP_330.preFilter.enable voice.txEq.hs.IP_430.preFilter.enable voice.txEq.hs.IP_500.preFilter.enable voice.txEq.hs.IP_600.preFilter.enable A - 50...
  • Page 205 Configuration Files Attribute Default voice.txEq.hs.IP_601.preFilter.enable voice.txEq.hs.IP_650.preFilter.enable voice.txEq.hs.IP_330.postFilter.enable voice.txEq.hs.IP_430.postFilter.enable voice.txEq.hs.IP_500.postFilter.enable voice.txEq.hs.IP_600.postFilter.enable voice.txEq.hs.IP_601.postFilter.enable voice.txEq.hs.IP_650.postFilter.enable voice.txEq.hd.IP_330.preFilter.enable voice.txEq.hd.IP_430.preFilter.enable voice.txEq.hd.IP_500.preFilter.enable voice.txEq.hd.IP_600.preFilter.enable voice.txEq.hd.IP_601.preFilter.enable voice.txEq.hd.IP_650.preFilter.enable voice.txEq.hd.IP_330.postFilter.enable voice.txEq.hd.IP_430.postFilter.enable voice.txEq.hd.IP_500.postFilter.enable voice.txEq.hd.IP_600.postFilter.enable voice.txEq.hd.IP_601.postFilter.enable voice.txEq.hd.IP_650.postFilter.enable voice.txEq.hf.IP_330.preFilter.enable voice.txEq.hf.IP_430.preFilter.enable voice.txEq.hf.IP_500.preFilter.enable voice.txEq.hf.IP_600.preFilter.enable voice.txEq.hf.IP_601.preFilter.enable voice.txEq.hf.IP_650.preFilter.enable voice.txEq.hf.IP_4000.preFilter.enable voice.txEq.hf.IP_6000.preFilter.enable voice.txEq.hf.IP_7000.preFilter.enable voice.txEq.hf.IP_330.postFilter.enable A - 51...
  • Page 206 Administrator’s Guide SoundPoint IP / SoundStation IP Attribute Default voice.txEq.hf.IP_430.postFilter.enable voice.txEq.hf.IP_500.postFilter.enable voice.txEq.hf.IP_600.postFilter.enable voice.txEq.hf.IP_601.postFilter.enable voice.txEq.hf.IP_650.postFilter.enable voice.txEq.hf.IP_4000.postFilter.enable voice.txEq.hf.IP_6000.postFilter.enable voice.txEq.hf.IP_7000.postFilter.enable Voice Activity Detection <vad/> These settings control the performance of the voice activity detection (silence suppression) feature. Permitted Attribute Values Default Interpretation voice.vadEnable 0, 1 If set to 1, enable VAD.
  • Page 207 Configuration Files • Server <server/> • RTCP-XR <rtcpxr/> Central Report Collector <collector/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voice.qualityMonitoring.collector.enable. 0, 1 Enables generation of periodic periodic quality reports throughout a call. voice.qualityMonitoring.collector.enable. 0, 1 Enables generation of a quality session report at the end of each call.
  • Page 208 Administrator’s Guide SoundPoint IP / SoundStation IP Alert Reports <alert/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voice.qualityMonitoring.collector. Null, 15 to 40 Null Threshold value of listening MOS alert.moslq.threshold.warning score (MOS-LQ) that causes phone to send a warning alert quality report.
  • Page 209: Quality Of Service

    Configuration Files Server <server/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation voice.qualityMonitoring.collector.server.x. Dotted-decima Null IP address or host name and port of address l IP address or a SIP server (report collector) that host name accepts voice quality reports contained in SIP PUBLISH messages.
  • Page 210 Administrator’s Guide SoundPoint IP / SoundStation IP RTP <RTP/> These parameters apply to RTP packets. Permitted Attribute Values Default Interpretation qos.ethernet.rtp.user_priority User-priority used for RTP packets. Call Control <callControl/> These parameters apply to call control packets, such as the network protocol signaling.
  • Page 211 Configuration Files RTP <rtp/> These parameters apply to RTP packets. Permitted Attribute Values Default Interpretation qos.ip.rtp.dscp 0 to 63 or Null This parameter allows the DSCP of EF or packets to be specified. If set to a any of value, this will override the other AF11,AF12, qos.ip.rtp…...
  • Page 212: Basic Tcp/Ip

    Administrator’s Guide SoundPoint IP / SoundStation IP Call Control <callControl/> These parameters apply to call control packets, such as the network protocol signaling. Permitted Attribute Values Default Interpretation qos.ip.callControl.dscp 0 to 63 or Null This parameter allows the DSCP of EF or packets to be specified.
  • Page 213 Configuration Files Network Monitoring <netMon/> Polycom recommends that you do not change these values. This configuration attribute is defined as follows: Permitted Attribute Values Default tcpIpApp.netMon.enabled 0, 1 tcpIpApp.netMon.period 1 to 86400 Time Synchronization <sntp/> The following table describes the parameters used to set up time synchronization and daylight savings time.
  • Page 214 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation tcpIpApp.sntp.address.overrideDHCP 0, 1 These parameters determine whether configuration file parameters override DHCP parameters for the SNTP server address and Greenwich Mean Time (GMT) offset. If set to 0, DHCP values will override configuration file parameters.
  • Page 215 Configuration Files Permitted Attribute Values Default Interpretation tcpIpApp.sntp.daylightSavings.start.date 1-31 If fixedDayEnable is set to 1, use as day of the month to start DST. If fixedDayEnable is set to 0, us the mapping: 1 = the first occurrence of a given day-of-the-week in a month, 8 = the second occurrence of a given day-of-the-week...
  • Page 216 Administrator’s Guide SoundPoint IP / SoundStation IP Port <port/> This attribute includes: • RTP <rtp/> RTP <rtp/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation tcpIpApp.port.rtp.filterByIp 0, 1 If set to 1, reject RTP packets arriving from (sent from) a non-negotiated (through SDP) IP address.
  • Page 217: Web Server

    Configuration Files Keep-Alive <keepalive/> Allowing for the configuration of TCP keep-alive on SIP TLS connections, the phone can detect a failures quickly (in minutes) and attempt to re-register with the SIP call server (or its redundant pair). This configuration attribute is defined as follows: Permitted Attribute Values...
  • Page 218: Call Handling Configuration

    Administrator’s Guide SoundPoint IP / SoundStation IP This attribute also includes: Configuration <cfg/> Configuration <cfg/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation httpd.cfg.enabled 0, 1 If set to 1, the HTTP server configuration interface will be enabled. httpd.cfg.port 1-65535 Port is 80 for HTTP servers.
  • Page 219 Configuration Files Permitted Attribute Values Default Interpretation call.dialtoneTimeOut Null, positive Time in seconds to allow the dialtone to be integer played before dropping the call. If set to 0, the call is not dropped. If set to Null, call dropped after 60 seconds. call.lastCallReturnString string of The string sent to the server when the user...
  • Page 220 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation call.singleKeyPressConference If set to 1, the conference will be setup after a user presses the Conference soft key or Conference key the first time. Also, all sound effects (dial tone, DTMF tone while dialing and ringing back) are heard by all existing participants in the conference.
  • Page 221 Configuration Files Shared Calls <shared/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation call.shared.disableDivert 0, 1 If set to 1, disable diversion feature for shared lines. Note: This feature is disabled on most call servers. call.shared.seizeFailReorder 0, 1 If set to 1, play re-order tone locally on shared line seize failure.
  • Page 222: Directory

    Administrator’s Guide SoundPoint IP / SoundStation IP Directory <dir/> This attribute includes: • Local Directory <local/> • Corporate Directory <corp/> Local Directory <local/> The local directory is stored in either flash memory or RAM on the phone. The local directory size is limited based on the amount of flash memory in the phone.
  • Page 223 Configuration Files Permitted Attribute Values Default Interpretation dir.local.nonVolatile.maxSize.8meg 1 to 100 Attribute applies only to platforms with 8 Mbytes or more of flash memory. This is the maximum size of non-volatile storage that the directory will be permitted to consume. dir.local.readonly 0, 1 Specifies whether or not local...
  • Page 224 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation dir.corp.baseDN UTF-8 encoded Null The base domain name is the string starting point for making queries on the LDAP server. dir.corp.user UTF-8 encoded Null The username used to authenticate string to the LDAP server.
  • Page 225 Configuration Files Permitted Attribute Values Default Interpretation dir.corp.attribute.x.sticky 0, 1 Null If set to 0 or Null, the filter criteria for this attribute is reset after a reboot. If set to 1, the filter criteria for this attribute is retained through a reboot.
  • Page 226: Presence

    Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation dir.corp.cacheSize 8 to 256 The maximum number of entries that can be cached locally on the phone. dir.corp.pageSize 8 to 64 The maximum number of entries requested from the corporate directory server with each query.
  • Page 227 . When defining a single .fon file, there is a need for a font delimiter, currently “Copyright Polycom Canada Ltd” is used as an embedded delimiter, but this can be configured using font.delimiter. The font delimiter is important to retrieve the different scrambled .fnt blocks.
  • Page 228 Administrator’s Guide SoundPoint IP / SoundStation IP to include support for a large number of font ranges at once; otherwise, if simply adding or changing a few fonts currently in use, multiple .fnt files are recommended since they are easier to work with individually. This configuration attribute is defined as follows: Attribute Permitted Values...
  • Page 229: Keys

    Configuration Files IP_500 font <IP_500/> This configuration attribute is defined as follows: Attribute Permitted Values Default Interpretation font.IP_500.x.name fontName_height_Uxx00_U Null Defines the font file that will be loaded from yyFF.fon OR boot server during boot up. fontName_height_Uxx00_U Note: When several font.IP_500.x.name xxFF.fnt are defined, the index x must follow consecutive increasing order.
  • Page 230 Administrator’s Guide SoundPoint IP / SoundStation IP Polycom does not recommend the remapping for keys. In the following table, x=IP_300, IP_330, IP 430, IP_500, IP_550, IP_600, IP_650, and IP_4000, and IP_7000 and y is the key number. Note that IP_300...
  • Page 231: Backgrounds

    Configuration Files Backgrounds <bg/> The backgrounds used by the SoundPoint IP 550, 560, 650, and 670 phones are defined in this section. In the following table, w=1 to 3, x=1 to 6. This configuration attribute is defined as follows: Permitted Attribute Values Default...
  • Page 232 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation button.color.selection.x.y. any string The label color for soft keys and line key labels modify associated with the defined backgrounds. These values can be modified locally by the user. The format is: “rgbHILo, <parameter list>”.
  • Page 233 Configuration Files Permitted Attribute Values Default Interpretation bg.hiRes.gray.bm.x.name any string Graphic files for display on the phone and Expansion Module and also the brightness bg.hiRes.gray.bm.x.em.name any string adjustment to the graphic. For x=1: bg.hiRes.gray.bm.x.adj integer • name is “Leaf.jpg” name is “LeafEM.jpg” adjustment is “0”...
  • Page 234: Bitmaps

    Administrator’s Guide SoundPoint IP / SoundStation IP Bitmaps <bitmap/> The bitmaps used by each phone model are defined in this section. Platform <IP_300/>, <IP 330/>, <IP_400/>, <IP_500/>, <IP_600/>, <IP_4000/>, and <IP_7000/> In the following table, x=IP_300, IP_330, IP_400, IP_500, IP_600, IP_4000, or IP_7000 and y is the bitmap number.
  • Page 235 Configuration Files This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation ind.idleDisplay.mode 1 (default), 2, Null The idle display animation screen layouts. For example, for the SoundPoint IP 330/320: • If set to 1 or Null, the idle display animation size is 87 x 11 pixels.
  • Page 236 Administrator’s Guide SoundPoint IP / SoundStation IP Patterns <pattern/> This section defines patterns for the LED indicators. In the following table, x is the pattern number, y is the step in the pattern. Permitted Attribute Values Interpretation ind.pattern.x.step.y.state On or Off Turn LED on or off for this step.
  • Page 237 Configuration Files LEDs <led/> In the following table, x is the LED number. Permitted Attribute Values Interpretation ind.led.x.index This is for internal usage only and should not be changed (this is the logical index). ind.led.x.class positive integer Assigns the class (defined in Classes <class/>...
  • Page 238: Event Logging

    IP 7000: 1-128 Event Logging <log/> Logging parameter changes can impair system operation. Do not change any Caution logging parameters without prior consultation with Polycom Technical Support. The event logging system supports the following classes of events: Level Interpretation Debug only...
  • Page 239 Configuration Files Each event in the log contains the following fields separated by the | character: • time or time/date stamp • 1-5 character component identifier (such as “so”) • event class • cumulative log events missed due to excessive CPU load •...
  • Page 240 Refer to above table for timestamp type. log.render.realtime 0, 1 Set to 1. Note: Polycom recommends that you do not change this value. log.render.stdout 0, 1 Set to 1. Note: Polycom recommends that you do not change this value.
  • Page 241 Scheduled Logging Parameters <sched/> The phone can be configured to schedule certain advanced logging tasks on a periodic basis. These attributes should be set in consultation with Polycom Technical Support. Each scheduled log task is controlled by a unique attribute set starting with log.sched.x where x identifies the task.
  • Page 242: Security

    Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Interpretation log.sched.x.startMode abs, rel Start at absolute time or relative to boot. log.sched.x.startTime positive Seconds since boot when startMode is rel or the start time in 24-hour integer OR clock format when startMode is abs. hh:mm log.sched.x.startDay When startMode is abs, specifies the day of the week to start...
  • Page 243: License

    Configuration Files Encryption <encryption/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation sec.encryption.upload.dir 0, 1 If set to 0, the phone-specific contact directory is uploaded to the server unencrypted regardless of how it was downloaded. This will replace whatever phone-specific contact directory is on the server even if it is encrypted.
  • Page 244: Provisioning

    Measured relative to boot time in rel mode. prov.polling.time Format is 03:00 Only used in abs mode. Polling hh:mm time. RAM Disk <ramdisk/> This attribute’s settings control the phone’s internal RAM disk feature. Polycom recommends that you do not change these values. A - 90...
  • Page 245: Request

    Configuration Files This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation ramdisk.enable 0, 1 If set to 1, RAM disk will be available. The RAM disk is used to cache downloaded wave files, and other resources for the user interface. ramdisk.bytesPerBlock 0, 32, 33, ..., These four parameters use internal defaults when...
  • Page 246: Feature

    Administrator’s Guide SoundPoint IP / SoundStation IP Feature <feature/> These settings control the activation or deactivation of a feature at run time. In the table below, x is the feature number. Attribute Permitted Values Interpretation feature.x.name “presence”, These are features offered on the phone: “messaging”, “presence”...
  • Page 247: Resource

    Note: feature.16.name =“nway-conference”, feature.17.name = “call-recording” , and feature.19.name =“corporate-directory” are charged for separately. To activate these features, you must go to the Polycom Resource Center (http://extranet.polycom.com/csnprod/signon.html) to retrieve the activation code. Resource <res/> This attribute’s settings control the maximum size or an external resource retrieved at run time.
  • Page 248 Administrator’s Guide SoundPoint IP / SoundStation IP Finder <finder/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation res.finder.sizeLimit positive If a resource that is being downloaded to the phone integer is larger than this value * 1024 bytes (= the maximum size), the resource will be automatically truncated to the maximum size defined.
  • Page 249: Microbrowser

    Configuration Files Permitted Attribute Values Interpretation res.quotas.x.value positive integer When a particular resource (one of category “font”, “bitmap”, or “font”) is downloaded to the phone, a quota equal to this value * 1024 bytes of compound data size is applied for that category.
  • Page 250 Administrator’s Guide SoundPoint IP / SoundStation IP Idle Display <idleDisplay/> The Microbrowser can be used to create a display that will be part of the phone’s idle display. These settings control the home page and the refresh rate. Attribute Permitted Values Default Interpretation mb.idleDisplay.home...
  • Page 251 Configuration Files Main Browser <main/> This setting controls the home page used by the Microbrowser when that function is selected. Attribute Permitted Values Default Interpretation mb.main.home Any fully formed valid Null URL used for Microbrowser home page. If blank, HTTP URL. Length the browser will notify the user that a blank up to 255 characters.
  • Page 252: Applications

    Administrator’s Guide SoundPoint IP / SoundStation IP Browser Limits <limits/> These settings limit the size of object which the Microbrowser will display by limiting the amount of memory available for the Microbrowser. Attribute Permitted Values Default Interpretation mb.limits.nodes positive integer Limits the number of tags that the XML parser will handle.
  • Page 253 Configuration Files Attribute Permitted Values Default Interpretation apps.statePolling.URL Null The URL to which the phone sends call processing state/device/network information. The protocol used can be either HTTP or HTTPS. Note: To enable state polling, the attributes apps.statePolling.URL, apps.statePolling.username, and apps.statePolling.password must be set to non-Null values.
  • Page 254: Peer Networking

    Administrator’s Guide SoundPoint IP / SoundStation IP Peer Networking <pnet/> Peer networking manages communications between Polycom devices. For the SoundStation IP 7000 conference phone, it manages daisy-chaining and video integation with the HDX video systems. This configuration attribute is defined as follows:...
  • Page 255 Configuration Files NAPTR <NAPTR/> This configuration attribute is defined as follows: Attribute Permitted Values Default Interpretation dns.cache.NAPTR.x. domain name string Null The domain name to which this resource record name refers. dns.cache.NAPTR.x.ttl 300 to 65535 Specifies the time interval (in seconds) that the resource record may be cached before the source of the information should again be consulted.
  • Page 256 Administrator’s Guide SoundPoint IP / SoundStation IP SRV <SRV/> This configuration attribute is defined as follows: Attribute Permitted Values Default Interpretation dns.cache.SRV.x.name domain name string Null The domain name string with SRV prefix. dns.cache.SRV.x.ttl 0 to 65535, seconds Specifies the time interval that the resource record may be cached before the source of the information should again be consulted.
  • Page 257: Soft Keys

    Configuration Files Soft Keys <softkey/> This configuration attribute is defined as follows (where x =1 to maximum number of defined soft keys): Permitted Attribute Values Default Interpretation softkey.x.label string Null This is the text displayed with the soft key. If set to Null, the label to display is determined as follows: •...
  • Page 258 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation softkey.x.use.alerting 0 (default) Null If set to 0 or Null, the soft key is not displayed in the alerting state. If set to 1, the soft key is displayed in the alerting state.
  • Page 259 Configuration Files Permitted Attribute Values Default Interpretation softkey.feature.directories Null If set to Null, the Dir soft key is displayed on the SoundPoint IP 320/330 phone, but Null (default) not on any other phone. If set to 0, the Dir soft key is not displayed on any phone.
  • Page 260: Per-Phone Configuration

    3-14. Polycom recommends that you create another file with your organization’s modifications. If you must change any Polycom templates, back them up first. For more information, refer to the “Configuration File Management on SoundPoint IP Phones” whitepaper at www.polycom.com/support/voice/.
  • Page 261: Registration

    The user part or the user and the host part of userPart from the phone’s SIP URI. userPart@domain The user part of the phone's SIP URI. For example, reg.x.address=”1002” from 1002@polycom.com or reg.x.address=”1002@polycom.com”. reg.x.label UTF-8 encoded Null Text label to appear on the display adjacent string to the associated line key.
  • Page 262 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation reg.x.auth.userId string Null User ID to be used for authentication challenges for this registration. If non-Null, will override the “Reg User x” parameter entered into the Authentication submenu off of the Settings menu on the phone.
  • Page 263 Configuration Files Permitted Attribute Values Default Interpretation reg.x.lineKeys 1 to max max = the number of line keys on the phone. max = 1 on SoundStation IP 4000, 6000, 7000, max = 2 on IP 301, 320, 330, 430, max = 3 on IP 501, max = 4 on IP 550, 560, max = 6 on IP 600, max = 48 on IP 601, 650, 670 (without any...
  • Page 264 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation reg.x.outboundProxy.transport DNSnaptr or DNSnap If set to Null or DNSnaptr: TCPpreferred or If reg.x.outboundProxy.address is a UDPOnly or hostname and reg.x.outboundProxy.port is 0 TLS or or Null, do NAPTR then SRV look-ups to try TCPOnly to discover the transport, ports and servers, as per RFC 3263.
  • Page 265: Calls

    Configuration Files Permitted Attribute Values Default Interpretation reg.x.auth.optimizedInFailover 0, 1 If set to 1, when failover occurs, the first new SIP request is sent to the server that sent the proxy authentication request. If set to 0, when failover occurs, the first new SIP request is sent to the server with the highest priority in the server list.
  • Page 266 (the user part of a SIP URL) or a string upon going off-hook on that constitutes a valid SIP URL (6416 this registration. or 6416@polycom.com) Missed Call Configuration <serverMissedCall/> The phone supports a per-registration configuration of which events will cause the locally displayed “missed calls” counter to be incremented.
  • Page 267 Configuration Files Missed Call Tracking <missedCallTracking/> You can enable/disable missed call tracking on a per-line basis. In the following table, x is the registration number. IP 301, 320, 330, 430: x=1-2; IP 501: x=1-3; IP 550, 560: x=1-4; IP 600: x=1-6; IP 601: x=1-12; IP 650, 670: x=1-34;...
  • Page 268: Diversion

    SIP specific contact of a per-call URL (6416 or diversion feature (refer to 6416@polycom.com below). divert.x.autoOnSpecificCaller 0, 1 If set to 1, calls may be diverted using the Auto Divert feature of the directory.
  • Page 269 SIP URL) or a string that Null, divert.x.contact will be constitutes a valid SIP URL used. (6416 or 6416@polycom.com No Answer <noanswer/> The phone can automatically divert calls after a period of ringing. Attribute Permitted Values...
  • Page 270: Dial Plan

    (the user part of a SIP URL) or a string calls forwarded due to DND that constitutes a valid SIP URL (6416 or status, if Null 6416@polycom.com) divert.x.contact will be used. Dial Plan <dialplan/> Per-registration dial plan configuration is supported.
  • Page 271 Configuration Files Permitted Attribute Values Default Interpretation dialplan.x.applyToUserDial 0, 1 When present, and if dialplan.x.digitmap is not Null, this attribute overrides the global dial plan defined in the sip.cfg configuration file. For interpretation, refer to Dial Plan <dialplan/> on page A-17. dialplan.x.applyToUserSend 0, 1 When present, and if...
  • Page 272 Administrator’s Guide SoundPoint IP / SoundStation IP This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation dialplan.x.digitmap A string compatible with the Null When present, this attribute digit map feature of MGCP overrides the global dial plan described in 2.1.5 of RFC defined in the sip.cfg 3435;...
  • Page 273: Messaging

    Configuration Files Emergency <emergency/> In the following attributes, y is the index of the emergency entry description and z is the index of the server associated with the emergency entry y. For each emergency entry (index y), one or more server entry (indexes (y,z)) can be configured.
  • Page 274: Network Address Translation

    If non-Null, the phone will send digits (the user part of a SIP a SUBSCRIBE request to this URL) or a string that constitutes contact after boot-up. a valid SIP URL (6416 or 6416@polycom.com) msg.mwi.x. contact or “registration” Configures message retrieval callBackMode registration or and notification for the line.
  • Page 275: Attendant

    Configuration Files This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation nat.ip dotted-decima Null IP address to advertise within SIP signaling - should l IP address match the external IP address used by the NAT device. nat.signalPort 1024 to 65535 Null If non-Null, this port will be used by the phone for SIP...
  • Page 276: Roaming Buddies

    Administrator’s Guide SoundPoint IP / SoundStation IP This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation attendant.uri string Null For attendant console / busy lamp field (BLF) feature. This specifies the list SIP URI on the server. If this is just a user part, the URI is constructed with the server host name/IP.
  • Page 277: Roaming Privacy

    Configuration Files Roaming Privacy <roaming_privacy/> This attribute is used in conjunction with Microsoft Live Communications Note Server 2005 only. This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation roaming_privacy.reg positive Null Specifies the line/registration number which has roaming integer privacy support enabled.
  • Page 278: Flash Parameter Configuration

    A has a configuration file that specifies that server B should be used, which has a configuration file that specifies that server A should be used. Polycom recommends that you test the new configuration files on two phones before initializing all phones. This should detect any errors including IP address conflicts.
  • Page 279 Configuration Files This flash attributes are defined as follows: Name Possible Values Description device.set 0 or 1 If set to 0, do not use any device.xxx.yyy fields to default = 0 set any parameters. Set this to 0 after the initial installation.
  • Page 280 Administrator’s Guide SoundPoint IP / SoundStation IP Name Possible Values Description device.prov.serverName any string For descriptions, refer to Server Menu on page 3-9. device.prov.serverType 0 to 4 device.prov.user any string device.prov.password any string device.prov.appProvType 0 or 1 device.prov.appProvString any string device.prov.
  • Page 281 Configuration Files Name Possible Values Description device.syslog.facility 0 to 23 A description of what generated the log message. For more information, refer to section 4.1.1 of RFC 3165. The default value is 16, which maps to “local 0”. device.syslog.renderLevel 0 to 6 Specifies the lowest class of event that will be rendered to syslog.
  • Page 282 Administrator’s Guide SoundPoint IP / SoundStation IP A - 128...
  • Page 283: B Session Initiation Protocol (Sip

    Session Initiation Protocol (SIP) This chapter provides a description of the basic Session Initiation Protocol (SIP) and the protocol extensions that are supported by the current SIP application. To find the applicable Request For Comments (RFC) document, go to http://www.ietf.org/rfc.html and enter the RFC number.
  • Page 284: Rfc And Internet Draft Support

    Administrator’s Guide SoundPoint IP / SoundStation IP RFC and Internet Draft Support The following RFC’s and Internet drafts are supported: • RFC 1321—The MD5 Message-Digest Algorithm • RFC 2327—SDP: Session Description Protocol • RFC 2387—The MIME Multipart / Related Content-type •...
  • Page 285: Request Support

    Session Initiation Protocol (SIP) • RFC 3969—The Internet Assigned Number Authority (IANA) Uniform Resource Identifier (URI) Parameter Registry for the Session Initiation Protocol (SIP) • RFC 4028—Session Timers in the Session Initiation Protocol (SIP) • RFC 4235—An INVITE-Initiated Dialog Event Package for the Session Initiation Protocol (SIP) •...
  • Page 286: Header Support

    Administrator’s Guide SoundPoint IP / SoundStation IP Method Supported Notes INFO RFC 2976, the phone does not generate INFO requests, but will issue a final response upon receipt. No INFO message bodies are parsed. MESSAGE Final response is sent upon receipt. Message bodies of type text/plain are sent and received.
  • Page 287 Session Initiation Protocol (SIP) Header Supported Notes Diversion Error-Info Event Expires From In-Reply-To Max-Forwards Min-Expires Min-SE MIME-Version Organization P-Asserted-Identity P-Preferred-Identity Priority Proxy-Authenticate Proxy-Authorization Proxy-Require RAck Record-Route Refer-To Referred-By Remote-Party-ID Replaces Reply-To Require Retry-After Route RSeq Server Session-Expires B - 5...
  • Page 288: Response Support

    Administrator’s Guide SoundPoint IP / SoundStation IP Header Supported Notes Subject Subscription-State Supported Timestamp Unsupported User-Agent Warning Only warning codes 300 to 399 WWW-Authenticate Response Support The following SIP responses are supported: In the following table, a “Yes” in the Supported column means the header is sent Note and properly parsed.
  • Page 289 Session Initiation Protocol (SIP) 3xx Responses - Redirection Response Supported Notes 300 Multiple Choices 301 Moved Permanently 302 Moved Temporarily 305 Use Proxy 380 Alternative Service 4xx Responses - Request Failure Note All 4xx responses for which the phone does not provide specific support will be treated the same as 400 Bad Request.
  • Page 290 Administrator’s Guide SoundPoint IP / SoundStation IP Response Supported Notes 481 Call/Transaction Does Not Exist 482 Loop Detected 483 Too Many Hops 484 Address Incomplete 485 Ambiguous 486 Busy Here 487 Request Terminated 488 Not Acceptable Here 491 Request Pending 493 Undecipherable 5xx Responses - Server Failure Response...
  • Page 291: Hold Implementation

    Session Initiation Protocol (SIP) Hold Implementation The phone supports both currently accepted means of signaling hold. The first method, no longer recommended due in part to the RTCP problems associated with it, is to set the “c” destination addresses for the media streams in the SDP to zero, for example, c=0.0.0.0.
  • Page 292: Sip For Instant Messaging And Presence Leveraging Extensions

    Administrator’s Guide SoundPoint IP / SoundStation IP SIP for Instant Messaging and Presence Leveraging Extensions The phone is compatible with the Presence and Instant Messaging features of Microsoft Windows Messenger 5.1. In a future release, support for the Presence and Instant Message recommendations in the SIP Instant Messaging and Presence Leveraging Extensions (SIMPLE) proposals will be provided by the following Internet drafts or their successors: •...
  • Page 293: C Miscellaneous Administrative Tasks

    Miscellaneous Administrative Tasks This appendix provides information required by varied aspects of the Session Initiation Protocol (SIP) application. This includes: • Trusted Certificate Authority List • Encrypting Configuration Files • Adding a Background Logo • BootROM/SIP Application Dependencies • Multiple Key Combinations •...
  • Page 294 Administrator’s Guide SoundPoint IP / SoundStation IP • Deutsche Telekom AG Root CA • Digital Signature Trust Co. Global CA 1 • Digital Signature Trust Co. Global CA 2 • Digital Signature Trust Co. Global CA 3 • Digital Signature Trust Co. Global CA 4 •...
  • Page 295 Miscellaneous Administrative Tasks • TC TrustCenter, Germany, Class 1 CA • TC TrustCenter, Germany, Class 2 CA • TC TrustCenter, Germany, Class 3 CA • TC TrustCenter, Germany, Class 4 CA • Thawte Personal Basic CA • Thawte Personal Freemail CA •...
  • Page 296: Encrypting Configuration Files

    Administrator’s Guide SoundPoint IP / SoundStation IP Polycom endeavors to maintain a built-in list of the most commonly used CA Certificates. Due to memory contraints, we cannot keep as thorough a list as some other applications (for example, browsers). If you are using a certificate from a...
  • Page 297: Changing The Key On The Phone

    Miscellaneous Administrative Tasks You can check whether an encrypted file is the same as an unencrypted file by: 1. Run the configFileEncrypt utility on the unencrypted file with the "-d" option. This shows the "digest" field. 2. Look at the encrypted file using WordPad and check the first line that shows a "Digest=…."...
  • Page 298: Adding A Background Logo

    Administrator’s Guide SoundPoint IP / SoundStation IP 2. Manually reboot the phone so that it will download the new key. The phone will automatically reboot a second time to use the new key. At this point, the phone expects all encrypted configuration files on the boot server to use the new key and it will continue to reboot until this is the case.
  • Page 299 Miscellaneous Administrative Tasks The SoundPoint IP 501/600/601 phones only support the four colors black, dark gray, light gray, and white. Any other colors will be approximated. RGB Values Color RGB Values (Decimal) (Hexadecimal) Black 0,0,0 00,00,00 Dark Gray 96,96,96 60,60,60 Light Gray 160,160,160 A0,A0,A0...
  • Page 300 Administrator’s Guide SoundPoint IP / SoundStation IP <IP_400 … bitmap.IP_400.61.name="logo-430" /> <IP_500 … bitmap.IP_500.61.name="logo-500" /> <IP_600 … bitmap.IP_600.65.name="logo-600" /> <IP_4000 … bitmap.IP_4000.65.name="logo-4000" /> <IP_7000 … bitmap.IP_7000.65.name="logo-7000" /> </bitmaps> Next, enable the idle display feature and modify the idle display “animation” for each model to point to your bitmap (again without the .bmp extension): <indicators ind.idleDisplay.enabled="1">...
  • Page 301: Bootrom/Sip Application Dependencies

    Miscellaneous Administrative Tasks </Animations> … </indicators> BootROM/SIP Application Dependencies Not withstanding the hardware backward compatibility mandate, there have been times throughout the life of the SoundPoint IP / SoundStation IP phones where certain dependencies on specific bootROM and application versions have been necessitated.
  • Page 302: Multiple Key Combinations

    For other methods for resetting and rebooting your SoundPoint IP or SoundStation IP phones, refer to “Quick Tip 18298: Resetting and Rebooting SoundPoint IP Phones” at http://www.polycom.com/support/voice/ Rebooting the Phone For the key combination, press and hold certain key combinations (depending...
  • Page 303 Miscellaneous Administrative Tasks Note As of SIP 3.1, users can restart their phones by pressing the Menu key, and then selecting Settings > Basic > Restart Phone. Any new bootROM and SIP applications will be downloaded to the phone as a result of this restart.
  • Page 304: Default Feature Key Layouts

    Administrator’s Guide SoundPoint IP / SoundStation IP Default Feature Key Layouts The following figures and tables show the default SIP key layouts for the SoundPoint IP 301, 320, 330, 430, 501, 550, 560, 600, 601, 650, and 670 and SoundStation IP 4000, 6000, and 7000 models. SoundPoint IP 301 Menu Do Not Disturb...
  • Page 305 Miscellaneous Administrative Tasks SoundPoint IP 320/330 Menu Line 1 Dial Line 2 Hold PQRS WXYZ OPER Key ID Key ID Function Key ID Function Key ID Function Key ID Function Dialpad2 VolUp Menu Dialpad5 SoftKey2 VolDown Dialpad8 ArrowUp Dialpad3 Dialpad7 Select Dialpad6 Dialpad4...
  • Page 306 Administrator’s Guide SoundPoint IP / SoundStation IP SoundPoint IP 430 Key ID Function Key ID Function Key ID Function Key ID Function Line1 DialpadPound Messages Softkey3 Line2 Dialpad9 Handsfree Dialpad8 SoftKey4 ArrowUp Dialpad7 Headset Hold Dialpad4 SoftKey2 Dialpad5 SoftKey1 Redial Dialpad6 ArrowDown VolUp...
  • Page 307 Miscellaneous Administrative Tasks SoundPoint IP 501 Conference Directories Services Menu Call Lists Messages Conference Do Not Disturb Transfer Redial PQRS WXYZ Hold Hold PQRS WXYZ OPER OPER Key ID Key ID Function Key ID Function Key ID Function Key ID Function ArrowUp VolDown...
  • Page 308 Administrator’s Guide SoundPoint IP / SoundStation IP SoundPoint IP 550/560/600/601/650/670 Directories Menu Services Messages Conference Do Not Disturb Transfer Redial PQRS WXYZ Hold PQRS WXYZ Hold OPER OPER Key ID The SoundPoint IP 550 and 560 has have only the top four lines keys. Key IDs 31 Note and 42 are not used on SoundPoint IP 550 and 560 phones.
  • Page 309 Miscellaneous Administrative Tasks SoundStation IP 4000 Key ID Function Key ID Function Key ID Function Key ID Function Dialpad1 Select Dialpad2 Dialpad7 Dialpad3 Dialpad8 Menu VolUp Dialpad9 Exit Handsfree MicMute SoftKey1 ArrowUp SoftKey2 Dialpad4 ArrowDown SoftKey3 Dialpad5 DialpadStar Dialpad6 Dialpad0 VolDown DialpadPound Redial...
  • Page 310 Administrator’s Guide SoundPoint IP / SoundStation IP SoundStation IP 6000 Key ID Key ID Function Key ID Function Key ID Function Key ID Function Dialpad1 Select Dialpad2 Dialpad7 Dialpad3 Dialpad8 SoftKey3 VolUp Dialpad9 Exit Handsfree MicMute Menu ArrowUp SoftKey1 Dialpad4 SoftKey2 Dialpad5 DialpadStar...
  • Page 311: Internal Key Functions

    Miscellaneous Administrative Tasks SoundStation IP 7000 Key ID Key ID Function Key ID Function Key ID Function Key ID Function SoftKey1 DialpadStar Dialpad9 ArrowUp SoftKey3 DialpadPound Menu ArrowLeft Conference Dialpad2 Select Redial Dialpad5 VolUp Handsfree Dialpad8 VolDown SoftKey2 Dialpad0 MicMute ArrowDown SoftKey4 Release...
  • Page 312 Administrator’s Guide SoundPoint IP / SoundStation IP • On the SoundPoint IP 320/330 phone, CallPickup and ParkedPickup refer to the same function. On other phones, CallPickup refers to the soft key function that provides the menu with separate soft keys for parked pickup, directed pickup, and group pickup.
  • Page 313 Miscellaneous Administrative Tasks Label Function Dialpad3 Dialpad3 Dialpad4 Dialpad4 Dialpad5 Dialpad5 Dialpad6 Dialpad6 Dialpad7 Dialpad7 Dialpad8 Dialpad8 Dialpad9 Dialpad9 DialpadPound DialpadPound DialpadStar DialpadStar DialpadURL Dialname Call screen only DirectedPiclup DirectedPickup Call screen only Directories Directories Divert Forward DoNotDisturb Do Not Disturb menu Exit Exist existing menu Menu only...
  • Page 314 Administrator’s Guide SoundPoint IP / SoundStation IP Label Function MyStatus MyStatus NewCall NewCall Call screen only Null Do nothing Offline Offline for presence EnterRecord enterCallRecord Call screen only Redial Redial Call screen only Release EndCall or Cancel hot dial SoundStation IP 7000 only ParkedPickup ParkedPickup Call screen only...
  • Page 315: Assigning A Vlan Id Using Dhcp

    Miscellaneous Administrative Tasks Assigning a VLAN ID Using DHCP To assign a VLAN ID to a phone using DHCP: In the DHCP menu of the Main setup menu, set VLAN Discovery to >> “Fixed” or “Custom”. When set to “Fixed”, the phone will examine DHCP options 128,144, 157 and 191 (in that order) for a valid DVD string.
  • Page 316: Parsing Vendor Id Information

    Administrator’s Guide SoundPoint IP / SoundStation IP The following figure shows the phone’s processing to determine if the VLAN ID is valid: Parsing Vendor ID Information After the phone boot, it sends a DHCP Discover packet to the DHCP server. This is found in the Bootstrap Protocol/option “Vendor Class Identifier”...
  • Page 317 This vendor ID information is not a character string, but an array of binary data. The steps for parsing are as follows: 1. Check for the Polycom signature at the start of the option: 4 octet: 00 00 36 3d 2.
  • Page 318: Product, Model, And Part Number Mapping

    Administrator’s Guide SoundPoint IP / SoundStation IP Product, Model, and Part Number Mapping In SIP 2.1.2, enhancements to the master configuration file were made to allow you to direct phone upgrades to a software image and configuration files based on phone model number, firmware part number, or MAC address. The part number specific version has precedence over the model number version, which has precedence over the original version.
  • Page 319: Disabling Pc Ethernet Port

    Miscellaneous Administrative Tasks Disabling PC Ethernet Port Certain SoundPoint IP phones have a PC Ethernet port. If it is unused, it can be disabled. The PC Ethernet port can be disabled on the SoundPoint IP 330, 430, 450, 550, 560, 601, 650, and 670 and 850. The port cannot be disabled on the SoundPoint IP 301, 501, and 600 due to a lack of hardware support for the feature.
  • Page 320 Administrator’s Guide SoundPoint IP / SoundStation IP C - 28...
  • Page 321: D Third Party Software

    Third Party Software This appendix provides the copyright statements for third party software products that are part of the Session Initiation Protocol (SIP) application. Ares Copyright 1998 by the Massachusetts Institute of Technology. Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting...
  • Page 322 Administrator’s Guide SoundPoint IP / SoundStation IP Each revision is distinguished by a version number. You may use this Software under terms of this license revision or under the terms of any subsequent revision of the license. THIS SOFTWARE IS PROVIDED BY THE OPENLDAP FOUNDATION AND ITS CONTRIBUTORS ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A...
  • Page 323 Third Party Software endorse or promote products derived from this software without prior written permission. For written permission, please contact openssl-core@openssl.org. 5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior written permission of the OpenSSL Project.
  • Page 324 Administrator’s Guide SoundPoint IP / SoundStation IP 3. All advertising materials mentioning features or use of this software must display the following acknowledgement: "This product includes cryptographic software written by Eric Young (eay@cryptsoft.com)" The word 'cryptographic' can be left out if the routines from the library being used are not cryptographic related.
  • Page 325 Third Party Software Expat: Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd and Clark Cooper Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,...
  • Page 326 Administrator’s Guide SoundPoint IP / SoundStation IP D - 6...
  • Page 327: Index

    Index Numerics event logging A–84 feature A–92 802.1Q VLAN header 4–78 finder A–94 fonts A–72 gains A–42 access URL 4–65 graphic icons A–83 ACD. See also automatic call distribution hold, local reminder A–67 acoustic echo cancellation 4–75 idle display A–96 indicator classes A–82 acoustic echo cancellation <aec>...
  • Page 328 Administrator’s Guide SoundPoint IP / SoundStation IP sampled audio for sound effects A–30 basic TCP/IP A–58 SDP A–9 blind transfers 4–18 security A–88 BNS. See also background noise suppression shared calls A–67 boot failure messages 5–8 SIP A–10 boot server security policy 3–14 soft keys A–103 boot servers sound effect patterns A–32...
  • Page 329 Index configuration file example 4–62 connected party identification 4–5 electronic hookswitch, supported 4–9, A–123 consultative transfers 4–18 emergency <emergency> A–21, A–119 context sensitive volume control 4–5 emergency routing A–21, A–119 corporate directory 4–35, A–69, A–92 encryption <encryption> A–89 custom certificates 4–81 enhanced feature keys 4–40, A–92 definition language 4–40 customizable audio sound effects 4–5...
  • Page 330 Administrator’s Guide SoundPoint IP / SoundStation IP IP_500 font A–75 Microbrowser 4–32, 4–65 IP_600 font A–75 microphone mute 4–13 Microsoft Live Communications Server 2005 Integration 4–61 jitter buffer 4–74 migration dependencies C–9 miscellaneous patterns A–35 missed call configuration <serverMissedCall> keep-alive <keepalive> A–63 A–112 key features 1–6 missed call notification 4–4...
  • Page 331 Index missed call configuration A–112 RTP <RTP> A–56, A–57, A–62 Network Address Translation A–120 no answer A–115 quotas A–94 sampled audio files A–31 registration A–107 sampled audio for sound effects <saf> A–30 roaming buddies A–122 SCA. See also shared call appearances roaming privacy A–123 scheduled logging parameters A–87 routing A–118...
  • Page 332 Administrator’s Guide SoundPoint IP / SoundStation IP SIP basic protocols, header support B–4 troubleshooting Application is not compatible 5–2 SIP header application error messages 5–3 diversion A–12 application logging options 5–5 warning A–13 audio issues 5–15 SIP headers, warnings 4–72 blinking time 5–4 SIP.
  • Page 333 API. The relationship between you and Polycom is that of licensee/licensor. No legal partnership or agency relationship is created between you and Polycom. Neither you nor Polycom is a partner, an agent or has any authority to bind the other. You agree not to represent otherwise.
  • Page 334 Polycom Products. Polycom is willing to license the Software to you only upon the condition that you accept all of the terms contained in this agreement. Select the "Accept" button at the bottom of the page to confirm your acceptance.
  • Page 335 2.3. Reservation. Polycom reserves all rights in the Software not expressly granted to you in this Agreement. 3. SUPPORT SERVICES. 3.1. No Support Services. Polycom provides no support services for the Software. 4. TERMINATION. 4.1. Termination. Without prejudice to any other rights, Polycom may terminate this Agreement if you fail to comply with any of the terms and conditions of this Agreement.
  • Page 336 DFAR Section 227.7015(b). 9.4. Relationship Between the Parties. The relationship between you and Polycom is that of licensee/licensor. Neither party will represent that it has any authority to assume or create any obligation, express or implied, on behalf of the other party, nor to represent the other party as agent, employee, franchisee, or in any other capacity.
  • Page 337 If any provision of this Agreement is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. www.polycom.com Corporate Headquarters: 4750 Willow Road, Pleasanton, CA 94588, USA Phone 408- 526.9000 Fax: 408-526-9100...
  • Page 338 Addendum to SIP 3.1 Administrator’s Guide This addendum addresses changes to the SoundPoint IP / SoundStation IP SIP 3.1 Administrator’s Guide specific to the release of the SoundPoint IP 450 desktop phone. The SoundPoint IP 450 desktop phone hardware behaves in a similar manner to the SoundPoint IP 430 except for: •...
  • Page 339 Note For more information on the SoundPoint IP 450 desktop phone, refer to the User Guide at http://www.polycom.com/support/voip/ New or Changed Features Distribution Zip File As well as the sip.ld file in the archive, there is a separate file for the SoundPoint IP 450 phone called 2345-12450-001.sip.ld .
  • Page 340 This feature requires a license key for activation. Using this feature may require Note purchase of a license key or activation by Polycom channels. For more information, contact your Certified Polycom Reseller. The SoundPoint IP 450 phones can be configured to generate various quality metrics for listening and conversational quality.
  • Page 341 Administrator’s Guide Addendum for the SoundPoint IP 450 Gains <gain/> The default gain settings have been carefully adjusted to comply with the TIA-810-A digital telephony standard. Polycom recommends that you do not change these values. Attribute Default voice.gain.rx.analog.chassis.IP_450 voice.gain.rx.analog.ringer.IP_450 voice.gain.rx.digital.chassis.IP_450 voice.gain.rx.digital.ringer.IP_450...
  • Page 342 Administrator’s Guide Addendum for the SoundPoint IP 450 Receive Equalization <rxEq/> These settings control the performance of the receive equalization feature. Polycom recommends that you do not change these values. Attribute Default voice.rxEq.hs.IP_450.preFilter.enable voice.rxEq.hs.IP_450.postFilter.enable voice.rxEq.hd.IP_450.preFilter.enable voice.rxEq.hd.IP_450.postFilter.enable voice.rxEq.hf.IP_450.preFilter.enable voice.rxEq.hf.IP_450.postFilter.enable Transmit Equalization <txEq/>...
  • Page 343 Administrator’s Guide Addendum for the SoundPoint IP 450 Background <bg/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation bg.gray.selection Specifiy which type of background (w) and index (x) for that type is selected on reboot. bg.medRes.gray.pr.x.adj Specify the brightness adjustment to the graphic.
  • Page 344 Administrator’s Guide Addendum for the SoundPoint IP 450 Permitted Attribute Values Default Interpretation bg.medRes.gray.bm.x.name any string Graphic files for display on the phone and Expansion Module and also the brightness bg.medRes.gray.bm.x.em. any string adjustment to the graphic. name For x=1: bg.medRes.gray.bm.x.adj integer •...
  • Page 345 Administrator’s Guide Addendum for the SoundPoint IP 450 Bitmaps <bitmap/> The IP_450 parameters affect the SoundStation IP 450 desktop phone. Indicators <ind/> The IP_450 parameters affect the SoundStation IP 450 desktop phone. Animations <anim/> The IP_450 parameters affect the SoundStation IP 450 desktop phone. Graphic Icons <gi/>...
  • Page 346 Administrator’s Guide Addendum for the SoundPoint IP 450 The SoundPoint IP 450 desktop phone default key layout is as follows: Key ID Key ID Function Key ID Function Key ID Function Key ID Function Line1 DialpadPound Messages SoftKey3 Line2 Dialpad9 Handsfree Line3 Dialpad8...
  • Page 347 Administrator’s Guide Addendum for the SoundPoint IP 450 1 - 10...

Table of Contents