loginclearpath

CiscoJabberVideoforTelePresenceAdministratorGuideVersion4.
3.
12.
13351D14410.
10December2011CiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page2of36ContentsIntroduction4Prerequisites5Infrastructurerequirements5NTLMauthenticationclientrequirements5PCrequirements6MacOSXrequirements6Multimediadevicerequirements6Microphone6Camera6Obtainingthesetupfiles7Upgrading7Newdeployment7ContentsoftheJabberVideoarchive7Providinghelp8Uploadingweb-basedhelp8Pre-configuringJabberVideo9Pre-configurablesettings9UsingDNSfortheserveraddresses11Installerpreconfiguration11CreatingacustomizedinstallerforWindows12CreatingacustomizedMacOSXinstaller12Provisioningtheclient14UploadingprovisioningtemplatestoCiscoTMS14Provisioningoptions14Distributingandinstallingthesetupfile21Newdeployment21Upgrading21UpgradingtoJabberVideo4.
321Windows22MacOSX22Defaultfilelocations22LaunchingJabberVideocallsfromotherapplications24Testingtheprotocolhandler24Usecases24Howcommunicationworks25SIPcommunication25Mediacommunication25Portranges25Duovideo–BinaryFloorControlProtocol(BFCP)26Mediarouting26MediaroutingwithoutICE26MediaroutingwithICE26CiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page3of36EnablingICE26ConfiguringJabberVideo'sTURNport27Runningtheclient28Signingin28SubscribingtotheCiscoVCS28RegisteringtotheCiscoVCS28CommunicatingwithCiscoVCS28Connectivitychecks28Bandwidthprobing29Presence29SIPkeepalive29Losingconnection30Searchingforacontact30Callsetup30Encryption30Sentandreceivedbandwidth30Resolution31Videoandaudiostandards32Far-endcameracontrolandICEnegotiation33Duringacall33Multiwayinitiation33Mutingmediastreams33Automaticbandwidthadaptation33AutomaticCPUadaptation33Conferenceinformation34Bibliography35IntroductionCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page4of36IntroductionThisguideprovidescomprehensiveinformationonCiscoJabberVideoforTelePresence,itscapabilitiesandfunctions.
JabberVideoworksinconjunctionwithotherCiscovideoconferencinginfrastructureproducts,primarilytheCiscoJabberVideoVideoCommunicationServer(CiscoVCS),theCiscoJabberVideoManagementSuite(CiscoTMS)andprovisioning.
Someknowledgeoftheseproductsisassumedinthisdocument.
TheReferencesandrelateddocumentssectioncontainsalistofdocumentsreferredtointhisguide.
CiscoJabberVideoforTelePresenceforWindowsisacertifiedWindows7application.
PrerequisitesCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page5of36PrerequisitesInfrastructurerequirementsJabberVideorequirestheProvisioningoptionontheCiscoVCSandinCiscoTMStobeenabled.
ProductVersionrequiredCiscoTelePresenceManagementSuite(CiscoTMS)12.
6orlaterCiscoVideoCommunicationServer(CiscoVCS)X5.
2orlaterX6.
0orlaterforICEsupportX6.
1orlaterforNTLMsupportNTLMauthenticationclientrequirementsJabberVideonowsupportsauthenticationwithActiveDirectoryandNTLM.
ForinstructionsondeployingNTLMauthenticationwithJabberVideoandCiscoVCS,refertoCiscoTelePresenceVideoCommunicationServerAuthenticatingDevicesDeploymentGuideNotethattouseNTLMauthenticationwithJabberVideoandCiscoVCS,NTLMv2mustbesupportedbytheclientcomputer.
Itisespeciallyimportanttobeawareofthisrequirementifthereareoldercomputersand/orWindowsXPusersinyournetwork.
Ontheclientcomputer:1.
GotoMyComputer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa2.
IftheLmCompatibilityLevelsetting(REG_DWORD)is1,setto2orhigher.
3.
Saveyourchanges.
CAUTION:Withasettingof1,authenticationwillfailfortheclient,andnowarningsorerrormessageswillbereceivedfromCiscoVCS,whichpassestherequestontotheActiveDirectoryserver.
PrerequisitesCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page6of36PCrequirementsOperatingsystemnWindowsXPSP2orlaternWindowsVistaSP1orlaternWindows7Processor2GHzIntelCore2Duoorequivalent.
MemorynWindowsXP:512MBRAMormore.
nWindows7orVista32-bit:1GBRAMormore.
nWindows7orVista64-bit:2GBRAMormore.
GraphicscardOpenGLversion1.
2orhigher.
SoundcardAnystandardsoundcard(full-duplex,16-bitorbetter).
Note:Oncomputerswithlimitedprocessingpowerand/ormemory,JabberVideowillusealotofsystemresources,andreducedperformancecanbeexpected.
MacOSXrequirementsProcessorAnyIntelprocessor.
Forbusiness-qualityHDvideo,CiscorecommendsusingtheCiscoPrecisionHDUSBcameraanda2GHzCore2Duoprocessororbetter.
OperatingsystemnMacOSX10.
7nMacOSX10.
6ConnectionIPnetworkconnection(broadband,LAN,wireless).
Atleast24kb/sisrequiredforanaudioconnection.
Foravideoconnection,therecommendedminimumis128kb/s.
MultimediadevicerequirementsMicrophoneAllmicrophonesworkwellwithJabberVideo.
Notethatsomecamerashavebuilt-inmicrophones.
CameraJabberVideoworkswithmostcommonwebcameras.
SeetheCiscoKnowledgeBaseforupdatedinformationonJabberVideoandcameras.
ObtainingthesetupfilesCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page7of36ObtainingthesetupfilesUpgradingWhenanewversionofJabberVideoisavailable,youwillgetaCiscoTMSticketif:1.
Automaticupdatecheckingisenabled.
Todothis:a.
InCiscoTMS,gotoAdministrativeTools>Configuration>NetworkSettings.
b.
UnderAutomaticSoftwareUpdate,setAutomaticallyCheckforUpdatestoYes.
2.
CiscoTMSAgentsareenabled.
Todothis:a.
InCiscoTMS,gotoAdministrativeTools>Configuration>GeneralSettings.
b.
SetEnableTMSAgentstoYes.
ThedescriptionfieldoftheCiscoTMSticketincludesalinktoa.
ziparchivecontainingthefilesdescribedbelow.
NewdeploymentIfinstallingCiscoJabberVideoforTelePresenceforthefirsttime:1.
GototheJabberVideosectionofcisco.
com.
2.
ClicktheDownloadSoftwarelink.
3.
Downloadthe.
ziparchivethatcontainsthelatestversionofJabberVideo.
ContentsoftheJabberVideoarchiveFilenameDescriptionJabberVideo.
msiFororganizationscreatingtheirownJabberVideoinstallerforWindowsJabberVideoSetup.
exeReady-madeinstallerforWindowscontainingthe.
msifileJabberVideoSetup.
dmgApplicationbundleforMacOSXJabberVideoProvisioningConfigTemplate.
xmlAddsJabberVideoprovisioningconfigurationstoCiscoTMS.
SeetheProvisioningtheclientsectionformoreinformation.
Jabber_Video_Release_Notes_.
pdfSoftwarereleasenotesdescribingthechangesfromthelasttothecurrentversionofCiscoJabberVideoforTelePresence.
Jabber_Video_Web_Help_.
zipZippedwebhelpfortheclientsthatcanbeuploadedlocallyandlinkedfromtheJabberVideomenu.
SeeProvidinghelpformoreinformation.
ProvidinghelpCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page8of36ProvidinghelpJabberVideohasHelpmenuentriesavailableonbothWindowsandMacOSX,beforeandaftersign-in.
Inadefaultinstallation,thesemenuentrieswilltaketheusertohttp://www.
cisco.
com/en/US/products/ps11328/products_user_guide_list.
html,whereuserguidesforbothWindowsandMacOSXcanbedownloadedasPDFdocuments.
Bypre-configuringorprovisioningJabberVideowithaHelpURL,youcandirectuserstoweb-basedhelpfilesoralocalsupportsiteinstead.
nBypre-configuringtheHelpURL,youcanhavedifferentURLsforMacandWindowsclients.
TheURLwillbeavailableatalltimes.
nAprovisionedHelpURLwillnotbeaccessiblefromthemenubeforetheuserhassignedin.
TheHelpURLpre-configurationandprovisioningsettingsmayalsobeusedtodirectuserstoanyinternalhelpandsupportsitethattheorganizationmayhaveforJabberVideo.
SeePre-configuringJabberVideoandProvisioningtheclientforguidanceonhowtoconfigurethesesettings.
Uploadingweb-basedhelpTheJabberVideodeliverablearchivecontainstwosetsofwebhelpfiles;onefortheWindowsclientandoneforMacOSX.
Tousetheincludedhelpfiles:1.
Unzipthearchive(s).
2.
Uploadthecontentstoanylocalserver.
3.
MakesuretoincludethefullpathtotheuploadedwebhelpfilesintheHelpURLwhenpre-configuringorprovisioning.
Includeboththeprotocol(HTTPorHTTPS)andthefileDefault.
htm.
Pre-configuringJabberVideoCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page9of36Pre-configuringJabberVideoThissectiondescribesrequiredandoptionalconfigurationsettingsforJabberVideoandmakesrecommendationsonhowtoconfigurethesesettingsaheadofdeployment.
Bydefault,thenetworkcommunicationsettingsareavailabletotheuserbyopeningSign-inSettingsfromJabberVideo'ssign-inwindow.
However,werecommendthatJabberVideobepre-configuredsothatthesesettingsarenoteditabletotheuser.
Theclientwillthenknowhowtolocateandauthenticatewiththeprovisioningserveronfirststartup,andtheuserdoesnothavetoworryaboutserversanddomains.
Pre-configurablesettingsTherearetwowaystodeploythebelowsettingsasanadministratorpriortodistributingtheclient:nPushingconfigurationsltotheWindowsregistrykeyHKEY_CURRENT_USER\Software\Cisco\JabberVideousing,forexample,ActiveDirectorygrouppolicies.
ltoaccountsinamanagedMacOSXenvironmentusingMCX.
nBypre-configuringinstallersforWindowsandMacOSX.
ValuenameDescriptionWindowsRegistrytypeWindowsinstallerPublicpropertyMacOSX.
plistelementDomainIdenticaltotheSIPdomainconfiguredontheCiscoVCS,inVCSconfiguration>Protocols>SIP>Domains.
REG_SZFORCEDDOMAINInternalVcsTheDNSaddressoftheprimaryCiscoVCSControlclusteryouwanttoconnectto.
JabberVideowillalwayslookforthisaddressfirstwhenconnecting.
Itisalsopossibletospecifywhichporttoconnectto.
ForexampleInternalVCS.
example.
com:5063.
REG_SZFORCEDINTERNALVCSExternalVcsTheDNSaddressoftheCiscoVCSExpresswayclusteryouwantJabberVideotoconnectto.
IfJabberVideofailstoconnecttotheInternalServer,itwilltrythisaddress.
Itisalsopossibletospecifywhichporttoconnectto.
ForexampleExternalVCS.
example.
com:5063.
REG_SZFORCEDEXTERNALVCSPre-configuringJabberVideoCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page10of36ValuenameDescriptionWindowsRegistrytypeWindowsinstallerPublicpropertyMacOSX.
plistelementHideAdvancedLoginSettingto1makestheabovenetworkcommunicationsettingsgrayedoutandinaccessibleforeditingbytheuser.
REG_DWORDFORCEDHIDEADVANCEDLOGINorEncryptionPolicyThetransportprotocolstotryandtoacceptforsignallingandmedia.
ThedefaultsettingisAuto.
SeeEncryptionformoredetail.
REG_SZFORCEDENCRYPTIONPOLICYVerifyTlsCertificateWhetherornottoverifytheprovisioningserver'scertificateagainstthesystemcertificatestore.
ThedefaultsettingisNo.
REG_DWORDFORCEDVERIFYTLSCERTIFICATEorTlsCommonNameTherequiredTLScertificatesubject.
ThismustbesetwhenprovisioningagainstaCiscoVCSusingHTTPS.
Ifnotset,theresolvedDNSnamewillbeexpectedinthecertificate.
NotethatthissettingreliesonVerifyTlsCertificatebeingenabled.
REG_SZFORCEDTLSCOMMONNAMEHelpUrlSpecifyafullURLtoasitecontainingwebhelporlocalsupportinformationthatJabberVideo'sHelpmenuentrieswilllinkto.
IfnoURLisprovided,themenuwilllinktotheuserguidesforWindowsandMaconcisco.
com.
SeeHelpURLformoreinformation.
REG_SZFORCEDHELPURLForgotPasswordUrlSpecifyafullURLtoapasswordretrievalsite.
REG_SZFORCEDFORGOTPASSWORDURLPre-configuringJabberVideoCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page11of36ValuenameDescriptionWindowsRegistrytypeWindowsinstallerPublicpropertyMacOSX.
plistelementUseWindowsUsernameWerecommendagainstusingthislegacysettingasitrequiresdisablingauthentication.
JabberVideosupportssecureNTLMauthenticationwithCiscoVCSversionX6.
1andlater.
FormoreinformationonhowtoconfigureJabberVideowithNTLM,seeCiscoTelePresenceVideoCommunicationServerAuthenticatingDevicesDeploymentGuideforyourversionofCiscoVCS.
Avalueof1hasthefollowingeffects:nJabberVideousesthecurrentWindowsuser'slogonnameasusername.
nTheUsernameandPasswordfieldsaredisabled.
nTheRemembermecheckboxintheloginwindowisselectedanddisabled.
REG_DWORDUSEWINDOWSUSERNAME—UsingDNSfortheserveraddressesJabberVideocanuseIPorDNSaddressestolocatetheCiscoVCSs.
UsingDNSaddressesoffersadvantagessuchas:nRedundancy:ifyouhavemorethanoneCiscoVCS,usingaDNSthattranslatestotheIPaddressofallCiscoVCSswillenableJabberVideoto"failover"tootherCiscoVCSsincaseofafaultinoneCiscoVCS.
nLocationawareness:forglobalcompanies,itispossibletoconfiguretheDNSserverssothatJabberVideowillbedirectedtothe"local"CiscoVCSwhereveritmaybe.
nFlexibility:usingDNSmakesitpossibletochangetheIPaddressofyourCiscoVCSlateron.
JabberVideoalsosupportsDNSSRVrecords,whichallowforevengreaterredundancyandflexibilitybecausetheycontaininformationsuchas"Priority"and"Weight".
InstallerpreconfigurationWheninstallersarepreconfigured,theseconfigurations:Pre-configuringJabberVideoCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page12of36ntakeprecedenceoveranyotherconfigurationfortheapplication.
napplytoallusersonthecomputer,notonlyfortheuserwhoinstalledtheapplication.
ncannotbechangedbyuserswithoutadministratorrightsontheircomputer.
nwillbereplacedorremovedduringupgrades.
Werecommendpreconfiguringallsettingswhencreatingtheinstallerstobecertainthatanyold/existingsettingsareoverridden.
CreatingacustomizedinstallerforWindowsTheJabberVideoSetup.
exefilesuppliedbyCiscoisabasicInstallShield-generatedinstallerthatcanberunwithstandardInstallShieldswitches.
Byusingtheformat/v"",JabberVideoSetup.
exewillbemadetorunMsiExec.
exetosettheseproperties.
Createaself-extractingexecutableusingthetoolofyourpreferencethatunpacksJabberVideoSetup.
exewithaminimalUIandthenautomaticallylaunchesitwithdesiredsettingsonthecommandline.
Theconfigurationsprovidedtotheinstallerwillbewrittentotheregistryofthehostcomputeroninstallation.
SyntaxJabberVideoSetup.
exe/v"==…"nBooleanvaluesarespecifiedby"0"or"1".
nPropertiesmustbeinuppercasefortechnicalreasons.
nInadditiontothestandardMsiExec.
exepublicproperties,theJabberVideoSetup.
exeinstallersupportsallpublicpropertiesdescribedinthePre-configurablesettingstable.
ExampleJabberVideoSetup.
exe/s/v"/qnDOMAIN=example.
comHIDEADVANCEDLOGIN=1"n/sisabasicInstallShieldswitchthathidestheinitializationdialog.
n/v""passesthepropertiestotheMsiExec.
exethatisactuallyperformingtheinstallation.
n/qnisabasicMsiExec.
exeswitch,aninstructiontoinstallsilently.
nDOMAIN=example.
comsetstheSIPDomainfieldinthePre-configurablesettingsoftheJabberVideoclienttoexample.
com.
nHIDEADVANCEDLOGIN=1hidestheserverconfigurationoptionsfromtheJabberVideoclient'sPre-configurablesettings.
CreatingacustomizedMacOSXinstaller1.
Specifythedesiredpreferencesasapropertylist(plist)file.
Xcodeisagoodeditorforthispurpose(seesamplefilebelow).
2.
Extractthefilecreate_custom_dmg.
tar.
gzfromtheJabberVideodeliverablearchive.
3.
Unpackthefile:tar–xzfcreate_custom_dmg.
tar.
gz.
4.
Changedirectory:cdcreate_custom_pkgPre-configuringJabberVideoCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page13of365.
Runthescriptcreate_custom.
dmg.
shwiththedesiredplistfileasparameter.
Example:.
/create_custom_dmg.
sh~/myconfig.
plist6.
ThecustomizedfileisnowwrittentothecurrentdirectoryasJabberVideo.
dmg.
Thesignatureoftheembeddedapplicationbundlewillstillbevalid.
Sample.
plistwithforcedsettingsHideAdvancedLoginInternalVcshttps://jabbervideotest.
example.
com/jabbervideo/provisioning/ExternalVcsDomainVerifyTlsCertificateProvisioningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page14of36ProvisioningtheclientNote:Beforeprovisioning,CiscoTMSandCiscoVCSmustbeconfiguredappropriately.
SeetheCiscoTelePresenceProvisioningDeploymentGuidefordetailedinformation.
ProvisioningisapowerfultoolfortheadministratortocontroltheJabberVideoclients.
UponsubscribingtotheCiscoVCS,theJabberVideoclientwillreceiveprovisioninginformationfromtheCiscoTMSAgentandactonit.
ToaccesstheCiscoTMSprovisioningconfigurations,gotoSystems>Provisioning>DirectoryandtheConfigurationspane.
UploadingprovisioningtemplatestoCiscoTMSEachversionofCiscoJabberVideoforTelePresencecomeswithaprovisioningtemplatethatmustbeuploadedtoCiscoTMS.
1.
GotoSystems>Provisioning>Directory.
2.
ClickthelinkManageConfigurationTemplates.
3.
Inthedialogboxthatopens,clickthebuttonUploadNew.
4.
LocatetheJabberVideoProvisioningConfigTemplate.
xmlfileonyourcomputer(seeObtainingthesetupfiles).
5.
ClickOpen,andthetemplatewillbeuploadedtoCiscoTMS.
Formoreonmanagingprovisioningtemplates,seeProvisioningDeploymentGuide.
ProvisioningoptionsThefollowingtabledetailstheprovisioningoptionsavailable,includingtipsonhowtheycanbeusedandinwhichsituations.
The"Default"columninthetabledescribeshowJabberVideobehavesifnospecificprovisioninginformationisconfiguredbytheadministrator.
Note:"Public"provisioningoptionsapplytoJabberVideoclientsconnectingfromoutsideoftheorganization'snetwork.
Unlessvaluesforthe"public"settingsareexplicitlyconfigured,theywillbeinheritedfromtheir"non-public"counterparts.
ProvisioningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page15of36FieldDefaultDescriptionBandwidthProberTime0Aftersigningin,JabberVideowillprobetheTURNrelayserverforbandwidthqualitybetweenclientandTURNserver.
Thissettingdeterminesthedurationoftheprobinginseconds.
nMinimumvalue:5nMaximumvalue:600nRecommendedvalue:30Theprovisionedtimeissplitinto256kb/sintervalsuptothemaximumprovisionedbandwidth.
BandwidthProberAutoSchedulingOffThissettingmustbeOntoenablebandwidthprobingasdescribedabove.
Notethatbandwidthprobingalsorequiresthefollowingsettingstobeprovisioned:nTurnAuthPasswordnTurnAuthUsernamenTurnServerClearPathOnClearPathisaCiscoTelePresencesolutionthatminimizesthenegativeeffectsofpacketlossinanon-optimalnetwork.
AmongthemechanismsusedareH.
264-specificerrorrecoverytechniques,feedbackfromdecodersandforwarderrorcorrection(FEC).
BothcallparticipantsmustsupportClearPathforittotakeeffect.
DefaultMediatypeCandidateHostTheaddresstousebeforeICEnegotiationhascompleted,ifICEfails,oriftheremotesidedoesnotunderstandICE.
Theavailableoptionsare:nHost-thelocalnetworkaddressnRflx-thecorporatepublicIPaddressseenfromtheoutsideoftheorganization'snetwork(publicIP)nRelay-theaddressoftheTURNrelayserverRelayistypicallyneededwhenJabberVideoisdeployedinenvironmentswheremostotherendpointsdonotunderstandICE.
SeeEnablingICEformoreinformation.
DetectMediaManglingOnDetectwhetheraserverinthenetworkistryingtorelaymedia.
EncryptionPolicyAutoDeterminestheencryptionpolicyfortheaccount.
ThisconfigurationaffectsboththeSIPcommunication(TransportTLSorTCP)andthemediacommunication(SRTPornoSRTP).
SeeEncryptionformoreinformation.
FarEndCameraControlOnThissettingletsJabberVideocontrolfarendcameras,whenallowedbythefarend.
HelpURLAfullHTTP(S)URLtoahelpand/orsupportsitethatwillbelinkedfromtheHelpmenuentriesinJabberVideo.
WebhelpfilesareprovidedintheJabberVideodeliverablearchive.
IfnoURLisprovisionedorpre-configured,themenuwilllinktotheuserguidesforWindowsandMacOSXoncisco.
com.
Seeformoreinformationonthisfeature.
ProvisioningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page16of36FieldDefaultDescriptionHttpLogURLAlogURLthatwillbepostedtoaftereverycallfromJabberVideo.
NotethattheURLmustbeawebpage/servicecapableofreceivingHTTPSPOST.
ThepostedXMLincludesinformationon:nTimestampnParticipatingSIPURIsnEncryptionnCalldurationnCalldirection(incoming/outgoing)nTURNservernSIPproxyICEOffInteractiveConnectivityEstablishment(ICE)dynamicallydiscoversthebestpossiblepathformediatotravelbetweencallparticipants.
SeeMediaroutingformoreinformationonwhatisrequiredtoenablethissetting.
InviterContactURIYoucanaddadisplaynameandSIPURIthatwillbeautomaticallyaddedtothefavoritesofallprovisionedusers.
Thestringmustbeontheformat"ContactPerson"IPversion4Availableoptions:nAuton4n6WARNING:DonotforceJabberVideotouseIPv6unlessallusersarepermanentlyonanIPv6network.
UserswhosigninoverIPv4,forexamplefromahomenetwork,willotherwiseberejected.
AlsonotethatICEisnotsupportedwithIPv6forJabberVideo.
WhenJabberVideosignsinoveranIPv6connection,ICEwillbedisabled.
MaximumInBandwidth512kb/s(adjustabletoupto2014kb/sfromwithintheclient)Determinesthemaximumbandwidththatcanbereceived/sentbytheaccount.
TheJabberVideoclientwillbesettosendtheprovisionedvalue.
Withnoprovisioning,thedefaultstartinglevelislowerthanthemaximumthatcanbesetbytheuser.
Highbandwidthisdirectlyrelatedtogoodvideoquality,butbandwidthcontrolcanbeusefultopreventaclientfromtryingtoreceive/sendbeyonditscapacity,asthismayresultinpacketloss,jitterandgenerallowvideoquality.
MaximumOutBandwidth384kb/s(adjustabletoupto2014kb/sfromwithintheclient)MediaPortRangeEnd21900Theupper/lowerboundoftheportnumbersthatthatareusedinthevideoandaudiocommunication.
Thesecanbeconfiguredtocontrolsecurity/firewallissues.
Arangeofminimum10portsmustbeprovisioned,orJabberVideowillreverttodefault.
MediaPortRangeStart21000ProvisioningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page17of36FieldDefaultDescriptionMNSModeOffEnablingthisoptionforcesrelayedmediatoberelayedviaprivateHDlinkswithguaranteedcapacitytoensurequalityofvideo.
ThissettingreliesonICEbeingenabled.
PrivatededicatedlinksareprovidedbycompaniessuchasMediaNetworkServices.
MultipleServerConnectionsOffEnablethisoptiontoallowJabberVideotokeepopenconnectionswithseveralserversinacluster,andfailoverbytransferringautomaticallytothenextserverintheclustershouldoneservergodown.
Shouldoneconnectionbelost,JabberVideowillalsobereachablefrommultipleservers.
NotethatthefeaturecanonlybeenabledifSIPOutbound(RFC5626)issupportedbythebackend.
ForCiscoVCS,thisrequiresversionX6.
0orlater.
MultiwayParticipantURIWhenMultiwayisinitiated,participantsaredirectedtothisUniformResourceIdentifier(URI).
SeeMultiwayinitiationformoreinformation.
OSXSoftwareURLURLlinkingtothesetupfileforthenewversionoftheJabberVideoclientforMacOSX.
Note:Uploadingfileswiththe.
dmgextensionisonlysupportedinCiscoTMSversion13.
1andlater.
IfusinganolderversionofCiscoTMS,theJabberVideoforMacinstallermusteitherbeaddedusingthefilesystemorhostedonadifferentserver.
ThecombinationofthisandtheOSXSoftwareVersionsettingallowstheadministratortoinformJabberVideousersthatanewversionisavailable,andprovideaclickablelinkfromwithintheclienttothesetupfile.
OSXSoftwareVersionIndicatestheversionnumberofthenewJabberVideoclientforMacOSX.
Thesettingshouldindicatetheversionthattheuserswillhaveoncetheyhaveupgraded,includingsoftwarebuildnumber.
Thecompleteversionnumberisincludedonthefrontpageofthereleasenotesforeachversion.
PhoneBookServerURIIfnovalueisset,theJabberVideoclientwillnotbeabletosearchforcontacts.
EnablestheaccounttosearchforotheraccountsintheCiscoTMSAgentdatabase.
ThisconfigurationshouldbeaURIontheform:phonebook@.
comPresenceServerURIIfnovalueisset,theJabberVideoclientwillnotbeabletopublishpresenceandwillappearoffline.
Enablestheaccounttosendpresencestatus.
ThisconfigurationshouldbeaURIontheform:presence@.
comProvisioningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page18of36FieldDefaultDescriptionPublicDefaultMediatypeCandidateUsesthevaluesetforDefaultMediatypeCandidate(changesdynamically).
TheaddresstousebeforeICEhascompleted,ifICEfailsoriftheremotesidedoesnotunderstandICE.
Theavailableoptionsare:nHost-thelocalnetworkaddressnRflx-thecorporatepublicIPaddressseenfromtheoutsideoftheorganization'snetwork(publicIP)nRelay-theaddressoftheTURNrelayserverRelayisrecommendedforJabberVideoclientsconnectingfromoutsideoftheorganization'snetwork.
ICEnegotiationcantakeafewsecondstocomplete,andusingtheTURNrelaywillhelpmediaflowthroughthefirewallsfromthebeginningofthecall.
OnceICEnegotiationhascompleted,mediawillberedirectedifasuperiormediapathhasbeenlocated.
SeeEnablingICEformoreinformation.
PublicIPversionUsesthevaluesetforIPVersion(changesdynamically).
Availableoptions:nAuton4n6WARNING:DonotforceJabberVideotouseIPv6unlessallusersarepermanentlyonanIPv6network.
UserswhosigninoverIPv4,forexamplefromahomenetwork,willotherwiseberejected.
AlsonotethatICEisnotsupportedwithIPv6forJabberVideo.
WhenJabberVideosignsinoveranIPv6connection,ICEwillbedisabled.
PublicMaximumInBandwidthUsesthevaluesetforMaximumInBandwidth(changesdynamically).
Determinesthemaximumbandwidththatcanbereceived/sentbytheaccountafterconnectingtotheexternalserver(CiscoVCS)configuredinJabberVideo'ssign-insettings.
Thesettingsmaybeusefulforcontrollingthebandwidthofusersthatconnectfromoutsideofthecompany'snetwork.
Theseusersmayhaveslownetworkconnections,orthecompanymaywanttolimittheirbandwidthusage.
PublicMaximumOutBandwidthUsesvaluesetforMaximumOutBandwidth(changesdynamically).
PublicMultipleServerConnectionsUsesthevaluesetforMultipleServerConnections(changesdynamically).
EnablethisoptiontoallowJabberVideotokeepopenconnectionswithseveralserversinacluster,andfailoverbytransferringautomaticallytothenextserverintheclustershouldoneservergodown.
Shouldoneconnectionbelost,JabberVideowillalsobereachablefrommultipleservers.
NotethatthefeaturecanonlybeenabledifSIPOutbound(RFC5626)issupportedbythebackend.
ForCiscoVCS,thisrequiresversionX6.
0orlater.
PublicPhoneBookServerURIUsesthevaluesetforPhoneBookServerURI(changesdynamically).
EnabletheaccounttosearchforotheraccountsintheCiscoTMSAgentdatabaseafterconnectingtotheexternalCiscoVCSconfiguredinJabberVideo'sSign-inSettings.
ItissufficienttosetthePhoneBookUriconfiguration.
ProvisioningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page19of36FieldDefaultDescriptionPublicPresenceServerURIUsesthevaluesetforPresenceServerURI(changesdynamically).
EnablestheaccounttosendpresencestatusafterconnectingtotheexternalCiscoVCSconfiguredinJabberVideo'sSign-inSettings.
ItissufficienttosetthePresenceBookUriconfiguration.
PublicSIPServerAddressUsesthevaluesetforSIPServerAddress(changesdynamically).
AddressoftheservertowhichtheusershouldsendaregisterrequestafterconnectingtotheexternalCiscoVCSconfiguredinJabberVideo'sSign-inSettings.
Generally,thisconfigurationshouldbethesameasExternalServerintheJabberVideoSign-inSettings.
ResolutionPreferencesHighRestrictsincomingandoutgoingvideoresolution.
WindowsusersmaymodifyJabberVideo'svideoresolutionwiththeprovisionedvalueasthemaximum.
TheMacOSXclientwillalwaysusetheprovisionedvalue.
Therestrictionsdependonmanyfactors,butasageneralrule:nHighwillallowthehighestresolutionpossibleuptowidescreenHD(1920x1080or1280x720).
nMediumwillrestrictresolutionstowideCIF(512x288)orlower.
nLowwillrestrictresolutionstowideQCIF(256x144)orlower.
SeeResolutionformoreonhowvideoresolutionisdeterminedbyJabberVideo.
SIPKeepAliveInterval24secondsTheintervalatwhichSIPKeepAlivemessagesaresent.
Formoreinformation,seeCommunicatingwithCiscoVCS.
SIPServerAddressTheSIPserver(CiscoVCS)thattheclientsubscribedto.
Addressoftheservertheusershouldsendaregisterrequestto.
ShouldbethesameastheInternalServerconfigurationintheJabberVideoSign-inSettings.
TcpMediaRelayOffAvailableoptions:nAuto.
JabberVideowilltrytodiscoverTURNrelayoverTCPorTLSifUDPfails.
nOff.
JabberVideowillnotlookforTCPorTLSoptions.
TurnAuthPasswordTURNserversettingsthatarerequiredforenablingICE.
SeeEnablingICEformoreinformation.
TurnAuthUsernameTurnServerWindowsSoftwareURLURLlinkingtothesetupfileforthenewversionoftheJabberVideoclientforWindows.
ThecombinationofthisandtheSoftwareVersionsettingallowstheadministratortoinformJabberVideousersthatanewversionisavailable,andprovideaclickablelinkfromwithintheclienttothesetupfile.
ProvisioningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page20of36FieldDefaultDescriptionWindowsSoftwareVersionIndicatestheversionnumberofthenewJabberVideoclientforWindows.
Thesettingshouldindicatetheversionthattheuserswillhaveoncetheyhaveupgraded,includingsoftwarebuildnumber.
Thecompleteversionnumberisincludedonthefrontpageofthereleasenotesforeachversion.
DistributingandinstallingthesetupfileCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page21of36DistributingandinstallingthesetupfileThissectiondescribestheprocessofdistributingandinstallingtheJabberVideoclient,whetherthisisthefirstinstallationofCiscoJabberVideoforTelePresenceoranupgradefromapreviousversion.
Note:InstallingJabberVideorequiresadministrativerightsonthecomputer.
NewdeploymentFornewdeployments,Ciscorecommendsthatyouuseyourowndeploymenttools.
Todistributetoendusers,youcansendacustomizedemailmessagefromTMS:1.
GotoSystems>Provisioning>Directory.
2.
IntheWorkspacepane,clickSendAccountInfo.
3.
Inthedialogthatopens,clickConfigureemailsettings.
4.
VerifythatSMTPhost,username,andpasswordhavebeenaddedcorrectly,oraddthemyourself.
5.
Chooseasuitablesubjectfortheemailnotification.
6.
Bydefault,thisemailmessagewillcontainlogincredentialsforJabberVideoandCiscoIPVideoPhoneE20.
IfyouwantuserstodownloadandinstallJabberVideothemselves,youcanaddthedownloadlinktothesamemessage.
UpgradingTheprocessofupgradingJabberVideoiscontrolledbytheITadministratorthroughfourprovisioningoptionsinCiscoTelePresenceManagementSuite:nWindowsSoftwareURLandOSXSoftwareURL.
nWindowsSoftwareVersion.
andOSXSoftwareVersionWerecommendthattheadministratorimmediatelytestandverifythattheprovisionedURLsworkandareavailabletoallprovisionedusersonthenetwork.
Whenthesetwooptionsarecorrectlyconfigured,userswillreceiveapromptwhentheysigninaskingthemwhethertheywanttoupgradeimmediately:nIftheuseraccepts,thenewinstallerwillbedownloadedandstartedautomatically.
Restartingthecomputerafterinstallationisnotnecessary.
nIftheuseraccepts,butthedownloadisnotavailable—forexamplebecausetheuserisconnectingfromoutsidethecompanynetwork,theuserwillbenotifiedofthefailureandthepromptwillreturnthenexttimetheusersignsin.
nIftheuserclicksAskLater,thepromptwillreturnthenexttimetheusersignsin.
Ifyouwanttomakeabsolutelysurethatallclientsareupgraded,youcaninsteadopttouseyourdeploymenttool(s)toforcetheupgrade.
UpgradingtoJabberVideo4.
3Duetochangesinproductnameandbrand,theJabberVideo4.
3installerswillmakesomechangestopreviousinstallations.
OnMacOSX,theusermustmanuallyremovetheoldapplicationafterinstallingandDistributingandinstallingthesetupfileCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page22of36launchingJabberVideo4.
3WindowsDuringinstallation:nJabberVideo4.
3installsitselftotheprogramfilepathsdescribedunderFilelocations.
nJabberVideoregistersitselfasthedefaultSIPprotocolhandler.
WhenJabberVideoislaunched:nIfupgradingfromversion4.
1orlater:Existingprofilefoldersandregistrysettingsarerenamedfrom~\Cisco\Movi\2.
0\~to~\Cisco\JabberVideo\~.
nIfupgradingfromversionolderthan4.
1:Existingprofilefoldersandregistrysettingsarerenamedfrom~\TANDBERG\Movi\2.
0\~to~\Cisco\JabberVideo\~.
MacOSXBesuretoinstallandstartupJabberVideobeforeremovingMovi,assettingsareimportedonfirststartup.
Wheninstalling:nJabberVideoinstallsitselfasanewapplicationalongsideCiscoTelePresenceMovi.
nJabberVideoregistersitselfasthedefaultSIPprotocolhandler.
nTheprogrambundleidentifierisnowcom.
cisco.
JabberVideo.
WhenJabberVideoislaunched:nPreferences,Favorites,andHistoryareimportedfromMovi.
nStoredpasswordsarenotimportedandmustbere-entered.
DefaultfilelocationsFilesWindowslocationMacOSXlocationProgramfilenWindowsVistaand7(64bit):%ProgramFiles(x86)%\Cisco\nWindowsVistaand7(32bit):%ProgramFiles%\Cisco\nWindowsXP:~\ProgramFiles\Cisco\/Applications/JabberVideoFavoritesandHistory%APPDATA%\Cisco\JabberVideo\~/Library/ApplicationSupport/JabberVideo/Logfilesfordebuggingpurposes\Cisco\JabberVideo\Logs\.
ThedirectoryishiddenbydefaultandcanbefoundatnWindowsXP:%USERPROFILE%\LocalSettings\ApplicationData\nWindowsVistaandWindows7:%LOCALAPPDATA%(typically%USERPROFILE%\AppData\)~/Library/Logs/JabberVideo/DistributingandinstallingthesetupfileCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page23of36OnaWindowscomputer,theFavoritesandHistoryareindividualtoeachuserloggingontoJabberVideo.
OnMacOSX,theFavoritesandHistoryarespecifictotheMacOSXuseraccount,regardlessofwhichJabberVideouserisloggedin.
LaunchingJabberVideocallsfromotherapplicationsCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page24of36LaunchingJabberVideocallsfromotherapplicationsJabberVideowillinstallitselfasthedefaultSIPprotocolhandlerontheoperatingsystem.
AslongasitremainsthedefaultSIPclient,activatinganySIPURIlinkwilllaunchacallfromJabberVideo.
Itisalsopossibletouse"movi:"astheprotocolratherthan"sip:".
ThiswillensurethatJabberVideoisalwaysusedevenifanotherSIPclientisthesystemdefault.
Testingtheprotocolhandler1.
HavethelatestversionofCiscoJabberVideoforTelePresenceinstalled2.
Openawebbrowser(orakeyboardlaunchapplicationsuchasQuicksilverorLaunchy).
3.
Intheinput(URL)field,typeaSIPURI,thenhitEnter.
JabberVideowillnowopenandlaunchacalltotheURIprovided.
Note:Adding"//"afterthe"movi:"and"sip:"protocolsisnotsupportedbytheJabberVideoprotocolhandler.
UsecasesnAddSIPURIstodefaultemployeeemailsignaturesandvcards.
nEmbedSIPURIlinksinintranetemployeeprofiles,helpdeskcontactpages,andsimilar.
nIntegratewithanyapplicationthatcansendaprotocolrequesttotheoperatingsystem.
HowcommunicationworksCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page25of36HowcommunicationworksThissectionincludesgeneralinformationonJabberVideo'smaintypesofcommunicationandisessentialforthesubsequentsection,whichdescribesspecificmessages.
SIPcommunicationJabberVideocommunicateswiththeCiscoVCSusingtheSessionInitiationProtocol(SIP).
Subscribing,registering,presencequerying,callinvites—allcommunicationexceptvideoandaudio,isdoneinSIP.
SIPmessagesaresentusingTCP,withorwithoutTLSencryptiondependingontheprovisionedsettings.
ThedefaultSIPlisteningportsusedontheCiscoVCSaren5060(unencrypted)n5061(encrypted)Thesearebothconfigurable.
GotoVCSConfigurations>Protocols>SIP>Configurationtochangethelisteningports.
Note:IfyouchangetheSIPlisteningportnumberontheCiscoVCS,youmustalsoconfiguretheJabberVideoclientstocontacttheCiscoVCSonthisport.
SeePre-configurablesettingsformoreinformation.
JabberVideoitselfwilluseephemeralTCPportsforthiscommunication.
TheseportsarehandedovertotheJabberVideoclientbytheTCPstackandarenotconfigurable.
ToenablecommunicationwithendpointsandotherdevicesthatrelyonH.
323anddonotsupportSIP,interworkingontheCiscoVCScanbeused.
MediacommunicationMediadataistransferredthroughuptonineUDPlinks(ports).
Thereareatmostfivemediastreams:nAudionPrimaryvideonSecondaryvideo(presentationsharing)nBFCP(managementofpresentationsharing/duovideo,seebelow)nFarendcameracontrol(FECC)WiththeexceptionofBFCP,eachofthesestreamsrequirestwolinks:onelinkforRTPpacketsandonelinkforRTCPpackets.
TheSRTPprotocolisusedifencryptionisenabled.
PortrangesThedefaultportrangeforJabberVideotoreceivemediais21,000-21,900.
ThisrangeisconfigurableinCiscoTMS:1.
GotoSystems>Provisioning>Directory.
2.
Add(orselect)theconfiguration'sMediaPortRangeStartandMediaPortRangeEnd.
Note:Aminimumrangeof10portsmustbeconfigured,orJabberVideowillreverttodefault.
HowcommunicationworksCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page26of36ThedefaultportrangeusedontheCiscoVCSis50,000-52,399.
Toconfigure:1.
GotoVCSConfiguration>Localzone>Traversalsubzone.
2.
SettheTraversalmediaportstartandTraversalmediaportend.
Notethatinbothcases,theportnumbersusedwillbeconsecutive,butchosenrandomlywithinthespecifiedrange.
Duovideo–BinaryFloorControlProtocol(BFCP)JabberVideosupportsBFCPforhandlingthecontrolofduovideo.
BFCPcommunicationcanbesentoveraUDPoraTCPlink.
JabberVideousesthesameportsasforaudioandvideoforthiscommunication.
OntheCiscoVCS,aportwillbechosenatrandomfromthesamerangethathasbeenassignedtothemedialinks.
MediaroutingCiscoJabberVideoforTelePresencesupportsInteractiveConnectivityEstablishment(ICE)forbettermediarouting.
ICEwillbeusedifenabledbothinJabberVideoandthefarend.
MediaroutingwithoutICEMedialinkscanbeestablisheddirectlybetweenthetwoendpointsinnon-traversalcalls,orbetweenJabberVideoandtheCiscoVCSintraversalcalls.
Asageneralrule,non-traversalcallsaredefinedascallsbetweentwoparticipantsthatareonthesamenetworkanddonotrequireinterworking.
NotethatSIPtoH.
323callsrequireinterworkingandarethereforetraversalcallsirrespectiveofwhethertheendpointsareonthesamenetwork.
Fordetailedinformation,seeCiscoVCSAdministratorGuideforyourversionofCiscoVCS.
MediaroutingwithICEICEdynamicallydiscoversthebestpossiblepathformediatotravelbetweencallparticipants.
ItispossibletofurtherimprovetheroutingofmediaandforceitthroughdedicatedlinksbyusingtheEnableMNSModeProvisioningconfiguration.
EnablingICEMediaroutingusingICErequiresaTURNserver.
CiscoVCSExpresswayrunningversionX5.
2orlatercanfunctionasaTURNserverifithasTURNRelaylicenses.
HavingtheTURNserveroptionkeyisrequired.
TostartsettinguptheCiscoVCSExpressway,gotoVCSconfiguration>Expressway>TURNandconfigurethefieldsasdescribedbelow.
SettingChangetoTURNservicesOnPort3478Mediaportrangestart60000Mediaportrangeend61399HowcommunicationworksCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page27of36TofinishsetupontheCiscoVCSExpressway:1.
GotoVCSconfiguration>Authentication>Devices>ConfigurationandsettheDatabasetypetoLocalDatabase.
2.
GotoVCSconfiguration>Authentication>Devices>Localdatabaseandcreateausernameandpassword.
TheusernameandpasswordarenecessarytoallowforuseofTURNRelaylicenses.
TheJabberVideoclientisprovisionedwiththeusernameandpasswordasdescribedbelow.
ToenableICEontheJabberVideoclient,gotoSystems>Provisioning>DirectoryandtheConfigurationspaneforJabberVideo,thenupdatethefieldsasdescribedbelow.
SettingChangetoEnableICEOnTurnAuthPasswordPasswordcreatedwhensettinguptheCiscoVCSExpresswayTurnAuthUsernameUsernamecreatedwhensettinguptheCiscoVCSExpresswayTurnServerTheaddressoftheservermediaisrelayedthroughinan"ICEcall",typicallytheaddressoftheCiscoVCSExpresswayNote:TheICEProvisioningconfigurationsarenotavailablebydefault.
SeetheProvisioningsectionformoreinformation.
ConfiguringJabberVideo'sTURNportTURNportconfigurationshouldbecontrolledthroughDNS.
JabberVideowilldoanSRVlookupfortheTURNIP,priority,weight,andport.
AsTURNrunsoverUDP,thelookupwillbefor_turn.
_udp.
.
IfnoSRVrecordforTURNisfound,JabberVideowillperformanArecordlookup(IPv4)oranAAAAlookup(IPv6),butwilldefaulttoport3478.
Iftheportneedstobeprovisioned,youcanappendittotheIPaddressintheTurnServerfield,forexample192.
0.
2.
0:3478.
RunningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page28of36RunningtheclientThissectionprovidesanoverviewofJabberVideo'scommunicationwiththeservers,asareferencetousewhenconfiguring,deploying,ortroubleshootingJabberVideo.
SigninginJabberVideowillattempttosignintoaCiscoVCSaccordingtoitsSign-inSettings,whetherpre-configuredorprovidedmanually.
Thesign-instagesaredescribedbelow.
SubscribingtotheCiscoVCSJabberVideofirstattemptstosubscribetotheinternalCiscoVCSconfiguredinitsSign-inSettings.
Ifthisfails,forexamplebecausetheuser'scomputerisconnectedtothepublicinternet,JabberVideowilltrytosubscribetotheexternalCiscoVCS.
However,iftheinternalCiscoVCSisaDNSaddressthattranslatestomorethanoneIPaddress,JabberVideowillattempttoconnecttoalltheseIPnumbersbeforetryingtheexternalCiscoVCS.
IftheDNSservercontainsSRVrecords,JabberVideowilladheretothepriorityandweightoftheIPaddresses,otherwisetheywillbetriedinrandomorder.
Typically,theCiscoVCSortheCiscoTMSAgentwillchallengethefirstsubscriptionmessage.
JabberVideowillanswerthischallengebysendinganotherSUBSCRIBEmessagewiththeauthenticationinformation.
Afterthesubscriptionhasbeenauthenticated,theCiscoTMSAgentwillsendprovisioninginformationtotheJabberVideoclient.
RegisteringtotheCiscoVCSJabberVideowillregistertotheCiscoVCSaccordingtotheprovisioningconfigurationinCiscoTMS;SIPServerURIorPublicSIPServerURI.
IfthisprovisioningconfigurationisidenticaltotheAdvancedsettingintheJabberVideoclient(recommended),JabberVideowillregistertothesameCiscoVCSitsubscribedto.
Aslongastheclientisregistered,theCiscoVCSwillknowtoforwardmessagestotheclient.
Afterinitialregistration,JabberVideowillcontinuetosendregistrationmessagestotheCiscoVCSaccordingtotheRegistrationexpiredeltasettingunderVCSconfiguration>Protocols>SIP>Configuration.
JabberVideowillsendthemessageafter75%ofthespecifiedtimeintervalhaselapsed.
CommunicatingwithCiscoVCSAfterJabberVideohassignedin,connectivitychecksandbandwidthprobingisperformedifenabled,andanumberofothertasksareperformedcontinuously.
ConnectivitychecksIndeploymentsthatsupportthisfunctionality,JabberVideowillnowperformconnectivitychecksusingDNStofindTURNserversandportsaftersigningin.
IfspecifiedintheSRVrecordsandsupportedbytheTURNserver,JabberVideocanuseanyportsincluding80(HTTP)and443(HTTPS).
JabberVideolooksforportsinthefollowingorderofpriority:RunningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page29of361.
UDP2.
TCP(ifsupported)3.
TLS(ifsupported)Ifnoportsaredetected,JabberVideowilldefaulttoports3478and5349.
NotethatfirewalltraversalusingTCPrelayisnotsupportedwhenusingCiscoVCSasaTURNserveratthistime.
BandwidthprobingIfbandwidthprobingisprovisioned,JabberVideowillroutedummymediatotheTURNserverandbackaftersigningintodeterminetheavailablebandwidth.
ThefunctionalityreliesonaTURNserverbeingsuccessfullyprovisioned.
TheresultofthebandwidthprobingisusedforJabberVideo'sdynamicresourceadaptation.
ItisalsodisplayedtousersintheQuickSetupdialogaspartofthecalculationofexpectedoutgoingvideoquality.
Notethattheresultsofthebandwidthprobingdependsontheprovisionedtimeforprobingandinmanycaseswillrepresenta"worstcase"bandwidthscenariowheremorebandwidthmaybeavailableduringanactualconference.
PresenceThepresencestatusserviceisprovidedbyCiscoVCS.
JabberVideopublishesitsownpresencetoCiscoVCSandsubscribestopresencestatusesforanySIPURIstheuserhasstoredasfavorites.
SubscribingtothepresencestatusofacontactinformstheCiscoVCSthattheclientshouldbenotifiedwhenthecontact'spresencestatuschanges.
InApplications>PresencetherearetwosettingsthatdeterminetimeoutsforthePresenceserver:nSubscriptionexpirationtimenPublicationexpirationtimeJabberVideowillsubscribeandpublishwhen75%ofthespecifiedtimeintervalshaveelapsed.
Theclientwillbeautomaticallysubscribedtothepresencestatusofanycontactthatisadded.
Inadditiontotheseperiodicmessages,JabberVideowillalsopublishpresenceinformationwhentheuser'sstatushasbeenchanged,eithermanuallyorbecausetheuserisinacall.
Seethe"Presence"sectionoftheCiscoVCSAdministratorsGuideformoreinformationaboutthepresenceserver.
SIPkeepaliveTomakesurethattheconnectionbetweentheJabberVideoclientandCiscoVCSremainsopenanddoesnotgetclosedbyafirewallasanidleconnection,JabberVideosendsSIPKeepAlivemessages.
Bydefaulttheintervalforthesemessagesis24seconds.
ToconfiguretheSIPKeepAliveInterval:1.
InCiscoTMS,gotoSystems>Provisioning>Directory.
2.
ClickonthegrouporuseryouwanttoprovisionandfindtheConfigurationspane.
3.
ChangetheSIPKeepAliveIntervalconfigurationifitexists,oraddone.
RunningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page30of36LosingconnectionIfJabberVideogetsanindicationthattheconnectionhasbeenlostorisunabletocontinueregisteringtoCiscoVCS,JabberVideowillsignoutanddisplaythesign-inscreen.
IftheSigninautomaticallyboxischecked,JabberVideowillattempttosigninagain.
Thefirstattemptwillbeonesecondafterconnectiongotlost,thesecondattemptaftertwo,thethirdafterfour,theneightandnextsixteen.
Fromtheninthattemptonwards,JabberVideowilltrytosigninonlyonceevery5minutes,topreventputtingtoomuchstrainonsystemresources.
SearchingforacontactEverytimeausertypesacharacterinthesearchfieldoftheJabberVideoclient,JabberVideoqueriestheTMSAgentontheCiscoVCS,andtheTMSAgentanswerswithmatchingresults.
Note:PhonebooksearchresultsaredeterminedbytheCiscoVCS/TMSAgentanddependentonCiscoVCSversion.
Whenasearchresultisselected,JabberVideowillalsoquerytheCiscoVCSforthepresencestatusofthatcontact.
CallsetupCallsetupiscommunicatedusingSIPmessagespassedthroughtheCiscoVCS.
Thefollowingdescribeshowthecall'sattributesaredeterminedduringcallsetup.
EncryptionForacalltobeencrypted,boththeSIPandthemediacommunicationmustbeencrypted,andallpartiesmustsupportencryption.
EncryptedmediacommunicationissentusingtheSecureReal-timeTransportProtocol(SRTP)witha128-bitAdvancedEncryptionStandard(AES).
TheEncryptionpolicysettingisprovisionedtotheclientasconfiguredinSystems>Provisioning>DirectoryinCiscoTMS.
nForceTLS/TCPdetermineswhethertheSIPcommunicationisencrypted(TLS)ornot(TCP).
TheTLSversionusedbyJabberVideoiscurrently1.
0.
nForce/NoSrtpdetermineswhetherthemediacommunicationisencryptedornot.
nAutomeanstheJabberVideoclientwilltrytohaveanencryptedcall,butifnotpossible,itwillallowthecalltobeunencrypted.
Note:Userscantellwhethertheircurrentcallisencryptedbytheiconintheinformationbaratthetopofthevideowindow.
meansthecallisencrypted,meansitisunencrypted.
SentandreceivedbandwidthDuringcallsetup,JabberVideosignalsthemaximumbandwidthitwouldliketoreceiveaccordingtothesettingsintheclient.
Itisuptothesystemontheotherendofthecalltorespectthissignaling.
RunningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page31of36Boththemaximumbandwidthtobesentduringcallandthebandwidthsentatthestartofthecallaredeterminedatcallsetup.
Duringthecall,JabberVideocanchangeandsendmoreorlessbandwidth,butnevermorethanthemaximumbandwidthdecidedduringcallsetup.
MaximumbandwidthsentTodeterminethemaximumbandwidthtobesent,JabberVideochoosesthelowestofthesetwovalues:nMaxoutgoingbandwidth,configuredintheJabberVideoclient'ssettingsnMaxincomingbandwidthrestrictionfromthefarendBandwidthsentatthestartofthecallTodeterminetheinitialbandwidthforanewcall,JabberVideousesitstrafficdatahistory,pulledfromadatabaseofyourlast250calls.
Thecallsareindexedbythenetworklocationsfromwhichthecallsweremade.
BasedonwhatJabberVideoknowsaboutthenetworkandthefarendSIPURI,a"safe"initialbandwidthischosen.
ThedatabaseresidesintheWindowsuserprofile:nWindowsXP:%userprofile%\LocalSettings\ApplicationData\Cisco\JabberVideo\2.
0nWindowsVistaandWindows7:%userprofile%\AppData\Local\Cisco\JabberVideo\2.
0ResolutionNote:Highimageresolutionisnottheonlyfactorlinkedtohighvideoquality.
Framerate,scenelightingandopticalqualityofthecamerasusedintheconferencearealsoimportant.
ResolutionpreferencesTheResolutionPreferencesprovisioningsettinglimitstheresolutionforbothincomingandoutgoingvideo.
SeeProvisioningtheclient.
JabberVideoforWindowstreatstheprovisionedvalueasthemaximum,withend-userconfigurationavailablethroughtheclient'ssettings.
UserswitholderWindowscomputerswithlimitedsystemresourcesmayneedtolowertheresolutionsettingfortheirJabberVideoclienttoensurethatitrunssmoothly.
Note:Itisuptothefarendtoobeyrestrictionsonincomingvideo.
OutgoingvideoresolutionJabberVideodetermineswhichresolutiontosendaccordingtothefollowingcriteria:nJabberVideomustbeabletogettheresolutioninnativeformatfromthecamera.
nPriorityisgiventoresolutionsthatcanbereceivedfromthecameraat30framespersecond.
nTheresolutionmustbepermittedbyJabberVideo'sownsettings,asdescribedabove.
nTheresolutionmustbepermittedbythereceivingend.
nSendinghighresolutionatlowbandwidthwillresultinpoorquality.
Thebandwidthsentmustbesufficientfortheresolution:RunningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page32of36lHD1080p(1920x1080)requiresaminimumof2600kb/s.
lHD720p(1280x720)requiresaminimumof1200kb/s.
lVGA(640x480)requiresaminimumof442kb/s.
Increasingthebandwidthfurtherwillimproveimagequality.
BandwidthpermissionsarecontrolledbytheMaximumOutBandwidthsettings,seeProvisioningtheclient.
IfHDresolutionisnotachieveddespitesufficientbandwidthasdescribedabove,thiscanusuallybeattributedtooneorbothofthefollowing:nIssueswithnetworkconnection,includingpacketlossnAdaptationduetohighCPUusagebyJabberVideo.
SeeAutomaticCPUadaptation.
IncomingvideoresolutionBandwidthpermissionsforincomingvideoarecontrolledbytheMaximumInBandwidthsettings,seeProvisioningtheclient.
ThebandwidthrequiredforincomingHDvideowillvarywiththecapabilitiesandlimitationsofeachfar-endendpoint.
NotethatevenwithanHD-capableendpointatthefarendandnorestrictionsonbandwidth,networkconnectionissues,suchaspacketloss,maystillcauseincomingvideonottoachieveHDresolution.
PresentationresolutionThemaximumresolutionforasharedpresentationisdependentonthevideocodecused(H.
263/H.
263+/H.
264),theavailablebandwidth,andthecapabilitiesofthefarend.
ForaJabberVideo-to-JabberVideocallonunlimitedbandwidth,thepresentationresolutionwouldbe1280x800.
Theresolutionforpresentationsisnotconfigurable.
VideoandaudiostandardsJabberVideosupportsbothsendingandreceivingthestandardsdescribedbelow.
JabberVideowillalwaysusethebeststandardthatissupportedbythefarend.
AudionMPEG4/AAC-LDnG.
722.
1nG.
711Note:Ifthebandwidthavailableislessthan192kb/sandthefarendsupportsG.
722.
1at24kb/s,JabberVideowillsendthatprotocolinordertofreeupbandwidthforbettervideoquality.
VideonH.
264nH.
263+nH.
263RunningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page33of36Far-endcameracontrolandICEnegotiationOncethecallhasbeenestablished,far-endcameracontrol(FECC)andICEarenegotiatedifenabledandsupportedbybothcallparticipants.
Pleasenotethat:nFECCnegotiationsmaytakeseveralseconds.
TheFECCbuttonintheJabberVideoclientisenabledoncenegotiationsarecomplete.
nICEnegotiationstakeacoupleofsecondsandrequirenineTURNserverlicenses;onelicenseforeachmedialink.
DuringacallOnceacallhasbeensetup,thereareanumberofactionsthatcanbepromptedinJabberVideo,eitherasaresultofauseractionorasanautomatedresponsetochangingconditions.
MultiwayinitiationMultiwayistheabilityforausertojoincallsandseamlesslycreateamulti-participantconference.
Ifmultiwayisinitiatedbytheuser,thecurrentcallisputonhold(therehastobeatleastoneothercallalreadyonhold)andalltheendpointsareredirectedtoamulti-conferencesystemaccordingtotheMultiwayParticipantURIprovisioningoption.
MutingmediastreamsIfthecameraormicrophoneismuted,JabberVideoallocatesthebandwidthfortheothermedialinkstouse.
Thismeansthatiftheuserdoesnothaveenoughbandwidthfortwovideostreams,itispossibletomuteonevideostreamandimprovethequalityoftheotherstream.
Topreventtheunusedlinkfrombeingclosed(forexamplebyafirewall),JabberVideosendsSTUNkeepalivemessagesevery7seconds.
AutomaticbandwidthadaptationIncaseofaJabberVideoclientsendingorreceivingbandwidthwhichexceedsthenetworkcapabilities,highpacketlossmayoccurandtheusermayexperiencepoorcallquality.
JabberVideousesautomaticbandwidthadaptationmechanismstotacklebandwidthissues.
Note:Automaticadaptationstaketime.
Configuringtheclienttofitthenetworkandsystemcapabilitiesisalwaysrecommended.
AutomaticCPUadaptationRunningJabberVideowiththehighestvideoqualityonalesspowerfulcomputermightresultin100%CPUusageandapoorcallquality.
JabberVideomonitorstheCPUusageofthecomputer.
IfCPUusageexceeds95%for10secondsormore:nifJabberVideoisresponsibleforlessthan90%oftheCPUusage,itwilldisplayawarningaskingtheusertocloseotherapplications.
RunningtheclientCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page34of36nifJabberVideoisresponsiblefor90%ormoreoftheCPUusage,itwilllowertheresolutionforthevideopicturesent.
Note:Automaticadaptationstaketime.
Configuringtheclienttofitthenetworkandsystemcapabilitiesisalwaysrecommended.
ConferenceinformationWhenmovingthecursoroverthevideowindow,aninformationbarappearsatthetop.
ClickingtheibuttonopensConferenceinformation,anoverviewofoutgoing(transmit)andincoming(receive)trafficdata.
FieldnameDescriptionMaxallowedbitrateRestrictionstakenfromJabberVideo'ssettings.
SignaledbitrateThesignaledbitratecombinesJabberVideo'srestrictionswiththosefromthefarend.
ConfiguredbitrateTheconfiguredbitratevariesbasedonautomaticbandwidthadaptation.
Thisvalueisnottransmittedtothefarend.
EncryptionThisfieldisblankifnoencryptionisused.
ProtocolThevideoandaudiostandardscurrentlyinuse.
ResolutionThecurrentoutgoingandincomingresolution.
Thisvaluechangesbasedonautomaticadaptation.
BitrateTheactualbandwidthsentandreceived,whichwillalwaysbeequaltoorlowerthantheconfiguredbitrate.
TotalpacketlossNumberofpacketslostduringthecallsofar.
CurrentpacketlossPercentageofpacketslostinthelastfiveseconds(transmit)orthreeseconds(receive).
PostFECtotalNumberofpacketsrecovered(FEC=forwarderrorcorrection)byClearPath.
PostFECcurrentPercentageofpacketsrecoveredbyClearPathinthelastthreeseconds.
JitterJitterisacontinuouslycalculatedestimateofthemeandeviationofthedifferenceintransittimeofadjacentpackets.
ThetransmitjitterinformationisbasedonRTCPreportsfromthefarend.
Highjitteraffectsthecallqualityandisusuallyindicativeofpoornetworkconditions.
BibliographyCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page35of36BibliographyThefollowingtablelistsdocumentsandwebsitesreferencedinthisdocument.
Allproductdocumentationcanbefoundonourwebsite.
DocumenttitleDocumentreferenceURLCiscoJabberVideoforTelePresenceSoftwareReleaseNotes4.
3D14835http://cisco.
comCiscoJabberVideoforTelePresenceUserGuideforWindowsD14409http://cisco.
comCiscoJabberVideoforTelePresenceUserGuideforMacOSXD14733http://cisco.
comCiscoTelePresenceVideoCommunicationServerAuthenticatingDevicesDeploymentGuideD14819http://cisco.
comManagingClient-InitiatedConnectionsintheSessionInitiationProtocol(SIP)RFC5626http://tools.
ietf.
org/html/rfc5626PackageMakerUserGuide—http://developer.
apple.
com/library/mac/#documentation/DeveloperTools/Conceptual/PackageMakerUserGuide/BibliographyCiscoJabberVideoforTelePresenceAdministratorGuide(4.
3)Page36of36THESPECIFICATIONSANDINFORMATIONREGARDINGTHEPRODUCTSINTHISMANUALARESUBJECTTOCHANGEWITHOUTNOTICE.
ALLSTATEMENTS,INFORMATION,ANDRECOMMENDATIONSINTHISMANUALAREBELIEVEDTOBEACCURATEBUTAREPRESENTEDWITHOUTWARRANTYOFANYKIND,EXPRESSORIMPLIED.
USERSMUSTTAKEFULLRESPONSIBILITYFORTHEIRAPPLICATIONOFANYPRODUCTS.
THESOFTWARELICENSEANDLIMITEDWARRANTYFORTHEACCOMPANYINGPRODUCTARESETFORTHINTHEINFORMATIONPACKETTHATSHIPPEDWITHTHEPRODUCTANDAREINCORPORATEDHEREINBYTHISREFERENCE.
IFYOUAREUNABLETOLOCATETHESOFTWARELICENSEORLIMITEDWARRANTY,CONTACTYOURCISCOREPRESENTATIVEFORACOPY.
TheCiscoimplementationofTCPheadercompressionisanadaptationofaprogramdevelopedbytheUniversityofCalifornia,Berkeley(UCB)aspartofUCB'spublicdomainversionoftheUNIXoperatingsystem.
Allrightsreserved.
Copyright1981,RegentsoftheUniversityofCalifornia.
NOTWITHSTANDINGANYOTHERWARRANTYHEREIN,ALLDOCUMENTFILESANDSOFTWAREOFTHESESUPPLIERSAREPROVIDED"ASIS"WITHALLFAULTS.
CISCOANDTHEABOVE-NAMEDSUPPLIERSDISCLAIMALLWARRANTIES,EXPRESSEDORIMPLIED,INCLUDING,WITHOUTLIMITATION,THOSEOFMERCHANTABILITY,FITNESSFORAPARTICULARPURPOSEANDNONINFRINGEMENTORARISINGFROMACOURSEOFDEALING,USAGE,ORTRADEPRACTICE.
INNOEVENTSHALLCISCOORITSSUPPLIERSBELIABLEFORANYINDIRECT,SPECIAL,CONSEQUENTIAL,ORINCIDENTALDAMAGES,INCLUDING,WITHOUTLIMITATION,LOSTPROFITSORLOSSORDAMAGETODATAARISINGOUTOFTHEUSEORINABILITYTOUSETHISMANUAL,EVENIFCISCOORITSSUPPLIERSHAVEBEENADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGES.
CiscoandtheCiscoLogoaretrademarksofCiscoSystems,Inc.
and/oritsaffiliatesintheU.
S.
andothercountries.
AlistingofCisco'strademarkscanbefoundatwww.
cisco.
com/go/trademarks.
Thirdpartytrademarksmentionedarethepropertyoftheirrespectiveowners.
TheuseofthewordpartnerdoesnotimplyapartnershiprelationshipbetweenCiscoandanyothercompany.
(1005R)AnyInternetProtocol(IP)addressesandphonenumbersusedinthisdocumentarenotintendedtobeactualaddressesandphonenumbers.
Anyexamples,commanddisplayoutput,networktopologydiagrams,andotherfiguresincludedinthedocumentareshownforillustrativepurposesonly.
AnyuseofactualIPaddressesorphonenumbersinillustrativecontentisunintentionalandcoincidental.
2011CiscoSystems,Inc.
Allrightsreserved.