LifeSize® Video Communications

I n n o v a t i o n
N e t w o r k A p p
N o t e
TPP -10225
Date: July 9, 2012
Product: ShoreTel |LifeSize Communications
System version: ShoreTel 13
LifeSize® Video Communications
This application note provides the details for integrating a LifeSize video communications system with the
ShoreTel IP phone system. This application note requires the use of ShoreTel 13, which supports the integration of
LifeSize components as SIP extensions.
Table of Contents
Overview ..................................................2
LifeSize Contact ..........................................2
Architecture Overview ..................................2
Requirements, Certification and Limitations .......3
Caveats..................................................... 3
Multipoint Video .........................................5
Configuration Overview.................................6
ShoreTel Configuration .................................7
Creating a SIP Profile .................................... 8
Creating a Codec List .................................... 9
Configuring the Switch Port ............................. 9
Configuring the Site .....................................10
Creating a SIP Individual User Extension .............11
LifeSize Video Communications Configuration ... 15
Setting up SIP port ...................................... 15
Setting up Audio ......................................... 16
Registering with the SIP Server........................ 20
Verifying Registration ................................... 21
LifeSize Troubleshooting ............................. 24
LifeSize Communications Technical Support ..... 24
Partner Escalation Services ............................ 24
Document and Software Copyrights................ 25
Trademarks ............................................. 25
Disclaimer ............................................... 25
Company Information ................................. 25
ShoreTel tests and validates the interoperability of the Member's solution with ShoreTel's published software
interfaces. ShoreTel does not test, nor vouch for the Member's development and/or quality assurance
process, nor the overall feature functionality of the Member's solution(s). ShoreTel does not test the
Member's solution under load or assess the scalability of the Member's solution. It is the responsibility of the
Member to ensure their solution is current with ShoreTel's published interfaces.
The ShoreTel Technical Support organization will provide Customers with support of ShoreTel's published
software interfaces. This does not imply any support for the Member's solution directly. Customers or reseller
partners will need to work directly with the Member to obtain support for their solution.
Overview
This document provides detailed instructions to configure the LifeSize video components (video codecs, cameras,
and audio I/O devices) with the ShoreTel System, to use extension dialing and video interoperability. Video
interoperability is a new feature introduced in ShoreTel 13 whereby a Communicator user can call from/to a
Lifesize room system and establish a video session.
Please note that ShoreTel has verified interoperability with a single Lifesize model, the LifeSize Room and
software version for ShoreTel 13.
For the purposes of this application note, a LifeSize video communications system consists of the following
components:



LifeSize codec
LifeSize camera
Audio I/O device, such as LifeSize Phone, LifeSize MicPod
LifeSize cameras and audio devices are connected to the LifeSize codec. All communication between the ShoreTel
system and the LifeSize system occurs through the LifeSize codec. All configurations of LifeSize system
components occur on the LifeSize codec.
LifeSize Contact
US Headquarters
LifeSize Communications
901 S. Mopac Building 3 Suite 300
Austin, Texas 78746
Phone: +1 512.347.9300 or 1.877.LIFESIZE
Fax: +1 512.347.9301
Sales and Technical sales support contact:
Joe Dorsey
National Accounts Manager
LifeSize Communications, Inc.
(512) 633-0322
[email protected]
www.lifesize.com
Architecture Overview
With ShoreTel 13, ShoreTel Communicator for Windows video-calls to and from LifeSize. By calling into a
Lifesize device with an embedded MCU, it can also participate in a multi-party video session.
Media path is peer-to-peer both video and audio.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
-2-
Requirements, Certification and Limitations
The following requirements apply to this application note:




Any LifeSize Room system with Firmware version v4.7.19.
ShoreTel 13
ShoreTel SIP phone license (one per Lifesize unit)
ShoreTel Standard video license (VGA, 640 x 480)
Please note that the high resolution license is not supported with third party video system. For information on
future HD video plan please contact your Area Sales Manager
A call between Communicator and Lifesize can use up to 600 kpbs. The bandwidth used will vary with the
level of image activity.
Caveats


ShoreTel systems do not pass along the Remote Mute Status of the LifeSize video communications
system.
Video (both desktop video and LifeSize video) requires that the user have an IP Phone MAC address as
primary port
o Video will fail if the SoftSwitch (i.e. a ShoreTel server, or "unassigned") is selected as your
primary port
o Video will work if your primary port is an IP Phone MAC address, even if you are externally
assigned to a PSTN number or the SoftPhone
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
-3-
Figure 1- Non supported configuration


You cannot dial into a room system by entering an IP address into Communicator. You simply need to dial
into the Lifesize extension.
The video Accept feature in Communicator presents caveat with Lifesize. If the user setting in the video
option is set as “Ask Me: accept video from others” and you receive a call from Lifesize, the call will be
established with audio first. When the Communicator’s user presses the “Accept” button in the call cell,
the user will be able to see the video from LifeSize but Communicator’s video stream is not displayed on
the LifeSize unit. This is a LifeSize defect. Please contact your Lifesize representative for further details.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
-4-
Figure 2- Ask Me Setting
Multipoint Video
Communicator supports a multipoint call hosted on the Lifesize unit if the latter offers an embedded MCU.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
-5-
Figure 3- Multipoint sample
When connected to a LifeSizeembedded MCU, the LifeSize system can change views and change display parameters
for their TV-based view. But Communicator will alwaysbe given a "grid" display of all participants and cannot adjust
or change that view
TIP: If the LifeSize MCU is set to "auto-answer" then multiple ShoreTel Communicator users could create an ad-hoc
multi-party video conference without any assistance from the LifeSize room system.
Configuration Overview
The following general steps are required to integrate a LifeSize video communications system with the ShoreTel IP
phone system:
1. Using Director, configure the ShoreTel system as described in the next sections.
2. Using your web browser, register the LifeSize video communications system with the ShoreTel SIP server.
Notes for Users Upgrading from a Previous ShoreTel Version
If you upgraded from a previous ShoreTel version, a certain parameter may be visible in the Call Control options.
You must disable this parameter in order to properly configure the SIP extension. To check for this parameter,
follow these steps:
1. Using Director, navigate to Administration>>Call Control>>Options.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
-6-
The Call/Control Options screen appears.
2. If the Always Use Port 5004 for RTP parameter is visible, disable the parameter.
3. Click Save to apply the change.
4. Restart the ShoreTel system in this order: restart all servers, then all switches, and then all IP phones.
ShoreTel Configuration
This section describes how to:





Create a SIP Profile for the LifeSize video communications system.
Create a Codec List for the LifeSize video communications system.
Configure a Switch port to act as a SIP proxy.
Configure the Site to use high-bandwidth codecs.
Create a SIP Individual User extension for the LifeSize video communications system.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
-7-
Creating a SIP Profile
1. Using Director, navigate to Administration>>Call Control>>SIP Profiles.
The SIP Profiles screen appears.
2. Click New to create a new SIP profile.
3. Provide input for the following parameters:
Name—Enter an appropriate name, such as LifeSize.
User Agent—Enter the following:
^LifeSize.*
Priority—Set this to 100.
Enable—Check this box.
Custom Parameters—Enter the following:
1CodecAnswer=0
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
-8-
Creating a Codec List
1. Using ShoreWare Director, navigate to Administration>>Call Control>>Codec Lists.
The Codec Lists screen appears.
2. Click New to create a new codec list.
3. Provide input for the following parameters:
Name—Enter an appropriate name, such as LS_codecs. You will use this name later when you configure the
ShoreTel site.
Codec List Members—Select the AAC_LC/32000 codec and click Move Up until the codec is at the
top of the list.
4. Click New to create the new codec list.
Configuring the Switch Port
1. Using Director, navigate to Administration>>Switches.
The Switches screen appears.
2. Select the switch you want to use to connect to the LifeSize video communications system.
The Edit Switch screen appears.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
-9-
3. Find the port you want to use and set the Port Type to 100 SIP Proxy.
If your installation requires more than 100 SIP extensions, configure more ports as necessary. For example,
two ports each set to 100 SIP Proxy provides 200 SIP extensions.
Alternatively, if the switch you selected has Built-in Capacity for SIP trunks, you can set aside a number of
ports for SIP extensions. Every 5 ports assigned to SIP trunks provides 100 SIP extensions. For example, a
single ShoreGear 120 switch with all ports assigned to SIP trunks can provide 2400 SIP extensions.
4. Click Save to apply the change.
Configuring the Site
1. Using Director, navigate to Administration>>Sites.
The Sites screen appears.
2. Select the site you want to configure.
The Edit Site screen appears.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 10 -
3. In the SIP Proxy area, ensure that the following parameters are set:
Virtual IP Address—Designate the static IP address that can be used as a SIP proxy for the site in case of
failure. If you do not set a Virtual IP Address, you can define only one proxy switch.
Proxy Switch 1—Select a switch to serve as SIP proxy if the current site fails. Switches are available for
selection only if proxy resources are enabled on the switch.
Proxy Switch 2—Select a switch to serve as SIP proxy if the Proxy Switch 1 fails.
4. In the Bandwidth area, ensure that the following parameters are set:
Admission Control Bandwidth—Defines the bandwidth to and from the site. This parameter is important
because SIP devices may be counted against the site bandwidth. For more information, refer to the ShoreTel
Planning and Installation Guide. Note that ACB does not apply to video.
Intra-Site Calls—Enter the codec list name you defined in the Creating a Codec List section.
5. Click Save to apply the changes.
Creating a SIP Individual User Extension
Follow these steps to create a user extension for the LifeSize video communications system:
1. Using ShoreWare Director, navigate to Administration>>Users…>>Individual Users.
The Individual Users screen appears.
2. In the Add new user at site field, select the site you want to use and click Go.
The Edit User screen appears.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 11 -
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 12 -
3. Provide input for the following parameters:
First Name—Provide an appropriate name, such as LifeSize_Conference_Room. You will use this name later
when you register the LifeSize video communications system with the ShoreTel SIP server.
Number—Director automatically assigns a number, which you can modify to any appropriate extension. You
will use this number later when you register the LifeSize video communications system with the ShoreTel SIP
server.
License Type—Select the type of license.
User Group—Select an appropriate user group.
Home Port—Select IP Phones and Any IP Phone.
4. Click Save to save these changes, then scroll down to the SIP Password section of the screen.
By default, there is no password assigned, but the field is masked to give the appearance of a password.
5. Enter a SIP Password. You will use this password later when you register the LifeSize video
communications system with the ShoreTel SIP server.
6. Click Save to save the password.
Note for Users Installing the LifeSize Video Communications System at a Remote Site
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 13 -
If you are installing the LifeSize video communications system at a remote site, you must perform the following
additional steps:
1. Using ShoreWare Director, navigate to Administration>>IP Phones…>>IP Address Phone Map.
The IP Address Phone Map screen appears.
2. Click New… and create an entry for the desired remote site, using the IP address of the LifeSize codec.
3. Click Save to apply your changes.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 14 -
LifeSize Video Communications Configuration
This section describes the steps necessary to register the LifeSize video communications system with the ShoreTel
SIP server. For general information about installing and configuring the LifeSize video communications system,
refer to the LifeSize system documentation available on the LifeSize product CD or from the Support page of
www.lifesize.com.
Setting up SIP port
One of the important settings is the “Communication->SIP” page, make sure the “TCP Signaling is enabled” and same
port “5060” is used TCP Signaling port
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 15 -
Setting up Audio
1. Make sure the “Symmetric RTP” is disabled
To disable “Symmetric RTP” on LifeSize side, go to
http://<IP_Address_of_LifeSize>/support
It will prompt for Username and password. By default:
Username: cli
Password: lifesize
From the page displayed go to “Advanced Comm Settings” click on “Go To”
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 16 -
In the Advanced Comm Setting, make sure the “Symmetric RTP is disabled”
2. The “Video Call Audio Output” and “Voice Call Audio Output” fields on the “Preference ->
Audio” Page should be set on “Phone”
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 17 -
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 18 -
Setting up video
Video Quality on the Preference->Video page
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 19 -
Video Control on the Preference->Video page
Registering with the SIP Server
1. Using your web browser, access the LifeSize codec and navigate to Preferences>>SIP>>Server.
The SIP Server screen appears.
2. Set the following parameters:
SIP Username—Enter the First Name you defined in the Creating a SIP Individual User Extension section.
Authorization Name—Enter the Extension you defined in the Creating a SIP Individual User Extension
section.
Authorization Password—Enter the SIP Password you defined in the Creating a SIP Individual User
Extension section.
SIP Proxy—Disable this parameter.
SIP Registrar—Enable this parameter.
Registrar Hostname—Enter the IP address of the ShoreTel switch with which the LifeSize codec will
register. This is either the Virtual IP Address you defined in the Configuring the Site section or the IP address
of the ShoreGear switch port that has 100 SIP Proxy enabled.
Registrar Port—Set this to 5060.
3. Click Save Changes to apply these changes.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 20 -
Verifying Registration
To verify that the LifeSize codec was registered, follow these steps:
1. In ShoreWare Director, navigate to Administration>>IP Phones>>Individual IP Phones.
2. Find the LifeSize codec in the list.
Note that the ShoreTel system automatically generates SIP phone names. The Name contains the prefix SIP and reflects
the current port assigned to the LifeSize codec. The Current User reflects the First Name you defined in the Creating
a SIP Individual User Extension section.
Troubleshooting Tips
Symptoms : « I see a black video in preview Window »
Areas of investigation:


Graphics card issue – update the graphics card drivers through device manager
User may be using generic windows drivers for their camera. In this case the generic windows drivers
need to be deleted from device manager and the correct drivers need to be installed.
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 21 -
Symptoms:



“I see a black video window”
“No video window is displayed”
“I get a connection lost error”
Areas of investigation:
.
1.
2.
3.
4.
5.
6.
Firewall : To determine if it is a firewall issue the firewall can be temporarily turned off for diagnostic
purposes
Video resolution adjuster
To disable adjuster go to:
HKEY_CURRENT_USER\Software\Shoreline Teleworks\ShoreWare Client\
DWORD VideoResolutionAdjusterEnabled = 0
Communicator clients are not running the same *major release* version
Make sure communicator/video is run in a supported environment. (ie. No virtualized windows 7 in a
MacBook Pro running VMWare Fusion…. Or communicator running in remote desktop/terminal server
environment)
Important: Make sure both clients can ping each other. If they can’t video won’t work
Diagnostic
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 22 -
Diagnostic and monitoring tools can be seen by clicking in the Quick Dialer area of Communicator and pressing
CTRL+F12
Defect reporting
When reporting an issue please provide:

Communicator client logs from *both* client end points (mandatory)

Wireshark Trace (mandatory if problem is with LifeSize) or switch traces with dbg “on sip” when
wireshark is not available

Lifesize Coroner Trace (if requested) located in the LifeSize diagnostics page

IP address of Communicator, IP address of LifeSize, IP address of the Voice Switch
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 23 -

Call GUID. This can be found by selecting the history recordCall DetailsSupport Info
LifeSize Troubleshooting
Please coordinate your trouble shooting efforts with LifeSize Technical Services and Shoretel technical support.
LifeSize Communications Technical Support
Partner Escalation Services
LifeSize partners can contact LifeSize in one of three ways to request LifeSize Technical Services. In order to
provide the quickest resolution to your customer’s issues, please provide the applicable product serial number.
Method 1 (preferred): Submit a problem case via the LifeSize Partner Portal under the Cases section. Partners
will receive an automated response from the LifeSize trouble ticketing system and will be contacted by a LifeSize
service representative by phone or email during the working business day.
http://eportal.lifesize.com:8080/PartnerPortal/login.do
Method 2: Email the contents of the problem report to LifeSize at [email protected]. Once you have
contacted LifeSize via email, a service representative will contact you by the next business day. Please provide the
product serial number and, if possible, the system coroner from the customer’s environment.
Method 3: Contact LifeSize Technical Services by phone, Monday through Friday, 8:00 a.m. to 5:00 p.m. within
each region via the LifeSize Technical Services hotline. Calls after hours are received by the central LifeSize
Services operation center:
AMERICAS (N/S America) 1-877-LIFESIZE
Direct Escalation (partners only) 1-512-623-4226
EUROPE (EMEA) (800-5433-7493)
Belgium 00-800-5433-7493
Finland 990-800-5433-7493
France 00-800-5433-7493
Germany 00-800-5433-7493
Italy 00-800-5433-7493
Netherlands 00-800-5433-7493
Norway 00-800-5433-7493
Spain 00-800-5433-7493
Sweden 00-800-5433-7493
Switzerland 00-800-5433-7493
United Kingdom 00-800-5433-7493
ASIA (APAC) (800-2573-6668)
China 00-800-2573-6668
Hong Kong 001-800-2573-6668
Japan 010-800-2573-6668
Singapore 001800-2573-6668
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 24 -
Document and Software Copyrights
Copyright ©2013 by ShoreTel, Inc., Sunnyvale, California, U.S.A. All rights reserved. Printed in the United States
of America. Contents of this publication may not be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without prior written authorization of ShoreTel Communications, Inc.
ShoreTel, Inc. reserves the right to make changes without notice to the specifications and materials contained herein
and shall not be responsible for any damage (including consequential) caused by reliance on the materials
presented, including, but not limited to typographical, arithmetic or listing errors.
Trademarks
The ShoreTel logo, ShoreTel, ShoreCare, ShoreGear, ShoreWare and ControlPoint are registered trademarks of
ShoreTel, Inc. in the United States and/or other countries. ShorePhone is a trademark of ShoreTel, Inc. in the
United States and/or other countries. All other copyrights and trademarks herein are the property of their respective
owners.
Disclaimer
ShoreTel tests and validates the interoperability of the Member's solution with ShoreTel's published software
interfaces. ShoreTel does not test, nor vouch for the Member's development and/or quality assurance process, nor
the overall feature functionality of the Member's solution(s). ShoreTel does not test the Member's solution under
load or assess the scalability of the Member's solution. It is the responsibility of the Member to ensure their solution
is current with ShoreTel's published interfaces.
The ShoreTel Technical Support organization will provide Customers with support of ShoreTel's published
software interfaces. This does not imply any support for the Member's solution directly. Customers or reseller
partners will need to work directly with the Member to obtain support for their solution.
Company Information
ShoreTel, Inc.
960 Stewart Drive
Sunnyvale, California 94085 USA
+1.408.331.3300
+1.408.331.3333 fax
960 Stewart Drive Sunnyvale, CA 94085 USA Phone +1.408.331.3300 +1.877.80SHORE Fax +1.408.331.3333 www.ShoreTel.com
- 25 -