Application Configuration Files | Polycom 1725-11530-200 Rev A1

Administrator’s Guide - SoundPoint® IP / SoundStation® IP			Installation and Operation

	CONTACTS_DIRECTOR	An alternative directory to use for user directory files if required. A
	Y	URl can also be specified. This is blank by default.

	OVERRIDES_DIRECTO	An alternative directory to use for configuration overrides files if
	RY	required. A URl can also be specified. This is blank by default.

Important

Be aware of the limited permanent storage on the phone(s).

Important

The order of the configuration files listed in CONFIG_FILES is significant.

•The files are processed in the order listed (left to right).

•The same parameters may be included in more than one file.

•The parameter found first in the list of files will be the one that is effective.

This provides a convenient means of overriding the behavior of one or more phones without changing the baseline configuration files for an entire system.

For more information, refer to the “Configuration File Management on SoundPoint® IP Phones” whitepaper at www.polycom.com/support/voip/.

2.2.2.1.1.2 Application Configuration Files

Typically, the files are arranged in the following manner although parameters may be moved around within the files and the file names themselves can be changed as needed.

Site-specific settings		Refer to the “Configuration File Management on
		SoundPoint® IP Phones” whitepaper at
		www.polycom.com/support/voip/ .
Per-phone settings		phoneXXXX.cfg
Application settings		sip.cfg

Category	Description		Example

Application	Contains parameters that affect the basic operation of the phone		sip.cfg
	such as voice codecs, gains, and tones and the 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.

Copyright © 2006 Polycom, Inc.

15

Image 23

Polycom 1725-11530-200 Rev A1 manual Application Configuration Files, Category Description Example

Contents

Administrator’s Guide SoundPoint/SoundStation IP SIP Polycom, Inc Table of Contents Call Management Features Optimization Configuration Files Session Initiation Protocol SIP 163 Viii Copyright 2006 Polycom, Inc Overview Copyright 2006 Polycom, Inc Installation Models Installation and Operation Installation Process Phones boot up in two phases Basic Network SetupDhcp or Manual TCP/IP Setup Sntp GMT offset Configuration File Local ParameterProvisioning File Transfer Subnet mask IP gateway 600 4000 Specified 300 301, 430Protocol Name Possible Values a Description Local User Interface Setup MenusMain Menu Name Possible Description Values Dhcp Menu Possible Name Values Description Name Possible Values Description Server Menu Ethernet Menu Reset to Factory Defaults Configuration Files Application ConfigurationCentralized Configuration Default Master Configuration File Master configuration files contain six XML attributes Category Description Example Application Configuration Files Setting Flash Parameters from Configuration Files Name Possible Values Description Name Possible Values Description Boot Server Deployment for the Phones Account-by-account basis Step Instructions Step Instructions Local Phone Configuration Management of File Encryption and Decryption Passwords Changing the Key on the Phone Copyright 2006 Polycom, Inc Page Phone maintains a call log. The log Basic FeaturesCall Timer Call Log Missed Call Notification Call WaitingCalled Party Identification Calling Party Identification Configurable Feature Keys SoundPoint IP 430 Key Layout SoundPoint IP 300 and 301 Key Layout SoundPoint IP 600 and 601 Key Layout SoundPoint IP 500 and 501 Key Layout Function SoundPoint IP 4000 Key Layout Key ID IP 300IP 500 IP 600 Key ID IP 300 Connected Party Identification Customizable Audio Sound Effects Context Sensitive Volume Control Distinctive Ringing Administration Distinctive Incoming Call TreatmentMessage Waiting Indication Distinctive Incoming Call Treatment Do-Not-Disturb Distinctive Call Waiting Handset, Headset, and Speakerphone Local Contact Directory Element Permitted Values Interpretation Local Contact Directory File FormatLocal Contact Directory File example Local Digit Map Multiple Line Keys per Registration Microphone Mute Multiple Call Appearances Shared Call Appearances Line-seize subscription for mutual exclusion feature Bridged Line Appearances Figuration files or the local phone user interface should be Busy Lamp Field Customizable Fonts and Indicators Speed Dial Soft Key-Driven User Interface Time and Date Display Set the time and date display formats Idle Display Animation Call Management FeaturesAutomatic Off-hook Call Placement Call Transfer Call Hold Three-Way Conference, Local or Centralized Directed Call Pick-up Call Diversion Call Forward Call Park / Retrieve Group Call Pick-up Last Call Return Audio Processing FeaturesLow-Delay Audio Packet Transmission Jitter Buffer and Packet Error Concealment Voice Activity Detection Dtmf Event RTP Payload Acoustic Echo Cancellation AECDtmf Tone Generation Algorithm Audio CodecsFollowing table summarizes the phone’s audio codec support Sample Effective Automatic Gain Control AGC Presence and Instant Messaging FeaturesBackground Noise Suppression BNS Comfort Noise Fill Multilingual User Interface Localization FeaturesInstant Messaging +FF00 U+FFFF Name Range Synthesized Call Progress Tones Downloadable Fonts Voice Mail Integration Advanced Server Features SoundPoint IP 500, 501, 600 and 601 instant mes Multiple Registrations Local Server Redundancy ACD login / logoutACD agent available / unavailable Microsoft Office Live Communications Server 2005 Integration DNS SIP Server Name Resolution Central Modify the phone1.cfg configuration file as follows Configuration File ChangesModify the sip.cfg configuration file as follows Optional Modify the sip.cfg configuration file as follows MicroBrowser Accessory Internet FeaturesSecurity Features Local User and Administrator Privilege Levels Custom Certificates Incoming Signaling Validation Configuration File Encryption Administrator’s Guide SoundPoint IP / SoundStation IP Real-Time Transport Protocol Ports Ethernet SwitchApplication Network Setup SoundPoint IP Switch Port Priorities Working with Network Address Translation Updating and Rebooting Event Logging Manual Reboot Menu Option or Key PressesCentralized Reboot Periodic Polling For Upgrades Log files uploaded in this manner are named Audio Quality Issues and VLANsIP TOS Ieee 802.1p/Q Rtcp Support SIP Configuration sip.cfg Configuration Files Permitted Attribute Values Protocol volpProtLocal local Server server Permitted Attribute Values TLS SIP SIP SDP SDP Attribute Values Attribute Values Invite Permitted Attribute Values Default Interpretation Request Validation requestValidation Attribute Default Interpretation Default Interpretation Ues Conference Setup conference Attribute Routing routing Attribute Permitted Values Default InterpretationDial Plan dialplan Digit Map digitmap Emergency emergency Localization localization Permitted Attribute Values Interpretation Multilingual multilingual Adding New Languages Date and Time datetime User Preferences userpreferences Dual Tone Multi-Frequency Dtmf Attribute Permitted Default Interpretation ValuesTones tones Chord Sets chordsets All three blocks use the same chord set specification format Attribute Permitted Interpretation Values Following sampled audio Wave file .wav formats are supported Attribute Permitted Values Interpretation Following table, x is the sampled audio file number Instruction Meaning Example Sound Effects soundeffectsPatterns patterns 104 Copyright 2006 Polycom, Inc Ringer Patterns Ringer pattern Number Default descriptionCall Progress Patterns Call progress Use within phone Pattern number Miscellaneous Use within phone Pattern number Miscellaneous Patterns Miscellaneous Pattern number Use within phone Ring type ringType Following voice codecs are supported Voice Settings voiceVoice Coding Algorithms codecs Codec Profiles profiles Default Interpretation Values Volume Persistence volume Gains gains Attribute Default 112 Copyright 2006 Polycom, Inc Acoustic Echo Cancellation AEC Acoustic Echo Suppression AES Automatic Gain Control AGC Background Noise Suppression NS Receive Equalization Rxeq Transmit Equalization Txeq Ethernet Ieee 802.1p/Q Ethernet Quality of Service QOSVoice Activity Detection VAD Other Other IP TOS IPCall Control CallControl 120 Copyright 2006 Polycom, Inc Time Synchronization Sntp Attribute Permitted Values DefaultBasic TCP/IP Tcpip Network Monitoring netMon 122 Copyright 2006 Polycom, Inc Copyright 2006 Polycom, Inc 123 1.10.3.1 1.10.3 Port port Web Server Httpd Call Handling Configuration callConfiguration cfg Shared Calls shared Hold, Local Reminder hold/localReminder Attribute Values Default Interpretation Directory directory Fonts font Presence presence Example of use 501 1.15.3 IP600 font IP600 1.15.1 IP400 font IP4001.15.2 IP500 font IP500 Following table lists the functions that are available Keys keys Bitmaps used by the phone are defined in this section Bitmaps bitmapsPlatform IP300/, IP400/, IP500/, IP600/ and IP4000 Indicators indicators Assignments Assignments Classes Classes Graphic Icons gi/ IP300/, IP400/, IP500/, IP600/ and IP4000 Following table, x is the LED numberLEDs led Level Interpretation Event Logging logging Type Example Basic Logging level/change/ and renderThree formats are available for the event timestamp Copyright 2006 Polycom, Inc 139 Scheduled Logging Parameters scheduled These settings affect security aspects of the phoneSecurity security Encryption encryption Password Lengths pwd/length RAM Disk RAMdisk Provisioning provisioning Request request Delay delay Feature feature Quotas quotas Resource resourceFinder finder Idle Display idleDisplay MicroBrowser microbrowser Browser Limits limits Main Browser main 148 Copyright 2006 Polycom, Inc Registration reg Per-phone Configuration phone1.cfg 150 Copyright 2006 Polycom, Inc Copyright 2006 Polycom, Inc 151 152 Copyright 2006 Polycom, Inc Do Not Disturb donotdisturb Automatic Off-hook Call Placement autoOffHookCalls call Diversion divert Missed Call Configuration serverMissedCall No Answer noanswer Calls can be automatically diverted when the phone is busyForward All fwd Busy busy Do Not Disturb dnd Copyright 2006 Polycom, Inc 157 158 Copyright 2006 Polycom, Inc Messaging msg Message Waiting Indicator mwi Network Address Translation nat Roaming Buddies roamingbuddies Attendant attendant Roaming Privacy roamingprivacy Title Basic ProtocolsRFC and Internet Draft Support Request Support Header Supported Header Support Copyright 2006 Polycom, Inc 165 Response Supported Response Support4.1 1xx Responses Provisional 4.2 2xx Responses Success 4.4 4xx Responses Request Failure 4.3 3xx Responses Redirection 4.5 5xx Responses Server Failure Third Party Call Control Hold ImplementationReliability of Provisional Responses Transfer Phone supports the following SIP protocol extensions Protocol Extensions Or their successors Shared Call Appearance Signaling Dialog for bridged line appearance subscribe and notify Bridged Line Appearance Signaling Trusted Certificate Authority List Appendix 174 Copyright 2006 Polycom, Inc RGB Values Color Decimal Miscellaneous Administrative TasksAdding a Background Logo Model Width Height Color Depth Configuration File Changes Third Party Software Attribution 178 Copyright 2006 Polycom, Inc Copyright 2006 Polycom, Inc 179 Copyright and Permission Notice Curl