SIP Call Transfer and Call Forwarding Supplementary Services(cisco)
2007-12-18 20:44
465 查看
TableOfContents
SIPCallTransferandCallForwardingSupplementaryServices
TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureintroducestheabilityofSessionInitiationProtocol(SIP)gatewaystoinitiateblind,orattended,calltransfers.ReleaseLinkTrunking(RLT)functionalityisalsoaddedwiththisfeature.WithRLT,SIPblindcalltransferscannowbetriggeredbychannel-associatedsignaling(CAS)trunksignaling.Finally,theSIPCallTransferandCallForwardingSupplementaryServicesfeatureimplementsSIPsupportofcallforwardingrequestsfromaCiscoIOSgateway.Calltransferandcallforwardingcapabilitiesenableapplicationserviceproviders(ASPs)toprovidecalltransferandcallforwardingservicesinaccordancewithemergingSIPstandards.
FeatureSpecificationsfortheSIPCallTransferandCallForwardingSupplementaryServices
FeatureHistory | |
Release | Modification |
12.2(11)YT | Thisfeaturewasintroduced. |
SupportedPlatforms | |
Cisco1760,Cisco2610,Cisco2613,Cisco2610XM,Cisco2611XM,Cisco2620,Cisco2621,Cisco2620XM,Cisco2621XM,Cisco2650,Cisco2651,Cisco2650XM,Cisco2651XM,Cisco2691,Cisco3620,Cisco3640,Cisco3660,Cisco7200,CiscoAS5300,CiscoAS5350,CiscoAS5400,andCiscoAS5850 2610-2613;2620-2621;2650-2651;3620;3640;7200;AS5300;AS5350;AS5400;AS5800;AS5850 1760;2400;2610-2613;2610XM-2611XM;2620-2621;2620XM-2621XM;2650-2651;2650XM-2651XM;2691;3620;3640;3660;3725;3745;7200;7400;AS5300;AS5350;AS5400;AS5800;AS5850 |
CiscoIOSsoftwareispackagedinfeaturesetsthataresupportedonspecificplatforms.Togetupdatedinformationregardingplatformsupportforthisfeature,accessCiscoFeatureNavigator.CiscoFeatureNavigatordynamicallyupdatesthelistofsupportedplatformsasnewplatformsupportisaddedforthefeature.
CiscoFeatureNavigatorisaweb-basedtoolthatenablesyoutodeterminewhichCiscoIOSsoftwareimagessupportaspecificsetoffeaturesandwhichfeaturesaresupportedinaspecificCiscoIOSimage.Youcansearchbyfeatureorrelease.Underthereleasesection,youcancomparereleasessidebysidetodisplayboththefeaturesuniquetoeachsoftwarereleaseandthefeaturesincommon.
ToaccessCiscoFeatureNavigator,youmusthaveanaccountonCisco.com.Ifyouhaveforgottenorlostyouraccountinformation,sendablanke-mailtocco-locksmith@cisco.com.Anautomaticcheckwillverifythatyoure-mailaddressisregisteredwithCisco.com.Ifthecheckissuccessful,accountdetailswithanewrandompasswordwillbee-mailedtoyou.QualifieduserscanestablishanaccountonCisco.combyfollowingthedirectionsfoundatthisURL:
CiscoFeatureNavigatorisupdatedregularlywhenmajorCiscoIOSsoftwarereleasesandtechnologyreleasesoccur.Forthemostcurrentinformation,gototheCiscoFeatureNavigatorhomepageatthefollowingURL:
AvailabilityofCiscoIOSSoftwareImages
PlatformsupportforparticularCiscoIOSsoftwarereleasesisdependentontheavailabilityofthesoftwareimagesforthoseplatforms.Softwareimagesforsomeplatformsmaybedeferred,delayed,orchangedwithoutpriornotice.ForupdatedinformationaboutplatformsupportandavailabilityofsoftwareimagesforeachCiscoIOSsoftwarerelease,refertotheonlinereleasenotesor,ifsupported,CiscoFeatureNavigator.
Contents
••
•
•
•
•
•
•
PrerequisitesforSIPCallTransferandCallForwardingSupplementaryServices
ThefollowingaregeneralprerequisitesforSIPdeployment:•
EnsurethatyourCiscorouterhastheminimummemoryrequirements.
•
EnsurethatthegatewayhasvoicefunctionalitythatisconfigurableforSIP.
•
AswithallSIPcalltransfermethods,thedialpeersmustbeconfiguredforcorrectfunctioningoftheRefermethod.Seethe
LoadCiscoIOSRelease12.2(11)YToralaterrelease.
Configurehookflashsignaling.
WriteaToolCommandLanguage(TCL)InteractiveVoiceResponse(IVR)2.0scriptthatimplementsCiscoIOScalltransferandforwardsupplementaryservicesfunctionality.
RestrictionsforSIPCallTransferandCallForwardingSupplementaryServices
•TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureissupportedonlythroughTCLIVR2.0andVoiceXMLapplications;itisnotsupportedforTCLIVR1.0applicationsortheDEFAULTsessionapplication.
•
AlthoughSIPCiscoIOSgatewayscurrentlysupportSIPURLsandTELURLs,theRefer-ToheaderandtheAlsoheadermustbeinSIPURLformattobevalid.TheTELURLformatcannotbeusedbecauseitdoesnotprovideahostportion,andwithoutone,thetriggeredInviterequestcannotberouted.
•
CiscoSIPcustomerpremiseequipment(CPE)suchas79xxandAnalogTelephoneAdaptors(ATAs)donotcurrentlysupportTELURLs.
•
TheRefer-ToandContactheadersarerequiredintheReferrequest.Theabsenceofeitherheaderresultsina4xxclassresponsetotheReferrequest.Also,theReferrequestmustcontainexactlyoneRefer-Toheader.MultipleRefer-Toheadersresultina4xxclassresponse.
•
TheReferred-ByheaderisrequiredinaReferrequest.Theabsenceofthisheaderresultsina4xxclassresponsetotheReferrequest.Also,theReferrequestmustcontainexactlyoneReferred-Byheader.MultipleReferred-Byheadersresultina4xxclassresponse.
•
OnlyRLTonCASoranalog(FXS)portsissupportedwithSIPcalltransfers.
•
TheCiscoAS5xxxplatformsdonotsupporthookflashdetectionforT1CAS.
•
SIPcallforwardingissupportedonlyone-phones—IPphonesthatarenotconfiguredonthegateway.FXS,FXO,T1,E1,andCASphonesarenotsupported.
•
InCiscoIOSRelease12.2(11)YT,whenSIPwithe-phonesisused,DTMFisnotsupported.Voicecanbeestablished,butDTMFcannotberelayedin-orout-of-band.Customscriptingisalsonecessaryfore-phonestoinitiatecallforwarding.Thestandardconfigurationslistedinthisdocumentworkonlywhenane-phoneistherecipientorfinal-recipient.
InformationAboutSIPCallTransferandCallForwardingSupplementaryServices
ToconfiguretheSIPCallTransferandCallForwardingSupplementaryServicesfeature,youmustunderstandthefollowingconcepts:•
•
•
•
SIPBlindCallTransferandCallForwardingTCLIVRScript
TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureimplementsSIPsupportofblind,orattended,calltransfersandcallforwardingrequestsfromaCiscoIOSgateway.Ablindtransferisoneinwhichthetransferringphoneconnectsthecallertoadestinationlinebeforeringbackbegins.Thisisdifferentfromaconsultativetransferinwhichoneofthetransferringpartieseitherconnectsthecallertoaringingphone(ringbackheard)orspeakswiththethirdpartybeforeconnectingthecallertothethirdparty.Blindtransfersareoftenpreferredbyautomateddevicesthatdonothavethecapabilitytomakeconsultationcalls.WhentheTCLIVRscriptrunsontheCiscogateway,itcanrespondtorequeststoinitiateblindcalltransfer(transferwithoutconsultation)onaSIPcallleg.SIPcallforwardingone-phones(IPphonesthatarenotconfiguredonthegateway)isalsosupported.
ReleaseLinkTrunkingonSIPGateways
RLTfunctionalityhasbeenaddedtoCiscoIOSSIPgateways.WithRLTfunctionality,SIPcalltransfercannowbetriggeredbyCAStrunksignaling,whichthecustomTCLIVRapplicationcanmonitor.AfteraSIPcalltransferhastranspiredandtheCASinterfaceisnolongerrequired,theCASinterfacecanbereleased.TheRLTfunctionalitycanbeusedtoinitiateblindtransfersonSIPgateways.BlindcalltransferusestheRefermethod.AfulldescriptionofblindtransferandthereferMethodcanbefoundin
RLTandSIPCallTransfers
WiththeCiscoIOSSIPCallTransferandCallForwardingSupplementaryServicesfeature,calltransfercanbetriggeredbyCAStrunksignalingandthencapturedbythecustomTCLIVRscriptonagateway.Theprocessbeginswiththeoriginator(theSIPuseragentthatinitiatesthetransferorReferrequest)respondingwithadialtoneonceitreceivesthesignalorhookflashfromthePSTNcallleg.Theoriginatorthenpreparestoreceivedual-tonemultifrequency(DTMF)digitsthatidentifythefinal-recipient(theuseragentintroducedintoacallwiththerecipient).OncethefirstDTMFdigitisreceived,thedialtoneisdiscontinued.DTMF-digitcollectionisnotcompleteduntila4-secondinterdigittimeoutoccursoranon-hookisreceivedonthatspecificCAStimeslot.CalltransferstartswhenDTMF-digitcollectionissuccessful.Ifdigitcollectionfails,forexampleifnotenoughDTMFdigitsorinvaliddigitsarecollected,theinitialcallisreestablished.
OncetheDTMFdigitsaresuccessfullycollected,thecustomTCLIVRscriptcaninitiatecalltransfer.SIPmessagingbeginswhenthetransferisinitiatedwiththeRefermethod.TheoriginatorsendsanInvitetotherecipient(theuseragentthatreceivestheReferrequestandistransferredtothefinal-recipient)toholdthecallandrequestthattherecipientnotreturnReal-TimeTransportProtocol(RTP)packetstotheoriginator.TheoriginatorthensendsaSIPReferrequesttotherecipienttostartthetransferprocess.Whentherecipientreceivestherequest,itreturnsa202Acceptedacknowledgementtotheoriginator.TheTCLIVRscriptrunbytheoriginatorcanthenreleasetheCAStrunkandclosetheprimarycall.See
IftherecipientdoesnotsupporttheRefermethod,a501Notimplementedmessageisreturned.However,forbackwardcompatibilitypurposes,thecalltransferisautomaticallycontinuedwiththeBye/Alsomethod.TheoriginatorsendsaBye/AlsorequesttotherecipientandreleasestheCAStrunkwiththePSTNcallleg.Theprimarycallbetweentheoriginatorandtherecipientisclosedwhena200OKresponseisreceived.
Inallothercasesofcalltransferfailures,theprimarycallbetweentheoriginatorandtherecipientisimmediatelyshutdown.
Figure1CallTransferUsingtheReferMethod
SIPandTELURLsinCallTransfers
WhentheSIPcalltransferoriginatorcollectsDTMFdigitsfromtheCAStrunk,itattemptstofindadialpeer.Ifadialpeerisfound,thesessiontargetinthedialpeerisusedtoformulateaSessionInitiationProtocolUniformResourceLocator(SIPURL).ThisURLcanbeusedwithboththeRefermethodandtheBye/Alsomethod.ASIPURLisinthefollowingform:sip:JohnSmith@somewhere.com
Ifavaliddialpeerisnotfound,aTelephoneUniformResourceLocator(TELURL)isformulatedintheRefer-Toheader.ATELURLisinthefollowingform:
tel:+11231234567
ThechoiceofwhichURLtouseiscriticalwhencorrectlyroutingSIPcalls.Forexample,theoriginatinggatewaycansendoutaByewithanAlsoheader,buttheAlsoheadercancarryonlyaSIPURL.ItcannotcarryaTELURL.Thatis,ifthegatewaydecidestosendaBye/Alsobutcannotfindamatcheddialpeer,thegatewayreportsanerroronthetransfergatewayandsendsaByewithouttheAlsoheader.
IftherecipientofaSIPcalltransferisaSIPphone,thephonemusthavethecapabilitytointerpreteithertheRefermethodortheBye/Alsomethodforthecalltransfertowork.IftherecipientisaCiscoIOSgateway,thereneedstobeamatchingdialpeerfortheRefer-Touser.User,lookingatthepreviousexample,canbeeitherJohnSmithor11231234567.Thedialpeeralsoneedstohaveanapplicationsessiondefined,wheresessioncanbethenameofaTCLIVRapplication.Ifthere'snomatch,a4xxerrorissentbackandnotransferoccurs.Ifthere'saPOTSdialpeermatch,acallismadetothatPOTSphone.Beforethe12.2(11)YTrelease,ifthere'saVoIPmatch,theRefer-ToURLisusedtoinitiateaSIPcall.Inrelease12.2(11)YTandlater,theapplicationsessiontargetinthedialpeerisusedfortheSIPcall.See
SIPGatewayInitiationofCallTransfers
TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureintroducestheabilityofSIPgatewaystoinitiate,ororiginate,attendedcalltransfers.Theprocessbeginswhentheoriginatorestablishesacallwiththerecipient.WhentheuseronthePSTNcalllegwantstotransferthecall,theuseruseshookflashtogetaseconddialtoneandthenentersthefinal-recipientsnumber.TheTCLIVRscriptcanthenputtheoriginalcallonholdandsetupthecalltothefinal-recipient,makingtheoriginatoractivewiththefinal-recipient.TheReferrequestissentoutwhentheuserhangsuptotransferthecall.TheReferrequestcontainsaReplacesheaderthatcontainsthreetags:SIPCallID,from,andto.ThetagsarepassedalongintheInvitefromtherecipienttothefinal-recipient,givingthefinal-recipientadequateinformationtoreplacethecallleg.ThehostportionoftheReferrequestisbuiltfromtheestablishedinitialcall.ThefollowingisanexampleofaReferrequestthatcontainsaReplacesheader:Note
IPaddressesandhostnamesinexamplesarefictitious.
Refersip:3100801@172.16.190.100:5060;user=phoneSIP/2.0
Via:SIP/2.0/UDP172.16.190.99:5060
From:"5555555"<sip:5555555@172.16.190.187>
To:<sip:3100801@172.16.190.187>;tag=A7C2C-1E8C
Date:Sat,01Jan200005:15:06GMT
Call-ID:c2943000-106ae5-1c5f-3428@172.16.197.182
User-Agent:Cisco-SIPGateway/IOS-12.x
Max-Forwards:6
Timestamp:946685709
CSeq:103Refer
Refer-To:sip:3100802@10.102.17.217?Replaces=DD713380-339C11CC-80BCF308-92BA812C@172.16.195.77;to-tag=A5438-23E4;from-tag=C9122EDB-2408
Referred-By:<sip:3100802@172.16.190.99>
Content-Length:0
OncetheNOTIFYisreceivedbytheoriginator,theTCLIVRscriptcandisconnectthecallbetweenoriginatorandrecipient.Thecallbetweentheoriginatorandfinal-recipientisdisconnectedbytherecipientsendingaBYEtotheoriginator.See
Figure2SuccessfulAttendedCallTransferInitiatedbytheOriginator
IftherecipientdoesnotsupporttheRefermethod,a501Notimplementedmessageisreturned.
Inallothercasesofcalltransferfailures,theprimarycallbetweentheoriginatorandtherecipientisimmediatelyshutdown.
Figure3UnsuccessfulCallTransfer—RecipientHangsUpBeforeTransferCompletes
SIPCallForwarding
SIPcallforwardingissupportedonlyone-phones—IPphonesthatarenotconfiguredonthegateway.FXS,FXO,T1,E1,andCASphonesarenotsupported.Withe-phones,therearefourdifferenttypesofSIPcallforwardingsupported:
•
CallForwardUnavailable
•
CallForwardNoAnswer
•
CallForwardBusy
•
CallForwardUnconditional
Inallfourofthesecallforwardingtypes,a302MovedTemporarilyresponseissenttotheuseragentclient.ADiversionheaderincludedinthe302responseindicatesthetypeofforward.
The302responsealsoincludesaContactheader.TheContactheaderisgeneratedbythecallingnumberthatisprovidedbythecustomTCLIVRscript.The302responsealsoincludesthehostportionfoundinthedialpeerforthatcallingnumber.IfthecallingnumbercannotmatchaVoIPdial-peerorPOTSdial-peernumber,a503ServiceUnavailablemessageissent,exceptinthecaseoftheCallForwardNoAnswer.WithCallForwardNoAnswer,callforwardingisignored,thephonerings,andtheexpirestimerclearsthecallifthereisnoanswer.
Note
InCiscoIOSRelease12.2(11)YT,whenSIPwithe-phonesisused,DTMFisnotsupported.Voicecanbeestablished,butDTMFcannotberelayedin-orout-of-band.Customscriptingisalsonecessaryfore-phonestoinitiatecallforwarding.Thestandardconfigurationslistedinthisdocumentworkonlywhenane-phoneistherecipientorfinal-recipient.
HowtoConfigureSIPCallTransferandCallForwardingSupplementaryServices
Thissectioncontainsthefollowingprocedures.Eachprocedureisidentifiedaseitherrequiredoroptional.•
•
•
•
•
LoadingtheTCLIVRApplicationontheGateway
TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureimplementsSIPsupportofblind,orattended,calltransfersandcallforwardingrequestsfromaCiscoIOSgateway.Beforethesefeaturesareimplemented,acustomTCLIVR2.0scriptmustbeloadedonthegateway.Prerequisites
Restrictions
TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureissupportedonlythroughTCLIVR2.0andVoiceXMLapplications;itisnotsupportedforTCLIVR1.0applicationsortheDEFAULTsessionapplication.SUMMARYSTEPS
1.enable
2.
configure{terminal|memory|network}
3.
callapplicationvoiceapplication-namelocation
4.
callapplicationvoiceapplication-namelanguagenumberlanguage
5.
callapplicationvoiceapplication-nameset-locationlanguagecategorylocation
6.
exit
7.
callapplicationvoiceloadapplication-name
DETAILEDSTEPS
CommandorAction | Purpose | |
---|---|---|
Step1 | enable Example: Router>enable | Enableshigherprivilegelevels,suchasprivilegedEXECmode. • Enteryourpasswordifprompted. |
Step2 | configure{terminal|memory|network} Example: Router#configureterminal | Entersglobalconfigurationmode. |
Step3 | callapplicationvoiceapplication-namelocation Example: Router(config)#callapplicationvoicetransfer_appflash:app_h450_transfer.tcl | LoadstheTCLIVRscriptandspecifiesitsapplicationname. • application-name—Nameusedtoreferencethecallapplication.Thisisauser-definednameanddoesnothavetomatchthedocumentname. • location—ThelocationoftheTCLIVRfileinURLformat.Forexample,Flashmemory(flash:filename),TFTP(tftp://../filename)orHTTPserverpaths(http://../filename)arevalidlocations. |
Step4 | callapplicationvoiceapplication-namelanguagenumberlanguage Example: Router(config)#callapplicationvoicetransfer_applanguage1en | (Optional)Setsthelanguagefordynamicpromptsusedbytheapplication. • application-name—NameoftheTCLIVRapplicationtowhichthelanguageparametersarebeingpassed. • language—Definesthelanguageoftheassociatedaudiofile.Validentriesareasfollows: – en—English – sp—Spanish – ch—Mandarin – aa—All • number—NumberthatidentifiesthelanguageusedbytheaudiofilesfortheIVRapplication. |
Step5 | callapplicationvoiceapplication-nameset-locationlanguagecategorylocation Example: Router(config)#callapplicationvoicetransfer_appset-locationen0flash:/prompts | (Optional)Definesthelocationandcategoryoftheaudiofilesthatareusedbytheapplicationfordynamicprompts. • application-name—NameoftheTCLIVRapplication. • language—Definesthelanguageoftheassociatedaudiofile.Validentriesareasfollows: – en—English – sp—Spanish – ch—Mandarin – aa—All • category—Categorygroup(0to4)fortheaudiofilesfromthislocation.Forexample,audiofilesforthedaysandmonthscouldbecategory1,audiofilesforunitsofcurrencycouldbecategory2,andaudiofilesforunitsoftime-(seconds,minutes,andhours)couldbecategory3.Thevalue0meansallcategories. • location—URLofthedirectorythatcontainsthelanguageaudiofilesusedbytheapplication,withoutfilenames.Forexample,Flashmemory(flash)oradirectoryonaserver(TFTP,HTTP,orRTSP)arevalidlocations. |
Step6 | exit Example: Router(config)#exit | ExitsglobalconfigurationmodeandreturnstoprivilegedEXECmode. |
Step7 | callapplicationvoiceloadapplication-name Example: Router#callapplicationvoiceloadtransfer.app | (Optional)ReloadstheTCLscriptafterithasbeenmodified. • application-name—NameoftheTCLIVRapplicationtoreload. |
ConfiguringSIPCallTransferandCallForwardingonaPOTSDialPeer
Tohandleallcalltransferandcallforwardingsituations,youshouldconfigurebothPOTSandVoIPdialpeers.ThistaskconfiguresSIPcalltransferandcallforwardingforaPOTSdialpeer.ToconfigureSIPcalltransferandforwardingonaCiscoIOSgatewayusingtheCAStrunkrefertothe"ConfiguringCAS"sectionoftheCiscoIOSDialTechnologiesConfigurationGuide,Release12.2.
Restrictions
•TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureissupportedonlythroughTCLIVR2.0andVoiceXMLapplications;itisnotsupportedforTCLIVR1.0applicationsortheDEFAULTsessionapplication.
•
OnlyRLTonCASoranalog(FXS)portsissupportedwithSIPcalltransfers.
•
TheCiscoAS5xxxplatformsdonotsupporthookflashdetectionforT1CAS.
•
SIPcallforwardingissupportedonlyone-phones—IPphonesthatarenotconfiguredonthegateway.FXSandCASphonesarenotsupported.
•
InCiscoIOSRelease12.2(11)YT,whenSIPwithe-phonesisused,DTMFisnotsupported.Voicecanbeestablished,butDTMFcannotberelayedin-orout-of-band.Customscriptingisalsonecessaryfore-phonestoinitiatecallforwarding.Thestandardconfigurationslistedinthisdocumentworkonlywhenane-phoneistherecipientorfinal-recipient.
SUMMARYSTEPS
1.enable
2.
configure{terminal|memory|network}
3.
dial-peervoicetag{pots|voip|mmoip|vofr|voatm}
4.
applicationapplication-name
5.
destination-pattern[+]string[T]
6.
portport
DETAILEDSTEPS
CommandorAction | Purpose | |
---|---|---|
Step1 | enable Example: Router>enable | Enableshigherprivilegelevels,suchasprivilegedEXECmode. Enteryourpasswordifprompted. |
Step2 | configure{terminal|memory|network} Example: Router#configureterminal | Entersglobalconfigurationmode. |
Step3 | dial-peervoicetag{pots|voip|mmoip|vofr|voatm} Example: Router(config)#dial-peervoice25pots | Entersdial-peerconfigurationmode.Thetagvalueisatagthatuniquelyidentifiesthedialpeer.(Thisnumberhaslocalsignificanceonly.) Thefollowingkeywordcanbeusedforconfiguringcalltransfer: • pots—IndicatesthatthisisaVoIPpeerusingvoiceencapsulationontheplainoldtelephoneservice(POTS)network. |
Step4 | applicationapplication-name Example: Router(config-dial-peer)#applicationtransfer_app | LoadstheTCLIVRscriptspecifiedinthesection: |
Step5 | destination-pattern[+]string[T] Example: Router(config-dial-peer)#destination-pattern7777 | DefinestheprefixorthetelephonenumberassociatedwiththisPOTSdialpeer. • +—(Optional)CharacterindicatinganE.164standardnumber. • string—SeriesofdigitsthatspecifytheE.164orprivatedialingplantelephonenumber.Validentriesarethedigits0through9,thelettersAthroughD,andanyspecialcharacter. • T—(Optional)Controlcharacterindicatingthatthedestination-patternvalueisavariablelengthdialstring. |
Step6 | portport Example: Router(config-dial-peer)#port1/1/0 | SpecifiesthevoiceslotnumberandlocalvoiceportthroughwhichincomingVoIPcallsarereceived.Tofindthecorrectdefinitionoftheportargumentforyourrouter,refertothe |
ConfiguringSIPCallTransferandCallForwardingonaVoIPDialPeer
Tohandleallcalltransferandcallforwardingsituations,youshouldconfigurebothPOTSandVoIPdialpeers.ThistaskconfiguresSIPcalltransferandcallforwardingforaVoIPdialpeer.ToconfigureSIPcalltransferandforwardingonaCiscoIOSgatewayusingtheCAStrunkrefertothe"ConfiguringCAS"sectionoftheCiscoIOSDialTechnologiesConfigurationGuide,Release12.2.
Restrictions
•TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureissupportedonlythroughTCLIVR2.0andVoiceXMLapplications;itisnotsupportedforTCLIVR1.0applicationsortheDEFAULTsessionapplication.
•
OnlyRLTonCASoranalog(FXS)portsissupportedwithSIPcalltransfers.
•
TheCiscoAS5xxxplatformsdonotsupporthookflashdetectionforT1CAS.
•
SIPcallforwardingissupportedonlyone-phones—IPphonesthatarenotconfiguredonthegateway.FXSandCASphonesarenotsupported.
•
InCiscoIOSRelease12.2(11)YT,whenSIPwithe-phonesisused,DTMFisnotsupported.Voicecanbeestablished,butDTMFcannotberelayedin-orout-of-band.Customscriptingisalsonecessaryfore-phonestoinitiatecallforwarding.Thestandardconfigurationslistedinthisdocumentworkonlywhenane-phoneistherecipientorfinal-recipient.
SUMMARYSTEPS
1.enable
2.
configure{terminal|memory|network}
3.
dial-peervoicetag{pots|voip|mmoip|vofr|voatm}
4.
applicationapplication-name
5.
destination-pattern[+]string[T]
6.
sessiontargetipv4:destination-address
DETAILEDSTEPS
CommandorAction | Purpose | |
---|---|---|
Step1 | enable Example: Router>enable | Enableshigherprivilegelevels,suchasprivilegedEXECmode. Enteryourpasswordifprompted. |
Step2 | configure{terminal|memory|network} Example: Router#configureterminal | Entersglobalconfigurationmode. |
Step3 | dial-peervoicetag{pots|voip|mmoip|vofr|voatm} Example: Router(config)#dial-peervoice29voip | Entersdial-peerconfigurationmode.Thetagvalueisatagthatuniquelyidentifiesthedialpeer.(Thisnumberhaslocalsignificanceonly.) Thefollowingkeywordcanbeusedforconfiguringcalltransfer: • voip—IndicatesthatthisisaVoIPpeerusingvoiceencapsulationontheplainoldtelephoneservice(POTS)network. |
Step4 | applicationapplication-name Example: Router(config-dial-peer)#applicationtransfer_app | LoadstheTCLIVRscriptspecifiedinthesection: |
Step5 | destination-pattern[+]string[T] Example: Router(config-dial-peer)#destination-pattern7777 | DefinestheprefixorthetelephonenumberassociatedwiththisVoIPdialpeer. • +—(Optional)CharacterthatindicatesanE.164standardnumber. • string—SeriesofdigitsthatspecifytheE.164orprivatedialingplantelephonenumber.Validentriesarethedigits0through9,thelettersAthroughD,andanyspecialcharacter. • T—(Optional)Controlcharacterindicatingthatthedestination-patternvalueisavariablelengthdialstring. |
Step6 | sessiontargetipv4:destination-address Example: Router(config-dial-peer)#sessiontargetipv4:172.18.200.21 | Specifiesanetwork-specificaddressforadialpeer. ipv4:destinationaddress:SetstheIPaddressofthedialpeer.AvalidIPaddressisinthisformat:xxx.xxx.xxx.xxx |
ConfiguringtheSIPCallTransferandCallForwardingSessionTarget
ThistaskconfiguresaSIPserverasasessiontarget.Althoughitisnotrequired,configuringaSIPserverasasessiontargetisusefulifthereisaCiscoSIPproxyserver(CSPS)presentinthenetwork.WithaCSPS,youcanconfiguretheSIPserveroptionandhavetheinteresteddialpeersusetheCSPSbydefault.Todeterminethecalltransferdestinationontheoriginator,checkifthereisamatchingdialpeer.Ifthereisamatchingdialpeer,checkthesessiontargetforthedialpeer.IfthesessiontargetisaSIPserver,configuretheSIPserverasdescribedinthetaskbelow.IfthesessiontargetisnotaSIPserver,thesessiontargetconfiguredintheVoIPdialpeerisused.
Ifthereisnodialpeerthatmatchesthedestinationpattern,aTELURLissent.
ToconfigureSIPcalltransferandforwardingonaCiscoIOSgatewayusingtheCAStrunkrefertothe"ConfiguringCAS"sectionoftheCiscoIOSDialTechnologiesConfigurationGuide,Release12.2.
SUMMARYSTEPS
1.enable
2.
configure{terminal|memory|network}
3.
sip-ua
4.
sip-serverdns:host-name
5.
exit
6.
dial-peervoicenumbervoip
7.
destination-pattern[+]string[T]
8.
sessiontargetsip-server
DETAILEDSTEPS
CommandorAction | Purpose | |
---|---|---|
Step1 | enable Example: Router>enable | Enableshigherprivilegelevels,suchasprivilegedEXECmode. Enteryourpasswordifprompted. |
Step2 | configure{terminal|memory|network} Example: Router#configureterminal | Entersglobalconfigurationmode. |
Step3 | sip-ua Example: Router(config)#sip-ua | EntersSIPuseragentconfigurationmode. |
Step4 | sip-serverdns:host-name Example: Router(config-sip-ua)#sip-serverdns:3660-2.sip.com | SetstheglobalSIPserverinterfacetoaDomainNameSystem(DNS)hostname.Ifyoudonotspecifyahostname,thedefaultDNSdefinedbytheipname-servercommandisused. |
Step5 | exit Example: Router(config-sip-ua)#exit | ExitsSIPuseragentconfigurationmode. |
Step6 | dial-peervoicetag{pots|voip|mmoip|vofr|voatm} Example: Router(config)#dial-peervoice29voip | Entersdial-peerconfigurationmode.Thetagvalueisatagthatuniquelyidentifiesthedialpeer.(Thisnumberhaslocalsignificanceonly.) Thefollowingkeywordcanbeusedforconfiguringcalltransfer: • voip—IndicatesthatthisisaVoIPpeerusingvoiceencapsulationontheplainoldtelephoneservice(POTS)network. |
Step7 | destination-pattern[+]string[T] Example: Router(config-dial-peer)#destination-pattern7777 | DefinestheprefixorthetelephonenumberassociatedwiththisVoIPdialpeer. • +—(Optional)CharacterindicatinganE.164standardnumber. • string—SeriesofdigitsthatspecifytheE.164orprivatedialingplantelephonenumber.Validentriesarethedigits0through9,thelettersAthroughD,andanyspecialcharacter. • T—(Optional)Controlcharacterindicatingthatthedestination-patternvalueisavariablelengthdialstring. |
Step8 | sessiontargetsip-server Example: Router(config-dial-peer)#sessiontargetsip-server | InstructsthedialpeersessiontargettousetheglobalSIPserver.ThissavesrepeatedlyenteringtheSIPserverinterfaceaddressforeachdialpeer. |
TroubleshootingTips
TotroubleshoottheSIPCallTransferandCallForwardingSupplementaryServicesfeature,usethefollowingcommands.Command | Purpose |
---|---|
Router#showtelephony-servicee-phone-dn | DisplaystheCiscoIPphonedestinationnumberofthe CiscoIOSTelephonyServicerouter. |
Router#showtelephony-servicevoice-port | DisplaysoutputforthevoiceportsoftheCiscoIOSTelephonyServicerouter. |
Router#showe-phone[mac-address] | DisplaystheCiscoIPphoneoutput. |
Router#showe-phone-dntag | DisplaystheCiscoIPphonedestinationnumber. |
Router#showe-phonesummary | DisplaysasummaryofallCiscoIPphones. |
Router#showe-phone-dnsummary | DisplaysasummaryofallCiscoIPphonedestinationnumbers. |
Router#showvoiceportsummary | Displaysasummaryofallvoiceports. |
Router#showdial-peervoicesummary | Displaysasummaryofallvoicedialpeers. |
ConfiguringSIPReferandNotifyMessageSettings
TheReferrequestisinitiatedbytheoriginatinggatewayandsignalsthestartofcalltransfer.OncetheoutcomeoftheSIPRefertransactionisknown,therecipientoftheReferrequestnotifiestheoriginatinggatewayoftheoutcomeoftheRefertransaction—whetherthefinal-recipientwassuccessfullyorunsuccessfullycontacted.ThenotificationisaccomplishedusingtheNotifymethod.CompletethesestepstoconfiguretheReferrequestsettingsandtoconfiguretheNotifymethod.
Prerequisites
Customscriptingisnecessaryfore-phonestoinitiatecallforwarding.Thestandardconfigurationslistedinthisdocumentworkonlywhenane-phoneistherecipientorfinal-recipient.Restrictions
•TheSIPCallTransferandCallForwardingSupplementaryServicesfeatureissupportedonlythroughTCLIVR2.0andVoiceXMLapplications;itisnotsupportedforTCLIVR1.0applicationsortheDEFAULTsessionapplication.
•
OnlyRLTonCASoranalog(FXS)portsissupportedwithSIPcalltransfers.
•
TheCiscoAS5xxxplatformsdonotsupporthookflashdetectionforT1CAS.
•
SIPcallforwardingissupportedonlyone-phones—IPphonesthatarenotconfiguredonthegateway.FXSandCASphonesarenotsupported.
•
InCiscoIOSRelease12.2(11)YT,whenSIPwithe-phonesisused,DTMFisnotsupported.Voicecanbeestablished,butDTMFcannotberelayedin-orout-of-band.Customscriptingisalsonecessaryfore-phonestoinitiatecallforwarding.Thestandardconfigurationslistedinthisdocumentworkonlywhenane-phoneistherecipientorfinal-recipient.
•
AswithallSIPcalltransfermethods,thedialpeersmustbeconfiguredforcorrectfunctioningoftheRefermethod.Seethe
Note
Customscriptingisnecessaryfore-phonestoinitiatecallforwarding.Thestandardconfigurationslistedinthisdocumentworkonlywhenane-phoneistherecipientorfinal-recipient.
SUMMARYSTEPS
1.enable
2.
configure{terminal|memory|network}
3.
sip-ua
4.
timersrefernumber
5.
retryrefernumber
6.
timersnotifynumber
7.
retrynotifynumber
8.
exit
DETAILEDSTEPS
CommandorAction | Purpose | |
---|---|---|
Step1 | enable Example: Router>enable | Enableshigherprivilegelevels,suchasprivilegedEXECmode. Enteryourpasswordifprompted. |
Step2 | configure{terminal|memory|network} Example: Router#configureterminal | Entersglobalconfigurationmode. |
Step3 | sip-ua Example: Router(config)#sip-ua | EntersSIPuseragentconfigurationmode. |
Step4 | timersrefernumber Example: Router(config-sip-ua)#timersrefer500 | SetshowlongtheSIPUAwaitsbeforeretransmittingaReferrequest.Thedefaulttimeis500milliseconds. |
Step5 | retryrefernumber Example: Router(config-sip-ua)#retryrefer10 | SetsthenumberoftimestheReferrequestisretransmitted.Thedefaultis10. |
Step6 | timersnotifynumber Example: Router(config-sip-ua)#timersnotify500 | SetshowlongtheSIPUAwaitsbeforeretransmittingtheNotifymessage.Thedefaulttimeis500milliseconds. |
Step7 | retrynotifynumber Example: Router(config-sip-ua)#retrynotify10 | SetsthenumberoftimestheNotifymessageisretransmitted.Thedefaultis10. |
Step8 | exit Example: Router(config-sip-ua)#exit | ExitsSIPuseragentconfigurationmode. |
TroubleshootingTips
ToverifyReferorNotifymessages,usethefollowingcommandsCommand | Purpose |
---|---|
Router#showsip-uatimers | DisplaysthecurrentsettingsfortheSIPuser-agent(UA)timer. |
Router#showsip-uaretry | DisplaysretrystatisticsfortheSIPUA. |
Router#showsip-uastatistics | Displaysresponse,traffic,andretrystatisticsfortheSIPUA. |
ConfigurationExamplesforSIPCallTransferandCallForwardingSupplementaryServices
Thissectionprovidesanend-to-endcalltransferconfigurationexample.•
•
•
•
•
Note
IPaddressesandhostnamesinexamplesarefictitious.
BlindCallTransferIllustrationExample
BlindCallTransferScenarioExample
1.Theuserat(818)382-1111callstheuserat(717)372-1111,andtheyareinaconversation.
2.
Theuserat(717)372-1111decidestotransfertheuserat(818)382-1111totheuserat(616)362-1111.
Thetransfertakesplacebytheuserat(717)372-1111goingon-hookovertheCAStrunkanddialing(616)362-1111.
3.
Acalltransferisinitiatedfromtheoriginatinggatewaytotherecipientgateway,andtheoriginatorreleasestheCAStrunkto(717)372-1111.
4.
Therecipientgatewayreleasesthecalllegtotheoriginatorandinitiatesanewcalltothefinal-recipient—theuserat(616)362-1111.
5.
Thecalltransferiscomplete,andtheuserat(818)382-1111andtheuserat(616)362-1111areinaconversation.
OriginatingGatewayConfigurationExample
Router#showrunning-config
Buildingconfiguration...
Currentconfiguration:4192bytes
!
version12.2
serviceconfig
noservicesingle-slot-reload-enable
noservicepad
servicetimestampsdebuguptime
servicetimestampsloguptime
noservicepassword-encryption
serviceinternal
serviceudp-small-servers
!
voice-card2
!
ipsubnet-zero
!
controllerT12/0
framingesf
linecodeb8zs
ds0-group0timeslots1-24typee&m-wink-start
!
interfaceFastEthernet3/0
ipaddress172.18.200.36255.255.255.0
speed10
half-duplex
noshut
iprsvpbandwidth75007500
!
voice-port2/0:0
timinghookflash-in1500
!
callapplicationvoicesample_RLTtftp://rtplab-tftp1/liszt/dec18/sample_RLT.tcl
callapplicationvoicesample_RLTuid-len4
callapplicationvoicesample_RLTlanguage1en
callapplicationvoicesample_RLTset-locationen0tftp://rtplab-tftp1/liszt/TCLware_1_2_2/prompts/en/
!
dial-peervoice2voip
applicationsample_rlt
destination-pattern8183821111
sessionprotocolsipv2
sessiontargetipv4:172.18.200.24
codecg711ulaw
!
dial-peervoice3pots
destination-pattern7173721111
direct-inward-dial
port2/0:0
prefix7173721111
!
dial-peervoice3621111voip
applicationsample_rlt
destination-pattern6163621111
sessionprotocolsipv2
sessiontargetsip-server
codecg711ulaw
!
sip-ua
retrybye1
retryrefer3
timersnotify400
timersrefer567
nooli
sip-serveripv4:172.18.200.21
!
linecon0
lineaux0
linevty04
login
!
end
RecipientGatewayConfigurationExample
Router#showrunning-config
Buildingconfiguration...
Currentconfiguration:2791bytes
!
version12.2
serviceconfig
noservicesingle-slot-reload-enable
noservicepad
servicetimestampsdebuguptime
servicetimestampsloguptime
noservicepassword-encryption
serviceinternal
serviceudp-small-servers
!
interfaceFastEthernet2/0
ipaddress172.18.200.24255.255.255.0
duplexauto
noshut
speed10
iprsvpbandwidth75007500
!
voice-port1/1/1
nosupervisorydisconnectlcfo
!
dial-peervoice1pots
applicationsession
destination-pattern8183821111
port1/1/1
!
dial-peervoice3voip
applicationsession
destination-pattern7173721111
sessionprotocolsipv2
sessiontargetipv4:172.18.200.36
codecg711ulaw
!
dial-peervoice4voip
applicationsession
destination-pattern6163621111
sessionprotocolsipv2
sessiontargetipv4:172.18.200.33
codecg711ulaw
!
gateway
!
sip-ua
!
linecon0
lineaux0
linevty04
login
!
end
Final-RecipientConfigurationExample
Router#showrunning-config
!
version12.2
noparsercache
servicetimestampsdebuguptime
servicetimestampsloguptime
noservicepassword-encryption
serviceinternal
!
nologgingbuffered
!
clocktimezoneGMT0
aaanew-model
!
!
aaaauthenticationloginh323groupradius
aaaauthorizationexech323groupradius
aaaaccountingconnectionh323start-stopgroupradius
aaasession-idcommon
ipsubnet-zero
iptcppath-mtu-discovery
!
!
ipdomainnamecisco.com
ipdhcpsmart-relay
!
!
voiceclasscodec1
codecpreference2g711alaw
codecpreference3g711ulaw
codecpreference5g726r16
codecpreference6g726r24
codecpreference7g726r32
codecpreference8g723ar53
codecpreference9g723ar63
codecpreference10g729r8
!
!
interfaceEthernet0/0
ipaddress172.18.200.33255.255.255.0
noshut
half-duplex
iprsvpbandwidth75007500
!
voice-port1/1/1
nosupervisorydisconnectlcfo
!
voice-port1/0/1
!
voice-port1/1/0
!
voice-port1/1/1
!
dial-peervoice1pots
applicationsession
destination-pattern6163621111
port1/1/1
!
ipclassless
noiphttpserver
ippimbidir-enable
!
!
gateway
!
sip-ua
!
rtrresponder
!
linecon0
exec-timeout00
lineaux0
linevty04
passwordww
linevty515
!
!
end
AdditionalReferences
ForadditionalinformationrelatedtotheSIPCallTransferandCallForwardingSupplementaryServicesfeature,refertothefollowingreferences:•
•
•
•
•
RelatedDocuments
RelatedTopic | DocumentTitle |
---|---|
CiscoSIPFunctionality | SessionInitiationProtocolGatewayCallFlows,Release12.2(4)T |
CiscoIOSReferences | |
CiscoIOSTelephony | |
CiscoVoiceXML | |
CiscoTCLIVRAPI |
Standards
Standards | Title |
---|---|
ITU-TH.450.2 | CalltransfersupplementaryserviceforH.323 |
ITU-TH.450.3 | CalldiversionsupplementaryserviceforH.323 |
MIBs
MIBs | MIBsLink |
---|---|
• CISCO-SIP-UA-MIB | ToobtainlistsofsupportedMIBsbyplatformandCiscoIOSrelease,andtodownloadMIBmodules,gototheCiscoMIBwebsiteonCisco.comatthefollowingURL: |
IfCiscoMIBLocatordoesnotsupporttheMIBinformationthatyouneed,youcanalsoobtainalistofsupportedMIBsanddownloadMIBsfromtheCiscoMIBspageatthefollowingURL:
ToaccessCiscoMIBLocator,youmusthaveanaccountonCisco.com.Ifyouhaveforgottenorlostyouraccountinformation,sendablanke-mailtocco-locksmith@cisco.com.Anautomaticcheckwillverifythatyoure-mailaddressisregisteredwithCisco.com.Ifthecheckissuccessful,accountdetailswithanewrandompasswordwillbee-mailedtoyou.QualifieduserscanestablishanaccountonCisco.combyfollowingthedirectionsfoundatthisURL:
RFCs
RFCs | Title |
---|---|
RFC2543 |
TechnicalAssistance
Description | Link |
---|---|
TechnicalAssistanceCenter(TAC)homepage,containing30,000pagesofsearchabletechnicalcontent,includinglinkstoproducts,technologies,solutions,technicaltips,tools,andlotsmore.RegisteredCisco.comuserscanloginfromthispagetoaccessevenmorecontent. |
CommandReference
Thissectiondocumentsnewandmodifiedcommands.AllothercommandsusedwiththisfeaturearedocumentedintheCiscoIOSRelease12.2commandreferencepublications.NewCommands
•
•
ModifiedCommands
•
•
•
retryrefer
ToconfigurethenumberoftimesthattheReferrequestisretransmitted,usetheretryrefercommandinSIPuser-agentconfigurationmode.Toresettothedefault,usethenoformofthiscommand.retryrefernumber
noretryrefer
SyntaxDescription
number | NumberofReferrequestretries.Rangeisfrom1to10.Defaultis10. |
Defaults
10retriesCommandModes
SIPuser-agentconfigurationCommandHistory
Release | Modification |
---|---|
12.2(11)YT | Thiscommandwasintroduced. |
UsageGuidelines
ASessionInitiationProtocol(SIP)Referrequestissentbytheoriginatinggatewaytothereceivinggatewayandinitiatescallforwardandcalltransfercapabilities.Whenconfiguringtheretryrefercommand,usethedefaultnumberof10whenpossible.Lowervaluessuchas1canleadtoanincreasedchanceofthemessagenotbeingreceivedbythereceivinggateway.
Examples
ThefollowingexampleconfiguresaReferrequesttoberetransmitted10times:Router(config)#sip-ua
Router(config-sip-ua)#retryrefer10
RelatedCommands
Command | Description |
---|---|
DisplaystheSIPretryattempts. | |
Displaysresponse,traffic,timer,andretrystatistics. |
showsip-uaretry
TodisplayretrystatisticsfortheSessionInitiationProtocol(SIP)useragent(UA),usetheshowsip-uaretrycommandinprivilegedEXECmode.showsip-uaretry
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.CommandModes
PrivilegedEXECCommandHistory
Release | Modification |
---|---|
12.1(3)T | Thiscommandwasintroduced. |
12.2(2)XB | Commandoutputwasenhancedtodisplaythefollowing:Reliableprovisionalresponses(PRACK/reliable1xx),Conditionsmet(COMET)responses,andNotifyresponses. |
12.2(2)XB1 | ThiscommandwasimplementedonCiscoAS5850universalgateways. |
12.2(8)T | ThiscommandwasintegratedintoCiscoIOSRelease12.2(8)T.ThiscommandisnotsupportedontheCiscoAS5300,CiscoAS5350,CiscoAS5400,andCiscoAS5850platformsinthisrelease. Forthepurposesofdisplay,thiscommandwasseparatedfromthegenericshowsip-uacommandfoundpreviouslyinthisreference. |
12.2(11)YT | ThiscommandwassupportedinCiscoIOSRelease12.2(11)YT.CommandoutputwasenhancedtodisplayReferresponses. |
UsageGuidelines
UsethiscommandtoverifySIPconfigurations.Examples
Thefollowingissampleoutputfromtheshowsip-uaretrycommand.Router#showsip-uaretry
SIPUARetryValues
inviteretrycount=6responseretrycount=1
byeretrycount=1cancelretrycount=1
prackretrycount=10cometretrycount=10
reliable1xxcount=6notifyretrycount=10
referretrycount=10
Field | Description |
---|---|
byeretrycount | NumberoftimesthataByerequestisretransmitted. |
cancelretrycount | NumberoftimesthataCancelrequestisretransmitted. |
cometretrycount | NumberoftimesthataCOMETrequestisretransmitted. |
inviteretrycount | NumberoftimesthatanInviterequestisretransmitted. |
notifyretrycount | NumberoftimesthataNotifymessageisretransmitted. |
prackretrycount | NumberoftimesthataPRACKrequestisretransmitted. |
referretrycount | NumberoftimesthataReferrequestisretransmitted. |
reliable1xxcount | NumberoftimesthataReliable1xxrequestisretransmitted. |
responseretrycount | NumberoftimesthataResponserequestisretransmitted. |
SIPUARetryValues | FieldheaderforSIPUAretryvalues. |
RelatedCommands
Command | Description |
---|---|
showsip-uastatistics | Displaysresponse,traffic,andretrySIPstatistics. |
showsip-uatimers | DisplaysthecurrentsettingsforSIPUAtimers. |
sip-ua | EnablestheSIPuser-agentconfigurationcommands. |
showsip-uastatistics
Todisplayresponse,traffic,andretrystatisticsfortheSessionInitiationProtocol(SIP)useragent(UA),usetheshowsip-uastatisticscommandinprivilegedEXECmode.showsip-uastatistics
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.CommandModes
PrivilegedEXECCommandHistory
Release | Modification |
---|---|
12.1(3)T | Thiscommandwasintroduced. |
12.2(2)XA | ThiscommandwasimplementedontheCiscoAS5400andCiscoAS5350. |
12.2(2)XB | Commandoutputwasenhancedtodisplaythefollowing:BadRequestcounter(400class)nowcountsMalformedViaentries,Reliableprovisionalresponses(PRACK/rel1xx),Conditionsmet(COMET),andNotifyresponses. |
12.2(2)XB1 | ThiscommandwasimplementedonCiscoAS5850universalgateways. |
12.2(8)T | ThiscommandwasintegratedintoCiscoIOSRelease12.2(8)T.ThiscommandisnotsupportedontheCiscoAS5300,CiscoAS5350,CiscoAS5400,andCiscoAS5850platformsinthisrelease. Forthepurposesofdisplay,thiscommandwasseparatedfromthegenericshowsip-uacommandfoundpreviouslyinthisreference. |
12.2(11)T | ThiscommandwassupportedinCiscoIOSRelease12.2(11)T.Commandoutputwasenhancedasfollows: • OkInfocounter(200)classcountsthenumberofsuccessfulresponsestoINFOrequests. • InfocountercountsthenumberofINFOmessagesreceivedandsent. • BadEventcounter(489response)countsresponsestoSUBSCRIBErequestswitheventtypesthatarenotunderstoodbytheserver. • OkSubscribecounter(200class)countsthenumberof200OKSIPmessagesreceivedandsentinresponsetoSubscribemessages. • Subscriberequestsindicatestotalrequestsreceivedandsent. • SDPapplicationstatistics. |
12.2(11)YT | ThiscommandwassupportedinCiscoIOSRelease12.2(11)YT.CommandoutputwasenhancedtodisplayReferresponses. |
UsageGuidelines
UsethiscommandtoverifySIPconfigurations.Examples
Thefollowingissampleoutputfromtheshowsip-uastatisticscommand:Router#showsip-uastatistics
SIPResponseStatistics(Inbound/Outbound)
Informational:
Trying0/0,Ringing0/0,
Forwarded0/0,Queued0/0,
Success:
OkInvite0/0,OkBye0/0,
OkCancel0/0,OkOptions0/0,
OkPrack0/0,OkPreconditionMet0/0
OkNotify0/0,202Accepted0/0
OkInfo0/0,OkSubscribe0/0
OKRefer1/0
Redirection(Inboundonly):
MultipleChoice0,MovedPermanently0,
MovedTemporarily0,SeeOther0,
UseProxy0,AlternateService0
ClientError:
BadRequest0/0,Unauthorized0/0,
PaymentRequired0/0,Forbidden0/0,
NotFound0/0,MethodNotAllowed0/0,
NotAcceptable0/0,ProxyAuthReqd0/0,
ReqTimeout0/0,Conflict0/0,Gone0/0,
LengthRequired0/0,ReqEntityTooLarge0/0,
ReqURITooLarge0/0,UnsupportedMediaType0/0,
BadExtension0/0,TempNotAvailable0/0,
CallLegNonExistent0/0,LoopDetected0/0,
TooManyHops0/0,AddrIncomplete0/0,
Ambiguous0/0,BusyHere0/0,
RequestCancel0/0,NotAcceptableMedia0/0
BadEvent0/0
ServerError:
InternalError0/0,NotImplemented0/0,
BadGateway0/0,ServiceUnavail0/0,
GatewayTimeout0/0,BadSipVer0/0,
PreCondFailure0/0
GlobalFailure:
BusyEverywhere0/0,Decline0/0,
NotExistAnywhere0/0,NotAcceptable0/0
SIPTotalTrafficStatistics(Inbound/Outbound)
Invite0/0,Ack0/0,Bye0/0,
Cancel0/0,Options0/0,
Prack0/0,Comet0/0
Notify0/0,Refer0/0
Info0/0
RetryStatistics
Invite0,Bye0,Cancel0,Response0,
Prack0,Comet0,Reliable1xx0,Notify0
Refer0
SDPapplicationstatistics:
Parses:4,Builds2
Invalidtokenorder:0,Invalidparam:0
NotSDPdesc:0,Noresource:0
Theshowsip-uastatisticscommandgeneratesoutput,listedin
•
1xx:Informational,indicatescallprogress.
•
2xx:Success,indicatessuccessfulreceiptorcompletionofarequest.
•
3xx:Redirection,thataredirectserverhasreturnedpossiblelocations.
•
4xx:Clienterror,indicatesthatarequestcannotbefulfilledasitwassubmitted.
•
5xx:Servererror,indicatesthatarequesthasfailedduetoanerrorbytheserver.Itmayberetriedatanotherserver.
•
6xx:Globalfailure,indicatesthatarequesthasfailedandshouldnotbetriedagainatanyserver.
Field | Description |
---|---|
Note Foreachfield,thestandardRFC2543SIPresponsenumberandmessageareshown. | |
Ack0/0 | Aconfirmedfinalresponsereceivedorsent. |
Accepted0/0 | 202IndicatesasuccessfulresponsetoaReferrequestreceivedorsent. |
AddrIncomplete0/0 | 484Addresssuppliedisincomplete. |
AlternateService0 | 380Unsuccessfulcall;however,analternateserviceisavailable. |
Ambiguous0/0 | 485Addresssuppliedisambiguous. |
BadEvent0/0 | 489BadEventresponseindicatesaSUBSCRIBErequestthathasaneventtypethattheservercouldnotunderstand. |
BadExtension0/0 | 420ServercouldnotunderstandtheprotocolextensionintheRequireheader. |
BadGateway0/0 | 502Networkisoutoforder. |
BadRequest | 400BadRequest(includesthemalformedViaheader). |
BadSipVer0/0 | 505RequestedSIPversionisnotsupported. |
BusyEverywhere0/0 | 600Calledpartyisbusy. |
BusyHere0/0 | 486Calledpartyisbusy. |
Bye0 | NumberoftimesthataByerequestisretransmittedtotheotheruseragent. |
Bye0/0 | Terminatedthesession. |
CallLegNonExistent0/0 | 481Serverisignoringtherequest,whichwaseitheraByerequestandtherewasnotamatchinglegIDoraCancelrequestandtherewasnotamatchingtransaction. |
Cancel0 | NumberoftimesthataCancelrequestisretransmittedtotheotheruseragent. |
Cancel0/0 | Terminatedthependingrequest. |
Comet0 | NumberoftimesthataCOMETrequestisretransmittedtotheotheruseragent. |
Comet0/0 | Conditionshavebeenmet. |
Conflict0/0 | 409Temporaryfailure. |
Decline0/0 | 603Callrejected. |
Forbidden0/0 | 403IPserverhastherequest,butcannotprovideservice. |
Forwarded0/0 | 181Callhasbeenforwarded. |
GatewayTimeout0/0 | 504Serverorgatewaydidnotreceiveatimelyresponsefromanotherserver(suchasalocationserver). |
Gone0/0 | 410Resourceisnolongeravailableattheserver,andnoforwardingaddressisknown. |
Info0/0 | IndicatesthenumberoftimesthatanINFOrequestissentandreceived. |
InternalError0/0 | 500Serverorgatewayencounteredanunexpectederrorthatpreventeditfromprocessingtherequest. |
Invite0 | NumberoftimesthatanInviterequestisretransmittedtotheotheruseragent. |
Invite0/0 | Initiatedacall. |
LengthRequired0/0 | 411Acontentlengthisrequired. |
LoopDetected0/0 | 482Aloop—serverreceivedarequestthatincludeditselfinthepath. |
MethodNotAllowed0/0 | 405Methodspecifiedintherequestisnotallowed. |
MovedPermanently0 | 301Userisnolongeravailableatthislocation. |
MovedTemporarily0 | 302Useristemporarilyunavailable. |
MultipleChoice0 | 300Addressresolvestomorethanonelocation. |
NotAcceptable0/0 | 406or606Callwascontacted,butsomeaspectofthesessiondescriptionwasunacceptable. |
NotAcceptableMedia0/0 | 406Callwascontacted,butsomeaspectofthesessiondescriptionwasunacceptable. |
NotExistAnywhere0/0 | 604Serverhasauthoritativeinformationthatthecalledpartydoesnotexistinthenetwork. |
NotFound0/0 | 404Calledpartydoesnotexistinthespecifieddomain. |
Notify0 | NumberoftimesthataNotifyisretransmittedtotheotheruseragent. |
Notify0/0 | NumberofNotifymessagesreceivedorsent. |
NotImplemented0/0 | 501Serviceoroptionnotimplementedintheserverorgateway. |
OkBye0/0 | 200AsuccessfulresponsetoaByerequest. |
OkCancel0/0 | 200AsuccessfulresponsetoaCancelrequest. |
OkInfo | 200AsuccessfulresponsetoanINFOrequest. |
OkInvite0/0 | 200AsuccessfulresponsetoanInviterequest. |
OkNotify0/0 | 200AsuccessfulresponsetoaNotifyrequest. |
OkOptions0/0 | 200AsuccessfulresponsetoanOptionsrequest. |
OkPrack0/0 | 200AsuccessfulresponsetoaPRACKrequest. |
OkPreconditionMet0/0 | 200AsuccessfulresponsetoaPreconditionMetrequest. |
OkRefer0/0 | 200AsuccessfulresponsetoaReferrequest. |
OkSubscribe0/0 | 200AsuccessfulresponsetoaSUBSCRIBErequest. |
Options0/0 | Querythereceivingorsendingserverastoitscapabilities. |
PaymentRequired0/0 | 402Paymentisrequiredtocompletethecall. |
Prack0 | NumberoftimesthataPRACKrequestisretransmittedtotheotheruseragent. |
Prack0/0 | Provisionalresponsereceivedorsent. |
PreCondFailure0/0 | 580Sessioncouldnotbeestablishedbecauseoffailuretomeetrequiredpreconditions. |
ProxyAuthReqd0/0 | 407Rejectedforproxyauthentication. |
Queued0/0 | 182Untilthecalledpartyisavailable,themessageisqueued. |
Refer0 | NumberoftimestheReferrequestisretransmittedtotheotheruseragent. |
Refer0/0 | NumberofReferrequestsreceivedorsent. |
ReqEntityTooLarge0/0 | 413Serverrefusestoprocesstherequestbecausetherequestislargerthanisacceptable. |
ReqTimeout0/0 | 408ServercouldnotproducearesponsebeforetheExpirestimeout. |
RequestCancel0/0 | Requesthasbeencanceled. |
ReqURITooLarge0/0 | 414Serverrefusestoprocess,becausetheURI(URL)requestislargerthanisacceptable. |
Response0 | NumberofResponseretries. |
RetryStatistics | Oneofthethreecategoriesofresponsestatistics. |
Ringing0/0 | 180Calledpartyhasbeenlocatedandisbeingnotifiedofthecall. |
SeeOther0 | 303Transfertoanotheraddress. |
ServiceUnavail0/0 | 503Serviceoptionisnotavailablebecauseofanoverloadormaintenanceproblem. |
SessionProgress0/0 | 183Indicatesinbandalerting. |
SIPResponseStatistics(Inbound/Outbound) | Oneofthethreecategoriesofresponsestatistics. |
SIPTotalTrafficStatistics(Inbound/Outbound) | Oneofthethreecategoriesofresponsestatistics. |
Subscribe0/0 | IndicatesthenumberofSubscriberequestsreceivedorsent. |
TempNotAvailable0/0 | 480Calledpartydidnotrespond. |
TooManyHops0/0 | 483ServerreceivedarequestthatrequiredmorehopsthanisallowedbytheMax-Forwardheader. |
Trying0/0 | 100Actionisbeingtakenwithnoresolution. |
Unauthorized0/0 | 401Requestrequiresuserauthentication. |
UnsupportedMediaType0/0 | 415Serverrefusestoprocessarequestbecausetheserviceoptionisnotavailableonthedestinationendpoint. |
UseProxy0 | 305Callermustuseaproxytocontactcalledparty. |
RelatedCommands
Command | Description |
---|---|
showsip-uaretry | DisplaysSIPretrystatistics. |
showsip-uastatus | DisplaysSIPUAstatus. |
showsip-uatimers | DisplaysthecurrentsettingsforSIPUAtimers. |
sip-ua | EnablestheSIPuser-agentconfigurationcommands. |
showsip-uatimers
TodisplaythecurrentsettingsfortheSessionInitiationProtocol(SIP)user-agent(UA)timers,usetheshowsip-uatimerscommandinprivilegedEXECmode.showsip-uatimers
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.CommandModes
PrivilegedEXECCommandHistory
Release | Modification |
---|---|
12.1(1)T | ThiscommandwasintroducedonCisco2600andCisco3600seriesroutersandCiscoAS5300universalaccessservers. |
12.1(3)T | Theoutputofthiscommandwaschangedtoreflectthechangesinthetimerscommand. |
12.2(2)XA | ThiscommandwasimplementedontheCiscoAS5400andCiscoAS5350. |
12.2(2)XB | Commandoutputwasenhancedtodisplaythefollowing:Reliableprovisionalresponses(PRACK/rel1xx),Conditionsmet(COMET),andNotifyresponses. |
12.2(2)XB1 | ThiscommandwasimplementedonCiscoAS5850universalgateways. |
12.2(8)T | ThiscommandwasintegratedintoCiscoIOSRelease12.2(8)T.ThiscommandisnotsupportedontheCiscoAS5300,CiscoAS5350,CiscoAS5400,andCiscoAS5850platformsinthisrelease. Forthepurposesofdisplay,thiscommandwasseparatedfromthegenericshowsip-uacommandfoundpreviouslyinthisreference. |
12.2(11)T | ThiscommandwassupportedinCiscoIOSRelease12.2(11)T. |
12.2(11)YT | CommandoutputwasenhancedtodisplayReferresponses. |
UsageGuidelines
UsethiscommandtoverifySIPconfigurations.Examples
Thefollowingissampleoutputfromtheshowsip-uatimerscommand:Router#showsip-uatimers
SIPUATimerValues(millisecs)
trying500,expires150000,connect500,disconnect500
comet500,prack500,rel1xx500,notify500
refer300
Field | Description |
---|---|
SIPUATimerValues(millisecs) | SIPUAtimerstatus. |
trying | TimetowaitbeforeaTryingmessageisretransmitted. |
expires | TimetowaitbeforeanExpiresmessageisretransmitted. |
connect | TimetowaitbeforeaConnectmessageisretransmitted. |
disconnect | TimetowaitbeforeaDisconnectmessageisretransmitted. |
comet | TimetowaitbeforeaCOMETmessageisretransmitted. |
prack | TimetowaitbeforeaPRACKacknowledgmentisretransmitted. |
rel1xx | TimetowaitbeforeaRel1xxresponseisretransmitted. |
notify | TimetowaitbeforeaNotifyresponseisretransmitted. |
refer | TimetowaitbeforeaRetryrequestisretransmitted. |
RelatedCommands
Command | Description |
---|---|
showsip-uaretry | DisplaysSIPretrystatistics. |
showsip-uastatistics | Displaysresponse,traffic,andretrySIPstatistics. |
sip-ua | EnablestheSIPuser-agentconfigurationcommands. |
timersrefer
TosethowlongtheSessionInitiationProtocol(SIP)useragent(UA)waitsbeforeretransmittingaReferrequest,usethetimersrefercommandinSIPuser-agentconfigurationmode.Toresettothedefault,usethenoformofthiscommand.timersrefertime
notimersrefer
SyntaxDescription
time | Waitingtime,inmilliseconds.Rangeisfrom100to1000.Defaultis500. |
Defaults
500millisecondsCommandModes
SIPuser-agentconfigurationCommandHistory
Release | Modification |
---|---|
12.2(11)YT | Thiscommandwasintroduced. |
UsageGuidelines
ASIPReferrequestissentbytheoriginatinggatewaytothereceivinggatewayandinitiatescallforwardandcalltransfercapabilities.Examples
Thefollowingexamplesetsretransmissiontimeto500milliseconds:Router(config)#sip-ua
Router(config-sip-ua)#timersrefer500
RelatedCommands
Command | Description |
---|---|
showsip-uastatistics | Displaysresponse,traffic,timer,andretrystatistics. |
showsip-uatimers | DisplaysthecurrentsettingsforSIPUAtimers. |
Glossary
Call-ID—Ageneralheaderfieldthatuniquelyidentifiesaparticularinvitationorallregistrationsofaparticularclient.callleg—Alogicalconnectionbetweentherouterandanotherendpoint.
CAS—channel-associatedsignaling.
CSPS—CiscoSIPproxyserver.
e-phones—IPphonesthatarenotconfiguredonthegateway.
final-recipient—Theuseragentintroducedintoacallwiththerecipient.
gateway—AgatewayallowsSIPorH.323terminalstocommunicatewithterminalsconfiguredtootherprotocolsbyconvertingprotocols.Agatewayisthepointwhereacircuit-switchedcallisencodedandrepackagedintoIPpackets.
Invite—ASIPmessagethatinitiatesaSIPsession.Itindicatesthatauserisinvitedtoparticipate,providesasessiondescription,indicatesthetypeofmedia,andprovidesinsightregardingthecapabilitiesofthecalledandcallingparties.
originator—TheuseragentthatinitiatesthetransferorReferrequestwiththerecipient.
proxy—ASIPUACorUASthatforwardsrequestsandresponsesonbehalfofanotherSIPUACorUAS.
PSTN—publicswitchedtelephonenetwork.PSTNreferstothelocaltelephonecompany.
recipient—TheuseragentthatreceivestheReferrequestfromtheoriginatorandistransferredtothefinal-recipient.
RLT—ReleaseLinkTrunking.ThetraditionalPSTNsignalingusedbyPSTNapplicationstoinitiatecalltransferoveraCAStrunk.
RTP—Real-TimeTransportProtocol.Theprotocolprovidesend-to-endnetworktransportfunctionsforapplicationsthattransmitreal-timedataandservicessuchaspayloadtypeidentification,sequencenumbering,time-stamping,anddeliverymonitoring.AnetworkprotocolusedtocarrypacketizedaudioandvideotrafficoveranIPnetwork.
SIP—SessionInitiationProtocol.Anapplication-layerprotocoloriginallydevelopedbytheMultipartyMultimediaSessionControl(MMUSIC)workinggroupoftheInternetEngineeringTaskForce(IETF).TheirgoalwastoequipplatformstosignalthesetupofvoiceandmultimediacallsoverIPnetworks.SIPfeaturesarecompliantwithIETFRFC2543,publishedinMarch1999.
SIPURL—SessionInitiationProtocolUniformResourceLocator.UsedinSIPmessagestoindicatetheoriginator,recipient,anddestinationoftheSIPrequest.Takesthebasicformofuser@host,whereuserisanameortelephonenumber,andhostisadomainnameornetworkaddress.
TCLIVR—ToolCommandLanguage(TCL)InteractiveVoiceResponse(IVR).
TELURL—TelephoneUniformResourceLocator.Describesvoicecallconnectionstoaterminal.CanalsobeanyconnectionthroughavoicemessagingsystemoraservicethatcanbeoperatedusingDTMFtones.Takesthebasicformoftel:telephone-subscriber-number,wheretelindicatesaURLandrequeststhelocalentitytoplaceavoicecall,andtelephone-subscriber-numberisthenumbertoreceivethecall.
UA—useragent.
UAC—useragentclient.AclientapplicationthatinitiatesaSIPrequest.
UAS—useragentserver(oruseragent).AserverapplicationthatcontactstheuserwhenaSIPrequestisreceivedthenreturnsaresponseonbehalfoftheuser.Theresponseaccepts,rejects,orredirectstherequest.
Posted:TueMar207:17:54PST2004
AllcontentsareCopyright©1992--2004CiscoSystems,Inc.Allrightsreserved.
相关文章推荐
- SIP Call Transfer and Call Forwarding Supplementary Services(cisco)
- 【】SIP REFER for Call Transfer
- Trixbox SIP trunk to Cisco Unified Call Manager 7.X
- How to Call WCF Services Synchronously and Asynchronously
- Internet Communications Using SIP: Delivering VoIP and Multimedia Services with Session Initiation P
- libeXosip2(3) -- SIP messages and call control API
- How to Call WCF Services Synchronously and Asynchronously
- 7.11 Call forwarding number andconditions +CCFC
- Performance Results for OpenSER and SIP Express Router
- SIP 中的Dialog,call,session 和 transaction
- How to call SQL SP in WCF ria services.
- About data conversion and transfer (ZZ) 数据转化和转移
- Installing Reporting Services, Analysis Services and Enterprise Portal for AX 2009
- How to change service accounts and service account passwords in SharePoint Server 2007 and in Windows SharePoint Services 3.0(Se
- cisco and fortigate OSPF configure
- SIP Call with Proxy Server
- Open Source SIP Stack and Media Links
- Spring之集成之Remoting and web services using Spring
- SOA and Web services 新手入门
- Call web service using HttpWebRequest and serialization