Академический Документы
Профессиональный Документы
Культура Документы
com
… and i thought i saw a 2
Polycom’s VVX family of phones is incredibly flexible, with a 23M Admin guide that spans 590 pages. I won’t say I’ve read
*every* page of that, but I’ve spent weeks trawling the config options so as to assemble my “ideal” config for a VVX
deployment operating as Lync peripherals.
Philosophy
My design philosophy for this config file was to make the phones as enterprise-grade as I could. I applied the mindset of a
major corporate: the phones needed to be simple, with unnecessary functionality removed or suppressed. I wanted them
to be secured, localised to the Australian environment, and to minimise the network traffic they would generate.
Setup
In this deployment I’ve condensed from my earlier three config files back to just two, with all of the config work now
contained in a file I’ve called “customisations.cfg”. (In some of my recent articles you’ll see a ‘”shared.cfg” file had the
Lync-specific values, which I’ve now moved to the top of “customisations.cfg”). When the phones boot and access the
provisioning server they first look for a file called “<MAC Address>.cfg”. If that’s not found, their Plan B is the master Search …
config file: “000000000000.cfg”. The master config file provides global settings (like the location and filename for
Pages
firmware, as well as the directories to place their own uploads) and also any other lower-level config files to look for. This
› About
master file then instructs the phone to download “customisations.cfg”, where it will find everything else it needs. At this
› Reviews policy
point it’s assumed that you have the usual pre-requisites set: the DHCPUtil additions (for PIN-based sign-in to Lync), and
› Privacy Policy
DHCP-based auto-discovery of the provisioning server. (I covered the latter here).
› Lync 2010 Resource Toolkit
› Lync 2013 Resource Toolkit
Master Config file › SfB 2015 Resource Toolkit
› SfB 2019 Resource Toolkit
The Master config file (000000000000.cfg) is pretty simple – note the “APP_FILE_PATH” is blank, because we’re using Lync
as our source of firmware. (To use the FTP server for firmware upgrades this would be populated with “sip.ld”. You may Categories
› AudioCodes
› Azure
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
still need to use this if your phones arrive running lower than UCS v5 firmware). › Clipsal C-Bus
› Electronics
› Enghouse
› Exchange 2007
› Exchange 2010
› Exchange 2013
› Hyper-V
› Lync Client 2010
› Lync Client 2013
› Lync Server 2010
› Lync Server 2013
› Nortel / Avaya CS1k PABX
› O365
› OCPE / LPE
› OCS
› PKI
› Polycom
› PowerShell
› PowerShell Scripts
› Product Review
BTW if you’ve seen my earlier post “polycom-vvx-firmware-v5-now-with-btoe”, you might have noticed that it refers to a
› Random
config file called “shared.cfg”. I’ve done away with that now and simply incorporated all of the relevant bits in
› Recipes
“Customisations.cfg”.
› SDK apps
› SfB 2015 – Client
Customisations.cfg › SfB Client 2016
It’s into my customisations.cfg file that I’ve placed the rest of my config. The whole file can be downloaded at the bottom › SfB Server 2015
of this page, but here’s a detailed look at what’s in there, with some explanations, suggestions and alternatives. The file › SfB Server 2019
itself is full of comment text to help you find your way around. › Sonus
› UC Gateways
› Uncategorized
Force Lync Mode
› Yealink
Here we’re forcing the base profile to be Lync, with device (firmware) updates to come from Lync, leaving only the › Zeacom
customisations to come from the FTP/provisioning server.
Archives
› 2018
<!-- Set the Base Profile to Lync mode, with firmware updates from Lync & user-popup enabled -->
› 2017
<device device.set="1" device.baseProfile.set="1" /> › 2016
› 2015
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
<device device.baseProfile="Lync" device.prov.lyncDeviceUpdateEnabled="1" device.prov.lyncDeviceUpdateEnabled.s › 2014
<lync lync.deviceUpdate.userInactivityTimeout="900" lync.deviceUpdate.popUpSK.enabled="1" lync.deviceUpdate.ser
› 2013
› 2012
› 2011
<!-- Disable access to the phone's website, & move it off port 80 -->
<httpd httpd.enabled="0" httpd.cfg.port="8080" />
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
The more advanced models in the range will permit the user to record calls. In many companies and parts of the world
this is viewed as A Bad Thing. Whilst it’s disabled by default, I think it’s nice to specify it in the config file just to be sure.
<!-- NTP & Daylight Saving : These values are applicable to NSW, ACT, SA, Broken Hill, VIC & TAS -->
<tcpIpApp>
<tcpIpApp.sntp>
<tcpIpApp.sntp.address tcpIpApp.sntp.address.overrideDHCP="0"></tcpIpApp.sntp.address>
<tcpIpApp.sntp.daylightSavings tcpIpApp.sntp.daylightSavings.enable="1" tcpIpApp.sntp.daylightSavings.fixedDayE
<tcpIpApp.sntp.daylightSavings.start tcpIpApp.sntp.daylightSavings.start.date="1" tcpIpApp.sntp.daylightSavings
<tcpIpApp.sntp.daylightSavings.start.dayOfWeek tcpIpApp.sntp.daylightSavings.start.dayOfWeek.lastInMonth="0"></
</tcpIpApp.sntp.daylightSavings.start>
<tcpIpApp.sntp.daylightSavings.stop tcpIpApp.sntp.daylightSavings.stop.date="1" tcpIpApp.sntp.daylightSavings.s
<tcpIpApp.sntp.daylightSavings.stop.dayOfWeek tcpIpApp.sntp.daylightSavings.stop.dayOfWeek.lastInMonth="0"></tc
</tcpIpApp.sntp.daylightSavings.stop>
</tcpIpApp.sntp.daylightSavings>
<tcpIpApp.sntp.gmtOffset tcpIpApp.sntp.gmtOffset.overrideDHCP="0" tcpIpApp.sntp.gmtOffset="36000" tcpIpApp.sntp
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
</tcpIpApp.sntp>
</tcpIpApp>
Power Saving
I was pleased to find that the phones have been designed with a clever power-saving feature: during “office” hours they’ll
operate to one set of parameters, and outside of those hours they’ll operate by another. The intent here is that they’ll stay
awake longer during the day and be quicker to drop to low power (with the screen off) at night. I fell out of love with this
feature when I found that outside of office hours, the phone broadcasts this mode to the user, which I felt was irrelevant,
and presented a very in-your-face reminder that they perhaps shouldn’t be at work… I couldn’t figure out how to suppress
the message, so I opted to force the phones into office hours 24×7.
With these settings, the phones will blank their display after 10 minutes, whilst the top-mounted red LED will flash every
3s to indicate it’s snoozing.
<!-- Power Saving : force "office hours" 24x7 & sleep after 10 minutes -->
<powerSaving powerSaving.enable="1" />
<powerSaving.officeHours powerSaving.officeHours.startHour.monday="0" powerSaving.officeHours.startHour.tuesday
<powersaving.officeHours.duration powerSaving.officeHours.duration.monday="24" powerSaving.officeHours.duration
<powerSaving.idleTimeout powerSaving.idleTimeout.officeHours="10" />
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
the bottom, and this extract is from it:
I experimented with a number of images here and found darker images with very little visual information in them worked
the best. Dark imagery won’t clash with the bright buttons or clash with the banners of information at the top and bottom
of the screen. (These captures are from the VVX410).
The left-hand sample image is of the radio mast that rises from the tourist town of Yulara, at Uluru (nee Ayers Rock) in the
centre of the Australian outback, whilst the “busier” one on the right is Sydney Harbour. You may want to set aside some
time to experiment with imagery that’s going to work well here. Or if in doubt, go vanilla and leave it out.
Don’t forget to add extra phone references to the above if you’re running more than the two models I am.
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
Updated 26th August 2018: Read more about on-screen real-estate in my post Optimising Polycom VVX background
images
Web-browser
If you click on the phone’s “Applications” button, it launches its internal browser and goes to a preconfigured website. As
convenient as it might be in some environments, I wanted to kill it, but it wasn’t so easy. Leave the URL unconfigured and
you see the left image below. Pointing it to the Front-End server’s “blank.html” presented the middle image, and so I
cobbled together the page that results in the image on the right:
(Leave mb.idleDisplay.home blank and only change the value for mb.main.home).
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
<!-- Set the "Messages" key to call Voicemail -->
<msg>
<msg msg.bypassInstantMessage="1" />
<msg.mwi.1 msg.mwi.1.callBackMode="contact" msg.mwi.1.callBack="sip:#UM-ContactAddress#@contoso.com;opaque=app
</msg>
Exchange (Calendar)
I opted to omit this functionality, partly due to the privacy concerns (especially if you’re not going with the Phone Locking,
described later below), but also due to the need to enter the user’s credentials in the phone.
Dial Plan
We don’t need to build a Dial Plan into the phone, as it’s going to abide by the one granted to the user in Lync. I have
however used this as an opportunity to override the default “911” settings. In the US, delete this section from the config
file, and in other countries, simply substitute your local emergency numbers.
<!-- Remove the default US E.911 values (obviously, *delete* this section for US locations!!) -->
<dialplan dialplan.1.e911dialmask="112;106" dialplan.1.e911dialstring="000" dialplan.routing.emergency.1.value=
<!-- Just dial any unknown number strings after 4s. Let Lync handle it... -->
<dialplan dialplan.impossibleMatchHandling="3" dialplan.impossibleMatchHandling.timeOut="4" />
A special mention here needs to go to Jonathan McKinney for finding a bug in the way the current 5.0.1 firmware handles
Lync’s normalisation rules. If you’re not already familiar with this, here’s his post.
Telephony Features
Add an audible reminder of a held call. Start after 30s on hold and remind every 30s.
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
Leave call.transferOnConferenceEnd=”1″. When established by the phone, a three-party conference call is created locally
(not via the Lync MCU). If the initiator of the conference leaves the calls, this setting transfers the other two parties
together so they can continue the conversation. By default the phone offers a “New Call” softkey on the very LH button. I
felt this was redundant, as pressing the line key does the same. Here I’ve removed it and replaced it with the more
practical Redial key. I found when I was testing announced transfers that Split didn’t work the way I expected. You could
“split” an announced transfer and toggle between both parties, but you could then never complete the transfer. I solved
that problem by removing the key! “call.BlindTransferSpecialInterop” is new in 5.1.0.15902 and addresses a few problems
getting Blind Transfers to work under Lync.
Miscellaneous Bits
ENABLE BTOE & SUPPRESS WARNINGS
<!-- Misc : a Warning Level of "1" suppresses the display of nuisance warnings (like the downstream PC is disco
<up up.warningLevel="1" up.oneTouchVoiceMail="1" />
(The values here for oneTouchVoiceMail and enhancedFeatureKeys are required for some of the other settings to work
correctly).
<!-- Volume persist settings: a "1" will retain the volume settings after each call -->
<voice voice.volume.persist.handset="1" voice.volume.persist.headset="1" voice.volume.persist.handsfree="1" />
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
(If you’re using Bluetooth or USB headsets there are some more related settings under “voice.volume.persist” in the
Admin guide).
<!-- "0" gives a 12-hour clock, "1" is 24. The admin guide has more clock & time/date display options -->
<lcl lcl.datetime.time.24HourClock="1" />
<!-- 1 = Label the Line key with the number, 0 = Show the name -->
<reg reg.1.useTelUriAsLineLabel="0" />
(The config file attached below has this value set at 0, so the name will show if you run it as-is).
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
<!-- Swap the preference for A/u-law. (*delete* this section for US locations!!) -->
<voice voice.codecPref.G711_A="6" voice.codecPref.G711_Mu="7" />
<!-- "0" disables the picture frame in the VVX500 and 1500 (otherwise on by default) -->
<feature feature.pictureFrame.enabled="0" />
Phone Lock
You may or may not want to have the phones auto-lock, or to give the user the ability to lock the phone. Here’s one point
where the Aries family is superior, as its lock will follow the state of the connected PC. Here, we’re not quite so lucky. I’ve
opted to give the user a Lock button, and the phone will only allow calls to up to five pre-configured numbers when it’s
locked. (I like that the phone automatically permits a call to Triple-0 without me needing to add that).
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
The downside of this is that the user needs to know their User-level password, and after they change and forget it, the
tightened security settings earlier are going to make it harder for the Admins to reset this (because we can no longer login
to the phone’s browser remotely). You’ll need to create a temporary copy of customisations.cfg as <MAC-Address>.cfg file
with <device device.auth.localUserPassword=”123″ device.auth.localUserPassword.set=”1” /> and then get the user to
reset the phone or force it by toggling PoE or sending a reset message to it. Needless to say, you might find this not worth
the pain, or you might instead choose to re-enable the phone’s web interface.
<!-- Give the user the ability to lock their phone. (Auto-lock is disabled here, but an option) -->
<phoneLock phoneLock.enabled="1" phoneLock.authorized.1.description="Taxi" phoneLock.authorized.1.value="+61123
<softkey softkey.2.enable="1" softkey.2.label="Lock" softkey.2.use.idle="1" softkey.2.action="$FLockPhone$" sof
QoS
Tweak these as required.
<!-- Tweak the QoS values & RTP media port as required -->
<qos qos.ethernet.callControl.user_priority="5" qos.ethernet.other.user_priority="2" qos.ethernet.rtp.user_prio
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
Debugging & Faultfinding
Every time you load a new config into a phone, you should check that the syntax is correct. Hit Settings / 4.Status /
1.Platform / 3.Config and the screen there will tell you if there are any errors in the various config files. In this example I
have 1 bad entry out of 162 – but it offers me no more clues. The only way I’ve been able to weed these out has been by
using a binary search: delete half the file, save, reboot, re-test. If the error’s gone, it was in the chunk you’ve deleted.
Reinstate the chunk, then delete half of it, and repeat.
My Wish-List
There were a few things I wanted to get the phones to do but couldn’t figure out how. It might be that someone else has
already been able to address this, or it might be something supported in a future firmware update.
When the phone is signed-out, move the sign-in soft-key to the main screen
Disable/remove the Applications key
Download
The config file now lives in my VVX Github Repo.
References / Credits
1. Polycom UC Software 5.8.0 Administrators’ Guide
2. Using Polycom® VVX® Business Media Phones with Microsoft® Lync™ Server 2013
3. Branding Your Polycom® Phone
4. Customizing the Display Background on Polycom® VVX® Business Media Phones
5. Suppressing soft-keys on the Applications page (pp 91-93)
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
6. Using Enhanced Feature Keys and Configurable Soft Keys on Polycom® Phones
7. How To Disable Default Softkeys And “Do Not Disturb” Feature
8. Optimising Polycom VVX background images
9. A VVX Courtesy Phone
Thanks to Polycom Australia for the loan of a VVX410 and some config guidance, and as always to Rocky for the glossies.
Change Log
26th August 2018: Updated doco links and redirected to the Github repo.
22nd May 2015: Referenced the consolidation of ‘shared.cfg’ into ‘customisations.cfg’ in Master Config file & updated the
admin guide link to the 5.3.0 version
7th Oct 2014: Updated admin guide link to the 5.2.0 version
18th September 2014: Updated Admin Guide link in References. Added Line Key Labelling (to post & config file)
21 May2014: Added “call.BlindTransferSpecialInterop” under Telephony Features.
– G.
18 Comments
Wayne Jackson
23rd January, 2015 at 12:33
Hi Greg
Great article has made my life a lot easier, however, I have one issue when I use your customisations file. When
using the Lync server to update the VVX firmware I no longer get the pop up “Device Update available. Press reboot
to Update” Under status -> Diagnostics -> Lync Device Update it shows that the new firmware is available.
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
I have seen the pop up when using no config file, any ideas?
Cheers Wayne
Laurent D
18th February, 2015 at 00:29
Hello,
We are using some Polycom VVX 500 in test under a Lync Hybrid architecture. Everything is working well but we
encounter one main issue. On the Phone, used for sure per OnPremise user, we don’t see the status of OnLine
users. Do you ever meet this case in your different tests?
Crodially
Nathan
13th April, 2015 at 13:50
Hi Greig,
Rrunning 5.2.2 firmware on vvx410 and the configuration settings for setting the admin password are not applying
the new password I am setting so we keep getting the red BANG! waring of a default password which it is, any
thoughts?
thanks
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
Greig Sheridan
13th April, 2015 at 22:53
hi Nathan,
Does the config file open without error if you open it with XML Notepad2007? (This confirms your syntax is valid
XML, but is no guarantee the phone will like the content).
I’d suggest upgrading to the new 5.3.0 release as a first step BTW – it has lots of new features and of course
plenty of bugfixes:
http://support.polycom.com/PolycomService/support/us/support/voice/polycom_uc/polycom_uc_software_release.html#5.3.0
– Greig.
Brad
25th April, 2015 at 04:37
Greig Sheridan
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
26th April, 2015 at 10:19
Thanks for the tip Brad, that’s great. I’ll add that in the next update.
Srthazha
18th November, 2015 at 04:23
Hi
Is there any method to stop vvx from signing in automatically after reboot?
Thanks
Markus
23rd January, 2016 at 01:31
Markus
23rd January, 2016 at 01:37
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
Any hints to disable softbuttons “callforwarding” (since V5.4.x) , because the use of that, will activate the default
Voicemail – and users without Voicemail (well no enterprise-users) will hang up the call in 20 seconds (4 times of
ringing).
In 5.3.1 it was still possible to deactivate it.
microsoft want`s to push you to buy enterprise-cals, but i would like to disable this feature in Polycom.
Also no UC-Enables/Voicemail-enabled user will get errors on Polycom VVX600 since 5.3.1.
Greig Sheridan
24th January, 2016 at 11:58
Hey Markus, I hadn’t noticed that – thanks for pointing it out. It looks like we’re stuck with the Forward key (at
least for the time being?). I notice the 5.4.1 doco still gives us the option, so I’m guessing this will be removed
or the functionality restored in a future update.
Viktor Steinmann
5th February, 2016 at 23:49
Great article. I’m pretty new in the SfB/VVX world (coming from Cisco CUCM) and this site managed to give me a
lot of useful information on how to setup the Polycom part.
I found, that adding the following header at the start of the customisations.cfg file helps a lot when using XML
Notepad, as the syntax is automatically checked by XML notepad:
This way, no config errors happen anymore and XML notepad even shows the supported values for the fields. Very
handy.
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
One thing, I’m trying to solve, for which I haven’t found a solution yet: Conference phones (e.g. SoundStation IP
5000) go to “Away” status automatically after a certain time. While this doesn’t prevent them from functioning
correctly, it’s not nice. If you can think of a hint on how to prevent this, while not disabling the auto-busy during
phone calls, that would be very cool.
Greig Sheridan
6th February, 2016 at 10:22
hi Viktor,
Thanks for the tip – I’m hoping to refresh this post soon and I’ll add that in.
As for the IP5000, I can’t think of an easy way to keep it Available (and yet hopefully powersave)? I tried my
trusty “Mouse Jiggler” in my CX500 and it didn’t make any difference but it might be worth a try in the 5000?
https://www.cru-inc.com/products/wiebetech/mouse_jiggler/
Viktor Steinmann
8th February, 2016 at 18:32
During the weekend I’ve gone through the complete documentation (those 500+ pages you mention) and
found a solution:
pres.idleTimeout.offHours.enabled=”0″
pres.idleTimeout.officeHours.enabled=”0″
in the overrides file of the IP5000 did the trick. The phone no longer shows the “away” status. You might
want to try that on that CX500 as well… ;-)
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
Reply to this comment
Greig Sheridan
10th February, 2016 at 08:44
powerSaving.enable.CX5500 = “0”
Viktor Steinmann
5th February, 2016 at 23:51
Ooops. My XML was eaten by the comment system in my last post. I replaced the XML-brackets by []-Brackets –
hope this helps…
Matt Ed
8th March, 2016 at 15:08
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
Great blog post here Greg. Thanks a lot. I stumbled across your blog while ramping up my VVX deployment skills. I
like what you’ve done here.
I really wish that Applications button could be removed! I was reviewing the Admin guide for UCS 5.4.0, maybe it
can be removed now? Looking at Page 350 of the guide.
Homescreen Parameters
homeScreen.application.enable 0 or 1 1
Enable or disable display of the Applications icon on the phone Home screen.
I am trying to get this to work in my configuration file but it appears to not be working. Maybe my formatting is
wrong?
Any thoughts?
Thanks
-Matt
Adarsh P S
10th May, 2016 at 15:09
Hi Greig,
Your blog helped me a lot for making VVX phones deployment through provisioning server.
However, I am looking for an option to disable the favourite contacts on the VVX 410 homescreen and changing the
911 emergency number to local emergency number through .cfg file.
I was not able to figure out which values needs to be add or change in .cfg files.
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
Thanks in advance.
Korbyn
10th October, 2016 at 08:33
Have you found a way to force the customization cfg file to be applied, regardless of settings that have been
already set on the phone?
Leave a Reply
Your email address will not be published. Required fields are marked *
Comment
Name *
Email *
Website
... and please just confirm for me that you're not a bot first:
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD
− 2 = two
Post Comment
This site uses Akismet to reduce spam. Learn how your comment data is processed.
« Front-End Stops When Upgrading from Lync Eval to Full Lync Server 2013 CU4 – January 2014 »
© 2018 greiginsydney.com
Powered by WordPress | Theme F2.
Create PDF in your applications with the Pdfcrowd HTML to PDF API PDFCROWD