Polycom SIP 3.0.2 Administrator's Manual
Polycom SIP 3.0.2 Administrator's Manual

Polycom SIP 3.0.2 Administrator's Manual

Sip 3.0.2
Hide thumbs Also See for SIP 3.0.2:
Table of Contents

Advertisement

Quick Links

Administrator's Guide for the
®
®
SoundPoint
IP/SoundStation
IP
Family
SIP 3.0.2
April, 2008 Edition
1725-11530-300 Rev. A2
SIP 3.0.2

Advertisement

Table of Contents
loading

Summary of Contents for Polycom SIP 3.0.2

  • Page 1 Administrator’s Guide for the ® ® SoundPoint IP/SoundStation Family SIP 3.0.2 April, 2008 Edition 1725-11530-300 Rev. A2 SIP 3.0.2...
  • 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

    ® 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: ___________________________ BootROM version: ________________________________________________...
  • Page 4 Administrator’s Guide SoundPoint IP / SoundStation IP...
  • Page 5: Table Of Contents

    Contents About This Guide ....... . . iii 1 Introducing the SoundPoint IP / SoundStation IP Family . . . 1–1 SoundPoint IP Desktop Phones .
  • Page 6 Administrator’s Guide SoundPoint IP / SoundStation IP Call Waiting ..........4–3 Called Party Identification .
  • Page 7 Contents Multilingual User Interface ........4–29 Downloadable Fonts ........4–30 Synthesized Call Progress Tones .
  • Page 8 Administrator’s Guide SoundPoint IP / SoundStation IP Status Menu ........... 5–4 Log Files .
  • Page 9 Contents Feature <feature/> ........A–83 Resource <res/>...
  • Page 10 Administrator’s Guide SoundPoint IP / SoundStation IP Assigning a VLAN ID Using DHCP ......C–16 Parsing Vendor ID Information .
  • Page 11: Introducing The Soundpoint Ip / Soundstation Ip Family

    Introducing the SoundPoint IP / SoundStation IP Family This chapter introduces the SoundPoint IP / SoundStation IP family, which is supported by the software described in this guide. The SoundPoint IP / SoundStation IP family provides a powerful, yet flexible IP communications solution for Ethernet TCP/IP networks, delivering excellent voice quality.
  • Page 12: 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. The currently supported desktop phones are: • SoundPoint IP 301 •...
  • Page 13 Introducing the SoundPoint IP / SoundStation IP Family • SoundPoint IP 430 • SoundPoint IP 501 • SoundPoint IP 550/560 1 - 3...
  • Page 14: Soundstation Ip Conference Phone

    SoundPoint IP 650 SoundStation IP Conference Phone This section describes the current SoundPoint IP conference phone. 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: 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 16 Administrator’s Guide SoundPoint IP / SoundStation IP — Application flexibility for call management and new telephony applications • Large LCD — Easy-to-use, easily readable and intuitive interface — Support of rich application content, including multiple call appearances, presence and instant messaging, and XML services —...
  • Page 17: Overview

    • A call server is active and configured to receive and send SIP messages. For more information on IP PBX and softswitch vendors, go to http://www.polycom.com/techpartners1/ This chapter contains information on: • Where SoundPoint IP / SoundStation IP Phones Fit •...
  • Page 18: 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 19: 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 20: 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 21: 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 22 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 23: 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 24: Available Features

    Administrator’s Guide SoundPoint IP / SoundStation IP • Ring tones • Synthesized tones • Contact directories Available Features The SoundPoint IP 300 and 500 phones will be supported on the latest Note maintenance patch release of the SIP 2.1 software stream—currently SIP 2.1.2. Any new features introduced after SIP 2.1.2 are not supported.
  • Page 25 Overview — Connected Party Identification—The identity of the party to which the user has connected is displayed and logged, if the name is provided by the call server. — Context Sensitive Volume Control—The volume of user interface sound effects, such as the ringer, and the receive volume of call audio is adjustable.
  • Page 26 Administrator’s Guide SoundPoint IP / SoundStation IP — Message Waiting Indication—The phone will flash a message-waiting indicator (MWI) LED when instant messages and voice messages are waiting. — Microphone Mute—When the microphone mute feature is activated, visual feedback is provided. —...
  • Page 27 Overview — Multilingual User Interface—All phones except SoundPoint IP 301 have multilingual user interfaces. — 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. —...
  • Page 28 Administrator’s Guide SoundPoint IP / SoundStation IP — Background Noise Suppression—Designed primarily for hands-free operation, reduces background noise to enhance communication in noisy environments. — Comfort Noise Fill—Designed to help provide a consistent noise level to the remote user of a hands-free call. —...
  • Page 29: Setting Up Your System

    Configuration Files on page A-1. For installation and maintenance of Polycom SoundPoint IP phones, the use of a Note 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 30: 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 31 Setting up Your System Alternate Configuration File Local Parameter DHCP Option DHCP DHCP (application only) FLASH Refer to DHCP • • • Menu on page boot server address • • Note: This value SIP server address is configurable. 42 then 4 •...
  • Page 32: 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 33: Modifying The Network Configuration

    Setting up Your System Setting Option 66 to tftp://192.168.9.10 has the effect of forcing a TFTP download. Note 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 34 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 Enabled, Disabled If enabled, DHCP will be used to obtain the parameters DHCP Client discussed in DHCP or Manual TCP/IP Setup on page 3-2.
  • Page 35 Setting up Your System A parameter value of “???” indicates that the parameter has not yet been set and Note 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 36 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 37 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 38 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 39 Setting up Your System The Server User and Server Password parameters should be changed from the Note default values. Note that for insecure protocols the user chosen should have very few privileges on the server. Ethernet Menu The following Ethernet configuration parameters can be modified on the Ethernet menu: Name Possible Values...
  • Page 40: Setting Up The Boot Server

    Administrator’s Guide SoundPoint IP / SoundStation IP Syslog Menu Syslog is a standard for forwarding log messages in an IP network. The term "syslog" is often used for both the actual syslog protocol, as well as the application or library sending syslog messages. The syslog protocol is a very simplistic protocol: the syslog sender sends a small textual message (less than 1024 bytes) to the syslog receiver.
  • Page 41 Use this procedure as a recommendation if this is your first boot server setup. Note 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 42 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 43: Deploying Phones From The Boot Server

    Setting up Your System the phone needs to read, such as the application executable and the standard configuration files, should be made read-only through file server file permissions. Deploying Phones From the Boot Server You can successfully deploy SoundPoint IP and SoundStation IP phones from one or more boot servers.
  • Page 44 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 45: Upgrading Sip Application

    Setting up Your System 4. Reboot the phones by pressing the reboot multiple key combination. For more information, refer to Multiple Key Combinations on page C-9. The bootROM and SIP application modify the APPLICATION APP_FILE_PATH attribute of the <Ethernet address>.cfg files so that it references the appropriate sip.ld files.
  • Page 46: Supporting Soundpoint Ip And Soundstation Ip 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 47: Supporting Soundpoint Ip 300 And 500 Phones

    Setting up Your System The phones can be configured to periodically poll the boot server to check for changed configuration files or application executable. If a change is detected, the phone will reboot to download the change. Refer to Provisioning <prov/> on page A-81.
  • Page 48 SoundPoint IP 300 and 500 phones. 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/support/voice/. 3 - 20...
  • Page 49: 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 50 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 51: 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 52: 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 53: Connected Party Identification

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

    Administrator’s Guide SoundPoint IP / SoundStation IP L16/16000 is not supported on SoundPoint IP 301 and SoundStation IP 4000 Note phones. The alternate sampled audio sound effect files must be present on the boot server Note or the Internet for downloading at boot time. Configuration changes can performed centrally at the boot server or locally: Configuration File: Specify patterns used for sound effects and the individual tones or...
  • Page 55: 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 56: 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 57: Handset, Headset, And Speakerphone

    For more information, refer to “Technical Bulletin 35150: Using an Electronic Hookswitch with SountPoint IP Phones“ at http://www.polycom.com/support/voip/. Configuration changes can performed centrally at the boot server or locally: Configuration file: Enable or disable persistent headset mode.
  • Page 58 Administrator’s Guide SoundPoint IP / SoundStation IP The directory is the central database for several other features including speed-dial, distinctive incoming call treatment, presence, and instant messaging. If a user makes a change to the local contact directory, there is a five second Note timeout before it is uploaded to the boot server as <mac-address>-directory.cfg.
  • Page 59 Configuring Your System <item> <ln>Doe</ln> <fn>John</fn> <ct>1001</ct> <sd>1</sd> <rt>1</rt> <dc/> <ad>0</ad> <ar>0</ar> <bw> 0</bw> <bb>0</bb> </item> <item> <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 first name 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 60: Local Digit Map

    Administrator’s Guide SoundPoint IP / SoundStation IP Element Permitted Values Interpretation Null, 1 to 21 ring type When incoming calls can be associated with a directory entry by matching the address fields, this field is used to specify ring type to be used.
  • Page 61: Microphone Mute

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

    Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can performed centrally at the boot server or locally: XML file: The <sd>x</sd> element in the <Ethernet address>-directory.xml Central 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 63: Idle Display Animation

    Configuring Your System Web Server Set the basic SNTP and daylight savings settings. Local (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 64: 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 65: Automatic Off-Hook Call Placement

    For the bitmaps, enter a bitmap filename and put the file on the boot server. For example: bg.gf.gray.3.name=”polycom.bmp” The default size for bitmaps is 320 x 160. Smaller bitmaps will be centered and a white border added. Larger bitmaps will be centered and cropped to fit.
  • Page 66: Call Transfer

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

    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 individual parties within a conference can be managed.
  • Page 68: Call Forward

    Administrator’s Guide SoundPoint IP / SoundStation IP Call Forward The phone provides a flexible call forwarding feature to forward calls to another destination. Call forwarding can be applied in the following cases: • Automatically to all calls • Calls from a specific caller (extension) •...
  • Page 69: Directed Call Pick-Up

    Configuring Your System Configuration changes can performed centrally at the boot server or locally: Configuration file: Enable or disable server-based call forwarding. Central sip.cfg For more information, refer to SIP <SIP/> on page A-10 (boot server) • Configuration file: Enable or disable server-based call forwarding as a per-registration feature.
  • Page 70: Call Park/Retrieve

    Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can performed centrally at the boot server: Configuration file: Turn this feature on or off. Central sip.cfg For more information, refer to Feature <feature/> on page A-83. (boot server) • Call Park/Retrieve An active call can be parked, and the parked call can be retrieved by another phone.
  • Page 71: Configurable Feature Keys

    Configuring Your System • Instant Messaging • Multilingual User Interface • Downloadable Fonts • Synthesized Call Progress Tones • Microbrowser • Real-Time Transport Protocol Ports • Network Address Translation • Corporate Directory • Recording and Playback of Audio Calls This section also provides information for making configuration changes for the following advanced call server features: •...
  • Page 72: Multiple Line Keys Per Registration

    Administrator’s Guide SoundPoint IP / SoundStation IP • The phone keys without removable key caps cannot be remapped. These include: — Any keys on the dial pad — Volume control — Handsfree, Mute, Headset — Hold — Navigation Cluster Configuration changes can performed centrally at the boot server: Configuration File: Set the key scrolling timeout, key functions, and sub-pointers for each Central...
  • Page 73: Multiple Call Appearances

    Configuring Your System 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. The number of concurrent calls per line key is configurable. Each registration can have more than one line key assigned to it (refer to the previous section, Multiple Line Keys per Registration).
  • Page 74: Bridged Line Appearance

    Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can performed centrally at the boot server or locally: Configuration file: Specify whether diversion should be disabled on shared lines. Central sip.cfg For more information, refer to Shared Calls <shared/> on page (boot server) •...
  • Page 75: Busy Lamp Field

    Configuring Your System 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 76: Customizable Fonts And Indicators

    Administrator’s Guide SoundPoint IP / SoundStation IP Polycom recommends that the BLF not be used in conjunction with the Microsoft Live Communications Server 2005 feature. For more information, refer to Microsoft Live Communications Server 2005 Integration on page 4-43. Use this feature with TCPpreferred transport (refer to Server <server/>...
  • Page 77: Multilingual User Interface

    Configuring Your System message or by initiating a new dialog. The destination for new dialog messages can be entered manually or selected from the contact directory, the preferred method. There are no related configuration changes. Multilingual User Interface This feature is not available on SoundPoint IP 301 phones. Note The system administrator or the user can select the language.
  • Page 78: Downloadable Fonts

    Administrator’s Guide SoundPoint IP / SoundStation IP Downloadable Fonts New fonts can be loaded onto the phone. For guidelines on downloading fonts, refer to Fonts <font/> on page A-66. 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.
  • Page 79: Real-Time Transport Protocol Ports

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

    Corporate Directory 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. 4 - 32...
  • Page 81 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 82 Administrator’s Guide SoundPoint IP / SoundStation IP 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 83: 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 84: Voice Mail Integration

    Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can be performed centrally at the boot server: Configuration file: Turn this feature on or off. Central sip.cfg For more information, refer to Feature <feature/> on page A-83. (boot server) • Voice Mail Integration The phone is compatible with voice mail servers.
  • Page 85: Multiple Registrations

    Configuring Your System Web Server For one-touch voice mail access, enable the “one-touch voice mail” Local user preference and bypass instant messages to remove the step of (if enabled) selecting between instant messages and voice mail after pressing the Messages key on the SoundPoint IP 430, 500, 501, 550, 560, 600, 601, and 650 (instant messages are still accessible from the Main Menu).
  • Page 86: Automatic Call Distribution

    Administrator’s Guide SoundPoint IP / SoundStation IP Web Server Specify the local SIP signaling port and an array of SIP servers to Local register to. (if enabled) Navigate to http://<phoneIPAddress>/appConf.htm#se For up to six registrations (depending on the phone model, in this case the maximum is six even for the IP 601 and 650), specify a display name, a SIP address, an optional display label, an authentication user ID and password, the number of line keys to use,...
  • Page 87: Server Redundancy

    (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 88 Administrator’s Guide SoundPoint IP / SoundStation IP Configuration changes can performed centrally at the boot server: Configuration file: Specify global primary and fallback server configuration parameters. Central sip.cfg For more information, refer to Protocol <volpProt/> on page A-6. (boot server) •...
  • Page 89 Configuring Your System timeout defined in RFC 3261. If it is not the last server in the list, the maximum number of retries using the configurable retry timeout is used. For more information, refer to Server <server/> on page Registration <reg/> on page A-89.
  • Page 90 Administrator’s Guide SoundPoint IP / SoundStation IP It is possible to configure the phone for more than two servers per registration, but Note you need to exercise caution when doing this to ensure that the phone and network load generated by registration refresh of multiple registrations do not become excessive.
  • Page 91: Presence

    Configuring Your System Presence The Presence feature allows the phone to monitor the status of other users/devices and allows other users to monitor it. The status of monitored users is displayed visually and is updated in real time in the Buddies display screen or, for speed dial entries, on the phone’s idle display.
  • Page 92 Administrator’s Guide SoundPoint IP / SoundStation IP 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-27. Configuration changes can performed centrally at the boot server:...
  • Page 93 Configuring Your System For the feature.2.name = messaging attribute, set feature.2.enabled to 1. Locate the voIpProt parameter. Set the voIpProt.server.x.transport attribute to TCPpreferred or TLS. Your selection depends on the LCS configuration. The TLS protocol is not supported on SoundPoint IP 300 and 500 phones. Note Set the voIpProt.server.x.address to the LCS address.
  • Page 94 Administrator’s Guide SoundPoint IP / SoundStation IP Save the modified phone1.cfg configuration file. 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.
  • Page 95: Setting Up Audio Features

    Configuring Your System Locate the roaming_privacy attribute. 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-104. m Save the modified phone1.cfg configuration file. Setting Up Audio Features Proprietary state-of-the-art digital signal processing (DSP) technology is used to provide an excellent audio experience.
  • Page 96: Jitter Buffer And Packet Error Concealment

    Administrator’s Guide SoundPoint IP / SoundStation IP 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. The jitter buffer is adaptive and configurable for different network environments.
  • Page 97: Dtmf Tone Generation

    Configuring Your System DTMF Tone Generation The phone generates dual tone multi-frequency (DTMF) tones in response to user dialing on the dial pad. These tones are transmitted in the real-time transport protocol (RTP) streams of connected calls. The phone can encode the DTMF tones using the active voice codec or using RFC 2833 compatible encoding.
  • Page 98: Audio Codecs

    Administrator’s Guide SoundPoint IP / SoundStation IP For more information, refer to Acoustic Echo Cancellation <aec/> on page A-34, Acoustic Echo Suppression <aes/> on page A-41, and Background Noise Suppression <ns/> on page A-42. For the SoundPoint IP 501 and 601, utilizing acoustic echo cancellation will introduce a small delay increase into the audio path which might cause a lower voice quality.
  • Page 99: Background Noise Suppression

    Configuring Your System Background Noise Suppression Background noise suppression (BNS) is designed primarily for hands-free operation and reduces background noise to enhance communication in noisy environments. There are no related configuration changes. Comfort Noise Fill Comfort noise fill is designed to help provide a consistent noise level to the remote user of a hands-free call.
  • Page 100: Ieee 802.1P/Q

    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 phones can be configured to generate various quality metrics for listening and conversational quality.
  • Page 101: Setting Up Security Features

    Configuring Your System The RTCP XR packets are complaint with RFC 3611 - RTP Control Extended Reports (RTCP XR). The packets are sent to a report collector as specified in draft RFC draft-ietf_sipping_rtcp-summary-02. Three types of quality reports can be enabled: •...
  • Page 102: Custom Certificates

    For more information on using custom certificates, refer to “Technical Bulletin Note 17877: Using Custom Certificates With SoundPoint IP Phones” at www.polycom.com/support/voice/ Configuration changes can performed locally: Local Phone User The custom certificate can be specified and the type of certificate to...
  • Page 103: Configuration File Encryption

    Configuring Your System Configuration changes can performed centrally at the boot server: Configuration File: Specify the type of validation to perform on a request-by-request Central basis, appropriate to specific event types in some cases. sip.cfg (boot server) For more information, refer to Request Validation •...
  • Page 104 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 105: Troubleshooting Your Soundpoint Ip / Soundstation Ip Phones

    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/. If your problems is not listed in this chapter nor described in the latest Release Notes, contact your Certified Polycom Reseller for support.
  • Page 106: Error Messages

    Administrator’s Guide SoundPoint IP / SoundStation IP Error Messages There are several different error messages that can be displayed on the phone when it is booting. Some of these errors are fatal, meaning that the phone will not able to boot until this issue has been resolved, and some are recoverable, meaning the phone will continue booting after the error, but the configuration of the phone may not be what you were expecting.
  • Page 107: Application Error Messages

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones Not all configuration files were present on the server Similarly, a message about configuration files not being present, means that the phone was able to reach the boot server, but that it was not able to find all the necessary files.
  • Page 108: Status Menu

    Administrator’s Guide SoundPoint IP / SoundStation IP 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. If an SNTP is not available, the data/time display can be turned off so that the flashing display is not a distraction.
  • Page 109 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 110 Administrator’s Guide SoundPoint IP / SoundStation IP • log.render.file.upload.append.sizeLimit—Controls the maximum size of log files on the boot server (default=512 kb) • log.render.file.upload.append.limitMode—Controls action to take when server log reaches max size, actions are stop and delete Scheduled Logging Scheduled logging is a powerful tool for anyone who is trying to troubleshoot an issue with the phone that only occurs after some time in operation.
  • Page 111: Reading A Boot Log

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones For more information, refer to Multiple Key Combinations on page C-9. When the log files are manually uploaded, the word “now” is inserted into the name of the file, for example, 0004f200360b-now-boot.log . Reading a Boot Log The following figure shows a portion of a boot log file: Boot Failure Messages...
  • Page 112: Reading An Application Log

    Administrator’s Guide SoundPoint IP / SoundStation IP Reading an Application Log The following figure shows a portion of an application log file: 5 - 8...
  • Page 113: Power And Startup

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones 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 •...
  • Page 114: Controls

    Administrator’s Guide SoundPoint IP / SoundStation IP 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 •...
  • Page 115: Access To Screens And Systems

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones 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. •...
  • Page 116: Calling

    Administrator’s Guide SoundPoint IP / SoundStation IP 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 117: Displays

    Troubleshooting Your SoundPoint IP / SoundStation IP Phones 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. •...
  • Page 118: Audio

    Troubleshooting Audio and Echo Issues Echo on external calls • on SoundPoint ® IP Phones” on the through a gateway. Polycom Support Knowledgebase. Internal calls (no gateway), • handsfree echo. Internal calls (no gateway), • handset to handset echo. Upgrading...
  • Page 119 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 120: 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 121 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 122: Application Configuration

    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/support/voice/. 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 123 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 124: Protocol

    Microbrowser <mb/> 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 125 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 126 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 127 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 128 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 129 Configuration Files Permitted Attribute Values Default Interpretation voIpProt.SIP.connectionReuse.useAli 0, 1 If set to 0, this is the old behavior. 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 130 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation voIpProt.SIP.serverFeatureControl.dn 0, 1 If set to 1, server-based DND is enabled. The call server has control of DND. If set to 0, server-based DND is not enabled. This is the old behavior. voIpProt.SIP.authOptimizedInFailover If set to 1, when failover occurs, the first new SIP request is sent to the server that sent the...
  • Page 131 Configuration Files 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 132 Administrator’s Guide SoundPoint IP / SoundStation IP Alert Information <alertInfo/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation volpProt.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...
  • Page 133 “SUBSCRIBE” or “NOTIFY”. If set to Null, all events will be validated. voIpProt.SIP.requestValidation.dige A valid string Polycom Determines string used for Realm. st.realm SPIP Special Events <specialEvent/> This configuration attribute is defined as follows:...
  • Page 134: Dial Plan

    Administrator’s Guide SoundPoint IP / SoundStation IP Dial Plan <dialplan/> The dial plan is not applied against Placed Call List, VoiceMail, last call return, and Note remote control dialed numbers. This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation dialplan.applyToCallListDial...
  • Page 135 Configuration Files This attributes also includes: • Digit Map <digitmap/> • Routing <routing/> Digit Map <digitmap/> A digit map is defined either by a “string” or by a list of strings. Each string in the list is an alternative numbering scheme, specified either as a set of digits or timers, or as an expression over which the gateway will attempt to find a shortest possible match.
  • Page 136 Administrator’s Guide SoundPoint IP / SoundStation IP • There is no limitation on the number of R triplet sets in a digit map. However, a digit map that contains less than full number of triplet sets (for example, a total of 2Rs or 5Rs) is considered an invalid digit map. •...
  • Page 137: Localization

    Configuration Files Server <server/> This configuration attribute is defined as follows: Attribute Permitted Values Default Interpretation dialplan.routing.server.x.addre dotted-decimal IP address Null IP address or host name and port of or host name a SIP server that will be used for routing calls.
  • Page 138 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 139 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 140 Administrator’s Guide SoundPoint IP / SoundStation IP Extended character support available on SoundPoint IP 600 and SoundStation IP 4000 platforms includes the following Unicode character ranges Name Range CJK Symbols and Punctuation U+3000 - U+303F Hiragana U+3040 - U+309F Katakana U+30A0 - U+30FF Bopomofo U+3100 - U+312F...
  • Page 141: User Preferences

    Configuration Files Date and Time <datetime/> This configuration attribute is defined as follows: Permitted Attribute Values Interpretation lcl.datetime.time.24HourClock If 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 142: Tones

    Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation up.welcomeSoundOnWarmBootE 0, 1 If set to 1, play welcome sound effect on warm nabled as well as cold boots, otherwise only a cold boot will trigger the welcome sound effect. up.localClockEnabled 0, 1 If set to 1, display the date and time on the idle...
  • Page 143 Configuration Files 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. tone.dtmf.onTime positive When a sequence of DTMF tones is...
  • Page 144 Administrator’s Guide SoundPoint IP / SoundStation IP 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 145: Sampled Audio For Sound Effects

    Configuration Files 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). tone.chord.cat.x.level.y -57 to 3 Level of this component in dBm0.
  • Page 146: Sound Effects

    Administrator’s Guide SoundPoint IP / SoundStation IP In the following table, x is the sampled audio file number. Attribute Permitted Values Interpretation saf.x Null OR valid path name If Null, the phone will use a built-in file. OR an RFC If set to a path name, the phone will attempt to download this file 1738-compliant URL to a at boot time from the boot server.
  • Page 147 Configuration Files 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 148 Administrator’s Guide SoundPoint IP / SoundStation IP Currently, patterns that use the sampled instruction are limited to the following Note 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 149 Configuration Files 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. Ringer pattern number Default description Silent Ring...
  • Page 150 Administrator’s Guide SoundPoint IP / SoundStation IP 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 Silent Ring will only provide a visual indication of an incoming call, but no audio Note indication.
  • Page 151 Configuration Files 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 152: Voice Settings

    Administrator’s Guide SoundPoint IP / SoundStation IP Modification of se.rt.modification.enabled and se.rt.x.name parameters Note 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...
  • Page 153 Configuration Files 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 G711A 64 Kbps 8 Ksps 10ms - 80ms...
  • Page 154 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation voice.codecPref.IP_4000.G711Mu Null, 1-3 Specifies the codec preferences for the SoundStation IP 4000 platform. voice.codecPref.IP_4000.G711A Interpretation as above. voice.codecPref.IP_4000.G729AB Null Not supported by default so that G.711Mu and G.711A local conferences can be supported.
  • Page 155 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 156 Administrator’s Guide SoundPoint IP / SoundStation IP Attribute Default voice.gain.rx.analog.ringer.IP_650 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_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.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 voice.gain.tx.analog.chassis.IP_430 voice.gain.tx.analog.chassis.IP_601 voice.gain.tx.analog.chassis.IP_650 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 A - 38...
  • Page 157 Configuration Files Attribute Default 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.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 voice.handset.txag.adjust.IP_650 voice.handset.sidetone.adjust.IP_330 voice.handset.sidetone.adjust.IP_430 voice.handset.sidetone.adjust.IP_650 voice.headset.rxag.adjust.IP_330 voice.headset.rxag.adjust.IP_430 voice.headset.rxag.adjust.IP_650 voice.headset.txag.adjust.IP_330 voice.headset.txag.adjust.IP_430 voice.headset.txag.adjust.IP_650 A - 39...
  • Page 158 Administrator’s Guide SoundPoint IP / SoundStation IP Attribute Default voice.headset.sidetone.adjust.IP_330 voice.headset.sidetone.adjust.IP_430 voice.headset.sidetone.adjust.IP_650 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...
  • Page 159 Attribute Default 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 voice.aes.hf.duplexBalance.2...
  • Page 160 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 voice.ns.hf.enable voice.ns.hf.signalAttn...
  • Page 161 Automatic Gain Control <agc/> These settings control the performance of the transmit automatic gain control feature. Automatic Gain Control will be implemented in a future release. Note Polycom recommends that you do not change these values. Attribute Default voice.agc.hs.enable voice.agc.hd.enable voice.agc.hf.enable...
  • Page 162 Administrator’s Guide SoundPoint IP / SoundStation IP Attribute Default 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 voice.rxEq.hd.IP_600.preFilter.enable voice.rxEq.hd.IP_601.preFilter.enable voice.rxEq.hd.IP_650.preFilter.enable voice.rxEq.hd.IP_330.postFilter.enable voice.rxEq.hd.IP_430.postFilter.enable voice.rxEq.hd.IP_500.postFilter.enable voice.rxEq.hd.IP_600.postFilter.enable voice.rxEq.hd.IP_601.postFilter.enable voice.rxEq.hd.IP_650.postFilter.enable voice.rxEq.hf.IP_330.preFilter.enable voice.rxEq.hf.IP_430.preFilter.enable voice.rxEq.hf.IP_500.preFilter.enable voice.rxEq.hf.IP_600.preFilter.enable voice.rxEq.hf.IP_601.preFilter.enable voice.rxEq.hf.IP_650.preFilter.enable voice.rxEq.hf.IP_4000.preFilter.enable voice.rxEq.hf.IP_330.postFilter.enable voice.rxEq.hf.IP_430.postFilter.enable voice.rxEq.hf.IP_500.postFilter.enable voice.rxEq.hf.IP_600.postFilter.enable voice.rxEq.hf.IP_601.postFilter.enable voice.rxEq.hf.IP_650.postFilter.enable voice.rxEq.hf.IP_4000.postFilter.enable A - 44...
  • Page 163 Configuration Files 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 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...
  • Page 164 Administrator’s Guide SoundPoint IP / SoundStation IP Attribute Default 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_330.postFilter.enable 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 Activity Detection <vad/> These settings control the performance of the voice activity detection (silence suppression) feature. Permitted Attribute Values...
  • Page 165 Configuration Files Permitted Attribute Values Default Interpretation voice.vad.signalAnnex 0, 1 Null If set to 1 and voice.vadEnable is set to 1, Annex B is used. A new line can be added to SDP depending on the setting of this parameter and the voice.vadEnable parameter.
  • Page 166 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation voice.qualityMonitoring.collector.enable.tri 0, 1, 2 Controls the generation of periodic ggeredPeriodic quality reports triggered by alert states. If set to 0, alert states do not cause periodic reports to be generated. If set to 1, periodic reports will be generated when an alert state is critical.
  • Page 167 Configuration Files Permitted Attribute Values Default Interpretation voice.qualityMonitoring.collector.alert.dela Null, 10 to Null Threshold value of one way delay y.threshold.warning 2000 (in ms) that causes phone to send a critical alert quality report. If set to Null, warning alerts are not generated due to one way delay.
  • Page 168: Quality Of Service

    Administrator’s Guide SoundPoint IP / SoundStation IP Quality of Service <QOS/> These settings control the Quality of Service (QOS) options. This attribute includes: • Ethernet IEEE 802.1p/Q <ethernet/> • IP TOS <IP/> Ethernet IEEE 802.1p/Q <ethernet/> The following settings control the 802.1p/Q user_priority field: •...
  • Page 169 Configuration Files IP TOS <IP/> The following settings control the “type of service” field in outgoing packets: • RTP <rtp/> • Call Control <callControl/> 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...
  • Page 170: 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 171 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 172 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 173 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 174 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 175: 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 176: 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 177 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 178 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 179: Directory

    Configuration Files Permitted Attribute Values Default Interpretation call.shared.oneTouchResume 0, 1 If set to 1, when a shared line has a call on hold the remote user can press that line and resume the call. If more than one call is on hold on the line then the first one will be selected and resumed automatically.
  • Page 180 Administrator’s Guide SoundPoint IP / SoundStation IP 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. (Different phone models have variable flash memory.) When the volatile storage option is enabled, ensure that a properly configured boot server that allows uploads is available to store a back-up copy of the directory or its contents will be lost when the phone reboots or loses power.
  • Page 181 Configuration Files Permitted Attribute Values Default Interpretation dir.local.nonVolatile.maxSize.8meg 1 to 100 Attribute applies only to platforms with 8 Mbytes 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 contact directory is read only.
  • Page 182 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation dir.corp.password UTF-8 encoded Null The password used to authenticate string to the LDAP server. dir.corp.filterPrefix UTF-8 encoded Null Predefined filter string. string If set to Null or invalid, “(objectclass=person)”...
  • Page 183: Presence

    Configuration Files Permitted Attribute Values Default Interpretation dir.corp.backGroundSync.period 60 to 65535, The corporate directory cache is seconds refreshed after the corporate directory feature has not been used for this period of time. dir.corp.viewPersistence 0, 1 If set to 0 or Null, the browse position in the data on the LDAP server and the attribute filters are reset for subsequent usage of the...
  • Page 184: Fonts

    Administrator’s Guide SoundPoint IP / SoundStation IP Fonts <font/> This section does not apply to the SoundPoint IP 301 phones. Note These settings control the phone’s ability to dynamically load an external font file during boot up. Loaded fonts can either overwrite pre-existing fonts embedded within the software (not recommended) or can extend the phone’s font support for Unicode ranges not already embedded.
  • Page 185 . 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 186 Administrator’s Guide SoundPoint IP / SoundStation IP IP_400 font <IP_400/> This configuration attribute is defined as follows: Attribute Permitted Values Default Interpretation font.IP_400.x.name Null Defines the font file that will be loaded from fontName_height_Uxx00_U yyFF.fon OR boot server during boot up. fontName_height_Uxx00_U Note: When several font.IP_430.x.name xxFF.fnt...
  • Page 187: Keys

    <keys .../> element of the configuration file. These will override the built-in assignments. 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 y is the key number. Note that IP_300 parameters affect...
  • Page 188: Backgrounds

    Administrator’s Guide SoundPoint IP / SoundStation IP The following table lists the functions that are available: Functions ArrowDown Dialpad5 Line2 Select ArrowLeft Dialpad6 Line3 Setup ArrowRight Dialpad7 Line4 SoftKey1 ArrowUp Dialpad8 Line5 SoftKey2 BuddyStatus Dialpad9 Line6 SoftKey3 CallList DialpadStar Messages SoftKey4 Conference DialpadPound...
  • Page 189: Bitmaps

    Configuration Files 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/> In the following table, x=IP_300, IP_330, IP_400, IP_500, IP_600, IP_4000 and y is the bitmap number. Note that IP_300 parameters affect SoundPoint IP 301 phones, IP_330 parameters affect SoundPoint IP 320 and 330 phones, IP_400 parameters affect SoundPoint IP 430 phones, IP_500 parameters affect SoundPoint IP 501 phones, IP_600 parameters affect SoundPoint IP 550, 560,...
  • Page 190 Administrator’s Guide SoundPoint IP / SoundStation IP 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 •...
  • Page 191 Configuration Files 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. ind.pattern.x.step.y.duration positive integer Duration in milliseconds for this step.
  • Page 192 Administrator’s Guide SoundPoint IP / SoundStation IP 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 193: Event Logging

    IP 4000: 1-68 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 194 Administrator’s Guide SoundPoint IP / SoundStation IP 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 195 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 196 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 197: Security

    Configuration Files 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 198: License

    Administrator’s Guide SoundPoint IP / SoundStation IP 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.
  • Page 199: 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 - 81...
  • Page 200: Request

    Administrator’s Guide SoundPoint IP / SoundStation IP 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.
  • Page 201: Feature

    Configuration Files 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 202: 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 203 Configuration Files 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 204: Microbrowser

    Administrator’s Guide SoundPoint IP / SoundStation IP Microbrowser <mb/> This attribute’s settings control the home page, proxy and size limits to be used by the Microbrowser when it is selected to provide services. The Microbrowser is supported on the SoundPoint IP 430, 501, 550, 560, 601, and 650 and the SoundStation IP 4000 phones.
  • Page 205 Configuration Files Attribute Permitted Values Default Interpretation mb.idleDisplay.refresh 0 or an integer > 5 The period in seconds between refreshes of the idle display Microbrowser's content. If set to 0, the idle display Microbrowser is not refreshed. The minimum refresh period is 5 seconds (values from 1 to 4 are ignored, and 5 is used).
  • Page 206 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 207: Per-Phone Configuration

    3-15. 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 208 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 209 Configuration Files Permitted Attribute Values Default Interpretation reg.x.server.y.address dotted-decimal IP Null Optional IP address or host name, port, address or host transport, registration period, fail-over name parameters and lineseize subscription period of a SIP server that accepts registrations. reg.x.server.y.port 0, Null, 1 to 65535 Null Multiple servers can be listed starting with y=1, 2, ...
  • Page 210 Administrator’s Guide SoundPoint IP / SoundStation IP Permitted Attribute Values Default Interpretation reg.x.callsPerLineKey 1 to 24 OR 24 OR For the SoundPoint IP 600, 601, and 650 the permitted range is 1 to 24 and the default is 1 to 8 For all other phones the permitted range is 1 to 8 and the default is 8.
  • Page 211: Calls

    Configuration Files Permitted Attribute Values Default Interpretation reg.x.serverFeatureControl.cf 0, 1 If set to 1, server-based call forwarding is enabled. The call server has control of call forwarding. If set to 0, server-based call forwarding is not enabled. This is the old behavior. If reg.x.serverFeatureControl.cf is not Null, this attribute overrides the global server-based call forwarding flag in the...
  • Page 212 (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 213 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: x=1-34;...
  • Page 214: 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 215 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 216: 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 217 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-16. dialplan.x.applyToUserSend 0, 1 When present, and if...
  • Page 218 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 219: 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 220: 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.callBackMo contact or “registration” Configures message retrieval registration or and notification for the line.
  • Page 221: 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 222: 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 223: User Preferences

    Configuration Files User Preferences <user_preferences/> This configuration attribute is defined as follows: Permitted Attribute Values Default Interpretation up.analogHeadsetOpti 0, 1 Selects optional external hardware for use with a headset attached to the phone's analog headset jack. If set to 0, no compatible headset is attached. If set to 1, a DHSG-compatible headset is attached and can be used as an electonic hookswitch.
  • Page 224 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 225 Configuration Files Name Possible Values Description device.dhcp.offerTimeout 1 to 600 Number of seconds the phone waits for secondary DHCP Offer messages before selecting an offer. device.dhcp.bootSrvUseOp 0 to 3 For descriptions, refer to DHCP Menu on page 3-7. device.dhcp.bootSrvOpt 128 to 254 (Cannot be the same as VLAN ID Option) device.dhcp.bootSrvOptTy 0 or 1...
  • Page 226 Administrator’s Guide SoundPoint IP / SoundStation IP Name Possible Values Description device.auth.regUserx any string The SIP registration user name for registration x where x = 1 to 12. device.auth.regPasswordx any string The SIP registration password for registration x where x = 1 to 12. device.sec.configEncryptio any string Configuration encryption key that is used for...
  • Page 227: 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 228: 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 229: 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 230: 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 231 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 232: Response Support

    Administrator’s Guide SoundPoint IP / SoundStation IP Header Supported Notes Subject Subscription-State Supported Timestamp Unsupported User-Agent Warning 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 233 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 All 4xx responses for which the phone does not provide specific support will be Note treated the same as 400 Bad Request.
  • Page 234 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 235: 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 236: 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. Shared Call Appearance Signaling A shared line is an address of record managed by a call server. The server allows multiple end points to register locations against the address of record.
  • Page 237: 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 238 Administrator’s Guide SoundPoint IP / SoundStation IP • Digital Signature Trust Co. Global CA 3 • Digital Signature Trust Co. Global CA 4 • Entrust Worldwide by DST • Entrust.net Premium 2048 Secure Server CA • Entrust.net Secure Personal CA •...
  • Page 239: Encrypting Configuration Files

    A separate SDK, with a readme file, is provided to facilitate key generation and configuration file encryption and decrypt on a UNIX or Linux server. The utility is distributed as source code that runs under the UNIX operating system. For more information, contact Polycom Technical Support. C - 3...
  • Page 240 Administrator’s Guide SoundPoint IP / SoundStation IP A key is generated by the utility and must be downloaded to the phone so that it can decrypt the files that were encrypted on the server. The device.sec.configEncryption.key configuration file parameter is used to set the key on the phone.
  • Page 241: Changing The Key On The Phone

    Miscellaneous Administrative Tasks The following configuration file changes are required to modify this feature: Configuration File: sip.cfg Specify the phone-specific contact directory and the Central phone-specific configuration override file. (boot server) For more information, refer to Encryption <encryption/> on page A-80. Configuration file: Change the encryption key.
  • Page 242 Administrator’s Guide SoundPoint IP / SoundStation IP Model Width Height Color Depth IP 301 IP 320/330 monochrome IP 430 monochrome IP 501 2-bit grayscale or monochrome IP 600/601 2-bit grayscale or monochrome IP 550/560/650 4-bit grayscale or monochrome IP 4000 monochrome Logos smaller than described in the table above are acceptable, but larger logos may be truncated or interfere with other areas of the user interface.
  • Page 243: Bootrom/Sip Application Dependencies

    Miscellaneous Administrative Tasks </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"> <Animations> <IP_300> … </IP_300> <IP_330> … <IDLE_DISPLAY ind.anim.IP_3300.38.frame.1.bitmap="logo-330" ind.anim.IP_330.38.frame.1.duration="0"/> …...
  • Page 244: Migration Dependencies

    Administrator’s Guide SoundPoint IP / SoundStation IP This table summarizes some the major dependences that you are likely to encounter: Model BootROM SIP Application IP 301/501 2.6.1 or later 1.4.2, 1.5.4, 1.6.1 or later IP 320/330 3.2.3 B or later 2.1.1 or later IP 430 3.1.3 C or later...
  • Page 245: 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 246: Default Feature Key Layouts

    Administrator’s Guide SoundPoint IP / SoundStation IP • IP 4000: Menu, Exit, Off-hook/Hands-free, Redial 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, and 650 and SoundStation IP 4000 models.
  • Page 247 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 248 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 249 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 250 Administrator’s Guide SoundPoint IP / SoundStation IP SoundPoint IP 550/560/600/601/650 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 251 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 252: Assigning A Vlan Id Using Dhcp

    Administrator’s Guide SoundPoint IP / SoundStation IP 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 253: Parsing Vendor Id Information

    Miscellaneous Administrative Tasks 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" section of the packet and includes the phone’s part number and the bootROM version.
  • Page 254 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 255: 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 256 Administrator’s Guide SoundPoint IP / SoundStation IP 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to 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"...
  • Page 257 Third Party Software and/or other materials provided with the distribution. 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 258 Administrator’s Guide SoundPoint IP / SoundStation IP 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 259 Third Party Software D - 5...
  • Page 260 Administrator’s Guide SoundPoint IP / SoundStation IP D - 6...
  • Page 261: Index

    Index Numerics indicator classes A–73 indicator patterns A–73 802.1Q VLAN header 4–52 indicators, assignments A–73 IP TOS call control A–52 keep-alive A–57 ACD. See also automatic call distribution keys A–69 acoustic echo cancellation 4–49 local protocol A–6 acoustic echo cancellation <aec> A–40 localization A–19 main browser A–87 acoustic echo suppression <aes>...
  • Page 262 Administrator’s Guide SoundPoint IP / SoundStation IP voice activity detection A–46 bootROM error messages 5–2 voice coding algorithms bootROM tasks 2–3 voice coding algorithms <codecs> A–35 bootROM/SIP application dependencies C–7 voice settings A–34 bridged line appearance signaling B–10 volume persistence A–37 bridged line appearances 4–26 web server A–57 browser limits A–88...
  • Page 263 Index flash parameter. See also device fonts <font> A–66 date and time <datetime> A–23 forward all <fwd> A–96 default feature key layouts C–10 default password 3–5, 4–56, C–9 deploying phones from the boot server 3–15 gains <gain> A–37 device <device> A–105 graphic display backgrounds 4–16, A–70 DHCP graphic icons <gi>...
  • Page 264 Administrator’s Guide SoundPoint IP / SoundStation IP local contact directory file format 4–10 network monitoring <netMon> A–53 local digit map 4–12 no answer <noanswer> A–97 local reminder <localReminder> A–61 local user and administrator privilege levels 4–53 Option 66 3–7 localization <lcl> A–19 outbound proxy <outboundProxy>...
  • Page 265 Index 1xx Responses - Provisional B–6 RAM disk <ramdisk> A–81 2xx Responses - Success B–6 receive equalization <rxEq> A–43 3xx Responses - Redirection B–7 registration <reg> A–89 4xx Responses - Request Failure B–7 reliability of provisional responses B–9 5xx Responses - Server Failure B–8 request <request>...
  • Page 266 Administrator’s Guide SoundPoint IP / SoundStation IP troubleshooting Application is not compatible 5–2 application error messages 5–3 application logging options 5–5 audio issues 5–14 blinking time 5–4 boot failure messages 5–7 bootROM error messages 5–2 calling issues 5–12 Config file error. Error is 5–3 controls issues 5–10 Could not contact boot server 5–2 displays issues 5–13...
  • Page 267 SIP 3.0 Administrator’s Guide specific to the release of the SoundStation IP 7000 conference phone. The SoundStation IP 7000 conference phone is a next-generation phone with a modern industrial design and the latest advancements in Polycom voice technology. Some of the features include: •...
  • Page 268 For more information on the SoundStation IP 7000 conference phone, refer to the Note 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 SoundStation IP 7000 conference phone called 3111-40000-001.sip.ld .
  • Page 269 Administrator’s Guide Addendum for the SoundStation IP 7000 Single Registration The SoundStation IP 7000 phone supports a single registration. When the phone is unable to register with the call control server, the icon is shown (outline). Once the phone is able to register, the icon shown (solid).
  • Page 270 Administrator’s Guide Addendum for the SoundStation IP 7000 Treble/Bass Controls The treble and bass controls equalize the tone of the high and low frequency sound from the speakers. The SoundStation IP 7000 phone’s treble and bass controls can be modified by the user (through Menu >...
  • Page 271: Provisioning Phones Over Clink

    Administrator’s Guide Addendum for the SoundStation IP 7000 Provisioning Phones Over CLink Normally the SoundStation IP 7000 conference phone is provisioned over the Ethernet by the boot server. However, when two SoundStation IP 7000 phones are daisy-chained together, the one that is not directly connected to the Ethernet can still be provisioned (known as the secondary).
  • Page 272 Administrator’s Guide Addendum for the SoundStation IP 7000 • Gains <gain/> • Receive Equalization <rxEq/> • Transmit Equalization <txEq/> • Call Handling Configuration <call/> • Bitmaps <bitmap/> • Feature <feature/> SDP <SDP/> This new configuration attribute is defined as follows: Permitted Attribute Values...
  • Page 273 Default Interpretation 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 274 Administrator’s Guide Addendum for the SoundStation IP 7000 Codec Preferences <codecPref/> 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.24kbp Null voice.codecPref.IP_7000.G7221C.32kbp Null...
  • Page 275 Administrator’s Guide Addendum for the SoundStation IP 7000 Codec Profiles <audioProfile/> The profile attributes can be adjusted for each of the new supported codecs, namely, x= G7221C, 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 276 Administrator’s Guide Addendum for the SoundStation IP 7000 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_7000 voice.gain.rx.analog.ringer.IP_7000 voice.gain.rx.digital.chassis.IP_7000 voice.gain.rx.digital.ringer.IP_7000...
  • Page 277 Administrator’s Guide Addendum for the SoundStation IP 7000 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.hf.IP_7000.preFilter.enable voice.txEq.hf.IP_7000.postFilter.enable Call Handling Configuration <call/> These new configuration attributes are defined as follows:...
  • Page 278 Administrator’s Guide Addendum for the SoundStation IP 7000 Permitted Attribute Values Default Interpretation call.cellPhoneAutoBridging Disabled, Disabled If set to Enabled, the cell phone audio is Enabled automatically bridged to active SIP call (conference call). If one SIP call is put on hold and another SIP call is activated the cell phone audio is automatically bridged to the newly active SIP call.
  • Page 279 Administrator’s Guide Addendum for the SoundStation IP 7000 • Restoring Factory Defaults—Press and hold 1, 3, 5, and 7 dial pad keys simultaneously during the countdown process in the bootROM until the password prompt appears. Enter the administrator password to initiate the reset.
  • Page 280 Administrator’s Guide Addendum for the SoundStation IP 7000 1 - 14...
  • Page 281 SIP 3.0 Administrator’s Guide specific to the release of the SoundStation IP 6000 conference phone. The SoundPoint IP 6000 conference phone is a next-generation phone with a modern industrial design and the latest advancements in Polycom voice technology. Some of the features include: •...
  • Page 282 Administrator’s Guide Addendum for the SoundStation IP 6000 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 6000 conference phone called 3111-15600-001.sip.ld . Configurable Feature Keys No feature keys on the SoundStation IP 6000 can be remapped.
  • Page 283 Administrator’s Guide Addendum for the SoundStation IP 6000 Note The network bandwidth necessary to send the encoded voice is typically 5-10% higher than the encoded bit rate due to packetization overhead. For example, a G.722.1C call at 48kbps consumes 5xkbps of network bandwidth (one-way audio). Two-way audio would take over 100kbps.
  • Page 284 Administrator’s Guide Addendum for the SoundStation IP 6000 Voice Coding Algorithms <codecs/> The codecs include: • Codec Preferences <codecPref/> Codec Preferences <codecPref/> Permitted Attribute Values Default Interpretation voice.codecPref.IP_6000.G711Mu Null, 1-13 Specifies the codec preferences for the SoundStation IP 6000 platform. voice.codecPref.IP_6000.G711A Interpretation as above.
  • Page 285 Administrator’s Guide Addendum for the SoundStation IP 6000 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_6000 voice.gain.rx.analog.ringer.IP_6000 voice.gain.rx.digital.chassis.IP_6000 voice.gain.rx.digital.ringer.IP_6000...
  • Page 286 Administrator’s Guide Addendum for the SoundStation IP 6000 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.hf.IP_6000.preFilter.enable voice.txEq.hf.IP_6000.postFilter.enable Feature <feature/> The “call list” feature cannot be disabled on the SoundStation IP 6000 phone.
  • Page 287 Administrator’s Guide Addendum for the SoundStation IP 6000 Key ID Function Key ID Function Key ID Function Key ID Function Handsfree MicMute Menu ArrowUp SoftKey1 Dialpad4 SoftKey2 Dialpad5 DialpadStar Dialpad6 Dialpad0 VolDown DialpadPound ArrowDown Redial 1 - 7...
  • Page 288 Administrator’s Guide Addendum for the SoundStation IP 6000 1 - 8...

Table of Contents