Cisco EasyQoS Application for APIC-EM Release Notes, Release 1.6.0.x FirstPublished:2017-10-23 Cisco EasyQoS Application for APIC-EM Release Notes ThisdocumentdescribestheCiscoEasyQoSfeatures,limitations,andbugsforrelease1.6.0.x. AlongwithCiscoEasyQoS,CiscoAPIC-EMsupportsthefollowingadditionalapplications: •CiscoNetworkVisibility •CiscoPathTrace •CiscoActiveAdvisor •CiscoIntegrityVerification •CiscoRemoteTroubleshooter •CiscoWideAreaBonjour •CiscoIWAN •CiscoNetworkPnP ForinformationabouttheCiscoAPIC-EMcontrollerinfrastructure(systemrequirements,security,licensing, supportedmulti-hostconfigurations,andsoon)andtheotherCiscoAPIC-EMapplications,seetheir correspondingreleasenotesatthefollowingURL: http://www.cisco.com/c/en/us/support/cloud-systems-management/one-enterprise-network-controller/ products-release-notes-list.html What’s New in Cisco EasyQoS for APIC-EM, Release 1.6.0.x TheCiscoAPIC-EMsoftwarereleaseprovidesthefollowingnewCiscoEasyQoSfeaturesandfunctionality: •NewCiscoEasyQoScustomqueuingfeature.Customqueuingpoliciescannowbeappliedtobothingress andegressqueuingfor2P6Q4Tingressandegressqueuing(Twostrict-priorityqueues,sixstandard queues,fourthresholds,eachconfigurableaseitherWRED-droportail-drop). •UpdatedEasyQoSconfigurationthatisappliedtoCiscoCatalyst3650and3850switchesrunningthe followingsoftwareversions: •CiscoIOSXE3.6.6andhigher •CiscoIOSXE3.7.5andhigher CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 1 CiscoEasyQoSSupportedPlatformsandSoftwareRequirements ThisupdatedEasyQoSconfigurationissuesthequeue-softmax-multiplier1200commandonthe switches.Thiscommandprovidesasignificantincreaseinbufferingcapacityforreal-timequeues(PQ2), aswellasasignificantincreaseinbufferingcapacityfornon-real-timequeues. •CiscoEasyQoSsupportforCisco4221SeriesIntegratedServicesRouters(ISR). •NewFastlaneQoSfeature—YoucannowenableordisableFastlaneQoSfortheEasyQoSapplication usingthecontroller'sGUI. Fordetailedinformationabouttheabovenewfeaturesandfunctionality,seetheCiscoEasyQoSApplication forAPIC-EMUserGuide.Fordetailedinformationaboutthenewplatformsupport,seeCiscoEasyQoS ApplicationforAPIC-EMSupportedPlatforms. Cisco EasyQoS Supported Platforms and Software Requirements ForinformationaboutthenetworkdevicesandsoftwareversionssupportedforthisreleasebytheEasyQoS app,seehttp://www.cisco.com/c/en/us/support/cloud-systems-management/one-enterprise-network-controller/ products-device-support-tables-list.html Installing or Upgrading EasyQoS TheEasyQoSimageisbuiltintotheAPIC-EMcontrollerimage.WhenyouinstallorupgradeCiscoAPIC-EM, theCiscoEasyQoSapplicationisinstalledorupgradedaswell. AfterinstallingorupgradingtheAPIC-EMsoftware,youcanbegintouseEasyQoSbyenablingtheapplication. Forinformationabouthowtoenableapplications,seetheCiscoApplicationPolicyInfrastructureController EnterpriseModuleAdministrationGuide.Foranyofthefollowinginformation,seethesesources: Table1:InformationSourcesforInstallingorUpgradingEasyQoS Information Source InstallingAPIC-EMorEasyQoS CiscoApplicationPolicyInfrastructureController EnterpriseModuleInstallationGuide UpgradingAPIC-EMorEasyQoS CiscoApplicationPolicyInfrastructureController EnterpriseModuleUpgradeGuide ObtainingbuginformationaboutAPIC-EM CiscoApplicationPolicyInfrastructureController EnterpriseModuleReleaseNotes Caveats OpenCaveats Thefollowingtableliststheopencaveatsforthisrelease. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 2 OpenCaveats CaveatIDNumber Headline CSCvg17773 Thereisabehaviordifferencewhenyoudisable FastlaneafterenablingitusingEasyQoS.The followingisprovidedasanexampleofthisissue. AftercreatingawirelesspolicyusingEasyQoSwith Fastlaneenabledandthatwirelesspolicyispushed totheWLC,thequalityofserviceis'Platinum'as expected.Later,Fastlaneisdisabledusingthe controller'sGUI.Whenyouthenreapplythepolicy, logintotheWLC,andrunthewlancheckqos command,thequalityofserviceis'Silver'andFastlane isdisabled.Thisisincorrect,withFastlanedisabled thequalityofserviceshouldstillbe'Platinum'. Workaround: Thereisnoworkaroundatthistime. CSCve50191 TheDSCPcustomizationisnotappliedforqueuing policyonMLSandNexus7000QoSplatforms. Workaround: Thereisnoworkaroundatthistime. CSCve16525 IncorrectconfigurationsenttoCiscoCatalyst6000 switchACCESSrolewithport-channel. Workaround: Thereisnoworkaroundatthistime. CSCve46220 Whenrollbackandre-applyaredonesimultaneously policyconfigurationdoesnotcomplete. Workaround: Onapolicyre-apply,thepolicyconfigurationwillbe completed. CSCve51471 Restorefeaturedoesnotworkforqueuingpolicywith MLSQoSplatforms. ForMLSQoSplatforms,thequeuingpolicyis configureddirectlyontheinterface.EasyQoSmay changethepolicy,sothereisnoprevious configurationsavedontheswitchplatform.Therefore, clickingontheRestorebuttonwillnotrestorethe pre-EasyQoSqueuingpolicyfortheseplatforms.Note thattheingressclassificationandmarkingpolicywill berestored,becausetheyuseservice-policy definitionsappliedtotheinterfaces. Workaround: Thereisnoworkaroundatthistime. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 3 OpenCaveats CaveatIDNumber Headline CSCuy37443 TheQoSstatisticsoutput"queueBandwidthbps"shows NAwhenconfiguredwithseveralcommands. OnanISRrouter,configurethepolicy-mapwiththe bandwidthandprioritycommands.Startaflow analysiswithQoSstatisticscollectionrequestwith theISRrouterinthepath.Thishappenswhen configuredwithfollowingcommands: •bandwidthpercent •prioritypercent •priority(strictpriority) Workaround: Thereisnoworkaroundatthistime. CSCuy52361 TrafficwillbedisruptedwhenapplyinganEasyQoS policyonaCiscoCatalyst4500seriesswitchthatis usingportchannels. Workaround: WhenconfiguringEasyQoSonaCiscoCatalyst4500 seriesswitchusingportchannels,werecommendthat youapplytheEasyQoSpolicyduringamaintenance windoworbychangingtheroutingmetrics(either EIGRPorOSPF)toremovetrafficoffofthemember linksduringtheapplicationofthepolicy. CSCva39044 WhenaCisco2500SeriesWirelessController(WLC) isupgradedfromversion7.4.100.0orlowertoany versionthatEasyQossupports,EasyQoscanpusha policytotheWLC,butitcannotattachtheWLAN. Inthisscenario,EasyQosshouldnotpushthepolicy totheWLC.Instead,itshoulddisplayamessageon theEasyQosGUIsimilartothefollowing: "AVCisnotsupportedwiththecurrentbootloader version(1.0.16).Pleaseupgradethebootloaderto version1.0.18orFieldUpgradablesoftwareversion 1.8.0.0orhigher.SeeCiscodocumentationfor informationaboutFieldUpgradablesoftware.” ThisissueisspecifictotheCisco2500SeriesWireless Controller(WLC). Workaround: Upgradethewirelesscontrollerbootloadertoversion 1.0.18orhigher,performaninventory synchronization,andreapplythepolicy. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 4 OpenCaveats CaveatIDNumber Headline CSCvb58195 AnapplicationmaybeomittedfromtheACLdueto limitedTCAMresources,whilehigherrank applicationsareincludedintheACL.Whenediting advancedsettingsforsuchNBARapplicationsin EasyQoSPolicieswindow(e.g.changeto bi-directionaloraddconsumerapplication),itwill stillbeomittedfromtheACLincaseoflimited TCAMresources. Workaround: Marktheeditedapplicationas"Favorite"inthe EasyQoSApplicationRegistryscreen.Thiswillcause theapplicationtobehighlyrankedandincludedin theACL. CSCvb49220 IntheEasyQoSapplicationpage,theunassignedcount includesalldevicesthatauserhasaccessto;although, onlydevicesforwhichtheuserisanadminare actuallydisplayed. Workaround: Thereisnoworkaroundatthistime. CSCvc79652 WhenthedestinationportandIPaddressarenot providedinaninputflow,EasyQoSlooksupthis informationinthecustomapplicationprofileand shoulddisplayitintheDynamicQoStab.However, EasyQoSdoesnotdisplayit. Workaround: Thereisnoworkaroundatthistime. CSCvc81320 EasyQoSreportsanerrormessagethattheQoS configurationfailedduetoaninvalidcommandfor CiscoNexusdevices. IfaCiscoNexusdevicehasvirtualdevicecontexts (VDCs)configured,andyoutrytoapplyaQoSpolicy configurationwiththenon-default/non-adminVDC, EasyQoSfailstoconfigurethedeviceandreportsan error. Workaround Toavoidthisissue,discoverandperformEasyQoS operationsthroughthedefault/adminVDC. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 5 ResolvedCaveats CaveatIDNumber Headline CSCvc95074 Whentheconfigurationforacustomapplicationis removedfromadevice,EasyQoSfailstoremoveall oftheconfiguration.TheremarksandACLcommands arenotbeingremoved. Workaround: Thereisnoworkaroundatthistime. CSCvd13950 Generatingaconfigurationforpreviewtakesmore thanaminuteforCiscoCatalyst3850stackable switchesthatareconfiguredtofullscalelimits. Workaround: Thereisnoworkaroundatthistime. CSCvf98731 AfterdeletingapolicyinanEasyQoSscopeandthen creatingandapplyingthesamepolicyinthatscope, differentconfigurationsaregeneratedforthepolicy ontheCiscoCatalyst6500switch. Workaround: WhenQoSpolicyisdeletedfromaCiscoCatalyst 6500switch,thedeviceshouldberesynchronized beforeanewQoSpolicyisapplied.Thiscanbe accomplishedthroughamanualresyncfromthe DeviceInventoryscreen,orbywaitinguntilafterthe nextpollinginterval.Theresyncwillensurethat APIC-EMcontrollerandEasyQoShasthecurrent configurationofthedevicebeforeapplyingthenew QoSpolicy. ResolvedCaveats Thefollowingtableliststheresolvedcaveatsforthisrelease. Note Foralistofcaveatsresolvedinanearliersoftwarerelease,seetheCiscoAPIC-EMreleasenotesforthe specificrelease. BugIDNumber Headline CSCvg13009 EasyQoSfailstopushmatchingpoliciestodevices withcustomapplicationqueuingpoliciesconfigured. Thisoccursinbrownfielddeployments. CSCve53844 Thepolicyscopesicondoesnotcorrectlyreflectthe policyconfigurationstatus. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 6 UsingtheBugSearchTool BugIDNumber Headline CSCve59932 The'plim'QoSconfigurationsarepushedtotheCisco CloudServicesRouter1000v. CSCvf35118 ForCiscoCatalyst6880switches,whenyoutryto excludeinterfacestheinterfacelistdoesnotloadin GUI. CSCvf36473 CustomQueuingPoliciesshouldbeappliedtoboth ingressandegressqueuingfor2P4Q6T. CSCve98296 AMonitoringandThresholdsensitivityfactorhigher than50mayresultinanegativehealthscoreforsevere packetdropsinsteadofazerohealthscore. CSCve59932 PlimqosconfigurationsarepushedtoCSRv1000. CSCve53844 Policyscopesiconnotreflectingpolicyconfiguration statuscorrectlyforEasyQoS. Using the Bug Search Tool UsetheBugSearchtooltosearchforaspecificbugortosearchforallbugsinthisrelease. Procedure Step1 Gotohttp://tools.cisco.com/bugsearch. Step2 AttheLogInscreen,enteryourregisteredCisco.comusernameandpassword;then,clickLogIn.TheBug Searchpageopens. Note IfyoudonothaveaCisco.comusernameandpassword,youcanregisterforthemat http://tools.cisco.com/RPF/register/register.do. Step3 Tosearchforaspecificbug,enterthebugIDintheSearchForfieldandpressReturn. Step4 Tosearchforbugsinthecurrentrelease: a) IntheSearchForfield,enterAPIC-EMandpressReturn.(Leavetheotherfieldsempty.) b) Whenthesearchresultsaredisplayed,usethefiltertoolstofindthetypesofbugsyouarelookingfor. Youcansearchforbugsbymodifieddate,status,severity,andsoforth. Note Toexporttheresultstoaspreadsheet,clicktheExportResultstoExcellink. EasyQoS Limitations and Restrictions TheEasyQoSapplicationhasthefollowinglimitationsandrestrictions. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 7 EasyQoSLimitationsandRestrictions Note RefertotheotherCiscoAPIC-EMapplicationreleasenotesorCiscoAPIC-EMcontrollerreleasenotesfor informationaboutanyotherapplicationorinfrastructure-specificissues. •ThePostgresservicefortheCiscoAPIC-EMcontrollerrestartedonascalesetupwith10,000devices whichwasidlefor24-36hours. •WhenenteringcharactersintheEasyQoSGUIforaURLfieldwhileaddingacustomapplication,Cisco EasyQoSsupportsupto30characters.ThefollowingCiscoIOSversionssupportonly29charactersin theURLfield: •15.5(03)S3.16 •15.5(03)M3.1 •15.6(3)M1 •16.3.2 IfyourdeviceisrunningoneoftheaboveCiscoIOSversions,thenonlyenterupto29charactersinthe URLfield. •CustomappscreatedusingtheEasyQoSGUIapplicationrequireanIPaddress(mandatoryfield).Custom appscreatedusingtheAPIdonotrequireanIPaddress(optionalfield).Customappscreatedwithout anIPaddressusingtheAPIwillfailwhenappliedtoaNBARrouter.NBARroutersdonotsupport applicationswithoutanIPaddress.ToapplythepolicyonNBARrouters,pleaseremovethecustomapp fromthelist. •WhenremovinganetworkdevicefromascopeinEasyQoS,optionsthatpermityoutorestoretothe originalpolicyordeletethepolicyarenottriggered.Additionally,unliketheoptioninEasyQoSthat permitsyoutoreapplyapolicy,therearenooptionstorestoreanoriginalpolicyortodeleteapolicy whenapolicyfailsonthenetworkdevices. •FortheEasyQoSapplication,themaximumnumberofdevicesthatcanbeconfiguredforascopeis 2000. •CiscoEasyQoSisnotsupportedontheCiscoASR1000seriesrouterrunningCiscoIOSXE16.3.1. •WithintheEasyQoSapplication,DynamicQoSisabetafunctionalityforthisrelease. •TheDSCP-to-UPmappingsprovisionedbyEasyQoStoWLCplatformsarenotchanged,regardlessof whetherthenetworkadministratorhasmodifiedtheDSCPmarkingassignedtoagiventraffic-class. Thiscouldresultinsub-optimalQoS.Thismayoccurifthetraffic-classisassignedaDSCPmarking whichmapstothewrongIEEE802.11userpriority(UP).Forexample,ifanetworkadministratorassigns theMultimedia-Streamingvideotraffic-classaDSCPvaluethatmapstoaUPthatbelongstotheBest Effort802.11accesscategory(AC),thenMultimedia-StreamingtrafficwillreceiveBestEffortservice acrossthewirelessmedium. •WhenrollingbackanAPIC-EM1.5policyinvolvingWLCplatforms,EasyQoSwillremovetheAVC ProfilefromtheWLAN/SSID,andwillchangetheQoSProfiletoSilver(BestEffort).EasyQoSwill leaveFastlaneenabledfortheWLAN/SSID,althoughthereisnoAVCProfileassociatedwithFastlane andtheQoSProfileassociatedwiththeWLAN/SSIDhasbeenchangedfromPlatinum(thedefaultwith Fastlane)toSilver. •TheCiscoEasyQoSapplicationdoesnotsupportmultilinkinterfaces. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 8 ServiceandSupport •Atpresent,theEasyQoSapplicationdoesnotsupportdeviceswithacellularinterface.Thisfunctionality maybeaddedinalaterrelease. •TheapplicationdoesnotsupportconfiguringQualityofServiceinaport-channelinterfaceforISR4000 routers. •Ifthenameofthesub-interfaceexceeds64characters,thencompletethefollowingsteps: 1. Runthefollowingcommandonthedevice. snmp ifmib ifalias long 2. ResyncthedeviceinAPIC-EM.Confirmthatthechangehasbeenapplied. 3. ReapplytheQoSpolicy. Important ForspecificEasyQoSfeaturesupportandrestrictionsbyplatformandlinecard,seeSupportedPlatformsfor theCiscoApplicationPolicyInfrastructureControllerEnterpriseModule. Service and Support Troubleshooting SeetheCiscoApplicationPolicyInfrastructureControllerEnterpriseModuleTroubleshootingGuide,for troubleshootingprocedures. RelatedDocumentation ThefollowingpublicationsareavailablefortheCiscoAPIC-EM: CiscoAPIC-EMControllerDocumentation Forthistypeofinformation... Seethisdocument... Releaseinformation,includingnewfeatures,system CiscoApplicationPolicyInfrastructureController requirements,andopenandresolvedcaveats. EnterpriseModuleReleaseNotes Installationandconfigurationofthecontroller, CiscoApplicationPolicyInfrastructureController includingpost-installationtasks. EnterpriseModuleInstallationGuide IntroductiontotheCiscoAPIC-EMGUIandits CiscoApplicationPolicyInfrastructureController applications. EnterpriseModuleQuickStartGuide1 Configurationofuseraccounts,RBACscope,security CiscoApplicationPolicyInfrastructureController certificates,authenticationandpasswordpolicies,and EnterpriseModuleAdministratorGuide globaldiscoverysettings. MonitoringandmanagingCiscoAPIC-EMservices. Backupandrestore. CiscoAPIC-EMAPIs. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 9 CiscoActiveAdvisorApplicationDocumentation Forthistypeofinformation... Seethisdocument... Troubleshootingthecontroller,includingthe CiscoApplicationInfrastructureControllerEnterprise installation,services,andpasswords. ModuleTroubleshootingGuide Developerconsole. HowtocontacttheCiscoTechnicalAssistanceCenter (TAC). Taskstoperformbeforeupdatingthecontrollertothe CiscoApplicationInfrastructureControllerEnterprise latestversion. ModuleUpgradeGuide Softwareupdateinstructions. Taskstoperformafteranupdate. 1 AvailablefromtheAPIC-EMcontrollerSystemInfowindow. CiscoActiveAdvisorApplicationDocumentation Forthistypeofinformation... Seethisdocument... Releaseinformation,includingopenandresolved CiscoActiveAdvisorforAPIC-EMReleaseNotes caveatsfortheCiscoActiveAdvisorapplication. CiscoEasyQoSApplicationDocumentation Forthistypeofinformation... Seethisdocument... Releaseinformation,includingopenandresolved CiscoEasyQoSApplicationforAPIC-EMRelease caveatsfortheCiscoEasyQoSapplication. Notes Supportedplatformsandsoftwarereleases. CiscoEasyQoSApplicationforAPIC-EMSupported Platforms Installationoftheapplication.(Thisapplicationis CiscoApplicationPolicyInfrastructureController installedaspartoftheCiscoAPIC-EMcontroller EnterpriseModuleInstallationGuide software.) Configurationofqualityofservicepoliciesonthe CiscoEasyQoSApplicationforAPIC-EMUserGuide networkdevicesinyournetwork. DevelopmentofanoverallCiscoEasyQoSsolution https://www.cisco.com/c/en/us/solutions/enterprise/ foryournetworkandCiscodevices. design-zone-campus/design-guide-listing.html CiscoIntegrityVerificationApplicationDocumentation Forthistypeofinformation... Seethisdocument... Releaseinformation,includingopenandresolved CiscoIntegrityVerificationApplication(Beta)on caveatsfortheCiscoIntegrityVerification APIC-EMReleaseNotes application. CiscoEasyQoSApplicationforAPIC-EMReleaseNotes,Release1.6.0.x 10