Polycom SIP 2.2.0 manual Flash Parameter Configuration

Page 211

Configuration Files

Flash Parameter Configuration

Any field in the bootROM setup menu and the application SIP Configuration menu can be set through a configuration file.

A DHCP server can be configured to point the phones to a boot server that has the required configuration files. The new settings will be downloaded by the phones and used to configure them. This removes the need for manual interaction with phones to configure basic settings. This is especially useful for initial installation of multiple phones.

These device settings are detected when the application starts. If the new settings would normally cause a reboot if they were changed in the application Network Configuration menu, then they will cause a reboot when the application starts.

Caution The parameters for this feature should be put in separate configuration files to simplify maintenance. Do not add them to existing configuration files (such as sip.cfg). One new configuration file will be required for parameters that should apply to all phones, and individual configuration files will be required for phone-specific parameters such as SIP registration information.

The global device.set parameter must be enabled when the initial installation is done, and then it should be disabled. This prevents subsequent reboots by individual phones triggering a reset of parameters on the phone that may have been tweaked since the initial installation.

Caution This feature is very powerful and should be used with caution. For example, an incorrect setting could set the IP Address of multiple phones to the same value.

Note that some parameters may be ignored, for example if DHCP is enabled it will still override the value set with device.net.ipAddress.

Individual parameters are checked to see whether they are in range, however, the interaction between parameters is not checked. If a parameter is out of range, an error message will appear in the log file and parameter will not be used.

Incorrect configuration could cause phones to get into a reboot loop. For example, server 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.

A - 99

Image 211
Contents SIP Copyright Notice DisclaimerAbout This Guide Administrator’s Guide SoundPoint IP / SoundStation IP Contents Administrator’s Guide SoundPoint IP / SoundStation IP Troubleshooting Your SoundPoint IP / SoundStation IP Phones Viii Contents Administrator’s Guide SoundPoint IP / SoundStation IP IP 320/330 IP 600/601 SoundPoint IP Desktop PhonesSoundStation IP Conference Phone SoundPoint IP Desktop Phones Introducing the SoundPoint IP / SoundStation IP Family SoundPoint IP 600/601 SoundStation IP Conference PhoneCurrently supported conference phone is SoundStation IP Key Features of Your SoundPoint IP / SoundStation IP PhonesAdministrator’s Guide SoundPoint IP / SoundStation IP Overview SoundPoint IP / SoundStation IP Phones on Where SoundPoint IP / SoundStation IP Phones FitSession Initiation Protocol Application Architecture BootROMApplication Master Configuration Files Application Configuration Files ConfigurationApplication Configuration Files Resource Files Ring tones Synthesized tones Contact directories Available FeaturesOverview Microsoft Live Communications Server Overview IP Type-of-Service-Allows for the setting of TOS settings Configured in your network Setting up Your SystemDhcp or Manual TCP/IP Setup Setting Up the NetworkFor more information on Dhcp options, go to FTP Tftp Http Https Supported Provisioning ProtocolsCertificate Authority List on page C-1 Modifying the Network ConfigurationMain Menu Dhcp Menu Server Menu Ethernet Menu Syslog Menu Phone IP Address EM PowerName Possible Values Description Dhcp Client Dhcp MenuPossible Name Values Description Menu Name Possible Values Description MenuOr later. Passive FTP is still supported This will be ignored Password these characters if they are correctly escapedUsing the method specified in RFC Password, this will be ignoredCDP Ethernet menuTLS=3 Setting Up the Boot ServerThese permissions, but will not be able to upload files Information, contact your Certified Polycom ResellerCreate account and home directory Each phone may open multiple connections to the serverYou must decide on a boot server security policy Deploying Phones From the Boot ServerSIP/ on page A-10 Configuration on page A-4PhoneMACaddress.cfg Supporting SoundPoint IP and SoundStation IP Phones Upgrading SIP ApplicationSupporting SoundPoint IP 300 and 500 Phones To upgrade your SIP application Cfg file can be used for all phones in a deployment Configuring SoundPoint IP / SoundStation IP Phones Locally Setting Up Basic FeaturesThis chapter also provides instructions on Administrator’s Guide SoundPoint IP / SoundStation IP Call Log Call TimerCall Waiting Calling Party Identification Called Party IdentificationMissed Call Notification Customizable Audio Sound Effects Context Sensitive Volume ControlCentral boot server Connected Party IdentificationDistinctive Incoming Call Treatment Message Waiting IndicationMessages and voice messages are waiting Xml Local Distinctive RingingDistinctive Call Waiting Address-directoryDo Not Disturb Local Contact Directory Handset, Headset, and SpeakerphoneXml Boot server Address-directoryDirect Ory.xmlUTF-8’s variable length encoding LnSmith/ln FnBill/fn Ct1003/ct Sd3/sd Rt3/rt Ad0/adDirectory Element Permitted Values InterpretationAuto-reject Local Digit MapTime and Date Display Microphone MuteSoft Key Activated User Interface Speed DialIdle Display Animation IP330/, IP400/, IP500/, IP600/, IP4000/ on Ethernet SwitchCall Hold Automatic Off-Hook Call PlacementLocal / Centralized Conferencing Call TransferCall Forward Directed Call Pick-Up Last Call Return Setting Up Advanced FeaturesGroup Call Pick-Up Call Park/RetrieveConfigurable Feature Keys Multiple Line Keys per Registration Feature Key Layouts on page C-10Shared Call Appearances Multiple Call AppearancesBridged Line Appearance Busy Lamp Field Refer to Bridged Line Appearance Signaling on page B-10Attendant.uri Customizable Fonts and IndicatorsCentral boot Instant MessagingMultilingual User Interface SoundStation IP 4000’s higher resolution displaySynthesized Call Progress Tones Downloadable FontsMicrobrowser Real-Time Transport Protocol Ports Voice Mail Integration Network Address TranslationMultiple Registrations Server server/ on page A-7 Automatic Call Distribution Feature depends on support from a SIP serverDepends on support from a SIP server Server Redundancy For Outgoing Calls Invite Fallback Reg.1.server.1.address=voipserver.serviceprovider.com Phone ConfigurationPhone Operation for Registration PresenceMasking, the automatic behavior Microsoft Live Communications Server 2005 IntegrationConfiguration File Example Refer to Roaming Privacy roamingprivacy/ on page A-99 Refer to Roaming Buddies roamingbuddies/ on page A-99Set the reg.x.server.y.address to the LCS server name Set reg.x.auth.password to the LCS passwordLocate the roamingprivacy attribute Low-Delay Audio Packet Transmission Setting Up Audio FeaturesJitter Buffer and Packet Error Concealment Dtmf Tone Generation Voice Activity DetectionNegative audio consequences Dtmf Event RTP Payload Acoustic Echo CancellationFollowing table summarizes the phone’s audio codec support Audio CodecsEffective Automatic Gain Control IP Type-of-ServiceBackground Noise Suppression Comfort Noise FillIeee 802.1p/Q Setting Up Security FeaturesConfiguration changes can performed locally Local User and Administrator Privilege LevelsCustom Certificates Configuration File Encryption Incoming Signaling ValidationDevice.cfg Passwords Configuring SoundPoint IP / SoundStation IP Phones LocallyTroubleshooting Your SoundPoint IP / SoundStation IP Phones BootROM Error Messages Error MessagesApplication Error Messages Log Files Status MenuApplication Logging Options Scheduled Logging Following figure shows a portion of a boot log file Reading a Boot LogFollowing figure shows a portion of an application log file Reading an Application LogSymptom Problem Corrective Action Power and StartupControls Access to Screens and Systems Calling Phone on page C-9 DisplaysUpgrading AudioConfiguration Files Master Configuration Files One will cause a reboot loop CONFIGFILES=phone1MACADDRESS.cfg, sip.cfg MISCFILES= Application ConfigurationConfiguration Files This attribute includes This configuration attribute is defined as followsProtocol volpProt Microbrowser mb USB Port usbIf voIpProt.server.x.address is an IP If voIpProt.server.x.address is aVoIpProt.server.x.transport is set to If voIpProt.server.x.transport is set toVoIpProt.server.x.address is an IP VoIpProt.SIP.lcs To 1 default is Parameter if set to 1 when the parameterPermitted Attribute Values Default Interpretation Reg.x.auth.optimizedInFailover takes This attribute also includesOutbound Proxy outboundProxy May have a negative performance impact Due to the additional signaling requiredAlert Information alertInfo Request Validation requestValidationAttribute Permitted Default Interpretation Values Conference Setup conferenceSpecial Events specialEvent Dialplan.applyToCallListDial Dial Plan dialplanConsidered a dial from directory Digit Map digitmap Routing routing This attributes also includesServer server Emergency emergency Attribute Permitted Values Default InterpretationMultilingual ml Date and Time datetime Localization lclServer server Emergency emergencyLcl.ml.lang.menu.3 Attribute Permitted Values InterpretationLcl.ml.lang.menu.1 Lcl.ml.lang.menu.2Lcl.datetime.date.dateTop Lcl.datetime.date.longFormat+FF00 U+FFFF Permitted Attribute Values Interpretation User Preferences upOnIntensity value Tones tonesDual Tone Multi-Frequency Dtmf Chord-Sets chord OnIntensity, it will be replaced withDisabled Only be enabled when tone.dtmf.viaRtp isBe enabled when tone.dtmf.viaRtp is Ringer, or misc Sampled Audio for Sound Effects safTftp//host/pathnamefilename, for example Sound Effects seFollowing table, x is the sampled audio file number Wave file formatInstruction Meaning Example Patterns pat Ring type rtCall Progress Patterns Miscellaneous PatternsCall progress Use within phone Pattern number Ringer Patterns Ringer pattern number Default descriptionCall progress Pattern number Use within phone Miscellaneous Pattern number Use within phone Miscellaneous PatternsPatterns on page A-31 SequentialFollowing voice codecs are supported Voice Settings voiceCodec Preferences codecPref Codec Profiles audioProfile These codecs includeCodec Preferences codecPref Codec Profiles audioProfile Attribute Default Attribute Default Attribute Default Acoustic Echo Cancellation aec Acoustic Echo Suppression aes Background Noise Suppression ns Feature Attribute Default Transmit Equalization txEq Attribute Default Ethernet Ieee 802.1p/Q ethernet IP TOS IP Quality of Service QOSFollowing settings control the 802.1p/Q userpriority field If voice.vadEnable is set to 0, add attribute lineRTP rtp Call Control callControl These parameters apply to RTP packetsCall Control callControl Other otherRTP rtp Qos.ip.callControl… Basic TCP/IP TcpipAttribute Permitted Default Values Permitted Attribute Values Default Interpretation Stop.dayOfWeek If fixedDayEnable is set toStart.dayOfWeek Start.date is ignoredTcpIpApp.port.rtp.filterByIp Must be enabled for this to workWeb Server httpd RTP rtpConfiguration cfg Call Handling Configuration callCase the phone may select a different available Take precedence over this feature if enabled. ForMore information, refer to No Answer Reg.x.callsPerLineKey. Refer to RegistrationIf call.stickyAutoLineSeize is set to 1, this Shared Calls shared Hold, Local Reminder hold/localReminderWhereas pressing and holding down the line Directory dirIP 4000 phone. For other phones a quick press Release of the line key will resume a callReplaced by 2X the value Platform, this value is internallyFonts font Presence presSoundPoint IP 550, 600, 601, SoundPoint IP 320, 330, 430, 500IP330 font IP330 Keys key This configuration attribute is defined as followsFunctions Following table lists the functions that are availableFollowing indicators are used by the phone Indicators indBitmaps bitmap Platform IP300/, IP 330/, IP400 Attribute Permitted Interpretation Values Following table, x is the LED number LEDs ledLevel Interpretation Event Logging logTwo types of logging are supported Three formats are available for the event timestampType Example You do not change this value Log.render.level maps toBeen logged since the last upload Support append mode unlessServer is set up for this Uploaded if no new events haveSecurity sec Encryption encryption Password Lengths pwd/lengthLicense license InFreeSpace is internally Provisioning provYou do not change these PlatformValue Delay delayRAM Disk ramdisk Request requestFeature feature Finder finder Quotas quotas Resource resInternally replaced by 2X the value Microbrowser mbSuccessful, the value in the Http refresh Will be respected, even if this parameter is set toRefresh parameter will be respected only Event that a refresh fails. Once a refresh isDetrimental effect on performance of the phone Function is selectedBulk Drive bulkDrive Per-Phone ConfigurationThese settings control the bulk drive or memory stick USB Port usbRegistration reg A-7 Is non-Null, all of the reg.x.server.y.xxxParameters will override the parameters Specified in sip.cfg in Server server/ onRefer to Call Handling Configuration call IP 300 and 500 phones Calls call If reg.x.serverFeatureControl.cf is notDo Not Disturb donotdisturb If call.missedCallTracking.x.enabled is Parameter is enabled Forwarding is enabled, thisDiversion divert Divert.x.contact will be Calls can be automatically diverted when the phone is busyServer-base call forwarding is Enabled, this parameter isDialplan.x.digitmap is not Dialplan.x.applyToUserDial When present, and if Digit Map digitmap/ on Messaging msg Message Waiting Indicator mwi Network Address Translation nat Attendant attendant VoIpProt.local.signalPort in sip.cfgCommunications Server Roaming Buddies roamingbuddiesRoaming Privacy roamingprivacy Value 0 if the call server is Microsoft LiveFlash Parameter Configuration This flash attributes are defined as follows EnabledFor example, if device.net.ipAddress.set = Server address is preserved Refer to Basic Logging level/change/ Session Initiation Protocol SIP RFC and Internet Draft Support Following SIP request messages are supported Request SupportMethod Supported Following SIP request headers are supported Header SupportHeader Supported Header Supported Following SIP responses are supported Response SupportResponse Supported 3xx Responses Redirection 5xx Responses Server Failure Third Party Call Control Hold ImplementationReliability of Provisional Responses TransferBridged Line Appearance Signaling Shared Call Appearance SignalingTrusted Certificate Authority List Miscellaneous Administrative TasksAdministrator’s Guide SoundPoint IP / SoundStation IP Encrypting Configuration Files Changed at regular intervals to enhance security Boot server management easierIt can decrypt the files that were encrypted on the server. Chaining CBC mode. An example key would look like thisChanging the Key on the Phone Adding a Background LogoRGB Values Model Width Height Color DepthColor RGB Values Decimal Hexadecimal BootROM/SIP Application Dependencies Migration Dependencies Model BootROM SIP ApplicationMultiple Key Combinations SoundPoint IP Default Feature Key LayoutsSoundPoint IP SoundStation IP SoundPoint IP 550/600/601/650Key IP 550 330 601 Function IP 550 Key 330 601 Function Assigning a Vlan ID Using Dhcp VLAN-A=10 VLAN-A=0x0a VLAN-A=012 Parsing Vendor ID Information End of sub-options Administrator’s Guide SoundPoint IP / SoundStation IP Third Party Software Administrator’s Guide SoundPoint IP / SoundStation IP Zlib Copyright and Permission Notice Third Party Software Administrator’s Guide SoundPoint IP / SoundStation IP Index Secondary server 3-3DHCP Inform DhcpIP TOS A-48 Administrator’s Guide SoundPoint IP / SoundStation IP SIP Administrator’s Guide SoundPoint IP / SoundStation IP
Related manuals
Manual 36 pages 13.24 Kb