Professional Documents
Culture Documents
Release 7.0(2)
February 2010
Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0833
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCBs public domain version of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED "AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. CCDE, CCSI, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Stackpower, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries. All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0903R) Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental. Copyright 2009 Cisco Systems, Inc. All rights reserved.
Table of Contents
Preface ...........................................................................................................................................................1 Purpose .....................................................................................................................................................1 Audience ....................................................................................................................................................1 Organization ..............................................................................................................................................2 Related Documentation .............................................................................................................................3 Conventions................................................................................................................................................5 Obtaining Documentation and Submitting a Service Request...................................................................5 Documentation Feedback...........................................................................................................................6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Unified CVP VRU Call Flow Models with NIC Routing...........................................................................120 Type 8 Unified CVP VRU-Only Call Flow Model, Unified ICME.........................................................121 Type 8 Unified CVP VRU-Only Call Flow Model, Unified ICMH.........................................................130 Type 3 or 7 Unified CVP VRU-Only Call Flow Model Network VRU, Unified ICMH...........................139 Unified CVP Comprehensive Call Flows for Pre-Routed Calls...............................................................147 Calls Which Arrive at Unified ICME Through a Pre-Route-Only NIC.................................................148 Calls Which are Pre-Routed Through a GKTMP NIC (Not Applicable for SIP Deployments)............150 Calls Which are Originated by Unified CM.........................................................................................150 Calls Which are Originated By an ACD or Call Routing Interface (CRI) Based VRU Using a Peripheral Gateway (PG)....................................................................................................................................152 Common Unified ICMH Configuration for Unified CVP Switch Leg........................................................153 Common Unified ICMH Configuration: Define Unified CVP ECC Variables...........................................155 Using Metadata ECC Variables..............................................................................................................159 Metadata ECC Variable.....................................................................................................................159 Common Configuration for Differentiating VRUs (Unified CVPs) Based on Dialed Number..................160 Gatekeeper Redundancy .......................................................................................................................161 Alternate Gatekeeper Configuration..................................................................................................161 Local SRV File Configuration Example for SIP Messaging Redundancy...............................................162 3. Cisco Unified CVP Operations Console Overview..................................................................................163 About the Unified CVP Operations Console...........................................................................................163 Using the Operations Console................................................................................................................164 Logging In to the Operations Console...............................................................................................165 Using the Cisco Unified Customer Voice Portal Page........................................................................166 Getting Acquainted with the Operations Console Menu Options.......................................................167 Where to Find More Information........................................................................................................171 Logging Out From the Operations Console.......................................................................................172 Resetting the Operations Console Password for "Administrator" Account.............................................173 Overview of User Management..............................................................................................................173 Configuring Components with and without the Unified CVP Operations Console..................................174 4. Writing Scripts for Unified CVP...............................................................................................................175 About Scripting for Unified CVP.............................................................................................................175 Scripting Alternatives: VoiceXML vs. Unified ICME Scripting.................................................................176 VoiceXML Scripting............................................................................................................................176 Unified ICME Scripting.......................................................................................................................177 Scripting for Unified CVP with Unified ICME..........................................................................................177 Before You Begin................................................................................................................................178 Example: Welcome to XYZ Corporation..........................................................................................178 What are Micro-Applications?............................................................................................................179 The Cisco Unified Intelligent Contact Management Enterprise /Unified CVP Micro-Application Connection.........................................................................................................................................180 Information Exchange Between Unified ICME and Unified CVP.......................................................182 Unified ICME Data Handling..............................................................................................................182 Unified CVP Script Error Checking....................................................................................................183 Unified ICME Setup................................................................................................................................187 Writing Unified ICME Applications for Unified CVP................................................................................187 How to Configure a Unified CVP Network VRU Script.......................................................................188 How to Specify a Run External Script Node that Accesses a Unified CVP Micro-Application...........189 Using Unified CVP Micro-Applications...................................................................................................190 How Micro-Applications Use Automatic Speech Recognition (ASR) and Text-to-Speech (TTS).......190 How Micro-Applications Use External VoiceXML...............................................................................191
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
ii
Dynamic Audio File Support for Micro-Applications...........................................................................191 Capture (CAP) Micro-Application.......................................................................................................193 Play Media (PM) Micro-Application....................................................................................................194 Play Data (PD) Micro-Application......................................................................................................200 Get Digits (GD) Micro-Application......................................................................................................209 Menu (M) Micro-Application...............................................................................................................216 Get Speech (GS) Micro-Application...................................................................................................222 External VoiceXML File Contents......................................................................................................237 Type-Ahead Support for ASR............................................................................................................239 Scripting for Unified CVP with Call Studio..............................................................................................240 About Call Studio ..............................................................................................................................240 Using Call Studio's ReqICMLabel Element to Pass Data..................................................................241 Deploying Call Studio Scripts in Unified CVP....................................................................................245 5. Using Cisco Support Tools with Unified CVP..........................................................................................247 About Cisco Support Tools.....................................................................................................................247 About Cisco Support Tools and Unified CVP..........................................................................................248 Cisco Unified Contact Center Security Wizard .................................................................................249 Accessing Cisco Support Tools from the Operations Console...............................................................249 6. Configuring and Modifying Unified CVP Security....................................................................................251 Unified CVP Security and Cisco Support Tools......................................................................................251 About Cisco Support Tools and Secure Sockets Layer (SSL)...........................................................251 About Cisco Support Tools and Unified CVP on a Windows System................................................252 About Cisco Support Tools and Unified CVP on an AIX System.......................................................252 Securing Communications Between Unified CVP Components.............................................................252 Before You Begin................................................................................................................................253 How to Secure JMX Communications Between Unified CVP Components......................................254 How to Exchange Certificates Between Systems..............................................................................254 How to Enable Security on Unified CVP Devices..............................................................................257 Obtaining and Deploying Certificate Authority Signed Certificates....................................................258 Securing Communications Between Unified CVP and IOS Devices......................................................260 How to Export the Operations Console Certificate to a File..............................................................260 How to Import the Operations Console Certificate to a Gatekeeper or Gateway..............................261 How to Configure Secure Access to the Router Using Protocol SSH Version 2 ...............................261 Securing Communications Between VoiceXML Gateways and VXML Server........................................263 HTTPS Support for Unified CVP............................................................................................................263 Using Tomcat to Present CA-signed Certificates to Inbound HTTPS Clients....................................264 Using WebSphere to Present CA-signed Certificates to Inbound HTTPS Clients.............................265 Set Up SSL........................................................................................................................................266 Securing Communications Between Unified CVP and IOS Devices.................................................268 Securing Sensitive Customer Information..............................................................................................269
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
iii
Deleting a VXML Server....................................................................................................................281 VXML Server General Properties......................................................................................................282 VXML Server Configuration Properties.............................................................................................283 Inclusive and Exclusive VoiceXML Filters for Reporting....................................................................284 Transferring Script Files.....................................................................................................................288 Downloading a Log Messages XML File...........................................................................................289 Editing the Log Messages XML File..................................................................................................290 Unified CVP Event Severity Levels....................................................................................................291 Uploading a Log Messages XML File................................................................................................291 Applying a License to a VXML Server...............................................................................................292 Getting the System ID for a VXML Server.........................................................................................293 Finding a VXML Server......................................................................................................................294 Associating a VXML Server with a Call Server..................................................................................295 Enabling Security for a VXML Server................................................................................................295 Configuring VXML Server Applications: Filters..................................................................................296 Enabling Reporting for the VXML Server...........................................................................................296 Configuring QoS for the VXML Server...............................................................................................297 Configuring a VXML Server (Standalone)..............................................................................................298 Adding a VXML Server (Standalone).................................................................................................298 Editing a VXML Server (Standalone).................................................................................................299 Deleting a VXML Server (Standalone)...............................................................................................300 Finding a VXML Server (Standalone)................................................................................................301 Getting the System ID for a VXML Server (Standalone)....................................................................302 Using VXML Server with Unified ICME..................................................................................................302 Integrating VoiceXML Scripts with Unified ICME Scripts...................................................................303 Correlating Unified CVP/Unified ICME Logs with VXML Server Logs...............................................304 Error Codes for VXML Server............................................................................................................304 VXML Server (Standalone) Solutions.....................................................................................................305 Configuring the VXML Server (Standalone) with ICM Lookup Call Flow Model................................305 Configuring the VXML Server (Standalone) Call Flow Model (without ICM Lookup).........................308 Activate the Gateway Configuration...................................................................................................310 Using Takeback and Transfer in VoiceXML Scripts............................................................................310 Configuring the Gateway for TDM to IP Calls....................................................................................316 Passing Data to Unified ICME................................................................................................................317 Configuring the Connections ............................................................................................................317 Configuring the Gateway for IP to TDM Calls....................................................................................318 Configuring a Cisco Multiservice IP-to-IP Gateway for Unified CM Connections..............................319 SNMP Monitoring for the VXML Server.............................................................................................319 8. Configuring Unified CVP Logging and Event Notifications......................................................................321 Using Syslog...........................................................................................................................................321 Using Logs to Interpret Events...............................................................................................................322 Editing the Log Messages XML File..................................................................................................322 Unified CVP Event Severity Levels....................................................................................................323 Downloading a Log Messages XML File...........................................................................................323 Uploading a Log Messages XML File................................................................................................324 VoiceXML Logs.......................................................................................................................................325 About VoiceXML Logs........................................................................................................................325 Correlating Unified CVP/Unified ICME Logs with VXML Server Logs...............................................326 About VXML Server Logs..................................................................................................................326 About VoiceXML Application Logging................................................................................................327 About Event Statistics.............................................................................................................................329
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
iv
Viewing Device Statistics...................................................................................................................330 Infrastructure Statistics......................................................................................................................331 ICM Service Call Statistics.................................................................................................................333 IVR Service Call Statistics.................................................................................................................336 SIP Service Call Statistics.................................................................................................................338 H.323 Service Call Statistics.............................................................................................................340 Gatekeeper Statistics.........................................................................................................................342 Gateway Statistics.............................................................................................................................344 VXML Server Statistics......................................................................................................................345 Video Media Server Statistics............................................................................................................346 Reporting Server Statistics................................................................................................................348 SNMP Alerts for Cisco Unified Presence Server (CUP).........................................................................349 Unified CVP SNMP-Raise/Clear Mappings............................................................................................349 9. Administering the Unified CVP H.323 Service........................................................................................353 Unified CVP H.323 Service Overview....................................................................................................353 How Does the H.323 Service Connect to a Call Server?..................................................................355 The H.323 Service Media File...........................................................................................................356 How to Control the State of the H.323 Service..................................................................................356 About the H.323 Service and the Gatekeeper...................................................................................358 VBAdmin Tool.........................................................................................................................................358 Running VBAdmin..............................................................................................................................359 VBAdmin Command Syntax..............................................................................................................359 VBAdmin Online Help........................................................................................................................360 Using VBAdmin......................................................................................................................................360 How to Use the VBAdmin Tool Locally...............................................................................................360 How to Use the VBAdmin Tool Remotely...........................................................................................361 VBAdmin Configuration Commands..................................................................................................361 Delivering H.323 Incoming UUI to a Unified ICME Routing Script.....................................................374 VBAdmin Logging Commands...........................................................................................................376 VBAdmin Metric and Control Commands..........................................................................................377 VBAdmin Error Handling....................................................................................................................381 Performing H.323 Blind Transfers...........................................................................................................381 Configuring H.323 Blind Transfer in Unified ICME.............................................................................382 Configuring H.323 Blind Transfer in Ingress Gateway........................................................................382 Configuring H.323 Blind Transfer in H.323 Service............................................................................382
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Adding a Unified CM Server..............................................................................................................392 Editing a Unified CM Server..............................................................................................................393 Unified CM Configuration Settings.....................................................................................................394 Deleting a Unified CM Server............................................................................................................395 Finding a Unified CM Server..............................................................................................................395 12. Configuring the SIP Devices.................................................................................................................397 Configuring a SIP Proxy Server..............................................................................................................397 Adding a SIP Proxy Server................................................................................................................398 Deleting a SIP Proxy Server..............................................................................................................399 Editing a SIP Proxy Server................................................................................................................400 Finding a SIP Proxy Server...............................................................................................................400 SIP Proxy Server Configuration Settings...........................................................................................401 Load-balancing SIP Calls.......................................................................................................................402 How to Set Up the Ingress Gateway to Use Redundant Proxy Servers.................................................402 How to Set Up the Unified CVP Call Server with Redundant Proxy Servers.........................................403 REFER Transfers Using "RFXXXX" Type Unified ICME Labels .............................................................403 Using the sendtooriginator Setting in the SIP Service............................................................................404 Expiration Timeout Setting Using Dialed Number Patterns in SIP.........................................................405 Critical Error Message Playback on Abnormal Disconnects with SIP ...................................................405 How It Works......................................................................................................................................406 Delivering SIP Incoming UUI to Unified ICME Routing Script................................................................406 How It Works......................................................................................................................................406 13. Transferring and Queuing Calls with Unified CVP.................................................................................409 IVRs from Unified ICME's Perspective...................................................................................................409 Transferring Calls Using Unified CVP in Comprehensive Mode.............................................................409 Transferring Calls Using SIP Service.................................................................................................410 Example: Transfer to a Label..............................................................................................................410 Example: Queue and Transfer to a Skill Group..................................................................................412 Example: Network Transfer Script......................................................................................................414 Transferring a Call from Agent to Agent.................................................................................................415 Configuring Network Transfer from IP Phone....................................................................................415 Configuring Network Transfer from CTI OS Agent Desktop...............................................................416 IP Transfer Example (Unified CCE Routing)...........................................................................................416 Overriding the CLI Field on Outgoing Transfers......................................................................................416 Configuring CLI Override...................................................................................................................417 Unified CVP H.323 Service Debugging.............................................................................................418 Most Significant Digit..............................................................................................................................418 Configuring Unified CCE Re-route On No Answer for Unified CVP.......................................................419 Summary...........................................................................................................................................419 Re-route On No Answer Operation for Unified CCE with Unified IP IVR ..........................................419 Re-route On No Answer Operation with Unified CVP........................................................................419 Configuring Re-route On No Answer for Unified CM with Unified CVP.............................................422 Limitations..........................................................................................................................................423 Call Survivability.....................................................................................................................................423 Installing the Call Survivability Script.................................................................................................424 How to Configure the Gateway for Call Survivability..........................................................................426 Configuring Locations-Based Call Admission Control............................................................................433 Configuring Unified CM Service Configuration Settings....................................................................434 Configuring Ingress Gateway H.323 Settings ...................................................................................434 Configuring Unified CVP H.323 Service Configuration Settings........................................................435
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
vi
Unified CVP Bandwidth Utilization.....................................................................................................436 VoiceXML Documents.......................................................................................................................437 Prompt Retrieval................................................................................................................................437 H.323 Signaling Bandwidth................................................................................................................437 Gateway Prompt Caching Considerations.........................................................................................438 Incoming UUI to be Used as the Correlation ID.....................................................................................439 How It Works......................................................................................................................................439 Configuring the Gateway...................................................................................................................439 Debugging Tips..................................................................................................................................440 Performing External Transfers in Unified CCE........................................................................................440 Defining a Unified ICME Script Label for Outpulse Transfer..............................................................440 Defining a Unified ICME Script Label for Two B-Channel Transfer (TBCT)........................................441 Defining a Unified ICME Script Label for Hookflash Transfer.............................................................441 Using Takeback and Transfer in VoiceXML Scripts............................................................................442 Restart to Alternate DNIS..................................................................................................................447 14. Configuring the H.323 Devices and VoIP..............................................................................................453 About Call Routing..................................................................................................................................453 Call Routing (tech-prefix method)......................................................................................................454 Call Routing (zone-prefix method).....................................................................................................457 Gatekeeper Redundancy........................................................................................................................462 Host Standby Router Protocol (HSRP) Support................................................................................462 H.323 Service....................................................................................................................................462 Gatekeeper........................................................................................................................................462 Gateway.............................................................................................................................................463 Unified CM.........................................................................................................................................463 Unified ICME......................................................................................................................................463 Alternate Gatekeeper Support...........................................................................................................463 Unified CVP in a GK Cluster Example...............................................................................................466 Configuring Unified CVP to Propagate UUI to Unified ICME.................................................................467 Example 1: VRU-Only Call Flow Model..............................................................................................468 Example 2: Comprehensive Call Flow Model....................................................................................468 Debugging Tips for VRU-Only Call Flow Model.................................................................................469 Debugging Tips for Comprehensive Model........................................................................................470 Unified CVP Endpoint Limitations...........................................................................................................470 Configuring a Gateway...........................................................................................................................471 Adding a Gateway..............................................................................................................................472 Deleting a Gateway............................................................................................................................473 Editing a Gateway..............................................................................................................................474 Gateway Configuration Settings........................................................................................................475 IOS Gateway Commands..................................................................................................................476 Executing IOS Commands on the Gateway.......................................................................................476 Transferring a File to a Gateway........................................................................................................476 Viewing Gateway Statistics................................................................................................................477 Finding a Gateway.............................................................................................................................478 Configuring a Gatekeeper......................................................................................................................479 Finding a Gatekeeper........................................................................................................................479 Adding a Gatekeeper.........................................................................................................................480 Deleting a Gatekeeper.......................................................................................................................481 Editing a Gatekeeper.........................................................................................................................482 Executing Gatekeeper Commands....................................................................................................483 Gatekeeper Configuration Settings....................................................................................................483
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
vii
IOS Gatekeeper Commands.............................................................................................................484 Transferring Script Files.....................................................................................................................484 Configuring an ICM Server.....................................................................................................................486 Adding an ICM Server.......................................................................................................................486 Deleting an ICM Server.....................................................................................................................487 Editing an ICM Server........................................................................................................................488 Finding an ICM Server.......................................................................................................................488 ICM Server Configuration Settings....................................................................................................489 15. Configuring High Availability for Unified CVP........................................................................................491 Using Cisco Content Services Switch (CSS) for Load Balancing in Unified CVP..................................491 CSS Configuration for Media Servers....................................................................................................492 CSS Configuration for Media Servers: Service..................................................................................493 CSS Configuration for Media Servers: Http Redirect Services..........................................................493 CSS Configuration for Media Servers: Content Routing Rule............................................................493 CSS Configuration for Media Servers: Keepalive Method.................................................................494 CSS Configuration for Media Servers: Keepalive Times....................................................................494 CSS Configuration for Media Servers: Groups..................................................................................494 CSS Configuration for Media Servers: Voice Gateway......................................................................495 CSS Configuration for Media Servers: Multiple Media-Server Rules.................................................495 CSS Configuration for Call Servers........................................................................................................496 CSS Configuration for Call Servers: Service.....................................................................................497 CSS Configuration for Call Servers: Content Routing Rule...............................................................497 CSS Configuration for Call Servers: Keepalive Method.....................................................................498 CSS Configuration for Call Servers: Keepalive Times.......................................................................498 CSS Configuration for Call Servers: Groups......................................................................................498 CSS Configuration for Call Servers: Activate Services, Group, and Rules........................................499 CSS Configuration for Call Servers: Voice Gateway Configuration....................................................499 CSS Configuration for ASR/TTS Servers...............................................................................................499 CSS Configuration for ASR/TTS Servers: Service............................................................................499 CSS Configuration for ASR/TTS Servers: Content Rule....................................................................500 CSS Configuration for ASR/TTS Servers: Keepalive Method............................................................500 CSS Configuration for ASR/TTS Servers: Keepalive Times..............................................................500 CSS Configuration for ASR/TTS Servers: Groups.............................................................................501 CSS Configuration for ASR/TTS Servers: Activate Services, Group, and Rules...............................501 CSS Configuration for ASR/TTS Servers: Voice Gateway.................................................................501 CSS Configuration for VXML Servers.....................................................................................................502 CSS Configuration for VXML Servers: Service..................................................................................502 CSS Configuration for VXML Servers: Content Rule.........................................................................503 CSS Configuration for VXML Servers: Keepalive Method..................................................................503 CSS Configuration for VXML Servers: Groups..................................................................................504 Redundancy and Failover for Unified CVP.............................................................................................504 ASR, TTS, and Media Server Redundancy for VXML Server Applications (with CSS).....................504 ASR, TTS, and Media Server Redundancy for VXML Server Applications (without CSS)................505 CSS Redundancy..............................................................................................................................507 Sample Configuration for CSS Redundancy......................................................................................507 Configuring a Content Services Switch (CSS).......................................................................................510 Adding a Content Services Switch....................................................................................................511 Editing a Content Services Switch.....................................................................................................512 Deleting a Content Services Switch..................................................................................................513 Finding a Content Services Switch....................................................................................................513 Content Services Switch Configuration Settings...............................................................................514
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
viii
IOS Content Services Switch Commands.........................................................................................515 Executing IOS Commands on the Content Services Switch.............................................................515 Transferring a Script File to a Content Services Switch.....................................................................516 Configuring a Speech Server.................................................................................................................517 Adding a Speech Server....................................................................................................................517 Speech Server Configuration Settings...............................................................................................518 Editing a Speech Server Configuration..............................................................................................519 Applying a License to a Speech Server.............................................................................................520 Deleting a Speech Server..................................................................................................................521 Adding and Removing Speech Servers from a Device Pool..............................................................521 Finding a Speech Server...................................................................................................................522 16. Configuring the Media Servers..............................................................................................................525 Media File Overview...............................................................................................................................525 Media Server.....................................................................................................................................525 Media File Names and Types.............................................................................................................526 Location of Media Files .....................................................................................................................526 Media File Address............................................................................................................................527 Locale Backward Compatibility..........................................................................................................529 System Media Files................................................................................................................................530 Miscellaneous Files...........................................................................................................................542 System Media File Error Messages...................................................................................................544 Configuring a Media Server....................................................................................................................545 Adding a Media Server......................................................................................................................546 Media Server Configuration Settings.................................................................................................547 Editing a Media Server Configuration................................................................................................547 Deleting a Media Server....................................................................................................................548 Adding and Removing a Media Server from a Device Pool...............................................................548 Finding a Media Server......................................................................................................................549
ix
How to Configure Playing Multiple Audio Files in Unified CVP Video Micro-Applications.................583 How to Set Up TLS Communication..................................................................................................584 How to Configure TLS When Adding Additional IVP to Call Server...................................................588 How to Configure Load-balancing and Failover Mechanism for Full Video Service...........................589 How to Configure Radvision MCU for Additional Languages............................................................590 Using the Video ECC Variables..............................................................................................................592 Recording Sessions................................................................................................................................594 Recording Sessions Using a Unified ICME Script.............................................................................594 Using the Unified CVP Video Micro-Applications...................................................................................595 Video Play Media (VPM) Micro-Application.......................................................................................595 Video Play Data (VPD) Micro-Application..........................................................................................599 Video Get Digits (VGD) Micro-Application.........................................................................................602 Video Menu (VM) Micro-Application..................................................................................................606 Adding IVP Server to Operations Console.............................................................................................610 Adding an IVP Server........................................................................................................................611 Editing an IVP Server........................................................................................................................612 IVP Server Configuration Settings.....................................................................................................612 Adding and Removing an IVP Server from a Device Pool.................................................................613 Deleting an IVP Server......................................................................................................................614 Finding an IVP Server........................................................................................................................614 Installing and Setting Up the CVP Video Media Server (VMS)..............................................................615 About the CVP Video Media Server (VMS).......................................................................................615 Overview of Setting Up the CVP Video Media Server.......................................................................615 Configuring Video Media Server.............................................................................................................617 Adding a Video Media Server............................................................................................................618 Editing a Video Media Server............................................................................................................619 Configuring Video Media Server Infrastructure Settings....................................................................620 Video Media Server Configuration Settings.......................................................................................621 Adding and Removing a Video Media Server from a Device Pool.....................................................622 Deleting a Video Media Server..........................................................................................................622 Finding a Video Media Server............................................................................................................623 Viewing Video Media Server Statistics..............................................................................................624 Launching the Video Media Server Administration Interface.............................................................624 Using the Video Media Server Administration Interface.........................................................................625 Copying Video Files to the Video Media Server.................................................................................627 Adding or Editing Metadata...............................................................................................................628 Deleting Metadata..............................................................................................................................629 Metadata Configuration Settings.......................................................................................................630 Searching Metadata...........................................................................................................................632 Sorting the Media List........................................................................................................................633 Filtering the Media List.......................................................................................................................633 Browsing the Media Library...............................................................................................................634 Previewing a Video File......................................................................................................................635 Configuring Video on the Cisco CTI OS or CAD Desktops ...................................................................635 How to Enable Video on the CTI OS Agent and CTI OS Supervisor Desktops.................................635 How to Enable Video on the CTI Toolkit Combo Desktop (.NET)......................................................636 How to Enable Video on the CAD Desktop........................................................................................636 Using the Cisco Unified Customer Voice Portal Video Desktop.............................................................638 How to Change the Cisco Unified Customer Voice Portal Video Desktop Language........................638 Agent Partitioning...................................................................................................................................639 Creating Videos......................................................................................................................................639
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
How to Add a Static Image to an Audio File Using Windows Movie Maker.......................................640 How to Add an Agent Avatar Using Codebaby Production Studio.....................................................641 How to Create a Video Using Nokia Multimedia Converter...............................................................642 Appendix A. Localization Customization.....................................................................................................645 Unified CVP Support for Video Play Data (VPD) Micro-Application Localization...................................645 List of Audio File Names for VPD.......................................................................................................646 Text Overlay for VPD..........................................................................................................................646 API Requirements..............................................................................................................................646 Overview of VPD Localization Framework Support...........................................................................647 Design Considerations.......................................................................................................................648 Compiling and Deploying Custom Localizer Java Classes................................................................648 VPD Localization Java API................................................................................................................649 Java API Details.................................................................................................................................650 Abstract Base Class: BaseLocalizer..................................................................................................651 Interface: CustomLogger...................................................................................................................651 Enum: TimeFormat............................................................................................................................652 Property File: customGrammar.properties.........................................................................................652 Example Implementation (en-us).......................................................................................................652 How to Create Customized Grammar Classes..................................................................................652 Example: Supporting Mexican-Spanish Language............................................................................653 Appendix B. CUP Proxy Static Route Provisioning Use Cases .................................................................655 CUP Proxy Static Route Provisioning Use Cases .................................................................................655 Index ...........................................................................................................................................................657
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
xi
List of Figures
Figure 1: SIP-Based Unified CVP Solution....................................................................................................................16 Figure 2: H.323-Based Unified CVP Solution................................................................................................................16 Figure 3: SIP-Based Unified CVP Solution....................................................................................................................21 Figure 4: H.323-Based Unified CVP Solution................................................................................................................22 Figure 5: Unified CVP VXML Server (Standalone) Call Flow Model...........................................................................40 Figure 6: Unified CVP Standalone with ICM Lookup Call Flow Model........................................................................47 Figure 7: Unified CVP Call Director with SIP without Proxy Server, Unified ICME....................................................55 Figure 8: Unified CVP Call Director with SIP with Proxy Server, Unified ICME.........................................................55 Figure 9: Unified CVP Call Director with H.323, Unified ICME...................................................................................55 Figure 10: DNS Zone File MS DNS Configuration Example.........................................................................................76 Figure 11: Unified CVP Call Director with SIP without Proxy Server, Unified ICMH.................................................77 Figure 12: Unified CVP Call Director with SIP with Proxy Server, Unified ICMH......................................................77 Figure 13: Unified CVP Call Director with H.323, Unified ICME.................................................................................78 Figure 14: Unified CVP Comprehensive with SIP without Proxy Server, Unified ICME..............................................81 Figure 15: Unified CVP Comprehensive with SIP with Proxy Server, Unified ICME...................................................81 Figure 16: Unified CVP Comprehensive with H.323, Unified ICME.............................................................................82 Figure 17: DNS Zone File MS DNS Configuration Example.......................................................................................117 Figure 18: Unified CVP Comprehensive with SIP without Proxy Server, Unified ICMH...........................................119 Figure 19: Unified CVP Comprehensive with SIP with Proxy Server with Proxy Server, Unified ICMH..................119 Figure 20: Unified CVP Comprehensive with H.323, Unified ICMH..........................................................................120 Figure 21: Type 8 Unified CVP with Type 8 VRU-Only, Unified ICME......................................................................121 Figure 22: Type 8 Unified CVP with Type 8 VRU-Only, Unified ICMH.....................................................................130 Figure 23: Unified CVP with Type 3 or 7 VRU-Only, Unified ICMH..........................................................................140 Figure 24: Example Play Media Script..........................................................................................................................179 Figure 25: Example Network VRU Script Attributes Tab.............................................................................................180 Figure 26: Run External Script Node Properties...........................................................................................................182 Figure 27: Set Node Dialog...........................................................................................................................................197 Figure 28: Set Node Dialog...........................................................................................................................................197 Figure 29: Run External Script Properties Dialog.........................................................................................................198 Figure 30: VXML Server (Standalone) with ICM Lookup...........................................................................................241 Figure 31: Sample Unified ICME Script for VXML Server.........................................................................................245 Figure 32: The Support Server and Clients...................................................................................................................248 Figure 33: Unified CVP's VXML Solution...................................................................................................................273
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
xii
Figure 34: Call Studio Application................................................................................................................................276 Figure 35: Call Studio Logger ......................................................................................................................................328 Figure 36: Call Server....................................................................................................................................................355 Figure 37: Unified ICME Script for Warm Consult Transfer........................................................................................388 Figure 38: DNS SRV Method for Load Balancing and Failover without a Proxy Server.............................................402 Figure 39: Local Static Route Configuration.................................................................................................................403 Figure 40: Office Hours Menu Configuration...............................................................................................................411 Figure 41: Transfer........................................................................................................................................................412 Figure 42: Queue Menu Configuration..........................................................................................................................413 Figure 43: Queue...........................................................................................................................................................414 Figure 44: Network Transfer Script...............................................................................................................................415 Figure 45: Agent Desk Settings Configuration..............................................................................................................420 Figure 46: Queue to Skill Group Properties..................................................................................................................421 Figure 47: Sample Script for Re-Route on No Answer.................................................................................................421 Figure 48: Example of a Gatekeeper Cluster.................................................................................................................464 Figure 49: Media File Location.....................................................................................................................................527 Figure 50: Unified CVP High-Level Video Overview...................................................................................................554 Figure 51: Unified CVP Basic Video Call Flow Model................................................................................................560 Figure 52: Sample Basic Video Script...........................................................................................................................563 Figure 53: Unified CVP Full Video Call Flow Model with 3G Gateway-Originated Caller........................................570 Figure 54: Unified CVP Full Video Call Flow Model with CUVA-Originated Caller..................................................570 Figure 55: Sample Full Video Script.............................................................................................................................579
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
xiii
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
xiv
Preface
Purpose
This manual describes how to set up, run, and administer the Cisco Unified Customer Voice Portal (Unified CVP) product. Note: Planning your Unified CVP solution is an important part of the process in setting up Unified CVP, so make sure you first read the Cisco Unified Customer Voice Portal Release 7.x Solution Reference Network Design (SRND) before configuring your Unified CVP solution.
Audience
This document is intended for Call Center managers, Unified CVP system managers, Cisco Unified Intelligent Contact Management Enterprise (Unified ICME)/ Cisco Unified ICM Hosted (Unified ICMH) system managers, VoIP technical experts, and IVR application developers. Readers of this manual should already have a general understanding of the Unified ICME products, as discussed in the Pre-Installation Planning Guide for Cisco Unified Intelligent Contact Management Enterprise and the Product Description Guide for Cisco Unified ICM Hosted. Readers should be familiar with general Unified ICME installation and setup procedures. A Word About Cisco Product Names Be aware of the following Cisco product name changes: Effective with Release 4.0(1), Cisco Customer Voice Portal is renamed Cisco Unified Customer Voice Portal (abbreviated as Unified CVP). Effective with Release 7.0(1), VoiceXML Server is renamed Cisco Unified CVP VXML Server (abbreviated as VXML Server).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Preface Organization
Effective with Release 7.0(1), VoiceXML Studio is renamed Cisco Unified Call Studio (abbreviated as Call Studio). Effective with Cisco CallManager Releases 4.1(3), 4.2(1), 5.0(2), Cisco CallManager is renamed Cisco Unified Communications Manager (abbreviated as Unified CM). Effective with Release 7.1(1) and later, Cisco ICM Enterprise Edition is renamed Cisco Unified Intelligent Contact Management Enterprise (abbreviated as Unified ICME). Cisco ICM Hosted Edition is renamed Cisco Unified ICM Hosted (abbreviated as Unified ICMH). This manual references this product by the new name, though the new name does not appear in the Release 7.1(1) user interface. Effective with Release 7.1(1) and later, Cisco IPCC Enterprise Edition is renamed Cisco Unified Contact Center Enterprise (abbreviated as Unified CCE). This manual references this product by the new name, though the new name does not appear in the Release 7.1(1) user interface. Note: These new names are introduced in Release 7.1(1). They are referenced in opening screens and documentation, but they do not yet appear throughout the user interface. (For example, the Supervisor Desktop title bar still reads "CTI Toolkit IPCC Supervisor Desktop," and there is still an "IPCC" selection on the CTI Login dialog Connect To pull-down menu.) Note: For more information about Cisco product and Unified CVP component names and acronyms, refer to the Glossary in the online help.
Organization
The manual is divided into the following chapters.
Part Chapter Description
Part 1, "Introduction to Chapter 1, "The Cisco Unified Customer Voice Cisco Unified Portal Solution" (page 9) Customer Voice Portal Chapter 2, "Configuration Overview" (page 27) (CVP)" Chapter 3, "Cisco Unified CVP Operations Console Overview" (page 163)
Introduces the Unified CVP components and how they interact with Unified ICMH. Provides background information and check-off lists for the various call flow model options available for Unified CVP. Describes the Unified CVP Operations Console and its menu options.
Chapter 4, "Writing Scripts for Unified CVP" Discusses Unified ICME configuration and (page 175) script editing. This chapter also provides a detailed description of the Unified CVP micro-applications. Chapter 5, "Using Cisco Support Tools with Unified CVP" (page 247) Describes the Cisco Support Tools and its supported features on Unified CVP on non-Windows boxes.
Chapter 6, "Configuring and Modifying Unified Describes Unified CVP security. CVP Security" (page 251)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Part
Chapter
Description
Part 2, "Configuration Chapter 7, "Configuring VXML Solution" (page Detail of Customer 273) Voice Portal Components" Chapter 8, "Configuring Unified CVP Logging and Event Notifications" (page 321)
Describes how to configure a VXML Server in either Standalone or Comprehensive deployment models. Describes how to configure external events and how to set trace levels and log levels.
Chapter 9, "Administering the H.323 Service" Gives an overview of the Unified CVP H.323 (page 353) Service and instructions for using the VBAdmin tool and commands. Part 3, "Configuration Detail of Non-Customer Voice Portal Components" Chapter 10, "Using Cisco Unified ICME Warm Details how to configure the Unified ICME Consult Transfer/Conference to Unified CVP" Warm Consult Transfer/Conference to Unified (page 385) CVP feature. Chapter 11, "Configuring Cisco Unified Communications Manager" (page 391) Describes how to use the Unified CVP Operations Console menus to add a pre-configured Unified CM Server to the network map. Provides the configuration tasks required for the SIP devices. Contains additional information about transferring and queuing calls with Unified CVP. Describes how to configure H.323 gateways, gatekeepers, Unified CM and ICM Server to perform inbound and outbound routing.
Chapter 12, "Configuring the SIP Devices" (page 397) Chapter 13, "Transferring and Queuing Calls with Unified CVP" (page 409) Chapter 14, "Configuring the H.323 Devices and VoIP" (page 453)
Chapter 15, "Configuring High Availability for Provides information about how to Unified CVP" (page 491) accommodate load balancing and redundancy in Unified CVP deployments. Chapter 16, "Configuring the Media Servers" Provides information about Unified CVP media (page 525) file handling and details about the system media files distributed with the Unified CVP solution. Part 4, "Using Unified Chapter 17, "Configuring the Basic Video and Describes the Unified CVP video call flow CVP Video Features" Full Video Call Flow Models (page 553)" models and provides instructions on how to configure them. Appendix A, "Localization Customization" Appendix A, "Localization Customization (page Describes the processes and application 645)" programming interfaces (API) provided for a developer to construct and deploy custom components that add additional language support for the VPD micro-application.
Related Documentation
Note: Planning your Unified CVP solution is an important part of the process in setting up Unified CVP. Cisco recommends that you read the Cisco Unified Customer Voice Portal Release 7.x Solution Reference Network Design (SRND) guide before configuring your Unified CVP
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
solution. With Unified CVP 7.x, the Planning Guide for Cisco Unified Customer Voice Portal has been incorporated into the SRND document. Unified CVP provides the following documentation: Cisco Security Agent Installation/Deployment for Cisco Unified Customer Voice Portal provides installation instructions and information about Cisco Security Agent for the Unified CVP deployment. We strongly urge you to read this document in its entirety. Cisco Unified Customer Voice Portal Release 7.x Solution Reference Network Design (SRND) provides design considerations and guidelines for deploying contact center voice response solutions based on Cisco Unified Customer Voice Portal (CVP) 7.x releases. Configuration and Administration Guide for Cisco Unified Customer Voice Portal describes how to set up, run, and administer the Cisco Unified CVP product, including associated configuration. Element Specifications for Cisco Unified CVP VXML Server and Unified Call Studio describes the settings, element data, exit states, and configuration options for Elements. Installation and Upgrade Guide for Cisco Unified Customer Voice Portal describes how to install Unified CVP software, perform initial configuration, and upgrade. Operations Console Online Help for Cisco Unified Customer Voice Portal describes how to use the Operations Console to configure Unified CVP solution components. Port Utilization Guide for Cisco Unified Customer Voice Portal describes the ports used in a Unified CVP deployment. Programming Guide for Cisco Unified CVP VXML Server and Unified Call Studio describes how to build components that run on the Cisco Unified VXML Server. Reporting Guide for Cisco Unified Customer Voice Portal describes the Reporting Server, including how to configure and manage it, and discusses the hosted database. Say It Smart Specifications for Cisco Unified CVP VXML Server and Unified Call Studio describes in detail the functionality and configuration options for all Say It Smart plugins included with the software. Troubleshooting Guide for Cisco Unified Customer Voice Portal describes how to isolate and solve problems in the Unified CVP solution. User Guide for Cisco Unified CVP VXML Server and Unified Call Studio describes the functionality of Call Studio including creating projects, using the Call Studio environment, and deploying applications to the Unified CVP VXML Server. For additional information about Unified ICME, see the Cisco web site (http://www.cisco.com/ en/US/products/sw/custcosw/ps1001/tsd_products_support_series_home.html) listing Unified ICME documentation.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Preface Conventions
Conventions
This manual uses the following conventions:
Convention Description
boldface font
Boldface font is used to indicate commands, such as user entries, keys, buttons, and folder and submenu names. For example: Choose Edit > Find. Click Finish.
italic font
Italic font is used to indicate the following: To introduce a new term. Example: A skill group is a collection of agents who share similar skills. For emphasis. Example: Do not use the numerical naming convention. A syntax value that the user must replace. Example: IF (condition, true-value, false-value) A book title. Example: See the Cisco CRS Installation Guide.
window font
Window font, such as Courier, is used for the following: Text as it appears in code or that the window displays. Example: <html><title>Cisco Systems,Inc. </
title></html>
< >
Angle brackets are used to indicate the following: For arguments where the context does not allow italic, such as ASCII output. A character string that the user enters but that does not appear on the window such as a password.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.
Documentation Feedback
You can provide comments about this document by sending email to the following address: mailto:ccbu_docfeedback@cisco.com We appreciate your comments.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Chapter 1
The Cisco Unified Customer Voice Portal Solution
This chapter introduces the Unified CVP components and how they interact with Unified ICME and Unified CVP Standalone VRU capability. It includes: A brief overview of the Unified CVP solution and some examples of call flow models. An introduction to the system and non-system components that make up the Unified CVP solution. A discussion about how Unified CVP uses SIP and H.323 to switch calls. An introduction to Unified CVP call flow models. Information about Quality of Service (QoS) and Unified CVP licensing. Note: This chapter contains important information for IVR application developers. It also might be of interest to Call Center Managers, Unified CVP System Managers, and Unified ICME System Managers. This chapter contains the following topics: About Unified CVP, page 9 Unified CVP Licensing, page 22 Where to Next?, page 25
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
10
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
Call Routing Support. Unified CVP provides call routing services for SIP (RFC 3261) and H.323 protocols. Existing customers can continue to use H.323 call services. Or, they can migrate to SIP over time. The Unified CVP solution can run as a hybrid, directing both SIP and H.323 calls until all call flows are switched over to SIP. VoiceXML Services. Unified CVP provides a platform for developing powerful, speech-driven interactive applications accessible from any phone. The VoiceXML platform includes: The Cisco Unified CVP VXML Server, a J2EE- and J2SE-compliant application server that dynamically drives the caller experience. The Cisco Unified Call Studio, a drag-and-drop graphical user interface (GUI) for the rapid creation of advanced voice applications.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
11
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
to select and play a video to their video-enabled callers. VMS has an embedded streaming video server, which delivers the video to callers. VXML Server. Executes advanced IVR applications by exchanging VoiceXML pages with the VoiceXML Gateways built-in voice browser. (For more information about the VXML Server, see Chapter 7 in Part 2, "Configuring VXML Solution (page 273).") Reporting Server. Receives reporting events from the IVR Service, the SIP Service, and the VXML Service. It is deployed together with a database management system, and it transforms and writes this reporting data into that database. (For more information about the Reporting Server, refer to the Reporting Guide for Cisco Unified Customer Voice Portal.)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
12
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
The Gatekeeper is the focus for high availability design in the H.323 protocol arena, and it is only used in Unified CVP implementations that use H.323 for call control. Like the SIP Proxy Server, it mixes directory lookup services with load balancing and failover capabilities, producing fault tolerance among H.323 endpoints. Unlike the SIP Proxy Server, control messages do not pass through it to target endpoints; the paradigm is instead that of a request/response server. For redundancy, Gatekeepers can be deployed in pairs using the HSRP (Hot Standby Routing Protocol), one redundant pair per site. Additionally, the VBAdmin SetGatekeeper command allows multiple IP addresses to be configured. The H.323 Service then keeps track of a currently active Gatekeeper from that list, beginning with the first, and sends all requests to that Gatekeeper. If the currently active Gatekeeper fails, it moves to the next one in the list, and that one becomes current. The H.323 Service continues to use it until it too fails, at which time it begins using the subsequent Gatekeeper in the list. When the list is exhausted, the next failover is back to the top. Note that for sizing purposes, each individual Gatekeeper should be sized to handle the entire load. Content Services Switch. Provides load-balancing services for servers. Speech Server. Provides speech recognition services and text-to-speech services for a VoiceXML Gateway. The MRCP ASR/TTS Server provides speech recognition services and text-to-speech services for VoiceXML Gateway. For capacity and redundancy reasons, a CSS is usually used to mediate between a farm of such servers; if no CSS is used, then Unified CVP can support a maximum of two. Cisco does not sell, OEM, or support any ASR/TTS Servers. Cisco does, however, test Unified CVP with Nuance and IBM offerings. A certification process is available to allow additional vendors to qualify the interoperability of their products with Unified CVP. Such certification is part of the Cisco Technology Developer Programfor more information, see http:// www.cisco.com/web/partners/pr46/tdp/index.html. Media Server. Hosts the media files that contain messages and prompts callers hear. The Media Server is a simple web server, such as Microsoft IIS or Apache. Its only purpose within Unified CVP is to store and serve up .wav files to the VoiceXML Gateway, as required in order to render VXML pages. As with ASR/TTS Servers, Media Servers can be deployed singly, as a redundant pair, or with CSS in a farm. Note that the VoiceXML Gateway caches .wav files it retrieves from the Media Server. In most deployments, the Media Server encounters extremely low traffic from Unified CVP. Cisco Unified Communications Manager (Unified CM). Manages and switches VoIP calls to IP phones; can originate and receive calls from either SIP or H.323 devices. When combined with Unified ICME it becomes Unified CCE. Unified CVP interacts with Unified CM primarily as a means for sending PSTN-originated calls to Unified CCE agents. However, several applications require that calls be originated
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
13
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
by Unified CCE agents instead. Specifically, Cisco Unified Outbound Option when used with Unified CCE, and calls that are being warm-consultative-transferred from one agent to another, are originated in this way. "Help desk" calls, in which an agent or other IP phone user calls Unified CVP (or calls a skill group and gets queued on Unified CVP), also fall into this category. A single Unified CM can originate and receive calls from both SIP and H.323 devices. ICM Server. Depending on the Unified CVP call flow model, can provide VoIP call switching capabilities, call control, information processing, and exchange of data. IVP Server. The Radvision IVP (Interactive Video Platform) is a media server platform for the development and delivery of enhanced interactive video communication services and applications. The IVR Controller (that is, IVP Server) is a component of the IVP platform that communicates and controls the various components of the IVP. Content Services Switch (CSS). Provides load-balancing and failover services for servers. The Content Services Switch (CSS) is the focus for high availability design in the TCP(Transmission Control Protocol) arena. The CSS can be placed between one (or more) VoiceXML Gateways and all its IVR Services, VXML Servers, Media Servers, and ASR/TTS Servers. Various mechanisms allow it to implement transparent load balancing and failover across these types of devices. CSS is an optional device, but it comes highly recommended. Without it, the IVR Service implements a "poor mans failover" mechanism for up to two of each of the above components, but they are not load balanced, and various retries and delays are part of the algorithmall of which is avoided if CSS is used. The CSS is normally deployed as a Virtual Router Redundancy Protocol (VRRP) pair. It is useful in all deployment models except for Call Director call flows. SIP Proxy Server. Routes individual SIP transport messages among SIP endpoints types and implements load balancing and failover among those endpoints. It plays a key role in Unified CVPs high availability architecture for call switching. It is designed to support multiple SIP endpoints of various types, and implements load balancing and failover among these endpoints. SIP Proxy Servers themselves can be deployed alone or as a pair. Unified CVP can also be deployed without a SIP Proxy Server. In such cases, some of the Proxy Server functions can be provided by the SIP Service, because it provides the ability to configure a static table to look up destinations. The benefits of using a SIP Proxy Server include: Priority and weight routing can be used with the routes for load balancing and failover If a SIP Proxy Server is already used in your SIP network, Unified CVP can be an additional SIP endpointit fits incrementally into the existing SIP network If the Cisco Unified Presence Server is being used as the SIP Proxy Server, dial plan management is available in the web administration of the static routes
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
14
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
If the Cisco Unified Presence Server is being used as the SIP Proxy Server, you are better positioned to also take advantage of Presence and Cisco Unified Client, as a compliment to Unified CVP If a SIP Proxy Server is not used, then Ingress Gateways and Unified CMs need to point directly to Unified CVP. In such a deployment: Load balancing is done via DNS SRV lookups from Gateway to DNS ServerSIP calls can be balanced using this mechanism Load balancing of calls outbound from Unified CVP (outbound call leg) can be done in similar fashion Failover of SIP rejections can also be performed if SRV records are configured with ordered priorities DNS Server. This optional component can be installed anywhere in the network. Its purpose, in general, is to resolve hostnames to IP addresses. However, it can also be configured with multiple IP addresses for the same hostname. Successive requests for a given hostname can be configured to return IP addresses in a round-robin fashion. Unified CVPs SIP design can make use of this capability in order to implement a sort of load balancing among multiple like components. The DNS (Domain Name System) Server comes into play during SIP interactions in the following situations: When a call arrives at an Ingress Gateway, the dial peer can use DNS to alternate calls between the two SIP Proxy Servers. The SIP Proxy Servers can also use DNS to distribute incoming calls among multiple SIP Services. If SIP Proxy Servers are not being used, then the Ingress Gateway can use DNS directly to distribute inbound calls among multiple SIP Services. When the SIP Service is instructed by Unified ICME to transfer the call to the VRU leg, it can use DNS to alternate such requests between two SIP Proxy Servers, and the SIP Proxy Servers can use DNS to distribute VRU legs among multiple VoiceXML Gateways. If SIP Proxy Servers are not being used, the SIP Service can use DNS directly to distribute VRU legs among multiple VoiceXML Gateways. When transferring a call to an agent using a SIP Proxy Server, the SIP Proxy Server can use DNS to identify the IP address target for that agent. Also, the SIP Service can use DNS to alternate such requests between the two SIP Proxy Servers. If SIP Proxy Servers are not being used, then the SIP Service can use DNS to locate the target agents IP address. Note that use of the DNS Server for SIP routing is entirely optional in Unified CVP. Network Monitor. An SNMP management station that can be used to monitor the solution deployment's health.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
15
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
For more information about setting up a SIP-based Unified CVP system, see Chapter 12, " Configuring the SIP Devices (page 397)," in Part 3. The following figure shows a VoIP H.323 Unified CVP system.
Figure 2: H.323-Based Unified CVP Solution
For more information about setting up an H.323-based Unified CVP system, see Chapter 14, "Configuring the H.323 Devices and VoIP (page 453)," in Part 3.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
16
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
SIP is a network communication protocol for initiating, modifying, and terminating interactive sessions between clients that involves multimedia elements such as voice, video, instant messaging, and so forth. SIP is intended to provide a superset of the call processing features available in the PSTN. SIP is the preferred protocol for Unified CVP: SIP provides improved scalability and performance to Unified CVP. With SIP, you are able to interoperate with both Cisco and non-Cisco SIP edge devices. As a generic session protocol, SIP is better able to handle non-voice media. SIP is becoming a de facto industry standard. H.323 support is primarily to provide backward compatibility for users of previous versions of Unified CVP. These are referred to as legacy deployments.
SIP
H.323
Clients (User Agents) are intelligent Servers (Proxy, Redirect, Registrar) provide network intelligence and services Follows the Internet/WWW model Uses UDP or TCP for signaling Uses RTP for media Is a full-featured multimedia protocol Is text-based (ASCII) Utilizes IETF/IP protocols - SDP, HTTP/1.1, SMTP, MIME,and so forth Only defines signaling, not all elements
Clients are intelligent Gatekeepers provide network intelligence and services Follows the Telephony/Q.SIG model Uses TCP for signaling (UDP optional in v3) Uses RTP for media Is a full-featured multimedia protocol Is binary-based (ASN.1 encoding) Utilizes ITU / ISDN protocols - H.225, H.245, H.450. Allportions fall under H.323 Interoperability is done with iNOW or IMTC
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
17
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
Note that certain call control capabilities, which are available in H.323, are not yet available in SIP. Customers who require these particular capabilities will wish to remain with H.323. In addition, most customers who are staying with H.323 are advised to move to Comprehensive call flow if they currently use Queue and Transfer, but there are some cases where these customers will not be able to do so. These situations are discussed below.
SIP Restrictions
SIP cannot perform all operations that H.323 can perform, because the endpoints, the Unified CVP implementation, or the protocol itself does not yet support those operations. Customers who require such call control capabilities must use H.323. The following are reasons why new customers might need to use H.323 for call control:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
18
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
Cisco PGW media gateway controller (MGC) in call control mode is used to initiate calls to Unified CVP GKTMP NIC is used for pre-routing Hook-flash is used to transfer calls
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
19
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
Might want to use optional VXML Server Might want to prompt/collect with optional ASR/TTS Comprehensive. For customers who: Want to use Unified CVP to provide Unified ICME with VoIP call switching capabilities Want to use Unified CVP to provide Unified ICME with VRU servicesincluding integrated self-service applications, queuing, and/or initial prompt and collect Want to use video IVR, video queuing, and video agent capabilities Note: See Chapter 17, "Configuring the Basic Video and Full Video Call Flow Models (page 553)," for detailed information about the Basic Video and Full Video call flow models. Might want to use optional VXML Server Might want to prompt/collect with optional ASR/TTS VXML Server (standalone). For customers who: Want to deploy self-service VoiceXML applications The deployment model you choose depends on the call flow preferences, geographic distribution requirements, and hardware configurations that best satisfies your company's needs. Note: For information about how to choose the appropriate deployment model for your site, see the Cisco Unified Customer Voice Portal Release 7.x Solution Reference Network Design (SRND). For instructions about how to configure the deployment model you choose, see Chapter 2, "Configuration Overview (page 27)." See Chapter 17, "Configuring the Basic Video and Full Video Call Flow Models (page 553)," for detailed information about the Basic Video and Full Video call flow models.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
20
Chapter 1: The Cisco Unified Customer Voice Portal Solution About Unified CVP
SIP-Based Call Flow Calls arrive from a PSTN via a TDM connection into an Ingress Gateway. The Ingress Gateway sends a new call message to the SIP Proxy Server, which forwards it to the SIP Service. The SIP Proxy Server, in addition to forwarding SIP messages to appropriate devices, also provides failover and redundancy support for those devices. The SIP Service consults Unified ICME (actually, in this particular case, Unified CCE) via the ICM Service (this and all subsequent interactions between any Unified CVP component and Unified ICME pass through the ICM Service). This consultation causes Unified ICME to run a routing script. The routing script requires the call to be transferred to a VRU, so Unified ICME instructs the SIP Service to extend a second call leg (that is, deliver the call) to a VoiceXML Gateway (which is often identical with the Ingress Gateway). The VoiceXML Gateway sends a message to the IVR Service, which then requests scripted instructions from Unified ICME. Unified ICME exchanges VRU instructions with the VoiceXML Gateway via the IVR Service. Among these VRU instructions can be requests to the VoiceXML Gateway to invoke more sophisticated applications on the VXML Server. Such requests will result in multiple exchanges between the VXML Server and the VoiceXML Gateway, ultimately ending in a reply to Unified ICME via the IVR Service. VXML Server applications are designed and built using Call Studio (not shown in the diagram, since it is essentially an offline tool). Once the self service portion of the call is completed, the Unified ICME routing script places the caller into queue. This call is already at a VRU, and it waits there for the agent to become available. Meanwhile, further VRU instructions are exchanged between Unified ICME and the VoiceXML Gateway via the IVR Service to play messages and recorded music. When the agent becomes available, Unified ICME sends a message to the SIP Service, which forwards a message via the SIP Proxy Server to the Ingress Gateway and to Unified CM to transfer the call away from the VoiceXML Gateway and deliver it to the Unified CM phone. During the VRU exchanges, the VoiceXML Gateway interacts with an ASR/TTS Server to have text played as speech or speech recognized as data, and with a Media Server (not shown in the diagram, but connected to the VoiceXML Gateway) to fetch audio files and prompts. These two devices, as well as the VXML Server, can be located behind a Content Services Switch (CSS), which offers them sophisticated failover and redundancy capability. (CSSs are optional, though recommended, and are not displayed in the diagram.) During this entire process, the SIP Service, the IVR Service, and the VXML Server send a stream of reporting events to the Reporting Server (not shown in the diagram, but connected to the Call Server), which processes and stores the information in a database for later reporting. All these devices also use SNMP (Simple Network Management Protocol) to support amonitoring
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
21
Chapter 1: The Cisco Unified Customer Voice Portal Solution Unified CVP Licensing
console. Cisco Unified Operations Manager can also be configured to process and forward SNMP events to higher-level monitoring stations such as HP OpenView. All components in the solution can be managed by the Operations Console (not shown in the diagram, but connected to all the components that it manages). The Operations Console uses a variety of means to pull together the configuration, management, and monitoring of the entire solution into a single station, which can be accessed via a standard web browser.
Figure 4: H.323-Based Unified CVP Solution
H.323-Based Call Flow If you are using H.323-based call control instead of the SIP-based call control described above, then the SIP Proxy Server and SIP Service are replaced by a Gatekeeper and H.323 Service. The message paths are a bit different as well; the Ingress Gateway consults the Gatekeeper but does not pass messages through it, and the H.323 Service communicates with the IVR Service rather than directly with Unified ICME.
Quality of Service
Quality of Service (QoS) is the measure of transmission quality and service availability of a network (or internetworks). Unified CVP implements Layer 3 QoS defaults on all relevant network paths, and provides a management interface via the Operations Console to modify QoS settings at each end of specifically designated data paths. Note: For instructions on configuring QoS for Unified CVP, refer to the Operations Console online help. For more information about QoS design, see the Enterprise QoS Solution Reference Network Design Guide.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
22
Chapter 1: The Cisco Unified Customer Voice Portal Solution Unified CVP Licensing
Unified CVP licenses: Call Server - The SIP Service and the IVR Service check at startup time to ensure that it is running on a system with a valid Call Server license. VXML Server - The VXML Server checks at startup time to ensure that it is running on a system with a valid VXML Server license. Reporting Server - The Reporting Server checks at startup time to ensure that it is running on a system with a valid Reporting Server license. The Operations Server runs without requiring a license. The H.323 Service is a licensed component, but requires no license file. In addition, each Call Server and each VXML Server enforce licenses for a particular number of simultaneous calls. The software does not distinguish between Call Director calls, VRU-only calls, or VRU calls with ASR/TTS or VXML. Port licensing is enforced as follows: The Call Server is licensed for a certain number of ports; SIP and IVR Services share this port pool. The SIP Service attempts to allocate one of its licenses whenever it receives an incoming call. Once the last license has been allocated, the SIP Service changes its status and that of its host Call Server (the Call Server on which the SIP Service is running) to Partial status, preventing further calls from being accepted. When a call terminates, the SIP Service releases a license, and if it had been in Partial status due to license depletion, it resumes Up status. Note: You can view the devices in a particular device pool by choosing Control Center from the System menu and then selecting the Device Pool tab and choosing a device pool. You can also view a particular type of device by selecting the Device Type tab and choosing a device type. The IVR Service can receive calls either directly from the H.323 Service, or transferred from the SIP Service or some other source. The IVR Service can handle both the VRU leg and the switch leg of the same call. The IVR Service keeps a list of active Call IDs, and uses that list to determine whether a particular incoming call has already been counted. Therefore, the IVR Service always accepts an incoming call if its host Call Server (the Call Server on which the IVR Service is running) is in the Up state, and then checks whether the call has been seen before. If the call has not been seen before, the IVR Service allocates a license for that call. If doing so exhausts the available licenses, the IVR Service changes its state and that of its host Call Server to Partial. When a call terminates, the IVR Service releases a license and if it had been in Partial state due to license depletion, it resumes Up status. Please note that this licensing scheme might change in future releases, and should customers order an insufficient number of licenses, they will be impacted in future releases when licensing tracks the number of ports actually ordered.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
23
Chapter 1: The Cisco Unified Customer Voice Portal Solution Unified CVP Licensing
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
24
Chapter 1: The Cisco Unified Customer Voice Portal Solution Where to Next?
When Unified CVP passes 5,000 database writes (the sum of both inserts and updates) for a day, it sends an alarm and no longer writes messages to the database. When the local date changes Unified CVP resumes writing to the database and tracking the number of writes. See Also For more comprehensive information on licensing, refer to the Cisco Unified Customer Voice Portal (CVP) Release 7.x Solution Reference Network Design (SRND) document.
Where to Next?
To learn more about: Unified CVP call flows and physical models, see Chapter 2, "Configuration Overview (page 27)." Chapter 2 is a configuration map that provides an overview of the configuration steps needed for each call flow model, with references to more detailed information for each configuration step. Unified CVP video call flows and physical models, see Chapter 17, "Configuring Basic Video and Full Video (page 553)" in Part 4. Chapter 17 provides an overview of the configuration steps needed for the Basic Video and the Full Video call flow models.
Developer Services
Questions and/or support issues related to such items as Call Studio scripting or ASR grammar ARE NOT covered by Cisco Technical Support. Note: Cisco Technical Support is limited to standard Cisco product installation/configuration, and Cisco-developed applicationsit does not include services or support for items such as those just mentioned. A separate service agreement and subscription fee is required to participate in the Developer Services Program. For more details on how to subscribe, go to Getting Started! on the Developer Support Web site at http://www.cisco.com/go/developersupport. Developers using Call Studio scripts, ASR, and the like might be interested in joining the Cisco Developer Services Program. This fee-based subscription program was created to provide you with a consistent level of Services that you can depend on while leveraging Cisco interfaces in your development projects. The Developer Services Program provides formalized services for Cisco Systems interfaces to enable developers, customers, and partners in the Cisco Technology Developer Program to accelerate their delivery of compatible solutions.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
25
Chapter 1: The Cisco Unified Customer Voice Portal Solution Where to Next?
The Developer Services Engineers are an extension of the product technology engineering teams. They have direct access to the resources necessary to provide expert support in a timely manner. See Also For additional information, refer to Frequently asked Questions about the Program and Support under Q&A on the Developer Support Web site at http://www.cisco.com/go/developersupport.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
26
Chapter 2
Configuration Overview
This chapter provides a configuration map overview of the information you need to know about configuring the Unified CVP call flow models. (Detailed configuration instructions are documented in Parts 2 and 3.) The maps outline the required configuration for all Unified CVP solution components in a call flow model, providing references to chapters in this guide or other Cisco documents for detailed instructions. Note: See Chapter 17, "Configuring the Basic Video and Full Video Call Flow Models (page 553)," for detailed information about the Basic Video and Full Video call flow models. Before using the configuration instructions in this chapter, you must first consult the Cisco Unified Customer Voice Portal Release 7.x Solution Reference Network Design (SRND) athttp:/ /www.cisco.com/en/US/products/sw/custcosw/ps1006/ products_implementation_design_guides_list.html to understand and choose the appropriate call flow model for your site. See "Related Documentation (page 3)" in the Preface for the complete list of Unified CVP solution documentation. This chapter discusses: "Overview of Unified CVP Call Flow Models (page 29):" Describes the Unified CVP call flow models. Note: The Unified CVP call flow models (formerly called "deployment models") are the available deployment scenarios you can use for your particular Unified CVP solution. "Network VRU Types and Unified CVP Call Flow Models (page 31):" Describes how Network VRU Types relate to the Unified CVP call flow models. "Before You Begin (page 33):" Information you need to know before configuring your Unified CVP solution.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
27
"Where to Go from Here? (page 36):" Provides links to all the configuration instructions and tasks documented in this chapter. This chapter includes information for (or pointers to information for) configuring the Gateway, Gatekeeper, Unified ICME VRU handling, Unified CVP Call Server (includes the SIP Service, ICM Service, and IVR Service), and the Unified CVP H.323 Service. This chapter does not include: Basic Video and Full Video call flow information. See Chapter 17, "Configuring the Basic Video and Full Video Call Flow Models (page 553), for detailed information. Detailed Unified ICME configuration for configuring agents or writing scripts. Complete configuration for every component of the system (for example, the TDM side of the Voice Gateway configuration). Note: Refer to the component's documentation for detailed configuration information. The information in this chapter assumes that you are already familiar with: Configuring Cisco Gateways and Gatekeepers. The ICM Configuration Manager and ICM Script Editor tools for call center operations and management. Configuring Unified CM. Note: You must have a copy of the following Unified ICME documentation available in addition to this manual in order to successfully configure Unified ICME and use its features in conjunction with Unified CVP: ICM Configuration Guide for Cisco ICM Enterprise Edition and ICM Scripting and Media Routing Guide for Cisco ICM/IPCC Enterprise & Hosted Editions. Refer to the Unified ICME documentation (http://www.cisco.com/en/US/products/sw/ custcosw/ps1001/tsd_products_support_series_home.html) for detailed information about Unified ICME. Call Studio's drag-and-drop scripting interface is available to create VoiceXML scripts. See the "Integrating VoiceXML Scripts with Unified ICME Scripts (page 303)" section in Chapter 7, "Configuring VXML Solution," in Part 2 for more information. This chapter contains the following topics: Overview of Unified CVP Call Flow Models, page 29 Network VRU Types and Unified CVP Call Flow Models , page 31 Before You Begin, page 33 Where to Go from Here?, page 36
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
28
Unified CVP Standalone Call Flow Models, page 38 Unified CVP Call Director Call Flow Models, page 54 Unified CVP Comprehensive (SIP/H.323) Call Flow Models, page 78 Unified CVP VRU Call Flow Models with NIC Routing, page 120 Unified CVP Comprehensive Call Flows for Pre-Routed Calls, page 147 Common Unified ICMH Configuration for Unified CVP Switch Leg, page 153 Common Unified ICMH Configuration: Define Unified CVP ECC Variables, page 155 Using Metadata ECC Variables, page 159 Common Configuration for Differentiating VRUs (Unified CVPs) Based on Dialed Number, page 160 Gatekeeper Redundancy , page 161 Local SRV File Configuration Example for SIP Messaging Redundancy, page 162
Description
Unified CVP VXML Server (Standalone) Call Flow Model (page 38)
In this call flow model, the VXML Server is a J2EE-compliant server that provides a complete solution for rapidly creating and deploying dynamic VoiceXML applications. You can install the VXML Server as a standalone component, without Unified ICME, the Unified CVP Call Server, or H.323 Service components.
Unified CVP Standalone with ICM Lookup Call This call flow model is the same as the Unified CVP VXML Server Flow Model (page 47) (standalone) call flow model, except that it has the additional capability of invoking a routing script in Unified ICME and receiving a response. Unified CVP Call Director (SIP/H.323) Call Flow Model, Unified ICME (page 54) In this call flow model, Unified CVP only provides Unified ICME with VoIP call switching capabilities. You provide your own Service Control VRU, if you are using Unified ICME to queue calls or you might queue calls directly on your ACD. Calls might be transferred multiple times, from Ingress, to customer-provided VRU, to either Unified CCE or customer-provided ACD or agent, and back again. When calls are connected to customer-provided equipment (either VoIP or TDM), their voice paths must go to an egress gateway, which is connected by TDM to that equipment. If the signaling is SIP, then this call flow model works with customer-provided SIP endpoints which have been tested and certified to interoperate with Unified CVP. Note: The Call Director call flow model is the most inclusive call flow because it potentially incorporates all components of the Unified CVP solution. Unified CVP Call Director (SIP/H.323) Call Flow Model, Unified ICMH (page 76) In this call flow model, Unified CVP only provides the Network Applications Manager (NAM) with VoIP call switching capabilities. You provide your own Service Control VRU, if you are using the
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
29
Description
NAM to queue calls or you might queue calls directly on your ACD. Calls might be transferred multiple times, from Ingress, to customer-provided VRU, to either the NAM or customer-provided ACD or agent, and back again. When calls are connected to customer-provided equipment, their voice paths must go to an egress gateway, which is connected by TDM to that equipment. If the signaling is SIP, then this call flow model works with customer-provided SIP endpoints which have been tested and certified to interoperate with Unified CVP. Note: In a two-tier service bureau (carrier) configuration, the NAM is the tier providing direct communication with the carrier PSTN. Route requests arrive at the NAM from the IXC carrier network and are forwarded, based on specific call properties, to the appropriate Customer ICM (CICM). A NAM usually contains only a small configuration that allows it to directly route a subset of calls and dispatch other calls to the appropriate CICM. The NAM receives route responses from all CICMs and forwards them to the carrier network. Unified CVP Comprehensive (SIP/H.323) Call In this call flow model, Unified CVP acts as the Switch, transferring Flow Model, Unified ICME (page 79) the call to the Network VRU and to agents. The Unified CVP IVR Service in the Operations Console is also configured to work with the VoiceXML Gateway to provide VRU treatment, which might include ASR/TTS and VXML Server applications. Note: For details on the Basic Video and Full Video call flow models, see Chapter 17, "Configuring the Basic Video and Full Video Call Flow Models (page 553). Unified CVP Comprehensive (SIP/H.323) Call In this call flow model, Unified CVP is deployed at the NAM where Flow Model, Unified ICMH (page 118) it acts as the Switch, transferring the call to the Network VRU (using the Correlation ID transfer mechanism) and to agents. The Unified CVP IVR Service in the Operations Console is also configured to work with the VoiceXML Gateway to provide VRU treatment, which might include ASR/TTS and VXML Server applications. Type 8 Unified CVP VRU-Only Call Flow Model, Unified ICME (page 121) In this call flow model, Unified CVP works with the Voice Gateway to act as the VRU; VRU voice treatment is provided by the Gateway and can include ASR/TTS and VXML Server applications. This model would be used when call switching is provided by some component other than Unified CVP, such as a Unified ICME NIC. In this call flow model, the Unified CVP Call Server is deployed at the CICM level to act only as the VRU leg for the call. The VRU voice treatment is provided at the Voice Gateway, and might include ASR/TTS and VXML Server applications. This model would be used when call switching is provided by some component other than Unified CVP, such as a Unified ICME NIC. Note: The CICM is the Customer ICM. In the optional two-tier service bureau (carrier) configuration, the CICM is the tier providing the
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Type 8 Unified CVP VRU-Only Call Flow Model, Unified ICMH (page 130)
30
Chapter 2: Configuration Overview Network VRU Types and Unified CVP Call Flow Models
Description
carrier customer-specific routing function. CICMs receive customer-specific call route requests from the NAM; they typically perform more elaborate scripted call routing using customer-specific advanced services or agent and skill context. Type 3 or 7 Unified CVP VRU-Only Call Flow In this call flow model, Unified CVP is deployed as a Network VRU Model Network VRU, Unified ICMH (page 139) at the NAM. The Unified CVP IVR Service in the Operations Console works with the Voice Gateway to act as the VRU; VRU voice treatment is provided at the Voice Gateway and can include ASR/TTS and VXML Server applications. (This call flow model is used when Unified CVP is connected to the NAM.) This model would be used when call switching is provided by some component other than Unified CVP, such as a Unified ICME NIC. Unified CVP Geographic models: Centralized Single-Site Centralized Multi-Site Centralized Branch Standalone Branch Unified CVP Physical models: Typical for Unified ICME Integrated Typical for Standalone Streamlined for SIP Call Director Laboratory (All-in-a-Box) Configuration instructions for these models are not listed in this guide. Refer to the Cisco Unified Customer Voice Portal Release 7.x Solution Reference Network Design (SRND) athttp://www.cisco.com/en/US/ products/sw/custcosw/ps1006/ products_implementation_design_guides_list.html for details about these models.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
31
Chapter 2: Configuration Overview Network VRU Types and Unified CVP Call Flow Models
Type - This is a number from 2 to 10, and corresponds to the types described above. Labels - This is a list of labels, which Unified ICME can use to transfer a call to the particular Network VRU being configured. These labels are only relevant for Network VRU's of Types 3, 7, and 10 (that is, those that use the Correlation ID mechanism to transfer calls). They are also required, but never used in the case of Type 5. (Labels for Types 8 and 2 are defined in the ICM Configuration Manager's Translation Route Explorer tool, and invoked via a TranslationRouteToVRU node.) Each label is made up of two parts: A digit string, which becomes a DNIS that can be understood by the gatekeeper (when using H.323), by a SIP Proxy Server or static route table (when using SIP without a Proxy Server), SIP), or by gateway dial-peers. A routing client (also known as a switch leg peripheral). In other words, each peripheral device which can act as a switch leg must have its own label, even if the digit strings are the same in all cases. Unified ICME Release 7.1(1) introduced Network VRU Type 10, which simplifies the configuration of Network VRUs for Unified CVP. For most call flow models, a single Type 10 Network VRU can take the place of the Type 2, 3, 5, 7, or 8 Network VRUs, which were associated with the Customer Instance and/or the Switch and VRU leg peripherals. The VRU-Only call flow models still require Type 8; however, in one specific case Type 3 or 7 is still required. Network VRU configuration entries themselves have no value until they are associated with active calls. There are three places in Unified ICME where this association is made: Advanced tab for a given peripheral in the ICM Configuration Manager's PG Explorer tool Customer Instance configuration in the ICM Configuration Manager's ICM Instance Explorer tool On every VRU Script configuration in the ICM Configuration Manager's Network VRU Script List tool Depending on the call flow model, Unified ICME looks at either the peripheral or the customer instance to determine how to transfer a call to a VRU. Generally speaking, Unified ICME examines the Network VRU which is associated with the switch leg peripheral when the call first arrives on a switch leg, and the Network VRU which is associated with the VRU leg peripheral when the call is being transferred to VRU using the Translation Route mechanism. It examines the Network VRU, which is associated with the Customer Instance or the default Network VRU from the System Information tool, when the call is being transferred to the VRU using the Correlation ID mechanism. Unified ICME also examines the Network VRU which is associated with the VRU Script every time it encounters a RunExternalScript node in its routing script. If Unified ICME does not believe the call is currently connected to the designated Network VRU, it will not execute the VRU Script.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
32
Note: The previously recommended VRU types still work as before, even in Unified ICME 7.1(1) and later; however, new installations must use Type 10 if possible, and existing installations can optionally switch to Type 10. See Also Refer to the Cisco Unified Customer Voice Portal Release 7.x Solution Reference Network Design (SRND) and each call flow model's configuration instructions in this chapter for detailed information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
33
components to deliver the call to an appropriate VoiceXML gateway. Such labels are part of the overall dialed number plan of the contact center, and must be determined prior to configuring Unified CVP. For call flow models that use Network VRUs of Type 3, 7, or 10: Determine the Network Routing Number. This number is the base for routing calls through the network to the VRU; a correlation ID is appended to this number to transfer calls to a Network VRU through the network. For call flow models with a Customer VRU, and in Unified ICMH environments, and for NIC Type 8 call flow models: Determine the translation route pools to use for each VRU. Determine the labels to be sent to the network to connect the call to the VRU and the corresponding DNIS that will be seen by the VRU. For example, the label for the network might be 18008889999 and the DNIS received by the VRU and sent back to Unified ICME to identify the call might be 9999.
Naming Schemes
Define naming schemes to be used for Unified ICME PGs, Peripherals, and routing clients.
Installation
Before using the information in this chapter, you need to do the following: Install the Unified CVP software. Note: Refer to the Installation and Upgrade Guide for Cisco Unified Customer Voice Portal for complete installation instructions. Install all the solution components. If you are using Unified CVP as a Unified ICME queuing platform, make sure the VRU PGs use service control with Service Control reporting enabled. If you are using it strictly as a self-service platform, disable Service Control reporting. Also, take note of the VRU Connection Port used for each VRU PG peripheral (PIM). Note: Refer to the Reporting Guide for Cisco IPCC Enterprise & Hosted Editions and the Reporting Guide for Cisco Unified ICM Enterprise & Hosted (both available at http:// www.cisco.com/en/US/products/sw/custcosw/ps4145/products_user_guide_list.html) for more information on IVR-related Service Control reporting and queue reporting. Make sure the NIC cards, Voice GW, and network components all have the Ethernet interfaces configured with matching speed and duplex settings. Note: See the Setting Speed and Duplex for Unified CVP (page 35) for details about the required Ethernet Switch / Server NIC settings. Refer to the Cisco Unified Customer Voice Portal Release 7.x Solution Reference Network Design (SRND) for additional information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
34
1000/ Full Auto / Auto 100 Mb / Full 100 Mb / Full 100 Mb / Full
1000/ Full Auto / Auto 100 Mb / Full 100 Mb / Full 100 Mb / Full
When using the "Auto" option, be aware that this option is only applicable for matched port/NIC at Gigabit Ethernet. Select 1000/Full on a Gigabit interface when you are unsure of the adjacent station configuration; unless both stations supply Gigabit interfaces, avoid using the Auto option.
Log into the gateway. Type enable and the password to enter enable mode. Configuration changes can be made only in enable mode.
Enter the configure terminal command to enter configuration mode. Use the ivr contact-center command to apply default debug settings. Configure the logging buffer size. For example, set logging buffer <numeric value> The recommended logging buffer size is 1000000.
Step 6
Exit configuration mode and return to the enable prompt by pressing Ctrl-Z. To see the current operating configuration, including the change you just made, enter the show running-config command: gw# show running-config
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
35
Step 7
To persist configuration changes (make changes permanent), enter the copy running-config startup-config command at the enable prompt: gw# copy running-config
startup-config
Description
Unified CVP VXML Server (Standalone) Call Flow Model (page 38)
In this call flow model, Unified CVP VXML Server is a J2EE-compliant server that provides a complete solution for rapidly creating and deploying dynamic VoiceXML applications. You can install the VXML Server as a standalone component, without Unified ICME, the Unified CVP Call Server, or H.323 Service components.
Unified CVP Standalone with ICM This call flow model is the same as the Unified CVP VXML Lookup Call Flow Model (page Server (standalone) call flow model, except that it has the 47) additional capability of invoking a routing script in Unified ICME and receiving a response. Unified CVP Call Director (SIP/H.323) Call Flow Model, Unified ICME (page 54) In this call flow model, Unified CVP only provides Unified ICME with VoIP call switching capabilities. You provide your own Service Control VRU, if you are using Unified ICME to queue calls or you might queue calls directly on your ACD. Calls might be transferred multiple times, from Ingress, to customer-provided VRU, to either Unified CCE or customer-provided ACD or agent, and back again. When calls are connected to customer-provided equipment (either VoIP or TDM), their voice paths must go to an egress gateway, which is connected by TDM to that equipment. If the signaling is SIP, then this call flow model works with customer-provided SIP endpoints which have been tested and certified to interoperate with Unified CVP. In this call flow model, Unified CVP only provides the Network Applications Manager (NAM) with VoIP call switching capabilities. You provide your own Service Control VRU, if you are using the NAM to queue calls or you might queue calls directly on your ACD. Calls might be transferred multiple times, from Ingress, to customer-provided VRU, to either the NAM or customer-provided ACD or agent, and back again. When calls are connected to customer-provided equipment, their
Unified CVP Call Director (SIP/H.323) Call Flow Model, Unified ICMH (page 76)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
36
Description
voice paths must go to an egress gateway, which is connected by TDM to that equipment. If the signaling is SIP, then this call flow model works with customer-provided SIP endpoints which have been tested and certified to interoperate with Unified CVP. Unified CVP Comprehensive (SIP/H.323) Call Flow Model, Unified ICME (page 79) In this call flow model, Unified CVP acts as the Switch, transferring the call to the Network VRU and to agents. The Unified CVP IVR Service in the Operations Console is also configured to work with the VoiceXML Gateway to provide VRU treatment, which might include ASR/TTS and VXML Server applications. Note: For details on the Basic Video and Full Video call flow models, see Chapter 17, "Configuring the Basic Video and Full Video Call Flow Models (page 553). Unified CVP Comprehensive (SIP/H.323) Call Flow Model, Unified ICMH (page 118) In this call flow model, Unified CVP is deployed at the NAM where it acts as the Switch, transferring the call to the Network VRU (using the Correlation ID transfer mechanism) and to agents. The Unified CVP IVR Service in the Operations Console is also configured to work with the VoiceXML Gateway to provide VRU treatment, which might include ASR/TTS and VXML Server applications.
Type 8 Unified CVP VRU-Only In this call flow model, Unified CVP works with the Voice Call Flow Model, Unified ICME Gateway to act as the VRU; VRU voice treatment is (page 121) provided by the Gateway and can include ASR/TTS and VXML Server applications. This model would be used when call switching is provided by some component other than Unified CVP, such as a Unified ICME NIC. Type 8 Unified CVP VRU-Only In this call flow model, the Unified CVP Call Server is Call Flow Model, Unified ICMH deployed at the CICM level to act only as the VRU leg for (page 130) the call. The VRU voice treatment is provided at the Voice Gateway, and might include ASR/TTS and VXML Server applications. This model would be used when call switching is provided by some component other than Unified CVP, such as a Unified ICME NIC. Type 3 or 7 Unified CVP VRU-Only Call Flow Model Network VRU, Unified ICMH (page 139) In this call flow model, Unified CVP is deployed as a Network VRU at the NAM. The Unified CVP IVR Service in the Operations Console works with the Voice Gateway to act as the VRU; VRU voice treatment is provided at the Voice Gateway and can include ASR/TTS and VXML Server applications. (This call flow model is used when Unified CVP is connected to the NAM.) This model would be used when call switching is provided by some component other than Unified CVP, such as a Unified ICME NIC.
Unified CVP Comprehensive Call This class of call flows is similar to the Unified CVP Flows for Pre-Routed Calls (page Comprehensive call flow models, except that calls are first 147) introduced into Unified ICME or Unified ICMH using some
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
37
Description
path other than through Unified CVP. A Unified ICME routing script is given the chance to "pre-route" such calls before Unified CVP ever sees them. Once the script transfers the call to Unified CVP, for either self-service or queuing, a more standard Unified CVP Comprehensive call flow model is used. Common Unified ICMH Configuration for Unified CVP Switch Leg (page 153) Common Unified ICMH Configuration: Define Unified CVP ECC Variables (page 155) Using Metadata ECC Variables (page 159) Describes Unified ICMH configuration instructions common to Comprehensive Unified ICMH and VRU-Only with NIC routing, with Correlation ID call routing call flow models for Unified CVP switch legs. Provides instructions on how to set up ECC variables that Unified CVP uses to exchange information with Unified ICMH. Defines the values for the user.microapp.metadata ECC variable.
Common Configuration for Provides instructions on how to configure Unified ICME Differentiating VRUs (Unified to differentiate the VRUs. CVPs) Based on Dialed Number (page 160) Gatekeeper Redundancy (page 161) As of CVP 3.1 SR1, Hot Standby Router Protocol (HSRP) is no longer the only method of Gatekeeper redundancy. Instead, Gatekeeper Clustering and Alternate Gatekeeper configuration on Unified CVP is the preferred method of Gatekeeper redundancy. SIP Proxy Redundancy See the "How to Set Up the Ingress Gateway to Use Redundant Proxy Servers (page 402)" and the "How to Set Up the Unified CVP Call Server with Redundant Proxy Servers (page 403)" sections in Chapter 12, "Configuring the SIP Devices," in Part 3 for details.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
38
the VXML Server as a standalone component, without the Unified CVP Call Server or H.323 Service components (without reporting). The Unified CVP VXML Server (standalone) call flow model is available in the following variations: Standalone without reporting: Use the VXML Server (Standalone) option in the Operations Console (see the "Configuration Checklist, Unified CVP VXML Server (Standalone) Call Flow Model without Reporting (page 41)" table for configuration instructions). (This call flow model does not require a Call Server and a Reporting Server.) Standalone with reporting: Use the VXML Server option in the Operations Console (see the "Configuration Checklist, Unified CVP VXML Server (Standalone) Call Flow Model with Reporting" (page 42) table for configuration instructions). (This call flow model requires a Call Server and a Reporting Server.) Standalone adding reporting after VXML Server (Standalone) has already been configured: Configure the Unified CVP Call Server, delete the VXML Server (Standalone), and use the VXML Server option in the Operations Console to add the VXML Server (see the "Configuration Checklist, Unified CVP VXML Server (Standalone) Call Flow Model Adding Reporting" (page 44) table for configuration instructions). In this call flow model with reporting, the Unified CVP Call Server is used to route messages between the components. Calls arrive through a VoiceXML gateway and interact directly with a VXML Server to execute VoiceXML applications. The gateway performs both ingress and VoiceXML functions. This call flow model provides a sophisticated VoiceXML-based VRU, for applications which in many cases do not need to interact with an Unified ICME Server. Some of the features of this option include: VoiceXML features to control: Audio input and output Presentation logic Call flow Telephony connections Event handling for errors ASR/TTS Digit detection and generation count Drag-and-drop Graphical User Interface for the rapid creation of voice applications. VXML Server provides a J2EE-compliant development framework.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
39
In the Unified CVP VXML Server (standalone) call flow model, only the VXML Server, Call Studio, and a Gateway are required, except when using reporting which requires a Call Server and a Reporting Server. (This standalone model functions similar to the Unified CVP VRU-Only call flow model (page 120).) Note: This call flow model allows only one synchronous blind or bridged transfer. (Asynchronous blind transfer indicates that once the call has been transferred, a Unified CVP Standalone script has no ability to asynchronously take it back and deliver it somewhere else, whereas Unified ICME scripts, in the Unified ICME-integrated models, do have that ability.) The following figure displays the call flow for the Unified CVP VXML Server (standalone) call flow model.
Figure 5: Unified CVP VXML Server (Standalone) Call Flow Model
The following call flow description assumes the following: When using reporting, a Unified CVP Call Server has been defined using the Operations Console. The VXML Server has been installed and licensed. A Call Studio application has been created. The Call Studio application must be deployed on the VXML Server. The call flow in the figure above is as follows: 1. The call arrives from the PSTN network to the Gateway. 2. The Gateway sends a HTTP URL request to the VXML Server. 3. VXML Server returns the VoiceXML to be executed on the Gateway Voice Browser. 4. The VoiceXML returned to the Gateway can include references to ASR/TTS and Media Servers to recognize voice input, play TTS files, and play .wav files, respectively. 5. The gateway can, optionally, transfer the call to any destination that it can deliver a call to, such as Unified CM. 6. Unified CM can then send the call to an agent.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
40
Configuration Instructions for Unified CVP VXML Server (Standalone) Call Flow Model without Reporting
The following table contains the configuration instructions for this call flow model when not using reporting.
Table 4: Configuration Checklist, Unified CVP VXML Server (Standalone) Call Flow Model without Reporting
Where to Go/What to Do
[]
Transfer the appropriate scripts to the Gateway for In the Operations Console, select Device Management use with the VXML Server: > Gateway > File Transfer > Scripts, then browse to the <cvp root>\Cisco\CVP\OpsConsoleServer 1. Transfer the following files using the Unified \GWDownloads folder. CVP Operations Console: Refer to the Operations Console online help for detailed CVPSelfService.tcl instructions. Note: Gateway configuration example can be found with this file. CVPSelfServiceBootstrap.vxml critical_error.wav
Note: Optionally, you can transfer the files from the Unified CVP product CD. [] Configure the Gateway for VXML Server (Standalone) applications: 1. Define the VXML Server applications on the gateway. Do the following: For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings for VXML Server (Standalone) (page 51)" section.
Note: Backup server is optional. For the For Step 4, see the "VoiceXML Gateway Tomcat Application Server and the WebSphere Configuration: Example of Dial-peer for VXML Application Server, set the port to 7000. Also, Server (Standalone) (page 53)" section. the backup server cannot be the same server as the Primary Server. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure a dial-peer, which will call the service to reach the Unified CVP VXML Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
41
Where to Go/What to Do
5. Optionally, create additional dial-peers for any outgoing transfer destinations your application uses. Review the updated gateway configuration by issuing a show run to ensure you have configured the gateway properly. [] Create an application: 1. Create an application using Call Studio and deploy it as a zip file. For detailed information, see the "Deploying VoiceXML Scripts Using Call Studio (page 245)" section in Chapter 7, "Configuring VXML Solution," in Part 2. Also, refer to the User Guide for Cisco Unified CVP VXML Server and Unified Call Studio for information about using Call Studio. In the Operations Console, select Device Management > VXML Server (standalone).
[]
1. In the Operations Console, configure a VXML Server (standalone). See the "Configuring the VXML Server (Standalone) Call Flow Model (without ICM Lookup) (page 308)" section in Chapter 7, "Configuring VXML Solution," in Part 2 for more details. [] Deploy the Call Studio application: In the Operations Console, select Device Management > VXML Server.
1. In the Operations Console on the VXML Server, deploy the Call Studio application on For detailed information, see the "Deploying VoiceXML the VXML Server. Scripts Using the Operations Console (page 246)" section in Chapter 7, "Configuring VXML Solution," in Part 2.
Configuration Instructions for Unified CVP VXML Server (Standalone) Call Flow Model With Reporting
The following table contains the configuration instructions for this call flow model when using reporting.
Table 5: Configuration Checklist, Unified CVP VXML Server (Standalone) Call Flow Model with Reporting
Where to Go/What to Do
[]
Transfer the appropriate scripts to the Gateway for In the Operations Console, select Device Management use with the VXML Server: > Gateway > File Transfer > Scripts, then browse to the <cvp root>\Cisco\CVP\OpsConsoleServer 1. Transfer the following files using the Unified \GWDownloads folder. CVP Operations Console: Refer to the Operations Console online help for detailed CVPSelfService.tcl instructions.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
42
Where to Go/What to Do
Note: Optionally, you can transfer the files from the Unified CVP product CD. [] Configure the Gateway for VXML Server (Standalone) applications: 1. Define the VXML Server applications on the gateway. Do the following: For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings for Standalone (page 51)" section.
Note: Backup server is optional. For the For Step 4, see the "VoiceXML Gateway Tomcat Application Server and the WebSphere Configuration: Example of Dial-peer for Standalone Application Server, set the port to 7000. Also, (page 53)" section. the backup server cannot be the same server as the Primary Server. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure a dial-peer, which will call the service to reach the Unified CVP VXML Server. 5. Optionally, create additional dial-peers for any outgoing transfer destinations your application uses. Review the updated gateway configuration by issuing a show run to ensure you have configured the gateway properly. [] Create an application: 1. Create an application using Call Studio and save it as a zip file. 2. Enable logging. Note: Refer to the User Guide for Cisco Unified CVP VXML Server and Unified Call Studio for For Step 1, see the "Deploying VoiceXML Scripts Using Call Studio (page 245)" section in Chapter 7, "Configuring VXML Solution," in Part 2. For Step 2, refer to the User Guide for Cisco Unified CVP VXML Server and Unified Call Studio for information about using Call Studio.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
43
Where to Go/What to Do
details on configuring loggers using Call Studio. [] Configure the Call Server: 1. In the Operations Console, configure a standard Call Server and do not enable any Unified CVP services. [] Configure the VXML Server: For Step 1, in the Operations Console, select Device Management > VXML Server. For detailed information, refer to the Operations Console online help.
1. In the Operations Console, configure a Primary Call Server for the VXML Server. See the "Configuring the VXML Server (Standalone) Call Flow Model (without ICM Lookup) (page 308)" 2. Enable reporting for this VXML Server and section in Chapter 7, "Configuring VXML Solution," in add appropriate filtering. Part 2 for more details. For Step 2, in the Operations Console, select Device Management > VXML Server. In the Configuration tab, select Enable Reporting for this VXML Server. [] Deploy the Call Studio application: In the Operations Console, select Device Management > VXML Server.
1. In the Operations Console on the VXML Server, deploy the Call Studio application on For detailed information, see the "Deploying VoiceXML the VXML Server. Scripts Using the Operations Console (page 246)" section in Chapter 7, "Configuring VXML Solution," in Part 2. [] In the Operations Console, configure the Reporting In the Operations Console, select Device Management Server: > CVP Reporting Server > General tab: 1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server. 1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal.
Configuration Instructions for Unified CVP VXML Server (Standalone) Call Flow Model Adding Reporting
The following table contains the configuration instructions for this call flow model when adding reporting after the VXML Server (Standalone) has already been configured.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
44
Table 6: Configuration Checklist, Unified CVP VXML Server (Standalone) Call Flow Model Adding Reporting
Where to Go/What to Do
[]
In the Operations Console, note the configuration In the Operations Console: settings for the VXML Server (Standalone) and then delete the VXML Server (Standalone) configuration. 1. Select Device Management > VXML Server. 2. The Find, Add, Delete, Edit VXML Servers window displays. 3. From the list of matching records, choose the VXML Server that you want to delete by clicking the radio button preceding it. 4. Click Delete. See the "Deleting a VXML Server (page 281)" section in Chapter 7, "Configuring VXML Solution," in Part 2 for details.
[]
Transfer the scripts to the Gateway for the VXML In the Operations Console, select Device Management Server: > Gateway > File Transfer > Scripts, then browse to the <cvp root>\Cisco\CVP\OpsConsoleServer 1. Transfer the following files using the Unified \GWDownloads folder. CVP Operations Console: Refer to the Operations Console online help for detailed CVPSelfService.tcl instructions. Note: Follow the instructions in this file. CVPSelfServiceBootstrap.vxml critical_error.wav
Note: Optionally, you can transfer the files from the Unified CVP product CD. [] Configure the Gateway for VXML Server (Standalone) applications: 1. Define the VXML Server applications on the gateway. Do the following: For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings for Standalone (page 51)" section.
Note: Backup server is optional. For the For Step 4, see the "VoiceXML Gateway Tomcat Application Server and the WebSphere Configuration: Example of Dial-peer for Standalone Application Server, set the port to 7000. Also, (page 53)" section. the backup server cannot be the same server as the Primary Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
45
Where to Go/What to Do
2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure a dial-peer, which will call the service to reach the Unified CVP VXML Server. 5. Optionally, create additional dial-peers for any outgoing transfer destinations your application uses. Review the updated gateway configuration by issuing a show run to ensure you have configured the gateway properly. [] Create an application: 1. Create an application using Call Studio and save it as a zip file. 2. Enable logging. Note: Refer to the User Guide for Cisco Unified CVP VXML Server and Unified Call Studio for details on configuring loggers using Call Studio. [] Configure the Call Server: 1. In the Operations Console, configure a Call Server and do not enable any Unified CVP services. [] Configure the VXML Server: For Step 1, in the Operations Console, select Device Management > VXML Server. For detailed information, refer to the Operations Console online help. For Step 1, see the "Deploying VoiceXML Scripts Using Call Studio (page 245)" section in Chapter 7, "Configuring VXML Solution," in Part 2. For Step 2, refer to the User Guide for Cisco Unified CVP VXML Server and Unified Call Studio for information about using Call Studio.
1. In the Operations Console, configure a Primary Call Server for the VXML Server. See the "Configuring the VXML Server (Standalone) Call Flow Model (without ICM Lookup) (page 308)" 2. Configure the VXML Server for reporting. section in Chapter 7, "Configuring VXML Solution," in Part 2 for more details. For Step 2, in the Operations Console, select Device Management > VXML Server. In the Configuration tab, select Enable Reporting for this VXML Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
46
Where to Go/What to Do
[]
1. In the Operations Console on the VXML Server, deploy the Call Studio application on For detailed information, see the "Deploying VoiceXML the VXML Server. Scripts Using the Operations Console (page 246)" section in Chapter 7, "Configuring VXML Solution," in Part 2. [] In the Operations Console, configure the Reporting In the Operations Console, select Device Management Server: > CVP Reporting Server > General tab: 1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server. 1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal.
The following call flow description assumes the following: A Unified CVP Call Server has been defined using the Operations Console.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
47
A Call Studio application has been created that contains a Unified ICME request label element. The Unified ICME script must be set up to handle this request, so Unified ICME can interpret the label. The Call Studio application must be deployed on the VXML Server. The call flow in the figure above is as follows: 1. The call arrives from the PSTN network to the Gateway. 2. The Gateway sends a HTTP URL request to the VXML Server. 3. VXML Server sends a message to the Unified CVP Call Server. 4. Unified CVP Call Server sends a Unified ICME new call to Unified ICME. 5. Unified ICME returns a Unified ICME label to the Unified CVP Call Server. 6. Unified CVP Call Server sends a message to the VXML Server. 7. The VoiceXML returned to the Gateway can include references to ASR/TTS and Media Servers to recognize voice input, play TTS files, and play .wav files, respectively. 8. The gateway can, optionally, transfer the call to any destination that it can deliver a call to, such as Unified CM. 9. Unified CM can then send the call to an agent. The following table contains the configuration instructions for this call flow model. Note: Configure the Unified CVP peripheral as Type 5 VRU.
Table 7: Configuration Checklist, Unified CVP Standalone with ICM Lookup Call Flow Model
Where to Go/What to Do
[]
Transfer the appropriate scripts to the Gateway for use In the Operations Console, select Device with the VXML Server: Management > Gateway > File Transfer > Scripts, then browse to the <cvp 1. Transfer the following files using the Unified CVP root>\Cisco\CVP\OpsConsoleServer Operations Console: \GWDownloads folder. CVPSelfService.tcl Note: Follow the instructions in this file. CVPSelfServiceBootstrap.vxml Refer to the Operations Console online help for detailed instructions.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
48
Where to Go/What to Do
critical_error.wav
Note: Optionally, you can transfer the files from the Unified CVP product CD. [] Configure the Gateway for VXML Server applications: Do the following: 1. Define the VXML Server applications on the gateway. For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings for Standalone (page 51)" section.
Note: Backup server is optional. For the Tomcat Application Server and the WebSphere For Step 4, see the "VoiceXML Gateway Application Server, set the port to 7000. Also, the Configuration: Example of Dial-peer for Standalone backup server cannot be the same server as the (page 53)" section. Primary Server. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure a dial-peer, which will call the service to reach the VXML Server. 5. Optionally, create additional dial-peers for any outgoing transfer destinations your application uses. Review the updated gateway configuration by issuing a show run to ensure you have configured the gateway properly. [] Configure the application: For more information about using Call Studio, refer to the User Guide for Cisco Unified CVP VXML 1. Using Call Studio, create a VoiceXML application Server and Unified Call Studio. that uses the ReqICMLabel element and save it as a zip file. In the Call Studio application, the ReqICMLabel element has two exit states: error and done. The done path must connect to a transfer element to transfer the caller to that label. Note: Refer to the Element Specifications for Cisco Unified CVP VXML Server and Unified Call Studio for details on the ReqICMLabel element. 2. Enable logging.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
49
Where to Go/What to Do
Note: Refer to the User Guide for Cisco Unified CVP VXML Server and Unified Call Studio for details on configuring loggers using Call Studio. 3. Enable the CVPSNMPLogger for SNMP monitoring. Note: By default, CVPSNMPLogger is enabled when a new Call Studio application iscreated and deployed to the VXML Server. [] Configure the Call Server: 1. In the Operations Console, configure a Call Server and select the ICM Service. [] Configure the VXML Server: 1. In the Operations Console, configure a Primary Call Server for the VXML Server. 2. Configure the VXML Server for reporting. For Step 1, in the Operations Console, select Device Management > VXML Server. See the "Configuring the VXML Server (Standalone) with ICM Lookup Call Flow Model (page 305)" section in Chapter 7, "Configuring VXML Solution," in Part 2 for more details. For Step 2, in the Operations Console, select Device Management > VXML Server. In the Configuration tab, select Enable Reporting for this VXML Server. [] Deploy the Call Studio application: In the Operations Console, select Device Management > VXML Server. For detailed information, refer to the Operations Console online help.
1. In the Operations Console on the VXML Server, deploy the Call Studio application on the VXML For detailed information, see the "Deploying Server. VoiceXML Scripts Using the Operations Console (page 246)" section in Chapter 7, "Configuring VXML Solution," in Part 2. [] On the ICM Script Editor tool: For more information about creating a Unified ICME script that returns a label in Step 1, refer to the Unified 1. Create a Unified ICME script that returns a label. ICME documentation. In order to transfer information from Unified ICME to the VXML Server besides the label, use the ToExtVXML0 - 4 ECC Variables and/or Peripheral Variables 1 - 10. The format for using the ToExtVXML 0 - 4 is with name value pairs that are delimited by semi-colons. For example: For more information about using the ReqICMLabel element in Step 1, see "Passing Data to Unified ICME (page 317)" in Chapter 4, "Writing Scripts for Unified CVP," for more information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
50
Where to Go/What to Do
Use the Peripheral Variables 1 - 10 to pass information to the VXML Server. The values in these variables will be taken as is. [] In the Operations Console, configure the Reporting Server (optional): 1. Configure the Reporting Server. 1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal. In the Operations Console, select Device Management > CVP Reporting Server > General tab:
service timestamps debug datetime msec localtime service timestamps log datetime msec localtime
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
51
! service internal logging buffered 99999999 debugging no logging console ! ip cef ! voice rtp send-recv ip host tts-en-us <IP of TTS or MRCP Server> ip host asr-en-us <IP of ASR or MRCP Server> voice class codec 1 codec preference 1 g711ulaw codec preference 2 g729r8 voice service voip signaling forward unconditional h323 ! gateway timer receive-rtcp 6 ! ip rtcp report interval 3000 voice translation-rule 1 rule 1 /987654/ // ! ! voice translation-profile block translate called 1 ! ! ivr prompt memory 15000 ivr prompt streamed none ivr asr-server rtsp://asr-en-us/recognizer ivr tts-server rtsp://tts-en-us/synthesizer mrcp client timeout connect 10 mrcp client timeout message 10 mrcp client rtpsetup enable rtsp client timeout connect 10 rtsp client timeout message 10 vxml tree memory 1000 http client cache memory pool 15000 http client cache memory file 500 http client cache refresh 864000 http client connection timeout 60 http client response timeout 30 application service hello_world flash:CVPSelfService.tcl param CVPPrimaryVXMLServer <ip address>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
52
paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en param CVPBackupVXMLServer <ip address> param CVPSelfService-port 7000 param CVPSelfService-SSL 0 -ORparam CVPSelfService-port 7443 param CVPSelfService-SSL 1 param CVPSelfService-app HelloWorld service CVPSelfService flash:CVPSelfServiceBootstrap.vxml paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en
Note: The optional param CVPSelfService-SSL 1 line enables HTTPS.
dial-peer voice 8 pots description Example incoming POTS dial-peer calling HelloWorld VXML Server application service hello_world incoming called-number <your DN pattern here> direct-inward-dial dial-peer voice 800 voip description Example incoming VOIP dial-peer calling HelloWorldVXML Server application service hello_world translation-profile incoming block incoming called-number 800....... voice-class codec 1 dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
53
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Unified CVP Call Director (SIP/H.323) Call Flow Model, Unified ICME
The SIP Call Director call flow model sends calls to other third-party ACDs, SIP gateways, or to a Unified CM server. In this call flow model, Unified CVP only provides Unified ICME with VoIP call switching capabilities. You provide your own Service Control VRU, if you are using Unified ICME to queue calls or you might queue calls directly on your ACD. Calls might be transferred multiple times, from Ingress, to customer-provided VRU, to either Unified CCE or customer-provided ACD or agent, and back again. When calls are connected to customer-provided equipment (either VoIP or TDM), their voice paths must go to an egress gateway, which is connected by TDM to that equipment. If the signaling is SIP, then this call flow model works with customer-provided SIP endpoints which have been tested and certified to interoperate with Unified CVP. Note: The Call Director call flow model is the most inclusive call flow because it potentially incorporates all components of the Unified CVP solution. In this call flow model, Unified CVP stays in the signaling path after the transfer. Note: VRU scripts and transfer to a VRU leg are not available in this call flow model. The Unified CVP Call Director call flow model requires the following components: Call Server (using either SIP or H.323 call signaling) Ingress Gateway Operations Console Unified ICME Note: The Reporting Server is optional. If the Call Server is configured to use SIP signaling, a SIP Proxy Server is optional. The following figure shows the call flow for this call flow model using SIP without a Proxy Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
54
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Note: In the following diagrams, solid lines indicate voice paths and dashed lines indicate signaling paths.
Figure 7: Unified CVP Call Director with SIP without Proxy Server, Unified ICME
The following figure shows the call flow for this call flow model using SIP with a Proxy Server.
Figure 8: Unified CVP Call Director with SIP with Proxy Server, Unified ICME
The following figure shows the call flow for this call flow model using H.323.
Figure 9: Unified CVP Call Director with H.323, Unified ICME
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
55
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Note: See the "REFER Transfers Using "RFXXXX" Type Unified ICME Labels (page 403)" and the "Using the sendtooriginator Setting in the SIP Service (page 404)" sections in Chapter 12, "Configuring the SIP Devices," in Part 3 for more information.
Configuration Instructions for the Unified CVP Call Director Call Flow Model Using SIP
The following table contains the configuration instructions for the Call Director Call Flow Model using SIP for both Unified ICME and Unified ICMH. Note: See the "Unified CVP Call Director (SIP/H.323) Call Flow Model, Unified ICMH (page 76)" section for detailed information about the Unified ICMH version of this call flow model.
Table 8: Configuration Checklist, Unified CVP Call Director Call Flow Model, Unified ICME and Unified ICMH Using SIP
Where to Go/What to Do
[]
Install the Gateways: 1. Install the IOS image on the Ingress Gateway.
[]
Do the following:
1. Transfer the following Unified CVP gateway For Step 1, in the Operations Console select Device scripts using the Unified CVP Operations Management > Gateway > File Transfer > Scripts, Console: then browse to the <cvp root>\Cisco\CVP\OpsConsoleServer bootstrap.tcl \GWDownloads folder. handoff.tcl survivabilty.tcl bootstrap.vxml recovery.vxml ringtone.tcl cvperror.tcl ringback.wav critical_error.wav For Steps 2 and 3, see the "Ingress Gateway Configuration: Example Gateway Settings for SIP (page 72)" section. For Step 4, see the "Ingress Gateway Configuration: Example of Incoming Pots Dial-peer (page 74)" section. For Step 5, see the "Ingress Gateway Configuration: Example of SIP Ringtone Dial-Peer (page 74)" and the "Ingress Gateway Configuration: Example of SIP Error Dial-peer (page 74)" sections. For Step 6, see the "Ingress Gateway Configuration: Example of Dial-peer to Reach the Unified CVP Call Server or CUP (page 74)" section. Refer to the Operations Console online help for detailed instructions.
Note: Optionally, you can transfer the files from the Unified CVP product CD. 2. Configure the base gateway settings.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
56
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
3. Configure the service gateway settings. 4. Configure a dial-peer for the Unified CVP Call Server. 5. Configure a dial-peer for ringtone and error. 6. Do the following: If using a Proxy Server, configure your session target in the outbound dial peer to point to the Proxy Server. If using the sip-server global configuration, then configure the sip-server in the sip-ua section to be your Proxy Server and point the session target of the dial-peer to the sip-server global variable.
See Chapter 12, "Configuring the SIP Devices (page 397)," in Part 3 for detailed information.
Note: Make sure your dial plan includes this information. You will need to refer to the dial plan when you configure the SIP Proxy Server for Unified CVP. The SIP Service voip dial peer and the destination pattern on the Ingress Gateway must match the DNIS in static routes on the SIP Proxy Server or Unified CVP Call Server. [] For SIP without a Proxy Server, do the following: For Step 1 for SIP without a Proxy Server, refer to the Operations Console online help for detailed instructions. 1. If using DNS query with SRV or A types from Also for this step, if using DNS query with SRV or A the gateway, configure the gateway to use DNS. types from the gateway, use CLI as shown below: 2. Configure the DNS zone file, for the separate Note: Normally, non-DNS setup is: sip-server DNS server, that displays how the Service ipv4:xx.xx.xxx.xxx:5060. (SRV) records are configured.
ip domain name patz.cisco.com
Note: SRV with DNS can be used in any of the SIP call flow models, with or without a Proxy ip name-server 10.10.111.16 server. Standard A type DNS queries can be sip-ua used as well for the calls, without SRV, but they lose the load balancing and failover sip-server dns:cvp.pats.cisco.com capabilities.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
57
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
or
1. If you are using the DNS Server, you can set ipv4:xx.xx.xxx.xxx:5060 your SIP Service as the Host Name (either A For Step 2 for SIP without a Proxy Server, see the or SRV type). "DNS Zone File Configuration (page 75)" section. You can also configure the Gateway statically instead of using DNS. The following example For Step 1 for SIP with a Proxy Server see Chapter 12, shows how both the A and SRV type records "Configuring the SIP Devices (page 397)," in Part 3. could be configured:
ip host cvp4cc2.cisco.com 10.4.33. 132 ip host cvp4cc3.cisco.com 10.4.33. 133 ip host cvp4cc1.cisco.com 10.4.33. 131
For SIP/TCP:
ip host _sip._tcp.cvp.cisco.com srv 50 50 5060 cvp4cc3.cisco.com ip host _sip._tcp.cvp.cisco.com srv 50 50 5060 cvp4cc2.cisco.com ip host _sip._tcp.cvp.cisco.com srv 50 50 5060 cvp4cc1.cisco.com
For SIP/UDP:
ip host _sip._udp.cvp.cisco.com srv 50 50 5060 cvp4cc3.cisco.com ip host _sip._udp.cvp.cisco.com srv 50 50 5060 cvp4cc2.cisco.com ip host _sip._udp.cvp.cisco.com srv 50 50 5060 cvp4cc1.cisco.com
Note: The DNS Server must be configured with all necessary A type or SRV type records. [] On the Unified CM server, CCMAdmin Publisher, From the Unified CM Administration page: configure SIP-specific actions:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
58
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
1. Add the CUP Proxy Server. 2. Create SIP trunks: If you are using a SIP Proxy Server, set up a SIP trunk to the SIP Proxy Server. Add a SIP Trunk for the Unified CVP Call Server. Add a SIP Trunk for each Ingress gateway that will send SIP calls to Unified CVP that might be routed to Unified CM.
1. For Step 1, if you are using a version of CUP prior to 7.0(3), select System > Application Server > Add New: Enter your CUP proxy in the Add New window in the Application Server area. (This step is done autimatically by versions of CUP later than 7.0(3)) 2. For Step 2, select Device > Trunk > Add New. Add the following:
Trunk Type: SIP trunk. Device Protocol: SIP. Destination Address: IP address or host name of the SIP Proxy Server (if using a SIP Proxy Server). If not using a SIP Proxy Server, enter the IP address or host name of the Unified CVP Call Server. DTMF Signaling Method: RFC 2833. Do not check the Media Termination Point Required checkbox. If you are using UDP as the outgoing transport on Unified CVP (and CUP routes if using a proxy server), also set the outgoing transport to UDP on the SIP Trunk Security Profile. The default port to use for connection to CUP is 5060
3. Add route patterns for outbound calls from the Unified CM devices using a SIP Trunk to the Unified CVP Call Server. Also, add a route pattern for error DN. Note: For warm transfers, the call from Agent 1 to Agent 2 does not typically use a SIP Trunk, but you must configure the CTI Route Point for that dialed number on the Unified CM server and associate that number with your peripheral gateway user (PGUSER) for the JTAPI gateway on the Unified CM peripheral gateway. An alternative is to use the Dialed Number Plan on Unified ICME to bypass the CTI Route Point. See the "Resource Sizing for Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature (page 386)" section in Chapter 10, "Using Cisco Unified ICME Warm Consult Transfer/Conference to Unified CVP," in Part 3. 4. If you are sending calls to Unified CM using an SRV cluster domain name, configure the cluster domain name. 5. Note the username and password for Unified CM. If you are using a SIP Proxy Server, you will need the Unified CM username and password when installing the CUP Proxy Server.
3. For Step 3, select Call Routing > Route/Hunt > Route Pattern > Add New. Add the following: Route Pattern: Specify the route pattern; for example: 3XXX" for a TDM phone that dials 9+3xxx and all Unified ICME scripts are set up for 3xxx dialed numbers. Gateway/Route List: Select the SIP Trunk defined in Step 2.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
59
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
Note the username and password for Unified CM. If you are using a SIP Proxy Server, you will need the Unified CM username and password when installing the CUP Proxy Server.
4. For Step 4, select Enterprise Parameters > Clusterwide Domain Configuration and add the Cluster fully qualified domain name FQDN. For detailed instructions about using Unified CM and the CUP Proxy Server, refer to the Unified CM and the Cisco Unified Presence Server (CUP) documentation. [] Configure the SIP Proxy Server (optional): 1. Configure the SIP static routes to the Unified CVP Call Server(s), Unified CM SIP trunks, and Gateways. Configure the SIP static routes for intermediary transfers for ringtone, playback dialed numbers, and error playback dialed numbers. Note: For failover and load balancing of calls to multiple destinations, configure the CUP static route with priority and weight. 2. Configure Access Control Lists for Unified CVP calls. 3. Configure the service parameters. 4. Note the IP address and host name of the SIP Proxy Server. (You will need this information when configuring the SIP Proxy Server in Unified CVP.) Note: You must use the SIP Proxy components of CUP, not the Presence Engine component. 5. If using redundant SIP Proxy Servers (primary and secondary or load balancing), then decide whether to use DNS server lookups for SRV records or non-DNS based local SRV record configuration.
0) http://<CUP server>
From the CUP Administration web page (http:\\<CUP server>)0: 1. For Step 1, select Cisco Unified Presence Server > Proxy Server > Static Routes > Add New, (in CUP 7.0(0) and greater select Presence > Routing > Static Routes) specify: Transport: UDP or TCP (UDP is recommended). Destination Pattern: Specify the dialed number pattern for the destination. For example: 777* (matches 777 followed by any number of characters 14085551234 (matches only 14085551234) 1408555.... (matches 1408555 followed by any four characters) Next Hop: <IP Address or DNS resolvable FQDN of Gateway or Unified Communications_Manager_short>, depending on the Destination Pattern. If the Destination Pattern is the VRU leg label, then the Next Hop would be the IP address of the VoiceXML Gateway.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
60
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
Note: If a single CUP Proxy Server is used, then SRV record usage is not required. The Call Director call flow model with SIP calls will typically be deployed with dual CUPs Proxies for redundancy. In some cases, you might want to purchase a second CUPs Proxy. Regardless, the default transport for deployment will be UDP, and make sure you always set the AddRecordRoute setting to Off with CUPs.
If the Destination Pattern is an agent label pattern, then the Next Hop would be the IP address of Unified CM on which the agent device is registered. Protocol Type: UDP or TCP (UDP is recommended).
See CUP Proxy Static Route Provisioning Use Cases (page 655) for confguration examples for multiple sites. 2. For Step 2, select Proxy Settings > Incoming ACL (in CUP 7.0(0) and greater select System > Security > Incoming ACL): Address pattern: all. Note: Unified CVP does not utilize the ACL functionality. 3. For Step 3, select Service Parameters, then set the following: Add record route: off. Maximum invite retransmission count: 2. Proxy Domain and Cluster Name: if using DNS SRV, set to the FQDN of your Proxy Server SRV name.
4. For Step 4, note the IP address and host name of the SIP Proxy Server. 5. For Step 5, configure the SRV records on the DNS server or locally on Unified CVP with a .xml file (local xml configuration avoids the overhead of DNS lookups with each call). Note: See the "Local SRV File Configuration Example for SIP Messaging Redundancy (page 162)" section for detailed information. For the required settings in the Unified CM Publisher configuration, refer to the Cisco Unified Presence Server (CUP) Proxy Server documentation. [] On Unified ICME, ICM Configuration Manager, PG In the tree view pane, select the applicable PG: Explorer tool:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
61
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
1. Configure each peripheral gateway (PG) to be On the Logical Controller tab: used for the Switch leg. Client Type: VRU. 2. Configure a peripheral for each Unified CVP Name: A name descriptive of this PG. Call Server to be used for a Switch leg connected to each PG. For example: <location>_A for side A of a particular location. On the Peripheral tab: Peripheral Name: A name descriptive of this Unified CVP peripheral. For example: <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. On the Routing Client tab: Name: By convention, use the same name as the peripheral. Client Type: VRU. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On the Unified ICME or Unified ICMH Server in the ICM Configuration Manager: 1. Configure the dialed numbers. 2. For Step 2, use the Call Type List tool tab. 2. Configure the call types. 3. For Step 3, use the ICM Instance Explorer tool tab. 3. Configure the applicable customers. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On the Unified ICME or Unified ICMH Server in the ICM Script Editor tool: For more information about creating scripts, see Chapter 4, "Writing Scripts for Unified CVP (page 175)." In the ICM Configuration Manager: 1. For Step 1, use the Dialed Number List Tool tab.
1. Create a routing script that handles the Refer to the ICM Scripting and Media Routing Guide incoming call. The routing script must execute for Cisco ICM/IPCC Enterprise & Hosted Editions for a Label node or Select node (node that returns more information. a label right away).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
62
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
Note: Do not use the Queue node in the routing script. The label must be configured in the Gatekeeper or SIP Proxy Server to the IP address of the device that the label corresponds to. The Proxy Server is optional, so if you do not have one you must configure the Gateway dial-peer to point to the Call Server (see the first step in this process). Also, you must configure the destination labels in the SIP Service for the Call Server. [] If using a SIP Proxy Server, configure the SIP Proxy Server device in Unified CVP: In the Operations Console:
1. Select Device Management > SIP Proxy Server. 1. In the Operations Console, configure the SIP For detailed information about configuring a SIP Proxy Proxy Server. Server, see the "Configuring a SIP Proxy Server (page 397)" section in Chapter 12, "Configuring the SIP Devices," in Part 3. [] In the Operations Console, install and configure the In the Operations Console: Call Server(s): 1. For Step 1, select Device Management > CVP 1. Enable the ICM and SIP Services on the Call Call Server: Select the ICM and SIP checkboxes. Server. 2. For Step 2, select Device Management > CVP 2. Configure the SIP Service: Call Server > SIP tab. If you are using a SIP Proxy Server, enable the Outbound Proxy and select the SIP Proxy Server. If you are not using a SIP Proxy Server, configure static routes to each third-party SIP gateway/ACD, SIP endpoints to receive calls. Note: The SIP Service voip dial peer and the destination pattern of the Ingress Gateway must match the DNIS. Configure destination labels. Check the default values for the SIP Service and change, if desired. dialed numbers must not be longer than 24 characters Note: Valid dialed number patterns are the same as for the ICM label sizes and limitations, including: use the period (.) or X character for single-digit wildcard matching use the greater than (>), asterisk (*), or exclamation (!) characters as a wildcard for 0 or more digits do not use the T character for wildcard matching
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
63
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
3. Configure the ICM Service by setting the maximum length DNIS to the length of the Network Routing Number.
Do the following: Enable Outbound Proxy: Yes. Outbound Proxy Host: Select from drop-down list. Local Static Routes, Dialed Number (DN): Specify the dialed number pattern (page 63) for the destination. Example: 9> (Errors are 9292 and ringtone is 9191) The following static route configuration is not correct because the least explicit routes must appear at the end. Load balancing and/or failover of calls will require DNS SRV domain names, not multiple routes with the same DN Pattern, but a single route to an SRV domain name.
1>,10.2.6.1 2>,10.2.6.2 3>,10.2.6.20 2229191>,10.2.6.241 2229292>,10.2.6.241 2229191>,10.2.6.242 2229292>,10.2.6.242 2>,ccm-subscribers.cisco.com 3>,ccm-subscribers.cisco.com
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
64
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
2>,ccm-subscribers.cisco.com 3>,ccm-subscribers.cisco.com
Note: "91919191>" pattern will not match an exact DN of "91919191." If you are not using a SIP Proxy Server, configure the following local static routes:
22291>,cvp-ringtone.cisco.com 22292>,cvp-error.cisco.com 1>,ccm-subscribers.cisco.com 2>,ccm-subscribers.cisco.com 3>,ccm-subscribers.cisco.com
3. For Step 3, select Device Management > CVP Call Server > ICM tab: Maximum Length of DNIS: length of the Network Routing Number. Example: if the Gateway dial pattern is 1800******, the maximum DNIS length is 10. For detailed information, refer to the Operations Console online help. [] In the Operations Console, configure the Reporting In the Operations Console, select Device Management Server (optional): > CVP Reporting Server > General tab: 1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server. 1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
65
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Configuration Instructions for the Unified CVP Call Director Call Flow Model Using H.323
The following table contains the configuration instructions for the Call Director Call Flow Model using H.323 for both Unified ICME and Unified ICMH. Note: See the "Unified CVP Call Director (SIP/H.323) Call Flow Model, Unified ICMH (page 76)" section for detailed information about the Unified ICMH version of this call flow model.
Table 9: Configuration Checklist, Unified CVP Call Director Call Flow Model, Unified ICME and Unified ICMH Using H.323
Where to Go/What to Do
[]
Install the Gateways: 1. Install the IOS image on the Ingress Gateway.
[]
Do the following:
1. Transfer the following Unified CVP gateway For Step 1, in the Operations Console select Device scripts using the Unified CVP Operations Management > Gateway > File Transfer > Scripts, Console: then browse to the <cvp root>\Cisco\CVP\OpsConsoleServer bootstrap.tcl \GWDownloads folder. handoff.tcl survivabilty.tcl bootstrap.vxml recovery.vxml cvperror.tcl critical_error.wav For Steps 2 and 3, see the "Ingress Gateway Configuration: Example Gateway Settings (page 72)" section. For Step 4, see the "Ingress Gateway Configuration: Example of Incoming Pots Dial-peer (page 74)" section. For Step 5, see the "Ingress Gateway Configuration: Example of Using Gatekeeper Lookup to Reach the Call Server (page 75)" section. See Chapter 14, "Configuring the H.323 Devices and VoIP (page 453)," in Part 3 for detailed information. Refer to the Operations Console online help for detailed instructions.
Note: Optionally, you can transfer the files from the Unified CVP product CD. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure a dial-peer for the Unified CVP Call Server. 5. Configure the gatekeeper.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
66
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
[]
Configure the Gatekeeper: 1. Register all Gateways. 2. Configure the Gatekeeper to send all VRU connections to the applicable Gateway. 3. Configure the Unified ICME Label Node to the IP address of the device to which the label corresponds.
Do the following: 1. For Step 1, add the boldfaced lines to the Gateway configuration. The Gateway auto-registers with the Gatekeeper once these lines are configured. interface FastEthernet0/0 ip address 10.86.129.79 255.255.255.0 ip route-cache same-interface duplex full speed 100 no cdp enable h323-gateway voip interface h323-gateway voip id <zone ID specified on the GK> ipaddr <IP of GK> 1719 h323-gateway voip h323-id <IP of this GW> h323-gateway voip tech-prefix 1# 2. For Step 2, include the following:
zone prefix <GK> <Network Routing Number>* gw-priority 10 <H323-ID of
3. For Step 3, zone prefix sox-gk 1* gw-priority 10 <CCM Trunk ID> zone prefix sox-gk 2* gw-priority 10 <CCM Trunk ID>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
67
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
zone prefix sox-gk 4* gw-priority 10 <CCM Trunk ID> zone prefix sox-gk 777* gw-priority <VXML GW1 IP><VXML GW2 IP> For example: zone prefix sox-gk 1* gw-priority 10 SOX_CCM_H323_TRUNK_2 SOX_CCM_H323_TRUNK_3 zone prefix sox-gk 2* gw-priority 10 SOX_CCM_H323_TRUNK_2 SOX_CCM_H323_TRUNK_3 zone prefix sox-gk 4* gw-priority 10 SOX_CCM_H323_TRUNK_2 SOX_CCM_H323_TRUNK_3 zone prefix sox-gk 777* gw-priority 10 10.86.129.106 10.86.129.20 For more information about Step 1, see Chapter 14, "Configuring the H.323 Devices and VoIP (page 453)," in Part 3. [] On the Unified CM server, CCMAdmin Publisher, From the Unified CM Administration page: configure H.323-specific actions: 1. For Step 1, select Device > Gatekeeper > Add 1. Add the Gatekeeper. New: Add the Host Name/IP address of Gatekeeper. 2. Add the Unified CVP H.323 Service as an H.323 gateway. 3. Add an H.323 Trunk for Unified CM to register with the Gatekeeper. 2. For Step 2, select Device > Gateway > Add New. Add the following: Gateway Type: H.323 Gateway. Device Name: <Unified CVP Call Server IP address>. Description: <Unified CVP Call Server IP address (or other identifying text)>. Device Pool: <device pool>. Calling Party Selection: From the Calling Party Selection list, select Originator.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
68
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
3. For Step 3, select Device > Trunk > Add New. Add the following: Trunk Type: H.225 Trunk (Gatekeeper controlled). Device Protocol: H.225. Device Name: <name for your trunk>. For example: MY_CCM_TRUNK. Device Pool: <device pool>. Gatekeeper Name: From the drop-down list, select the Gatekeeper to which this trunk will register. Terminal Type: Gateway. Technology Prefix: 1#.
For detailed instructions about using Unified CM, refer to the Unified CM documentation. [] On Unified ICME, ICM Configuration Manager, PG In the tree view pane, select the applicable PG: Explorer tool: On the Logical Controller tab: 1. Configure each peripheral gateway (PG) to be Client Type: VRU. used for the Switch leg. 2. Configure a peripheral for each Unified CVP Call Server to be used for a Switch leg connected to each PG. Name: A name descriptive of this PG. For example: <location>_A for side A of a particular location. On the Peripheral tab: Peripheral Name: A name descriptive of this Unified CVP peripheral. For example: <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
69
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
On the Advanced tab: Select the name of the Unified CVP VRU from the Network VRU field drop-down list. For example: cvpVRU. On the Routing Client tab: Name: By convention, use the same name as the peripheral. Client Type: VRU. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On the Unified ICME or Unified ICMH Server in the ICM Configuration Manager: 1. Configure the dialed numbers. 2. For Step 2, use the Call Type List tool. 2. Configure the call types. 3. For Step 3, use the ICM Instance Explorer tool. 3. Configure the applicable customers. 4. For Step 4, use the Network VRU Explorer tool. 4. Configure the Network VRU. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On the Unified ICME or Unified ICMH Server in the ICM Script Editor tool: For more information about creating scripts, see Chapter 4, "Writing Scripts for Unified CVP (page 175)." In the ICM Configuration Manager: 1. For Step 1, use the Dialed Number List Tool.
1. Create a routing script that handles the Refer to the ICM Scripting and Media Routing Guide incoming call. The routing script must execute for Cisco ICM/IPCC Enterprise & Hosted Editions for a Label node or Select node (node that returns more information. a label right away). Note: Do not use the Queue node in the routing script. [] In the Operations Console, install and configure the In the Operations Console, select Device Management > CVP Call Server: Call Server(s): 1. Enable the ICM, IVR, and H.323 Services on the Call Server. 1. Select the ICM, IVR, and H.323 checkboxes. For detailed information, refer to the Operations Console online help.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
70
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
[]
In the Operations Console, configure the ICM Service by specifying the following required information: 1. VRU Connection Port. 2. Maximum Length of DNIS. 3. Call service IDs: New Call and Pre-routed. 4. Trunk group IDs: New Call and Pre-routed.
In the Operations Console, select Device Management > CVP Call Server > ICM tab: 1. Set the VRU Connection Port to match the VRU connection Port defined in ICM Setup for the corresponding VRU peripheral gateway (PIM). 2. Set the maximum length DNIS to the length of the Network Routing Number. Example: if the Gateway dial pattern is1800******, the maximum DNIS length is 10. 3. Configure the ports for both groups according to the licenses purchased, call profiles, and capacity by completing the required fields on this tab. 4. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values.
[]
In the Operations Console, select Device Management > CVP Call Server > IVR tab: 1. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values.
[]
In the VBAdmin tool, configure the H.323 Service: In the VBAdmin tool, select Cisco Unified Customer Voice Portal H.323 Service: 1. Set the IP address of the Gatekeeper. 1. For Step 1, specify: SetGateKeeper <NewValue> 2. Configure the capacity. Where <NewValue> is the IP address for the 3. Check the default values and change, if desired. Gatekeeper serving the H.323 Service. 2. For Step 2 for Unified ICMH only, configure the total number of calls and IVR ports according to the licenses purchased, call profiles, and capacity. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
71
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
Where to Go/What to Do
[]
In the Operations Console, configure the Reporting In the Operations Console, select Device Management Server (optional): > CVP Reporting Server > General tab: 1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server. 1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal.
service timestamps debug datetime msec localtime service timestamps log datetime msec localtime ! service internal logging buffered 99999999 debugging no logging console
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
72
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
! ip cef ! voice rtp send-recv ! voice service voip signaling forward unconditional h323 sip min-se 360 rel1xx disable header-passing ! voice class codec 1 codec preference 1 g711ulaw codec preference 2 g729r8 ! application service cvperror flash:cvperror.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service cvp-survivability flash:survivability.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service ringtone flash:ringtone.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service handoff flash:handoff.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! gateway timer receive-rtcp 6 ! ip rtcp report interval 3000 !
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
73
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
sip-ua retry invite 1 timers expires 60000 sip-server ipv4:<IP of CUP Proxy or Call Server>:5060 reason-header override Ingress Gateway Configuration: Example of Incoming Pots Dial-peer
The following example provides the configuration for an incoming Pots call for the Call Director call flow model:
dial-peer voice 8 pots description Example incoming POTS dial-peer service cvp-survivability incoming called-number <your DN pattern here> direct-inward-dial Ingress Gateway Configuration: Example of SIP Ringtone Dial-peer
The following example provides the configuration for a SIP ringtone for the Call Director call flow model:
dial-peer voice 9191 voip description SIP ringtone dial-peer service ringtone voice-class codec 1 voice-class sip rel1xx disable incoming called-number <your ringtone DN pattern here> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad ! Ingress Gateway Configuration: Example of SIP Error Dial-peer
The following example provides the configuration for a SIP error dial-peer for the Call Director call flow model:
dial-peer voice 9292 voip description SIP error dial-peer service cvperror voice-class codec 1 voice-class sip rel1xx disable incoming called-number <your error DN pattern here> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad Ingress Gateway Configuration: Example of Dial-peer to Reach the Unified CVP Call Server or CUP
The following example provides the configuration for a dial-peer to reach the Unified CVP Call Server or CUP for the Call Director call flow model:
74
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
description Example Call Server Dialpeer with CUP destination-pattern <your DN pattern here> voice-class codec 1 session protocol sipv2 session target sip-server dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad Ingress Gateway Configuration: Example of Using Gatekeeper Lookup to Reach the Call Server
The following example provides the configuration to use gatekeeper lookup for the Call Director call flow model:
dial-peer voice 800 voip translation-profile incoming block description Example Call Server Dialpeer with GK destination-pattern <your DN pattern here> voice-class codec 1 session target ras dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
ringtone-1 IN A 10.86.129.20 ringtone-2 IN A 10.86.129.229 vxml-1 IN A 10.86.129.20 vxml-2 IN A 10.86.129.229 vxml-3 IN A 161.44.81.254 cvp-1 IN A 10.86.129.211 cvp-2 IN A 10.86.129.220 cvp-3 IN A 161.44.81.254 ; Priority Weight Port Target sip._tcp.ringtone.sox.cisco.com. SRV 1 1 5060 ringtone-1.sox.cisco.com. _ SRV 1 1 5060 ringtone-2.sox.cisco.com. sip._udp.ringtone.sox.cisco.com. SRV 1 1 5060 ringtone-1.sox.cisco.com. _ SRV 1 1 5060 ringtone-2.sox.cisco.com.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
75
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
_sip._tcp.vxml.sox.cisco.com. SRV 1 1 5060 vxml-1.sox.cisco.com. SRV 1 1 5060 vxml-2.sox.cisco.com. SRV 1 1 5060 vxml-3.sox.cisco.com. _sip._udp.vxml.sox.cisco.com. SRV 2 1 5060 vxml-1.sox.cisco.com. SRV 2 1 5060 vxml-2.sox.cisco.com. SRV 1 1 5060 vxml-3.sox.cisco.com. _sip._tcp.cvp.sox.cisco.com. SRV 1 1 5060 cvp-1.sox.cisco.com. SRV 2 1 5060 cvp-2.sox.cisco.com. SRV 3 1 5060 cvp-3.sox.cisco.com. _sip._udp.cvp.sox.cisco.com. SRV 1 1 5060 cvp-1.sox.cisco.com. SRV 2 1 5060 cvp-2.sox.cisco.com. SRV 3 1 5060 cvp-3.sox.cisco.com. DNS Zone File MS DNS Configuration Example
The following is an example of a DNS zone file MS DNS configuration.
Figure 10: DNS Zone File MS DNS Configuration Example
Unified CVP Call Director (SIP/H.323) Call Flow Model, Unified ICMH
In this call flow model, Unified CVP only provides the Network Applications Manager (NAM) with VoIP call switching capabilities. You provide your own Service Control VRU, if you are using the NAM to queue calls or you might queue calls directly on your ACD. Calls might be transferred multiple times, from Ingress, to customer-provided VRU, to either the NAM or customer-provided ACD or agent, and back again. When calls are connected to customer-provided equipment, their voice paths must go to an egress gateway, which is connected by TDM to that
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
76
Chapter 2: Configuration Overview Unified CVP Call Director Call Flow Models
equipment. If the signaling is SIP, then this call flow model works with customer-provided SIP endpoints which have been tested and certified to interoperate with Unified CVP. Note: VRU scripts and transfer to a VRU leg are not available in this call flow model. The following figure shows the call flow for this call flow model using SIP without a Proxy Server. Note: In the following diagrams, solid lines indicate voice paths and dashed lines indicate signaling paths.
Figure 11: Unified CVP Call Director with SIP without Proxy Server, Unified ICMH
The following figure shows the call flow for this call flow model using SIP with a Proxy Server.
Figure 12: Unified CVP Call Director with SIP with Proxy Server, Unified ICMH
The following figure shows the call flow for this call flow model using H.323.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
77
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Figure 13: Unified CVP Call Director with H.323, Unified ICME
See the "Configuration Checklist, Unified CVP Call Director Call Flow Model, Unified ICME and Unified ICMH Using SIP" (page 56) table for configuration instructions for this call flow model. Note: See the "REFER Transfers Using "RFXXXX" Type Unified ICME Labels (page 403)" and the "Using the sendtooriginator Setting in the SIP Service (page 404)" sections in Chapter 12, "Configuring the SIP Devices," in Part 3 for more information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
78
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models paramspace english language en paramspace english index 0 paramspace english location flash: paramspace english prefix en param cvpserverhost xxx.xxx.xxx.xxx <IP of primary Call Server> param cvpserverbackup xxx.xxx.xxx.xxx <IP of backup Call Server> param cvpserverport 8000 <TCP Port # of Call Server>
The Unified CVP Comprehensive call flow model with SIP/H.323 extracts the Call Server host from the signaling. That is, the Unified CVP SIP Service or the H.323 Service is handling the switch legs of the call. If you are performing a SIP call that does not involve the switch leg with Unified CVP, then the service parameters below will apply for the "VRU leg only" call flow. Cisco requires that Comprehensive calls always use the same Call Server for both switch leg and VRU legs. It is an effort to "simplify" our solution and make it easier to troubleshoot, as discussed in the Unified CVP 4.0 TOI presentations. Note: The app-info header is only for SIP calls. The incoming H.323 calls use the "leg_remote_signaling_ip_address" parameter in the call. If this is empty, then the primary Call Server IP, as configured on the service, will be used. If that is "out-of-service," then it will try the backup Call Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
79
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Caution: The Operations Console can only manage speech servers installed on Windows (or AIX if supported by vendors), not on Linux. If the speech server is installed on Linux, the server cannot be managed. Media Servers DNS Server Content Services Switch Gatekeeper SIP Proxy Server (if the Call Server is configured to use SIP signaling, a SIP Proxy Server is optional) In this call flow model, both the Voice Gateway and the Call Server see two call legs for the same call: One for the Switch leg. One for the VRU leg. For the Switch leg, the Gateway simply provides Gateway capabilities from TDM to VoIP and call-switching capabilities. For the VRU leg, the Gateway provides VRU voice treatment. Note: Although the following figures show two Gateways (one where the call arrives and a separate one for the VRU leg), these could be the same physical Gateway. For simplicity, the figures do not illustrate a call flow model for redundancy and failover. The following figure shows the call flow for this call flow model using SIP without a Proxy Server. Note: In the following diagrams, solid lines indicate voice paths and dashed lines indicate signaling paths.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
80
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Figure 14: Unified CVP Comprehensive with SIP without Proxy Server, Unified ICME
The following figure shows the call flow for this call flow model using SIP with a Proxy Server.
Figure 15: Unified CVP Comprehensive with SIP with Proxy Server, Unified ICME
Note: For simplicity, the Gatekeeper is not shown in this diagram. The following figure shows the call flow for this call flow model using H.323.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
81
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Note: The numbers in the figure indicate call flow progression. Configuration overview for this call flow model: There is one Network VRU, Type 10, which serves both the Switch and VRU legs. Use the ICM Script Editor's SendToVRU node to connect the call to the Network VRU. Note: See the "REFER Transfers Using "RFXXXX" Type Unified ICME Labels (page 403)" and the "Using the sendtooriginator Setting in the SIP Service (page 404)" sections in Chapter 12, "Configuring the SIP Devices," in Part 3 for more information.
Configuration Instructions for the Unified CVP Comprehensive Call Flow Model Using SIP
The following table contains the configuration instructions for the Comprehensive Call Flow Model using SIP for both Unified ICME and Unified ICMH. Note: See the "Unified CVP Comprehensive (SIP/H.323) Call Flow Model, Unified ICMH (page 118)" section for detailed information about the Unified ICMH version of this call flow model.
Table 10: Configuration Checklist, Unified CVP Comprehensive Call Flow Model, Unified ICME and Unified ICMH Using SIP
Where to Go/What to Do
[]
Install the Gateways: 1. Install the IOS image on the Ingress Gateway.
[]
Do the following:
1. Transfer the following Unified CVP gateway For Step 1, in the Operations Console select Device scripts using the Unified CVP Operations Management > Gateway > File Transfer > Scripts, Console: then browse to the <cvp
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
82
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
root>\Cisco\CVP\OpsConsoleServer \GWDownloads folder. Refer to the Operations Console online help for detailed instructions. For Steps 2 and 3, see the "Ingress Gateway Configuration: Example Gateway Settings (page 110)" section. For Step 4, see the "Ingress Gateway Configuration: Example of Incoming Pots Dial-peer (page 111)" section. For Step 5, see the "Ingress Gateway Configuration: Example of SIP Ringtone Dial-Peer (page 112)" and the "Ingress Gateway Configuration: Example of SIP Error Dial-peer (page 112)" sections. For Step 6, see the "Ingress Gateway Configuration: Example of Dial-peer to Reach the Unified CVP Call Server or CUP (page 112)" section. See Chapter 12, "Configuring the SIP Devices (page 397)," in Part 3 for detailed information.
Note: Optionally, you can transfer the files from the Unified CVP product CD. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure an incoming Pots dial-peer. 5. Configure a dial-peer for ringtone and error. Note: This configuration is optional. 6. Do the following: If using a Proxy Server, configure your session target in the outbound dial peer to point to the Proxy Server. If using the sip-server global configuration, then configure the sip-server in the sip-ua section to be your Proxy Server and point the session target of the dial-peer to the sip-server global variable.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
83
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
Note: Make sure your dial plan includes this information. You will need to refer to the dial plan when you configure the SIP Proxy Server for Unified CVP. The SIP Service voip dial peer and the destination pattern on the Ingress Gateway must match the DNIS in static routes on the SIP Proxy Server or Unified CVP Call Server. [] For SIP without a Proxy Server, do the following: Refer to the Operations Console online help for detailed information. Also for this step, if using DNS query with 1. If using DNS query with SRV or A types from SRV or A types from the gateway, use CLI as shown the gateway, configure the gateway to use DNS. below: 2. Configure the DNS zone file, for the separate Note: Normally, non-DNS setup is sip-server DNS server, that displays how the Service ipv4:xx.xx.xxx.xxx:5060. (SRV) records are configured.
ip domain name pats.cisco.com
Note: SRV with DNS can be used in any of the SIP call flow models, with or without a Proxy ip name-server 10.86.129.16 server. Standard A type DNS queries can be sip-ua used as well for the calls, without SRV, but they lose the load balancing and failover sip-server dns:cvp.pats.cisco.com capabilities. or For SIP with a Proxy Server, do the following:
ipv4:xx.xx.xxx.xxx:5060
1. If you are using the DNS Server, you can set your SIP Service as the Host Name (either A For Step 2 for SIP without a Proxy Server, see the "DNS Zone File Configuration (page 115)" section. or SRV type). You can also configure the Gateway statically For Step 1 for SIP with a Proxy Server see Chapter 12, instead of using DNS. The following example "Configuring the SIP Devices (page 397)," in Part 3. shows how both the A and SRV type records could be configured:
ip host cvp4cc2.cisco.com 10.4.33. 132 ip host cvp4cc3.cisco.com 10.4.33. 133 ip host cvp4cc1.cisco.com 10.4.33. 131
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
84
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
For SIP/TCP:
ip host _sip._tcp.cvp.cisco.com srv 50 50 5060 cvp4cc3.cisco.com ip host _sip._tcp.cvp.cisco.com srv 50 50 5060 cvp4cc2.cisco.com ip host _sip._tcp.cvp.cisco.com srv 50 50 5060 cvp4cc1.cisco.com
For SIP/UDP:
ip host _sip._udp.cvp.cisco.com srv 50 50 5060 cvp4cc3.cisco.com ip host _sip._udp.cvp.cisco.com srv 50 50 5060 cvp4cc2.cisco.com ip host _sip._udp.cvp.cisco.com srv 50 50 5060 cvp4cc1.cisco.com
Note: The DNS Server must be configured with all necessary A type or SRV type records. [] Configure the VoiceXML Gateway used for the VRU leg: 1. Copy the Unified CVP gateway scripts from the <cvp root>\Cisco\CVP\OpsConsoleServer \GWDownloads folder on the Unified CVP product CD-ROM. 2. Configure the base gateway settings. survivabilty.tcl 3. Configure the service gateway settings. bootstrap.vxml 4. Configure the dial-peers for the Play Media (PM) Micro-Application and the ICM VRU Label. recovery.vxml ringtone.tcl cvperror.tcl ringback.wav critical_error.wav Do the following: For Step 1, copy the following Unified CVP gateway scripts: bootstrap.tcl handoff.tcl
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
85
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
Refer to the Operations Console online help for detailed instructions. For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings (page 113)" section. For Step 4, see the "VoiceXML Gateway Configuration: Example of Play Media (PM) Micro-Application Dial-peer (page 115)" and the "VoiceXML Gateway Configuration: Example of ICM VRU Label (page 115)" sections. See Chapter 12, "Configuring the SIP Devices (page 397)," in Part 3 for detailed information. [] Enable security media fetches. Click the Use Security for Media Fetches checkbox on the IVR Service tab.
The VXML that the IVR Service returns as a response to an HTTP/HTTPS request from the Refer to the Operations Console online help for detailed VXML gateway contains URLs to media servers, so information about the IVR Service. that the gateway knows where to fetch the media See the Micro-Application ECCs table (page 592) for files from. details about the user.microapp.media_server ECC The URLs to the media servers in the VXML variable. returned by the IVR Service can be controlled so that they are either HTTP or HTTPS URLs. This property is a boolean property called Use Security for Media Fetches. By default, it is set to "false." A value of "true" means to generate HTTPS URLs to media servers and a value of "false" means to generate HTTP URLs to media servers. This property is only applicable if both of the following conditions are true: The client is not the H.323 Service. This is because the H.323 Service does not support HTTPS. In the Unified ICME script, the media server (specified in ECC variable "call.user.microapp.media_server") is not set to a URL that explicitly specifies an HTTP or HTTPS scheme. An example of a URL that explicitly specifies an HTTP scheme is "http://<servername>:80." One that specifies an HTTPS scheme is "https://<servername>:443."
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
86
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
An example of a URL that does not specifies the scheme is "<servername>." In the Operations Console, the user-visible text for this property is "Use Security for Media Fetches." The Call Server does not have to be re-started for this property to take effect. [] If you will use ASR and TTS Servers, specify IP Do one of the following: addresses for those servers for each locale using the applicable name resolution system for the Gateway If using a CSS, the server name is configured to the virtual IP (VIP) of the Call Server on the CSS. (For (DNS or ip host commands). more information, see Chapter 15, "Configuring High Note: If ASR and TTS use the same server, the Availability for Unified CVP (page 491)" in Part 3.) MRCP server might allocate one license for the ASR session and a second license for the TTS section. If If not using a CSS, primary and backup servers must be configured. If using name resolution local to the you are hosting both ASR and TTS on the same speech server, you must select the ASR/TTS use the Gateway (rather than DNS) specify: same MRCP server option in the IVR Service ip host asr-<locale><ASR server for locale> configuration tab in the Operations Console and follow the instructions in the row below. ip host asr-<locale>-backup<backup ASR server for locale>
ip host tts-<locale><TTS server for locale> ip host tts-<locale>-backup<backup TTS
[]
If you select the ASR/TTS use the same MRCP If ASR and TTS share the same MRCP server, and you server option in the IVR Service configuration tab want one speech licence used per call, do the following: in the Operations Console, you must configure the 1. In the IVR Service in the Operations Console, select gateway as follows. the ASR/TTS use the same MRCP server option. 2. Add the following two host names to the gateway configuration:
ip host asrtts-<locale> <IP Address
Of MRCP Server>
ip host asrtts-<locale> -backup <IP
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
87
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
Where the locale might be something like en-us or es-es, resulting in asrtts-en-us or asrtts-es-es. 3. Change the 'ivr asr-server' and 'ivr tts-server' lines as follows:
ivr asr-server rtsp:// asrtts-en-us/recognizer ivr tts-server rtsp:// asrtts-en-us/synthesizer
[]
If you are using ASR and/or TTS with external grammar and expect the Gateway to resolve the addresses for those servers, give the following commands to the Gateway, specify ASR and/or TTS commands.
Note: This setting does not accommodate multiple locales and assumes that a CSS is deployed for failover handling. [] Configure the speech servers to work with Unified To ensure that the speech servers work with Unified CVP. CVP, you must make the following changes on each speech server as part of configuring the Unified CVP Caution: The Operations solution. Console can only manage speech servers installed on If you are using Nuance SpeechWorks MediaServer Windows (or AIX if (SWMS), the configuration file is osserver.cfg. If you supported by vendors), are using Nuance Speech Server (NSS), the configuration not on Linux. If the file is NSSserver.cfg. speech server is installed Make the following changes to the Nuance configuration on Linux, the server file: cannot be managed. Change:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
88
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
to:
server.resource.2.url VXIString recognizer
Change:
server.resource.4.url VXIString media/ speechsynthesizer
to:
server.resource.4.url VXIString synthesizer
Change:
server.mrcp1.resource.3.url VXIString media/speechrecognizer
to:
server.mrcp1.resource.3.url VXIString / recognizer
Change:
server.mrcp1.resource.2.url VXIString media/speechsynthesizer
to:
server.mrcp1.resource.2.url VXIString media/synthesizer
Change:
server.mrcp1.transport.port VXIInteger 4900
to:
server.mrcp1.transport.port VXIInteger 554
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
89
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
to:
com.ibm.voice.server.rtsbridge.recourl= recognizer
Change:
com.ibm.voice.server.rtsbridge.syntheurl=/ media/synthesizer
to:
com.ibm.voice.server.rtsbridge.syntheurl= synthesizer
[]
Specify the commands listed in the "Characteristics for the VRU Leg (page 117)" section to provide voice treatment. Note: You do not need to configure all services listed. Required services depend on the call flow model you are using and whether SIP or H.323 calls are being processed. These characteristics are for VRU legs requiring ASR and/or TTS treatment. If you have other requirements for DTMF relay, Codecs or VAD settings, you must modify the commands accordingly.
[]
On the Unified CM server, CCMAdmin Publisher, From the Unified CM Administration page: configure SIP-specific actions: 1. For Step 1, if you are using a version of CUP prior to 7.0(3), select System > Application Server > 1. Add the CUP Proxy Server. Add New: Enter your CUP proxy in the Add New 2. Create SIP trunks: window in the Application Server area. (This step is done autimatically by versions of CUP later than If you are using a SIP Proxy Server, set 7.0(3)) up a SIP trunk to the SIP Proxy Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
90
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
Add a SIP Trunk for the Unified CVP Call Server. Add a SIP Trunk for each Ingress gateway that will send SIP calls to Unified CVP that might be routed to Unified CM.
2. For Step 2, select Device > Trunk > Add New. Add the following:
Trunk Type: SIP trunk. Device Protocol: SIP. Destination Address: IP address or host name of the SIP Proxy Server (if using a SIP Proxy Server). If not using a SIP Proxy Server, enter the IP address or host name of the Unified CVP Call Server. DTMF Signaling Method: RFC 2833. Do not check the Media Termination Point Required checkbox. If you are using UDP as the outgoing transport on Unified CVP (and CUP routes if using a proxy server), also set the outgoing transport to UDP on the SIP Trunk Security Profile.
3. Add route patterns for outbound calls from Unified CM devices using a SIP Trunk to the Unified CVP Call Server. Also, add a route pattern for error DN. Note: For warm transfers, the call from Agent 1 to Agent 2 does not typically use a SIP Trunk, but you must configure the CTI Route Point for that dialed number on the Unified CM Server and associate that number with your peripheral gateway user (PGUSER) for the JTAPI gateway on the Unified CM peripheral gateway. An alternative is to use the Dialed Number Plan on Unified ICME to bypass the CTI Route Point. See the "Resource Sizing for Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature (page 386)" section in Chapter 10, "Using Cisco Unified ICME Warm Consult Transfer/Conference to Unified CVP," in Part 3. 4. If you are sending calls to Unified CM using an SRV cluster domain name, configure the cluster domain name. 5. Note the username and password for Unified CM. If you are using a SIP Proxy Server, you will need the Unified CM username and password when installing the CUP Proxy Server.
3. For Step 3, select Call Routing > Route/Hunt > Route Pattern > Add New. Add the following: Route Pattern: Specify the route pattern; for example: 3XXX" for a TDM phone that dials 9+3xxx and all Unified ICME scripts are set up for 3xxx dialed numbers. Gateway/Route List: Select the SIP Trunk defined in Step 2. Note the username and password for Unified CM. If you are using a SIP Proxy Server, you will need the Unified CM username and password when installing the CUP Proxy Server.
4. For Step 4, select Enterprise Parameters > Clusterwide Domain Configuration and add the Cluster fully qualified domain name FQDN.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
91
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
For detailed instructions about using Unified CM and the CUP Proxy Server, refer to the Unified CM and the Cisco Unified Presence Server (CUP) documentation. [] Configure the SIP Proxy Server (optional): 1. Configure the SIP static routes to the Unified CVP Call Server(s), Unified CM SIP trunks, and Gateways. Configure the SIP static routes for intermediary transfers for ringtone, playback dialed numbers, and error playback dialed numbers. Note: For failover and load balancing of calls to multiple destinations, configure the CUP static route with priority and weight. 2. Configure Access Control Lists for Unified CVP calls. 3. Configure the service parameters. 4. Note the IP address and host name of the SIP Proxy Server. You will need this information when configuring the SIP Proxy Server in Unified CVP. Note: You must use the SIP Proxy components of CUP, not the Presence Engine component. 5. If using redundant SIP Proxy Servers (primary and secondary or load balancing), then decide whether to use DNS server lookups for SRV records or non-DNS based local SRV record configuration. Note: If a single CUP Proxy Server is used, then SRV record usage is not required. This option is not applicable for the Unified CVP Full Video Service. From the CUP Administration web page (http:\\<CUP server>)0: 1. For Step 1, select Cisco Unified Presence Server > Proxy Server > Static Routes > Add New, (in CUP 7.0(0) and greater select Presence > Routing > Static Routes) specify: Transport: UDP or TCP (UDP is recommended). Destination Pattern: Specify the dialed number pattern for the destination. For example: 777* (matches 777 followed by any number of characters 14085551234 (matches only 14085551234) 1408555.... (matches 1408555 followed by any four characters) Next Hop: <IP Address or DNS resolvable FQDN of Gateway or Unified Communications_Manager_short>, depending on the Destination Pattern. If the Destination Pattern is the VRU leg label, then the Next Hop would be the IP address of the VoiceXML Gateway. If the Destination Pattern is an agent label pattern, then the Next Hop would be the IP address of Unified CM on which the agent device is registered. Protocol Type: UDP or TCP (UDP is recommended).
0)
http://<CUP server>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
92
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
The Comprehensive call flow model with SIP calls will typically be deployed with dual CUPs Proxies for redundancy. In some cases, you might want to purchase a second CUPs Proxy. Regardless, the default transport for deployment will be UDP, and make sure you always set the AddRecordRoute setting to Off with CUPs.
See CUP Proxy Static Route Provisioning Use Cases (page 655) for confguration examples for multiple sites. 2. For Step 2, select Proxy Settings > Incoming ACL (in CUP 7.0(0) and greater select System > Security > Incoming ACL): Address pattern: all. Note: Unified CVP does not utilize the ACL functionality. 3. For Step 3, select Service Parameters, then set the following: Add record route: off. Maximum invite retransmission count: 2. Proxy Domain and Cluster Name: if using DNS SRV, set to the FQDN of your Proxy Server SRV name.
4. For Step 4, note the IP address and host name of the SIP Proxy Server. 5. For Step 5, configure the SRV records on the DNS server or locally on Unified CVP with a .xml file (local xml configuration avoids the overhead of DNS lookups with each call). Note: See the "Local SRV File Configuration Example for SIP Messaging Redundancy (page 162)" section for detailed information. For the required settings in the Unified CM Publisher configuration, refer to the Cisco Unified Presence Server (CUP) Proxy Server documentation. [] On Unified ICME or the NAM, ICM Configuration Specify the following: Manager, Network VRU Explorer tool: Type: 10. 1. Define a Network VRU for the VRU leg and Name: <Network VRU Name>. labels for each Unified CVP Call Server. For example: cvp. On the CICM only, ICM Configuration Manager, Network VRU Explorer tool: Define a label for each Unified CVP Call Server that is handling the Switch leg:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
93
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
1. Define a Network VRU for the VRU leg and labels for reaching the NAM.
Label: <Network Routing Number> . Type: Normal. Routing client for Unified ICME or the NAM: Select the routing client configured for that Unified CVP Call Server peripheral from the drop-down list. Routing client for CICM only: Select the INCRP routing client from the drop-down list. Note: The Network VRU label in the NAM and CICM must be identical. The Network VRU Names on the NAM and CICM must also be identical to avoid confusion.
[]
On Unified ICMH, on the NAM and CICMs, configure the Network VRUs and PGs for the switch leg in the ICM Configuration Manager, Network VRU Explorer tool: 1. Define one label per Unified CVP Call Server or NIC routing client. Note: Use the same Type 10 Network VRU that you previously defined for the VRU leg (page 93).
For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition.
[]
On the CICM, ICM Configuration Manager, NIC Explorer tool: 1. Set the client type for the INCRP NIC.
[]
On the CICM, ICM Configuration Manager, Network VRU Explorer tool: 1. Define a Network VRU with a label that uses INCRP as its routing client. 2. Define one label for the NAM routing client.
Do the following: 1. For Step 1, specify the following: Type: 10. Name: <name of Unified CVP VRU>. For example: cvpVRU.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
94
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
2. For Step 2, specify the following: Type: Normal. Label: <Network Routing Number>. Routing client: INCRP NIC.
For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On the NAM, ICM Configuration Manager, PG Explorer tool: 1. Configure each peripheral gateway (PG) to be used for Unified CVP. 2. Configure a peripheral for each Unified CVP Call Server. In the tree view pane, select the applicable PG: On the Logical Controller tab: Client Type: VRU. Name: A name descriptive of this PG. For example: <location>_A for side A of a particular location. On the Peripheral tab: Peripheral Name: A name descriptive of this Unified CVP peripheral. For example: <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. On the Advanced tab: Select the name of the Unified CVP VRU from the Network VRU field drop-down list. For example: cvpVRU. On the Routing Client tab: Name: By convention, use the same name as the peripheral. Client Type: VRU. If you are in a Unified ICMH environment and configuring the CICM, then do the following:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
95
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
-- Do not select the Network Transfer Preferred checkbox. -- Routing client: INCRP NIC. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On Unified ICME or the NAM, ICM Configuration In the General section of the System Information tool: Manager, System Information tool: Define the Default Network VRU: <Network VRU 1. For Unified ICME or on the CICM only, Name>. define a default Network VRU. For example: cvpVRU. 2. If there are Routing Scripts on the NAM, define For more information, refer to the ICM Configuration a default Network VRU. Guide for Cisco ICM Enterprise Edition. On the Unified ICME or Unified ICMH Server in the ICM Configuration Manager: 1. Configure the dialed numbers. 2. For Step 2, use the Call Type List tool tab. 2. Configure the call types. 3. For Step 3, use the ICM Instance Explorer tool tab. 3. Configure the applicable customers. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On Unified ICME, ICM Configuration Manager: 1. Configure the ECC variables. [] On the Unified ICME or Unified ICMH Server in the ICM Script Editor tool: 1. Create a routing script that handles the incoming call. For more information, see the "Common Unified ICMH Configuration: Define Unified CVP ECC Variables (page 155)" section. In the ICM Script Editor: 1. For Step 1, use the SendToVRU node to connect the call to the Network VRU. For more information about creating scripts, see Chapter 4, "Writing Scripts for Unified CVP (page 175)." Refer to the ICM Scripting and Media Routing Guide for Cisco ICM/IPCC Enterprise & Hosted Editions for more information. [] If using a SIP Proxy Server, configure the SIP Proxy Server device in Unified CVP: 1. In the Operations Console, configure the SIP Proxy Server. In the Operations Console: 1. Select Device Management > SIP Proxy Server. In the ICM Configuration Manager: 1. For Step 1, use the Dialed Number List Tool tab.
[]
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
96
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
For detailed information about configuring a SIP Proxy Server, see the "Configuring a SIP Proxy Server (page 397)" section in Chapter 12, "Configuring the SIP Devices," in Part 3. [] In the Operations Console, install and configure the In the Operations Console: Call Server(s): 1. For Step 1, select Device Management > CVP 1. Enable the ICM and SIP Services on the Call Call Server: Select the ICM and SIP checkboxes. Server. 2. For Step 2, select Device Management > CVP 2. Configure the SIP Service: Call Server > SIP tab. If you are using a SIP Proxy Server, enable the Outbound Proxy and select the SIP Proxy Server. If you are not using a SIP Proxy Server, configure static routes to each third-party SIP gateway/ACD, SIP endpoints to receive calls. Note: The SIP Service voip dial peer and the destination pattern of the Ingress Gateway must match the DNIS. Configure destination labels. Check the default values for the SIP Service and change, if desired. The following static route configuration is not correct because the least explicit routes must appear at the end. Load balancing and/or failover of calls will require DNS SRV domain names, not multiple routes with the same DN Pattern, but a single route to an SRV domain name.
1>,10.2.6.1 2>,10.2.6.2 3>,10.2.6.20 2229191>,10.2.6.241 2229292>,10.2.6.241 2229191>,10.2.6.242 2229292>,10.2.6.242
Do the following: Enable Outbound Proxy: Yes Outbound Proxy Host: Select from drop-down list. Local Static Routes, Dialed Number (DN): Specify the dialed number pattern (page 63) for the destination. Example: 9> (Errors are 9292 and ringtone is 9191)
3. Configure the ICM Service by setting the maximum length DNIS to the length of the Network Routing Number.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
97
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
2>,ccm-subscribers.cisco.com 3>,ccm-subscribers.cisco.com
Note: "91919191>" pattern will not match an exact DN of "91919191." 3. For Step 3, select Device Management > CVP Call Server > ICM tab: Maximum Length of DNIS: length of the Network Routing Number. Example: if the Gateway dial pattern is 1800******, the maximum DNIS length is 10. For detailed information, refer to the Operations Console online help. [] In the Operations Console, configure the custom In the Operations Console, select Device Management ringtone patterns to play different ring tones based > CVP Call Server > SIP tab: on the dialed number destination: 1. In the Custom ringtone patterns group box, specify 1. Specify a custom Dialed Number (DN) pattern. a custom Dialed Number (DN) pattern. 2. Specify a specific .wav file name for a destination label pattern. 2. Specify the file name of the ringtone to be played for the respective dialed number in the Ringtone media file name field. 3. Click Add to add the Dialed Number (DN) and ringtone file to the list displayed in the box below the Add button. 4. Click Save. [] In the Operations Console, configure the Reporting In the Operations Console, select Device Management Server (optional): > CVP Reporting Server > General tab:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
98
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server.
1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal.
Configuration Instructions for the Unified CVP Comprehensive Call Flow Model Using H.323
The following table contains the configuration instructions for the Comprehensive Call Flow Model using H.323 for both Unified ICME and Unified ICMH. Note: See the "Unified CVP Comprehensive (SIP/H.323) Call Flow Model, Unified ICMH (page 118)" section for detailed information about the Unified ICMH version of this call flow model.
Table 11: Configuration Checklist, Unified CVP Comprehensive Call Flow Model, Unified ICME and Unified ICMH Using H.323
Where to Go/What to Do
[]
Install the Gateways: 1. Install the IOS image on the Ingress Gateway.
[]
Do the following:
1. Transfer the following Unified CVP gateway For Step 1, in the Operations Console select Device scripts using the Unified CVP Operations Management > Gateway > File Transfer > Scripts, Console: then browse to the <cvp root>\Cisco\CVP\OpsConsoleServer bootstrap.tcl \GWDownloads folder. handoff.tcl survivabilty.tcl bootstrap.vxml recovery.vxml For Steps 2 and 3, see the "Ingress Gateway Configuration: Example Gateway Settings (page 110)" section. Refer to the Operations Console online help for detailed instructions.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
99
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
cvperror.tcl critical_error.wav
For Step 4, see the "Ingress Gateway Configuration: Example of Incoming Pots Dial-peer (page 74)" section. For Step 5, see the "Ingress Gateway Configuration: Example of Using Gatekeeper Lookup to Reach the Call Server (page 75)" section. See Chapter 14, "Configuring the H.323 Devices and VoIP (page 453)," in Part 3 for detailed information.
Note: Optionally, you can transfer the files from the Unified CVP product CD. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure a dial-peer for the Unified CVP Call Server. 5. Configure the gatekeeper. [] Configure the VoiceXML Gateway used for the VRU leg: 1. Copy the Unified CVP gateway scripts from the <cvp root>\Cisco\CVP\OpsConsoleServer \GWDownloads folder on the Unified CVP product CD-ROM. Note: If you have installed a Unified CVP Call Server, you can also copy gateway scripts from the <cvp root>\Cisco\CVP\OpsConsoleServer \GWDownloads folder on the Call Server. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure the dial-peers for the Play Media (PM) Micro-Application and the ICM VRU Label.
Do the following: For Step 1, copy the following Unified CVP gateway scripts: bootstrap.tcl handoff.tcl survivabilty.tcl bootstrap.vxml recovery.vxml cvperror.tcl critical_error.wav Refer to the Operations Console online help for detailed instructions. For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings (page 113)" section. For Step 4, see the "VoiceXML Gateway Configuration: Example of Play Media (PM) Micro-Application Dial-peer (page 115)" and the
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
100
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
"VoiceXML Gateway Configuration: Example of ICM VRU Label (page 115)" sections. See Chapter 14, "Configuring the H.323 Devices and VoIP (page 453)," in Part 3 for detailed information. [] Configure the Gatekeeper: 1. Register all Gateways. 2. Configure the Gatekeeper to send all VRU connections to the applicable Gateway. 3. Configure the Gatekeeper to send all agent device target labels to the IP address of the applicable Unified CM trunks. Do the following: 1. For Step 1, add the boldfaced lines to the Gateway configuration. The Gateway auto-registers with the Gatekeeper once these lines are configured. interface FastEthernet0/0 ip address 10.86.129.79 255.255.255.0 ip route-cache same-interface duplex full speed 100 no cdp enable h323-gateway voip interface h323-gateway voip id <zone ID specified on the GK> ipaddr <IP of GK> 1719 h323-gateway voip h323-id <IP of this GW> h323-gateway voip tech-prefix 1# 2. For Step 2, include the following:
zone prefix <GK> <Network Routing Number>* gw-priority 10 <H323-ID of
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
101
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
zone prefix sox-gk 2* gw-priority 10 <CCM Trunk ID> zone prefix sox-gk 4* gw-priority 10 <CCM Trunk ID> zone prefix sox-gk 777* gw-priority <VXML GW1 IP><VXML GW2 IP> For example: zone prefix sox-gk 1* gw-priority 10 SOX_CCM_H323_TRUNK_2 SOX_CCM_H323_TRUNK_3 zone prefix sox-gk 2* gw-priority 10 SOX_CCM_H323_TRUNK_2 SOX_CCM_H323_TRUNK_3 zone prefix sox-gk 4* gw-priority 10 SOX_CCM_H323_TRUNK_2 SOX_CCM_H323_TRUNK_3 zone prefix sox-gk 777* gw-priority 10 10.86.129.106 10.86.129.20 See Chapter 14, "Configuring the H.323 Devices and VoIP (page 453)," in Part 3 for detailed information. [] On the Unified CM server, CCMAdmin Publisher, From the Unified CM Administration page: configure H.323-specific actions: 1. For Step 1, select Device > Gatekeeper > Add 1. Add the Gatekeeper. New: Add the Host Name/IP address of Gatekeeper. 2. Add the Unified CVP H.323 Service as an H.323 gateway. 3. Add an H.323 Trunk for Unified CM to register with the Gatekeeper. 2. For Step 2, select Device > Gateway > Add New. Add the following: Gateway Type: H.323 Gateway. Device Name: <Unified CVP Call Server IP address>. Description: <Unified CVP Call Server IP address (or other identifying text)>. Device Pool: <device pool>.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
102
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
Calling Party Selection: From the Calling Party Selection list, select Originator. Calling Party Presentation: Allowed.
3. For Step 3, select Device > Trunk > Add New. Add the following: Trunk Type: H.225 Trunk (Gatekeeper controlled). Device Protocol: H.225. Device Name: <name for your trunk>. For example: MY_CCM_TRUNK. Device Pool: <device pool>. Gatekeeper Name: From the drop-down list, select the Gatekeeper to which this trunk will register. Terminal Type: Gateway. Technology Prefix: 1#.
For detailed instructions about using Unified CM, refer to the Unified CM documentation. [] On Unified ICME or the NAM, ICM Configuration Specify the following: Manager, Network VRU Explorer tool: Type: 10. 1. Define a Network VRU for the VRU leg and Name: <Network VRU Name>. labels for each Unified CVP Call Server. For example: cvp. On the CICM only, ICM Configuration Manager, Network VRU Explorer tool: 1. Define a Network VRU for the VRU leg and labels for reaching the NAM. Define a label for each Unified CVP Call Server that is handling the Switch leg: Label: <Network Routing Number> . Type: Normal.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
103
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
Routing client for Unified ICME or the NAM: Select the routing client configured for that Unified CVP Call Server peripheral from the drop-down list. Routing client for CICM only: Select the INCRP routing client from the drop-down list. Note: The Network VRU label in the NAM and CICM must be identical. The Network VRU Names on the NAM and CICM must also be identical to avoid confusion. [] On Unified ICME or the NAM, ICM Configuration In the tree view pane, select the applicable PG: Manager, PG Explorer tool: On the Logical Controller tab: 1. Configure each peripheral gateway (PG) to be Client Type: VRU. used for the VRU Client leg. 2. Configure a peripheral for each Unified CVP Call Server to be used for a VRU leg connected to each PG. Name: A name descriptive of this PG. For example: <location>_A for side A of a particular location.
Note: If you are using the same Unified CVP Call On the Peripheral tab: Server for the Switch and VRU legs, skip this step Peripheral Name: A name descriptive of this as this configuration is already completed. If you are Unified CVP peripheral. using the same PG but different Call Servers, you need to perform only the second part of the step. For example: <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. On the Advanced tab: Select the name of the Unified CVP VRU from the Network VRU field drop-down list. For example: cvpVRU. On the Routing Client tab: Name: By convention, use the same name as the peripheral.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
104
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
Client Type: VRU. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On Unified ICMH, on the NAM and CICMs, configure the Network VRUs and PGs for the switch leg in the ICM Configuration Manager, Network VRU Explorer tool: 1. Define one label per Unified CVP Call Server or NIC routing client. Note: Use the same Type 10 Network VRU that you previously defined for the VRU leg (page 103). [] On the CICM, ICM Configuration Manager, NIC Explorer tool: 1. Set the client type for the INCRP NIC. [] On the CICM, ICM Configuration Manager, Network VRU Explorer tool: 1. Define a Network VRU with a label that uses INCRP as its routing client. 2. Define one label for the NAM routing client. Do the following: 1. For Step 1, specify the following: Type: 10. Name: <name of Unified CVP VRU>. For example: cvpVRU. 2. For Step 2, specify the following: Type: Normal. Label: <Network Routing Number>. Routing client: INCRP NIC. Do the following: 1. Set the Client Type: VRU. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition.
For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On the NAM, ICM Configuration Manager, PG Explorer tool: In the tree view pane, select the applicable PG.
Logical Controller tab: 1. Configure each PG to be used for the Switch Client Type: VRU. leg.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
105
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
2. Configure a peripheral for each ICM Service Name: A name descriptive of this PG, for example, to be used for a Switch leg connected to each <location>_A, for side A of a particular location. PG. Peripheral tab: Peripheral Name: A name descriptive of this Unified CVP peripheral, for example, <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. Advanced tab: Select the name of the Unified CVP VRU from the Network VRU field drop-down list; for example, cvpVRU. Routing Client tab: Name: By convention, use the same name as the peripheral. Client Type: VRU. Do not select the Network Transfer Preferred checkbox. Routing client: INCRP NIC. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On Unified ICME, ICM Configuration Manager, PG In the tree view pane, select the applicable PG: Explorer tool: On the Logical Controller tab: 1. Configure each peripheral gateway (PG) to be Client Type: VRU. used for the Switch leg. 2. Configure a peripheral for each Unified CVP Call Server to be used for a Switch leg connected to each PG. Name: A name descriptive of this PG. For example: <location>_A for side A of a particular location.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
106
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
Note: If you are using the same Unified CVP Call On the Peripheral tab: Server for the Switch and VRU legs, skip this step Peripheral Name: A name descriptive of this as this configuration is already completed. If you are Unified CVP peripheral. using the same PG but different Call Servers, you need to perform only the second part of the step. For example: <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. On the Advanced tab: Select the name of the Unified CVP VRU from the Network VRU field drop-down list. For example: cvpVRU. On the Routing Client tab: Name: By convention, use the same name as the peripheral. Client Type: VRU. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. [] On Unified ICME or the NAM, ICM Configuration In the General section of the System Information tool: Manager, System Information tool: Define the Default Network VRU: <Network VRU 1. For Unified ICME or on the CICM only, Name>. define a default Network VRU. For example: cvpVRU. 2. If there are Routing Scripts on the NAM, define For more information, refer to the ICM Configuration a default Network VRU. Guide for Cisco ICM Enterprise Edition. On the Unified ICME or Unified ICMH Server in the ICM Configuration Manager: 1. Configure the dialed numbers. 2. For Step 2, use the Call Type List tool tab. 2. Configure the call types. 3. For Step 3, use the ICM Instance Explorer tool tab. 3. Configure the applicable customers. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. In the ICM Configuration Manager: 1. For Step 1, use the Dialed Number List Tool tab.
[]
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
107
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
[]
For more information, see the "Common Unified ICMH Configuration: Define Unified CVP ECC Variables (page 155)" section. In the ICM Script Editor: 1. For Step 1, use the SendToVRU node to connect the call to the Network VRU. For more information about creating scripts, see Chapter 4, "Writing Scripts for Unified CVP (page 175)." Refer to the ICM Scripting and Media Routing Guide for Cisco ICM/IPCC Enterprise & Hosted Editions for more information.
[]
On the Unified ICME or Unified ICMH Server in the ICM Script Editor tool: 1. Create a routing script that handles the incoming call.
[]
In the Operations Console, install and configure the In the Operations Console: Call Server(s): 1. For Step 1, select Device Management > CVP Call Server: Select the ICM, IVR, H.323 and 1. Enable the ICM, IVR, and H.323 Services on the Call Server. checkboxes. For detailed information, refer to the Operations Console online help.
[]
Configure the ICM Servicein the Operations Console In the Operations Console, select Device Management by specifying the following required information: > CVP Call Server > ICM tab: 1. VRU Connection Port. 2. Maximum Length of DNIS. 3. Call service IDs: New Call and Pre-routed. 4. Trunk group IDs: New Call and Pre-routed. For example: if the Gateway dial pattern is 1800******, the maximum DNIS length is 10. Set the VRU Connection Port to match the VRU connection Port defined in ICM Setup for the corresponding VRU peripheral gateway (PIM). Configure the ports for both groups according to the licenses purchased, call profiles, and capacity by completing the required fields on this tab. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values. Set the maximum length DNIS to the length of the Network Routing Number.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
108
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
[]
In the Operations Console, select Device Management > CVP Call Server > IVR tab: 1. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values.
[]
In the VBAdmin tool, configure the H.323 Service: In the VBAdmin tool, select Cisco Unified Customer Voice Portal H.323 Service: 1. Set the IP address of the Gatekeeper. 1. For Step 1, specify: SetGateKeeper<GK IP 2. Configure the capacity. Address> 3. Restart the H.323 Service. . Where <GK IP Address> is the IP address for the Gatekeeper serving the H.323 Service. 2. For Step 2 for Unified ICMH only, configure the total number of calls and IVR ports according to the licenses purchased, call profiles, and capacity. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values. 3. For Step 3, restart the H.323 service: Start > Programs > Cisco Unified Customer Voice Portal > H.323 Service Click Shutdown. Click Start.
Verify that the H.323 Service can communicate with the Gatekeeper. [] In the Operations Console, configure the Reporting In the Operations Console, select Device Management Server (optional): > CVP Reporting Server > General tab: 1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server. 1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
109
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Where to Go/What to Do
3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal.
service timestamps debug datetime msec localtime service timestamps log datetime msec localtime ! service internal logging buffered 99999999 debugging no logging console ! ip cef ! voice rtp send-recv ! voice service voip signaling forward unconditional
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
110
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
h323 sip min-se 360 rel1xx disable header-passing ! voice class codec 1 codec preference 1 g711ulaw codec preference 2 g729r8 ! application service cvperror flash:cvperror.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service cvp-survivability flash:survivability.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service ringtone flash:ringtone.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service handoff flash:handoff.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! gateway timer receive-rtcp 6 ! ip rtcp report interval 3000 ! sip-ua retry invite 1 timers expires 60000 sip-server ipv4:<IP of CUP Proxy or Call Server>:5060 reason-header override Ingress Gateway Configuration: Example of Incoming Pots Dial-peer
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
111
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
The following example provides the configuration for an incoming Pots call for the Comprehensive call flow model:
dial-peer voice 8 pots description Example incoming POTS dial-peer service cvp-survivability incoming called-number <your DN pattern here> direct-inward-dial Ingress Gateway Configuration: Example of SIP Ringtone Dial-peer
The following example provides the configuration for a SIP ringtone for the Comprehensive call flow model:
dial-peer voice 9191 voip description SIP ringtone dial-peer service ringtone voice-class codec 1 voice-class sip rel1xx disable incoming called-number <your ringtone DN pattern here> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad ! Ingress Gateway Configuration: Example of SIP Error Dial-peer
The following example provides the configuration for a SIP error dial-peer for the Comprehensive call flow model:
dial-peer voice 9292 voip description SIP error dial-peer service cvperror voice-class codec 1 voice-class sip rel1xx disable incoming called-number <your error DN pattern here> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad Ingress Gateway Configuration: Example of Dial-peer to Reach the Unified CVP Call Server or CUP
The following example provides the configuration for a dial-peer to reach the Unified CVP Call Server or CUP for the Comprehensive call flow model:
dial-peer voice 800 voip description Example Call Server Dialpeer with CUP destination-pattern <your DN pattern here> voice-class codec 1 session protocol sipv2 session target sip-server dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
112
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Ingress Gateway Configuration: Example of Using Gatekeeper Lookup to Reach the Call Server
The following example provides the configuration to use gatekeeper lookup for the Comprehensive call flow model:
dial-peer voice 800 voip translation-profile incoming block description Example Call Server Dialpeer with GK destination-pattern <your DN pattern here> voice-class codec 1 session target ras dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad VoiceXML Gateway Configuration: Example Gateway Settings
The first part of the following example provides the basic configuration for setting a VoiceXML gateway: Applies a timestamp to debugging and log messages Turns on logging Turns off printing to the command line interface console Sends RTP packets Configures ASR/TTS Server Configures gateway settings The last part of this example provides the following: Initiates the VoiceXML leg Intitiates the switch leg of the call Plays a .wav file that enables caller to hear message from critical_error.wav Logs errors on the gateway when the call fails
service timestamps debug datetime msec service timestamps log datetime msec service internal logging buffered 99999999 debugging no logging console ip cef no ip domain lookup ip host tts-en-us <IP of TTS or MRCP Server> ip host asr-en-us <IP of ASR or MRCP Server>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
113
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
voice rtp send-recv ! voice service voip signaling forward unconditional h323 sip min-se 360 rel1xx disable header-passing voice class codec 1 codec preference 1 g711ulaw codec preference 2 g729r8 voice translation-rule 1 rule 1 /987654/ // ! ! voice translation-profile block translate called 1 ! ! ivr prompt memory 15000 ivr prompt streamed none ivr asr-server rtsp://asr-en-us/recognizer ivr tts-server rtsp://tts-en-us/synthesizer mrcp client timeout connect 10 mrcp client timeout message 10 mrcp client rtpsetup enable rtsp client timeout connect 10 rtsp client timeout message 10 vxml tree memory 1000 http client cache memory pool 15000 http client cache memory file 500 http client cache refresh 864000 http client connection timeout 60 http client response timeout 30 gateway timer receive-rtcp 6 ! ip rtcp report interval 3000 application service new-call flash:bootstrap.vxml paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service cvperror flash:cvperror.tcl paramspace english index 0
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
114
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
paramspace english language en paramspace english location flash paramspace english prefix en service handoff flash:handoff.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service bootstrap flash:bootstrap.tcl paramspace english index 0 paramspace english language en paramspace english location flash param cvpserverss1 1 paramspace english prefix en
Note: The optional param cvpserverss1 1 line enables HTTPS.
dial-peer voice 987654 voip description Dial-peer needed for PM Micro-App translation-profile incoming block incoming called-number 987654 VoiceXML Gateway Configuration: Example of Dial-peer for ICM VRU Label
The following example provides the configuration for an ICM VRU label dial-peer for the Comprehensive call flow model:
dial-peer voice 777 voip description ICM VRU label translation-profile incoming block service bootstrap voice-class codec 1 incoming called-number <your sendtovru label pattern here> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
115
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
ringtone-1 IN A 10.86.129.20 ringtone-2 IN A 10.86.129.229 vxml-1 IN A 10.86.129.20 vxml-2 IN A 10.86.129.229 vxml-3 IN A 161.44.81.254 cvp-1 IN A 10.86.129.211 cvp-2 IN A 10.86.129.220 cvp-3 IN A 161.44.81.254 ; Priority Weight Port Target sip._tcp.ringtone.sox.cisco.com. SRV 1 1 5060 ringtone-1.sox.cisco.com. _ SRV 1 1 5060 ringtone-2.sox.cisco.com. sip._udp.ringtone.sox.cisco.com. SRV 1 1 5060 ringtone-1.sox.cisco.com. _ SRV 1 1 5060 ringtone-2.sox.cisco.com. _sip._tcp.vxml.sox.cisco.com. SRV 1 1 5060 vxml-1.sox.cisco.com. SRV 1 1 5060 vxml-2.sox.cisco.com. SRV 1 1 5060 vxml-3.sox.cisco.com. _sip._udp.vxml.sox.cisco.com. SRV 2 1 5060 vxml-1.sox.cisco.com. SRV 2 1 5060 vxml-2.sox.cisco.com. SRV 1 1 5060 vxml-3.sox.cisco.com. _sip._tcp.cvp.sox.cisco.com. SRV 1 1 5060 cvp-1.sox.cisco.com. SRV 2 1 5060 cvp-2.sox.cisco.com. SRV 3 1 5060 cvp-3.sox.cisco.com. _sip._udp.cvp.sox.cisco.com. SRV 1 1 5060 cvp-1.sox.cisco.com. SRV 2 1 5060 cvp-2.sox.cisco.com. SRV 3 1 5060 cvp-3.sox.cisco.com. DNS Zone File MS DNS Configuration Example
The following is an example of a DNS zone file MS DNS configuration.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
116
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
service vru-leg flash:bootstrap.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service new-call flash:bootstrap.vxml paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service handoff flash:handoff.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service ringtone flash:ringtone.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service cvperror flash:cvperror.tcl
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
117
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en ! service cvp-survivability flash:survivability.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
118
Chapter 2: Configuration Overview Unified CVP Comprehensive (SIP/H.323) Call Flow Models
Although the following figure shows two Gateways (one where the call arrives and a separate one for the VRU leg), these could be the same physical Gateway. Similarly, the Unified CVP IVR Service in the Operations Console and the PG could be the same physical machine. For simplicity, the figure does not illustrate a call flow model for redundancy and failover. Also, the Gatekeeper is not shown.
Figure 18: Unified CVP Comprehensive with SIP without Proxy Server, Unified ICMH
The following figure shows the call flow for this call flow model using SIP with a Proxy Server.
Figure 19: Unified CVP Comprehensive with SIP with Proxy Server with Proxy Server, Unified ICMH
Note: The numbers in the figure indicate call flow progression. The following figure shows the call flow for this call flow model using H.323. Note: For simplicity, this diagram does not show interactions with the Gatekeeper.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
119
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Configuration overview for this call flow model: There are two Network VRUs: One on the NAM for the Switch leg and the VRU leg (Type 10). One for the CICM for the INCRP connection. The Network VRU names (where applicable) and the ECC variable configurations must be identical on the NAM and CICM. All Labels must also be duplicated but their routing clients will be different. Use the ICM Script Editors SendToVRU node to connect the call to the Network VRU. See the Comprehensive Call Flow Model table (page 56) for configuration instructions for this call flow model. Note: See the "REFER Transfers Using "RFXXXX" Type Unified ICME Labels (page 403)" and the "Using the sendtooriginator Setting in the SIP Service (page 404)" sections in Chapter 12, "Configuring the SIP Devices," in Part 3 for more information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
120
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Note: The numbers in the figure represent call flow progression. Configuration overview for this call flow model: There is one Network VRU: a Type 8 when NIC is queuing and transferring calls. Define a Translation Route and labels for the VRU Peripheral (Network VRU labels do not need to be configured.)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
121
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Use the ICM Script Editors TranslationRouteToVRU node to connect the call to the Network VRU. The following table contains the configuration instructions for this call flow model.
Table 12: Configuration Checklist, Type 8, Unified CVP VRU-Only, Unified ICME
Where to Go/What To Do
[]
Configure the VoiceXML Gateway used for Do the following: the VRU leg: For Step 1, in the Operations Console select Device 1. Transfer the following Unified CVP Management > Gateway > File Transfer > Scripts, then gateway scripts using the Unified CVP browse to the <cvp root>\Cisco\CVP\OpsConsoleServer Operations Console: \GWDownloads folder. bootstrap.tcl handoff.tcl survivabilty.tcl bootstrap.vxml recovery.vxml ringtone.tcl cvperror.tcl ringback.wav critical_error.wav For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings (page 127)" section. For Step 4, see the "VoiceXML Gateway Configuration: Example of Play Media (PM) Micro-Application Dial-peer (page 129)" and the "VoiceXML Gateway Configuration: Example of ICM VRU Label (page 129)" sections. Refer to the Operations Console online help for detailed instructions.
Note: Optionally, you can transfer the files from the Unified CVP product CD. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure the dial-peers for the Play Media (PM) Micro-Application and the ICM VRU Label. [] On Unified ICME, ICM Configuration Manager, Network VRU Explorer tool: Specify the following: Type: 8.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
122
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
Name: cvpVRU. Note: This name is used by convention. Any name will do; since it is referenced elsewhere in this document, cvpVRU will be assumed.
[]
On Unified ICME, ICM Configuration Manager, PG Explorer tool: 1. Configure each PG.
For each Unified CVP ICM Service connected to this PG, in the tree view pane, select the applicable PG. Logical Controller tab:
2. Configure a peripheral for each Unified Client Type: VRU. CVP ICM Service connected to each Name: A name descriptive of this PG, for example, PG. <location>_A for side A of a particular location. Peripheral tab: Peripheral Name: A name descriptive of this Unified CVP peripheral, for example, <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. Advanced tab: Select the name cvpVRU from the Network VRU field drop-down list. Routing Client tab: Name: By convention, use the same name as the peripheral. Client Type: VRU. [] On Unified ICME, ICM Configuration Manager, Service Explorer tool: Specify the following:
Service Name: cvpVRU. 1. Configure a Service and Route for each Route Name: PeripheralName_cvpVRU. VRU.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
123
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
Note: You can also use service arrays. Refer Peripheral Number: 2 (must match the "Pre-routed Call to the Unified ICME documentation set for Service ID" in the Call Server configuration on the ICM tab more information. in the Operations Console). Note: This number Select the Enable Post-routing checkbox. [] On Unified ICME, ICM Configuration For Step 1, specify the following: Manager, Network Trunk Group Explorer Network Trunk Group Name: A name descriptive of this tool: trunk group. 1. Configure the network trunk group. 2. For each Unified CVP ICM Service for For Step 2, specify the following: the VRU leg, configure an associated Peripheral Name: A name descriptive of this trunk group. trunk group. Note: You must configure one Network Transfer Group and one associated Trunk Group for each VRU leg Unified CVP ICM Trunk Count: Select Use Trunk Data from the drop-down Service. list. Do not configure any trunks. [] On Unified ICME, ICM Configuration For Step 1, specify the following: Manager, Translation Route Explorer tool: Translation Route tab: 1. Define a Translation Route for each Set the Name field to the name of the target VRU VRU Peripheral. peripheral. (This is by convention; this value must be 2. Configure translation route and label unique in the enterprise.) information for each VRU peripheral. Set the Type field to DNIS and select the Service defined in the previous step. For Step 2, do the following: Route tab: Set the Name. By convention, this is the name of the target VRU peripheral, followed by the DNIS that this route will use, for example, MyVRU_2000. (This is by convention; this value must be unique in the enterprise.) Peripheral Number: 200 (must match the "Pre-routed Call Trunk Group ID" in the Call Server configuration on the ICM tab in the Operations Console).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
124
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
Service Name drop-down: Select PeripheralName.cvpVRU. Peripheral Target tab: Enter the first DNIS that will be seen by the VRU that you will be using for this translation route. Note: The DNIS pool used for each VRU peripheral must be unique. Select a Network Trunk Group which belongs to the target VRU from the drop-down list. Label tab: Set the Label: Enter the translation route label (which might or might not be the same DNIS you entered on the Peripheral Target tab). Type: Normal. Routing Client: Select the NIC Routing Client. You must create an additional label for each NIC routing client. Note: Repeat the Route and corresponding Peripheral Target and Label information for each DNIS in the pool. [] On Unified ICME, ICM Script Editor tool: Use the ICM Script Editors TranslationRouteToVRU node to connect the call to the Network VRU. 1. Create the VRU scripts and routing scripts to be used for IVR treatment and agent transfer, as described in other sections of this manual and in the ICM manuals. The VRU scripts are associated with the applicable Network VRU (for example, cvpVRU). On Unified ICME, ICM Configuration Manager: 1. Configure the ECC variables. [] On Unified ICME, ICM Configuration Manager: For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. For more information, see the "Common Unified ICMH Configuration: Define Unified CVP ECC Variables (page 155)" section.
[]
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
125
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
1. Configure dialed numbers and call types. [] On Unified CM: 1. Configure Unified CM. [] In the Operations Console, install and configure the Call Server(s): 1. Enable the ICM and IVR Services on the Call Server. In the Operations Console, select Device Management > CVP Call Server: 1. Select the ICM and IVR checkboxes. For detailed information, refer to the Operations Console online help. [] In the Operations Console on the ICM tab, on In the Operations Console, select Device Management > CVP each Unified CVP Call Server, configure the Call Server > ICM tab: ICM Service by specifying the following 1. Set the VRU Connection Port to match the VRU required information: connection Port defined in ICM Setup for the 1. VRU connection port number. corresponding VRU peripheral gateway (PIM). 2. Maximum Length of DNIS. 3. Call service IDs: New Call and Pre-routed. 4. Trunk group IDs: New Call and Pre-routed. 5. Dialed numbers used in the translation route. 6. Check other settings. 2. Set the maximum length DNIS to a number which is at least the length of the translation route DNIS numbers. Example: if the Gateway dial pattern is1800******, the maximum DNIS length is 10. 3. Enter the new and pre-routed call service IDs. Configure the ports for both groups according to the licenses purchased, call profiles, and capacity by completing the required fields on this tab 4. Enter the new and pre-routed call trunk group IDs. Configure the group number for the Pre-routed Call Trunk group. The group number must match the trunk group number in the Network Trunk group used for the translation route. Configure the number of ports according to the licenses purchased and capacity. Configure each of the numbers used for translation routes. (The New Call group is not used since the calls are being sent to the VRU (Unified CVP) after some initial processing by the NIC/Unified ICME.) 5. Add the dialed numbers in the DNIS field. 6. Check the default values and change, if desired. For more information, refer to the Unified CM user documentation.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
126
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
Refer to the Operations Console online help for information about other settings you might want to adjust from the default values. [] In the Operations Console: 1. Configure the IVR Service. 1. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values. [] In the Operations Console, configure the Reporting Server (optional): 1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server. In the Operations Console, select Device Management > CVP Reporting Server > General tab: 1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal. In the Operations Console, select Device Management > CVP Call Server > IVR tab:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
127
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Plays a .wav file that enables caller to hear message from critical_error.wav Logs errors on the gateway when the call fails
service timestamps debug datetime msec service timestamps log datetime msec service internal logging buffered 99999999 debugging no logging console ip cef no ip domain lookup ip host tts-en-us <IP of TTS or MRCP Server> ip host asr-en-us <IP of ASR or MRCP Server> voice rtp send-recv ! voice service voip allow-connections h323 to h323 signaling forward unconditional h323 sip min-se 360 rel1xx disable header-passing voice class codec 1 codec preference 1 g711ulaw codec preference 2 g729r8 voice translation-rule 1 rule 1 /987654/ // ! ! voice translation-profile block translate called 1 ! ! ivr prompt memory 15000 ivr prompt streamed none ivr asr-server rtsp://asr-en-us/recognizer ivr tts-server rtsp://tts-en-us/synthesizer mrcp client timeout connect 10 mrcp client timeout message 10 mrcp client rtpsetup enable rtsp client timeout connect 10 rtsp client timeout message 10 vxml tree memory 1000 http client cache memory pool 15000 http client cache memory file 500 http client cache refresh 864000
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
128
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
http client connection timeout 60 http client response timeout 30 gateway timer receive-rtcp 6 ! ip rtcp report interval 3000 application service new-call flash:bootstrap.vxml paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service cvperror flash:cvperror.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service handoff flash:handoff.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service bootstrap flash:bootstrap.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en VoiceXML Gateway Configuration: Example of Play Media (PM) Micro-Application Dial-peer
The following example provides the configuration for a PM micro-application dial-peer for the Type 8 Unified CVP VRU-Only call flow model:
dial-peer voice 987654 voip description Dial-peer needed for PM Micro-App translation-profile incoming block incoming called-number 987654 VoiceXML Gateway Configuration: Example of Dial-peer for ICM VRU Label
The following example provides the configuration for an ICM VRU label dial-peer for the Type 8 Unified CVP VRU-Only call flow model:
dial-peer voice 777 voip description ICM VRU label translation-profile incoming block service bootstrap voice-class codec 1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
129
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
incoming called-number <your sendtovru label pattern here> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
130
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Note: For simplicity, the figure does not illustrate a call flow model for redundancy and failover. Configuration overview for this call flow model: There are two Network VRUs configured: One on the NAM (Type 8). One on the CICM for the INCRP connection (Type 8). Use the ICM Script Editors TranslationRouteToVRU node to connect the call to the Network VRU. The following table contains the configuration instructions for this call flow model.
Table 13: Configuration Checklist, Type 8, Unified CVP VRU-Only Call Flow Model, Unified ICMH
Where to Go/What To Do
[]
Configure the VoiceXML Gateway used for Do the following: the VRU leg: For Step 1, in the Operations Console select Device 1. Transfer the following Unified CVP Management > Gateway > File Transfer > Scripts, then gateway scripts using the Unified CVP browse to the <cvp root>\Cisco\CVP\OpsConsoleServer Operations Console: \GWDownloads folder. bootstrap.tcl handoff.tcl survivabilty.tcl bootstrap.vxml recovery.vxml ringtone.tcl cvperror.tcl ringback.wav critical_error.wav For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings (page 136)" section. For Step 4, see the "VoiceXML Gateway Configuration: Example of Play Media (PM) Micro-Application Dial-peer (page 138)" and the "VoiceXML Gateway Configuration: Example of ICM VRU Label (page 138)" sections. Refer to the Operations Console online help for detailed instructions.
Note: Optionally, you can transfer the files from the Unified CVP product CD. 2. Configure the base gateway settings.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
131
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
3. Configure the service gateway settings. 4. Configure the dial-peers for the Play Media (PM) Micro-Application and the ICM VRU Label. [] On the NAM and CICM, ICM Configuration Specify the following: Manager, Network VRU Explorer tool: Type: 8. 1. Define a Network VRU. Name: cvpVRU. Note: This name is used by convention. Any name will do; since it is referenced elsewhere in this document, cvpVRU will be assumed. [] On the CICM, ICM Configuration Manager, For each Unified CVP ICM Service connected to this PG, in the PG Explorer tool: tree view pane, select the applicable PG. 1. Configure each PG. Logical Controller tab:
2. Configure a peripheral for each Unified Client Type: VRU. CVP ICM Service connected to each Name: A name descriptive of this PG, for example, PG. <location>_A for side A of a particular location. Peripheral tab: Peripheral Name: A name descriptive of this Unified CVP peripheral, for example, <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. Advanced tab: Select the name cvpVRU from the Network VRU field drop-down list. Routing Client tab: Name: By convention, use the same name as the peripheral.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
132
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
Client Type: VRU. [] On the CICM, ICM Configuration Manager, Specify the following: Service Explorer tool: Service Name: cvpVRU. 1. Configure a Service and Route for each Route Name: PeripheralName_cvpVRU. VRU. Peripheral Number: 2 (must match the "Pre-routed Call Note: You can also use service arrays. Refer Service ID" in the Call Server configuration on the ICM tab in the Operations Console). to the Unified ICME documentation set for more information. Note: This number Select the Enable Post-routing checkbox. [] On the CICM, ICM Configuration Manager, For Step 1, specify the following: Network Trunk Group Explorer tool: Network Trunk Group Name: A name descriptive of this 1. Configure the network trunk group. trunk group. 2. For each Unified CVP ICM Service for the VRU leg, configure an associated For Step 2, specify the following: trunk group. Peripheral Name: A name descriptive of this trunk group. Peripheral Number: 200 (must match the "Pre-routed Call Note: You must configure one Network Trunk Group ID" in the Call Server configuration on the ICM Transfer Group and one associated Trunk tab in the Operations Console). Group for each VRU leg Unified CVP ICM Service. Trunk Count: Select Use Trunk Data from the drop-down list. Do not configure any trunks. [] On the CICM, ICM Configuration Manager, For Step 1, specify the following: Translation Route Explorer tool: Translation Route tab: 1. Define a Translation Route for each Set the Name field to the name of the target VRU VRU Peripheral. peripheral. (This is by convention; this value must be 2. Configure translation route and label unique in the enterprise.) information for each VRU peripheral. Set the Type field to DNIS and select the Service defined in the previous step.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
133
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
For Step 2, do the following: Route tab: Set the Name. By convention, this is the name of the target VRU peripheral, followed by the DNIS that this route will use, for example, MyVRU_2000. (This is by convention; this value must be unique in the enterprise.) Service Name drop-down: Select PeripheralName.cvpVRU. Peripheral Target tab: Enter the first DNIS that will be seen by the VRU that you will be using for this translation route. Note: The DNIS pool used for each VRU peripheral must be unique. Select a Network Trunk Group which belongs to the target VRU from the drop-down list. Label tab: Set the Label: Enter the translation route label (which might or might not be the same DNIS you entered on the Peripheral Target tab). Type: Normal. Routing Client: Select the NIC Routing Client. You must create an additional label for each NIC routing client. Note: Repeat the Route and corresponding Peripheral Target and Label information for each DNIS in the pool. [] On the CICM, ICM Script Editor tool: 1. Create the VRU scripts and routing scripts to be used for IVR treatment and agent transfer, as described in other sections of this manual and in the ICM manuals. The VRU scripts are associated with the applicable Network VRU (for example, cvpVRU). Use the ICM Script Editors TranslationRouteToVRU node to connect the call to the Network VRU.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
134
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
[]
On the NAM and CICM, ICM Configuration For more information, see the "Common Unified ICMH Manager: Configuration: Define Unified CVP ECC Variables (page 155)" section. 1. Configure the ECC variables. On the NAM and CICM, ICM Configuration For more information, refer to the ICM Configuration Guide Manager: for Cisco ICM Enterprise Edition. 1. Configure dialed numbers and call types.
[]
[]
[]
In the Operations Console, install and configure the Call Server(s): 1. Enable the ICM and IVR Services on the Call Server.
In the Operations Console, select Device Management > CVP Call Server: 1. Select the ICM and IVR checkboxes. For detailed information, refer to the Operations Console online help.
[]
In the Operations Console on the ICM tab, In the Operations Console, select Device Management > CVP on each Unified CVP Call Server, configure Call Server > ICM tab: the ICM Service by specifying the following 1. Set the VRU Connection Port to match the VRU required information: connection Port defined in ICM Setup for the 1. VRU connection port number. corresponding VRU peripheral gateway (PIM). 2. Maximum Length of DNIS. 3. Call service IDs: New Call and Pre-routed. 4. Trunk group IDs: New Call and Pre-routed. 5. Dialed numbers used in the translation route. 6. Check other settings. 2. Set the maximum length DNIS to the length of the translation route DNIS numbers. Example: if the Gateway dial pattern is1800******, the maximum DNIS length is 10. 3. Enter the new and pre-routed call service IDs. Configure the ports for both groups according to the licenses purchased, call profiles, and capacity by completing the required fields on this tab 4. Enter the new and pre-routed call trunk group IDs. Configure the group number for the Pre-routed Call Trunk group. The group number must match the trunk group number in the Network Trunk group used for the translation route. Configure the number of ports according to the licenses purchased and capacity. Configure each of the
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
135
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What To Do
numbers used for translation routes. (The New Call group is not used since the calls are being sent to the VRU (Unified CVP) after some initial processing by the NIC/Unified ICME.) 5. Add the dialed numbers in the DNIS field. 6. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values. [] In the Operations Console: 1. Configure the IVR Service. 1. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values. [] In the Operations Console, configure the Reporting Server (optional): 1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server. In the Operations Console, select Device Management > CVP Reporting Server > General tab: 1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal. In the Operations Console, select Device Management > CVP Call Server > IVR tab:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
136
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Configures ASR/TTS Server Configures gateway settings The last part of this example provides the following: Initiates the VoiceXML leg Plays a .wav file that enables caller to hear message from critical_error.wav Logs errors on the gateway when the call fails
service timestamps debug datetime msec service timestamps log datetime msec service internal logging buffered 99999999 debugging no logging console ip cef no ip domain lookup ip host tts-en-us <IP of TTS or MRCP Server> ip host asr-en-us <IP of ASR or MRCP Server> voice rtp send-recv ! voice service voip allow-connections h323 to h323 signaling forward unconditional h323 sip min-se 360 rel1xx disable header-passing voice class codec 1 codec preference 1 g711ulaw codec preference 2 g729r8 voice translation-rule 1 rule 1 /987654/ // ! ! voice translation-profile block translate called 1 ! ! ivr prompt memory 15000 ivr prompt streamed none ivr asr-server rtsp://asr-en-us/recognizer ivr tts-server rtsp://tts-en-us/synthesizer mrcp client timeout connect 10
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
137
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
mrcp client timeout message 10 mrcp client rtpsetup enable rtsp client timeout connect 10 rtsp client timeout message 10 vxml tree memory 1000 http client cache memory pool 15000 http client cache memory file 500 http client cache refresh 864000 http client connection timeout 60 http client response timeout 30 gateway timer receive-rtcp 6 ! ip rtcp report interval 3000 application service new-call flash:bootstrap.vxml paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service cvperror flash:cvperror.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service handoff flash:handoff.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service bootstrap flash:bootstrap.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en VoiceXML Gateway Configuration: Example of Play Media (PM) Micro-Application Dial-peer
The following example provides the configuration for a PM micro-application dial-peer for the Type 8 Unified CVP VRU-Only call flow model:
dial-peer voice 987654 voip description Dial-peer needed for PM Micro-App translation-profile incoming block incoming called-number 987654 VoiceXML Gateway Configuration: Example of Dial-peer for ICM VRU Label
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
138
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
The following example provides the configuration for an ICM VRU label dial-peer for the Type 8 Unified CVP VRU-Only call flow model:
dial-peer voice 777 voip description ICM VRU label translation-profile incoming block service bootstrap voice-class codec 1 incoming called-number <your sendtovru label pattern here> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
Type 3 or 7 Unified CVP VRU-Only Call Flow Model Network VRU, Unified ICMH
In this call flow model, Unified CVP is deployed as a Network VRU at the NAM. The Unified CVP IVR Service in the Operations Console works with the Voice Gateway to act as the VRU; VRU voice treatment is provided at the Voice Gateway and can include ASR/TTS. (This call flow model is used when Unified CVP is connected to the NAM.) The NIC interfaces to the TDM switch to transfer calls to Unified CVP for VRU treatment and to queue and transfer calls using a VRU Type 3 or 7 call flow. Note: Use this call flow model only if the PSTN to which the NIC is connected can transport a Correlation ID when it transfers a call. If this is not the setup you are using, then use the VRU-Only Type 8 Unified ICMH call flow model (page 130) instead. Neither the Unified CVP H.323 Service nor the Unified CVP SIP Service are part of this call flow model. The following figure shows the call flow for this call flow model model. Note: In the following diagram, solid lines indicate voice paths and dashed lines indicate signaling paths. For simplicity, the figure does not illustrate a call flow model for redundancy and failover.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
139
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Note: The numbers in the figure indicate call flow progression. Configuration overview for this call flow model: Set the Network VRU Type to 3 or 7. There is no difference between these two types except that Type 7 causes Unified ICME to explicitly inform Unified CVP when it is about to transfer the call away from Unified CVP. (Most customers use Type 7.) The Network VRU names (where applicable), correlation IDs, and the ECC variable configurations must be identical on the NAM and CICM. All Labels must also be duplicated, but their routing clients will be different. Use the CICM Script Editors SendToVRU node to connect the call to the Network VRU. The following table contains the configuration instructions for this call flow model.
Table 14: Configuration Checklist, Type 3 or 7, Unified CVP VRU-Only Call Flow Model Network VRU, Unified ICMH
Where to Go/What to Do
[]
Configure the VoiceXML Gateway used for the VRU Do the following: leg: For Step 1, in the Operations Console select Device 1. Transfer the following Unified CVP gateway Management > Gateway > File Transfer > Scripts, scripts using the Unified CVP Operations then browse to the <cvp Console: root>\Cisco\CVP\OpsConsoleServer \GWDownloads folder. bootstrap.tcl Refer to the Operations Console online help for handoff.tcl detailed instructions. survivabilty.tcl bootstrap.vxml recovery.vxml ringtone.tcl For Steps 2 and 3, see the "VoiceXML Gateway Configuration: Example Gateway Settings (page 145)" section. For Step 4, see the "VoiceXML Gateway Configuration: Example of Play Media (PM)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
140
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What to Do
Micro-Application Dial-peer (page 147)" and the "VoiceXML Gateway Configuration: Example of ICM VRU Label (page 147)" sections.
Note: Optionally, you can transfer the files from the Unified CVP product CD. 2. Configure the base gateway settings. 3. Configure the service gateway settings. 4. Configure the dial-peers for the Play Media (PM) Micro-Application and the ICM VRU Label. [] On the NAM, ICM Configuration Manager, PG Explorer tool: 1. Configure each PG to be used for the VRU Client leg. For each Unified CVP ICM Service connected to this PG, in the tree view pane, select the applicable PG. Logical Controller tab:
Client Type: VRU. 2. Configure a peripheral for each Unified CVP ICM Service to be used as a VRU leg connected Name: A name descriptive of this PG, for example, <location>_A for side A of a particular location. to each PG. Peripheral tab: Peripheral Name: A name descriptive of this VRU peripheral, for example, <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. Routing Client tab: Name: By convention, use the same name as the peripheral. Client Type: VRU.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
141
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What to Do
[]
On the CICM, ICM Configuration Manager, Network VRU Explorer tool: 1. Define a Network VRU for the VRU leg and labels for reaching the NAM.
Specify the following: Type: 3 or 7. Name: cvpVRU. Note: This name is used by convention. Any name will do; since it is referenced elsewhere in this document, cvpVRU will be assumed. Define a Label for the NAM. Label: Network routing number. Type: Normal. Routing client: Select the INCRP Routing Client from the drop-down list.
[]
On the NAM, ICM Configuration Manager, Network Specify the following: VRU Explorer tool: Type: 3 or 7. 1. Define a Network VRU and a label for each NIC Name: cvpVRU. that is using this VRU. Note: This name is used by convention. Any name will do; since it is referenced elsewhere in this document, cvpVRU will be assumed. Define a Label for each NIC that is using this VRU: Label: Network routing number. Type: Normal. Routing client: Select the Routing Client for that NIC from the drop-down list. Note: Make sure the Network VRU label is identical in the NAM and CICM. The Network VRU Name must be identical as well to avoid confusion.
[]
On the NAM, ICM Configuration Manager, System In the General section of the System Information tool: Information tool: Define the Default Network VRU: cvpVRU. 1. If there will be Routing Scripts on the NAM, define a default Network VRU.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
142
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What to Do
[]
On the CICM, ICM Configuration Manager, System In the General section of the System Information tool: Information tool: Define the Default Network VRU: cvpVRU. 1. Define a default Network VRU. On the CICM, ICM Script Editor tool: Use the ICM Script Editors SendToVRU node to connect the call to the Network VRU.
[]
1. Create the VRU scripts and routing scripts to be used for IVR treatment and agent transfer, Note: A RunVRU Script or Queue node is an implicit as described in other sections of this manual and SendToVRU node, although error handling will be easier in the Unified ICME manuals. The VRU scripts if the explicit SendToVRU node is used. are associated with the applicable Network VRU, that is, cvpVRU. [] On the NAM and CICM, ICM Configuration Manager: 1. Configure the ECC variables. [] On the NAM and CICM, ICM Configuration Manager: 1. Configure dialed numbers and call types. [] On the NAM and CICM, ICM Configuration Manager: 1. If necessary, differentiate VRUs (Unified CVPs) based on dialed number. 2. Define customers and their Network VRU. [] On Cisco Unified CM: 1. Configure Unified CM. [] In the Operations Console, install and configure the In the Operations Console, select Device Management Call Server(s): > CVP Call Server: 1. Enable the ICM and IVR Services on the Call Server. 1. Select the ICM and IVR checkboxes. For detailed information, refer to the Operations Console online help. For more information, refer to the Unified CM user documentation. For more information, see the "Common Configuration for Differentiating VRUs (Unified CVPs) Based on Dialed Number (page 160)" section. For more information, refer to the ICM Configuration Guide for Cisco ICM Enterprise Edition. For more information, see the "Common Unified ICMH Configuration: Define Unified CVP ECC Variables (page 155)" section.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
143
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What to Do
[]
In the Operations Console on the ICM tab, on each In the Operations Console, select Device Management Unified CVP Call Server, configure the ICM Service > CVP Call Server > ICM tab: by specifying the following required information: 1. Set the VRU Connection Port to match the VRU 1. VRU connection port number. connection Port defined in ICM Setup for the corresponding VRU peripheral gateway (PIM). 2. Maximum Length of DNIS. 2. Set the maximum length DNIS to the length of the 3. Call service IDs: New Call and Pre-routed. Network Routing Number. 4. Trunk group IDs: New Call and Pre-routed. 5. Check other settings. 3. Enter the new and pre-routed call service IDs. Configure the ports for both groups according to the licenses purchased, call profiles, and capacity by completing the required fields on this tab 4. Enter the new and pre-routed call trunk group IDs. Configure the group number for the Pre-routed Call Trunk group. The group number must match the trunk group number in the Network Trunk group used for the translation route. Configure the number of ports according to the licenses purchased and capacity. Configure each of the numbers used for translation routes. (The New Call group is not used since the calls are being sent to the VRU (Unified CVP) after some initial processing by the NIC/Unified ICME.) 5. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values. Example: if the Gateway dial pattern is1800******, the maximum DNIS length is 10.
[]
In the Operations Console, select Device Management > CVP Call Server > IVR tab: 1. Check the default values and change, if desired. Refer to the Operations Console online help for information about other settings you might want to adjust from the default values.
[]
In the Operations Console, configure the Reporting In the Operations Console, select Device Management Server (optional): > CVP Reporting Server > General tab:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
144
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
Where to Go/What to Do
1. Configure the Reporting Server. 2. Associate the Reporting Server with a Call Server.
1. Configure the Reporting Server. 2. Select a Call Server to associate with this Reporting Server. 3. Check the default values of the Reporting properties and change, if desired. For more information, refer to the Reporting Guide for Cisco Unified Customer Voice Portal.
service timestamps debug datetime msec service timestamps log datetime msec service internal logging buffered 99999999 debugging no logging console ip cef no ip domain lookup ip host tts-en-us <IP of TTS or MRCP Server> ip host asr-en-us <IP of ASR or MRCP Server> voice rtp send-recv
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
145
Chapter 2: Configuration Overview Unified CVP VRU Call Flow Models with NIC Routing
! voice service voip allow-connections h323 to h323 signaling forward unconditional h323 sip min-se 360 rel1xx disable header-passing voice class codec 1 codec preference 1 g711ulaw codec preference 2 g729r8 voice translation-rule 1 rule 1 /987654/ // ! ! voice translation-profile block translate called 1 ! ! ivr prompt memory 15000 ivr prompt streamed none ivr asr-server rtsp://asr-en-us/recognizer ivr tts-server rtsp://tts-en-us/synthesizer mrcp client timeout connect 10 mrcp client timeout message 10 mrcp client rtpsetup enable rtsp client timeout connect 10 rtsp client timeout message 10 vxml tree memory 1000 http client cache memory pool 15000 http client cache memory file 500 http client cache refresh 864000 http client connection timeout 60 http client response timeout 30 gateway timer receive-rtcp 6 ! ip rtcp report interval 3000 application service new-call flash:bootstrap.vxml paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service cvperror flash:cvperror.tcl paramspace english index 0
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
146
Chapter 2: Configuration Overview Unified CVP Comprehensive Call Flows for Pre-Routed Calls
paramspace english language en paramspace english location flash paramspace english prefix en service handoff flash:handoff.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en service bootstrap flash:bootstrap.tcl paramspace english index 0 paramspace english language en paramspace english location flash paramspace english prefix en VoiceXML Gateway Configuration: Example of Play Media (PM) Micro-Application Dial-peer
The following example provides the configuration for a PM micro-application dial-peer for the Type 3 or 7 Unified CVP VRU-Only call flow model:
dial-peer voice 987654 voip description Dial-peer needed for PM Micro-App translation-profile incoming block incoming called-number 987654 VoiceXML Gateway Configuration: Example of Dial-peer for ICM VRU Label
The following example provides the configuration for an ICM VRU label dial-peer for the Type 3 or 7 Unified CVP VRU-Only call flow model:
dial-peer voice 777 voip description ICM VRU label translation-profile incoming block service bootstrap voice-class codec 1 incoming called-number <your sendtovru label pattern here> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
147
Chapter 2: Configuration Overview Unified CVP Comprehensive Call Flows for Pre-Routed Calls
In this section we will discuss the following call flows: Calls which arrive at Unified ICME through a pre-route-only NIC (page 148) Calls which are pre-routed through a GKTMP NIC (not applicable for SIP deployments) (page 150) Calls which are originated by Cisco Unified Communications Manager (page 150) Calls which are originated by an ACD or Call Routing Interface (CRI) based VRU using a Peripheral Gateway (PG) (page 152). A VXML Server running as a Standalone with ICME Lookup call flow model also falls into this category, if the goal of the ICM Lookup is to transfer the call into a Unified CVP Comprehensive call flow model deployment. All these call flows share the characteristic that the original routing client (a NIC, Unified CM, an ACD, or a VRU) is capable of a single route request only. By definition, the routing client makes a single request to Unified ICME, and Unified ICME returns a destination label and the routing client affects the transfer. At that point the route request dialog is ended, and Unified ICME has no ability to send a subsequent label or conduct any other form of third-party call control. The routing script might continue, however. This would be the case if the returned label was a translation route to VRU label, or if it was a correlation ID label resulting from a SendToVRU node. In those cases the call is transferred to Unified CVP, and the routing script continues executing once Unified CVP successfully receives the call. The script then invokes micro-application requests as part of its queuing or self service treatment. If the call will then be transferred to an agent or skill group, that label must go to Unified CVP rather than to the original routing client. If the call will later be blind-transferred to another agent or skill group, or back into Unified CVP for additional queuing or self service, that label too must go to Unified CVP rather than to the original routing client. When the call is delivered to Unified CVP, in order for micro-applications to be supported, it must establish both the Switch and the VRU leg. In short, it must enter a normal Unified CVP Comprehensive call flow model. The only difference between the pre-routed case and a normal Unified CVP Comprehensive call flow model case is in how the call first arrives at Unified CVP. In the pre-routed case, it arrives using either a translation route or correlation-id transfer, whereas in the more typical case it arrives as a new call from the PSTN. In either case, a subsequent transfer to Unified CVP's VRU leg is required. The following sections describe the important configuration points for each of the above call flows.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
148
Chapter 2: Configuration Overview Unified CVP Comprehensive Call Flows for Pre-Routed Calls
1. Configure a single Type 10 Network VRU and associate it with all Unified CVP peripherals in the PG Explorer configuration tool, and also define it as the default system Network VRU in the System Information tool. 2. In order to support the initial call transfer to Unified CVP from the pre-route routing client, configure Translation Route labels to target the Unified CVP peripherals. 3. In order to support the transfer to VRU leg, configure the Type 10 Network VRU that you defined above in Step 1 with Network Routing Number labels for each Unified CVP peripheral routing client. 4. Associate all micro-application VRU scripts with that same Type 10 Network VRU. When the routing script transfers the call into Unified CVP, it must use a TranslationRouteToVRU node. No subsequent node is necessary in order to perform the transfer to Unified CVP's VRU leg; this will take place automatically. Note: Non-prerouted calls can also share the same Network VRU and the same Unified CVP Call Servers. ForUnified ICME Release 7.0, do the following: 1. Configure two Network VRUs: one Type 2 and one Type 7. 2. In the PG Explorer tool, assign all Unified CVP Call Servers to the Type 2 Network VRU. 3. Configure one set of Translation Route labels to target the Type 2 Call Servers; these will be used to transfer the call from the original routing client to the Unified CVP Switch leg. 4. Assign a label to the Type 7 Network VRU for each Unified CVP Call Server routing client, whose label string is set to the Network Routing Number. 5. Configure the Type 7 Network VRU as the system default Network VRU in the System Information configuration tool. 6. Associate all micro-application VRU scripts with the Type 7 Network VRU. 7. When the routing script transfers the call into Unified CVP, it must use two nodes in succession: first, a TranslationRouteToVRU, and then an explicit SendToVRU node. The first node transfers the call from the initial routing client to one of the Type 2 Call Servers (Unified CVP Switch leg); the second one transfers the call from the Type 2 Call Server to the Unified CVP VRU leg. (The VRU leg will usually end up running through the same Unified CVP Call Server as the Switch leg.) Note: Non-prerouted calls can also share the same Type 2 Call Servers and Type 2 and Type 7 Network VRUs; however, note that the scripts which handle non-prerouted calls must also use an explicit SendToVRU node before they can execute any micro-applications.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
149
Chapter 2: Configuration Overview Unified CVP Comprehensive Call Flows for Pre-Routed Calls
Calls Which are Pre-Routed Through a GKTMP NIC (Not Applicable for SIP Deployments)
This call flow is actually a special case of those calls which arrive at Unified ICME through a pre-route-only NIC, since GKTMP does in fact fall into that category. However, it differs in that when the call arrives there, it is already in the H.323 realm. In fact, it is an H.323 Gatekeeper which issues the GKTMP request. The GKTMP routing script returns not only a translation route to VRU label, but also the IP address of the specific Unified CVP Call Server which represents the Unified CVP Switch leg for that call. (The IP address is returned in an ECC variable.) Therefore, the GKTMP pre-route can be used to perform a kind of custom-scripted load balancing across Unified CVP Call Servers. Note: This call flow applies to both Unified ICME and Unified ICMH implementations. In the latter case, both Unified CVP and the NIC would be deployed at the NAM.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
150
Chapter 2: Configuration Overview Unified CVP Comprehensive Call Flows for Pre-Routed Calls
2. Configure the Type 10 Network VRU with two sets of labels. Associate the first set with the Unified CM routing client, which contains a label that Unified CM uses to transfer the call to Unified CVP. Configure Unified CM with a series of route patterns, which include that label followed by one to five arbitrary digits. For example, if the selected label is 1111, then the following route patterns are needed: 1111X, 1111XX, 1111XXX, 1111XXXX, and 1111XXXXX. The second set of Network VRU labels must contain the usual Comprehensive Model "Network Routing Number," which must be associated with each Unified CVP Call Server routing client. 3. Associate all micro-application VRU scripts with that same Type 10 Network VRU. 4. When the routing script transfers the call into Unified CVP, it should use a single SendToVRU node. No subsequent node is necessary in order to perform the transfer to Unified CVP's VRU leg; this will take place automatically. (The SendToVRU node can be omitted since any micro-application script node will invoke the same functionality automatically; however, you can include this node explicitly in the script for troubleshooting purposes.) Note: Non-prerouted calls can also share the same Network VRU and the same Unified CVP Call Servers as those calls which are transferred from Unified CM; however, note that the scripts which handle non-prerouted calls must also use an explicit SendToVRU node before they can execute any micro-applications. For Unified ICME Release 7.0, do the following: 1. Configure two Network VRUs: one Type 2 and one Type 7. 2. In the PG Explorer tool, assign the Unified CVP Call Servers to the Type 2 Network VRU. 3. Configure one set of Translation Route labels to target the Type 2 Call Servers; these will be used to transfer the call from the original routing client to the Unified CVP Switch leg. 4. Assign a label to the Type 7 Network VRU for each Unified CVP Call Server routing client, whose label string is set to the Network Routing Number. 5. Configure the Type 7 Network VRU as the system default Network VRU in the System Information configuration tool. 6. Associate all micro-application VRU scripts with the Type 7 Network VRU. 7. When the routing script to transfers the call into Unified CVP, it should use two nodes in succession: first, a TranslationRouteToVRU, and then an explicit SendToVRU node (which contrary to the Unified ICME 7.1 case, is not optional). The first node transfers the call from the initial routing client to one of the Type 2 Call Servers (Unified CVP Switch leg); the second one transfers the call from the Type 2 Call Server to the Unified CVP VRU leg. (The VRU leg will usually end up running through the same Unified CVP Call Server as the Switch leg.) Note: Non-prerouted calls can also share the same Type 2 Call Servers and Type 2 and Type 7 Network VRUs.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
151
Chapter 2: Configuration Overview Unified CVP Comprehensive Call Flows for Pre-Routed Calls
Calls Which are Originated By an ACD or Call Routing Interface (CRI) Based VRU Using a Peripheral Gateway (PG)
These calls are very similar to those which arrive from a preroute-only NIC, except that the routing client is connected to Unified ICME using a PG rather than using a NIC. Therefore, if this call flow is used in a Unified ICMH environment, the target Unified CVP Call Servers are required to be connected to the same CICM as the ACD or CRI-based VRU from which the call originates. Just as multiple CICMs will require multiple ACD or VRU peripherals, so will they require multiple Unified CVP Call Servers. Further configuration points differ depending on whether Unified CVP is being deployed with Unified ICME Release 7.0 or 7.1. For Unified ICME Release 7.1 and later, do the following: 1. Configure a single Type 10 Network VRU and associate it with all Unified CVP peripherals in the PG Explorer configuration tool, and also define it as the default system Network VRU in the System Information tool. 2. In order to support the initial call transfer to Unified CVP from the pre-route routing client, configure Translation Route labels to target the Unified CVP peripherals. 3. In order to support the transfer to VRU leg, configure the Type 10 Network VRU with Network Routing Number labels for each Unified CVP peripheral routing client. 4. Associate all micro-application VRU scripts with that same Type 10 Network VRU. 5. When the routing script transfers the call into Unified CVP, it must use a TranslationRouteToVRU node. No subsequent node is necessary in order to perform the transfer to Unified CVP's VRU leg; this will take place automatically. Note: Non-prerouted calls can also share the same Network VRU and the same Unified CVP Call Servers. For Unified ICME Release 7.0, do the following: 1. Configure two Network VRUs: one Type 2 and one Type 7. 2. In the PG Explorer tool, assign all Unified CVP Call Servers to the Type 2 Network VRU. 3. Configure one set of Translation Route labels to target the Type 2 Call Servers; these will be used to transfer the call from the original routing client to the Unified CVP Switch leg. 4. Assign a label to the Type 7 Network VRU for each Unified CVP Call Server routing client, whose label string is set to the Network Routing Number. 5. Configure the Type 7 Network VRU as the system default Network VRU in the System Information configuration tool. 6. Associate all micro-application VRU scripts with the Type 2 Network VRU.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
152
Chapter 2: Configuration Overview Common Unified ICMH Configuration for Unified CVP Switch Leg
7. When the routing script transfers the call into Unified CVP, it should use two nodes in succession: first, a TranslationRouteToVRU, and then an explicit SendToVRU node. The first node transfers the call from the initial routing client to one of the Type 2 Call Servers (Unified CVP Switch leg); the second one transfers the call from the Type 2 Call Server to the Unified CVP VRU leg. (The VRU leg will usually end up running through the same Unified CVP Call Server as the Switch leg.) Note: Non-prerouted calls can also share the same Type 2 Call Servers and Type 2 and Type 7 Network VRUs.
Where to Go/What to Do
[]
On the NAM, ICM Configuration Manager, Network VRU Explorer tool: 1. Define a Network VRU for Unified CVP.
2. Assign labels. Note: This name is used by convention. Any name will do; since it is referenced elsewhere in this document, cvpVRU will be assumed. Define one Label per Unified CVP or NIC routing client: Type: Normal. Label: Network Routing Number. [] On the CICM, ICM Configuration Manager, NIC Specify the following on the Routing Client tab for the Explorer tool: INCRP NIC: 1. Set the client type for the INCRP NIC. [] On the CICM, ICM Configuration Manager, Network VRU Explorer tool: Client Type: VRU. Specify the following:
Type: 10 1. Define a Network VRU with a label that uses Name: cvpVRU INCRP as its routing client.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
153
Chapter 2: Configuration Overview Common Unified ICMH Configuration for Unified CVP Switch Leg
Where to Go/What to Do
Note: This name is used by convention. Any name will do; since it is referenced elsewhere in this document, cvpVRU will be assumed. Define one Label for the NAM routing client: Label: Network Routing Number. . Type: Normal. Routing client: INCRP NIC. [] On the NAM, ICM Configuration Manager, PG Explorer tool: For each Unified CVP ICM Service connected to this PG, in the tree view pane, select the applicable PG.
1. Configure each PG to be used for the Switch Logical Controller tab: leg. Client Type: VRU. 2. Configure a peripheral for each ICM Service to be used for a Switch leg connected to each Name: A name descriptive of this PG, for example, <location>_A, for side A of a particular location. PG. Peripheral tab: Peripheral Name: A name descriptive of this Unified CVP peripheral, for example, <location>_<cvp1> or <dns_name>. Client Type: VRU. Select the Enable Post-routing checkbox. On the Advanced tab, select the name cvpVRU from the Network VRU field drop-down list. Routing Client tab: Name: By convention, use the same name as the peripheral. Client Type: VRU. Do not select the Network Transfer Preferred checkbox.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
154
Chapter 2: Configuration Overview Common Unified ICMH Configuration for Unified CVP Switch Leg
Within the ICM Configuration Manager, select Tools > Miscellaneous Tools > System Information and select the Enable expanded call context checkbox. Within the ICM Configuration Manager, select Tools > List Tools > Expanded Call Variable List. In the Expanded Call Variable List window, enable the Add button by clicking Retrieve. Click Add. The Attributes property tab is enabled. Create each of the variables in the following table, clicking Save after defining each variable. Note: Any time you change the configuration of any ECC variable with the Expanded Call Variable List tool, you must stop and restart the Unified CVP ICM Services. Caution: It is important that you enter the ECC's Name values listed in following table exactly as specified. If you do not, the Unified ICMH software will not be able to successfully communicate with the micro-applications on the ICM Service. Caution: Length values are a bit more flexible. Unless the values listed in following table are specifically noted as "required," the value in the Length column is the maximum that Unified ICMH can handle for that ECC; you can specify a value between 1 and the maximum length. Note: In a Unified ICMH configuration, the ECC variable configuration, including the length, defined in the NAM must be defined exactly the same in the CICM. If you change the length of the ECC variables while the Unified CVP ICM Service is running, you need to restart the Unified CVP ICM Service for it to work properly.
Step 2
Step 6
Name
Length
Definition
user.media.id
Required value: 36
A number identifying a call to the ICM Service and, optionally, the H.323 Service: For a call arriving from the network, consists of an H.323 Conference ID.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
155
Chapter 2: Configuration Overview Common Unified ICMH Configuration for Unified CVP Switch Leg
Name
Length
Definition
For a call arriving from a non-H.323 Service client, consists of a random number. user.microapp.currency user.microapp.error_code Required value: 6 Required value: 2 Currency type. Return status error code to be returned from the Unified CVP to Unified ICME upon a False return code in the Run Script Result. Locale, a combination of language and country which defines the grammar and prompt set to use. Root of the URL for all media files and external grammar files used in the script. HTTP and HTTPS schemes can be specified as: HTTP scheme is specified as "http://<servername>" HTTPS scheme is specified as "https://<servername>" user.microapp.play_data user.microapp.sys_media_lib 40 10 Default storage area for data for Play Data micro-application. Directory for all system media files, such as individual digits, months, default error messages, and so forth. Directory for all application-specific media files and grammar files. You can also set this value to .. (literally two periods in quotes), which bypasses the user.microapp.app_media_lib and user.microapp.locale ECC Variables when writing a URL path. For example, if you set the user.microapp.app_media_lib to .., the path:
http://server/locale/../hello.wav
user.microapp.locale
Required value: 5
user.microapp.media_server
user.microapp.app_media_lib
Note: The system and application media libraries need message and prompt files created/recorded for each locale that will be referenced. For more information, see Chapter 16, "Configuring the Media Servers (page 525)" in Part 3. user.microapp.grammar_choices Configurable on Unified Specifies the ASR choices that a caller can input ICME. Maximum length: for the Get Speech micro-application. Each 210 characters.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
156
Chapter 2: Configuration Overview Common Unified ICMH Configuration for Unified CVP Switch Leg
Name
Length
Definition
option in the list of choices is delimited by a forward slash (/). Note: If text is placed in this variable that is longer than the variable is configured to handle, only the first 210 characters are sent. user.microapp.inline_tts Configurable on the Specifies the text for inline Text To Speech ICM. Maximum length: (TTS). 210 characters. Note: If text is placed in this variable that is longer than the variable is configured to handle, only the first 210 characters are sent. Required value: 1 Specifies the type of input that is allowed. Valid contents are: D - DTMF B - (Both, the default) DTMF and Voice If you are not using an ASR, you need to set this variable to D. If you are using an ASR, you can set the variable to either D or B. Note: With input_mode set to "B" (both), either DTMF or speech will be accepted, but mixed mode input is not. Once you begin entering with one mode, input using the other mode is ignored and has no effect. user.microapp.caller_input Configurable on Unified Storage area for any ASR input that is collected ICME. Maximum length: from Get Speech. 210 characters. Note: Get Speech text results will be written to this ECC variable. Results from Get Digits or Menu micro-applications will be written to the CED. Required value: 1 Specifies whether Unified CVPs Text To Speech (TTS) or media files must be played to the caller. Valid contents are: Y - Yes, use TTS capabilities
user.microapp.input_type
user.microapp.pd_tts
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
157
Chapter 2: Configuration Overview Common Unified ICMH Configuration for Unified CVP Switch Leg
Name
Length
Definition
N - No, do not use TTS capabilities; play media files instead. Note: Used only with Play Data micro-application. user.microapp.UseVXMLParams Required value: 1 This parameter specifies the manner in which you pass information to the external VoiceXML. Set this parameter to either Y (for yes) or N (for no). Y uses the values in the user.microapp.ToExtVXML variable array. N appends the name/value pairs in user.microapp.ToExtVXML to the URL of the external VoiceXML. See Chapter 4, "Writing Scripts for Unified CVP (page 175)," for more information about micro-applications. user.microapp.ToExtVXML 210 This variable array sends information to the external VoiceXML file. Must be configured as Array variables, not Scalar variables, even if the array length is set to 1. See "Passing Information to the External VoiceXML (page 230)" in Chapter 4, "Writing Scripts for Unified CVP," for more information about micro-applications. user.microapp.FromExtVXML 210 This variable array returns information from the external VoiceXML file. Must be configured as Array variables, not Scalar variables, even if the array length is set to 1. See "Passing Data Back to Unified ICME with External VoiceXML (page 233)" in Chapter 4, "Writing Scripts for Unified CVP," for more information about micro-applications. user.microapp.override_cli Configurable on Unified Used by system to override the CLI field on ICME. Maximum length: outgoing transfers. 200 characters. The variable length would normally be configured as 62 bytes, but if ECC space is restricted, you can configure it as 21 bytes. Following the Menu (M), Get Data (GD) and Get Speech (GS) micro-applications, Unified CVP now returns information about the execution of that micro-application. The User.microapp.metadata ECC variable is structured as follows:
user.microapp.metadata
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
158
Name
Length
Definition m|con|tr|to|iv|duratn|vruscriptname
user.sip.refertransfer
SIP Service will use REFERs when transferring to the agents: y Use REFER when transferring n Do not use REFER when transferring
user.microapp.uui
Configurable on Unified Used to pass user-to-user information back to ICME. Maximum length: Unified CVP from Unified ICME. 131 characters.
Metadata
D, V or N Indicates whether the user responded with Voice (V), DTMF (D), or not at all (N). (Note that for the Menu micro-application, any successful single digit entry will result in m being set to V or D, even if the entry was an invalid menu selection.) 000 to 100 Indicates the ASR percent confidence level at which the voice input was finally recognized. This field is only valid if m is Voice (V). 00 to 99 Indicates how many tries were required. 01 means user responded successfully after the first prompt. 00 to 99 Indicates how many timeouts occurred. Does not include interdigit timeouts.
con
tr to
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
159
Chapter 2: Configuration Overview Common Configuration for Differentiating VRUs (Unified CVPs) Based on Dialed Number
Metadata
iv duratn
00 to 99 Indicates how many invalid entries were received, including interdigit timeouts. 000000 to 999999 Indicates the micro-application duration in milliseconds. Duration is defined as the elapsed time between entering and exiting the RunExternalScript node, as measured in the IVR Service. Full name of the VRU script which was executed. This is the only variable length field.
This ECC variable is optional. If used, you must define it in the Unified ICME Expanded Call Context Variables configuration tool. The variable length would normally be configured as 62 bytes, but if ECC space is restricted, you can configure it as 21 bytes. This will drop the vruscriptname subfield. If you do define this variable, its contents get written to the Unified ICME database with every termination record, and can be used to provide a record of meta-information about the execution of each input micro-application.
Common Configuration for Differentiating VRUs (Unified CVPs) Based on Dialed Number
The Network VRU configuration instructions in this guide assume that all callers will be routed to the same VRUs (Unified CVPs) for VRU treatment purposes. Under this assumption, it is always simplest to rely on the system default Network VRU. However, it is sometimes necessary to differentiate the VRUs (Unified CVPs) based on dialed number. Note: This section is only applicable to call flow models which use the SendToVRU node to transfer the call to Unified CVP's VRU leg (it does not apply to Translation Route transfers). For example, some calls: Require Comprehensive treatment, while others only use the H.323 with Media Termination call flow model which does not support ASR/TTS. Need to assign different customers or applications to their own Unified CVP machines. To configure Unified ICME to differentiate the VRUs, do the following: Configure more than one Network VRU. On Unified ICME, ICM Configuration Manager, ICM Instance Explorer tool: Configure the customer(s). Configure the Network VRU for each customer if that customer will use a Network VRU other than the default. Associate the dialed number(s) to the customer in the Dialed Number List tool.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
160
Since each configured VRU script is specific to one specified Network VRU, you need to create a distinct set of VRU scripts for each Network VRU. Also, be sure that the ICM routing script calls the correct set of VRU scripts.
Gatekeeper Redundancy
As of CVP 3.1 SR1, Hot Standby Router Protocol (HSRP) is no longer the only method of Gatekeeper redundancy. Instead, Gatekeeper Clustering and Alternate Gatekeeper configuration on Unified CVP is the preferred method of Gatekeeper redundancy.
interface ethernet 0 ip address 10.0.1.98 255.255.255.0 ! Unique IP address for this GK standby 1 ip 10.0.1.100 ! Member of standby group 1, sharing virtual address 10.0.1.100 standby 1 preempt ! Claim active role when it has higher priority. standby 1 priority 110 ! Priority is 110
On the backup gatekeeper, enter these commands:
interface ethernet 0 ip address 10.0.1.99 255.255.255.0 standby 1 ip 10.0.1.100 standby 1 preempt standby 1 priority 100
On both Gatekeepers, configure identical gatekeeper configurations, for example:
gatekeeper ! Enter gatekeeper configuration mode zone local gk-sj cisco.com 10.0.1.100 ! Define local zone using HSRP virtual address as gatekeeper RAS address
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
161
Chapter 2: Configuration Overview Local SRV File Configuration Example for SIP Messaging Redundancy
Example 1: set GK "10.0.1.100, 10.0.2.100, 10.0.3.100" This example sets up three gatekeepers, which could be registered to the H.323 Service. In each case, the H.323 Service registers to the first local zone that is configured in that gatekeeper. It also uses the default RAS port 1719. Example 2: setGK "10.0.1.100:zone1:1718, 10.0.2.100" This example causes the H.323 Service to first attempt to register to gatekeeper 10.86.129.33 on port 1718 with local zone "zone1". If that gatekeeper fails, the H.323 Service subsequently attempts to register to 10.86.129.34 on port 1719 with the first local zone defined on that gatekeeper. See Also Refer to the Operations Console online help for more information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
162
Chapter 3
Cisco Unified CVP Operations Console Overview
About the Unified CVP Operations Console
The Unified CVP Operations Console allows you to centrally operate, administer, maintain, and provision the Unified CVP solution. With its web-based approach, the Operations Console provides the capability to administer and monitor the Unified CVP components remotely. Note: The Operations Console is required for all the Unified CVP call flow models. You use the Unified CVP Operations Console to configure Unified CVP devices: CVP Call Server CVP Video Media Server CVP Reporting Server VXML Server VXML Server (Standalone) You can also use Unified CVP Operations Console to perform some device administration -for example, getting device statistics, downloading scripts to gateways and gatekeepers -- on non-Unified CVP devices, such as: IVP Server Gatekeeper Gateway Content Services Switch
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
163
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
Speech Server Media Server Unified CM ICM Server SIP Proxy Server Note: Before you can perform administrative tasks on non-Unified CVP devices, you must first configure them at the device and add them to the Operations Console. See Also See the chapters in Part 2: Configuration Detail of Unified CVP Components (page 271).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
164
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
Health Monitoring - You can use any SNMP-standard monitoring tool to get a detailed visual and tabular representation of the health of the solution network. All Unified CVP product components and most Unified CVP solution components also issue SNMP traps and statistics which can be delivered to any standard SNMP management station or monitoring tool. Direct administration of individual IOS-based components - Administrators can select an individual gateway, gatekeeper, or content services switch for direct administration using secure shell (ssh). Configurations which are modified in this way, or which are modified by directly accessing those components without using the Operations Server can be uploaded to the Operations Server backup and later use. You can perform the following tasks to get started with the Operations Console: Logging in to the Operations Console (page 165) Using the Cisco Unified Customer Voice Portal Page (page 166) Getting Acquainted with the Operations Console Menus (page 167) Where to Find More Information (page 171) Logging out from the Operations Console (page 172) Using the Control Center (page ?)
Procedure
To log in to the Operations Console:
Step 1
From the web browser, enter https://ServerIP:9443/oamp, where ServerIP is the IP address or hostname of the machine on which the Operations Console is installed. The main Cisco Unified Customer Voice Portal page displays.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
165
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
Step 2
Enter your user ID in the Username field. The first time you log in after installing Unified CVP software, enter Administrator, the default user account.
Step 3
In the Password field, enter your password. If you are logging in to the default Administrator account, enter the password that was set for this account during installation. If the user ID or password is invalid, the Operations server displays the message, "Invalid Username or password." Enter your user ID and password again and click OK. The main Cisco Unified Customer Voice Portal page displays.
Step 4
Default security settings can prevent users from using the Operations Console. Check your security policy and, if needed, change the settings to a less restrictive level.
See Also Logging Out From the Operations Console (page 172)
My Account
The My Account screen displays the settings for the account of the user who is currently logged in. From this screen you can perform the following tasks: Configuring General User Information (page ?) You can view the device pools and user groups to which you are assigned. For more information on changing these assignments, see the following topics: Assigning a User to a Device Pool (page ?) Assigning a User to a User Group (page ?)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
166
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
System
Control Center
View the status of the Cisco Unified Customer Voice Portal environment in a network control center. View the status and statistics by Device Type or Device Pools, logical groups of devices in the Cisco Unified Customer Voice Portal solution. Initiate Start, Shutdown, or Graceful Shutdown actions on devices in the control center. Create, modify, and delete device pool names and descriptions for logical groups of devices (for example, all devices located in a geographical region). Import a previously-saved Operations Console Server configuration file and apply it to the current system. Save and export all configuration information for the Operations Console Server to a single file on your local computer.
Device Pool
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
167
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
Menu
Options
Use To
You can later use this file to restore an Operations Console Server during disaster recovery. Location SIP Server Groups Web Services Add, edit, synchronize, and delete Unified CM location information. Configure server groups for SIP and view Call Server deployment status. Configure Diagnostic Portal servlet credentials.
Service Advertisement Framework Add, configure, and delete a SAF Forwarder. (SAF) Additional menu options provide you with the ability to provision a SAF Forwarder, and to find and add Hosted dialed number (DN) patterns. Realtime Database Identify the required reporting server(s) for which youwish to configure realtime database attributes and deploy them to the selected Call Servers. Configure Call Server general and infrastructure settings; specify call services settings for each deployment model; associate Call Servers with device pools, SIP Proxy Server, or IVP; apply licenses to a Call Server. Configure Reporting Server general and infrastructure settings; associate Reporting Servers with Call Servers; specify reporting properties; associate Reporting Servers with device pools. Perform Reporting database administration: schedule database backups and purges; manage database and reporting user names and passwords; apply licenses to a Reporting Server. CVP VXML Server Configure VXML Server general and infrastructure settings; specify primary and backup Call Servers; enable VXML Server reporting and specify VoiceXML data filters; associate VXML Servers with device pools; apply licenses and transfer scripts to a VXML Server. Configure VXML Server (standalone) general settings; associate VXML Server (standalone) with device pools; and apply licenses and transfer scripts to a VXML Server (standalone). Note: A VXML Server (standalone) handles calls that arrive through a VoiceXML gateway. (No statistics are provided when the VXML Server is configured this way.) Also, you cannot configure a database to and capture data from VXML Server (standalone) applications.
Device Management
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
168
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
Menu
Options
Use To
Configure Video Media Server general and infrastructure settings and associate a Video Media Server with device pools. Also, the Video Media Server Administration interface is launched from here. Note: A Video Media Server stores, annotates, and retrieves video media files.
Gatekeeper
Configure Gatekeeper general settings and associate Gatekeepers with device pools; execute a subset of IOS commands; view gatekeeper statistics; and transfer files. Configure Gateway general settings; associate Gateways with device pools; execute a subset of IOS commands; view gateway statistics; and transfer files. Configure CSS general settings; associate a CSS with device pools; execute a subset of IOS commands; and transfer files. Note: A Content Services Switch (CSS) provides load-balancing services for servers.
Gateway
Speech Server
Configure Speech Server general settings; associate a Speech Server with device pools; and transfer licenses. Note: A Speech Server provides speech recognition and synthesis services.
Media Server
Configure Media Server general settings and associate a Media Server with device pools. Note: A Media Server administers the media files that contain messages and prompts callers hear.
Unified CM
Configure Unified CM general settings; specify the URL to the Unified CM Device Administration page; associate the Unified CM with device pools. Configure ICM Server general settings and associate the ICM Server with device pools. Configure SIP Proxy Server general settings; specify the URL to the SIP Proxy Server Device Administration page; and associate the SIP Proxy Server with device pools.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
169
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
Menu
Options
Use To
IVP Server Unified IC Server Recording Server Device Past Configurations Device Versions
Configure IVP Server general settings and associate the IVP Server with device pools. Configure CUIS Server general settings and associate the CUIS Server with device pools. Configure Recording Server general settings and associate the Recording Server with device pools. Review and Restore past device configurations. View version information for the Call Server, Reporting Server, VXML Server, VXML Server (standalone), and Video Media Server. Create, modify, and delete user roles. Assign SuperUser, Administrator, or Read Only access privileges to roles. Create, modify, and delete user groups. Assign roles to user groups. Manage Unified CVP users, assign them to groups and roles. Transfer license files and script files to multiple devices at a time. Configure the SNMP agent that runs on the Unified CVP device to use the V1/V2 SNMP protocol to communicate with an SNMP management station; add and delete SNMP V1/V2c community strings; configure a destination to receive SNMP notifications from an SNMP management station; associate community strings with device. Configure the SNMP agent that runs on the Unified CVP device to use the V3 SNMP protocol to communicate with an SNMP management station; add and delete SNMP users and set their access privileges; configure a destination to receive SNMP notifications from an SNMP management station; associate SNMP users with devices. Configure the MIB2 System Group system contact and location settings; associate the MIB2 System Group with devices. Launch the SNMP Monitor application in a new browser window. Launch the Support Tools application in a new browser window. Launch the Diagnostic Portal application in new browser window. Specify the URLs that launch the SNMP Monitor, Support Tools, and Diagnostic Portal applications.
User Management
User Roles
V3
System Group
Tools
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
170
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
Menu
Options
Use To
Help
Display the table of contents for the help system. Display help on the current screen. Display the version of the help system.
The versions of software and hardware that Hardware and Software System Specification for Cisco Unified are required and compatible with the Unified Customer Voice Portal Software2 CVP solution System requirements, features of the release, Release Notes for Cisco Unified Customer Voice Portal3 packaging information, limitations and restrictions, and a list of known defects Installing Unified CVP software, performing Installation and Upgrade Guide for Cisco Unified Customer Voice an initial configuration, and upgrading from Portal4 earlier versions of Unified CVP software Setting up, running, and administering the Configuration and Administration Guide for Cisco Unified Customer Unified CVP product, including associated Voice Portal5 configuration Configuring the Reporting Server and Reporting Database and using report templates to generate reports Reporting Guide for Cisco Unified Customer Voice Portal6
Isolating and solving problems in the Unified Troubleshooting Guide for Cisco Unified Customer Voice Portal7 CVP solution
2) 3) 4) 5) 6) 7)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
171
Chapter 3: Cisco Unified CVP Operations Console Overview Using the Operations Console
Refer to...
Using the Call Studio environment and User Guide for Cisco Unified CVP VXML Server and Cisco Unified deploying applications to the Cisco Unified Call Studio 8 CVP VXML Server Configuration options for all Say It Smart plugins Say It Smart Specifications for Cisco Unified CVP VXML Server and Cisco Unified Call Studio9
Building components that run on the Cisco Programming Guide for Cisco Unified CVP VXML Server and Cisco Unified CVP VXML Server Unified Call Studio10 The ports used by Unified CVP software components. Port Utilization Guide for Cisco Unified Customer Voice Portal Software11
You can also find additional background information on these related products and technologies: The Cisco Security Agent for Cisco Unified Customer Voice Portal - Cisco Security Agent Installation/Deployment Guide for Cisco Unified Customer Voice Portal Session Initiation Protocol (SIP) - Cisco SIP Proxy Server Data Sheet (http:// www.cisco.com/en/US/products/sw/voicesw/ps2157/products_data_sheets_list.html) Simple Network Management Protocol (SNMP) - http://www3.ietf.org/ Cisco Support Tools - Cisco Support Tools User Guide for Cisco Unified Software
Procedure
To log out from the Operations Console:
Step 1
Click Logout in the screen header at the top of the screen. You will be logged out and the main Cisco Customer Voice Portal page displays.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
172
Chapter 3: Cisco Unified CVP Operations Console Overview Overview of User Management
Stop the 'Cisco CVP OPSConsoleServer' windows service. Run the %CVP_HOME%\bin\mgr-init.bat -install <new_password> script. Start the 'Cisco CVP OPSConsoleServer' windows service.
The next time you log in, the Operations Console Server will prompt for the new password for the "Administrator" account.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
173
Chapter 3: Cisco Unified CVP Operations Console Overview Configuring Components with and without the Unified CVP Operations Console
Configuring Components with and without the Unified CVP Operations Console
The Unified CVP components that reside on the Call Server (ICM Service, IVR Service, SIP Service, and H.323 Service) must be configured using the Operations Console. Devices configured outside Unified CVP, such as Cisco Unified Communications Manager, the SIP and H.323 devices, and the Media Servers, will not have their parameters adjusted in the Operations Console's configuration cache. If a device is physically not available, you can still configure it in an "Offline" mode. Once a device is configured in the Offline mode and saved to the Operations Server database, you can later apply the same configuration to it once the device becomes available. "Unapplied changes" are indicated in the Operations Console's Control Center as an icon in the "Actions" column next to the device. See Also Refer to the Unified CVP online help for detailed information about the Control Center.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
174
Chapter 4
Writing Scripts for Unified CVP
This chapter discusses using Unified ICME configuration and script editing to access the Unified CVP solution. It includes information about how to: Set up Unified ICME to interact with Unified CVP Write applications for Unified CVP Note: This chapter contains important information for IVR application developers. It also may be of interest to Call Center Managers, Unified CVP System Managers, and Unified ICME System Managers. This chapter contains the following topics: About Scripting for Unified CVP, page 175 Scripting Alternatives: VoiceXML vs. Unified ICME Scripting, page 176 Scripting for Unified CVP with Unified ICME, page 177 Unified ICME Setup, page 187 Writing Unified ICME Applications for Unified CVP, page 187 Using Unified CVP Micro-Applications, page 190 Scripting for Unified CVP with Call Studio, page 240
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
175
Chapter 4: Writing Scripts for Unified CVP Scripting Alternatives: VoiceXML vs. Unified ICME Scripting
Note: See Chapter 17, "Configuring the Basic Video and Full Video Call Flow Models (page 553)," for detailed information about the video micro-applications. Unified CVP does not support using the MicroApp nodes that are available in the ICM Script Editor. All MicroApp implementation must be done using the Run External Script node in ICM Script Editor. Refer to the ICM Scripting and Media Routing Guide for Cisco ICM/IPCC Enterprise & Hosted Editions for detailed information about the Run External Script node. See the Writing Unified ICME Applications for Unified CVP (page 187) section for detailed information about setting Unified CVP-specific parameters in this node for each Unified CVP micro-application. For more information about creating scripts, see the "Scripting for Unified CVP with Unified ICME (page 177)" section. Use Call Studio to develop sophisticated IVR applications. Note: For more information, see the "Scripting for Unified CVP with Call Studio (page 240)" section. Note: The same special micro-application that is used to invoke VXML Server applications can also be used to invoke arbitrary "External VXML" pages from a Media Server or other customer-provided source. Only use this capability for very simple VoiceXML needs, however, because Cisco has no way to verify that customer-provided VoiceXML documents are compatible with the IOS Voice Browser. (As opposed to VoiceXML documents that are generated by VXML Server, which are guaranteed by Cisco to be compatible with the IOS Voice Browser.) Although the capability has not been removed from the Unified CVP 4.0 and later offerings, customers are discouraged from using it directly. Additionally, all the VoiceXML Gateway sizing metrics that Cisco provides are based on the specific VoiceXML documents that are generated using either micro-applications or VXML Server applications. Using VoiceXML from another source will require the customer to perform his own empirical performance and capacity testing in order to determine how to size the VoiceXML Gateways.
VoiceXML Scripting
Sophisticated IVR applications can be developed using Call Studio. This is an Eclipse-based service creation environment whose output is an intermediary file which describes the application flow. That file gets loaded onto the VXML Server machines for execution. To invoke a VXML Server application, the script writer includes a special micro-application in his Unified ICME routing script. This micro-application actually instructs the VoiceXML Gateway to interact with the VXML Server directly to execute the application. Final results are then passed back to Unified ICME.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
176
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
Among its many features, the VoiceXML scripting environment has a drag-and-drop interface with a palette of IVR functions, can do database queries, and can even be extended with Java code written to perform any task a Java application could perform,
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
177
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
Unified ICME uses IVR messaging technology to direct Unified CVP and to receive the responses from Unified CVP. You can use the ICM Script Editor to develop agent routing scripts that use the Unified CVP micro-applications. Note: While it is possible to develop full scale IVR applications using micro-applications, it is not recommended. Micro-application-based scripts are primarily used for initial prompt and collect operations, as well as for directing the playing of .wav files while calls are in queue. The capability of using Unified ICME scripting for anything other than simple functions has been kept in support of legacy deployments. New customers are strongly advised to use the VoiceXML scripting environment. The sections that follows include: A sample Unified ICME script. A discussion of how Unified ICME and Unified CVP exchange information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
178
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
This simple script performs three functions: Sends the Run External Script request to Unified CVP. Indicates the location of the "Welcome" media file. Releases the call. Note: In a real life application, any Unified ICME script you create would include error checking to ensure that micro-applications instructions are properly executed.
179
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
Menu. Plays a TTS or media menu file and retrieves a single telephone keypad entry from the caller. Get Speech. Collects ASR or DTMF input after prompting a caller. Capture. The Capture (CAP) micro-application allows you to trigger the storage of current call data at multiple points in the Unified ICME routing script. Micro-applications are interpreted by the IVR Service, which resides on the Call Server. The IVR Service sends VoiceXML code to the VoiceXML Gateway Voice Browser. The IVR Service also accepts HTTP requests from the VoiceXML Gateway's Voice Browser, and communicates those requests to Unified ICME's Service Control Interface using the ICM Service. Note: In H.323 implementations only, the IVR Service also transmits call control instructions (new call, transfer, release) between the Unified ICME and the H.323 Service.
The Cisco Unified Intelligent Contact Management Enterprise /Unified CVP Micro-Application Connection
Before the Unified CVP IVR solution can be accessible through the Script Editors Run External Script node, you must first set up Unified ICME with special Unified CVP parameters using the ICM Configuration Manager tool. Begin by using the ICM Configuration Managers Network VRU Script window to define Unified CVP parameters.
Figure 25: Example Network VRU Script Attributes Tab
In the figure above: PM,Welcome. (VRU Script Name field.) This means: "Use the instructions in the Play Media micro-application to play the Welcome.wav media file."
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
180
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
N. (Configuration Param field.) This means: "Do not allow barge-in." (Barge-in is when the caller can interrupt message play by entering a digit, causing the script to move to the next prompt.) You must check the Interruptible checkbox as shown in the figure above. Note: As shown in the following table, certain entries for the VRU Script Name and Configuration Param fields are case-sensitive.
Network VRU Script Field Attributes That Network VRU Script Field Attributes That Are Are Case-Sensitive Not Case-Sensitive
Attribute: Media File Name (for example, Attribute: VRU Script Name (for example, PM, media or .vxml) GD). Applies to: Get Speech (GS). Attribute: External Grammar File name. Applies to: All micro-applications. Attribute: Media Library Type (A, S, V) Applies to: All micro-applications. Attribute: Barge-in Allowed (Y/N), Applies to: PlayData (PD). Attribute: Data playback type (for example, Number, Char). Applies to: PlayData (PD). Attribute: Time Format (HHMM, HHMMSS, HHMMAP), Applies to: Get Digits (GD), Get Speech (GS), Menu (M). Attribute: Timeout Message Override (Y/N) Applies to: Get Digits (GD), Get Speech (GS), Menu (M). Attribute: Invalid Entry Message Override (Y/N). Applies to: All micro-applications. Attribute: DTMF Termination Key (only N) Applies to: Get Speech (GS). Attribute: Type of Data to Collect (for example, boolean, date). Once the ICM Configuration Managers settings have been saved, the information is available to the Script Editor. When you place a Run External Script node in the Script Editor workspace and open the Properties dialog box, it displays all the script names defined in the system.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
181
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
The Run External Script node below shows that the ICM Script Name Play_Welcome was selected.
Figure 26: Run External Script Node Properties
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
182
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
Leading 0s are significant to the data type (times, character), enter the number as a quoted string (example: "031524"). Trailing 0s after a decimal point are significant to the data type (number, character, currency), enter the number as a quoted string (examples: "42.00" or "42.10"). The number is very large (example: a number normally expressed through exponential notation).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
183
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
Timed Out. Caller did not enter digits in response to the prompt in the time allowed by the micro-application. TTS Error. Failure of a Text-to-Speech component. Unavailable Media file. Media file name passed from Unified ICME to the IVR Service did not exist on the Media Server. Unknown micro-application. Micro-application name passed from Unified ICME to the IVR Service did not exist on the IVR Service. Unsupported locale. The VoiceXML Interpreter (that is, Gateway or H.323 Service) did not recognize the locale passed from the IVR Service. Unsupported VoiceXML element. The VoiceXML Interpreter (that is, Gateway or H.323 Service) did not recognize a VoiceXML element passed from the IVR Service, VXML Server, or media server (using External VoiceXML). Unsupported VoiceXML format. The VoiceXML Interpreter (that is, Gateway or H.323 Service) did not recognize a VoiceXML format passed from the IVR Service, VXML Server, or media server (using External VoiceXML). Each Unified CVP micro-application has individualized settings for user.microapp.error_code (non-video and video), as shown in the following table.
Table 18: Possible user.microapp.error_code ECC Variable Settings for Non-Video
Error Code
Play Media
Play Data
Get Digits
Menu
Get Speech
Capture
0 1 2 3 5 6
Unknown Unknown Unknown Unknown Unknown Unknown micro-application micro-application micro-application micro-application micro-application micro-application Invalid VRU Script Name format Invalid Configuration Param Misconfigured ECC variable One of the following: Media or external Invalid VRU Script Name format Invalid Configuration Param Misconfigured ECC variable One of the following: Invalid VRU Script Name format Invalid Configuration Param Misconfigured ECC variable One of the following: Invalid VRU Script Name format Invalid Configuration Param Misconfigured ECC variable One of the following: Invalid VRU Script Name format Invalid Configuration Param Misconfigured ECC variable One of the following: N/A
N/A
8 9
N/A N/A
Media file Media file Media file Media or does not exist does not exist does not exist external
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
184
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
Error Code
Play Media
Play Data
Get Digits
Menu
Get Speech
Capture
VXML file Invalid URL does not exist for Media L file Invalid URL for Media or external VXML file External VXML is in an invalid format 10 11
VXML file does not exist Invalid URL for Media or external VXML file External VXML is in an invalid format
Semantic-Runtime Semantic-Runtime Semantic-Runtime Semantic-Runtime Semantic-Runtime N/A Error Error Error Error Error Unsupported VoiceXML format Unsupported VoiceXML element N/A N/A Unsupported VoiceXML format Unsupported VoiceXML element Unsupported VoiceXML format Unsupported VoiceXML element Unsupported VoiceXML format Unsupported VoiceXML element N/A N/A Unsupported VoiceXML format Unsupported VoiceXML element N/A N/A N/A
12
N/A
13 14
Variable data is N/A invalid Location of variable data is empty Time format is invalid N/A N/A
N/A N/A
15 16
N/A N/A
N/A Reached Maximum Invalid Tries Reached Maximum No Entry Tries N/A No answer Busy
N/A Reached Maximum Invalid Tries Reached Maximum No Entry Tries N/A No answer Busy
N/A N/A
17
N/A
N/A
N/A
20 23 24 25 26 27
General transfer General transfer General transfer General transfer General transfer N/A error error error error error Invalid extension Invalid extension Invalid extension Invalid extension Invalid extension N/A Called party hung up Called party hung up Called party hung up Called party hung up Called party hung up N/A
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
185
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Unified ICME
Error Code
Play Media
Play Data
Get Digits
Menu
Get Speech
Capture
28
Error after transfer established Unsupported locale ASR error TTS error
Error after transfer established Unsupported locale ASR error TTS error
Error after transfer established Unsupported locale ASR error TTS error
Error after transfer established Unsupported locale ASR error TTS error
Error after transfer established Unsupported locale ASR error TTS error
N/A
30 31 32 33 34 40
General General General General General N/A ASR/TTS error ASR/TTS error ASR/TTS error ASR/TTS error ASR/TTS error Unknown error VXML Server system unavailable Unknown error N/A Unknown error N/A Unknown error N/A Unknown error VXML Server system unavailable N/A N/A
41 42
VXML Server N/A application error VXML Server N/A application used hangup element instead of subdialog return element VXML Server application is suspended N/A
N/A N/A
N/A N/A
VXML Server N/A application error VXML Server N/A application used hangup element instead of subdialog return element VXML Server application is suspended N/A
43
N/A
N/A
44
VXML Server N/A session error (for example, application has not yet been loaded) VXML Server N/A encounters a bad fetch error (for example, media or grammar file not found)
N/A
N/A
VXML Server N/A session error (for example, application has not yet been loaded) VXML Server N/A encounters a bad fetch error (for example, media or grammar file not found)
45
N/A
N/A
Table 19: Possible user.microapp.error_code ECC Variable Settings for Full Video Only
Error Code
Video Menu
18
Unable to perform Unable to perform Unable to perform Unable to perform video-related request due video-related request due video-related request due video-related request due to resource limitations to resource limitations to resource limitations to resource limitations
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
186
Error Code
Video Menu
19
Unable to start the recording Note: Recording is not triggered by video micro-applications, so this error cannot be attributed to micro-applications.
Unable to start the recording Note: Recording is not triggered by video micro-applications, so this error cannot be attributed to micro-applications.
Unable to start the recording Note: Recording is not triggered by video micro-applications, so this error cannot be attributed to micro-applications.
Unable to start the recording Note: Recording is not triggered by video micro-applications, so this error cannot be attributed to micro-applications.
Note: user.microapp.error_code is always zero, indicating success, if control proceeds out the Checkmark (success) branch of the Run External Script node. Usually, if control proceeds out the X (failure) branch, Unified CVP sets this variable to one of the codes listed here. (Set up your routing script to always test the error code after an X branch is taken.) However, if a configuration error, or a network or component failure of some sort, prevents the micro-application from being executed at all, then Unified CVPdoes not get a chance to set this variable at all. Such cases can be identified by using a Set node to pre-set user.microapp.error_code to some known invalid value such as -1, and then to test for that value using an If node, following the X branch of the Run External Script node. Two classes of problems can prevent the micro-application from being executed at all: (1) inability to route the call to an appropriate VoiceXML-enabled gateway and IVR Service (VRU-Only call flow model only); (2) mismatch between Network VRU associated with the configured VRU script and Network VRU associated with Unified CVP that is handling the call. The second case can only be caused by an ICM configuration error, but the first case may also be caused by a temporary network outage or other component failure.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
187
Chapter 4: Writing Scripts for Unified CVP Writing Unified ICME Applications for Unified CVP
Configuration Manager Script Editor The sections that follow give a brief overview of how to use these tools to access Unified CVP functionality.
Within the ICM Configuration Manager, select Tools > List Tools > Network VRU Script List. In the Network VRU Script List window, enable the Add button by clicking Retrieve. Click Add. The Attributes property tab is enabled.
Step 2 Step 3
Step 4
Complete the Attributes tab as described below. Warning: The format of the strings for the VRU Script Name and Configuration Param fields are very specific and vary for different micro-applications (Play Media, Play Data, Get Digits, Menu, and Get Speech). Network VRU. (Drop-down list.) The name of the Network VRU to be associated with the Network VRU script. VRU Script Name. A 39-character, comma-delimited string used by Unified CVP to pass parameters to the IVR Service. The content of string depends on the micro-application to be accessed. For more information on what to specify in this field, see the following sections: "Play Media (PM) Micro-Application" (page 194) "Play Data (PD) Micro-Application" (page 200) "Get Digits (GD) Micro-Application" (page 209) "Menu (M) Micro-Application" (page 216) "Get Speech (GS) Micro-Application" (page 222) Name. A unique name for the VRU script. Unified ICME generates a name based on the Network VRU and script names. Timeout. The number of seconds Unified ICME is to wait for a response from the VRU after invoking the script before assuming that the Unified CVP script has failed. Warning: This setting is designed to detect VRU failures only; attempting to use it as a technique for interrupting script processing can lead to unexpected results. Use the
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
188
Chapter 4: Writing Scripts for Unified CVP Writing Unified ICME Applications for Unified CVP
180-second default or lengthen the setting to a duration that is longer than the longest time the script is expected to take. Configuration Param. A string used by Unified CVP to pass additional parameters to the IVR Service. The content of string depends on the micro-application to be accessed. For more information on what to specify in this field, see the following sections: "Play Media (PM) Micro-Application" (page 194) "Play Data (PD) Micro-Application" (page 200) "Get Digits (GD) Micro-Application" (page 209) "Menu (M) Micro-Application" (page 216) "Get Speech (GS) Micro-Application" (page 222) Description. Any additional information about the script. Customer. (Optional.) A customer associated with the script. For Service Provider solutions, this field is mandatory, due to multiple tenancy solutions (customer-specific data needs to be separated). Interruptible. (Checkbox.) Whether Unified ICME can interrupt the script (for example, if a routing target becomes available). Overridable. (Checkbox.) Indicates whether the script can override its own Interruptible attribute. Options: This setting does not apply to Unified CVP micro-applications.
Step 5
How to Specify a Run External Script Node that Accesses a Unified CVP Micro-Application
Step 1
Within Script Editor, place the Run External Script object in the workspace, right-click, and open the Properties dialog box. The Run External Script Properties dialog box lists all Network VRU scripts currently configured Note: The ICM Script Name column reflects the values defined through the Name field in ICM Configuration Managers Network VRU Script List tool.
Select the ICM Script/VRU Script Name you want to execute. Optionally, modify the Comments tab Optionally, modify the Labels tab. When finished, click OK to submit the changes and close the dialog box.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
189
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
How Micro-Applications Use Automatic Speech Recognition (ASR) and Text-to-Speech (TTS)
Unified CVP micro-applications can use ASR in two ways: In Get Digits and Menu micro-applications, to recognize data for built-in data types, such as numbers, dates or currency, using digits and/or voice. The user.microapp.input_type ECC variable specifies the collection type. The script writer uses this variable in a Script Editor Set node to allow the caller to input DTMF only (D) or both DTMF and Voice (B, the default). If you are not using an ASR, you need to set this variable to D. If you are using an ASR, you can set the variable to either D or B. Regardless of the value of user.microapp.input_type, the recognized digit(s) are always returned to ICM in the CED variable. Note: With input_mode set to "B" (both), either DTMF or speech will be accepted, but mixed mode input is not. Once you begin entering with one mode, input via the other mode is ignored and has no effect.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
190
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
In Get Speech micro-applications, to collect voice input according to a specified grammar. The grammar to be used is specified either as inline grammar (through the setting in the user.microapp.grammar_choices ECC variable) or as an external grammar file (through a text file, the name of which is given in the Network VRU Scripts Configuration Param field). The recognized result is returned to ICM in the user.microapp.caller_input ECC variable. Unified CVP micro-applications can use TTS for two purposes: As an alternative for playing recorded announcement prompts with the Play Media, Get Digits, Menu, and Get Speech micro-applications, using either the contents of the user.microapp.inline_tts or an external .vxml file. (For more information, see the "How Micro-Applications Use External VoiceXML (page 191)" section.) The ECC variable is useful if the amount of text is relatively short and simple. The external .vxml file is useful for more lengthy text or text that needs to be changed frequently using tools other than the ICM Script Editor. As a method of playing data using the Play Data micro-application. If the user.microapp.pd_tts ECC variable contains Y, Unified CVP will use TTS to speak the data (depending on the TTS locale support and capabilities); if N, Unified CVP will use the system recorded announcements to speak the data (depending on IVR Service locale support and capabilities). Note: These ECC variables must be set in the Unified ICME script prior to executing the micro-application that they modify.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
191
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
When you set the Media Library to A or S, Unified CVP plays the audio file specified by the Call Variable after the -(number). For example, if the second VRU Script Parameter is set to -4, it plays the audio file specified in Call.PeripheralVariable4. This functionality is added for Play Media, Menu, Get Digits, and Get Speech micro-applications. If you set the Media Library to V, Unified CVP calls the external VoiceXML file specified by the Call Variable after the -(number). If the Script Parameter is set to -7, for example, it calls the external VoiceXML file specified in Call.PeripheralVariable7. Note: The V option is only supported for the Play Media and Get Speech micro-applications.
Second VRU Script Parameter Corresponding Call Variable
-1 to -10
Call.VariableParameter (-1 to -10) For an example of how to use a dynamic audio file, see the following table.
Definition
PM, -3,V
PM - Utilizes the Play Media micro-application. -3 - Plays the file specified in Call.PeripheralVariable3. V - Acquires the file from the external VoiceXML Media Library.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
192
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Note: A specific hostname, wav filename, form ID, et cetera, was used for the purpose of this example. Replace these elements with your own configuration settings. Notes If you do not specify a file extension for the file name in the Call.PeripheralVariable, the default media file extension is applied. If you set the second VRU script parameter to a value prefixed with a dash and dont specify a file name in the corresponding Call.PeripheralVariable, the IVR Service creates a VoiceXML that does not contain a media prompt. If you set the second VRU Script Parameter to a value prefixed with a dash and set the App Media Library to V, signifying external VoiceXML, you must specify a VoiceXML file in the corresponding Call.PeripheralVariable. If you do not, an Invalid VRU Script Name error is returned to ICM. If the specified VoiceXML filename does not contain an extension, and user.microapp.UseVXMLParams is not set to N, the default extension of .vxml is automatically added. You can only specify the name of a single file in the Peripheral Variable. You cannot set this value to a name/value pair. For more information, see the sections on individual micro-applications in this chapter. Note: This section does not include information about the Unified CVP Video micro-applications. See the "Using Unified CVP Video Micro-Applications (page 595)" section in Chapter 17, "Configuring the Unified CVP Basic Video and Full Video Call Flow Models," in Part 4 for detailed information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
193
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
to ICM. From there you can organize the tables in the way that best supports your querying requirements. Some information you need concerning these records: TCD records for a given call may be identified because they contain the same RouterCallKeyDay and RouterCallKey. Successive TCD records are ordered by incrementing RouterCallKeySequenceNumber. Intermediate TCD records may be identified because they contain a CallDisposition of 53, PartialCall. Only the last TCD record for the call contains the actual disposition. TCV records corresponding to a particular TCD record may be obtained by joining on TCV.TCDRecoveryKey. This key matches the RecoveryKey value in the TCD record. As of Unified ICME 6.0(0), the TCD records CallTypeId is populated even for VRU peripherals. This means you can determine the calls current CallType at the time of each Capture micro-application invocation, as well as at the end of the call. In Unified CVP Comprehensive call flow models, these records will be associated with the VRU leg peripheral. If you are doing VRU application reporting, you may want to filter for TCD records which contain the PeripheralID of the ISN VRU leg. If using the Capture micro-application, keep in mind that it places a heavy demand on ICM resources. Each time you use it, ICM writes one TCD record and multiple TCV records. Though it can conveniently capture the information you need, it is also likely to capture a great deal of extra information which you do not require. If you overuse this micro-application, you may end up placing a heavy load on ICM both in terms of processing time and disk space, which despite the minimal indexing, may nevertheless impact ICMs ability to handle the expected call load. Choose carefully where in your scripts you really need to capture information, and that you spread data items into as many different call variables as possible in order to maximize the usefulness of each invocation.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
194
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Micro-application type. For Play Media, valid options are: PM or pm. Media File Name. Name of the media file to be played (that is, the prompt file) or the name of the external VoiceXML file. The valid options are: A file name (for instance, a .wav file). Note: Media file names are case-sensitive. null - (default) If this field is empty, Unified CVP examines the contents of the user.microapp.inline_tts ECC variable. If this ECC variable contains a value, Unified CVP prompts using TTS. If the ECC is empty, no prompt is played. -(number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. Note: If you use the - (number 1-10) option and set the Media Library Type to "V," Unified CVP plays the external VoiceXML file specified in the corresponding Call.PeripheralVariable. If you set the value to - (no value) and set the Media Library Type to V, the IVR Service creates VoiceXML without a media prompt. Media Library Type. Flag indicating the location of the media files to be played. The valid options are: A - (default) Application S - System V - External VoiceXML Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Step 2
Configure the Configuration Param field parameters: Barge-in Allowed. Specifies whether barge-in (digit entry to interrupt media playback) is allowed. The valid options are: Y - (default) barge-in allowed N - barge-in not allowed Note: Voice barge-in is not supported by Play Media and Play Data micro-applications. However, DTMF barge-in is supported for these micro-applications. Unified CVP handles barge-in in the following manner: If barge-in is not allowed, the H.323 Service/Gateway continues prompt play when a caller starts entering digits and the entered digits are discarded. If barge-in is allowed,
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
195
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
the H.323 Service/Gateway discontinues prompt play when the caller starts entering digits. (For more information, see the "Get Speech and External VoiceXML (page 230)" section.) When barge-in is allowed, the IOS Gateway discontinues prompt play when the caller starts entering digits. The barge-in digits entered are saved in a type-ahead buffer on the gateway. If the ICM script contains subsequent PM and/or PD node(s) that also allow barge-in after the current node (the node that is barged-in), each subsequent node is treated as barged-inbecause of the buffered digitsuntil an input micro-app is encountered (e.g. GD, GS, M). For example, if there is a loop in the ICM script to play 2 or more PM and/or PD nodes that allow barge-in with no intervening input micro-apps (such as while in queue for an agent), all of the nodes will be treated as barged-in after the initial barge-in to one of the PM/PD nodes in the loop. Important: Although this configuration may cause the ICM router script to reach its limit, the workaround for preventing subsequent nodes from barge-in is to simply configure at least one of the nodes to __dis-allow__ barge-in. Any barge-in setting is ignored when using external VoiceXML.
Add a Set Node in the script to configure the media_server ECC variable. On the Set Variable tab of the Set Properties dialog box, select Call from the Object Type drop down and then set the Variable to user.microapp.media.server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
196
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
In the Value field, specify the URL up to, but not including, the stream name. Note: The URL must begin with an rtsp:// prefix (Real-time Streaming Protocol) to stream audio over the network. A trailing forward slash is not permitted in the URL. Click OK.
Step 2
Add another Set Node in the script to configure the stream name. On the Set Variable tab of the Set Properties dialog box, select Call from the Object Type drop down and set the Variable to PeripheralVariable<1>. The range for standard ICM Peripheral Variables is PeripheralVariable1 through PeripheralVariables10.
Figure 28: Set Node Dialog
In the Value field, specify the stream name and click OK. Note: Stream names are case-sensitive.
Step 3
Add a Run External Script node to the workspace and double-click Run External Script.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
197
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
The Run External Script Properties dialog box lists all of the Network VRU scripts that are currently configured.
Figure 29: Run External Script Properties Dialog
Note: In the example above, the IVR_RTSPStream_Forever script's external script name contains four parameters: PM, -1, A, 5. The second parameter, -1, instructs CVP to play the stream name declared in PeripheralVariable1 (shown in Step 2). It is recommended that you configure streaming audio following the steps outlined so that you may easily change the stream name within the Script Editor, if necessary. You can also use the Run External Script node in the ICM Script Editor to configure ICM to failover to a new streaming server. For example, if you want to point to an alternate streaming server (IP address), you would use the X-path out of the Run External Script node to redefine the media_server ECC variable. In a failover situation, the script executes and the stream plays from the targeted streaming server and proceeds normally.
Step 4 Step 5
From the Run VRU Script tab, select the ICM Script Name desired and click OK. Optionally, you can use the ICM Configuration Managers Network VRU Script List tools Attributes tab to configure the timeout value for the stream. Configure the Configuration Param field parameter: At the end of the Configuration Param field, enter a timeout value (in seconds). The valid range is 0 - 43200 seconds. The stream will not end if the value is set to 0 or a timeout value is not provided.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
198
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Step 6
Access the IOS device in global configuration mode and use the rtsp client timeout connect command to set the number of seconds the router waits before it reports an error to the Real-time Streaming Protocol (RTSP) server. The range is 1 to 20. The recommended value is 10 seconds.
Step 7
Optionally, you can customize ringtone patterns for streaming audio in the Operation Console's Call Server SIP configuration (select Device Management > CVP Call Server > SIP tab).
PM,Welcome
To use the Play Media (PM) micro-application to play the Welcome.wav" Media file and accept the defaults for remaining settings. Note: If no file extension is specified, .wav is assumed.
Configuration Param 2 VRU Script Name Configuration Param 3 VRU Script Name
That Barge-in is not allowed. To use the Play Media (PM) micro-application to play the July.wav" Media file, using the System (S) Media library. That Barge-in is allowed. To use the Play Media (PM) micro-application to play the Website.wav" Media file, using the default Media Type (Application library), and setting 0 as the Uniqueness value. Note: A , (comma) indicates a skipped parameter. When a parameter is skipped, Unified CVP applies its default.
That Barge-in is allowed. To use the Play Media (PM) micro-application to play the Website.wav" Media file, using the default Media Type (Application library), and setting 1 as the Uniqueness value. That Barge-in is not allowed. To use the Play Media (PM) micro-application to the external VoiceXML file customer.vxml, using the
N PM,customer.vxml,V,1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
199
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Example
Field Name
Field Contents
VoiceXML Media library, and setting 1 as the Uniqueness value. Configuration Param Note: Any barge-in setting is ignored when using external VoiceXML. PM To use the Play Media (PM) micro-application and accept the defaults for remaining settings. Note: If the user.microapp.inline_tts ECC contains a value, the PM micro-application will play its contents (for example, Hello world). Configuration Param 7 VRU Script Name N PM, -3, A That Barge-in is not allowed. To use the Play Media (PM) micro-application, using the file listed in Call.PeripheralVariable3, acquiring the file from the Application (A) media library. That Barge-in is not allowed. To use the Play Media (PM) micro-application, Calls the external VoiceXML listed in Call.PeripheralVariable7, acquiring external VoiceXML (V) media library.
N PM, -7, V
Configuration Param
Note: Any barge-in setting is ignored when using external VoiceXML. PM, stream.rm To use the Play Media (PM) micro-application to play stream.rm" from a streaming audio server and accept the defaults for remaining settings. That Barge-in is not allowed, and the stream is configured to stop playing in 30 seconds.
Configuration Param
N, 30
Note: Play Media sets the ECC variable user.microapp.error_code to zero, indicating success, if control proceeds out the Checkmark (success) branch of the Run External Script node. If control proceeds out the X (failure) branch, Play Media typically sets this variable to one of the codes listed in Unified CVP Script Error Checking (page 183).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
200
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
How to Configure Network VRU Script Settings for the Play Data Micro-application
Use the ICM Configuration Managers Network VRU Script List tools Attributes tab to specify parameters. Note: DTMF digit type-ahead is not supported by Play Media and Play Data micro-apps when executing in Comprehensive mode (Type 7). However, this feature is supported for Type 5 calls. Voice barge-in is not supported by Play Media and Play Data micro-applications. However, DTMF barge-in is supported for these micro-applications. If you are using integers that are larger than 9 digits, enclose the value in quotation marks, so it will be treated as a string.
Step 1
Configure VRU Script field parameters: Micro-application type. For Play Data, valid options are: PD or pd. Data Playback Type. The kind of the data to be returned (played) to the caller. The valid options are: Number Char (character) Date Etime (elapsed time) TOD (Time of Day) 24TOD (24-hour Time of Day) DOW (Day of Week)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
201
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Currency Note: 24TOD and DOW data play back types are not supported when using TTS. Also, currency other than US dollar (USD) is not supported. For more information about each of these playback types, including input format and output examples, see the "Play Back Types for Voice Data (page 203)" section. Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Step 2
Configure the Configuration Param field parameters: Location of the data to be played. The valid options are: null (default) - If you leave this option empty, uses the ECC variable user.microapp.play_data. A number representing a Call Peripheral Variable number (for example, a 1 to represent Call.PeripheralVariable1). Note: For more information on data location, see the "Play Data and Data Storage (page 201)" section. Barge-in Allowed. Specifies whether barge-in (digit entry to interrupt media playback) is allowed. The valid options are: Y - (default) barge-in allowed N - barge-in not allowed Note: Voice barge-in is not supported by Play Media and Play Data micro-applications. However, DTMF barge-in is supported for these micro-applications. Unified CVP deals with barge-in as follows: If barge-in is not allowed, the H.323 Service/Gateway continues prompt play when a caller starts entering digits and the entered digits are discarded. If barge-in is allowed, the H.323 Service/Gateway discontinues prompt play when the caller starts entering digits. (For more information, see the "Get Speech and External VoiceXML (page 230)" section.) When barge-in is allowed, the IOS Gateway discontinues prompt play when the caller starts entering digits. The barge-in digits entered are saved in a type-ahead buffer on the gateway. If the ICM script contains subsequent PM and/or PD node(s) that also allow barge-in after the current node (the node
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
202
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
that is barged-in), each subsequent node is treated as barged-inbecause of the buffered digitsuntil an input micro-app is encountered (e.g. GD, GS, M). For example, if there is a loop in the ICM script to play 2 or more PM and/or PD nodes that allow barge-in with no intervening input micro-apps (such as while in queue for an agent), all of the nodes will be treated as barged-in after the initial barge-in to one of the PM/PD nodes in the loop. Important: Although this configuration may cause the ICM router script to reach its limit, the workaround for preventing subsequent nodes from barge-in is to simply configure at least one of the nodes to __dis-allow__ barge-in. Any barge-in setting is ignored when using external VoiceXML. Barge-in works the same for ASR as DTMF. If the caller speaks during prompt play, the prompt play stops. Unlike DTMF input, ASR caller input is checked against the grammar that is defined. If a match is not found, an Invalid Entry error is generated and the caller input is deleted.Voice barge-in is not supported during a Play Media or Play Data script because there is not a grammar specified for these micro-applications. Time Format Valid only for the time Data Playback types (Etime, TOD, 24TOD). The available formats are: null - leave this option empty for non-time formats HHMM - default for time formats HHMMSS HHMMAP - includes am or pm; valid only for TOD
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
203
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Keep in mind that any string of characters typically used in the language may need to be spoken back character by character (this includes special keyboard symbols and numbers). If a particular symbol is not used by a particular language, there is still the possibility that a string containing that symbol will be spelled out with a Play Data with Char data type. For example, assume that an IVR application in the US (a locale of en-us) queries a database for an account owners name and spells the name back to the caller. If the name pulled from the database was Hnschen Walther, the media files that would need to be pulled from the Media Server would have been derived from a URL including the en-us locale. The symbol has a decimal value of 228, which is different than the symbol a which has a value of 97. It is the translators task to record the proper word(s) for each symbol to be supported. For detailed information on character translation, see the "System Media Files (page 530)" section in Chapter 16 in Part 3, "Configuring the Media Servers." Note: When using TTS, some output format may vary between Unified CVP playback types and TTS playback types. For example, TTS may pronounce a Play Data number "1234" as "twelve thirty four". When not using TTS, the output is "one thousand, two hundred, thirty four". Please check with your third-party vendor on TTS outputs for playback types.
Table 20: Data Play Back Types
Description
Input Format
Number
Play the stored data as a -###############.###### en-us and en-gb typical spoken form: number. The leading minus (-) is optional -123 = minus one hundred twenty and is played as minus. three The whole number portion of the 35.67 = thirty five point six seven string can contain a maximum 1234.0 = one thousand, two of 15 digits (for a maximum value of 999 trillion, 999 billion, hundred, thirty four point zero et cetera). es-mx and es-es typical spoken form: The decimal point is represented -120 = menos ciento veinte as a period (.) and played as point. It is optional if there is 10.60 = diez coma seis cero no floating portion. The floating point portion of the 1,100 = mil cien number is optional and can contain a maximum of 6 digits. Trailing zeros are played.
Char
All printable American National en-us and en-gb typical spoken form: Standards Institute (ANSI) abc123= A, B, C, one, two, three characters are supported. Note: Code Page 1252 is ANSI es-mx and es-es typical spoken form: standard. It contains ASCII abc123 = A, B, C, uno, dos, tres
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
204
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Description
Input Format
(characters 0-127) and extended characters from 128 to 255. Date Play the stored data as a YYYYMMDD, regardless of date. locale. YYYY options: the range of 1800 through 9999. MM options: the range of 01 through 12. DD options: the range of 01 through 31. en-us typical spoken form: MMDDYYYY format: 20000114 = January fourteenth, two thousand en-gb typical spoken form: DDMMYYYY format: 20000114 = Fourteenth of January, two thousand
es-mx and es-es typical spoken form: Note: The software does not validate the date (for example, DDMMYYYY format: 20001012 = "doce octubre dos mil 20000231 is valid and played accordingly). However, a failure occurs if any bounds are broken Note: All spoken forms use the proper (for example, 34 for month). grammar for the locale. Etime (elapsed time) Play the stored data as an HHMM or HHMMSS en-us and en-gb typical spoken form: amount of elapsed time. Maximum 99 hours, 59 minutes, HHMM format: 0830= eight hours 59 seconds thirty minutes Leading zeros are ignored. HHMMSS format: 083020= eight hours, thirty minutes, twenty seconds es-mx and es-es typical spoken form: HHMM format: 0205 = dos horas cinco minutos HHMMSSS format: 020101 = dos horas un minuto un segundo TOD (Time of Day) Play the stored data as a HHMM or HHMMSS 24 hour en-us and en-gb typical spoken form: time of day. time HHMM format: 0800 = eight HH options: 00 - 24 oclock 0830 = eight thirty 1430 = two thirty MM options: 00 - 59 HHMMSS format: 083020 = eight SS options: 00 - 59 thirty and twenty seconds
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
205
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Description
Input Format
HHMMAP format: 1430 = two thirty p.m. es-mx and es-es typical spoken form: HHMM format: 0100 = una a.m. HHMMAP format: 1203 = doce y tres p.m. HHMMSS format: 242124 = doce veintiuno a.m. 24TOD (24-hour Time of Day) Play the stored data as military time. HHMM or HHMMSS 24 hour en-us and en-gb typical spoken form: time. HHMM format: 0815 = eight HH options: 00 - 24 fifteen 2330 = twenty three thirty 2300 = twenty three hundred hours Note: 24-hour time and military time may have a discrepancy as HHMMSS format: 233029 = twenty to valid hours. Unified CVP three thirty and twenty nine seconds plays back the value 00 or 24 as is. The application developer is es-mx and es-es typical spoken form: free to make alterations to the HHMM format: 2121 = veintiuno data passed to the micro-application, if so desired. veintiuno 2100 = veintin horas MM options: 00 - 59 SS options: 00 - 59 Note: In Spanish, when a time ends in 00 minutes the spoken form is hours, not hundred hours.
Unified CVP validates the HHMMSS format: 050505 = cinco ranges as stated above. For y cinco y cinco segundos example, if a time ends in 00 minutes (that is, 2300), one would say hundred hours (that is, twenty-three hundred hours). The range is 0000 (12 a.m.) through 2459 (after midnight) or 0059, if you prefer. 1300 equals 1 oclock in the afternoon. Note: The 24TOD play back type is not supported when using TTS.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
206
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Description
Input Format
Play the stored data as a An integer from 1 through 7 (1 en-us and en-gb typical spoken form: day of week. = Sunday, 2 = Monday, et 7 = Saturday cetera). Note: The DOW data play back es-mx and es-es typical spoken form: type is not supported when using 7 = Sabado TTS.
Currency
Format is [-]15(X)[.2(Y)] where the minus sign is optional as well as the decimal point and the 2 digits after the decimal point. The whole number portion of the string can contain a maximum of 15 digits (for a maximum value of 999 trillion, 999 billion).
USD (US dollar) typical spoken form: 15.05 = fifteen dollars and five cents 3.00 = three dollars and zero cents
Note: Unified CVP uses the USD_dollar.wav and USD_dollars.wav Note: No comma delimiters or media files; the dollar.wav and dollars.wav used by ISN Version 1.0 are currency symbols are no longer installed. recognized. Leading and trailing zeros are played. If a number does not have a decimal point, the cents portion of the amount will not be spoken. For example, the spoken form for the input 100 is one hundred dollars. The grammar rules apply to the currency, not the locale. CAD (Canadian dollar) typical spoken form: 15.05 = fifteen dollars and five cents 3.00 = three dollars and zero cents EUR (Euro dollar) typical spoken form: 1.10 = one point one zero euro
Note: The GBP (Great Britain pound) typical user.microapp.currency ECC spoken form: variable contains the currency indicator (USD, CAD, EUR, et 1.10 = one pound ten pence cetera). MXN (Mexican pesos) typical spoken form: 1.10 = one peso and ten centavos Note: The default spoken form for a negative amount (for all currency types) is minus <amount>.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
207
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Note: 24TOD and DOW data play back types are not supported when using TTS. Also, currency other than US dollar (USD) is not supported.
It means
PD,Number
empty
Note: If you are using integers that are larger than 9 Number Play back the data digits, enclose the value in as a number. quotation marks, so it will be treated as a string. PD,Char pd Use the Play Data micro-app. Char Play back the data as individual characters. PD,Etime,0 PD Use the Play Data micro-app. 1,,HHMM 1
Note: If you are using integers that are larger than 9 Etime Play back the data digits, enclose the value in as a Time. quotation marks, so it will be treated as a string.
1 Play the data in Call PeripheralVariable 1 as an elapsed time. , (Skipped parameter) Accept default setting (Y) HHMM Play the time in HHMM format (for example, 8 hours, 30 minutes).
PD,Date
PD Use the Play Data micro-app. Date Play back the data as a Date.
1,N
PD,Currency
PD Use the Play Data micro-app. Currency Play back the data as a Currency. Note:
4,N
Play Data sets the ECC variable user.microapp.error_code to zero, indicating success, if control proceeds out the Checkmark (success) branch of the Run External Script node. If
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
208
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
control proceeds out the X (failure) branch, Play Data typically sets this variable to one of the codes listed in Unified CVP Script Error Checking (page 183). To enable Text-to-Speech (TTS) as the data play back source, you would need to need to insert a Set node in the script prior to the Run External Script node setting user.microapp.pd_tts to "Y".
How to Configure Network VRU Script Settings for the Get Digits Micro-Application
Use the ICM Configuration Managers Network VRU Script List tools Attribute tab to specify parameters.
Step 1
Configure VRU Script field parameters: Micro-application type. For Get Digits, valid options are: GD or gd. Media File Name. Name of the media file or external VoiceXML to be played (that is, the prompt file). The valid options are: A file name (for instance, a .wav file). Note: The file name is case-sensitive. null - (default) If this field is empty, Unified CVP examines the contents of the user.microapp.inline_tts ECC variable. If this ECC variable contains a value, Unified CVP prompts using TTS. If the ECC is empty, no prompt is played. -(number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, entering -2 causes Unified CVP to look at Call.PeripheralVariable2. Media Library Type. Flag indicating the location of the media files to be played. The valid options are: A - (default) Application S - System Note: This value is ignored if using TTS. Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
209
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Step 2
Configure the Configuration Param field parameters: Minimum Field Length. Minimum number of digits expected from the caller. The valid options are: 1-32 (the default is 1) Maximum Field Length. Maximum number of digits expected from the caller. The valid options are: 1-32 (the default is 1). Note: For information about Maximum Field Length and the DTMF Termination Key, see the Note in the "Get Digits and Digit Entry Completion" section. Barge-in Allowed. Specifies whether barge-in (digit entry to interrupt media playback) is allowed. The valid options are: Y - (default) barge-in allowed N - barge-in not allowed Note: Unified CVP deals with barge-in as follows: If barge-in is not allowed, the H.323 Service/Gateway continues prompt play when a caller starts entering digits. If barge-in is allowed, the H.323 Service/Gateway discontinues prompt play when the caller starts entering digits. (For more information, see the "Get Speech and External VoiceXML (page 230)" section.) Inter-digit Timeout. The number of seconds the caller is allowed between entering digits. If exceeded, the system times-out. The valid options are: 1-99 (the default is 3). Note: This value is ignored if using ASR. No Entry Timeout. The number of seconds a caller is allowed to begin entering digits. If exceeded, the system times-out. The valid options are: 0-99 (the default is 5). Number of No Entry Tries. Unified CVP repeats the Get Digits cycle when the caller does not enter any data after the prompt has been played. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Number of Invalid Tries. Unified CVP repeats the Get digits cycle when the caller enters invalid data. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Timeout Message Override. The valid options are: Y - override the system default with a pre-recorded Application Media Library file N - (default) do not override the system default Note: This value is ignored if using TTS. Invalid Entry Message Override. The valid options are:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
210
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Y - override the system default with a pre-recorded Application Media Library file. N - (default) do not override the system default Note: This value is ignored if using TTS. For more information about Timeout and Invalid Entry Messages, see the "System Media Files (page 530)" section in Chapter 16 in Part 3, Configuring the Media Servers." DTMF Termination Key. A single character that, when entered by the caller, indicates digit entry is complete. The valid options are: 0-9 * (asterisk) # (pound sign, the default) N (No termination key) Note: For information about Maximum Field Length and the DTMF Termination Key, see the Note in the "Get Digits and Digit Entry Completion" section. This value is ignored if using ASR. Incomplete Timeout. The amount of time after a caller stops speaking to generate an invalid entry error because the caller input does not match the defined grammar. The valid options are: 0-99 (the default is 3). Note: This value is ignored when not using ASR. If the value is set to 0, the IVR Service treats the NoEntry Timeout as NoError.
GD,Password,A,0
6,12
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
211
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Password Play the Media file named Password.wav. A Application Media Library. 0 Uniqueness value. GD,Password,A,1 gd Use the Get Digits micro-app. 6,12,N,3,5,2,2,N,Y,# Password - Play the Media file named Password.wav. A - Application Media Library. 1 Uniqueness value.
6 Minimum field length 12 Maximum field length N No barge-in allowed. 3 Inter-digit Timeout (seconds) 5 No Entry Timeout (seconds) 2 Number of no entry tries 2 Number of invalid tries N Timeout Msg Override Y Invalid Entry Msg Override # DTMF Termination key
Note: The two examples above both play the Password.wav file (Please enter your password followed by the pound sign.) and collect digits. They differ in that the first example accepts most of the default settings available through the Configuration Param field; the second field does not. GD,ssn GD Use the Get Digits micro-app. ssn Play the Media file named ssn.wav. GD GD Use the Get Digits micro-app. Since no Media field settings appear after GD, Unified CVP examines the contents of the user.microapp.inline_tts ECC variable. If this ECC variable contains a valuefor example, What is your account number? 6,12,N 9,9, 9 Minimum field length. 9 Maximum field length. Accept defaults for all other settings. 6 Minimum field length. 12 Maximum field length. N No barge-in allowed. Accept defaults for all other settings.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
212
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Unified CVP prompts using TTS. Note: If the user.microapp.inline_tts is empty, no prompt is played. In turn, if the user.microapp.input_type ECC variable is D, Unified CVP will be set to process any DTMF input the customer supplies. Note: Type-ahead can only be used with the Get Digits micro-application when user.microapp.input_type is set to D. For more information, see the "Get Speech and External VoiceXML (page 230)" section. GD, -4, S gd Use the Get Digits micro-app 6,12, -4 Calls the file specified in Call.PeripheralVariable4. S Acquires the file from the System media library. 6 Minimum field length. 12 Maximum field length. Accept defaults for all other settings.
The following table shows several configuration examples for Get Digits for an ASR/TTS application.
Table 23: Get Digits Configuration Examples
If ...
It means ...
It means ...
The user.microapp.inline_tts ECC variable contains What is your account number? and
Use the Get Digits micro-app to play the contents of the ECC variable and collect DTMF input.
6, 12, N,3,5,2,2,N,Y,#
6 Minimum field length 12 Maximum field length N No barge-in allowed. 3 Inter-digit Timeout (seconds)
user.microapp.input_type contains: D (DTMF) and The VRU Script Name field contains: GD
5 No Entry Timeout (seconds) 2 Number of no entry tries 2 Number of invalid tries N Timeout Msg Override Y Invalid Entry Msg Override # DTMF Termination key
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
213
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
If ...
It means ...
It means ...
The user.microapp.inline_tts ECC variable contains What is your account number? and user.microapp.input_type contains: B (the default, both DTMF and voice) and The VRU Script Name field contains: GD The user.microapp.inline_tts ECC variable contains What is your account number? and user.microapp.input_type contains: B (the default, both DTMF and voice) and The VRU Script Name field contains: GD
Use the Get Digits 6,12,N,,,,4 micro-app to play the contents of the ECC variable and collect either voice or DTMF input.
6 Minimum field length 12 Maximum field length N No barge-in allowed. ,,,, Accept defaults for Inter-digit Timeout (seconds), No Entry Timeout (seconds), Number of no entry tries, Number of invalid tries, Timeout Msg Override, Invalid Entry Msg Override, DTMF Termination key 4 Incomplete timeout
Use the Get Digits 6,12,N micro-app to play the contents of the ECC variable and collect DTMF or voice input.
6 Minimum field length 12 Maximum field length N No barge-in allowed Accept defaults for all other settings.
Note: Type-ahead can only be used with the Get Digits micro-application when user.microapp.input_type is set to D. For more information, see the "Get Speech and External VoiceXML (page 230)" section.
Note: Get Digits sets the ECC variable user.microapp.error_code to zero, indicating success, if control proceeds out the Checkmark (success) branch of the Run External Script node. If control proceeds out the X (failure) branch, Get Digits typically sets this variable to one of the codes listed in Unified CVP Script Error Checking (page 183).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
214
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
The maximum number of digits, excluding a terminator key (when terminator key is used). Less than the maximum number of digits, followed by the terminator key. Less than the maximum number of digits and exceeding the inter-digit timeout. Nothing and reaching the no entry timeout. Caution: It is important that you set up your Unified ICME script to test for all the scenarios mentioned below. If Digit-Entry Input is Complete After digit-entry input is complete, Unified CVP validates the digit string to determine if it is >= (greater than or equal to) the minimum length and <= (less than or equal to) the maximum length. In variable-length data entry, the Maximum Field Length value does not accommodate the termination key. For example, if a GD micro-application is configured to accept a password that is between 6 and 12 digits long and digit-entry completion is indicated through a termination key (or a timeout), the Minimum Field Length setting would be 6, the Maximum Field Length setting would be 12, and the DTMF Termination Key would be defined as a single character. Before passing the result back to the IVR Service, the H.323 Service or SIP Service would discard the termination key (that is, only the password digits will be included in the CED returned to Unified ICME). Note: In this example, if the 13th digit is entered without reaching the interdigit timeout and the 13th digit is not the terminator key, a NOMATCH event (same as inter-digit timeout) occurs to clear the CED buffer on the H.323 Service or SIP Service. After validating the digit string, Unified CVP does the following: If the string is valid, Unified CVP stores the digit string (not including the terminator key) in the Call.CallerEnteredDigits variable, exits the node through the Checkmark (success) branch, and returns control to Unified ICME software. If the string is not valid, Unified CVP considers it an invalid entry and does the following: If the Number of Invalid Entry Tries value has not been reached, Unified CVP plays an error message and re-plays the original prompt. If the Number of Invalid Entry Tries value has been reached, Unified CVP stores the last-entered digit string in the Call.CallerEnteredDigits variable, exits the node through the X (failure) branch, sets the user.microapp.error_code ECC variable to 16 (Reached Maximum Invalid Tries), and returns control to Unified ICME.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
215
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
If No Entry Timeout Occurs If the caller does not enter input and No Entry Timeout period is exceeded, the following happens: If the Number of No Entry Tries value has not been reached, Unified CVP plays the no entry error message and re-plays the original prompt. If the Number of No Entry Tries value has been reached, Unified CVP exits the node through the X (failure) branch, sets the Call.CallerEnteredDigits variable to NULL, the user.microapp.error_code ECC variable to 17 (Reached Maximum No Entry Tries), and returns control to Unified ICME.
How to Configure Network VRU Script Settings for the Menu Micro-Application
Use the ICM Configuration Managers Network VRU Script List tools Attribute tab to specify parameters.
Step 1
Configure VRU Script field parameters: Micro-application type. For Menu, valid options are: M or m. Media File Name. Name of the media file or external VoiceXML to be played (that is, the prompt file). The valid options are: A file name (for instance, a .wav file) Note: The file name is case-sensitive. null - (default) If this field is empty, Unified CVP examines the contents of the user.microapp.inline_tts ECC variable. If this ECC variable contains a value, Unified CVP prompts using TTS. If the ECC is empty, no prompt is played. -(number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, entering -2 causes Unified CVP to look at Call.PeripheralVariable2. Media Library Type. Flag indicating the location of the media files to be played. The valid options are:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
216
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
A - (default) Application S - System Note: This value is ignored if using TTS. Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Step 2
Configure the Configuration Param field parameters: A list of menu choices. The valid options are: 0-9 * (asterisk) # (pound sign) Formats allowed include: Individual options delimited by a / (forward slash) Ranges delimited by a - (hyphen) with no space Barge-in Allowed. Specifies whether barge-in (digit entry to interrupt media playback) is allowed. The valid options are: Y - (default) barge-in allowed N - barge-in not allowed Note: Unified CVP deals with barge-in as follows: If barge-in is not allowed, the H.323 Service/Gateway continues prompt play when a caller starts entering digits. If barge-in is allowed, the H.323 Service/Gateway discontinues prompt play when the caller starts entering digits. (For more information, see the "Get Speech and External VoiceXML (page 230)" section.) No Entry Timeout. The number of seconds a caller is allowed to begin entering digits. If exceeded, the system times-out. The valid options are: 0-99 (the default is 5). Number of No Entry Tries. Unified CVP repeats the "Menu" cycle when the caller does not enter any data after the prompt has been played. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Number of Invalid Tries. Unified CVP repeats the prompt cycle when the caller enters invalid data. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
217
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Timeout Message Override. The valid options are: Y - override the system default with a pre-recorded Application Media Library file N - (default) do not override the system default Invalid Entry Message Override. The valid options are: Y - override the system default with a pre-recorded Application Media Library file. N - (default) do not override the system default Note: For more information about Timeout and Invalid Entry Messages, see the "System Media Files (page 530)" section in Chapter 16 in Part 3, Configuring the Media Servers."
If...
It means...
It means...
The user.microapp.inline_tts ECC variable contains "Press 1 for Sales and 2 for Support." and user.microapp.input_type contains: D (DTMF) and The VRU Script Name field contains: M The user.microapp.input_type ECC variable contains: D (DTMF) and The VRU Script Name field contains: M,SalesService,A
Use the Menu micro-app to 1-2,Y,4,3 play the contents of the user.microapp.inline_tts ECC variable and collect DTMF input.
1-2 Accept the DTMF digits 1 and 2. Y Barge-in allowed. 4 No Entry Timeout value (in seconds). 3 Number of no entry tries allowed.
Use the Menu micro-app to 1-2,N,4,3,2,Y,Y play the media file named "SalesService.wav" (which is located in the Application Media library) and collect DTMF input.
1-2 Accept the numbers 1 and 2. N No barge-in allowed. 4 No Entry Timeout value (in seconds). 3 Number of no entry tries allowed.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
218
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
If...
It means...
It means...
2 Number of invalid tries allowed. Y Allow Timeout Msg Override. Y Allow Invalid Entry Msg Override). The user.microapp.inline_tts ECC variable contains "Press or Say 1 for Sales and 2 for Support." and user.microapp.input_type contains: B (the default, both DTMF and voice) and The VRU Script Name field contains: M The user.microapp.inline_tts ECC variable contains "Press 1 for Sales and 2 for Support." and user.microapp.input_type contains: B (the default, both DTMF and voice) and The VRU Script Name field contains: M Note: Type-ahead can only be used with the Menu micro-application when user.microapp.input_type is set to D. For more information, see the "Get Speech and External VoiceXML (page 230)" section. Use the Menu micro-app to The Configuration Param play the contents of the field contains: 1-2,Y,4,3 user.microapp.inline_tts ECC variable and collect DTMF or voice input. 1-2 Accept the DTMF digits 1 and 2. Y Barge-in allowed. 4 No Entry Timeout value (in seconds). 3 Number of no entry tries allowed. Use the Menu micro-app to 1-2,Y,4,3 play the contents of the user.microapp.inline_tts ECC variable and collect either DTMF or voice input. 1-2 Accept the DTMF digits 1 and 2. Y Barge-in allowed. 4 No Entry Timeout value (in seconds). 3 Number of no entry tries allowed.
The following table shows several configuration examples for Menu for use in an application where input type is DTMF.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
219
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
It means...
M,Banking
M Use the Menu micro-app. Banking Play the Media file named "Banking.wav." Note: This file might contain a message such as: "For Checking, press 1. For Savings, press 2. For Money Market, press 3."
1-3
1-3 Accept numbers 1, 2, 3. Accept all other defaults (No Entry Timeout, Number of no entry tries, Number of invalid tries, Timeout Msg Override, Invalid Entry Msg Override).
M,Main_Menu
M Use the Menu micro-app. Main_Menu Play the Media file called "Main_Menu.wav." Note: This file might contain a message such as: "For information or transactions on checking, press 1. For savings or club accounts, press 2. For other information, press 0. If you know your partys extension, press 9."
0-2/9,,4,2,2
0-2/9 Accept numbers 0, 1, 2, and 9. , (Skipped parameter) Accept the default barge-in setting (Y). 4 No Entry Timeout value (in seconds). 2 Number of no entry tries allowed. 2 Number of invalid tries allowed. Accept all other defaults (Timeout Msg Override, Invalid Entry Msg Override)
M,-2,S
M Use the Menu micro-app. -2 Plays the file specified in Call.PeripheralVariable2. S Acquires the file from the System media library.
1-3
1-3 Accept numbers 1, 2, 3. Accept all other defaults (No Entry Timeout, Number of no entry tries, Number of invalid tries, Timeout Msg Override, Invalid Entry Msg Override).
Note: Menu sets the ECC variable user.microapp.error_code to zero, indicating success, if control proceeds out the Checkmark (success) branch of the Run External Script node. If control proceeds out the X (failure) branch, Menu typically sets this variable to one of the codes listed in Unified CVP Script Error Checking (page 183).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
220
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
If No Entry Timeout Occurs If the caller does not enter a digit within the No Entry Timeout period: If the Number of No Entry Tries value has not been reached, Unified CVP plays the "no entry" error message and re-plays the menu prompt If the Number of No Entry Tries value has been reached, Unified CVP exits the node through the X (failure) branch, sets the Call.CallerEnteredDigits variable to NULL, the user.microapp.error_code ECC variable to 17 (Reached Maximum No Entry Tries), and returns control to Unified ICME.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
221
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
222
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
How to Configure Network VRU Script Settings for the Get Speech Micro-Application
Use the ICM Configuration Managers Network VRU Script List tools Attribute tab to specify parameters.
Step 1
Configure VRU Script field parameters: Micro-application type. For Get Speech, valid options are: GS or gs. Media File Name. Name of the media file or external VoiceXML to be played (that is, the prompt file). The valid options are: A file name (for instance, a .wav file) Note: The file name is case-sensitive. null - (default) If this field is empty, Unified CVP examines the contents of the user.microapp.inline_tts ECC variable. If this ECC variable contains a value, Unified CVP prompts using TTS. If the ECC is empty, no prompt is played. -(number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, entering -2 causes Unified CVP to look at Call.PeripheralVariable2. Note: If you use the -(number 1-10) option and set the Media Library Type to "V," Unified CVP plays the external VoiceXML file specified in the corresponding Call.PeripheralVariable. If you set the value to - (no value) and set the Media Library Type to "V," the IVR Service creates VoiceXML without a media prompt. Media Library Type. Flag indicating the location of the media files to be played. The valid options are: A - (default) Application S - System V - External VoiceXML. See the "Get Speech and External VoiceXML (page 230)" section. Note: This value is ignored if using TTS. Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Step 2
Configure the Configuration Param field parameters: Note: This field does not apply if you are using external VoiceXML. For example, if you are using external VoiceXML, all Configuration Param settings (such as barge-in) will be allowed whether they're set to Y or N.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
223
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Type of Data to Collect. A flag indicating the location of the media files to be played. The valid options are: null - (default) Leave this option empty if you will be specifying an External Grammar File Name setting. boolean - Affirmative and negative phrases appropriate to the current locale. date - Phrases that specify a date, including a month, days and year. currency - Phrases that specify a currency amount. Note: Nuance 8.5 ASR does not support negative currencies in its built-in grammar of datatype "currency." number - Phrases that specify numbers. (For example, "one hundred twenty-three.") time - Phrases that specify a time, including hours and minutes. Note: For information about the format of the currency data returned to Unified ICME in the user.microapp.caller_input ECC variable, see the "Get Speech Data Format" section. External Grammar File Name. The name of the grammar file that holds the grammar definition for the ASR. The valid options are: null - (default) Leaving this option empty implies that an inline grammar, as given in the Type of Data to Collect setting, will be used. A grammar file name. The Gateway retrieves the grammar file from a Web Server using HTTP. Note: The file name is case-sensitive. Note: For more information about the "Type of Data to Collect" and "External Grammar" settings, see the "Get Speech and Grammar Specification (page 222)" section. Barge-in Allowed. Specifies whether barge-in (digit entry to interrupt media playback) is allowed. The valid options are: Y - (default) barge-in allowed N - barge-in not allowed Note: Unified CVP deals with barge-in as follows: If barge-in is not allowed, the H.323 Service/Gateway continues prompt play when a caller starts entering input. If barge-in is allowed, the H.323 Service/Gateway discontinues prompt play when the caller starts entering input. (For more information, see the "Get Speech and External VoiceXML (page 230)" section.)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
224
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
No Entry Timeout. The number of seconds a caller is allowed to begin entering digits. If exceeded, the system times-out. The valid options are: 0-99 (the default is 5). Number of No Entry TriesUnified CVP repeats the Get Digits cycle when the caller does not enter any data after the prompt has been played. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Number of Invalid TriesUnified CVP repeats the prompt cycle when the caller enters invalid data. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Timeout Message Override. The valid options are: Y - override the system default with a pre-recorded Application Media Library file N - (default) do not override the system default Note: This value is ignored if using TTS. Invalid Entry Message Override. The valid options are: Y - override the system default with a pre-recorded Application Media Library file. N - (default) do not override the system default Note: This value is ignored if using TTS. For more information about Timeout and Invalid Entry Messages, see the "System Media Files (page 530)" section in Chapter 16 in Part 3, Configuring the Media Servers." Incomplete Timeout. The amount of time after a caller stops speaking to generate an invalid entry error because the caller input does not match the defined grammar. The valid options are: 0-99 (the default is 3). Note: This value is ignored when not using ASR. If the value is set to 0, the IVR Service treats the NoEntry Timeout as NoError Inter-digit Timeout. The number of seconds the caller is allowed between entering DTMF key presses. If exceeded, the system times-out. The valid options are: 1-99 (the default is 3). Note: This value is ignored if using ASR.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
225
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
If...
It means...
And, if...
It means...
The user.microapp. inline_tts Use the Get Speech The Configuration ECC variable contains What is micro-app to play the contents Param field contains: your account value of the Currency,,N,5,2,1 user.microapp.inline_tts and ECC variable and collect account balance in voice or user.microapp. input_type DTMF input, which it passes contains: B (the default, both in the DTMF and voice) user.microapp.caller_input ECC variable. and The VRU Script Name field contains: GS
Currency Collect a string of data in currency format , Accept the default External Grammar File Name setting (empty). Note: You accept the default because you are specifying a Type of Data to Collect parameter (Currency). N No barge-in allowed. 5 No Entry Timeout (seconds) 2 Number of no entry tries 1 Number of invalid tries
The user.microapp. inline_tts ECC variable contains What department do you wish to speak to and user.microapp. input_type contains: B (the default, both DTMF and voice) and user.microapp. grammar_choices contains Sales/ Customer Service/ Help Desk and The VRU Script Name field contains: GS,Department,A
Use the Get Speech The Configuration micro-app play the contents Param field contains: of the ,,N user.microapp.inline_tts ECC variable and collect the answer, which will be passed in either voice or DTMF format in the user.microapp.caller_input ECC variable
, Accept the default Type of Data to Collect parameter (empty) Note: You accept the default Type of Data to Collect parameter because you are specifying a value in the External Grammar File Name parameter. , Accept the default External Grammar File Name setting (empty) and use the grammar in the user.microapp. grammar_choices ECC variable Note: This is an inline grammar example. Each option in the list of choices specified in the user.grammar_choices ECC must be delimited by a forward slash (/). N No barge-in allowed.
The user.microapp. inline_tts Use the Get Speech The Configuration ECC variable contains What is micro-app play the contents Param field contains: your name of the ,customers.grxml,N user.microapp.inline_tts and ECC variable and collect the answer, which will be passed
, Accept the default Type of Data to Collect parameter (empty) Note: You accept the default Type of Data to Collect parameter because you are specifying a
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
226
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
If...
It means...
And, if...
It means...
user.microapp. input_type contains: B (the default, both DTMF and voice) and user.microapp.media_server contains http://
grammars.com
value in the External Grammar File Name setting parameter. customers.grxml Use the grammar in this file Note: This is an external grammar file example. For details on writing an external grammar file, see the External VoiceXML File Contents (page 237) section. N No barge-in allowed.
and user.microapp.app_media_lib contains Boston and The VRU Script Name field contains: GS,YourName,A
Note: Get Speech sets the ECC variable user.microapp.error_code to zero, indicating success, if control proceeds out the Checkmark (success) branch of the Run External Script node. If control proceeds out the X (failure) branch, Get Speech typically sets this variable to one of the codes listed in Unified CVP Script Error Checking (page 183).
Type of Data To Collect (as Allows DTMF specified in the Config Params Input?
DTMF Rules
boolean
1)
Yes
Source: Voice Extensible Markup Language (VoiceXML) Version 2.0, W3C Working Draft, 23 October 2001, This version: http://www.w3.org/TR/2001/WD-voicexml20-2001 1023
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
227
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Type of Data To Collect (as Allows DTMF specified in the Config Params Input?
DTMF Rules
Valid DTMF inputs are: four digits for the year, followed by two digits for the month, and two digits for the day.* For DTMF input, the * (asterisk) key represents the decimal point.* Valid DTMF input includes positive numbers entered using digits and the * (asterisk) key to represent a decimal point. Since is no DTMF convention for specifying AM/PM, in the case of DTMF input, the result will always end with h or ? None. None.
Note: Regardless of the collection type (that is, "voice" or "DTMF"), caller input from Get Speech is always written to the user.microapp.caller_input ECC variable.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
228
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
If Input Entry is Complete After a caller enters input, the ASR Engine validates the input against the valid grammar set that was defined using the Set node to define the user.microapp.grammar_choices ECC variable. Then Unified CVP does the following: If the input is valid, Unified CVP stores the input in the user.microapp.caller_input ECC variable, exits the node through the Checkmark (success) branch, and returns control to Unified ICME. If the input is not valid, Unified CVP considers it an invalid entry and does the following: If the Number of Invalid Entry Tries value has not been reached, Unified CVP plays the "invalid message" file and re-plays the menu prompt. If the Number of Invalid Entry Tries value has been reached, Unified CVP stores the last-entered invalid digit in the Call.CallerEnteredDigits variable, exits the node through the X (failure) branch, sets the user.microapp.error_code ECC variable to 16 (Reached Maximum Invalid Tries), and returns control to Unified ICME. Note: For more information, see the "Unified CVP Script Error Checking (page 183)" section. If No Entry Timeout Occurs If the caller does not enter input within the No Entry Timeout period: If the Number of No Entry Tries value has not been reached, Unified CVP plays the "no entry" error message and re-plays the prompt. If the Number of No Entry Tries value has been reached, Unified CVP exits the node through the X (failure) branch, sets the user.microapp.caller_input ECC variable to NULL, the
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
229
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
user.microapp.error_code ECC variable to 17 (Reached Maximum No Entry Tries), and returns control to Unified ICME.
Type
User.microapp.ToExtVXML
Array
210
This variable array contains a list of semicolon delimited name/value pairs. The following is an example of the syntax:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
230
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Variable Name
Values
Unified CVP links all five elements of the "ToExtVXML" array, parses the contents, and then puts each of the name/value pairs in the VoiceXML that it creates. You define an ECC variable to determine which method to use when passing information to the external VoiceXML.
Table 30: Use External VoiceXML ECC Variable
Type
User.microapp.UseVXMLParams Scalar
Y - (Yes) Use the values in the user.microapp.ToExtVXML variable array elements. N - (No) Append the name/value pairs in user.microapp.ToExtVXML to the URL of the external VXML.
If User.microapp.UseVXMLParams is set to a value other than "Y" or "N," the IVR Service sends a Misconfigured ECC Variable error message to Unified ICME. If the User.microapp.UseVXMLParams variable is not set, the default method is "VXML Parameters." If the User.microapp.UseVXMLParams is set to "N," the .vxml file extension is not used.
Using <Param> Elements All name/value pairs declared in the User.microapp.ToExtVXML variable array are added to the VoiceXML file that the IVR Service creates in <param> elements. These <param> elements are how the information is passed to the external VoiceXML. Unlike the URL parameters, these VoiceXML parameters are a complete, 100% VoiceXML solution that does not require media server side scripting. You must declare all names specified in the name/value pairs as variables in the external VoiceXML; otherwise, the VoiceXML Interpreter produces a error.semantic error that is returned to Unified ICME as error code "10." Using the example above in the Sample Array Definition (page 230) table, you would need to define the following form level declarations in the external VoiceXML.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
231
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
<var name=Company/> <var name=Job/> <var name=Location/> <var name=Street/> <var name=FirstName/> <var name=LastName/> <var name=Commute/> <var name=Car/> <var name=BadgeID/>
This is the reason that Unified CVP does not allow the Script Writer to specify a name without a value. Specifying only a name and not a value in a ToExtVXML parameter is useless because the external VoiceXML already has the variable defined. URL Parameter Element When you use the URL parameter element option, the name/value pairs that you set in the User.microapp.ToExtVXML parameter are appended to the URL to the external VoiceXML. The media server side scripting logic parses the URL and passes the parameters to the external VoiceXML document. Unlike the VXML Parameters, this is not a 100% VoiceXML solution and requires media-server side scripting. Using the examples above in the Sample Array Definition (page 230) table, the URL to the external VoiceXML would be in the following form: http://server/en-us/app/
MyVXML?Company=Cisco&Job=technical+writer& Location=Boxborough&Street=Main&FirstName=Gerrard&LastName=Thock& Commute=1+hour&Car=Isuzu&BadgeID=2121212
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
232
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Although the maximum number of bytes you can set each variable to is 210, as you can see from the formula above, maxing out each variable would go over the 1050 character limit. Thus, you need to make sure you use this formula to keep your character limit under the 1050 maximum. You must use a single 210-byte array element in each direction. Note: Remember that when you are returning a call from the external VoiceXML, the User.microapp.caller_input variable is automatically returned. Notes If the User.microapp.ToExtVXML array is either not defined on Unified ICME or empty, the IVR Service does not pass any parameters to the external VoiceXML. You do not need to define the User.microapp.ToExtVXML array to contain 5 elements. However, it must be defined as an ARRAY variable, not a SCALAR variable, even if you are using only one element. The IVR Service can handle any number of array elements up to a maximum of 5. If the User.microapp.ToExtVXML is either undefined or partially defined, a warning message appears on the VRU PIM console window indicating that the variable is undefined or partially defined. Although the array elements are linked together, you cant span a name/value pair to multiple array elements. This is because before you parse for the name/value pairs, the IVR Service inserts a semicolon between two array elements if there is not one. The IVR Service produces a Misconfigured ECC Variable error if there is not a = symbol between two semicolons. The IVR Service produces a Misconfigured ECC Variable error if the = symbol is the first or last character between two semicolons (for example, if there is not a name or a value). The IVR Service produces a Misconfigured ECC Variable error if the name part of the name/value pair contains a space. The IVR Service treats each of the name/value parameters as strings. The IVR Service does not check to see if the value parameter is an integer.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
233
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Type
User.microapp.FromExtVXML
Array
210
The Get Speech micro-app returns up to 1050 characters by populating the User.microapp.caller_input variable and each element of the User.microapp.FromExtVXML array. Note: Remember to use the ECC Variable array formula listed above when defining the FromExtVXML variable. You do not need to define the User.microapp.FromExtVXML array to contain 5 elements. However, it must be defined as an ARRAY variable, not a SCALAR variable, even if you are using only one element. VoiceXML Requirements External VoiceXML is called via the <subdialog> VoiceXML element. Because of the design of the VoiceXML itself, the variable names in the customer defined VoiceXML must be coordinated with Unified CVP; otherwise, it wont be possible to pass external VoiceXML data back to Unified CVP. The following table lists the VoiceXML variables and the ECC variables they correspond to.
Table 32: From External VoiceXML ECC Variable Definition
You need to define the following form level declarations in the external VoiceXML.
<var name="caller_input"/>
When passing the information back to Unified ICME, you need to use the following syntax for caller input:
<assign name="caller_input" expr="input$.utterance"/>
If the external VoiceXML sets input to sales and FromExtVXML2 to stocks, for example, the User.microapp.caller_input would be set to sales and User.microapp.FromExtVXML[2] would be set to stocks. Notes The variables declared in the customer VoiceXML must be named exactly as specified above. VoiceXML is case-sensitive.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
234
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
The caller-input variable must be declared and used in the VoiceXML. The only way that it is acceptable to not populate this variable is if the external VoiceXML is returning an error event. Examples of error events include <badfetch>, <noinput>, and <nomatch>. If the caller_input variable is not set to a value and an error event is not generated, the Unified CVP assumes that a No Entry error occurred. The FromExtVXML variables are optional. You can use these variables if the caller_input variable is not sufficient. If you are not using this additional data then the ECC Variable array does not need to be defined. If the User.microapp.FromExtVXML ECC Variable array is undefined or partially defined, a warning message appears when the IVR Service starts up on the VRU PIM console window. If you set an FromExtVXML variable in the external VoiceXML, the User.microapp.FromExtVXML must be defined on Unified ICME. If it is not, the Unified CVP does not attempt to set the value and an error appears on the VRU PIM console window. However, no error appears in the Unified CVP log files. If you need more than 210 characters but less than the full 1050 characters, you can declare the User.microapp.FromExtVXML array to be less than four elements long. If you do this, you only use the corresponding number of External VoiceXML Variables. For example, if you configure a 2 element FromExtVXML ECC Variable array, you can utilize the caller_input, FromExtVXML0 and FromExtVXML1 VoiceXML variables. If the external VoiceXML sets a FromExtVXML variable to a value that is longer than the maximum ECC Variable length, an error message appears in the VRU PIM console window and the value is not set. No error appears in the Unified CVP log files.
<?xml version=1.0> <vxml version=2.0> <var name="caller_input"/> <form id=getcredit> <field name=input> <prompt> What is your credit card type? </prompt> <help> I am trying to collect your credit card type. <reprompt/> </help> <nomatch> <return event=nomatch/> </nomatch> <grammar src=cctype.grxml type=application/srgs+xml/> </field>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
235
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
<field name=FromExtVXML0> <prompt> What is your credit card number? </prompt> <help> I am trying to collect your credit card information. <reprompt/> </help> <nomatch> <return event=nomatch/> </nomatch> <grammar src=ccn.grxml type=application/srgs+xml/> </field> <field name=FromExtVXML1> <grammar type=application/srgs+xml src=/grammars/date.grxml/> </prompt> <help> I am trying to collect the expiration date of the credit card number you provided. <reprompt/> </help> <nomatch> <return event=nomatch/> </nomatch> </field> <block> <assign name="caller_input" expr="input$.utterance"/> <return namelist=caller_input FromExtVXML0 FromExtVXML1/> </block> <catch event=telephone.disconnect.hangup> <return event=telephone.disconnect.hangup/> </catch> <catch event=error.badfetch> <return event=error.badfetch/> </catch> <catch event=error.semantic> <return event=error.semantic/> </catch> <catch event = error.unsupported.format> <return event=error.unsupported.format/> </catch> <catch event = error.unsupported.element> <return event=error.unsupported.element/> </catch> <catch event=error.unsupported.language>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
236
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
<return event=error.unsupported.language/> </catch> <catch event = error.com.cisco.media.resource.unavailable.asr> <return event= error.com.cisco.media.resource.unavaliable.asr/> </catch> <catch event = error.com.cisco.media.resource.unavalable.tts> <return event= error.com.cisco.media.resource.unavailable.tts/> </catch> <catch event = error.com.cisco.media.resource.failure.asr> <return event= error.com.cisco.media.resource.failure.asr/> </catch> <catch event = error.com.cisco.media.resource.failure.tts> <return event= error.com.cisco.media.resource.failure.tts/> </catch> <catch event = error.com.cisco.media.resource> <return event= error.com.cisco.media.resource/> </catch> <catch event = error> <return event=error/> </catch> <form> </vxml>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
237
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Note: This example assumes that the VRU Script Name value is PM,CustomerVXML,V. External VoiceXML Document Example
<?xml version="2.0" encoding="iso-8859-1"?> <vxml version="2.0"> <form id="CustomerVXML" scope="dialog"> <block> <prompt bargein="true"> <audio src="http://webserver.com/myapp/Hello_World.wav" /> </prompt> </block> <catch event="error.badfetch"> <return event="error.badfetch"/> </catch> <catch event="error.semantic"> <return event="error.semantic"/> </catch> <catch event = "error.unsupported.format"> <return event="error.unsupported.format"/> </catch> <catch event = "error.unsupported.element"> <return event="error.unsupported.element"/> </catch> <catch event="telephone.disconnect.hangup"> <return event="telephone.disconnect.hangup"/> </catch> <catch event="error"> <return event="error"/>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
238
Chapter 4: Writing Scripts for Unified CVP Using Unified CVP Micro-Applications
Note: For a complete explanation of VoiceXML file grammar format, see http://www.w3.org/ TR/speech-grammar/. Also, consult the user documentation for your ASR Server for a list of supported grammar elements. The example that follows illustrates another external grammar file that might be used to prompt callers for the state that they live in. External Grammar file <?xml version = 1.0?>
<grammar version= 1.0 root= action xml:lang= en-us > <rule id= action scope= public > <one-of> <item> California </item> <item> Arizona </item> <item> Connecticut </item> </one-of> </rule> </grammar>
After a caller responds with the name of the state she lives in, the ASR Engine determines if the caller said California, Arizona, or Connecticut. If the caller said the name of one of these states, the text listed in the <item> element will be passed to the IVR Serviceand, in turnICM software. If a caller responds with a name not included in this list, an invalid entry error is returned to the IVR Service.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
239
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Call Studio
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
240
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Call Studio
Default
Notes
No
Yes
Yes
Call Peripheral variables passed by the Call Studio script to the Unified ICME Server. This
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
241
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Call Studio
Default
Notes
10 (callvar1 callvar10)
setting can be a maximum length of 210 characters. The Unified ICME Server returns a name-value pair for up to 10 Call Peripheral Variables in a result. Any value that is placed in callvar<n> from a Call Studio script is returned unchanged, if the Unified ICME Script does not change it. No Yes Yes Call Peripheral variables created upon the return of the Unified ICME Label request, regardless of whether or not these variables are filled by the Unified ICME Script. You need two sets of these variables to keep reporting the To ICM Call Peripheral Variables separate from what is returned from Unified ICME. External Call Context (ECC) variables passed by the Call Studio script to the Unified ICME Server. Each variable is a string of name-value pairs, separated by semicolons, for up to 4 external VoiceXML variables. This setting can be a maximum length of 210 characters. External Call Context (ECC) variables received from the Unified ICME script. The Unified ICME Server returns a string of name-value pairs, separated by semicolons, for up to 5 external VoiceXML variables. 3000 (ms) The number of milliseconds the transfer request waits for a response from the Unified ICME Server before timing out. Note: This value can only be increased or decreased by increments of 500 ms.
Yes
Yes
Yes
Yes
Timeout
Integer
Yes
Yes
Yes
String
No
Yes
Yes
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
242
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Call Studio
Default
Notes
Name
Type
Notes
result
String
Unified ICME Label returned from a Unified ICME server. You can use this result as input to other Call Studio elements, such as Transfer or Audio. The element data value is {Data.Element.ReqICMLabelElement.result}. Call Peripheral variables that the Call Studio scripts passes to the Unified ICME Server. Valid Call Peripheral Variables are callvar1 callvar10. Call Peripheral variables that the Unified ICME script returns to the VXML Server. Valid Call Peripheral Variables are callvarReturn1 callvarReturn10. For example, if an Unified ICME script contains Call Peripheral variable 3 with the string value CompanyName=Cisco Systems, Inc, you can access the value of CompanyName that is returned by the Unified ICME script by using:
Data.Element.ReqICMLabelElement.callvarReturn3.
callvar<n callvarReturn<n
String String
Name
Type
Notes
name
String
Value for a name-value pair contained in a ToExtVXML variable returned in the Unified ICME label. You must know which name-value pairs are set in the Unified ICME script to retrieve the correct value from the Call Studio script. For example, if a Unified ICME script contains a user.microapp.ToExtVXML0 variable with the string value CustomerName=Mantle, specify Data.Session.CustomerName. If the same Unified ICME script contains a user.microapp.ToExtVXML0 variable with the string value BusinessType=Manufacturing, you can access the customer business type returned by the Unified ICME script by using Data.Session.BusinessType.
Name
Notes
done error
The element execution is complete and the value was successfully retrieved. The element failed to retrieve the value. Studio Element Folder is "Cisco."
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
243
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Call Studio
Specify the URL and port number of the VXML Server that you want to reach, for example:
http://12.34.567.890:7000/CVP/Server?application=HelloWorld
In the example above, 12.34.567.890 is the URL and 7000 port number; the values are delimited by a colon (:). Note: 7000 is the default port number for a VXML Server.
Step 2
In the Unified ICME script, first set the media_server ECC variable to http://
12.34.567.890:7000/CVP
Step 3 Step 4
Set the app_media_lib ECC Variable to "..", (literally two periods in quotes). Set the user.microapp.ToExtVXML[0] ECC variable to application=HelloWorld. Note: This example indicates that the VXML Server will execute the HelloWorld application. To execute a different application, change the value of user.microapp.ToExtVXML[0] accordingly.
Step 5 Step 6
Set the UseVXMLParams ECC Variable to "N." Set the concatenate element by following the instructions in the "Correlating Unified CVP/Unified ICME Logs with VXML Server Logs (page 304)" section in Chapter 7, "Configuring VXML Solution." Create a Run External Script node within the Unified ICME script with a VRU Script Name value of GS,Server,V. Note: Remember to link this node to the nodes configured in previous steps. Configure the timeout setting in the Network VRU Script to a value substantially greater than the length of the timeout in the VXML Server application. (This timeout would only be used for recovery from a failed VXML Server.) Always leave the Interruptible checkbox in the Network VRU Script Attributes checked; otherwise, calls queued to a VXML Server application might stay in the queue when an agent becomes available.
Step 7
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
244
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Call Studio
After you configure the Unified ICME script, you need to configure a corresponding VXML Server script with Call Studio. The VXML Server script must: Begin with a Subdialog_Start element (immediately after the Call Start element). Contain a Subdialog_Return element on all return points (script must end with a Subdialog_Return element). The Subdialog_Return element must include a value for the call input. To enable reporting, you must add Data Feed/SNMP loggers.
Create or modify one or more VoiceXML application scripts. Deploy one or more VoiceXML application scripts to the local machine using archive option. The archived scripts are saved as a zipped file under a user-specified directory, for example:
C:\Program Files\Cisco\CallStudio
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
245
Chapter 4: Writing Scripts for Unified CVP Scripting for Unified CVP with Call Studio
Step 3
Use Call Studio to set up the loggers using the ActivityLogger, ErrorLogger, and Admin Logger tools. Set up the Unified CVP Datafeed logger for each application. Note: Call Studio also includes CVPDatafeedLogger and CVPSNMPLogger, as well. Call Studio also allows you to change other parameters for these loggers, such as log file size, log lever, et cetera.
See Also Refer to the Call Studio documentation for more information.
From the web browser, enter https://ServerIP:9443/oamp or http:// ServerIP:9000/oamp, which is redirected to the former URL. Enter your user ID in the User Name field. Note: The first time you log in after installing Unified CVP, enter Administrator, the default user account.
Step 2
Step 3
In the Password field, enter your password. Observe the following: If you are logging in to the default Administrator account, enter the password that was set for this account during installation. If the user ID or password is invalid, the Operations server displays the message, "Invalid Username or password." Click the link, enter your user ID and password again, and click OK. The main Operations Console Welcome window displays.
Select Bulk Administration > File Transfer. In the File Transfer window, select Script File. In the Available Script Files pane, select one or more archived script files to deploy. If the archived script file is not listed, click Browse and locate the archived script files. Select the Transfer to Devices tab. In the Available Devices pane, select one or more VXML Servers to which you want to deploy scripts. Click Transfer to transfer the selected archived scripts file to the selected devices.
Step 7 Step 8
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
246
Chapter 5
Using Cisco Support Tools with Unified CVP
This chapter presents an overview of Cisco Support Tools, including the tools available with Unified CVP solutions running on Windows and AIX environments. This chapter contains the following topics: About Cisco Support Tools, page 247 About Cisco Support Tools and Unified CVP, page 248 Accessing Cisco Support Tools from the Operations Console, page 249
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
247
Chapter 5: Using Cisco Support Tools with Unified CVP About Cisco Support Tools and Unified CVP
Unified CVP installation. For more information on IPSEC, see Configuring and Modifying Unified CVP Security (page 251). For additional information about Cisco Support Tools, refer to the Cisco web site (http:// www.cisco.com/en/US/products/ps5905/tsd_products_support_series_home.html) listing Cisco Support Tools documentation.
In addition to the STPA module that is now part of Unified CVP, the Unified CVP installer, when run on a Windows platform, automatically installs the Windows version of the Support Tools Node Agent (called STNA) on the Windows server. If the STPA receives any requests for commands that are not handled by the STPA, the STPA will attempt to forward the requests
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
248
Chapter 5: Using Cisco Support Tools with Unified CVP About Cisco Support Tools and Unified CVP
to the local STNA. This will enable other Support Tools commands to work when Unified CVP is installed on Windows servers. Note: STNA functionality is not available on AIX servers.
Select Tools > Support Tools. Note: The Support Tools options will only work if it has been configured. You must first specify the URL of the Support Tools webpage to launch; select Tools > Configure option. (For more information, refer to the Operations Console online help.) A web browser window opens displaying the Cisco Support Tools Dashboard.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
249
Chapter 5: Using Cisco Support Tools with Unified CVP About Cisco Support Tools and Unified CVP
Step 2
Select the Support Tools utility you want to work with. Refer to the Support Tools User Guide for ICM/IPCC for a list of available Support Tools utilities.
See Also For additional information about using Cisco Support Tools, see the Cisco web site (http:// www.cisco.com/en/US/products/ps5905/tsd_products_support_series_home.html) for documentation for Cisco Support Tools Release 2.x documentation.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
250
Chapter 6
Configuring and Modifying Unified CVP Security
This chapter discusses security considerations for Unified CVP deployments. Note: For detailed information about security issues in Unified ICME, see Security Best Practices Guide for ICM and IPCC Enterprise Hosted Editions. This chapter contains the following topics: Unified CVP Security and Cisco Support Tools, page 251 Securing Communications Between Unified CVP Components, page 252 Securing Communications Between Unified CVP and IOS Devices, page 260 Securing Communications Between VoiceXML Gateways and VXML Server, page 263 HTTPS Support for Unified CVP, page 263 Securing Sensitive Customer Information, page 269
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
251
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP Components
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
252
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP Components
For AIX machines, $WAS_HOME/java/bin Note: On both Windows and AIX systems, the keystore and the keystore password are in a folder that is protected with Access Control List (ACL), so only a user who has Administrator privileges can import trusted certificates. For more information about the keytool and keystores, refer to your Java documentation.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
253
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP Components
On a Windows system, do the following: 1. Stop the Unified CVP Operations Console service. Select Start > Control Panel > Administrative Tools > Services. The Services window appears. 2. In the list of Service names, highlight Cisco CVP OpsConsoleServer. 3. Click the Stop link. The service stops.
Step 2
Use the instructions in the "How to Exchange Certificates Between Systems (page 254)" section for details on using the keystore and keytool Java tools to exchange trusted certificates between the Operations Console and the device being managed. Note: For information about prerequisites and assumptions regarding keystore and keytool, see the "Before You Begin (page 253)" section. For detailed instructions about using these tools, see the Java documentation.
Step 3
Restart the Cisco CVP OpsConsoleServer service. Follow the procedure described in Step 1, selecting the Start link instead of Stop on a Windows system.
Step 4
Use the Security checkbox on the Operations Console Device Management configuration page to enable security for devices that require secure communication. (See the "How to Enable Security on Unified CVP Devices (page 257)" section for more information.) Restart the Cisco CVP Resource Manager service on the Unified CVP device machines on which communications needs to be secure by doing the following:
a.
Step 5
For Windows, restart the Cisco CVP Resource Manager service. Select Start > Control Panel > Administrative Tools > Services. For AIX, restart the ORM services. From the $CVP_HOME/bin directory, enter the following command: orm-wrapper.sh restart.
b.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
254
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP Components
Note: The keytool commands shown below use the JRE relative path for the Windows platform. For AIX, keytool can be found in $WAS_HOME/java/bin.
Step 1
Import the Operations Console Server certificate as trusted on the managed Unified CVP device:
a.
Retrieve the keystore password from the security.properties file (resides in the %CVP_HOME%\conf directory) on the Operations Console Server. Export the certificate from the keystore on the Operations Console Server. Open a command prompt and navigate to the %CVP_HOME%\conf\security directory, then enter the following command:
b.
.\..\jre\bin\keytool -export -v -keystore .keystore -storetype JCEKS -alias oamp_certificate -file <oamp_cert_XXX>
Where the file argument in <> (angle brackets) is user-defined and unique. Note: Do not modify the oamp_certificate alias name. When prompted, enter the keystore password.
c.
Copy the exported certificate file <oamp_cert_XXX> from the Operations Console service to the %CVP_HOME%\conf\security folder on the machine where the Unified CVP Resource Manager service is running. Retrieve the keystore password from the security.properties file on the managed Unified CVP device. For Windows, import the Operations Console certificate <oamp_cert_XXX> into the keystore on the managed Unified CVP device. Open a command prompt and navigate to the %CVP_HOME%\conf\security directory, then enter the following command:
d.
e.
..\..\jre\bin\keytool -import -keystore .keystore -storetype JCEKS -trustcacerts -alias <orm_oamp_certificate> -file <oamp_cert_XXX>
Where the alias argument in <> (angle brackets) is user-defined and unique, and the file argument in <> (angle brackets) is the exported Operations Console certificate filename. When prompted, enter the keystore password and then enter yes to confirm.
f.
For AIX, import the Operations Console certificate oamp_cert_XXX into the keystore on the managed Unified CVP device. Open a command prompt and navigate to the %CVP_HOME%\conf\security directory, then enter the following command:
$WAS_HOME/java/bin/keytool -import -keystore .keystore -storetype JCEKS -trustcacerts -alias <orm_oamp_certificate> -file <oamp_cert_XXX>
Where the alias argument in <> (angle brackets) is user-defined and unique, and the file argument in <> (angle brackets) is the exported Operations Console certificate filename.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
255
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP Components
g.
Repeat these steps for every machine where the Unified CVP Resource Manager service is running if the JMX communication from the Operations Server to that managed Unified CVP device needs to be secured.
Step 2
Import the managed Unified CVP device certificate as trusted in the keystore on the Operations Console Server:
a.
Retrieve the keystore password from the security.properties file (resides in the %CVP_HOME%\conf directory) on the managed Unified CVP device. For Windows, export the Unified CVP device certificate from the keystore. Open a command prompt and navigate to the %CVP_HOME%\conf\security directory, then enter the following command:
b.
..\..\jre\bin\keytool -export -v -keystore .ormKeystore -storetype JCEKS -alias orm_certificate -file <orm_cert_file_XXX>
Where the file argument in <> (angle brackets) is user-defined and unique. Note: Do not modify the orm_certificate alias name. Append an IP address to the file name to make it unique. The IP address can be replaced with any value as long as it makes the filename unique when copied to the Operations Console Server.
c.
For AIX, export the Unified CVP device certificate from the keystore using the following command:
$WAS_HOME/java/bin/keytool -export -v -keystore .ormKeystore -storetype JCEKS -alias orm_certificate -file <orm_cert_XXX>
Where the file argument in <> (angle brackets) is user-defined and unique. Note: Do not modify the orm_certificate alias name.
d.
Copy the exported certificate file <orm_cert_file> from the managed Unified CVP device to the %CVP_HOME%\conf\security folder on the Operations Console service. Retrieve the keystore password from the security.properties file in the Operations Console Server. Import the certificate <orm_cert_file> into the keystore on the Operations Console Server. Open a command prompt and navigate to the %CVP_HOME%\conf\security directory, then enter the following command:
e.
f.
..\..\jre\bin\keytool -import -keystore .keystore -storetype JCEKS-trustcacerts -alias <oamp_orm_certificate_XXX> -file <orm_cert_XXX>
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
256
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP Components
Where the alias argument in <> (angle brackets) is user-defined and unique, and the file argument in <> angle brackets is the exported managed device certificate filename. Note: Append an IP address to the certificate alias to make the alias unique in the keystore. The IP address can be replaced with any value as long as it makes the certificate name unique when imported to the keystore.
g.
Repeat these steps for every machine where the Unified CVP Resource Manager service is running if the JMX communication from the Operations Console Server to that managed Unified CVP device needs to be secured.
Open the Operations Console. Choose a device type from the Device Management menu. Click Add New or select an existing device name and click Edit. The General tab displays.
Step 4 Step 5
Select the Security On checkbox. Click Save to save the settings in the Operations Server database and click Save and Deploy to apply the changes to the device. Restart the Unified CVP Resource Manager service on the machine where the device is running. Repeat these steps for all Unified CVP components that are to accept only secure SSL communications.
Step 6 Step 7
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
257
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP Components
Retrieve the keystore password from the security.properties file. Generate a Certificate Signing Request (CSR).
a.
..\..\jre\bin\keytool -keystore .keystore -storetype JCEKS -certreq -keyalg RSA -sigalg MD5withRSA -alias orm_certificate -file ormcertreq. csr b. Step 3
Send the ormcertreq.csr certificate file to a Certificate Authority (CA) for sign-off. Once the certificate is signed, it will be returned with a root certificate of a CA and, depending on the signing CA, some optional intermediate certificates. Install the signed certificate into keystore.
a.
Step 4
Enter the following command to install the Intermediate CA Certificates (if any):
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
258
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP Components
keytool -keystore .keystore -storetype JCEKS -import -alias root -trustcacerts -file <filename_of_intermediate_CA_certs> b.
Enter the following command to install the root certificates (these are not in the Unified CVP keystore by default):
keytool -keystore .keystore -storetype JCEKS -import -alias root -trustcacerts -file <filename_of_root_cert>
Note: Be careful to examine the contents of any root certificate file before installing it to your keystore as a trusted certificate. The Java root certificates are installed in %CVP_HOME%\jre\lib\security\cacerts.
c.
keytool -keystore .keystore -storetype JCEKS -import -alias orm_certificate -trustcacerts -file <filename_of_your_signed_cert_from_CA> Step 5
How to Add a Certificate Signed by a Certificate Authority for HTTPS Web Access
Follow the steps below to present a CA-signed certificate to inbound Operations Console HTTPS clients. Note: The OAMP and ORM certificates provided in the keystore do not provide TLS encryption for inbound HTTPS traffic; those certificates provide secure connections between the Operations Console and the CVP Resource Manager on other devices in your Unified CVP solution. The certificate and private key used for Operations Console HTTPS are: Self-signed certificate: %CVP_HOME%\conf\security\oamp.crt Private key for self-signed certificate: %CVP_HOME%\conf\security\oamp.key
Step 1
Access the OpenSSL command line. Note: You must first install OpenSSL (http://www.openssl.org), as it is not included with Unified CVP. Refer to the OpenSSL documentation for details.
Step 2
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
259
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP and IOS Devices
Step 3
Send the xxxx.csr certificate file to a Certificate Authority (CA) for sign-off. Once the certificate is signed, it will be returned with a root certificate of a CA. Replace the original oamp.crt file with the signed certificate.
Step 4
From the web browser, enter https://ServerIP:9443/oamp The Security Alert dialog box appears.
Step 2
Step 3
Select the Details tab. <All> will be highlighted in the Show drop-down list.
Step 4
Select the Base-64 encoded X.509 (.CER) radio button and click Next. Specify a file name in the File to Export dialog and click Next. Click Finish. An Export was Successful message appears.
Step 8 Step 9
Click OK and close the Security Alert dialog. Open the exported file in Notepad and copy the text that appears between the ----BEGIN CERTIFICATE--- and ----END CERTIFICATE--- tags.
You are now ready to copy the Operations Console certificate information to the IOS device.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
260
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP and IOS Devices
Access the IOS device in privileged EXEC mode. Note: For more information, see the Cisco IOS Command-Line Interface documentation.
Step 2
Step 3
Where xxxx is a trustpoint name. The IOS device exits conf t mode and returns to privileged EXEC mode.
Step 4
Do the following to copy the certificate exported to the Notepad to the IOS device: 1. Enter cryp pki auth xxxx Where xxxx is the trustpoint name specified in in the previous step. 2. Paste the certificate from the Notepad clipboard. 3. Enter quit. The following happens: A message displays describing the certificate attributes. A confirmation prompt appears.
Step 5
Enter yes. A message reports that the certificate was successfully imported.
How to Configure Secure Access to the Router Using Protocol SSH Version 2
The Unified CVP administrator can configure secure access to the router using the following example.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
261
Chapter 6: Configuring and Modifying Unified CVP Security Securing Communications Between Unified CVP and IOS Devices
Step 1 Step 2
Log into the IOS devices. On the gateway or gatekeeper, enter the command show ip ssh to determine if the SSH Server is enabled. If the SSH Server is not enabled, perform the following steps.
Step 3
Enter 768 or higher for how many bits to use. Note: Important! If you enter lower than 768, IOS automatically uses SSH Version 1, which is not compatible with the Operations Console, which is trying to connect with SSH Version 2.
Step 5 Step 6
Choose the key modulus size in the range of 360 to 2048 for your General Purpose Keys. Enter the following commands:
gw(config)# ip ssh time-out 60 gw(config)# ip ssh authentication-retries 5
Step 7
Enter the show ip ssh command and confirm that "SSH version enabled -version 1.99" or "SSH version enabled - version 2.0" displays. Configure a user name and password in IOS by entering the following command: gw(config)# username <username> password <password> Where the username and password are your configured username and password.
Step 8
Step 9
Configure the IOS settings to allow SSH logins by entering the following commands. Note: These commands are located in the running configuration towards the end. Search for the line vty configurations in the configuration. The important settings are those indicated by an asterisk (*).
line vty 0 4* exec-timeout 35 0 password <password>* session-limit 10 login local* transport input telnet* transport output all
To configure these settings, access the configurable terminal and enter the following:
gw# configure terminal gw(config)# line vty 0 4 gw(config-line)# password <password> gw(config-line)# login local gw(config-line)# transport input ssh
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
262
Chapter 6: Configuring and Modifying Unified CVP Security HTTPS Support for Unified CVP
Where the password is your configured password. Note: Important! Enabling these settings will not allow regular telnet anymore and will only allow SSH. If you want telnet and SSH available, then enter transport input all or transport input telnet for telnet-only access.
Edit the CATALINA_HOME\conf\context.xml file, where CATALINA_HOME is the Tomcat installation directory. Between the existing <Context> tag and its closing tag, insert: <Valve
className="org.apache.catalina.valves.RemoteAddrValve" allow="X.X.X.X" deny=""/>.
Step 2
Where X.X.X.X is the IP address of your VoiceXML Gateway (or Content Services Switch IP, as appropriate). If multiple IP addresses need access, indicate them as a comma-delimited list, such as: allow="X.X.X.X,Y.Y.Y.Y".
Step 3
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
263
Chapter 6: Configuring and Modifying Unified CVP Security HTTPS Support for Unified CVP
Access the OpenSSL command line. Note: You must first install OpenSSL (http://www.openssl.org), as it is not included with Unified CVP. Refer to the OpenSSL documentation for details.
Step 2
Step 3
Send the xxxx.csr certificate file to a Certificate Authority (CA) for sign-off. Once the certificate is signed, it will be returned with a root certificate of a CA. Replace the original xxxx.crt file with the signed certificate. Restart the CVP server to apply the new signed certificate.
Step 4 Step 5
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
264
Chapter 6: Configuring and Modifying Unified CVP Security HTTPS Support for Unified CVP
Run IBM's ikeyman utility to create a keystore: C:\Program Files\IBM\HTTPServer\bin\ikeyman.bat. Create a new Key database file: Select Key Database File > New. Database type: CMS Filename: key.kdb Location: C:\Program Files\IBM\HTTPServer\keys Note: The "keys" directory will have to be explicitly created if it does not exist. Keystore will prompt for password and expiration information. Check off creates a Stash file.
Step 2
Create a new Certificate Request in ikeyman by selecting Create > New Certificate Request. Key Label: <hostname> Version: V509 v3 Key Size: 1024 Common Name: <hostname> Organization: <Company Name> Organization Unit: <Group Name> Locality: <Town> State: <State> Zip Code: <Zip Code> Country: <Country> Validity Period: 730 days This saves a file certreq.arm. Present this certificate request to a Certificate Authority for sign-off. Once the certificate is signed, it will be returned with the root certificate of a CA.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
265
Chapter 6: Configuring and Modifying Unified CVP Security HTTPS Support for Unified CVP
Step 3
Import the CA root certificate into the Key Database. If the CA is not listed in the Key Database Content > Signer Certificates, then the root certificate of the CA must be imported into this list for the signed certificate to be installed into the database. Click Add, and provide the path of the DER certificate file of the Root CA certificate.
Step 4
Import the signed certificate into the key database. Save the signed certificate from the CA as a DER file format and locate it on the machine in which you will install it into the key database. Then import the signed certificate into the database with the ikeyman utility. Key Database Content > Personal Certificates, click Receive. Provide the path of the signed certificate from the CA.
Set Up SSL
Follow the instructions below to set up SSL.
Step 1
Set IHS_HOME=<location of IBM HTTPServer>; for example, set IHS_HOME=C:\Program Files\IBM\HTTPServer. Modify the %IHS_HOME%\conf\httpd.conf file as follows: Current configuration for HTTP/port 7000:
## ## To enable AFPA on supported Windows Operating Systems delete the "#" symbol in ## front of the "LoadModule ibm_afpa_module modules/mod_afpa_cache.so" directive ## LoadModule ibm_afpa_module modules/mod_afpa_cache.so <IfModule mod_afpa_cache.c> AfpaEnable AfpaCache on AfpaPort 7000 AfpaLogFile "C:/Program Files/IBM/HTTPServer/logs/afpalog" </IfModule></IfModule> ## ## Configuration with AFPA disabled ## <IfModule !mod_afpa_cache.c> Listen 0.0.0.0:7000
Step 2
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
266
Chapter 6: Configuring and Modifying Unified CVP Security HTTPS Support for Unified CVP
# Note: You can use Win32DisableAcceptEx only if mod_afpa_cache.so is disabled. # Win32DisableAcceptEx #</IfModule> LoadModule ibm_ssl_module modules/mod_ibm_ssl.so Listen 0.0.0.0:7443 <VirtualHost 0.0.0.0:7443> SSLEnable SSLClientAuth none KeyFile "c:\Program Files\IBM\HTTPServer\keys\key.kdb" SSLStashfile "c:\Program Files\IBM\HTTPServer\keys\key.sth" ErrorLog "c:\Program Files\IBM\HTTPServer\logs\sslerror.log" TransferLog "c:\Program Files\IBM\HTTPServer\logs\sslaccess.log" </VirtualHost> SSLDisable
Step 3
Open the WebSphere Integrated Solutions Console (http://localhost:9080/ibm/console) and log in, if necessary. Using the WebSphere Integrated Solutions Console, navigate to Servers > Web servers. Delete "webserver1" by selecting and click Delete. (Be sure to click Save to save the configuration when prompted.) Using the WebSphere Integrated Solutions Console, navigate to Environment > Virtual Hosts. Add the port mapping: Hostname = *; Port = 7443. (Be sure to click Save to save the configuration when prompted.) Log out of the WebSphere Integrated Solutions Console. Copy %CVP_HOME%\bin\DefineWebContainer.bat to %CVP_HOME%\bin\DefineWebContainerHTTPS.bat. Edit %CVP_HOME%\bin\DefineWebContainerHTTPS.bat as follows: Current HTTP port definition:
Step 4
Step 5
Step 6 Step 7
Step 8
set PORT=7000
Change to new HTTPS port definition:
set PORT=7443
Step 9
Open up the WebSphere Integrated Solutions Console (http://localhost:9080/ibm/console) and log in, if necessary. Using the WebSphere Integrated Solutions Console, navigate to Servers > Web servers. Click webserver1. Click Plugin properties link. Click Copy to Web server key store directory and then click OK. Click Save to save the configuration when complete.
Step 10
Step 11
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
267
Chapter 6: Configuring and Modifying Unified CVP Security HTTPS Support for Unified CVP
Step 12
After the machine restarts, try to load the standard HTTPServer HTTPS web page; for example, https://localhost:7443/. Try to load the CVP Licensing web page using HTTPS; for example, https://localhost:7443/CVP/Licensing.
Step 13
From the web browser, access the secure Call Server with [https://<ServerIP>:8443/] or the secure VXML Server with [https://<ServerIP>:7443/]. The Security Alert dialog box displays.
Step 2
Step 3
Select the Details tab. <All> will be highlighted in the Show drop-down list.
Step 4
Click Base-64 encoded X.509 (.CER) and then click Next. Specify a file name in the File to Export dialog box and then click Next. Click Finish. An Export was Successful message displays.
Step 8 Step 9
Click OK and close the Security Alert dialog box. Open the exported file in Notepad and copy the text that appears between the ---BEGIN CERTIFICATE-- and --END CERTIFICATE-- tags. You are now ready to copy the Operations Console certificate information to the IOS device.
Step 10
Access the IOS device in privileged EXEC mode. Note: For more information, refer to the Cisco IOS Command-Line Interface documentation.
Step 11
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
268
Chapter 6: Configuring and Modifying Unified CVP Security Securing Sensitive Customer Information
Step 12
Where xxxx is a trustpoint name. The IOS device exits conf t mode and returns to privileged EXEC mode.
Step 13
Do the following to copy the certificate exported to the Notepad to the IOS device: 1. Enter crypto pki auth xxxx. Where xxxx is the trustpoint name specified in the previous step. 2. Paste the certificate from the Notepad clipboard. 3. Enter quit. The following happens: A message displays describing the certificate attributes. A confirmation prompt appears.
Step 14
Enter yes. A message reports that the certificate was successfully imported.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
269
Chapter 6: Configuring and Modifying Unified CVP Security Securing Sensitive Customer Information
See Also See the "Inclusive and Exclusive VoiceXML Filters for Reporting (page 284)" section in Chapter 7, "Configuring VXML Solution," in Part 2 for detailed information about configuring filters.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
270
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
271
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
272
Chapter 7
Configuring VXML Solution
Unified CVP provides a platform for developing powerful, speech-driven interactive applications accessible from any phone. VXML solution consists of: VXML Server, a J2EE-compliant application server that dynamically drives the caller experience. VoiceXML Service, provides Unified ICME with call control capabilities and allows data to be sent to the Reporting Service. Call Studio, a drag-and-drop graphical user interface (GUI) for the rapid creation of advanced voice applications.
Figure 33: Unified CVP's VXML Solution
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
273
Note: This section focuses on how to integrate the Unified CVP solution with other Cisco products. For complete details on how to use the VXML Server software, refer to the User Guide for Cisco Unified CVP VXML Server and Unified Call Studio. This chapter contains the following topics: About VXML Server, page 274 Configuring a VXML Server, page 278 Configuring a VXML Server (Standalone), page 298 Using VXML Server with Unified ICME, page 302 VXML Server (Standalone) Solutions, page 305 Passing Data to Unified ICME, page 317
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
274
Is the connection between the VXML Server and the ICM Service that feeds data to the Reporting Service. In a Standalone Mode with ICM Lookup deployment: Interacts with the VXML Server and the ICM Service to do call control piece Interacts with VXML Server and Reporting Service to populate the Reporting database. Note: For more information, see Using Call Studio's ReqICMLabel Element to Pass Data (page 241).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
275
Note: For more information about Call Studio applications, see the Call Studio documentation.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
276
VRUProgress variable. The setting selected dictates how the transaction will be counted in the aggregate VRU reporting fields in the CallTypeHalfHour table. VRU reporting enhancements are described in the Unified ICME 6.0(0) and later WebView Online Help.
WebView Reporting
This section lists the Unified CVP-related WebView reports that are available when using Unified CVP integrated with VXML Server. Traditional VRU Services Reports persvc20:Peripheral Service for IVR Queue Half Hour Report persvc21:Peripheral Service IVR Queue Daily Report persvc22:Peripheral Service IVR Self-Service Half Hour Report persvc23:Peripheral Service IVR Self-Service Daily Report Caltyp35:VRU Calls Analysis Half Hour Report Caltyp36:VRU Calls Analysis Daily Report periph06:VRU Peripheral Capacity Report
Unified CVP Related Data trkgrp04:Trunks Real Time All Fields Report trkgrp12:Trunks Half Hour All Fields Report trkgrp20:All Port Busy Real Time trkgrp21:IVR Ports Idle & In Service Real Time Report trkgrp22:IVR Ports Status Real Time Ports trkgrp23:IVR Ports Performance Half Hour nettrk03:Network Trunk Group Real Time All Field Report nettrk13:Network Trunk Group Historical All Fields Report Note: Currently, the VXML Server has the following reporting limitations: The VXML Server does not provide any pre-defined reports for Historical reporting
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
277
The VXML Server provides real-time reporting capabilities that help monitor aggregate active sessions associated with a voice application. However, these active sessions cannot be mapped to the actual calls that triggered those sessions.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
278
Collect the hostname or IP address of the VXML Server during the installation of Unified CVP software. Install and configure at least one Call Server before configuring the VXML Server. Note: However, you do not need to install a Call Server if you are adding a VXML Server (standalone). Review Call Studio scripts, noting any of the following items you want to include or exclude from VXML Server reporting data: Application names Element types Element names Element fields ECC variables
Procedure
To add a VXML Server:
Step 1
Choose Device Management > VXML Server. The Find, Add, Delete, Edit VXML Servers window opens. Note: To use an existing VXML Server as a template for creating the new VXML Server, select the VXML Server by clicking the radio button preceding it and then click Use As Template.
Step 2
Click Add New. The VXML Server Configuration window opens to the General Tab.
Step 3 Step 4
Fill in the IP Address and Hostname fields and choose a primary Call Server. Select each tab and verify that the default values are correct or change the values if desired: Configuration tabs: Configuring VXML Server Properties (page 283) Adding or Removing a Device From a Device Pool (page ?) Configuring the Infrastructure (page ?)
Step 5
When you finish configuring the VXML Server, click Save to save the settings in the Operations Console database. Click Save & Deploy to apply the changes to the VXML Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
279
Step 6
Shut down and then start the VXML Server and the primary and backup Call Servers.
See Also Configuring General VXML Server Information (page 282) Configuring VXML Server Properties (page 283) Viewing Infrastructure Settings (page 331) Adding or Removing a Device From a Device Pool (page ?) Shutting Down a Server (page ?) Starting a Server (page ?)
Procedure
To edit a VXML Server configuration:
Step 1
Choose Device Management > VXML Server. The Find, Add, Delete, Edit VXML Servers window opens.
Step 2
You can search for a VXML Server by using the procedure in the Finding a VXML Server topic. From the list of matching records, choose the VXML Server that you want to edit. Click Edit. The VXML Server Configuration window opens to the General Tab.
Step 3 Step 4
Change any general server information. You cannot change the IP address of the VXML Server. Select the Configuration Tab, then edit VXML Server properties. Optionally, select the Device Pool tab and add or remove the VXML Server from a device pool. Optionally, select the Infrastructure tab and configure log file and syslog settings. When you finish configuring the VXML Server, click Save to save the settings in the Operations Server database. Click Save & Deploy to apply the changes to the VXML Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
280
Step 10
If instructed, shut down and then start the VXML Server and the primary and backup Call Servers.
See Also Deleting a VXML Server (page 281) Adding a VXML Server (page 278) Configuring VXML Server Properties (page 283) Configuring Unified CVP General Server Information (page 282) Finding a VXML Server (page 294) Shutting Down a Server (page ?) Starting a Server (page ?) Viewing Device State (page ?)
Procedure
To delete a VXML Server from the Control Center:
Step 1
Choose Device Management > VXML Server. The Find, Add, Delete, Edit VXML Servers window displays.
Step 2
From the list of matching records, choose the VXML Server that you want to delete by clicking the radio button preceding it. Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation. Shut down and start the VXML Server and the primary and backup Call Servers.
Step 3 Step 4
Step 5
281
Transferring Files to a VXML Server (page 288) Shutting Down a Server (page ?) Starting a Server (page ?) Finding a VXML Server (page 294)
Field
Description
Default
Range
Restart/Reboot Needed
General IP Address Hostname The IP address of the VXML Server None A valid IP address No The host name of the VXML Server. None Host names must be valid DNS names, which can include letters in the alphabet, the numbers 0 through 9, and a dash. The description of the VXML Server None A valid DNS name, No which includes uppercase and lowercase letters in the alphabet, the numbers 0 through 9, and a dash Up to 1,024 characters On or Off No Yes - reboot
Select to enable secure communications None between the Operations Server and this component. The device is accessed using SSH and files are transferred using HTTPS. You must configure secure communications before you enable this option. See Chapter 6 in the Configuration and Administration Guide for Cisco Unified Customer Voice Portal.
Call Servers Primary Call Server The VXML Server uses the message None service on this Call Server to communicate with the Reporting Server and to perform an ICM lookup. Select a primary Call Server from the drop-down list. The drop-down list includes all Call Servers added to the Operations Console. Not applicable Yes - Restart Call Server and VXML Server
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
282
Field
Description
Default
Range
Restart/Reboot Needed
None Backup Call Server The VXML Server uses the message service on this Call Server to communicate with the Reporting Server and perform an ICM lookup if the Primary Call Server is unreachable. Select a backup Call Server from the drop-down list. The drop-down list includes all Call Servers added to the Operations Console.
Not applicable
Field
Description
Default
Range
Restart/Reboot Needed
Configuration Enable Reporting for this VXML Server Indicates whether or not the VXML Enabled Server sends data to the Reporting Server. If disabled, no data is sent to the Reporting Server and reports will not contain any VoiceXML application data. Indicates whether or not VoiceXML Disabled application details are reported. The maximum size of reporting 100,000 messages that are saved in a memory buffer if a failover occurs and the Call Server is unreachable. The level of transmission quality and service availability for the VXML Server. cs3 Enabled (the default) or Disabled. No
QoS Select QoS Level The drop-down list has the Yes - Restart following values: af11, VXML Server af12, af13, af21, af22,
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
283
Field
Description
Default
Range
Restart/Reboot Needed
Note: For more information, see Implementing Quality of Service Policies with DSCP (Document ID: 10103) at http://www.cisco.com/ warp/public/105/dscpvalues.html.
af23, af31, af32, af33, af41, af42, af43, cs1, cs2, cs3, cs4, cs5, cs6, cs7,default, ef Note: The default QoS setting for the VXML Server is CS2.
VXML Applications Details: Filters Inclusive Filters List of applications, element types, None element names, and element fields, and ECC variables to include in reporting data. A semicolon-separated list Yes - Restart of text strings. A wildcard VXML Server character (*) is allowed within each element in the list. Note: For more information about filter syntax and rules, see Inclusive and Exclusive VoiceXML Filters for Reporting (page 286). Exclusive Filters List of applications, element types, None element names, and element fields, and ECC variables to exclude from reporting data. A semicolon-separated list Yes - Restart of text strings. A wildcard VXML Server character (*) is allowed within each element in the list. Note: For more information about filter syntax and rules, see Inclusive and Exclusive VoiceXML Filters for Reporting (page 286).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
284
Procedure
To configure inclusive and exclusive filters for a Reporting Server:
Step 1
Choose Device Management > VXML Server. The Find, Add, Delete, Edit VXML Servers window opens.
Step 2
You can search for a VXML Server by using the procedure in the Finding a VXML Server topic. From the list of matching records, choose the VXML Server that you want to edit. Click Edit. The VXML Server Configuration window opens to the General Tab.
Step 3 Step 4
Step 5 Step 6
Select the Configuration Tab, then configure VXML Server properties. In the VXML Applications Details: Filters pane, enter an inclusive filter that defines the VoiceXML elements to include in data sent to the Reporting Server. Optionally, enter an exclusive filter that excludes some of the data specified by the inclusive filter. When you finish configuring filters, click Save to save the settings in the Operations Console database or click Save & Deploy to save and apply the changes to the VXML Server. Shut down and then start the VXML Server and the primary and backup Call Servers.
Step 7
Step 8
Step 9
See Also Rules for VoiceXML Inclusive and Exclusive Filters (page 285) Examples of VoiceXML Filter Wildcard Matching (page 286) Examples of Inclusive and Exclusive VoiceXML Filters for Reporting (page 286)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
285
The Exclusive Filter takes precedence over the Inclusive Filter. For example, if an application name is in the Exclusive Filter, then all of the items of that applications are excluded from reporting data even if a particular field or element is listed in the Inclusive filter. The syntax for Inclusive/Exclusive filters is:
Appname.ElementType.ElementName.FieldName
or
AppName.*.*.SESSION:Varname
Note: This syntax is used to indicate session variables. A semicolon (;) should be used to separate each item in a filter. For example, ElementA ; ElementB is valid. A single wildcard (*) can be specified anywhere within the application name, element type, element name, or field name. Element types, element names, and field names can contain alphanumeric characters, underscores, and a space character. An application name can contain alphanumeric characters and underscores, but the space character is not allowed. For example, A_aa.B_bb.*C_cc_DD.E_ee_F* is valid.
Filter
What It Matches
Matches all voice elements in MyApplication Matches all Voice elements in all applications. Matches all fields in MyApplication that start with with the string var. Matches all fields in MyApplication that end with 3. Matches the Company session variable in MyApplication.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
286
Table 40: Examples of Inclusive and Exclusive VoiceXML Filters for Reporting
Exclusive Filter
None
*.*.Element1.*; *.*.Element2.*
All Application1 data All Application1 data, except Element1 and Element2 All Application1 data, except Element1, Element2, and Field1
Application1.*.*.*
Application1.*.*.* *.*.Element1.*; *.*.Element2.*; *.*.*.Field1 *.Voice.*.* which matches Element1, Element2, Element3, and Element4 *.Voice.*.* which matches Element1 and Element2 *.*.Element1.* *.*.Element1.* *.*.*.Field1
All Application1 data, except Element3 and Element4 No data for Application1. Other Data for other applications, such as Application2, which contain Element1, Element2 and Field1, will be fed. Only Element1 and Element2 and all applications. Element1 and Element2, except for Field1, if it exists in those elements Element1 Element1, except for Field1 if it exists in Element1 Field1 in any elements except Element3 and Element4
None
*.*.*.Field1 *.*.Element3.*; *.*.Element4.*
A good strategy for using filters is to create an Inclusive filter that includes the data you want to save in the Reporting database and then create an Exclusive filter to exclude portions of the data, for example, sensitive security information such as Social Security Numbers. For example. you would First, create an inclusive filter to include all information:
MyApp.Voice.*.*
Then, create an exclusive filter to remove credit card and social security numbers information:
MyApp.Voice.*.CreditCard; MyApp.voice.*.SSN
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
287
Procedure
To transfer a script file:
Step 1
From the Device Management menu, choose the type of server to which to transfer the script file. For example, to transfer a script file to a VXML Server, choose Device Management > VXML Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
288
The Find, Add, Delete, Edit window lists any servers that have been added to the Operations Console.
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit. Select File Transfer in the toolbar and then click Scripts. The Script File Transfer page opens, listing the host name and IP address for the selected device. Script files currently stored in the Operations Server database are listed in the Select From available Script Files box.
Step 3
Step 4
If the script file is not listed in the Select From Available Script Files box:
a. b.
Click Select a Script File from Your Local PC. Enter the file name in the text box or click Browse to search for the script file on the local file system.
Step 5 Step 6
If the script file is listed in the Select From Available Script Files box, select the script file. Click Transfer to send the file to the device. The script file is transferred to the selected server.
Procedure
To download a Log Messages XML file from the Operations Console to a Unified CVP Server:
Step 1
From the Device Management menu, choose the type of server from which you want to download a syslog XML file. For example, to download a file to a VXML Server, choose Device Management > VXML Server. The Find, Add, Delete, Edit window lists any servers that have been added to the control panel.
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
289
Step 3
Select File Transfer in the toolbar and then click Log Messages XML File Download. The Log Messages XML Download dialog box displays.
Step 4
Click Download to transfer the XML file to the server. A message indicates that this operation might take some time. Click OK to continue with the download or click Cancel to cancel the download.
See Also Uploading a Log Messages XML File (page 291) Editing the Log Messages XML File (page 290)
Identifies the event type described in the CVPLogMessagesRes.properties file. Identifies the message text described in the CVPLogMessagesRes.properties file. Identifies the severity level (page 291) of the event. Set to true, to send this message, when logged, to an SNMP manager, if one is configured. Set to true to send this message, when logged, to a Syslog server, if one is configured. Set to true to identify this message, when logged, as an SNMP raise event, which the SNMP management
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
290
Message Element
Possible Values
What it Means
station can use to initiate a task or automatically take an action. Set to false to identify this message as an SNMP clear when sent to an SNMP management station. An SNMP clear event usually corresponds to an SNMP raise event, indicating that the problem causing the raise has been corrected. An administrator on an SNMP management station can correlate SNMP raise events with SNMP clear events.
0 1 2 3 4 5 6
System or service is unusable Action must be taken immediately Critical condition, similar to ALERT, but not necessarily requiring an immediate action An error condition that does not necessarily impact the ability of the service to continue to function A warning about a bad condition, which is not necessarily an error Notification about interesting system-level conditions, which are not errors Information about internal flows or application or per-request information, not system-wide information
Procedure
To upload a Log Messages XML file from a Unified CVP Server to the Operations Console:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
291
Step 1
From the Device Management menu, choose the type of server to which you want to upload a syslog XML file. For example, to upload a file to a VXML Server, choose Device Management > VXML Server. The Find, Add, Delete, Edit window lists any servers that have been added to the control panel.
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit. Select File Transfer in the toolbar and then click Log Messages XML File Upload. The Log Messages XML Upload page displays.
Step 3
Step 4
In the Select a Log Messages XML file from your local PC text box, enter a file name or click Browse and search for the file on your local system. Click Upload to transfer the selected file to the Unified CVP Server. Shut down and then start the corresponding Unified CVP Server.
Step 5 Step 6
See Also Downloading a Log Messages XML File (page 291) Editing the Log Messages XML File (page 290) Shutting Down a Server (page ?) Starting a Server (page ?)
Procedure
To apply a license file:
Step 1
Choose Device Management > VXML Server. The Find, Add, Delete, Edit VXML Server window lists any servers that have been added to the Operations Console.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
292
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit. Select File Transfer in the toolbar and then click Licensing. The File Transfer page displays, listing the Hostname and IP Address for the currently selected VXML Server.
Step 3
Step 4
If the license file is not listed in the Select From Available License Files text box:
a. b.
Click Select a License File from Your Local PC. Enter the file name in the text box or click Browse to search for the license file on the local file system.
Step 5 Step 6
If the license is listed in the Select From Available License Files text box, select the license file. Click Transfer to transfer the selected license file to the selected device. The license is applied to the selected server.
Procedure
To get the System ID for a VXML Server:
Step 1
Choose Device Management > VXML Server. The Find, Add, Delete, Edit VXML Servers window opens.
Step 2 Step 3
From the list of matching records, choose the VXML Server that you want to edit. Click Edit. The VXML Server Configuration window opens to the General Tab.
Step 4 Step 5
Select System Id from the toolbar. Click OK when the confirmation message is displayed. The System ID for the VXML Server will be displayed.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
293
See Also Adding a VXML Server (page 278) Editing a VXML Server (page 280) Deleting a VXML Server (page 281) Finding VXML Server (page 294) Applying a License to a VXML Server (page 292)
Procedure
To find a VXML Server:
Step 1
Choose Device Management > VXML Server from the Main menu. The Find, Add, Delete, Edit VXML Servers window lists the available VXML Servers, 10 at a time, sorted by name.
Step 2 Step 3
If the list is long, click Next to view the next group of available VXML Servers. If you know the exact name of a particular VXML Server, enter the name in the Search text box and then click Go. Note: Basic Search is not case sensitive, and wildcard characters are not allowed. If the Search text box is empty, all VXML Servers are listed.
Step 4
To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
294
Procedure
This section describes how to specify a primary and backup Call Server for the VXML Server.
Step 1 Step 2 Step 3
Open the Operations Console. Choose Device Management > VXML Server. Click Add New or select an existing VXML Server name and click Edit. The General tab displays.
Select the Primary Call Server from the drop-down list. Select the Backup Call Server from the drop-down list. Click Save to save the settings in the Operations Server database and click Save & Deploy to apply the changes to the VXML Server. Restart the VXML Server and the Call Servers..
Step 7
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
295
Whenever this security setting is modified, you must restart the Cisco CVP Resource Manager service on the machine where the device is running.
Procedure
This section describes how to enable security for the VXML Server.
Step 1 Step 2 Step 3
Open the Operations Console. Choose Device Management > VXML Server. Click Add New or select an existing VXML Server name and click Edit. The General tab displays.
Step 4 Step 5
Select the Security On checkbox. Click Save to save the settings in the Operations Server database and click Save & Deploy to apply the changes to the VXML Server. Restart the VoiceXML Service.
Step 6
From Operations Console. Choose Device Management > VXML Server. Click Add New or select an existing VXML Server name and click Edit. Select the Configuration Tab and use the Inclusive Filters and Exclusive Filters fields to specify the list of applications, element types, element names, element fields, and ECC variables to include and exclude from reporting data. For information, see Rules for VoiceXML Inclusive and Exclusive Filters (page 285) and Examples of Inclusive and Exclusive VoiceXML Filters for Reporting (page 286).
Step 5 Step 6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
296
Open the Operations Console. Choose Device Management > VXML Server. Click Add New or select an existing VXML Server name and click Edit. Select the Configuration Tab and set the following: Click the Yes button to Enable reporting for this VXML Server. Indicates whether or not the VXML Server sends data to the Reporting Server. If disabled, no data is sent to the Reporting Server and reports will not contained any VoiceXML application data. Click the Yes button to Enable reporting for VXML application details. Indicates whether or not VoiceXML application details are reported. Specify a Max. Number of Messages to save in a file if failover occurs and the Reporting Server is unreachable. Limited by the amount of free disk space.
Step 5 Step 6
Click Save. Restart the VoiceXML Service and the Call Server.
Procedure
This section describes how to configure QoS settings for the VXML Server.
Step 1 Step 2 Step 3 Step 4
Open the Operations Console. Choose Device Management > VXML Server. Click Add New or select an existing VXML Server name and click Edit. Select the Configuration Tab and use the drop-down list to choose a Select QoS Level. Note: For more information, see the Enterprise QoS Solution Reference Network Design Guide.
Step 5 Step 6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
297
Procedure
To add a VXML Server (standalone):
Step 1
Choose Device Management > VXML Server (standalone). The Find, Add, Delete, Edit VXML Servers (Standalone) window opens. Note: To use an existing VXML Server (standalone) as a template for creating the new VXML Server (Standalone), select the VXML Server (standalone) by clicking the radio button preceding it and then click Use As Template.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
298
Step 2
Click Add New. The VXML Server (Standalone) Configuration window opens to the General Tab.
Step 3
Fill in the IP address and hostname and an optional description for the VXML Server. Note: Hostnames must be valid DNS names, which can include letters in the alphabet, the numbers 0 through 9, and a dash.
Step 4 Step 5
Optionally, select the Device Pool Tab and add the server to a device pool. When you finish configuring the VXML Server (standalone), click Save to save the settings in the Operations Console database. Click Save & Deploy to apply the changes to the VXML Server (standalone).
See Also Deleting a VXML Server (Standalone) (page 300) Editing a VXML Server (Standalone) (page 299) Finding a VXML Server (Standalone) (page 301) Adding and Removing Devices from a Device Pool (page ?) Viewing Device State (page ?)
Choose Device Management > VXML Server (standalone). The Find, Add, Delete, Edit VXML Servers (Standalone) window opens.
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit. The VXML Server (Standalone) Configuration window opens to the General Tab.
Step 3 Step 4
Make the desired changes. You can change the IP address or assign the server to a device pool. When you finish configuring the VXML Server, click Save to save the settings in the Operations Console database. Click Save & Deploy to apply the changes to the VXML Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
299
See Also Deleting a VXML Server (Standalone) (page 300) Adding a VXML Server (Standalone) (page 298) Finding a VXML Server (Standalone) (page 301) Getting the System ID for a VXML Server (Standalone) (page 302) Transferring Script Files (page 288) Applying a License to a VXML Server (page 292) Adding and Remove a device from a device pool (page ?) Viewing Device State (page ?)
Procedure
To delete a VXML Server (standalone):
Step 1
Choose Device Management > VXML Server (standalone). The Find, Add, Delete, Edit VXML Servers (Standalone) window opens.
Select the VXML Server that you want to delete by clicking the radio button preceding it. Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
See Also Adding a VXML Server (Standalone) (page 298) Editing a VXML Server (Standalone) (page 299) Finding a VXML Server (Standalone) (page 301)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
300
Procedure
To find a VXML Server (standalone):
Step 1
Choose Device Management > VXML Server (standalone) from the Main menu. The Find, Add, Delete, Edit VXML Servers (Standalone) window lists the available VXML Servers (standalone), 10 at a screen, sorted by name.
Step 2 Step 3
If the list is long, click Next to view the next group of available VXML Servers. If you know the exact name of a particular VXML Server, enter its hostname in the Search text box and then click Go. Note: Basic Search is not case sensitive, and wildcard characters are not allowed. If the Search text box is empty, all VXML Servers (standalone) are listed.
Step 4
To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with is exactly is empty
Step 6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
301
Chapter 7: Configuring VXML Solution Using VXML Server with Unified ICME
See Also Adding a VXML Server (Standalone) (page 298) Editing a VXML Server (Standalone) (page 299) Deleting a VXML Server (Standalone) (page 300)
Procedure
To get the System ID for a VXML Server (standalone):
Step 1
Choose Device Management > VXML Server (standalone). The Find, Add, Delete, Edit VXML Servers (Standalone) window opens.
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit. The VXML Server (Standalone) Configuration window opens to the General Tab.
Step 3 Step 4
Select System ID from the toolbar. Click OK when the confirmation message is displayed. The System ID for the VXML Server will be displayed.
See Also Deleting a VXML Server (Standalone) (page 300) Adding a VXML Server (Standalone) (page 298) Editing a VXML Server (Standalone) (page 299) Finding a VXML Server (Standalone) (page 301) Transferring Script Files (page 288)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
302
Chapter 7: Configuring VXML Solution Using VXML Server with Unified ICME
Specify the URL (remove and port number) of the VXML Server that you want to reach, for example:
http://12.34.567.890:7000/CVP/Server?application=HelloWorld
In the example above, 12.34.567.890 is the IP address of the VXML Server, 7000 is the port number, and the application name is HelloWorld. The values are delimited by a colon (:). Note: 7000 is the default port number for a VXML Server. The new port for Unified CVP 4.0 and later is 7000 for both Tomcat and WebSphere with VXML Server.
Step 2
In the Unified ICME script, first set the media_server ECC variable to http://
12.34.567.890:7000/CVP
Step 3 Step 4
Set the app_media_lib ECC Variable to "..", (literally two periods in quotes) Set the user.microapp.ToExtVXML[0] ECC variable to application=HelloWorld. Note: This example indicates that the VXML Server will execute the HelloWorld application. To execute a different application, change the value of user.microapp.ToExtVXML[0] accordingly.
Step 5 Step 6
Set the UseVXMLParams ECC Variable to "N." Create a Run External Script node within the Unified ICME script with a VRU Script Name value of GS,Server,V. Note: Remember to link this node to the nodes configured in previous steps. The timeout value set in the Network VRU Script should be substantially greater than the length of the timeout in the VXML Server application. This timeout should only be used for recovery from a failed VXML Server. Aways leave the Interruptible checkbox in the Network VRU Script Attributes tab checked; otherwise, calls queued to a VXML Server application might stay in the queue when an agent becomes available.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
303
Chapter 7: Configuring VXML Solution Using VXML Server with Unified ICME
Step 7
After you configure the Unified ICME script, you need to configure a corresponding VXML Server script with Call Studio. The VXML Server script must: Begin with a Subdialog_Start element (immediately after the Call Start element) Contain a Subdialog_Return element on all return points (script must end with a Subdialog_Return element) The Subdialog_Return element must include a value for the call input To enable reporting, you must add Data Feed/SNMP loggers
In the Unified ICME script, use the formula editor to set ToExtVXML[1]. Set the value of ToExtVXML[1] variable to concatenate("callid=",Call.user.media.id) Note: Always include "callid" when sending the call to the VXML Server using the Comprehensive call flow model. The Call ID can also be used in VXML Server (standalone) solutions. When you concatenate multiple values, use a comma for the delimiter; for example,
concatenate("ICMInfoKeys= ",Call.RouterCallKey,"-",Call.RouterCallDay,"-",Call.RouterCallKeySequenceNumber).
Refer to the "Passing Information to the External VoiceXML (page 230)" section in Chapter 4, "Writing Scripts for Unified CVP," for more information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
304
This is returned if the application server is unavailable (shutdown, network connection disabled, and so forth) Error Code 41 -- App Error This is returned if some VXML Server-specific error occurs (For example, java exception). Error Code 42 -- App Hangup This is returned to Unified CVP if the Hang Up element is used without being preceded by a Subdialog_Return element. Note: If the application is configured correctly, this should not occur. Error Code 43 -- Suspended This is returned if the VXML Server application is suspended. Error Code 44 -- No Session Error This is returned when an emergency error occurs (for example, an application is called that has not been loaded in the VXML Server application). Error Code 45 -- Bad Fetch This is returned when the VXML Server encounters a bad fetch situation. This code is returned when either a .wav file or an external grammar file is not found.
Configuring the VXML Server (Standalone) with ICM Lookup Call Flow Model
To configure the VXML Server (standalone) with ICM Lookup call flow model, do the following:
Step 1
Copy the following files from the VXML Server CD to the gateway flash memory using tftp: CVPSelfService.tcl
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
305
Define the VXML Server applications on the gateway. The following shows an example configuration:
service CVPSelfService flash:CVPSelfServiceBootstrap.vxml paramspace english index 0 paramspace english language en paramspace english location flash: paramspace english prefix en ! service [gateway application name] flash:CVPSelfService.tcl paramspace english index 0 paramspace english language en param CVPBackupVXMLServer 12.34.567.890 paramspace english location flash: param CVPSelfService-port 7000 param CVPSelfService-app [name of application on the VXML Server, exactly how it appears] paramspace english prefix en param CVPPrimaryVXMLServer 12.34.567.890
Note: CVPSelfService is required. Backup server is optional. For both the Tomcat Application Server and the WebSphere Application Server, set the port to 7000. After completing the gateway configuration, run the following to load and activate the applications:
call application voice load CVPSelfService call application voice load [gateway application name]
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
306
Step 3
Step 4 Step 5
Optionally, create another dial peer to do transfers using the Unified ICME label that is returned. Create the application in Call Studio. In the Call Studio application, the ReqICMLabel has two exit states: error and done. The done path grabs a transfer element to transfer the caller to that label. The gateway needs another dial peer to transfer the label it gets from this process (see previous step). If you want to do real transfers, you must have the transfer element set up inside the Call Studio application. Drag the ReqICMLabel element onto the application created in Call Studio and configure it. Note: This step is necessary to obtain a label from Unified ICME. For more information, see Using Call Studio's ReqICMLabel Element to Pass Data (page 241).
Step 6
Step 7
Save and deploy the application from Call Studio using the VoiceXML Service on the Operations Console. Install the Call Server; select only the Core Software component. Configure the VXML Server to communicate with the Call Server through the Operations Console. See the "Configuring a VXML Server (page 278)" section. Transfer the application using File Transfer to the VXML Server. This will automatically deploy the application on the selected VXML Server.
Step 8 Step 9
Step 10
See Also Refer to the Call Studio documentation for complete instructions.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
307
Configuring the VXML Server (Standalone) Call Flow Model (without ICM Lookup)
To configure the VXML Server (Standalone) call flow model, do the following:
Step 1
Copy the following files from the VXML Server CD to the gateway flash memory using tftp: CVPSelfService.tcl critical_error.wav For example:
copy tftp: flash:CVPSelfService.tcl copy tftp: flash:CVPSelfServiceBootstrap.vxml copy tftp: flash:critical_error.wav
Step 2
Define the VXML Server applications on the gateway. The following shows an example configuration:
service CVPSelfService flash:CVPSelfServiceBootstrap.vxml paramspace english index 0 paramspace english language en paramspace english location flash: paramspace english prefix en ! service [gateway application name] flash:CVPSelfService.tcl paramspace english index 0 paramspace english language en param CVPBackupVXMLServer 12.34.567.890 paramspace english location flash: param CVPSelfService-port 7000 param CVPSelfService-app [name of application on the VXML Server, exactly how it appears] paramspace english prefix en param CVPPrimaryVXMLServer 12.34.567.890
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
308
Note: CVPSelfService is required. Backup server is optional. For both the Tomcat Application Server and the WebSphere Application Server, set the port to 7000. After completing the gateway configuration, run the following to load and activate the applications:
call application voice load CVPSelfService call application voice load [gateway application name] Step 3
Step 4
Create the application in Call Studio. This application must have the same name as the CVPSelfService-app defined in the gateway configuration above.
Step 5
If: If there is an operations console Then: Save and deploy the Call Studio application locally; create a VXML Server (Standalone) configuration; and upload and transfer the application script file to the desired VXML Server. If: there is not an operations console Then: Save and Deploy the Call Studio Application to the desired installed VXML Server. Then, on the VXML Server, run the deployallapps.bat file (c:/Cisco/CVP/VXMLServer/admin directory) .
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
309
See Also Refer to the Call Studio documentation for complete instructions.
application service CVPSelfService flash:CVPSelfServiceBootstrap.vxml paramspace english language en paramspace english index 0 paramspace english location flash: paramspace english prefix en service HelloWorld flash:CVPSelfService.tcl paramspace english language en paramspace english index 0 paramspace english location flash param CVPBackupVXMLServer 12.34.567.890 paramspace english prefix en param CVPSelfService-app HelloWorld param CVPSelfService-port 7000 param CVPPrimaryVXMLServer 12.34.567.890 dial-peer voice 4109999 voip /* for IP originated call */ service HelloWorld incoming called-number 88844410.. dtmf-relay rtp-nte h245-signal h245-alphanumeric codec g711ulaw dial-peer voice 4109999 voip /* for TDM originated call */ service HelloWorld incoming called-number 88844420.. direct-inward-dial
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
310
Two B-Channel Transfer (TBCT) - A call transfer standard for ISDN interfaces. This feature enables a Cisco voice gateway to request an NI-2 switch to directly connect two independent calls. The two calls can be served by the same PRI or by two different PRIs on the gateway. Hookflash Relay - A brief interruption in the loop current that the originating call entity (PBX or Public Switch Telephone Network switch) does not interpret as a call disconnect. Instead, once the PBX or Public Switch Telephone Network switch senses the hookflash, it puts the current call on hold and provides a secondary dial tone, which allows Unified CVP to transfer the caller to another destination. SIP Refer - VoiceXML applications can use a SIP REFER transfer instead of a blind or bridged transfer. This allows Unified CVP to remove itself from the call, thus freeing up licensed Unified CVP ports. Unified CVP cannot execute further call control or IVR operations after this kind of label has been executed.
Configure the originating gateway for TBCT call transfer, by following the instructions in "Configuring the Gateway for Two B-Channel Transfer (TBCT) (page 449)." Locate the following files on the VXML Server and copy them to flash memory on the gateway, using the tftp command: en_error.wav en_holdmusic.wav en_pleasewait.wav survivability.tcl CVPSelfService.tcl CVPSelfServiceBootstrap.vxml
Step 2
Step 3
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
311
Note: CVPSelfService is required. Backup server is optional. For both the Tomcat Application Server and the WebSphere Application Server, set the port to 7000.
Step 5
Step 6
Specify the target destination for the TBCT transfer either by entering the number manually, or dynamically by using caller input.
a.
Manually. In the SubdialogReturn node in the VXML Server application, next to Caller Input in the Settings Tab, enter TBCT<target_destination_number>, where target_destination_number is the target destination of the TBCT transfer. For example:
TBCT8005551212
b.
Dynamically. The target destination is created dynamically using input entered by the caller during the call. To do this, click the Substitution icon next to the Caller Input variable and select substitution values. For example:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
312
Step 7
In the event that the TBCT fails (for example, bad number, bad gateway config, etc.), you can specify alternate transfer targets under the survivability service according to survivability rules as defined in the "Call Survivability (page 423)" section in Chapter 19, "Configuring the H.323 Devices and VoIP," in Part 3.
Configure the originating gateway for Hookflash Relay call transfer, by following the instructions in the "Configuring the Gateway for Hookflash Relay (page 447)" section in Chapter 18, "Transferring and Queuing Calls with Unified CVP," in Part 3.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
313
Step 2
Locate the following files on the VXML Server and copy them to flash memory on the gateway. en_error.wav en_holdmusic.wav en_pleasewait.wav survivability.tcl en_0.wav en_1.wav en_2.wav en_3.wav en_4.wav en_5.wav en_6.wav en_7.wav en_8.wav en_9.wav en_pound.wav en_star.wav
Step 3
Step 4
If you have not already done so, configure the CVPSelfService application as follows:
service [gateway application name] flash:CVPSelfService.tcl paramspace english index 0 paramspace english language en param CVPBackupVXMLServer 12.34.567.890 paramspace english location flash:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
314
param CVPSelfService-port 7000 param CVPSelfService-app [name of application on the VXML Server, exactly how it appears] paramspace english prefix en param CVPPrimaryVXMLServer 12.34.567.890
Note: CVPSelfService is required. Backup server is optional. For both the Tomcat Application Server and the WebSphere Application Server, set the port to 7000.
Step 5
Step 6
In the SubdialogReturn node in your VXML Server application, next to Caller Input in the Settings Tab, enter HF8005551212, replacing 8005551212 with the target destination of the hookflash transfer. The label can also be defined dynamically using digits entered by the caller in conjunction with the VXML Server substitution tags. If the switch requires a pause after the hookflash, commas can be inserted between the HF and the transfer number. Each comma represents 100ms.
Configure the gateway according to either "Configuring the VXML Server (Standalone) Call Flow Model (without ICM Lookup) (page 308)" or "Configuring the VXML Server (Standalone) with ICM Lookup Call Flow Model (page 305)," whichever is appropriate for the implementation. Note: The incoming dial-peer running the CVPSelfService application must be a voip dial-peer, not a pots dial-peer. Additionally, the IOS image that is used must contain the IPIPGW feature. SIP REFER will not work with the IPIPGW feature.
Step 2
Specify the target destination for the refer transfer in the Call Studio application either by entering the number manually, or dynamically using caller input.
a.
Manually. In the SubdialogReturn node in the VXML Server application, next to CallerInput in the Settings tab, enter RF<target_destination_number>, where target_destination_number is the target destination of the REFER transfer; for example, RF8005551212.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
315
b.
Dynamically. The target destination is created dynamically using input entered by the caller during the call. To do this, click the Substitution icon next to the Caller Input variable and select the substitution values.
To configure the number dialed from the TDM phone to match, use the following configuration:
dial-peer voice [dialpeer name] pots service [gateway application name] incoming called-number [number dialed from phone] direct-inward-dial
Step 2
To configure the number dialed from the IP phone to match, use the following configuration:
dial-peer voice [dialpeer name] voip service [gateway application name] incoming called-number [number dialed from phone] dtmf-relay rtp-nte h245-signal h245-alphanumeric codec g711ulaw
Step 3
To configure the transfer node to transfer to a specific extension (for example, 5080001): Note: The gateway sends the call to Unified CM as a blind transfer.
dial-peer voice [dialpeer name] voip destination-pattern 508.... session target ipv4:[call manager subscriber IP] dtmf-relay rtp-nte h245-signal h245-alphanumeric codec g711ulaw no vad
Step 4
To hear a ring tone on a blind transfer call, do the following: Select Service > Service Parameters in Cisco Unified Communications Manager. Select your server and the Unified CM Service.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
316
Set the Send H225 User Info Message setting to H225 Info for Call Progress Tone.
Start the VXML Server. The VXML Server starts the VoiceXML Service using the DataFeed mechanism or the ReqICMLabel element. The ReqICMLabel element allows a Call Studio script to pass caller input, call variables, and External Call Context (ECC) variables to a Unified ICME script. The ReqICMLabel must be inserted into a Call Studio script as a decision element. In Call Studio, the returned Unified ICME label contains a result which can be used by other elements in the same application, such as the Transfer or Audio element. The Transfer element sends instructions to the IOS Voice Browser to transfer the caller to the desired location. Once the VoiceXML Service starts, it begins communicating with the ICM Service.
From the Operations Console, add a Call Server. On the General tab, enable the ICM Service by clicking the ICM checkbox. On the ICM General Configuration tab, specify the VRU Connection Port (by default this value is 5000). This is the port on which the ICM Service listens for a connection from the VRU PIM upon startup of the Call Server. Note: Refer to the Unified ICME documentation for instructions on configuring the VRU PIM to connect to a VRU (for example, Unified CVP).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
317
Step 5
Set up the following items in Unified ICME: Dialed Number (DN), customer records which must match the Network VRU, call type, and a script.
When setting up the script, be aware that only the following script nodes are allowed: Label Select node LAA and MED agents Caution: The Run External Script node and queuing are not allowed. See Also Refer to the Unified ICME documentation located at the documentation web page (http:// www.cisco.com/en/US/products/sw/custcosw/ps1001/tsd_products_support_series_home.html) for more information.
Configure the gateway to send the call to a particular VXML Server application, as follows:
dial-peer voice 8888 voip service [gateway application name] incoming called-number 888800.... dtmf-relay rtp-nte h245-signal h245-alphanumeric codec g711ulaw no vad
Step 2
To match the number in the VXML Server transfer node and send it out the T1 port to the G3 to its destination, use the following configuration:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
318
dial-peer voice 8880 pots destination-pattern 888800.... incoming called-number direct-inward-dial port 1/0:D
Configure the IPIPGW to transport calls to and from Unified CM. Configure Unified CM with the Media termination point (MTP) enabled. MTP enables Unified CM to extend supplementary services, such as hold and transfer, to calls that are routed through an H.323 endpoint or an H.323 gateway.
See Also For detailed information on configuring the Cisco IOS gateway for Unified CM connections, refer to the Cisco Multiservice IP-to-IP Gateway Software documentation. For detailed information on configuring MTP on Unified CM, refer to the Unified CM documentation.
To view CVPSNMPLogger for the VXML Server, access the Call Studio interface. Right-click the application and select Properties > Cisco Unified CVP > General Settings from Call Studio for each Call Studio application. CVPSNMPLogger displays in the Loggers list box.
Caution: Do not remove CVPSNMPLogger. Doing so will disable viewing of SNMP events and alerts.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
319
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
320
Chapter 8
Configuring Unified CVP Logging and Event Notifications
Unified CVP provides information about component device status and interaction through: Logs, which are presented in text format and can be viewed using Cisco Support Tools. Statistics, which can be viewed using the Unified CVP Operations Console. This chapter also provides information about SNMP alerts for Cisco Unified Presence Server (CUP) (page 349) and CVP SNMP-Raise/Clear Mappings (page 349). This chapter contains the following topics: Using Syslog, page 321 Using Logs to Interpret Events, page 322 VoiceXML Logs, page 325 About Event Statistics, page 329 SNMP Alerts for Cisco Unified Presence Server (CUP), page 349 Unified CVP SNMP-Raise/Clear Mappings, page 349
Using Syslog
Unified CVP allows you to configure primary and backup syslog servers; however, it is important to note that failover from primary to backup server is not guaranteed. When the primary syslog server goes down (that is, the entire machine, not just the syslog receiver application), Unified CVP relies on the host operating system and the Java Runtime Environment for notification that the destination is not reachable. Because the semantics of this notification do not guarantee delivery, Unified CVP cannot guarantee failover.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
321
Chapter 8: Configuring Unified CVP Logging and Event Notifications Using Logs to Interpret Events
Identifies the event type described in the CVPLogMessagesRes.properties file. Identifies the message text described in the CVPLogMessagesRes.properties file. Identifies the severity level (page 291) of the event. Set to true, to send this message, when logged, to an SNMP manager, if one is configured.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
322
Chapter 8: Configuring Unified CVP Logging and Event Notifications Using Logs to Interpret Events
Message Element
Possible Values
What it Means
SendToSyslog SNMPRaise
Set to true to send this message, when logged, to a Syslog server, if one is configured. Set to true to identify this message, when logged, as an SNMP raise event, which the SNMP management station can use to initiate a task or automatically take an action. Set to false to identify this message as an SNMP clear when sent to an SNMP management station. An SNMP clear event usually corresponds to an SNMP raise event, indicating that the problem causing the raise has been corrected. An administrator on an SNMP management station can correlate SNMP raise events with SNMP clear events.
0 1 2 3 4 5 6
System or service is unusable Action must be taken immediately Critical condition, similar to ALERT, but not necessarily requiring an immediate action An error condition that does not necessarily impact the ability of the service to continue to function A warning about a bad condition, which is not necessarily an error Notification about interesting system-level conditions, which are not errors Information about internal flows or application or per-request information, not system-wide information
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
323
Chapter 8: Configuring Unified CVP Logging and Event Notifications Using Logs to Interpret Events
Procedure
To download a Log Messages XML file from the Operations Console to a Unified CVP Server:
Step 1
From the Device Management menu, choose the type of server from which you want to download a syslog XML file. For example, to download a file to a VXML Server, choose Device Management > VXML Server. The Find, Add, Delete, Edit window lists any servers that have been added to the control panel.
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit. Select File Transfer in the toolbar and then click Log Messages XML File Download. The Log Messages XML Download dialog box displays.
Step 3
Step 4
Click Download to transfer the XML file to the server. A message indicates that this operation might take some time. Click OK to continue with the download or click Cancel to cancel the download.
See Also Uploading a Log Messages XML File (page 291) Editing the Log Messages XML File (page 290)
Procedure
To upload a Log Messages XML file from a Unified CVP Server to the Operations Console:
Step 1
From the Device Management menu, choose the type of server to which you want to upload a syslog XML file. For example, to upload a file to a VXML Server, choose Device Management > VXML Server. The Find, Add, Delete, Edit window lists any servers that have been added to the control panel.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
324
Chapter 8: Configuring Unified CVP Logging and Event Notifications VoiceXML Logs
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit. Select File Transfer in the toolbar and then click Log Messages XML File Upload. The Log Messages XML Upload page displays.
Step 3
Step 4
In the Select a Log Messages XML file from your local PC text box, enter a file name or click Browse and search for the file on your local system. Click Upload to transfer the selected file to the Unified CVP Server. Shut down and then start the corresponding Unified CVP Server.
Step 5 Step 6
See Also Downloading a Log Messages XML File (page 291) Editing the Log Messages XML File (page 290) Shutting Down a Server (page ?) Starting a Server (page ?)
VoiceXML Logs
Note: Refer to the Support Tools documentation for more information about viewing logs.
Infrastructure
CVP.<timestamp>.log
Unified CVP logs for the VoiceXML Service: This includes Notice, Info, and Debug logs. With Debug turned on, you can also see Call, Message, and Method trace types of logs. Unified CVP error log: This contains any error that Unified CVP Services and message layer has generated.
Error messages
Error.<timestamp>.log
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
325
Chapter 8: Configuring Unified CVP Logging and Event Notifications VoiceXML Logs
In the Unified ICME script, use the formula editor to set ToExtVXML[1]. Set the value of ToExtVXML[1] variable to concatenate("callid=",Call.user.media.id) Note: Always include "callid" when sending the call to the VXML Server using the Comprehensive call flow model. The Call ID can also be used in VXML Server (standalone) solutions. When you concatenate multiple values, use a comma for the delimiter; for example,
concatenate("ICMInfoKeys= ",Call.RouterCallKey,"-",Call.RouterCallDay,"-",Call.RouterCallKeySequenceNumber).
Refer to the "Passing Information to the External VoiceXML (page 230)" section in Chapter 4, "Writing Scripts for Unified CVP," for more information.
VXML Server Call Log VXML Server Call Error Log VXML Server Administration History Log
Records a single line for every application visit handled by an install of VXML Server. Records errors that occur outside the realm of a particular application. Records information from VXML Server administration scripts.
The VXML Server Call Error Log can contain the following error codes: Error Code 40 -- System Unavailable This is returned if the application server is unavailable (shutdown, network connection disabled, and so forth) Error Code 41 -- App Error
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
326
Chapter 8: Configuring Unified CVP Logging and Event Notifications VoiceXML Logs
This is returned if some VXML Server-specific error occurs (For example, java exception). Error Code 42 -- App Hangup This is returned to Unified CVP if the Hang Up element is used without being preceded by a Subdialog_Return element. Note: If the application is configured correctly, this should not occur. Error Code 43 -- Suspended This is returned if the VXML Server application is suspended. Error Code 44 -- No Session Error This is returned when an emergency error occurs (for example, an application is called that has not been loaded in the VXML Server application). Error Code 45 -- Bad Fetch This is returned when the VXML Server encounters a bad fetch situation. This code is returned when either a .wav file or an external grammar file is not found.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
327
Chapter 8: Configuring Unified CVP Logging and Event Notifications VoiceXML Logs
Note: Refer to the User Guide for Cisco Unified CVP VXML Server and Unified Call Studio for details on configuring loggers. The table that follows describes the logs that are created for each application.
Application Logger Type Log Name Description
ActivityLog
Records all application activity, which will show which elements were entered and exited during a call. Default setting: on
ErrorLog
AdminLog
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
328
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Log Name
Description
CVPDatafeedLog
Listens for logging events and provides VXML Server and VoiceXML Service data to the Unified CVP Reporting Server. The Unified CVP Reporting Server stores this information in a reporting database so that it is available for later review. One CVPDatafeedLog is created per application. Default setting: on Note: The VoiceXML Service can be started by adding this logger in the VoiceXML application.
CVPSNMPLog
Listens for a set of events and sends information about these events to the SNMP log, Syslog, or Unified CVP log. Default setting: on
DebugLog
Creates a single file per call that contains all HTTP requests and responses that occurred between a IOS Gateway and VXML Server during the call session. Default setting: off
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
329
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
VXML Server statistics Video Media Server statistics Reporting Server statistics
Procedure
To view device statistics:
Step 1 Step 2
Choose System > Control Center. From the Device Type tab in the left pane, choose the type of device for which you want to view statistics. From the Devices tab, select a device by checking the radio button preceding it. Select Statistics either in the Actions column or in the toolbar. Statistics for the selected device are reported in a new statistics result window. All event statistics are sent to an SNMP manager, if one is configured. The log messages XML file, CVPLogMessages.xml, defines the severity, destination (SNMP management station or Syslog server), and possible resolution for Unified CVP log messages.
Step 3 Step 4
See Also Infrastructure Statistics (page 331) ICM Service Call Statistics (page 333) IVR Service Call Statistics (page 336) SIP Service Call Statistics (page 338) Gatekeeper Statistics (page 342) Gateway Statistics (page 344) VXML Server Statistics (page 345) Video Media Server Statistics (page 346) Reporting Statistics (page 348)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
330
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Infrastructure Statistics
Unified CVP infrastructure statistics include realtime and interval data on the Java Virtual Machine (JVM), threading, and Licensing. You can access these statistics by choosing Control Center from the System menu and then selecting a device. See Viewing Infrastructure Statistics (page ?) for more information. Access infrastructure statistics either by: Choosing System > Control Center, selecting a device, clicking the Statistics icon in the toolbar, and then selecting the Infrastructure tab. Selecting a device type from the Device Management menu, selecting a device, clicking the Statistics icon in the toolbar, and then selecting the Infrastructure tab. The following table describes Licensing statistics.
Table 41: Licensing Statistics
Statistic
Description
Realtime Statistics Port Licenses Available The number of port licenses available for the processing of new calls. Exactly one port license is used per call, independent of the call's traversal through the individual call server services. The number of port licenses currently in use on the call server. Exactly one port license is used per call, independent of the call's traversal of the individual call server services. The threshold level of port license usage. There are four levels: safe, warning, critical and failure. An administrator may set the required percentage of port licenses in use needed to reach a given threshold level, with the exception of the failure level which is reached when the number of ports checked out is equal to the total number of licenses ports. The time the system started collecting statistics for the current interval. The amount of time that has elapsed since the start time in the current interval. The interval at which statistics are collected. The default value is 30 minutes. The number of port license checkout requests made in the current interval. For each port license checkout request, whether it checks out new port license or not, this metric is increased by one.
Interval Statistics Start Time Duration Elapsed Interval Duration Total New Port License Requests
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
331
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
The average number of port license checkout requests made per minute in the current interval. This metric is calculated by dividing the port license requests metric by the number of minutes elapsed in the current interval. The maximum number of port licenses used during this time interval. The time the service started collecting statistics. The amount of time that has elapsed since the service start time. The number of port license checkout requests made since the system was started. For each port license checkout request, whether it checks out new port license or not, this metric is increased by one. The average number of port license checkout requests made per minute since the system was started. This metric is calculated by dividing the aggregate port license requests metric by the number of minutes elapsed since the system was started. The peak number of simultaneous port licenses used since the start of the system. When a port checkout occurs, this metric is set to the current port licenses in use metric if that value is greater than this metric's current peak value. The number of port license checkout requests that were denied since the start of the system. The only reason a port license checkout request would be denied is if the number of port licenses checked out at the time of the request is equal to the total number of port license available. When a port license checkout is denied, the call does not receive regular treatment (the caller may hear a busy tone or an error message).
Maximum Port Licenses Used Aggregate Statistics Start Time Duration Elapsed Total New Port License Requests
The following table describes thread pool system statistics. The thread pool is a cache of threads, used by Unified CVP components only, for processing of relatively short tasks. Using a thread pool eliminates the waste of resources encountered when rapidly creating and destroying threads for these types of tasks.
Table 42: Thread Pool Realtime Statistics
Statistic
Description
Realtime Statistics Idle Threads Running Threads Core Threads Maximum Threads Peak Threads Used The number of idle threads waiting for some work. The number of running thread pool threads currently processing some work. The number of thread pool threads that will never be destroyed no matter how long they remain idle. The maximum number of thread pool threads that will ever exist simultaneously. The peak number of thread pool threads ever simultaneously tasked with some work to process. The following table describes Java Virtual Machine statistics.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
332
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
Realtime Statistics Peak Memory Usage The greatest amount of memory used by the Java Virtual machine since startup. The number reported is in megabytes and indicates the peak amount of memory ever used simultaneously by this Java Virtual Machine. The current number of megabytes of memory used by the Java Virtual Machine. The total amount of memory in megabytes available to the Java Virtual Machine. The number reported is in megabytes and indicates the how much system memory is available for use by the Java Virtual Machine. The amount of available memory in the Java Virtual Machine. The number reported is in megabytes and indicates how much of the current system memory claimed by the Java Virtual Machine is not currently being used. The number of threads currently in use in the Java Virtual Machine. This number includes all of the Unified CVP standalone and thread pool threads as well as those threads created by the Web Application Server running within the same JVM. The greatest amount of threads ever used simultaneously in the Java Virtual Machine since startup. The peak number of threads ever used by the Java Virtual Machine includes all Unified CVP standalone and thread pool threads as well as threads created by the Web Application Server running within the same JVM. The length of time that the Java Virtual Machine has been running. This time is measured in hh:mm:ss and shows the amount of elapsed time since the Java Virtual Machine process began executing.
Available Memory
Threads in Use
Uptime
Statistic
Description
Realtime Statistics
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
333
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
Active Calls
The current number of calls being serviced by the ICM Server for a Unified CVP Call Server. This value represents a count of calls currently being serviced by the ICM for the Unified CVP Call Server for follow-on routing to a Contact Center agent. The ICM Server can accept Voice over IP (VoIP) calls that originate using either the Session Initiation Protocol (SIP) or H.323 protocol. Active SIP Call Legs indicates the current number of calls received by the ICM Server from the Unified CVP Call Server using the SIP protocol. The ICM Server can accept Voice over IP (VoIP) calls that originate using either the Session Initiation Protocol (SIP) or H.323 protocol. Active H.323 Call Legs indicates the current number of calls received by the ICM Server from the Unified CVP Call Server using the H.323 protocol. The current number of calls receiving Voice Response Unit (VRU) treatment from the ICM Server. The VRU treatment includes playing pre-recorded messages, asking for Caller Entered Digits (CED) or Speech Recognition Techniques to understand the customer request. Calls originating from an external VXML Server need call routing instructions from the ICM Server. Active Lookup Requests indicates the current number of external VXML Server call routing requests sent to the ICM Server. The current number of simultaneous full service video calls being processed by the ICM service.
Active Basic Service Video Calls Offered The current number of simultaneous basic service video calls being processed by the ICM service where video capability was offered. Active Basic Service Video Calls Accepted Interval Statistics Start Time Duration Elapsed Interval Duration New Calls The time at which the current interval has begun. The amount of time that has elapsed since the start time in the current interval. The interval at which statistics are collected. The default value is 30 minutes. The number of new calls received by the Intelligent Contact Management (ICM) application for follow-on Voice Response Unit (VRU) treatment and routing to a Contact Center agent during the current interval. The Intelligent Contact Management (ICM) application has the ability to accept Voice over IP (VoIP) calls that originate via the Session Initiation Protocol (SIP) or H.323 Protocol. Interval SIP Call Legs is an interval specific snapshot metric indicating the number of calls received by the ICM application via SIP during the current interval. The Intelligent Contact Management (ICM) application has the ability to accept Voice over IP (VoIP) calls that originate via the Session Initiation Protocol (SIP) or H.323 Protocol. Interval H.323 Call Legs is an interval specific snapshot metric indicating the number of calls received by the ICM application via the H.323 protocol during the current interval. The number of calls receiving Voice Response Unit (VRU) treatment from the Intelligent Contact Management (ICM) application. The VRU treatment The current number of simultaneous calls that were accepted as basic service video calls and are being processed by the ICM service.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
334
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
includes playing pre-recorded messages, asking for Caller Entered Digits (CED) or speech recognition techniques to understand the customer request during the current interval. ICM Lookup Requests Calls originating in an external VXML Server need call routing instructions from the Intelligent Contact Management (ICM) application. Interval Lookup Requests is an interval specific metric indicating the number of external VXML Server call routing requests sent to the ICM application during the current interval. The number of full service video calls processed by the ICM service during the current interval. The number of offered basic service video calls processed by the ICM service during the current interval. The number of basic service video calls accepted and processed by the ICM service during the current interval. The time the service started collecting statistics. The amount of time that has elapsed since the service start time. The total number of new calls received by the Intelligent Contact Management (ICM) application for follow-on Voice Response Unit (VRU) treatment and routing to a Contact Center agent since system start time. The Intelligent Contact Management (ICM) application has the ability to accept Voice over IP (VoIP) calls that originate via the Session Initiation Protocol (SIP) or H.323 Protocol. Total SIP Switch Legs is a metric indicating the total number of calls received by the ICM application via SIP since system start time. The Intelligent Contact Management (ICM) application has the ability to accept Voice over IP (VoIP) calls that originate via the Session Initiation Protocol (SIP) or H.323 Protocol. Total H.323 Switch Legs is a metric indicating the total number of calls received by the ICM application via the H.323 protocol since system start time. The total number of calls that have received Voice Response Unit (VRU) treatment from the Intelligent Contact Management (ICM) application since system start time. The VRU treatment includes playing pre-recorded messages, asking for Caller Entered Digits (CED) or Speech Recognition Techniques to understand the customer request. Calls originating in an external VXML Server need call routing instructions from the Intelligent Contact Management (ICM) application. Total Lookup Requests is a metric indicating the total number of external VXML Server call routing requests sent to the ICM application since system start time. The total number of new full service video calls received by the ICM service since system start time.
Full Service Video Calls Basic Service Video Calls Offered Basic Service Video Calls Accepted Aggregate Statistics Start Time Duration Elapsed Total Calls
Total Basic Service Video Calls Offered The total number of newly offered basic service video calls processed by the ICM service since system start time.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
335
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
Total Basic Service Video Calls Accepted The total number of new basic service video calls accepted and processed by the ICM service since system start time.
Statistic
Description
Realtime Call Statistics Active Calls Active HTTP Requests2 Active Full Service Video Calls Interval Statistics Start Time Duration Elapsed Interval Duration Peak Active Calls New Calls The time the system started collecting statistics for the current interval. The amount of time that has elapsed since the start time in the current interval. The interval at which statistics are collected. The default value is 30 minutes. Maximum number of active calls handled by the IVR service at the same time during this interval. New Calls is a metric that counts the number of New Call requests received from the IOS Gateway or the CVP H323 Service. A New Call includes the Switch leg of the call and the IVR leg of the call. This metric counts the total number of New Call Requests received by the IVR Service during this interval. A Call is a metric that represents the Switch leg the CVP call and the IVR leg of the CVP call. When both legs of the call are finished, this The number of active calls being serviced by the IVR service. The number of active HTTP requests being serviced by the IVR service. The current number of simultaneous full service video calls being serviced by the IVR service.
Calls Finished
2)
HTTP sessions are the number of HTTP requests currently being processed by the IVR SS. This # will be different than the # of calls being processed.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
336
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
metric will increase. Calls Finished is a metric that counts the number of CVP Calls that have finished during this interval. Average Call Latency Maximum Call Latency The average amount of time in milliseconds it took the IVR Service to process a New Call or Call Result Request during this interval. The maximum amount of time in milliseconds it has taken for the IVR Service to complete the processing of a New Call Request or a Request Instruction Request during this time interval. The minimum amount of time in milliseconds it took for the IVR Service to complete the processing of a New Call Request or a Request Instruction Request during this time interval. Active HTTP Requests is a metric that indicates the current number of simultaneous HTTP requests being processed by the IVR Service. Peak Active Requests is a metric that represents the maximum simultaneous HTTP requests being processed by the IVR Service during this time interval. The total number of HTTP Requests received from a client by the IVR Service during this time interval. The average number of HTTP Requests the IVR Service receives per second during this time interval. HTTP Requests per Second is a metric that represents the number of HTTP Requests the IVR Service receives each second from all clients. Peak HTTP Requests per Second is the maximum number of HTTP Requests that were processed by the IVR Service in any given second. This is also known as high water marking. The number of full service video calls received by the IVR service during this time interval. The maximum number of simultaneous full service video calls processed by the IVR service during this time interval. The time the service started collecting statistics. The amount of time that has elapsed since the service start time. New Calls is a metric that counts the number of New Call requests received from the IOS Gateway or the H.323 Service. A New Call includes the Switch leg of the call and the IVR leg of the call. Total New Calls is a metric that represents the total number of new calls received by the IVR Service since system startup. The maximum number of simultaneous calls processed by the IVR Service since the service started. Total HTTP Requests is a metric that represents the total number of HTTP Requests received from all clients. This metric is the total number of HTTP Requests received by the IVR Service since system startup. Active HTTP Requests is a metric that indicates the current number of simultaneous HTTP requests processed by the IVR Service.
Total HTTP Requests Average HTTP Requests/second Peak Active HTTP Requests/second
Full Service Video Calls Peak Active Full Service Video Calls Aggregate Statistics Start Time Duration Elapsed Total New Calls
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
337
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
Maximum number of active HTTP requests processed at the same time since the IVR service started. This is also known as high water marking. Total Full Service Video Calls Peak Active Full Service Video Calls Total Agent Video Pushes Total Agent Initiated Recordings Total Agent VCR Control Invocations The number of full service video calls received by the IVR service since system start time. The maximum number of simultaneous full service video calls processed by the IVR Service since system start time. The number of videos pushed by agents since system start time. The number of video recordings by agents since system start time. The number of video VCR controls invoked by agents since system start time.
Statistic
Description
Realtime Statistics Active Calls A real time snapshot metric indicating the count of the number of current calls being handled by the SIP service. This value does not include H.323 calls. The total number of SIP call legs being handled by the SIP service. A call leg is also known as a SIP dialog. The metric includes incoming, outgoing and ringtone type call legs. For each active call in the SIP service, there will be an incoming call leg, and an outgoing call leg to the destination of the transfer label.
Active Basic Service Video Calls Offered The number of basic service video calls in progress where video capability was offered. Active Basic Service Video Calls Answered The number of basic service video calls in progress where video capability was answered.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
338
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
Interval Statistics Start Time Duration Elapsed Interval Duration New Calls The time the system started collecting statistics for the current interval. The amount of time that has elapsed since the start time in the current interval. The interval at which statistics are collected. The default value is 30 minutes. The number of SIP Invite messages received by Unified CVP in the current interval. It includes the failed calls as well as calls rejected due to the SIP service being out of service. The number of CONNECT messages received by SIP service in order to perform a call Transfer, in the last statistics aggregation interval. Connects Received includes the regular Unified CVP transfers as well as Refer transfers. Any label coming from the ICM service is considered a CONNECT message, whether it is a label to send to the VRU or a label to transfer to an agent. The period of time between the CONNECT from ICM and when the call is answered. The metric includes the average latency computation for all the calls that have been answered in the last statistics aggregation interval. The total number of failed SIP transfers since system start time. When Unified CVP attempts to make a transfer to the first destination of the call, it sends the initial INVITE request to set up the caller with the ICM routed destination label. The metric does not include rejections due to the SIP Service not running. The metric includes failed transfers that were made after a label was returned from the ICM Server in a CONNECT message. The number of failed re-invite requests on either the inbound or outbound legs of the call during the interval. After a SIP dialog is established, re-INVITE messages are used to perform transfers. Re-invite requests can originate from the endpoints or else be initiated by a Unified CVP transfer from the Unified ICME script. This counter includes failures for both kinds of re-invite requests. The number of basic service video calls offered in the current interval. The number of basic service video calls answered in the current interval. The time the service started collecting statistics. The amount of time that has elapsed since the service start time. The number of SIP Invite messages received by Unified CVP since system start time. It includes the failed calls as well as calls rejected due to the SIP service being out of service. The number of CONNECT messages received by SIP service in order to perform a Unified CVP Transfer, since system start time. Connects Received includes the regular Unified CVP transfers as well as Refer transfers. Any label coming from the ICM service is considered a CONNECT message, whether it is a label to send to the VRU or a label to transfer to an agent.
Connects Received
Basic Service Video Calls Offered Basic Service Video Calls Answered Aggregate Statistics Start Time Duration Elapsed Total New Calls
Connects Received
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
339
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
The period of time between the CONNECT from ICM and when the call is answered. The metric includes the average latency computation for all the calls that have been answered since system start up time. The total number of failed transfers on the first CVP transfer since system start time. A SIP dialog is established after the first CVP transfer is completed. The metric does not include rejections due to SIP being out of service. The metric includes failed transfers that were made after a label was returned from the ICM in a CONNECT message. The number of failed re-invite requests on either the inbound or outbound legs of the call since start time. After a SIP dialog is established, re-INVITE messages are used to perform transfers. Re-invite requests can originate from the endpoints or else be initiated by a Unified CVP transfer from the Unified ICME script. This counter includes failures for both kinds of re-invite requests. The total number of basic service video calls offered since system start time. The total number of basic service video calls answered since system start time.
Total Basic Service Video Calls Offered Total Basic Service Video Calls Offered
The number of new inbound calls handled by the H.323 Service during this interval. The maximum number of inbound calls arriving per minute to the Unified CVP H.323 Service during this interval. This value represents the peak value over the interval and is expressed as "calls per minute." The number of calls that have been transferred by the Unified CVP H.323 Service during this interval. The Unified CVP H.323 Service might handle multiple transfers for a single call, so the value might not equal the "New calls this interval" statistic. The maximum number of calls transferred per minute by the Unified CVP H.323 Service during this interval. This value represents the peak value over the interval and is expressed as "calls transferred per minute." The number of calls that have been redirected by the Unified CVP H.323 Service. The H.323 Service only redirects a call when it is in an "out of service" state. A redirected call means that the Unified CVP H.323 Service did not accept the call. This allows the originating gateway to redirect the call to an alternate Unified CVP H.323 Server, if so configured in its dial-peers.
Transfers not completed this interval The number of calls that could not be transferred by the Unified CVP H.323 Service during this interval. The Unified CVP H.323 Service was unable to
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
340
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
transfer the call to a particular destination due to one of several factors: ring-no-answer; busy; incorrect configuration; call admission control (CAC) denials. It is a recoverable error if proper configuration elements have been put in place, such as Unified ICME router requery, and/or gatekeeper alternate endpoints. Prompts not found this interval The number of calls to which prompts could not be played during this interval period. This statistic indicates a failure within the solution for each of these calls. It could be caused by an Unified ICME script error, a missing prompt, or failure of the HTTP media server. The number of calls to which critical media needed to be played during the interval period. This usually, but not always, indicates an abnormal termination of the caller. In some benign cases, it can be caused by improper Unified ICME script termination practices. The number of calls to which the Unified CVP H.323 Service has completed servicing during this interval. These calls have ended and are no longer being handled by the Unified CVP H.323 Service. The average elapsed time in milliseconds from when the Unified CVP H.323 Service sends a 'New Call' request to Unified ICME until the time when the Unified CVP H.323 Service receives a response from Unified ICME. This value is expressed in milliseconds and is averaged over the interval period. The maximum elapsed time in milliseconds from when the Unified CVP H.323 Service sends a 'New Call' request to Unified ICME until the time when the Unified CVP H.323 Service receives a response from Unified ICME. This value is expressed in milliseconds and indicates the high-water mark for the interval period. The minimum elapsed time in milliseconds from when the Unified CVP H.323 Service sends a 'New Call' request to Unified ICME until the time when the H.323 Service receives a response from Unified ICME. This value is expressed in milliseconds and indicates the low-water mark for the interval period. The standard deviation elapsed time in milliseconds from when the Unified CVP H.323 Service sends a 'New Call' request to Unified ICME until the time when the H.323 Service receives a response from Unified ICME. The average amount of time elapsed for a transferred call to enter the "alerting" state once transferred. This value is expressed in milliseconds and is averaged over the interval. The maximum amount of time elapsed for a transferred call to enter the "alerting" state once transferred. This value is expressed in milliseconds and indicates the high-water mark for the interval. The minimum amount of time elapsed for a transferred call to enter the "alerting" state once transferred. This value is expressed in milliseconds and indicates the low-water mark for the interval period. The standard deviation elapsed time in milliseconds for a transferred call to enter the "alerting" state once transferred.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
341
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
The average amount of elapsed time for a transferred call to be answered at the destination once transferred. This value is expressed in milliseconds and indicates the average time for the interval. The maximum amount of time elapsed for a transferred call to be answered at the destination once transferred. This value is expressed in milliseconds and indicates the high-water mark for the interval. The minimum amount of time elapsed for a transferred call to be answered at the destination once transferred. This value is expressed in milliseconds and indicates the low-water mark for the interval. The standard deviation or elapsed time in milliseconds for a transferred call to be answered at the destination once transferred. The average server CPU usage for the Unified CVP H.323 Service computed during this interval. The CPU usage value is expressed as a percentage of potential usage available. The maximum server CPU usage for the Unified CVP H.323 Service during this interval. The CPU usage value is expressed as a percentage of potential usage available and represents a high-water mark of CPU usage during this interval. The minimum server CPU usage for the Unified CVP H.323 Service during this interval. The CPU usage value is expressed as a percentage of potential usage available and represents the low-water mark of CPU usage during this interval. The standard deviation server CPU usage for the Unified CVP H.323 Service during this interval. The CPU usage value is expressed as a percentage of potential usage available.
IVR Service: Avg Call Event Latency Average latency statistics in processing a new call arrival. (ms) IVR Service: Max Call Event Latency Maximum latency statistics in processing a new call arrival. (ms) IVR Service: Min Call Event Latency Minimum latency statistics in processing a new call arrival. (ms) IVR Service: Standard Deviation (theta) Standard deviation latency statistics in processing a new call arrival.
IVR Service: Number of Call Events Number of call latency statistics in processing a new call arrival.
Gatekeeper Statistics
Gatekeeper statistics include the number of active calls, available memory, CPU utilization and performance data.
Procedure
To get gatekeeper statistics:
Step 1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
342
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Step 2
Select the Device Type tab in the left pane, then select gatekeepers. Gatekeepers are listed in the right pane.
Step 3
Select the gatekeeper by clicking on its link under the Hostname column. the Edit Gatekeeper Configuration window opens.
Step 4
Gatekeeper Statistics
The following table describes gatekeeper statistics.
Table 47: Gatekeeper Statistics
Statistic
Description
Number of currently active calls handled by the gatekeeper. Free memory, for example:
Processor memory free: 82% I/O memory free: 79%
CPU Utilization
Performance Statistics
Admission levels. See the Gateway Performance Statistics Example. (page 343)
Gateway Performance Statistics Example Gatekeeper Level Admission Statistics: ARQs received: 5635885 ARQs received from originating endpoints: 2663162 ACFs sent: 5635884 ACFs sent to the originating endpoint: 2663162 ARJs sent: 1 ARJs sent to the originating endpoint: 0 ARJs sent due to overload: 0 ARJs sent due to ARQ access-list denial: 0 Number of concurrent calls: 280 Number of concurrent originating calls: 140 Gatekeeper level Registration Statistics:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
343
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Gateway Statistics
Gateway statistics include the number of active calls, available memory, and CPU utilization.
Procedure
To get gateway statistics:
Step 1 Step 2
Choose System > Control Center. Select the Device Type tab in the left pane, then select gateways. Gateways are listed in the right pane.
Step 3
Select the gateway by clicking on its link under the Hostname column. the Edit Gateway Configuration window opens.
Step 4
Gateway Statistics
The following table describes gateway statistics.
Statistic Description
Active Calls
Number of currently active calls handled by the gateway. For example, Total call-legs: 0 no active calls
Free Memory
CPU Utilization
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
344
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
The following table describes the statistics reported by the VXML Server.
Statistic Description
Real Time Statistics Active Sessions Active ICM Lookup Requests Interval Statistics Start Time Duration Elapsed Interval Duration Sessions Reporting Events ICM Lookup Requests ICM Lookup Responses The time at which the current interval has begun. The amount of time that has elapsed since the start time in the current interval. The interval at which statistics are collected. The default value is 30 minutes. The total number of sessions in the VXML Server in the current interval. The number of events sent to the Reporting Server from the VXML Server in the current interval. The number of requests from the VXML Server to the ICM Service in the current interval. The number of responses to both failed and successful ICM Lookup Requests that the ICM Service has sent to the VXML Server in the current interval. In the case that multiple response messages are sent back to the VXML Server to a single request, this metric will increment per response message from the ICM Service. The number of successful requests from the VXML Server to the ICM Service in the current interval. The number of requests from the VXML Server to the ICM Service in the current interval. This metric will be incremented in the case an ICM failed message was received or in the case the VXML Server generates the failed message. The time at which the current interval has begun. The number of current sessions being handled by the VXML Server. The number of current ICM requests being handled by the VXML Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
345
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
Duration Elapsed Total Sessions Total Reporting Events Total ICM Lookup Requests
The amount of time that has elapsed since the start time in the current interval. The total number of sessions in the VXML Server since startup. The total number of reporting events sent from the VXML Server since startup. The total number of requests from the VXML Server to the ICM Service. For each ICM lookup request, whether the request succeeded or failed, this metric will be increased by one. The total number of responses the ICM Service has sent to the VXML Server since startup. For each ICM lookup response, whether the response is to a succeeded or failed request, this metric will be increased by one. In the case that multiple response messages are sent back to the VXML Server to a single request, this metric will increment per response message from the ICM Service. The total number of requests from the VXML Server to the ICM Service since startup. For each ICM lookup request that succeeded, this metric will be increased by one. The total number of requests from the VXML Server to the ICM Service since startup. For each ICM lookup request that failed, this metric will be increased by one. This metric will be incremented in the case an ICM failed message was received or in the case the VXML Server generates a failed message.
See Also Viewing Infrastructure Statistics (page ?) Viewing Device Statistics (page 330)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
346
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
pool eliminates the waste of resources encountered when rapidly creating and destroying threads for these types of tasks.
Table 49: Thread Pool Realtime Statistics
Statistic
Description
Realtime Statistics Idle Threads Running Threads Core Threads Maximum Threads Peak Threads Used The number of idle threads waiting for some work. The number of running thread pool threads currently processing some work. The number of thread pool threads that will never be destroyed no matter how long they remain idle. The maximum number of thread pool threads that will ever exist simultaneously. The peak number of thread pool threads ever simultaneously tasked with some work to process. The following table describes Java Virtual Machine statistics.
Table 50: Java Virtual Machine (JVM) Realtime Statistics
Statistic
Description
Realtime Statistics Peak Memory Usage The greatest amount of memory used by the Java Virtual machine since startup. The number reported is in megabytes and indicates the peak amount of memory ever used simultaneously by this Java Virtual Machine. The current number of bytes of memory used by the Java Virtual Machine. The total amount of memory in megabytes available to the Java Virtual Machine. The number reported is in megabytes and indicates the how much system memory is available for use by the Java Virtual Machine. The amount of available memory in the Java Virtual Machine. The number reported is in megabytes and indicates how much of the current system memory claimed by the Java Virtual Machine is not currently being used. The number of threads currently in use in the Java Virtual Machine. This number includes all of the Unified CVP standalone and thread pool threads as well as those threads created by the Web Application Server running within the same JVM. The greatest amount of threads ever used simultaneously in the Java Virtual Machine since startup. The peak number of threads ever used by the Java Virtual Machine includes all Unified CVP standalone and thread pool threads as well as threads created by the Web Application Server running within the same JVM. The length of time that the Java Virtual Machine has been running. This time is measured in hh:mm:ss and shows the amount of elapsed time since the Java Virtual Machine process began executing.
Available Memory
Threads in Use
Uptime
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
347
Chapter 8: Configuring Unified CVP Logging and Event Notifications About Event Statistics
Statistic
Description
Interval Statistics Start Time Duration Elapsed Interval Duration VXML Events Received The time the system started collecting statistics for the current interval. The amount of time that has elapsed since the start time in the current interval. The interval at which statistics are collected. The default value is 30 minutes. The total number of reporting events received from the VoiceXML Service during this interval. For each reporting event received from the VoiceXML Service, this metric will be increased by one. The total number of reporting events received from the SIP Service during this interval. For each reporting event received from the SIP Service, this metric will be increased by one. The total number of reporting events received from the IVR service in the interval. For each reporting event received from the IVR service, this metric will be increased by one. The total number of writes to the database made by the Reporting server during the interval. For each write to the database by the Reporting server, this metric will be increased by one. The time the service started collecting statistics. The amount of time that has elapsed since the service start time. The total number of reporting events received from the VoiceXML Service since the service started. For each reporting event received from the VoiceXML Service, this metric will be increased by one.
Database Writes
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
348
Chapter 8: Configuring Unified CVP Logging and Event Notifications SNMP Alerts for Cisco Unified Presence Server (CUP)
Statistic
Description
The total number of reporting events received from the SIP Service since the service started. For each reporting event received from the SIP Service, this metric will be increased by one. The total number of reporting events received from the IVR Service since the service started. For each reporting event received from the IVR Service, this metric will be increased by one. The total number of writes to the database made by the Reporting server during since startup. For each write to the database by the Reporting server, this metric will be increased by one.
Database Writes
Raise ID
Clear ID
Event Name
7 8 9 10 15
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
349
Chapter 8: Configuring Unified CVP Logging and Event Notifications Unified CVP SNMP-Raise/Clear Mappings
Raise ID
Clear ID
Event Name
20
Table 53: Infrastructure
SEND_QUEUE_SIZE_CLEAR
Raise ID
Clear ID
Event Name
9005 1003 9007 9008 9014 1003 1004 9016 9015 1011 1014 1012 1003 1020 1003 1024 1003 1025 1003 1033 1026 1035 1003
Table 54: Unified ICME
LICENSING [AUDIT] "The system has started up." PORT_THRESHOLD PORT_THRESHOLD SHUTDOWN [AUDIT] "The system has started up." [AUDIT] "The system has completely shutdown." SERVER_SETUP - "CCBUSNMPAgent Server setup failed because XXX" 3 SERVER_SETUP - "CCBUSNMPAgent Server setup on port YYY" HEARTBEATS_STOPPED - "Heartbeats from XXX stopped..."4 RECEIVED_STATE_MSG - "StateManager: Subsystem [XXX] reported change to..." STATE_MANAGER_STARTUP_FAILURE [AUDIT] "The system has started up." STARTUP [AUDIT] "The system has started up." SERVLET_STARTUP [AUDIT] "The system has started up." START - "Could not start XXX due to: YYY" 5 [AUDIT] "The system has started up." START - "No Subsystems have been started..." START - "All Subsystems have been started." LICENSE_EXPIRATION [AUDIT] "The system has started up."
Raise ID
Clear ID
Event Name
2001
3) 4) 5) Where XXX must match in both messages Where XXX must match in both messages Where XXX must match in both messages
LOGMSG_ICM_SS_MSGBUS_SHUTDOWN
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
350
Chapter 8: Configuring Unified CVP Logging and Event Notifications Unified CVP SNMP-Raise/Clear Mappings
Raise ID
Clear ID
Event Name
Raise ID
Clear ID
Event Name
4005 1026 4006 4007 4010 4011 4014 N/A 4017 4007 4009 4018 4019
Table 56: IVR
REPORTING_SS_ERROR_RAISE START - "All Subsystems have been started." REPORTING_DB_PURGE_FAILED REPORTING_DB_PURGE_COMPLETED REPORTING_DB_BACKUP_FAILED REPORTING_DB_BACKUP_COMPLETED REPORTING_DB_ALERT_MSG Not applicable REPORTING_DB_STARTING_PURGE REPORTING_DB_PURGE_COMPLETED REPORTING_DB_EMERGENCY_PURGE_COMPLETED REPORTING_DB_REMAINDER_DATA REPORTING_DB_NO_REMAINDER_DATA
Raise ID
Clear ID
Event Name
3014 3013 3027 3026 3021 3022 3002 3001 3000 3001
VBCLIENT_REMOVED VBCLIENT_ADDED VBCLIENT_SHUT_DOWN VBCLIENT_RESTARTED VBSERVLET_STATE_CHANGED VBSERVLET_STATE_IN_SERVICE STATE_CHANGED STATE_CHANGED_IN_SERVICE SHUTDOWN_NOTICE STATE_CHANGED_IN_SERVICE
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
351
Chapter 8: Configuring Unified CVP Logging and Event Notifications Unified CVP SNMP-Raise/Clear Mappings
Raise ID
Clear ID
Event Name
5001 5002
Table 58: VoiceXML
SS_STATE SS_STATE
Raise ID
Clear ID
Event Name
VXML_SERVER_APP_SHUTDOWN_ALERT VXML_SERVER_APP_STARTUP_CLEAR VXML_SERVER_APPADMIN_ERROR [AUDIT] "The system has started up." [AUDIT] "The system has completely shutdown." VXML_SERVER_SYSTEM_ERROR [AUDIT] "The system has started up." [AUDIT] "The system has completely shutdown."
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
352
Chapter 9
Administering the Unified CVP H.323 Service
This chapter provides the following: An overview of the Unified CVP H.323 Service. Instructions for controlling the state of the Unified CVP H.323 service. Instructions for using the VBAdmin tool. Descriptions of each of the VBAdmin commands. Instructions for performing a H.323 blind transfer. Note: The primary audience for this chapter is Unified CVP System Managers. This chapter contains the following topics: Unified CVP H.323 Service Overview, page 353 VBAdmin Tool, page 358 Using VBAdmin, page 360 Performing H.323 Blind Transfers, page 381
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
353
Chapter 9: Administering the Unified CVP H.323 Service Unified CVP H.323 Service Overview
Cisco IOS gateways (refer to the Hardware and System Software Specification for Cisco Unified Customer Voice Portal (Unified CVP) Software Release 7.0(1) for the current list of gateways supported) PGW/HSI in call control mode (used as an Ingress Gateway only) The H.323 Service interacts with Unified ICME through the Unified CVP Call Server to relay call arrival, disconnect, and transfer instructions between Unified ICME and the other H.323 endpoints. Note: The H.323 Service is only used in H.323-based call flows. The H.323 Service includes its own internal Voice Browser that serves several key roles in the Unified CVP architecture. It: Functions as the initial VoIP end-point for H.323 voice contacts. Coordinates the delivery of messages and prompts to a caller from the Media Server. Note: This is legacy functionality, only; it should not be used for new deployments. New deployments should always use the Unified CVP Comprehensive call flow model, where prompts are rendered from the IOS VXML gateway. Sends HTTP requests to the IVR Service. In addition, the H.323 Service includes a configuration and administration toolcalled VBAdmin. On the incoming call side, the H.323 Service processes call and control signals from calls entering the system at one of the supported ingress H.323 endpoints. (The ingress H.323 endpoints converts them into H.323 messages before forwarding them to the H.323 Service.) Once in control of the call, the H.323 Service converts the voice signals into events to be processed by a web server known as the Call Server, which houses the IVR Service. The H.323 Service connects to the IVR Service through a pre-defined URL address. (For more information, see the "How Does the H.323 Service Connect to a Call Server? (page 355) section.") The H.323 Service remains in the call control path until the calls logical completion. (The IVR Service never directly controls a telephone call.) On its outgoing side, the H.323 Service acts upon VoiceXML commands received from the IVR Service. The VoiceXML commands contain instructions for: Transferring the telephone call. Disconnecting the telephone call. Delivering recorded messages and prompts and processing user responses to the prompts.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
354
Chapter 9: Administering the Unified CVP H.323 Service Unified CVP H.323 Service Overview
If the Call Server list changes, the first Call Server on the new list will be used. The change will be used for new calls only.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
355
Chapter 9: Administering the Unified CVP H.323 Service Unified CVP H.323 Service Overview
To start the Service Control tool, select Start > Programs > Cisco Unified Customer Voice Portal > H.323 Service. The Service Control window displays the following information:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
356
Chapter 9: Administering the Unified CVP H.323 Service Unified CVP H.323 Service Overview
Computer Name. (Read-only.) Displays the name of the selected computer where Service Control is viewing and controlling services. Select. (Button.) Accesses the Select Computer dialog box. This option allows you to select a machine and remotely view and control the services on that machine. To select a remote computer, enter the computer name in the text field of the Select Computer dialogue box (or choose it from the list) and click OK. Close. (Button.) Click this button to exit and close the Service Control tool. Note: All services remain in their current state (running services continue to run) after you close the Service Control tool. Services. (Column.) Lists the name of the Windows 2003 service. This column also displays a traffic light icon which indicates the state of the service. State. (Column.) Describes the state of the service. Possible states include: Stopped. The service is stopped. Stop Pending. Service Control is in the process of stopping the service. Start Pending. Service Control is in the process of starting the service. Running. Service is running. Startup. (Column.) Indicates whether the Windows 2003 service is Automatic (service starts when you turn on the computer), Manual (user must start the service) or Disabled (user stopped the service). All. (Checkbox.) If not checked, the default, displays only Cisco CCBU Support Tools Node Agent, Cisco CVP SNMP Management, and Cisco CVP H.323 Service. If checked, displays all Windows 2003 services on the machine specified in the Computer Name. Start/Start All. (Button.) Use this button to start a service or services: Start All. (The All checkbox is not checked and no services are selected.) Click Start All to start all Unified CVP services. Note: Start All only affects Cisco Support Tools Node Agent, Cisco Unified CVP SNMP Management, and Cisco Unified CVP H.323 Service (on a Call Server machine). Start. (The All checkbox is checked or one service is selected.) Controls only one service at a time. Click Start to start a selected service. Stop/Stop All. (Button.) Use this button to stop a selected service or services. Stop All. (The All checkbox is not checked and no services are selected.) Click Stop All to stop all Unified ICME services. Note: Stop All only affects Cisco Support Tools Node Agent, Cisco Unified CVP SNMP Management, and Cisco Unified CVP H.323 Service (on a Call Server machine).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
357
Stop. (The All checkbox is checked or one service is selected.) Controls only one service at a time. Click Stop to stop a selected service. Cycle. (Button.) Click this button to stop and restart a selected service in a single action. Manual/Automatic. (Buttons.) These buttons allow you to switch the startup mode of a selected service between manual (user-initiated) and automatic (starts when the computer is turned on). Help. (Button) Click this button to access the Service Control online help.
Step 2
To remotely view and control services on another machine, click Select. The Select Computer dialog box appears. Type a computer name or select a name from the list and click OK. The Service Control window reappears, displaying the services on the computer you specified.
Step 3
VBAdmin Tool
The H.323 Service includes a configuration and administration toolcalled VBAdminto help you keep track of the H.323 Services interactions with related components. This tool provides a command line interface (CLI) you can use to: Gather statistics. Modify configuration settings. View system metrics and status. Control the H.323 Service. Note: In order for the VBAdmin tool to function, the H.323 Service must be running. The sections that follow describe the VBAdmin tool, its commands, and how to use them.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
358
Running VBAdmin
Since there are often many H.323 Services in network installations, VBAdmin can be run locally or remotely (Remote VBAdmin), or redirected to monitor a different H.323 Service. However, Remote VBAdmin is supported only when being run on a server that has Unified ICME installed. VBAdmin can also be used from any machine running Unified ICME to remotely administer the H.323 Service. The syntax to do so is: procmon Customer "Voice Browser" VB machine-name-or-IP-of-H323-Service.
where: show<Parameter> or set<Parameter> is the command; for example, ShowGateKeeper or SetCallServerNumTries. NewValueonly used with Set commandsis the new setting for the parameter. /? and /help are two options for accessing VBAdmin Online Help. Note: NewValue must be enclosed in quotes only if you are defining multiple settings for a parameter using one command. For example, to define one Call Server Name, you would enter: SetCallServerList CS_Lowell(no quotes). To define three Call Server Names at one time, you would enter: SetCallServerList CS_Lowell CS_Salem CS_SanJose (with quotes). VBAdmin Commands are not case-sensitive; for example, either ShowGateKeeper or showgatekeeper is an acceptable entry value. After you enter a Show or Set command, VBAdmin responds with messages that fall into one of the following types: Informational/Online Help. Examples: CallServerNumTries is currently 3. Valid values: 256 character string. Confirmational. Example: CallServerNumTries has been changed from 3 to 5. Error. Example: Entered value needs to be a positive integer.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
359
The first two message types are described in the Command tables in the Using VBAdmin (page 360) section. Error messages are described in VBAdmin Error Handling (page 381).
Command ShowCallServerNumTries /?
Help Message
Maximum number of times the H.323 Service will try to connect to the Call Server before failing and reporting an error. ShowCallServerNumTries [/? | /help] SetCallServerNumTries [<NewValue> | /? | /help]
SetTraceMask /help
For use by Technical Support, only. Default: 101003HEX Changes to this value take effect immediately. (System shutdown and startup unnecessary.) ShowTraceMask [/? | /help] SetTraceMask [<NewValue> | /? | /help]
Note: To obtain an alphabetical list of all commands supported by VBAdmin, enter mhelp at the VBAdmin CLI prompt.
Using VBAdmin
This section describes how to use the VBAdmin command language interface (CLI) tool.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
360
Step 1
Select Start > Programs > Cisco Unified Customer Voice Portal > H.323 Services > H.323 Service Admininstration. The H.323 Service Administration window appears.
Step 2 Step 3
Enter a show<parameter> or set<parameter> command you want to execute. When finished using VBAdmin, enter q. The VBAdmin window closes.
At the DOS prompt, enter the command: procmon Customer "Voice Browser" VB machine-name-or-IP-of-H323-Service. Enter a show<Parameter> or set<Parameter> command you want to execute.
Step 2
Note: VBAdmin must be installed on any machine you want to access remotely. The sections that follow describe the VBAdmin commands by category.
Description
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
361
error.
SetCallServerConnectTimeout [<New Value> | /? | /help]
ShowCallServerList [/? | /help] SetCallServerList [<List of CallServer base URLs, delimited by spaces> | /? | /help] (Shorthand commands: sCSList, SetCSList)
List of base URLs of Call Servers for the H.323 Service, delimited by spaces and the entire list enclosed in quotes. The syntax for the base URL is: <CallServer>:<Port>/cvp/VBServlet where: <CallServer is the hostname or IP address of the machine that is running the Call Server. (Default: localhost.) <Port is the port number the Call Server is listening on. (Default: 8000.) /cvp/VBServlet is a fixed string that you must append to each name in the CallServerList. Note: A colon (:) must separate the <CallServer> and <Port> values. In addition, you must use the default Port number and treat cvp/VBServlet as a fixed string. Making changes to these value can render a Call Server unusable. IP Address and DNS name may be used in configuring the base URL portion of a Call Server. However, Unified CVP cannot currently support more than one IP address per DNS name, so you must have a one-to-one correspondence between a DNS name and IP address for each Call Server. When defining multiple List of CallServer base URLs settings, enclose them in quotes (for example: SetCSList CS_Boston:8000/cvp/ VBServlet CS_SanJose:8000/cvp/VBServlet). Changes to this value take effect immediately. Note: For more information, see the "How Does the H.323 Service Connect to a Call Server? (page 355)" section.
ShowCallServerNumTries [/? | /help] Maximum number of times the H.323 Service will try to connect to
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
362
Description
Number of seconds the H.323 Service should wait for a response from the Call Server before timing out and generating an error.
SetCallServerTimeout [<NewValue> | / ? | /help] Note: This setting must be greater than the IVR Service Timeout (Shorthand commands: sCSTimeout, SetCSTimeout)
setting on the IVR tab in the Operations Console. (For information about setting the IVR Service Timeout setting, refer to the Operations Console online help.) Default: 7 seconds System shutdown and startup necessary for changes to take effect.
ShowCalledPartyTimeout [/? | /help] Length of time in seconds to wait for additional instructions from
Unified ICME after the Called Party (that is, agent) hangs up. If no
SetCalledPartyTimeout [<NewValue> | instructions are received, the H.323 Service disconnects the caller. /? | /help]
Default: 2
(Shorthand commands: sCPT, SetCPT)
When this value is set to on, call events will be logged to the console and log files. This is the lowest level of debugging, recommended SetCallTrace [on | off | /? | /help] when you want to see basic call events (call arrived, call transferred, call disconnected). Valid Values: on and off Default: off.
ShowCLIDigitsToDelete [/? | /help]
When a call arrives at the H.323 Service with the H323 presentationIndicator value set to Restricted, the H.323 Service SetCLIDigitsToDelete [<New Value>/? needs to hide some portion or all of the caller ID before passing the | /help] CallerID to Unified ICME. This setting controls how many digits will be stripped from the rightmost portion of the callerID before passing it to Unified ICME. A value of 0 will leave the callerID as is, and a value that is greater than the length of the callerID will strip all the digits. Default: 0.
ShowCodec [/? | /help]
Type of codec and rate used in the H.323 Service when communicating with another VoIP endpoint.
Note: All H.245 channel signaling and RTP streams are based on the codec setting. The H.323 Service will only accept the prompt files with the same encoding as the codec setting. If instructed to play an
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
363
Description
audio file with a different encoding, the prompt will not be played and an error will be generated. System shutdown and startup necessary for changes to take effect.
ShowDefaultConnectTimeout [/? | / help]
The number of seconds the H.323 Service waits for a TCP connect to a server to complete before timing out and generating an error. Note: This does not apply to Call Servers and Media Servers. They SetDefaultConnectTimeout [<New Value> have their own settings.
| /? | /help]
When SetTransferLabel is set, a call whose transfer label from Unified ICME matches one of the labels in that list would normally be sent back to the same gateway from which it arrived for IVR treatment, regardless of the route settings in the gatekeeper. Sometimes it is not desirable to send the call back to the same gateway from which it arrived, for instance, such as when the call originated from Unified CM. The SetExcludeIP command lets you specify a comma-delimited list of IP addresses that will ignore the SetTransferLabel directive. Valid value: A a comma-delimited list of IP addresses. Default: "" Changes to this value take effect immediately.
Specifies a list of gatekeepers to which the H.323 Service will register. Note: The H.323 Service will register to only one gatekeeper at a time. In the event that a gatekeeper failure is detected by the H.323 Service, it will register to the next gatekeeper in the list. Note: The H.323 Service will not automatically revert to the previous gatekeeper when that gatekeeper becomes available again. You will need to re-enter the setGK command with the orginal gatekeeper address to revert to the beginning of the list. You can specify particular zones and ports on the gatekeeper. For example: setGK "10.86.129.33" setGK "10.86.129.33:zonename1" setGK "10.86.129.33, 10.86.129.34, 10.86.129.35"
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
364
Description
setGK "10.86.129.33:zonename1:portnum, 10.86.129.34" setGK "10.86.129.33:zonename1:portnum, 10.86.129.34:zonename2:portnum" Valid values: IP address or none Default: none (or no value) Changes to this value take effect immediately.
ShowH323ID [/? | /help] SetH323ID [<NewValue> | /? | /help]
This value defines a unique identification for this H.323 endpoint in a H.323 network. By convention, this is the IP address of the machine. Valid values: 256 character string
(Shorthand command: sH323ID) Default: Local IP address System shutdown and startup necessary for changes to take effect.
ShowH323Trace [/? | /help] SetH323Trace [on | off | /? | /help]
When this value is set to on, H323 details will be logged to the console and log files. Valid Values: on and off Default: off. Changes to this value take effect immediately.
ShowH323Zone [/? | /help] SetH323Zone [<New Value> | /? | / help] ShowISNtoISN [/? | /help] SetISNtoISN [on | off | /? | /help]
When this value is set on, the H.323 Service is not allowed to send calls to another H.323 Service. Valid Values: on and off Default: off Changes to this value take effect immediately.
When this value is set to on, Interface details will be logged to the console and log files.
When this value is set on, the H.323 Service transfers calls to accommodate Unified CM (Unified CCM) Location-based CAC.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
365
Description
SetLocationsBasedCAC [on | off | /? Specifically, this means forcing the H.225 setup to port 1720 on | /help] Unified CCM and including the IP address of the originating gateway
in the sourceCallSignalAddress of the ARQ and H.225 setup message on the transfer. Valid Values: on and off Default: off Changes to this value take effect immediately.
ShowLogMeters [/? | /help]
Controls logging metrics. When "on," the H.323 Service will log metrics to the console and log files at the interval specified by the SetLogMeters [on | off | /? | /help] "Message Meter Interval". Metrics are always available on demand for the last interval(s). Valid Values: on and off Default: on Changes to this value take effect immediately.
ShowMaxIVRPorts [/? | /help]
Maximum number of calls in the H.323 Service which are allowed to receive IVR treatment at any given time. If the number of calls SetMaxIVRPorts [<NewValue> | /? | / receiving IVR treatment at any given time exceed the MaxIVRPorts help] value, additional calls arriving at the H.323 Service is rejected. (Shorthand command: sMaxIVRPorts) Note: Even when a Gateway is acting as the IVRas can be the case in a Unified CVP Comprehensive call flow modelyou still need a small number of IVR ports on the H.323 Service, based on the incoming calls per second and subsequent transfers. Use the Max IVR Ports listing in the H.323 Service Total Statistics log to help make decisions regarding IVR port sizing. Default: 50 System shutdown and startup necessary for changes to take effect.
ShowMaxTotalCalls [/? | /help]
System shutdown and startup necessary for changes to take effect. (Shorthand command: sMaxTotalCalls)
ShowMediaServerConnectTimeout [/? | The number of seconds the H.323 Service waits for a TCP connect /help] to the Media Server to complete before timing out and generating an
error.
SetMediaServerConnectTimeout [<New Value> | /? | /help]
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
366
Description
ShowMediaServerTimeout [/? | /help] Number of seconds the H.323 Service should wait for a response from
addresses in sequence resolved by the DNS server for the Media Server URL. The timeout value is for every IP address resolved by DNS server for the media server URL. Default: 10 System shutdown and startup necessary for changes to take effect.
Maximum number of retries the H.323 Service attempts (in addition to the original attempt) in trying to connect to the media server before SetMediaServerTries [<NewValue> | /? failing and reporting an error.
| /help]
The H.323 Service attempts to retry every IP address resolved by the DNS server for the Media Server URL. The MediaServerTries is the number of retries for each IP address resolved by the DNS server. The H.323 Service does all the tries on each media server before moving to the next media server. Default: 1 System shutdown and startup necessary for changes to take effect.
The time interval in which metrics are output to the console and logfile. Setting this value to less than 300 seconds (5 minutes) might SetMeterInterval [<New Value> | /? | impact system performance. The meters setting must be set to "on" /help] to activate logging. Changes to this value take effect immediately. Default: 1800 seconds
ShowNewCallOnly [/? | /help]
Determines whether a call is restarted from the beginning if there is a NAM/Unified ICME or Call Server problem during the course of SetNewCallOnly [<on | off> | /? | / the call. Set this value to on to restart calls. (Because pre-routed help] calls cannot be restarted, turning this setting on means that you do not expect any pre-routed calls to come to this H.323 Service; that (Shorthand commands: sNco, setNco) is, only new calls arrive at this H.323 Service.) Note: Do not set this value to on if you expect any pre-routed calls to come to this H.323 Service. Unified CVP cannot restart pre-routed calls. Default: off Valid Values: on, off Changes to this value take effect immediately.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
367
Description
Number of seconds the Node Manager should wait to restart the H.323 Service after recognizing that it is not healthy. Delaying the restart SetNMRestartTimer [<New Value> | /? gives transferred calls ample time to terminate conversations normally.
| /help]
Default: 1800 seconds. System shutdown and startup necessary for changes to take effect.
ShowNumOutOfBand [/? | /help]
Number of connections the H.323 Service should reserve per Call Server for performing out of band communications, such as SetNumOutOfBand [<NewValue> | /? | / transferring a queued call.
help]
Default: 3 (Shorthand commands: sOutofBand, SetOutofBand) System shutdown and startup necessary for changes to take effect. connect to the out of band channels before failing and reporting an
SetOutOfBandConsecFails [<NewValue> error. |/? | /help]
ShowOutOfBandConsecFails [/? | /help] Maximum number of consecutive times the H.323 Service can try to
Default: 3 (Shorthand commands: sOBFail, SetOBFail) System shutdown and startup necessary for changes to take effect.
ShowOutOfBandTimeout [/? | /help]
Number of seconds the H.323 Service should wait to connect to out of band channels before failing and reporting an error.
Note: There is a relationship between this setting and the IVR Services Heartbeat timeout setting in the Operations Console. The Heartbeat timeout should be two times the OutOfBandTimeout setting. (For information about setting the Heartbeat timeout, refer to the Operations Console online help.) System shutdown and startup necessary for changes to take effect.
ShowPassPresentationInd [/? | /help] Controls whether the H.323 Service will pass the Calling Party
(H.323 Stack). A percentage of MaxInCalls. If the number of active incoming calls exceeds (RAIMaxThreshold/100)*MaxTotalCalls or SetRAIMaxThreshold [<NewValue> | /? exceeds (RAIMaxThreshold/100)*maxIVRports | /help] (currentTransferedCalls * (takebackPercentage/100)), an RAI indicator instructs the Gatekeeper to stop routing further incoming calls to this (Shorthand commands: sRaiMax, SetRaiMax) H.323 Service. Valid values: 0 - 100
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
368
Description
Default: 90 Note: RaiMinThreshold must be less than RaiMaxThreshold. Changes to this value take effect immediately.
ShowRAIMinThreshold [/? | /help]
(H.323 Stack). A percentage. If the number of active incoming calls drops below (RAIMinThreshold/100)*MaxTotalCalls or SetRAIMinThreshold [<NewValue> | /? (RAIMinThreshold/100)*maxIVRports - (currentTransferredCalls * | /help] (takebackPercentage/100)), an RAI indicator instructs the Gatekeeper to start routing incoming calls to this H.323 Service. (Shorthand commands: sRaiMin, SetRaiMin) Valid values: 0 - 100 Default: 80 Note: RaiMinThreshold must be less than RaiMaxThreshold. Changes to this value take effect immediately.
ShowRNATimeout [/? | /help] SetRNATimeout [<integer >0 and <=1800> | /? | /help]
H.323 Service restart necessary for changes to take effect. The number of seconds the H.323 Service waits for the called party to answer before timing out and returning an RNA error back to Unified ICME. This value can be set on either a global basis (that is, all calls have the same RNA timeout) or on a per-transfer basis based on the value of the transfer DNIS. Note: This is a global setting and cannot be adjusted on a per-call basis. Global syntax: SetRNATimeout 30 Sets the RNA timeout for all calls to be 30 seconds. Default is 15 seconds if no value is specified. Valid Values: 15 - 180 Default: 15 seconds H.323 Service restart necessary for changes to take effect. Per-call syntax: setRNATimeout " 1*:30, 20*:60, 3...:20, *:300 " The value before the colon(:) represents the transfer DNIS. The value after the colon represents the RNA timeout for that DNIS. One "*" or multiple "." can be placed at the end of the DNIS value. So, in the above example: Transfer DNIS's beginning with 1 will have a 30 sec RNA timeout. Transfer DNIS's beginning with 20 will have a 60 sec RNA timeout.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
369
Description
Transfer DNIS's beginning with 3 and containing exactly 4 characters will have a 20 sec RNA timeout. Transfer DNIS's that don't match any of the previous regular expressions will have a 300 sec RNA timeout. Precedence order for DNIS matching is as follows. Assume DNIS is 2100. In order of increasing matching precedence: * < 2* < 21* < 21.. < 2100 If a DNIS does not match any value in the list, it will default to the highest RNA timeout value specified in the list unless a specific "*:NNN" catch-all timeout is provided, in which case it will use that timeout value. Any RNA timeout value must be > 0 and <= 1800 seconds.
ShowSecurityMask [/? | /help]
This setting controls various aspects of how and who can administer and configure the H.323 Service.
Changes to this value take effect only after an H.323 Service restart. When set to value 0, remote administration of the H.323 Service using procmon is not allowed. All administration must be performed from the local machine.
ShowServiceMode [/? | /help] SetServiceMode [in | out | /? | / help]
When set to out, the H.323 Service does not accept new calls but processes all existing calls to completion. When set to in, the H.323 Service starts accepting new calls. Valid Values: in or out Changes to this value take effect immediately.
Controls whether the Dialed Number (DNIS) or Calling Line Identification (CLI) is used as the Calling Party Number in VoIP messages during IP Call Transfer. When this value is set to CLI, CLI (if present) will be passed in the Calling Party Number parameter of the Setup message during IP Transfer; when set to DNIS, DNIS are passed. Valid Values: CLI, DNIS Default: CLI Changes to this value take effect immediately.
The number of leading significant digits (not including the tech-prefix, if it exists), which Unified CVP will strip from the incoming DNIS. SetSigDigits [integer >= 0 | /? | / The value that is stripped off is saved. When the H.323 service help] receives a transfer command from Unified ICME, it first appends a
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
370
Description
# sign to this value and then prepends the resulting string to the transfer label. Note: This is a mechanism used to pair together Ingress Gateways to desired targeted transfer endpoints. Valid Values: an integer >= 0 Default: 0 Changes to this value take effect immediately.
ShowSurveyDnis [/? | /help]
One or more alternate DNIS numbers to which to restart the call. If the called party disconnects before the caller, and no further SetSurveyDnis <original Dnis-survey instructions are sent from Unified ICME within 2 seconds, the H.323 Dnis, [original Dnis-survey Dnis, Service checks this list of DNIS numbers to see if the call should be .....]> [/? | /help] restarted to an alternate DNIS. For more information on restarting a call to an alternate DNIS, see "Restart to Alternate DNIS (page 657)" in Chapter 13, "Transferring and Queuing Calls with Unified CVP, in Part 3." You must specify at least one pair of values consisting of the original DNIS number and the alternate or survey DNIS number to which the call should be restarted. Wild cards are allowed. Each pair should be delimited by a comma and the entire string enclosed in quotes. Only [0-9,*] are acceptable characters, and the *, if present, must occur at the end of a DNIS value. Examples: SetSurveyDnis "9785551515-1234" If the original DNIS was 9785551515, the call will be restarted to DNIS 1234. SetSurveyDnis "978*-1234" If the original DNIS was a DNIS beginning with 978, the call will be restarted to DNIS 1234. SetSurveyDnis "978*-800*" If the original DNIS was a DNIS beginning with 978, the call will be restarted to the same number but 978 would be replaced with 800, e.g. 9785551212 would be restarted to 8005551212. SetSurveyDnis "9785551515-1234,8003331111-9876" If the original DNIS was 9785551515, the call will be restarted to 1234, OR if the original DNIS was 8003331111, the call will be restarted to 9876. SetSurveyDnis "*-9000" If the original DNIS is anything, the call be retarted to DNIS 8000. The survey DNIS feature can be used with Unified CVP that is defined as any VRU type, provided that the SurveyDnis invokes a new call in Unified ICME. That is, the survey DNIS must not fall in a
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
371
Description
Translation route DNIS range and must be less than or equal to the "Maximum Length of DNIS" field in the ICM Service tab in the Operations Console. Changes to this value take effect immediately.
ShowTakebackDelay [/? | /help] SetTakebackDelay [<New Value in milliseconds> | /? | /help]
This setting controls the number of delay milliseconds that each comma in a transfer label represents. For example, when doing an outpulse transfer, it is sometimes desirable to place a pause between the *8 and the digits, as in *8,,,9870987465. This setting controls how long the pause is for each comma. Hence, 3 commas = 300ms if this value is set to 100. Default:100 milliseconds Changes to this value take effect immediately.
ShowTakebackPercentage [/? | /help] Percentage of currently transferred calls for which IVR ports should
Changes to this value take effect immediately. (System shutdown and startup unnecessary.) For example, if the MaxIVRPorts setting is 100, MaxTotalCalls is 300, and TakebackPercentage is 10, it would mean the following: If no calls are currently transferred, the H.323 Service would accept up to 100 calls IVR. If 50 calls are currently transferred, the H.323 Service would accept up to 95 calls IVR (then there would be 145 total calls and the H.323 Service would stop accepting new ones). If 200 calls currently transferred, the H.323 Service would accept up to 80 IVR (then there would be 280 total calls and the H.323 Service would stop accepting new ones). At 300 calls, the H.323 Service would still have room for 70 IVR but would stop taking calls, anyway, because the total number of calls would have been reached.
Specifies the tech-prefix the H.323 Service uses to reigster to the Gatekeeper. Default: 2# System shutdown and startup necessary for changes to take effect.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
372
Description
Controls whether the H.323 service will strip off the tech prefix beore it sends the call to the Call Server.
Default: on System shutdown and startup necessary for changes to take effect.
ShowTraceMask [/? | /help] SetTraceMask [<New Value> | /? | / help] ShowTransferCLI [/? | /help]
For Use by Technical Support only. Default: 0x101003 Changes to this value take effect immediately.
Controls whether the Dialed Number (DNIS) or Calling Line Identification (CLI) is used as the source address in VoIP messages SetTransferCLI [<on | off> | /? | / during IP Call Transfer. When this value is set to on, the CLI (if help] present) will be passed in the SrcInfo parameter of the ARQ message during IP Transfer; when set to off, the DNIS will be passed. (Shorthand command: sTransferCLI) Valid Values: on, off Default: off Changes to this value take effect immediately.
ShowTransferLabel [/? | /help]
A list of label values (delimited by spaces and the entire list enclosed in quotes). If any of the values in this list match the VRU label SetTransferLabel[<List of labels, configured in Unified ICME, it triggers the H.323 Service to send delimited by spaces, all enclosed in the transfer back to the originating Ingress Gateway instead of using quotes> | /? | /help] the IP address returned by the gatekeeper lookup. If this value is not set or set to 'None', the H.323 Service uses the IP address returned by the gatekeeper lookup for the transfer. Note: A gatekeeper is still needed even when this value is set. However, in that case, the IP address returned by the gatekeeper is ignored. Default: None Changes to this value take effect immediately.
ShowUUIParams[/? | /help]
Lets you to specify which lines of GTD data to pass to Unified ICME.
SetUUIParams None | Full | An incoming call (whether from the PSTN or from Unified CM) can XXX[N:N:...], [YYY[N:N:...]] | /? | contain GTD data. Generally, the data looks like this: /help] IAM, PRN,isdn*,,ATT5*, USI,rate,c,s,c,1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
373
Note: See the NSS spec (Narrowband Signaling Syntax) Q.1980.1 ITU specification for specific details about the meaning and syntax of NSS (GTD) data. Use SetUUIParams to specify data to pass to Unified ICME and whether data should be converted from 2-byte hex representation to 1-byte ASCII. (For example, the UUS value would be "303132333530" in 2-byte hex representation; in 1-byte ASCII, the value would be "012350".) For example, the command SetUUIParams CPN, UUS:2,CGN would: Pass the data in the CPN message to Unified ICME. Convert the data in the UUS message to ASCII and pass it to Unified ICME. Pass the data in the CGN message to Unified ICME. Default: None Changes to this value take effect immediately.
ShowVbRestartTimer [/? /help] SetVbRestartTimer [value /? /help]
Number of seconds the H.323 Service should wait to restart itself if it is not operating properly. Delaying the restart gives transferred calls ample time to terminate conversations normally. Default: 1800 seconds Changes to this default take effect immediately.
Shows calls the are currently active in the H.323 Service. This command displays all configuration data and real-time data for the H.323 Service.
374
sent to the gateway from the network in the Q.931 setup message. The gateway and Unified CVP can extract this data and send it to Unified ICME on a new call. Additionally, other parameters in the GTD can also be extracted and sent to Unified ICME if the user chooses. Any parameter contained in the NSS IAM message can be extracted as long as the ingress IOS gateway also extracts it. Refer to http://www.cisco.com/en/US/partner/ products/sw/iosswrel/ps5207/products_configuration_guide_chapter09186a008020ecef.html for a description of all the GTD fields IOS 12.4 will extract. Also, refer to the ITU-T Narrowband Signaling Syntax spec (Q.1980.1) for a detailed description of the IAM message. This feature is available in Unified CVP Comprehensive and VRU-Only call flow models and can be used with any Unified CVP VRU type.
How it Works
The external system inserts the desired values into the dat field of the UUS parameter of the NSS IAM message. These NSS messages are used as the basis for building the GTD data that ultimately arrives at the IOS gateway from the PSTN. Note that the UUS dat field is represented by pairs of hexadecimal digits. This means that if the external system wants to pass "12345" in the UUS dat field, it will arrive to the gateway with the following representation: "3132333435". By default, this 2-byte hexadecimal value is passed to Unified ICME. The Unified ICME script must manipulate this value using the Formula Editor. The user can specify an option on the gateway or the Unified CVP H.323 Service to convert to the 1-byte ASCII representation (that is, "12345") before passing to Unified ICME. Any data that cannot be represented by a printable ASCII character will be replaced with a "." character. Therefore, if the incoming GTD data from the network contains binary data (such as counters), this option should not be used since it will result in a loss of valuable information. Additionally, other fields from the IAM message can also be utilized, if desired. How that data moves from the gateway to the Unified ICME differs depending on the deployment model used. The format in which the data appears in Unified ICME will also be somewhat different based on the deployment model. In any case, Unified ICME 7.1(1) and beyond will accommodate a maximum length of 131 characters. Before that release, Unified ICME will only accommodate a maximum length of 36 characters.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
375
The Unified CVP H.323 Service extracts the GTD fields the user has configured using VBAdmin. The user must explicitly extract the UUI using the VBAdmin setUUIUnified CVP Call Server in the HTTP URL as the CALL_UUI. The Call Server places the CALL_UUI data in the ICM Service UUI variable, which is then passed to Unified ICME. Unified ICME makes that data available in the Call.UserToUserInfo field in the Unified ICME script. It also stores it in the UserToUser column in the TCD (Termination Call Detail record) in the database.
Description
When on, the H.323 Service logs basic call detail information to the console and log files. Valid Values: on, off
(Shorthand command: sCallTrace) Default: off Changes to this value take effect immediately.
ShowInterfaceTrace [/? | /help]
When on, the H.323 Service logs interface details to the console and log files.
When on, H.323 details will be logged to the console and log files. Valid Values: on, off Default: off Changes to this value take effect immediately.
For use by Technical Support, only. Default: 101003HEX Changes to this value take effect immediately.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
376
Command Syntax
Description
DisconnectCall [<LocalID> | /? | / Disconnects the call identified by Local ID from the active call list help] (after confirmation).
Displays the following information about each call active in the H.323 Service: Local ID Unique Call ID Creation Time State Duration DNIS ANI Last Call Server the call accessed Last Media Server the call accessed
Can be used to print out a detailed call history of an active call. Either the long or short call ID may be entered as the argument. Default: none
ShowIntervalStatistics [/? | /help] Displays the interval time, and a series of counts, averages and
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
377
Command Syntax
Description
Interval size. Number of new calls. Number of calls transferred. Number of calls rejected (if H.323 Service is out of service). Number of transfer errors. Number of prompts not ready. This is the number of times a prompt was playing, and before the end of the prompt was reached, the H.323 Service had to stop playing the prompt because the next part of the file had not yet been received. Number of prompts not found. Number of calls using critical media, that is, that were prematurely terminated because of internal errors (in which case a system error message is played to the caller). Note: These do not always represent call drops. Sometimes, incorrect call release configuration in Unified ICME scripting and configuration can cause these errors; however, they should be considered suspect. Number of calls terminated (call may have begun in a previous interval). Percent of total system CPU used - average, minimum, maximum and standard deviation. For each H.323 Service, average, minimum, maximum and standard deviation of the latency statistics in processing a new call arrival. This represents the round-trip time from when the H.323 service first receives the new call from the network to the time the H.323 service receives a response from Unified ICME. Note: This would include the time involved for the Unified ICME to perform back-end database lookups, if required. If there are no back-end database lookups, an average value of greater than 1000 ms indicates potential network problems. For each H.323 Service, average, minimum, maximum and standard deviation of the latency statistics in processing a successful transfer, measuring the time from when the H.323 Service receives the Transfer command from the Call Server to the time of alerting. An average value of greater than 1000 ms indicates potential network problems.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
378
Command Syntax
Description
For each H.323 Service, average, minimum, maximum and standard deviation of the latency statistics in processing a successful transfer, measuring the time from alerting to when the called party answers. For each Call Server, average, minimum, maximum and standard deviation of the latency statistics in communicating with Call Server for call processing requests, and the number of message exchanges (requests to the Call Server from the H.323 Service). This represents the round-trip time from when the H.323 service sends a request (not including new call requests) to Unified ICME to the time the H.323 service receives a response from Unified ICME. Note: This would include the time involved for Unified ICME to do back-end database lookups, if required. If there are no back-end database lookups, an average value of greater than 1000 ms indicates potential network problems. Note: Averages, minimums, maximums and standard deviation statistics are calculated by using current data (occurring within this interval), not rolling averages (occurring over multiple intervals). Call latency is displayed in milliseconds.
ShowLogMeters [/? | /help] SetLogMeters [<on | off> | /? | / help]
Controls logging metrics. When on, the H.323 Service will log metrics to the console and log files at the interval specified by the Message Meter Interval setting. Metrics are always available on demand for the last interval(s). Valid Values: on, off Default: on Changes to this value take effect immediately.
Time interval, in seconds, at which metrics will be calculated. Note that, if logging of metrics is on, setting the interval to a short time SetMeterInterval [<NewValue> | /? | will cause the log files to roll over more quickly. Also, the Meters /help] parameter must be set to on to activate logging. (Shorthand command: sMeterInterval) Default: 1800 seconds (30 minutes) Changes to this value take effect immediately. (System shutdown and startup unnecessary.)
ShowServiceMode [/? | /help]
Controls the processing of calls. When out (out of service), the H.323 Service will not accept new calls but will process all existing calls to SetServiceMode [<in | out> | /? | / completion. When in (in service), the H.323 Service will accept new help] calls. (Shorthand commands: sServMode, setServMode) Valid Values: in, out
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
379
Command Syntax
Description
Changes to this value take effect immediately. (System shutdown and startup unnecessary.)
ShowSnapshot [/? | /help]
Gives a count of all the calls in progress, and subtotals for the count in each state. The states include: Waiting for VoiceXML (or for response from Call Server) Playing Prompt Waiting for DTMF Transferred Disconnecting Disconnected (caller has been disconnected and software is just finishing up) New (call has arrived, but processing has not started yet) IVR Ports in use (a call is in one of two states at any point in time: receiving IVR treatment, or transferred. Time spent in all call setupH.323 activity plus communications to Unified ICMEcounts as being in the IVR state. Therefore, even though a call may be immediately transferred upon arrival at Unified CVP, there is still a brief periodseveral secondsthat the call is in the IVR state until the endpoint answers the call. IVR Ports in use shows the number of calls in the IVR state at any point in time) Wait (a transient internal state; calls should never stay in this state any length of time; this number increasing over time indicates a problem) Other (calls should never be in this state; a catch-all for problem calls) Internal (for debugging purposes only; shows the total number of calls in the internal call object map in the H.323 Service; includes all active call legs, plus calls that are marked for deletion). Note: The value of Internal Call Count should not be greater than the value of ShowMaxTotalCalls; it it is, it indicates that there is a memory leak in the H.323 Service. Also, this number can be greater than 0 when no calls are active in the system, as this value represents the number of call objects, not the number of active calls.
Status gives the overall status for the Call Server for the entire time the H.323 Service has been up, including: Total calls
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
380
Chapter 9: Administering the Unified CVP H.323 Service Performing H.323 Blind Transfers
Command Syntax
Description
Disconnect Disposition (Rejected, Caller Hangup, Called Party Hangup, ICM Release, Critical Media) Maximum Simultaneous Calls Maximum IVR Ports Total Prompts Not Found Total Transfer Errors (Busy, Ring No Answer, Gatekeeper Problem, Destination Problem, Other) System Startup Time System Up Time Current System State (In Service, Out of Service) Packets Transmitted
ShowVersion [/? | /help]
Displays release number (e.g., 4.0) and build number of the software.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
381
Chapter 9: Administering the Unified CVP H.323 Service Performing H.323 Blind Transfers
survivability script strips the RF number, terminates #, and connects the caller to the label using the configured dial-peer and releases the call control to the Unified CVP H.323 Service. Note: This feature is only available for PSTN-originated calls via IOS GW running Unified CVP survivability service. This feature can be used in both the Comprehensive and the Call Director call flow models.
Set the user.h323.rftransfer ECC variable in a Unified ICME script. When using this ECC variable in a Unified ICME script, it must be set to the value of the single character "y" or "Y" and Unified CVP will use the RF method when transferring to the agents. Alternatively, use a fixed RF label in a Unified ICME script. The RF label format for H.323 service is "RF<Rf number>#<destination label>#" . An RF number (default is 88) identifies the type of transfer for Unified CVP survivability service. For example, if the destination label is 1002, then the corresponding RF label should be RF88#1002#. If the user.h323.rftransfer ECC variable is set to "y," then the Unified CVP H.323 Service will modify the received label automatically to conform to the format given above.
Step 2
When using H.323 RF transfers, the Ingress gateway must include an outbound voip dial peer. This outbound dial peer is necessary because when the RF transfer message enters the gateway from the Call Server, it needs to match an outbound dial peer in order for the call to succeed. For example:
dial-peer voice 1050 voip destination-pattern 1... voice-class codec 1 session target <your h323 destination> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
Step 2
Enable the Unified CVP survivability service to execute the H,323 RF transfers by using the following parameter: param icm-rf 1. The default RF number in the Unified CVP survivability script can be changed using param rf-number <new RFnumber>.
Change the default RF number (88) using the Unified CVP VBAdmin setRFN <new RFNumber> parameter. Note: Do not append any characters to the Temp connect using Label+corrId even if h323.rftransfer is set to "y" or "Y" in the Unified ICME script.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
382
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
383
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
384
Chapter 10
Using Cisco Unified ICME Warm Consult Transfer/Conference to Unified CVP
This chapter provides information about the minimal software component release requirements for the Unified ICME Warm Consult Transfer and Conference to Unified CVP feature for the H.323 Service and Type 2/7 VRUs. Resource sizing and configuration requirements are also included. Note: For information about using the Warm Consult Transfer feature with SIP and Type 10 VRUs, see the "Using the Warm Transfer Feature with SIP Calls (page 388)" section. Also, see the configuration instructions for the Call Director and Comprehensive call flow models using SIP in Chapter 2, "Configuration Overview (page 27)," in Part 1. This chapter contains the following topics: About Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature, page 385 Resource Sizing for Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature, page 386 Configuring Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature, page 387 Minimal Component Version Required, page 388 Using the Warm Transfer Feature with SIP Calls, page 388 Using the Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature with a Type 10 VRU, page 389 Using Blind Transfer with Unified CVP as a Type 10 VRU, page 390
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
385
Chapter 10: Using Cisco Unified ICME Warm Consult Transfer/Conference to Unified CVP About Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature
to provide queue music to the first agent. To Unified CVP, this appears as a new call from an IP phone. However, due to the nature of the call signaling, this type of call requires a Media Termination Point (MTP) resource to be allocated in Unified CM. Optionally, customer business call flows may require that IP phone users call Unified CVP directly. For example, you may have a corporate IP phone network that is serviced by a Unified CVP help desk call center. IP phone users with problems would call a Unified CVP number to open trouble tickets. These IP phones require MTP resources in Unified CM if callers perform any supplementary services, such as putting the Unified CVP agent on hold. This requires additional sizing and configuration, as noted in the IP-originated calls only instructions below.
Resource Sizing for Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature
The Unified ICME Warm Consult Transfer/Conference to Unified CVP feature requires the following steps:
Step 1
Assign a separate Call Server dedicated to accepting the warm transfer queue calls from Unified CM. This is because MTP must be enabled in Unified CM for the Unified CVP H.323 gateway device for calls that Unified CM sends to Unified CVP. Since is not recommended that you enable MTP in Unified CM for calls that do not require warm transfer functionality, it is necessary to segregate Unified CVP calls that perform the warm transfer queuing. Determine the maximum number of calls that could be in the warm consultative transfer state at any one time. Use this number to size the number of MTP resources that are required in Unified CM. One way to approximate this is to monitor the Unified ICME script that processes consultative transfer requests from the agents. Look at the Unified ICME script monitor during a busy hour and note the number of calls that exit the Queue to Skill Group node via the queue path (the 'check' path out of the Queue to Skill Group node). For example, assume that: Unified ICME script monitor shows 360 calls over a 60-minute period during busy hour in this script path. The average length of (agent queue time + subsequent transfer/conference time) = 6 minutes. (360 calls / 60 minutes) * 6 minutes = 36 calls. Each call uses 2 MTP resources = (36 calls * 2 resources) = 72 MTP resources.
Step 2
Step 3
(IP-originated calls only). Determine if customer business call flows require that IP phone users callUnified CVP directly (as described in About Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature (page 385)). Find the maximum number of IP-originated calls that could simultaneously be active in Unified CVP at any one time. For example, you find the number is 30. Each call requires 2 MTP resources, so the total MTP resources required would be 60. Add the two numbers obtained from steps 2 and 3 (in this example, 72 + 60). This is the number of MTP resources that must be allocated in Unified CM.
Step 4
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
386
Chapter 10: Using Cisco Unified ICME Warm Consult Transfer/Conference to Unified CVP About Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature
Allocate some additional percentage of MTP resources to handle unexpected call volume spikes. Either software or hardware MTP may be used, keeping in mind that software MTP consumes significant Unified CM CPU resources.
Install a new Call Server (refer to the Installation and Upgrade Guide for Cisco Unified Customer Voice Portal for detailed information). It can be configured identically to all other Unified CVP machines, with the exception that you must add each Translation Route DNIS. Define it as a Type 2 VRU in the Network VRU Explorer tool in Unified ICME. Network Transfer Preferred must be disabled for this peripheral . Add a new DNIS in the Add DNIS box on the ICM tab in the Operations Console. Be sure to add each translation route DNIS.
Step 2
If the Unified CVP machine resides in a different location from the Unified CM cluster initiating the calls, WAN bandwidth will be a consideration since the prompts are played G.711 from the Unified CVP machine. In this case, size and configure the network appropriately. Where possible, Unified CVPshould be co-located with Unified CM to eliminate these bandwidth requirements. Define a gateway device in Unified CM for the Unified CVP machine installed in Step 1. Under Device > Gateway, define an H.323 gateway using the Unified CVP IP address. Be sure to enable the Media Termination Point Required checkbox. Configure MTP resources according to Unified CM instructions for the type of MTP that you have selected to use (software or hardware). (IP-originated calls only). Determine if customer business call flows require that IP phone users call Unified CVP directly (as described in the second paragraph of About Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature (page 385)). IP-originated calls must be routed to Unified CVP, which has MTP enabled. This allows the caller to perform supplementary services, such as putting Unified CVP on hold. In Unified CM administration under Route Plan using route groups/lists/patterns, route Unified CVP DNISs to the Unified CVP gateway installed in Step 1 above. If you want to load-balance between two Unified CVP systems: Define an additional Unified CVP gateway device in Unified CM with MTP enabled. Create a route group and put both of the Unified CVP gateways in the route group, both with order priority 1. Create a route list and put the route group in the route list. Create a route pattern and assign the route list to the route pattern.
Step 3
Step 4
Step 5
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
387
Chapter 10: Using Cisco Unified ICME Warm Consult Transfer/Conference to Unified CVP Minimal Component Version Required
In Service Parameters for Unified CM, set Reorder Route List to TRUE and the 'H225 TCP timer' to 5. Note: The Reorder Route List setting applies only for Unified CM 3.3 and earlier.
Step 6
Create a Unified ICME script similar to the script below. (Refer to the Unified ICME documentation for information.) This script should be tied to the Dialed number and call type that the agent invokes to do a warm consultative transfer/conference. This dialed numbers Routing Client should be associated with a Unified CM peripheral from which the agent will be invoking the transfer or conference.
Figure 37: Unified ICME Script for Warm Consult Transfer
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
388
Chapter 10: Using Cisco Unified ICME Warm Consult Transfer/Conference to Unified CVP Using the Warm Transfer Feature with SIP Calls
CVP then sends the "request instruction" message back to Unified ICME on the Unified CVP routing client and starts the queuing. Note: These SIP calls do not require MTP enablement on the SIP trunks. If consult transfer should happen while the call is in the queue (VXML Gateway), the call will need an MTP resource. When using the Warm Transfer feature for SIP Calls with queuing, call flows must have MTP enabled on the SIP trunk that is associated with the VRU label route pattern in the case where the agent completes consult transfer to caller while the call is still in the queue (VXML Gateway). Note: MTP is not required for single step transfer or if the agent waits before connecting to the second agent.
Using the Unified ICME Warm Consult Transfer/Conference to Unified CVP Feature with a Type 10 VRU
Note: Unified CVP with a Type 10 VRU does not support multiple Network VRUs on the same Unified CVP peripheral device. Multiple customer instances can be used in order to address multiple Network VRUs, but they must then address different physical Unified CVP Call Servers as well. Calls that originate from an ACD or Unified CM, such as Warm Transfer/Conference, Helpdesk, or Outbound calls, are also limited to one Network VRU on any given Unified CVP Call Server. Note that the reverse is no problem: multiple Unified CVP Call Servers can share the same Network VRU. In this scenario, an agent needs to transfer a call to another agent by dialing that agent's ID. If the agent is not available, the originating agent will be placed in a queue to wait for the second agent to pick up the call. In order for the first agent to be queued while waiting for another agent, set up the following configuration:
Step 1
In the ICM Configuration Manager's PG Explorer tool Routing Client tabs, uncheck the NetworkTransferPreferred checkbox for Unified CM and Unified CVP routing clients. On the Advanced tab for the Unified CM routing client, select None for the Network VRU and your Type 10 VRU for the Unified CVP routing client. For your Type 10 VRU, in the ICM Configuration Manager's Network VRU Explorer tool define a label for the Unified CM routing client as well as the Unified CVP routing client and associate them with a customer instance. In the ICM Configuration Manager's Dialed Number List Tool, associate the dialed numbers for the incoming call as well as the transfer dialed number with the same customer instance. When the second call is placed for the warm transfer and no agent is available, the label defined on the Unified CM RC plus the correlation ID will be sent back via EAPIM/JGW to Unified CM (for example, if the label is 7777777777, with a correlation ID it could be 777777777712345) since the call originated from the Unified CM RC and since the NetworkTransferPreferred checkbox is not checked.
Step 2
Step 3
Step 4
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
389
Chapter 10: Using Cisco Unified ICME Warm Consult Transfer/Conference to Unified CVP Using the Warm Transfer Feature with SIP Calls
Step 5
In Unified CM, select Call Routing > Route/Hunt > Route Pattern > Add New. Add a new route pattern to route the call to Unified CVP via either the SIP trunk if you are using SIP, or via a GK controlled trunk with MTP enabled when using H.323 (for example, 777! where ! allows label plus arbitrary length correlation ID).
When Unified CVP sees this call, it perceives it as a pre-routed call with a correlation id and sends it back to Unified ICME to continue the script. Unified ICME sends a temporary connection back to Unified CVP, which queues the agent call while the caller hears music on hold (MoH) from Unified CM.
Uncheck the Wait for Far End H.245 Terminal Capability Set parameter in CCMAdmin for the Unified CVP gateway device. Change the value of the Unified CM H323 Service Parameter called Send H225 User InfoMessage to the value H225 Info for Call Progress.
Step 2
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
390
Chapter 11
Configuring Unified CM
This chapter describes how to configure Unified CM. Once Unified CM has been configured, you can add a pre-configured Unified CM server to the Operations Console network control panel. Once added, you can add the Unified CM Server to a device pool and access a Unified CM administration web page (see the "Configuring a Cisco Unified Communications Manager Server (page 392)" section). This chapter contains the following topics: Configuring Unified CM for Use with Unified CVP, page 391 Configuring a Cisco Unified Communications Manager Server, page 392
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
391
Chapter 11: Configuring Unified CM Configuring a Cisco Unified Communications Manager Server
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
392
Chapter 11: Configuring Unified CM Configuring a Cisco Unified Communications Manager Server
Information You will Need: IP address URL for the web administration page for the Unified CM Server
Procedure
To add a Unified CM Server:
Step 1
Choose Device Management > Cisco Unified Communications Manager. The Find, Add, Delete, Edit CCM Servers window opens.
Step 2
Click Add New. The CCM Server Configuration window opens to the General tab.
Step 3
Fill in the appropriate configuration settings as described in Unified CM Configuration Settings (page 394). Optionally, select the Device Pool tab and add the Unified CM Server to a device pool. When you finish configuring the Unified CM, click Save to save the configuration.
Step 4 Step 5
See Also Viewing Device State (page ?) Unified CM Configuration Settings (page 394) Add the Unified CM Server to a device pool (page ?)
Procedure
To edit a Unified CM Server:
Step 1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
393
Chapter 11: Configuring Unified CM Configuring a Cisco Unified Communications Manager Server
From the list of matching records, choose the Unified CM Server that you want to edit. Click Edit. The Edit CCM Server Configuration window opens to the General tab with the current settings displayed.
Step 4
Change the desired configuration settings as described in Unified CM Configuration Settings (page 394). You cannot change the IP address of the Unified CM Server. Optionally, select the Device Pool tab and add the server to a device pool. When you finish configuring the server, click Save to save the configuration.
Step 5 Step 6
See Also Viewing Device State (page ?) Finding a Unified CM Server (page 395) Unified CM Configuration Settings (page 394) Adding and Removing Devices from Device Pools (page ?)
Field
Description
Default
Range
General IP Address Hostname The IP address of the Unified CM Server The name of the Unified CM Server None None Valid IP address Valid DNS names, which can include letters in the alphabet, the numbers 0 through 9, and a dash. Any text A valid URL. The Operations Console will validate the URL for syntax errors but does not check that the site exists.
The description of the Unified CM Server The Administration URL for the Unified CM Server
None None
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
394
Chapter 11: Configuring Unified CM Configuring a Cisco Unified Communications Manager Server
Procedure
To delete a Unified CM Server:
Step 1
Choose Device Management > Cisco Unified Communications Manager. The Find, Add, Delete, Edit CCM Servers window opens.
From the list of matching records, choose the Unified CM Server that you want to delete. Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
Procedure
To find a Unified CM Server:
Step 1
Choose Device Management > Cisco Unified Communications Manager Server from the Main menu. The Find, Add, Delete, Edit CCM Servers window lists the available CCM Servers, sorted by name, 10 at a time.
Step 2 Step 3
If the list is long, click Next to view the next group of available devices. If you know the host name of a particular Unified CM, enter its name in the Search text box and then click Go.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
395
Chapter 11: Configuring Unified CM Configuring a Cisco Unified Communications Manager Server
Step 4
To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with is exactly is empty
Step 6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
396
Chapter 12
Configuring the SIP Devices
This chapter describes how to configure SIP calls on the gateway, Call Server, and Proxy Server. This chapter contains the following topics: Configuring a SIP Proxy Server, page 397 Load-balancing SIP Calls, page 402 How to Set Up the Ingress Gateway to Use Redundant Proxy Servers, page 402 How to Set Up the Unified CVP Call Server with Redundant Proxy Servers, page 403 REFER Transfers Using "RFXXXX" Type Unified ICME Labels , page 403 Using the sendtooriginator Setting in the SIP Service, page 404 Expiration Timeout Setting Using Dialed Number Patterns in SIP, page 405 Critical Error Message Playback on Abnormal Disconnects with SIP , page 405 Delivering SIP Incoming UUI to Unified ICME Routing Script, page 406
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
397
Chapter 12: Configuring the SIP Devices Configuring a SIP Proxy Server
Configure the following characteristics of the SIP Proxy Server for use with Unified CVP: A static route to the Unified CVP Call Server, Unified CM SIP trunks, VoiceXML gateway, and Ingress gateway for the transfer to the ringtone playback dialed number and error playback dialed number. Note: You must configure a Unified CM SIP trunk on Unified CM to point to the SIP Proxy Server. In a cluster with multi-subscribers and device pools, adding only one SIP trunk per proxy in the default device pool will be sufficient. Incoming Access Control Lists (ACLs) for Unified CVP calls. Unified CVP works with RFC-3261-compliant SIP Proxy Servers and has been qualified with the following: Unified CVP works with the CUPS Proxy server, not the presence engine (PE). You can perform the following tasks: Adding a SIP Proxy Server (page 398) Deleting a SIP Proxy Server (page 399) Editing a SIP Proxy Server (page 400) Finding a SIP Proxy Server (page 400)
Procedure
To add a SIP Proxy Server:
Step 1
Choose Device Management > SIP Proxy Server. The Find, Add, Delete, Edit SIP Servers window opens.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
398
Chapter 12: Configuring the SIP Devices Configuring a SIP Proxy Server
Note: To use an existing SIP Proxy Server as a template for creating the new SIP Proxy Server, select the SIP Proxy Server by clicking the radio button preceding it and then click Use As Template.
Step 2
Fill in the appropriate SIP Proxy Server configuration settings on the General tab. Optionally, select the Device Pool tab and add the SIP Proxy Server to a device pool. When you finish configuring the SIP Proxy Server, click Save to save the configuration.
See Also SIP Proxy Server Configuration Settings (page 401) Adding and Removing a Device from a Device Pool (page ?) Viewing Device State (page ?) Review the Configuration Checklist (page 571)
Procedure
To delete a SIP Proxy Server:
Step 1
Choose Device Management > SIP Proxy Server. The Find, Add, Delete, Edit SIP Proxy Server window displays.
From the list of matching records, choose the SIP Proxy Server that you want to delete. Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
399
Chapter 12: Configuring the SIP Devices Configuring a SIP Proxy Server
Procedure
To edit SIP Proxy Server:
Step 1
Choose Device Management > SIP Proxy Server. The Find, Add, Delete, Edit SIP Servers window opens.
Step 2 Step 3
From the list of matching records, choose the SIP Proxy Server that you want to edit. Click Edit. The SIP Proxy Server Configuration window opens with the current settings displayed.
Step 4
Fill in the appropriate configuration settings on the General tab. You cannot change the IP address of the SIP Proxy Server. When you finish configuring the SIP Proxy Server, click Save to save the configuration.
Step 5
See Also Viewing Device State (page ?) Finding a SIP Proxy Server (page 400) SIP Proxy Server Configuration Settings (page 401)
Procedure
To find a SIP Proxy Server:
Step 1
Choose Device Management > SIP Proxy Server from the Main menu. The Find, Add, Delete, Edit SIP Proxy Servers window lists the available proxy servers of the type you selected, sorted by name, 10 at a time.
Step 2
If the list is longer than 10 devices, click Next to view the next group of available devices.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
400
Chapter 12: Configuring the SIP Devices Configuring a SIP Proxy Server
Step 3
If you know the hostname of a particular SIP Proxy Server, enter the name in the Search text box and then click Go. To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP Address Description Is empty
Step 4
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with is exactly is empty
Step 6
Field
Description
Default
Range
IP Address Hostname
The IP address of the SIP Proxy Server The host name of the SIP Proxy Server The description of the SIP Proxy Server
None None
Valid IP address Valid DNS name, which can include letters in the alphabet, the numbers 0 through 9, and a dash Up to 1,024 characters
Description
None
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
401
Field
Description
Default
Range
None
A valid URL. The UI will validate the URL for URL syntax errors but no validation for site existence.
Configure the gateway with the following to send calls to redundant proxy servers as resolved using DNS SRV lookup:
ip domain name <your domain name> ip name-server <your DNS server> sip-ua sip-server dns:<your SRV cluster domain name> dial-peer voice 1000 voip session target sip-server
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
402
Chapter 12: Configuring the SIP Devices REFER Transfers Using "RFXXXX" Type Unified ICME Labels
How to Set Up the Unified CVP Call Server with Redundant Proxy Servers
The Device Management SIP proxy server section in the Operations Console does not currently allow the SRV cluster domain name to be configured as an outbound proxy server, since this by itself does not have an IP address.
Step 1
To send calls from Unified CVP to the SRV cluster name, set Enable outbound proxy to No in the Operation Console's Call Server SIP configuration (select Device Management > CVP Call Server > SIP tab). Create a local static route with the wildcard character of ">" to match all calls. Send this to the hostname of your SRV cluster domain name. (Do not specify the port at the end of the SRV domain name.) The following screen shot example displays this configuration:
Figure 39: Local Static Route Configuration
Step 2
Note: Valid Dialed Number patterns are the same as for the ICM label sizes and limitations, including: Use the period (.) or the X character for single-digit wildcard matching Use the greater than (>), asterisk (*), or exclamation(!) character as a wildcard for 0 or more digits Do not use the character T for wildcard matching Dialed numbers must not be longer than 24 characters
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
403
Chapter 12: Configuring the SIP Devices Using the sendtooriginator Setting in the SIP Service
However, if the transfer fails, configure survivability to transfer the call elsewhere. This process is not the same as an ICM router requery; for example, as it will appear as a new call to Unified ICME, but it is a way to take an alternate action, if the transfer fails. Note: This feature can be used in Comprehensive (SIP only), Call Director, and Standalone call flow models. Using this feature, the call can be queued at the VoiceXML gateway and then sent to an agent with a Unified ICME label that begins with the letters "rf." Otherwise, standard Unified ICME agent labels enable Unified CVP to remain in the signaling path for the duration of the call, and the licensed Unified CVP resource will not be freed until the end of the call. REFER transfers can be made to Unified CM or other SIP endpoints in the SIP cloud, such as an ACD. The ECC variable "user.sip.refertransfer" can also be set in Unified ICME scripts. (When using this ECC variable in an Unified ICME script, it must be set to the value of the single character "y" and Unified CVP will use REFERs when transferring to the agents.) When using REFER transfers, including the REFER used to play back critical_error.wav for abnormal disconnects, the Ingress gateway must include an outbound voip dial peer. This outbound dial peer is necessary because when the REFER message enters the gateway from theUnified CVP Call Server, it needs to match an outbound dial peer in order for the call to succeed; otherwise, a 503 rejection occurs if no dial peers match the REFER-TO header URI. Dial peer destination targets must match the labels in the REFER-TO SIP URI; that is, <errorDN>@<sip-server> and other labels that might be used in the Unified ICME routing label. For example:
dial-peer voice 1050 voip destination-pattern 1... voice-class codec 1 session protocol sipv2 session target <your sip-server destination> dtmf-relay rtp-nte h245-signal h245-alphanumeric no vad
When configuring Route Patterns on Unified CM for REFERs to destinations outside of the cluster, such as to CUPS or the gateways directly, you must add SIP Route Pattern for the SIP Trunk associated with that endpoint. For example, if you use REFER to Error DN to the IP Originated caller on Cisco Unified Communications Manager, and the host of the REFER To header SIP URL is the CUPS proxy, you must create a SIP Route Pattern with that IP address or domain name and associate it with your SIP Trunk for CUPS.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
404
Chapter 12: Configuring the SIP Devices Expiration Timeout Setting Using Dialed Number Patterns in SIP
For the Unified CVP Branch call flow model, incoming calls into the Unified CVP Call Server from the gateway might be automatically routed back to the originating gateway at the branch using the"sendtooriginator" setting in the SIP Service of the Call Server. This setting overrides sending the call to the outbound proxy or to any locally configured static routes on Unified CVP. It is also limited in use to calls from the IOS gateway SIP "User Agent," as it will check the User Agent header value of the incoming invite to verify this information. If the label returned from Unified ICME for the Unified CVP transfer matches one of the configured patterns under the Unified CVP "sendtoorginator" settings, then the call will be routed to the SIP URL of "sip:<label>@<host portion from header of incoming invite>." This functionality is similar to the Unified CVP H.323 "SetTransferLabel" setting for the H.323 calls.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
405
Chapter 12: Configuring the SIP Devices Delivering SIP Incoming UUI to Unified ICME Routing Script
How It Works
Critical Error Message playback works as follows: For typical TDM calls using the survivability service on the IOS Gateway, the error message is played using the survivability script when it detects the non-normal disconnect code after Unified CVP has disconnected the call (see SIP BYE message). The display name of "--CVP" is appended in a Remote Party ID header of the SIP call. This is how the SIP Service can identify the incoming call as using survivability or not; for example, IP-originated Cisco Unified Communications Manager callers will not have this setting. All TDM callers must have survivability service. For IP-originated calls that the SIP Service detects is not using the survivability service, when the call is disconnected and the reason code is abnormal, Unified CVP sends a REFER message with the SIP URL of the error DN. The error DN needs to be configured in the dial plan to point to an IOS gateway that has the cvp-error TCL service configured. When the caller gets the REFER TO destination, it attempts to blind transfer the call to the Unified CVP Error service on the gateway. Once Unified CVP sends a REFER for error message playback, it cannot retrieve the call, so it is important to confirm this mechanism is configured correctly during deployment. For any call that Unified CVP sees is not using the survivability service, it will attempt the REFER method to the error DN for critical error message playback for abnormal disconnects.
How It Works
Assume the following ISDN data is sent in the call to Unified CVP:
PRN,isdn*,,ATT5*, USI,rate,c,s,c,1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
406
Chapter 12: Configuring the SIP Devices Delivering SIP Incoming UUI to Unified ICME Routing Script USI,lay1,ulaw TMR,00 CPN,00,,u,5900 CPC,09 FCI,,,,,,,y, UUS,3,3132333435 GCI,87c0c79d91dd11daa9c4000bfda207f2
Note: By default, UUS field data is converted from 2-byte hex representation to 1-byte ASCII; for example, the UUS value would be"303132333530" in 2-byte hex representation; in 1-byte ASCII, the value would be "012350." The Generic Type Descriptor (GTD) Parameter Forwarding configuration setting in the Operations Console is used for passing GTD (UUI) data to Unified ICME in a new call. (The default is UUS.) Additionally, other parameters in the GTD can also be extracted and sent to Unified ICME. (UUS,PRN,GCI) use comma-separated values. Any parameter contained in the NSS IAM message can be extracted. (Refer to the ITU-T Narrowband Signaling Syntax spec(Q.1980.1).) Configure the SIP Service by selecting Device Management > CVP Call Server > SIP tab in the Operations Console and make an entry for the Generic Type Descriptor (GTD) Parameter Forwarding with the string to forward using the parameter names delimited by commas. For example, configure the SIP Service with the string UUS,PRN,GCI to forward these three parameters in a concatenated string to Unified ICME. The Unified ICME script needs to retrieve the call variable on the route request message called "UsertoUserInfo," and parse out the needed information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
407
Chapter 12: Configuring the SIP Devices Delivering SIP Incoming UUI to Unified ICME Routing Script
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
408
Chapter 13
Transferring and Queuing Calls with Unified CVP
IVRs from Unified ICME's Perspective
Essentially, Unified ICME categorizes IVRs into one of two types: Intelligent Peripheral IVRs, whereunder Unified ICME's controlthe carrier network routes calls to the IVR and then removes calls from the IVR for delivery to agents. With Intelligent Peripheral IVRs, once the IVRs prompting or queuing treatment has been completed, the IVR typically has no further role to play for that call. Service Node IVRs, wherefollowing prompting/queuing treamentthe IVR initiates call delivery to agents, who are under Unified ICME's control. When functioning as a Service Node IVR, Unified CVP can stay involved with a call even after it has been transferred to another VoIP endpoint. Unified CVP can act as either IVR type. Note: For complete information about the call flow models available for Unified CVP, see Chapter 2, "Configuration Overview (page 27)," in Part 1.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
409
Chapter 13: Transferring and Queuing Calls with Unified CVP Transferring Calls Using Unified CVP in Comprehensive Mode
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
410
Chapter 13: Transferring and Queuing Calls with Unified CVP Transferring Calls Using Unified CVP in Comprehensive Mode
The Network VRU Script List tools Attribute tab in the figure above shows: 1. The VRU Script Name field contains two Unified CVP parameters: M. Menu OfficeHours. Media File name 2. The Config Params field contains the following Unified CVP parameter: 0. The number 0 is the only valid option.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
411
Chapter 13: Transferring and Queuing Calls with Unified CVP Transferring Calls Using Unified CVP in Comprehensive Mode
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
412
Chapter 13: Transferring and Queuing Calls with Unified CVP Transferring Calls Using Unified CVP in Comprehensive Mode
The Network VRU Script List tools Attribute tab in the figure above shows: 1. The VRU Script Name field containing two Unified CVP parameters: M. Menu Queue. Media File name 2. The Configuration Param field containing the following Unified CVP parameters: 1-2,0. The numbers. 1, 2, and 0 are valid options
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
413
Chapter 13: Transferring and Queuing Calls with Unified CVP Transferring Calls Using Unified CVP in Comprehensive Mode
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
414
Chapter 13: Transferring and Queuing Calls with Unified CVP Transferring a Call from Agent to Agent
In EA PG setups where the EA is behind a PBX, use the Network Transfer Preferred checkbox on the PG Explorers Routing Client tab. If this box is checked, Network Transfer is enabled; if unchecked, Network Transfer is not enabled.
Figure 44: Network Transfer Script
Define a CTI Route Point, for example "9999", in Unified CM. Associate it with the JTAPI User that is connected to Unified CCE PIM in Unified ICME. In the ICM Admin Workstation, define a Dialed Number for Unified CCE PIM and a call Type for that dialed number. This call type can then be associated with a Unified ICME Script, for example "NetXfer2".
Step 2
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
415
Chapter 13: Transferring and Queuing Calls with Unified CVP IP Transfer Example (Unified CCE Routing)
Note: Do not define the labels of agents for the Unified CCE PIM. Instead, define the labels for VRU PIM so that the route result will be returned to VRU instead of Unified CCE PIM. If you do define the agent labels for the Unified CCE PIM, the Unified ICME router returns the route result to the VRU PIM if "Network Transfer Preferred" is enabled on the Unified CCE PIM and VRU PIM and returns the route result to the Unified CCE PIM if "Network Transfer Preferred" is disabled on the Unified CCE PIM and VRU PIM.
Step 3
When the call is delivered to Agent 1 using the Unified ICME Script "NetXfer1", the agent can dial the number 9999 to send the call to another script "NetXfer2" .
Define a Dialed Number Plan in Unified ICME. The routing client is the Unified CCE PIM and dialed number will be the one defined before for the Unified CCE PIM; that is, IPCC_PIM.9999. Set Post Route to Yes and Plan to be international. In the Agent Desk Settings, check all the Outbound access checkboxes.
Step 2 Step 3
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
416
Chapter 13: Transferring and Queuing Calls with Unified CVP Overriding the CLI Field on Outgoing Transfers
The following section describes how to enable the call.user.microapp.override_cli ECC variable, which you must configure to enable this feature.
Append CLI=NNNNNNNN to the label in a LABEL node. Setting NNNNNNNN to the word null will blank out the CLI on the transfer. Example: Setting a label node to 1111;CLI=9876543 results in a transfer to 1111 using a CLI of 9876543. Example: Setting a label node to 1111;CLI=null results in a transfer to 1111 using an empty CLI.
Step 2
Set the call.user.microapp.override_cli ECC variable before invoking a transfer using Queue to Skill Group, Label node, et cetera. The call.user.microapp.override_cli Expanded Call Variable List. Set the maximum length to the maximum length of the data that will be used for CLI override. The Unified CVP Call Server must be restarted after adding this variable to Unified ICME. Setting the variable to the word null will blank out the CLI on the transfer. Example: Setting call.user.microapp.override_cli ECC variable to 9876543 prior to a Queue to SkillGroup where agent 1111 becomes available results in a transfer to 1111 using a CLI of 9876543. Example: Setting call.user.microapp.override_cli=null ECC variable prior to a Queue to Skill Group where agent 1111 becomes available results in a transfer to 1111 using an empty CLI.
If both of the above methods are used in one routing script, the LABEL node CLI value takes precedence over the ECC variable. CLI override takes precedence over the SetSetupCallingNum command in VBAdmin. That is, the new CLI will always be propagated to the transfer call leg regardless of the value of ShowSetupCallingNum. CLI override also forces the presentationIndicator to presentationAllowed on the transfer call leg. Note: For SIP calls, the CLI Override feature is only supported using the ECC variable. Using a dynamic label with "CLI" prepended is not supported.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
417
Chapter 13: Transferring and Queuing Calls with Unified CVP Most Significant Digit
The Unified CVP H.323 Service log displays the following message when it is executing CLI Override:
03:32:52 VoiceBrowser-VB Trace: 00000003: INTF: Overriding old CLI with new CLI 876543 : DNIS = 5900 : CID = 20efcd51-92fb-11da-8b50-ccd458cce346
Note: This command takes effect immediately. You do not need to restart the H.323 Service. With this configuration, Unified CVP will transfer calls to a specific Unified CM cluster. Unified CVP will strip one leading significant digit (excluding the tech-prefix, if it exists) from the dialed number (provided by DNIS). The stripped value is saved and prepended with a pound sign (#) before the call is transferred to Unified CM. For example, assume that Unified CVP receives a call with the DNIS-provided dialed number of 2#38005551234. This call is processed as follows: 1. Unified CVP strips the tech-prefix, 2#, leaving 38005551234. 2. Unified CVP strips one digit (3) from the beginning of the dialed number, leaving 8005551234. 3. Unified CVP passes 8005551234 to Unified ICME for routing. 4. When Unified ICME transfers the call to an agent, assume that Unified ICME returns the agent device label 3201. 5. Unified CVP prepends 3# to this device label and then passes 3#3201 to the gatekeeper for address resolution. 6. The gatekeeper resolves this label to a specific Unified CM cluster. This cluster is identified by the Unified CM gatekeeper.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
418
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Unified CCE Re-route On No Answer for Unified CVP
7. Unified CM strips 3# from the label, leaving 3201 as the destination phone address.
Summary
When using Unified CCE with Unified CVP as a queuing point and routing client, Re-route On No Answer needs to be configured differently than when using it with Unified IP IVR . The difference is caused by the fact that when using Unified IP IVR the call control is with Unified CM, whereas with Unified CVP, the call control is with Unified CVP.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
419
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Unified CCE Re-route On No Answer for Unified CVP
to answer a call; for example, 2 rings = 8 seconds. Set this timer shorter than the no answer timeout for router requery (see below).
Figure 45: Agent Desk Settings Configuration
This will cause the agent to be made unavailable after the Re-route On No Answer timer expires, but will not invoke the Re-route On No Answer mechanism to re-route the call.
420
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Unified CCE Re-route On No Answer for Unified CVP
The Queue node selects the longest available agent from the skill groups configured, if there is an available agent. If there is no available agent, it queues the call with a priority set in the node (see screen shot below) and continues down the success exit of the node. When an agent becomes available, Unified ICME always selects the longest queued call from the ones with the highest priority. When the Queue node connects the call to an agent and the agent does not answer the call, Unified CVP Ring-No-Answer timeout will expire, causing the Requery mechanism to kick in.
Figure 46: Queue to Skill Group Properties
When this happens, the script immediately continues through the failure exit of the Queue node with the Requery Status variable set to No Answer (= 3). The typical treatment is to put the call back into the same queue but with a higher priority than all other calls, since the call needs to go in the front of the queue, not the back.
Figure 47: Sample Script for Re-Route on No Answer
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
421
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Unified CCE Re-route On No Answer for Unified CVP
In this script, when the Queue node selects an agent that does not answer the call, the script exits through the failure exit (X) of the Queue node. The If node tests the RequeryStatus variable. If it has value of greater than zero, this is a requery call, and the script re-queues the call. In the example above it also sets a flag using a call variable for reporting purposes (see below). Assuming that there are no agents available, the Queue node immediately exits through the success exit (Checkmark). The If node checks to see if this is a requeried call. If so, it increases the Queue Priority of the call so that it will be handled before any other calls in queue. It then enters the normal wait loop with RunScripts. The call flow is as follows: Script connects call to agent by sending connect message to Unified CVP (with requery enabled). Agent phone rings. After the Re-route On No Answer timeout expires, Unified ICME makes the agent unavailable. The agent state does not actually change until the call gets taken away from the agent. The agent phone continues to ring and the agent can still pick up the phone (if he does pick up the phone, he will be left in Ready state after the call, even if it was after the Re-route On No Answer timer expired). After the Unified CVP VB RNATimeout expires, the VB/AS/PG sends an EventReport=No Answer to the router. The router picks another target according to the routing script and sends the Connect message to Unified CVP. The target might be another agent or it might be a VRU label to requeue the call. When the call disappears from the first agent he is put in Not Ready state.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
422
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
Another skill group A prompt GoTo node (do not use "Dynamic Label") See Also The Ring on No Answer (RONA) timeout setting used for Unified ICM are configured differently for Unified CVP. To ensure these setting are configured properly. See VBAdmin Configuration Commands (page 361) and Router Requery Configuration (page 420) for additional configuration information. You can also refer to the Operations Console online help for detailed information about configuring CVP H.323 Service and SIP Service settings.
Limitations
The configuration described in this section has the following limitations: The disposition of the requeried call is not correctly reported. The Redirect No Answer field in the agent and skill group reports do not show calls that are redirected by this mechanism. Each call that is redirected by this mechanism is counted twice, once as abandoned and once as handled (if the call is finally handled). There are two Unified CCE TerminationCallDetail records for this call, one for the rerouted call (with CallDisposition Abandoned while Ringing, code 3) and one for the handled call with a CallDisposition depending on how the call was finally handled. The scripting example above shows how a Peripheral Call Variable can be used to mark and count calls Requeried because of no answer. A custom reporting template can be written to report on this data.
Call Survivability
This section describes how to install and configure Unified CVP with a script that allows the gateway to transfer a call in the event of a critical Unified CVP application error or WAN failure. This application should be placed on the incoming pots dial-peer that is destined for Unified CVP. Call survivability is supported in all Unified CVP call flow models except the VRU-only call flow model. In the Unified CVP Standalone call flow model, survivability will be invoked if the gateway encounters an error from the CVP Voice Server, the "param survive" parameter has been included and a survivability service has been defined. In the event of critical Unified CVP application errors or a WAN failure that would normally disconnect the caller, this script allows the gateway to attempt a transfer to some alternate location after the failure occurs instead of disconnecting the caller. In the event that the call cannot be transferred to an alternate agent, the script will play a "call-back-later" message and disconnect. This script provides the following capabilities: Ability to do multiple types of transfer in call failure conditions:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
423
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
*8 transfer connect (outpulse) Hairpin SRST Hookflash Relay Two B-Channel Transfer (TBCT) Ability to differentiate call recovery behavior by incoming DNIS. Ability to differentiate call recovery behavior by incoming DNIS and how long the call had been in Unified CVP prior to failure. Ability to differentiate call recovery behavior based on time of day and date. Ability to hand off to an auto-attendant type application in the event of some downstream failure (for example, WAN failure, Unified ICME failure, Unified CVP failure). This auto-attendant functionality could be CME's BACD, a Unified CVP Standalone call flow model, a VXML Server application, or a custom-written VXML application. Caution: This script is a component of the Unified CVP software. Do not make any modifications to this script. Modifications to this script not made as part of an official Unified CVP release nullify Cisco support responsibility for this script.
Using the Operations Console, copy all script/prompt files to the gateway. On the gateway, do the following: For a Unified CVP Comprehensive call flow model: Define two services: application service survive flash:survivability.tcl paramspace callfeature med-inact-det enable service handoff flash:handoff.tcl Add the following parameters: ip rtcp report interval 2000
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
424
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
gateway timer receive-rtcp 6 Note: This will cause survivability to be invoked between 8 and 16 seconds for an active call after a WAN failure. If IOS detects the absence of both RTP and RTCP packets after (2000*4)*2 ms = 8 to 16 seconds, it will raise an error event and survivability will be invoked. (The factor of 2 is a built-in IOS factor that cannot be configured. Do not adjust these values lower as this could cause the survivability event to be prematurely invoked.) The timer receive-rtcp command configures a media activity timer that is common to both H.323 and SIP. If set, it affects both H.323 and SIP calls. For a Unified CVP Standalone call flow model: Define one service: application service my-survivability-service flash:survivability.tcl Note: You can replace "my-survivability-service" with any name you choose. Associate the my-survivability-service that you just created as a parameter on the CVPSelfService.tcl service associated with the incoming pots dial-peer. Note that the text "param survive" must be entered exactly as shown, but the my-survivability-service can be renamed to the service name of your choice. For example:
dial-peer voice XXXX pots service my-CVP-service incoming called-number NNNNN service my-CVP-service flash:CVPSelfService.tcl param CVPPrimaryVXMLServer my-VXML-server-IP param CVPBackupVXMLServer my-backup-VXML-server-IP param CVPSelfService-app my-VXML-server-app param keepalive my-CVP-service param survive my-survivability-service service my-survivability-service flash:survivability.tcl
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
425
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
Optionally, start a background keepalive service to the VXML Server: For example, for a service name of "my-standalone-service": service my-standalone-service param keepalive my-standalone-service Note: This will prevent the caller from hearing a period of silence at the start of each call if the VXML Server is down, as the gateway will know the current status of the VXML Server.
Step 3
On the gateway, do a "call appl voice load my-survivability-service" and "call appl voice load handoff." Do the following: On a Unified CVP Comprehensive call flow model: Create a Unified CVP pots dial-peer on the gateway, placing the Unified CVP called number on an incoming-called-number parameter. Assign the my-survivability-service service to this dial-peer. On a Unified CVP Standalone call flow model, no special survivability dial-peer needs to be created. However, the parameter "param survive my-survivability-service" must be included on the CVPSelfService.tcl service. This parameter indicates which service to run in the event of a system failure. In this way, different survivability services can be invoked depending on the incoming pots dial-peer invoked.
Step 4
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
426
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
*8 - The sequence the switch recognizes to perform the takeback. Zero or more commas - Each comma represents a pause of 100 ms. Some switches require a pause between the takeback sequence and the DNIS. 9875551212 - The actual DNIS to which the PSTN should transfer the call. Example 2: HF,,,,,9875551212 (when hookflash transfer is desired) where: HF - Indicates takeback and transfer via hookflash relay Zero or more commas - Each comma represents a pause of 100 ms. Some switches require a pause between the hookflash and the DNIS. 9875551212 - The actual DNIS to which the switch should transfer the call. Note: When using either DTMF or hookflash takeback, you need to configure the following additional parameters on the gateway voice ports:
voice-port 7/1:0 no echo-cancel enable no non-linear no vad playout-delay maximum 250 playout-delay nominal 200 playout-delay minimum high playout-delay mode fixed
Example 3: 9875551212 (when hairpin or SRST transfer is desired) Example 4: TBCT9875551212 (when TBCT is desired) Example 5: <retry> (when a retry to the original CVP DNIS is desired) Assuming the original Unified CVP DNIS was 4444: <retry> will send the call to CVP using DNIS 4444 56<retry>78 will send the call to CVP using DNIS 56444478 after-hours-agent - The destination recovery target DNIS to be used when the current time matches any after-hours-time parameter or as a default destination if transfers to the open-hours-agent's fail. The script will cycle through all agents sequentially until one answers (maximum of 50 agents). If no one answers, a call-back-later message will be played to the caller and then disconnected.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
427
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
Syntax: identical to open-hours-agent open-hours-time - A string representing the date or days of week and time of day that open-hours-agent's will be used for the recovery transfer (maximum of 20 values). Month/day has higher selection priority than days of the week. If a starting and ending time are not specified, 0000-2359 is assumed. Syntax: open-hours-timeX {month/day | days-of-week}[:HHMM-HHMM] Arguments: X = a number from 0 to 19. month/day = month of year and day of month (no year) days-of-week = a string of up to seven digits representing the days of the week (Sunday = 0, Saturday = 6) HHMM-HHMM = the starting and ending time of the period, expressed in 24-hour clock notation. after-hours-time - A string representing the date or days of week and time of day that after-hours-agent's will be used for the transfer. These do not explicitly need to be listed. If the current date/time does not fall in an open-hours-time slot, it will default to an after-hours agent. A typical use would be to specify holidays that would normally fall on working weekdays. A maximum of 20 values are allowed. Syntax: identical to open-hours-time open-hours-cvptime - You may want to choose a particular recovery agent based on how long the call had been in Unified CVP before the failure occurred. If no open-hours-cvptime is specified, the associated open-hours-agent will be used regardless. Syntax:number-of-seconds Arguments: X = a number from 0 to 19, corresponding to the associated open-hours-agent number-of-seconds55 would use open-hours-agent0 only when the call had been in Unified CVP less than 55 secs. after-hours-cvptime - Same as open-hours-cvptime, but applies instead to after-hours-agents. alert-timeout - A numeric value indicating the maximum number of seconds the destination phone should ring before aborting the call attempt. Syntax: alert-timeout 20 setup-timeout - A numeric value indicating the maximum number of seconds that the tcl script will wait in establishing a tcp connection to Unified CVP before aborting the call attempt. This value should be greater than the "h225 timeout tcp establish" parameter under the voice class h323 configuration on the gateway.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
428
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
Syntax: setup-timeout 7 aa-name - If non-blank, indicates that when a failure occurs, the Unified CVP survivability script hands off the caller to the BACD auto-attendant application. Enter the following:
service <survivability-servicename> param aa-name <BACD-servicename> service <BACD-servicename> param isn-name <survivability-servicename>
where servicename is the service name of the BACD auto-attendant script to which control should be passed. standalone - If non-blank, indicates that when a failure occurs, this Unified CVP survivability script passes control to the service name specified. Typically, that service would reference the CVPSelfService.tcl script to invoke a Call Studio application to provide IVR treatment to the caller; for example:
service survivability flash:survivability.tcl param standalone vxmlapp service vxmlapp flash:CVPSelfService.tcl
standalone-isntime - Select the standalone option depending on how long the call had been in Unified CVP before the failure occurred. If no standalone-isntime is specified, the standalone option is invoked if it is non-blank. Syntax: standalone-isntime {> OR <}number-of-seconds Arguments: number-of-seconds = number of seconds the call was in Unified CVP before the call failed, prefixed with > or <. For example, standalone-isntime <2 would use standalone only when the call had been in Unified CVP less than 2 seconds. icm-tbct - A numeric boolean value (0 or 1) indicating whether or not Unified ICME scripts will issue TBCT transfers. Default is 0 (by default, Unified ICME does not handle TBCT transfers). Set this value to 1 to enable TBCT transfers issued from a TBCT label in an Unified ICME script. Syntax Example: icm-tbct 1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
429
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
paramspace english language en paramspace english location flash: paramspace english prefix en param open-hours-agent0 9777123400 param open-hours-agent1 4444888 param open-hours-time0 12345:0900-1730 param open-hours-time1 12/18:0600-2300 param after-hours-agent0 7777008 param after-hours-agent1 8766008 param after-hours-time0 7/21:0700-0800 param after-hours-time1 11/25 param setup-timeout 7 param alert-timeout dial-peer voice 800232 pots application survivability incoming called-number 8002321765 direct-inward-dial
Using the above configurations, review the following cases: Case 1: Assume today is a holiday, Thursday, 11/25 at 1300 hours. Since 11/25 is defined as a specific after-hours-time, it will be selected before the 12345:0900-1730 open-hours-time which also falls on a Thursday. If the WAN fails, this script will first try a transfer to 7777008 and then to 8766008. Case 2: Assume today is Saturday, 12/18 at 0900 hours, peak of the holiday shopping season. Since 12/18 is defined as a specific open-hours-time, it will be selected for an open-hours-agent even though it falls on a Saturday which would normally be an after hours time. If the WAN fails, this script will first try a transfer to 9777123400, then try 4444888, 7777008, 8766008. Case 3: If you don't care about time-of-day routing, and simply want a last-resort transfer mechanism, put one of more DNIS's in the after-hours-agent slots and don't define any times. Any failed call will always be directed to the list of after-hours-agents.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
430
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
The next example illustrates how to organize call survivability functionality by incoming DNIS, create a separate application for each DNIS and apply desired call recovery properties to each application. For example: Assume billing callers dial 45XX and sales callers dial 55XX to access Unified CVP. Assume that a billing call fails somewhere in the course of the call: If the call fails and the call had been in Unified CVP less than 30 seconds (this would also include the case where the call had *never* made it to Unified CVP, i.e., 0 seconds), send the caller back through the PSTN via a *8 takeback to 8005556666. If the call fails and the call had been in Unified CVP greater than or equal to 30 seconds, send the caller back through the PSTN via a *8 takeback to 8007778888. Assume that a sales call fails somewhere in the course of the call: If the call fails (in this case, the amount of time the call had been in Unified CVP is irrelevant), send the caller back through the PSTN via a hairpin transfer to 8009990000. Assume the PSTN switch is sending ANI and DNIS in such a way that the ANI and DNIS are concatenated together in the DNIS field. Assume that ANI length is 10 and DNIS length is 4. Also assume that ANI can be blank, e.g. blocked callerID. The IOS configuration elements necessary to accomplish these cases is shown below. Note: Dial-peers 2 and 4 are necessary in the event of no ANI (blocked caller ID). The lower preferences of dial-peers 2 and 4 is to protect against the case where a caller's ANI begins with, say, 45. For example, assume caller with ANI 4521111111 dials the sales DNIS. Without lower preferences, the caller would have matched dial-peer 2 and gone to the billing application instead of sales (you wanted it to match dial-peer 3). The following are the configuration elements for the second example:
dial-peer voice 1 pots preference 1 application billing incoming called-number 45.. #-----------------------------------------dial-peer voice 2 pots preference 2 application billing incoming called-number 45..
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
431
Chapter 13: Transferring and Queuing Calls with Unified CVP Call Survivability
#-----------------------------------------dial-peer voice 3 pots preference 1 application sales incoming called-number 55.. #-----------------------------------------dial-peer voice 4 pots preference 2 application sales incoming called-number 55.. #-----------------------------------------dial-peer voice 5 pots destination-pattern 8009990000 port 7/0:D (or whatever port is desired) #-----------------------------------------dial-peer voice 6 voip incoming called-number 8009990000 codec g711ulaw (To force the call to g711ulaw on the outgoing hairpin) #-----------------------------------------service billing flash:survivability.tcl paramspace english index 0 paramspace english language en paramspace english location flash: paramspace english prefix en param after-hours-agent0 DTMF*8,,,8005556666 param after-hours-cvptime0 <30 param after-hours-agent1 DTMF*8,,,8007778888
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
432
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Locations-Based Call Admission Control
param after-hours-cvptime1 >29 param ani-dnis-split 10:4 #-----------------------------------------service sales flash:survivability.tcl paramspace english index 0 paramspace english language en paramspace english location flash: paramspace english prefix en param after-hours-agent0 8009990000 param ani-dnis-split 10:4
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
433
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Locations-Based Call Admission Control
Configuring Unified CVP H.323 Service Configuration Settings (page 435) Configuring Unified CVP Bandwidth Utilization (page 436)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
434
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Locations-Based Call Admission Control
Hairpinning
Configure the H.323 Service to hairpin a voice response unit (VRU) call leg to its originating gateway. In this way, the playing of prompts does not consume WAN bandwidth and the bearer path stays entirely within the originating gateway. To make this configuration, enter the following command at the VBAdmin command line interface:
SetTransferLabel NetworkRoutingNumber
where you replace NetworkRoutingNumber with the label value that you configured in Unified ICME with the Type 3, 7, or 10 VRU. Note: This command takes effect immediately. You do not need to restart the H.323 Service. With this configuration, a call is handled as follows: 1. When the H.323 Service receives a call, it notifies Unified ICME that a call has arrived. 2. Unified ICME might return a transfer request to Unified CVP that instructs Unified CVP to send a second call (the VRU call leg) to an IOS Voice Browser for prompt and collect treatment. 3. When Unified CVP receives the transfer request, it sends an admission request (ARQ) to the gatekeeper, but it ignores the reply and instead sends the VRU call leg back to the originating gateway.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
435
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Locations-Based Call Admission Control
Note: This command takes effect immediately. You do not need to restart the H.323 Service. With this configuration: The H.323 Service forces the H.225 SETUP message to the Unified CM port 1720, which is the default H.225 listening port. The H.323 Service includes the IP address of the originating gateway in the ARQ and in the H.225 SETUP message that it sends to Unified CM. In this way, Unified CM will identify calls as originating from the remote gateway instead of from Unified CVP and will adjust its CAC counters accordingly.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
436
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Locations-Based Call Admission Control
VoiceXML Documents
A VoiceXML document corresponds approximately to a Run External node in a Unified ICME script. A round trip of a VoiceXML document between Unified CVP and the gateway consumes an average of 7 KB (7,000 bytes). If each call includes approximately 20 VoiceXML documents, the WAN bandwidth consumed by VoiceXML documents can be calculated as follows: 1. 7,000 bytes * 20 VoiceXML documents * 8 bits = 1,120,000 bits per call 2. 0.166 CPS * 1,120,000 bits per call = 185.9 Kbps per remote site
Prompt Retrieval
Voice prompts can be stored in the following locations: In flash memory on each local site gatewayIn this way, gateways do not need to retrieve .wav files for prompts and WAN bandwidth is not affected. However, if a prompt needs to change, you must change it on every gateway. On an HTTP media serverIn this way, each local site gateway (if properly configured) can cache many or all prompts, depending on the number and size of the prompts. When prompts are stored on an HTTP media server, the refresh period for the prompts is defined on that server. The bandwidth consumed by prompts consists of the initial loading of the prompts at each gateway and of the periodic updates at the expiration of the refresh interval. As an example of determining the bandwidth consumed by prompts, assume that a call flow has 50 prompts with an average size of 50 KB (50,000 bytes) each. Also, assume that the refresh period for the prompts is defined as 15 minutes (900 seconds) on the HTTP media server. The WAN bandwidth required for prompts in this call flow can be calculated as follows: 1. 50 prompts * 50,000 bytes * 8 bits = 20,000,000 bits 2. 20,000,000 bits / 900 seconds = 22.2 Kbps per branch
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
437
Chapter 13: Transferring and Queuing Calls with Unified CVP Configuring Locations-Based Call Admission Control
0.166 CPS * 56,000 bits per call = 9.3 Kbps for the WAN link to a remote branch
Note: The 'http client cache memory file' represents the largest size prompt file (in Kbytes) that can be cached. In general, break up customer prompts larger than 500K (about a minute in length) into smaller, more manageable pieces to facilitate loading and caching. For example, queue music could be a repetitive loop of a 30 second prompt. Note also that because the prompts are streamed, the prompt will not be cached unless the whole prompt is played. Therefore, you must make prompts a manageable size. 2. Synchronize the datetime between the gateway and the HTTP media server. Note: Synchronization does not have to be exact, but at least within a minute or two. Times that are not synchronized can cause prompts to never refresh or they will refresh with every call, both of which are undesirable behaviors. 3. On the media server, set the content expiration (for example 15 minutes). Note: In IIS, this is done under the "HTTP Header" tab. The gateway prompt will be refreshed after this time period. The period chosen reflects how often the record prompts and how long you are willing to wait to have the new prompt load after modification.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
438
Chapter 13: Transferring and Queuing Calls with Unified CVP Incoming UUI to be Used as the Correlation ID
Do show http client cache on the gateway. The 'Fresh Time' column equals the refresh time period set on the HTTP media server. For example, if the refresh period was set to 15 minutes, it says 900 seconds. The 'Age' column shows how many seconds have passed since the prompt was last refreshed. In general, this number will be less than the 'Fresh Time'. However, if no call has ever accessed the prompt recently, this number could be greater than the fresh time. Prompts are only refreshed when triggered by a call and the prompt 'Fresh Time' has expired. If the Fresh Time is a very high value, the only way to remove the prompt from cache is to reload the gateway.
How It Works
The call control client (such as the CRSP NIC) inserts the desired Correlation ID value into the dat field of the UUS parameter of the NSS IAM message. These NSS messages are used as the basis of building the GTD data that ultimately arrives at the IOS gateway from the PSTN. Refer to the ITU-T Narrowband Signaling Syntax spec (Q.1980.1) for a detailed description of the IAM message and UUS parameter, included below for convenience. Note that the dat field contains pairs of hexadecimal digits. This means that if the Correlation ID is "12345", the dat field must be populated as "3132333435". The gateway bootstrap.tcl script converts back to "12345" before appending to the DNIS and passing to the Unified CVP Call Server in the HTTP URL.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
439
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE service <your-cvp-service-name> param use-uui-as-corrid Y (See Note 1) param correlation-gtd-attribute XXX (See Note 2) param correlation-gtd-instance N (See Note 2) param correlation-gtd-field YYY (See Note 2) dial-peer voice pots 123 service <your-cvp-service-name>
Note: This is a mandatory parameter to enable this feature. These parameters are optional. They need only be specified if the call control client placed the Correlation ID in a GTD parameter other than uus.dat.
Debugging Tips
Debug Trace Settings for the Gateway
On the gateway, enter the following: debug voip application script debug gtd
6616806: *Jan 31 17:12:41.220: cdapi_find_tsm: Found a gtdmsg of length144:6616807: *Jan 31 17:12:41.220: gtd msg = "IAM,PRN,isdn*,, ATT5*,USI,rate,c,s,c,1USI,lay1,ulawTMR,00CPN,00 ,,u,5900CPC,09FCI,,,,,,,y,UUS,3,3132333435 ---------------------> This is the UUI that will become the Correlation ID12345GCI, 87c0c79d91dd11daa9c4000bfda207f2"
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
440
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
For example, to use the AT&T Transfer Connect feature to transfer the call to the number 4441234, configure the label as DTMF*8,,,4441234. Note: Usually the PSTN switch expects a delay between the *8 and the phone number. Each comma represents 100ms by default. It can be changed with the SetTakebackDelay command in VBAdmin. In outpulse transfer mode, Unified CVP will send whatever digits are in the label to the Gateway for outpulsing. It is the customers responsibility to confirm interoperability with the target switch. In your Unified ICME script when using outpulse transfers with SIP calls, digits can only be outpulsed on a call that has already been established. This means that it is necessary to transfer the call to the VXML gateway with a run external script node before you can send the DTMF*8 label. The Unified ICME script cannot send the DTMF*8 label back to Unified CVP for the first connect message in the call because the call has not been answered at this point. The Unified CVP Call Server uses SIP INFO messages to send the digits to the gateway for outpulsing. When using outpulse transfers with SIP, you can also use the comma duration as the default interdigit pause duration. For example, with the default 100 msec comma duration, a label such as "DTMF*8,,,8009785001" will have 300 msecs between the first 8 and the second 8. The interdigit pause will also be 100 msecs. The tone duration is also configurable and defaults to 100 msecs.
Defining a Unified ICME Script Label for Two B-Channel Transfer (TBCT)
For Unified CVP calls that require Two B-Channel Transfer (TBCT) mode, add a label node to your Unified ICME script with the following syntax:
TBCT99#8005551212#
Replace 8005551212 with your transfer destination target; TBCT99 and the # sign are mandatory. By configuring the target label in this form, Unified CVP sends the digits to the Ingress endpoint for Two B-Channel transfer.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
441
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
For example, to use the hookflash feature to transfer the call to the number 4441234 with a 500- millisecond pause after the hookflash, configure the Unified ICME label as HF,,,,,4441234.
Configure the originating gateway for TBCT call transfer, by following the instructions in "Configuring the Gateway for Two B-Channel Transfer (TBCT) (page 449)." Locate the following files on the VXML Server and copy them to flash memory on the gateway, using the tftp command: en_error.wav en_holdmusic.wav en_pleasewait.wav survivability.tcl CVPSelfService.tcl CVPSelfServiceBootstrap.vxml
Step 2
Step 3
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
442
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
service takeback flash:survivability.tcl paramspace english index 0 paramspace english language en paramspace english location flash: paramspace english prefix en param icm-tbct 1 Step 4
Note: CVPSelfService is required. Backup server is optional. For both the Tomcat Application Server and the WebSphere Application Server, set the port to 7000.
Step 5
Step 6
Specify the target destination for the TBCT transfer either by entering the number manually, or dynamically by using caller input.
a.
Manually. In the SubdialogReturn node in the VXML Server application, next to Caller Input in the Settings Tab, enter TBCT<target_destination_number>, where target_destination_number is the target destination of the TBCT transfer. For example:
TBCT8005551212
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
443
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
b.
Dynamically. The target destination is created dynamically using input entered by the caller during the call. To do this, click the Substitution icon next to the Caller Input variable and select substitution values. For example:
Step 7
In the event that the TBCT fails (for example, bad number, bad gateway config, etc.), you can specify alternate transfer targets under the survivability service according to survivability rules as defined in the "Call Survivability (page 423)" section in Chapter 19, "Configuring the H.323 Devices and VoIP," in Part 3.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
444
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
Step 1
Configure the originating gateway for Hookflash Relay call transfer, by following the instructions in the "Configuring the Gateway for Hookflash Relay (page 447)" section in Chapter 18, "Transferring and Queuing Calls with Unified CVP," in Part 3. Locate the following files on the VXML Server and copy them to flash memory on the gateway. en_error.wav en_holdmusic.wav en_pleasewait.wav survivability.tcl en_0.wav en_1.wav en_2.wav en_3.wav en_4.wav en_5.wav en_6.wav en_7.wav en_8.wav en_9.wav en_pound.wav en_star.wav
Step 2
Step 3
Step 4
If you have not already done so, configure the CVPSelfService application as follows:
service [gateway application name] flash:CVPSelfService.tcl paramspace english index 0 paramspace english language en
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
445
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
param CVPBackupVXMLServer 12.34.567.890 paramspace english location flash: param CVPSelfService-port 7000 param CVPSelfService-app [name of application on the VXML Server, exactly how it appears] paramspace english prefix en param CVPPrimaryVXMLServer 12.34.567.890
Note: CVPSelfService is required. Backup server is optional. For both the Tomcat Application Server and the WebSphere Application Server, set the port to 7000.
Step 5
Step 6
In the SubdialogReturn node in your VXML Server application, next to Caller Input in the Settings Tab, enter HF8005551212, replacing 8005551212 with the target destination of the hookflash transfer. The label can also be defined dynamically using digits entered by the caller in conjunction with the VXML Server substitution tags. If the switch requires a pause after the hookflash, commas can be inserted between the HF and the transfer number. Each comma represents 100ms.
Configure the gateway according to either "Configuring the VXML Server (Standalone) Call Flow Model (without ICM Lookup) (page 308)" or "Configuring the VXML Server (Standalone) with ICM Lookup Call Flow Model (page 305)," whichever is appropriate for the implementation. Note: The incoming dial-peer running the CVPSelfService application must be a voip dial-peer, not a pots dial-peer. Additionally, the IOS image that is used must contain the IPIPGW feature. SIP REFER will not work with the IPIPGW feature.
Step 2
Specify the target destination for the refer transfer in the Call Studio application either by entering the number manually, or dynamically using caller input.
a.
Manually. In the SubdialogReturn node in the VXML Server application, next to CallerInput in the Settings tab, enter RF<target_destination_number>, where
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
446
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
target_destination_number is the target destination of the REFER transfer; for example, RF8005551212.
b.
Dynamically. The target destination is created dynamically using input entered by the caller during the call. To do this, click the Substitution icon next to the Caller Input variable and select the substitution values.
447
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
Follow the gateway configuration instructions as described in Configuring the Gateway for Hookflash Relay (page 447). Add a label node to your Unified ICME script with the following syntax: HF8005551212 Replace 8005551212 with the number to which the switch will transfer the call. If the switch requires a pause after the hookflash, insert commas between the HF and the transfer number. Each comma represents 100 milliseconds. Note: Unified CVP automatically disconnects the call two seconds after sending the digits. If the switch needs more time to complete the hookflash sequence, you can increase the delay by appending more commas after the transfer number to extend the two-second timeout.
Step 2
Configure the originating gateway for hookflash relay call transfer, by following the instructions in Configuring the Gateway for Hookflash Relay (page 447) .
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
448
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
Step 2
Follow the instructions for configuring survivability in the How to Configure the Gateway for Call Survivability (page 426) in Chapter 14, "Configuring the H.323 Devices and VoIP." See the HF target for open-hours-agent and after-hours-agent.
Save a copy of the current running configuration to flash memory in case you need to roll back to the earlier version. If needed, upgrade the IOS version on the originating gateway. Consult the Hardware and Software System Specification for Cisco Unified Customer Voice Portal Software Release 7.0(1) for the required version of Cisco IOS on the Gateway. Configure trunks, switches, and dial-peers to process TBCT call transfers. Consult your service provider for switch configuration details as they will vary between switches (DMS100, 5ESS). TBCT supports the National ISDN-2 (NI-2) standard. One sample originating gateway configuration is shown in the Gateway Configuration for Two B-Channel Transfer example, below. Only the pertinent gateway configuration elements are shown. For more information on the TBCT feature, refer to the Cisco IOS Tcl IVR and VoiceXML Application Guide.
Step 2
Step 3
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
449
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
Note: The trunk group is what ties the incoming and outgoing call legs together. The notify-on-clear parameter is optional. When set on both the gateway and the switch, the gateway will monitor the status of the call if required for billing purposes. The notify-on-clear parameter is only available on 5XXX gateways. You can use the "tbct max" gateway configuration parameters to limit the number of TBCT calls. For more information on the TBCT feature, refer to the Cisco IOS Tcl IVR and VoiceXML Application Guide. The tbct max parameter is only available on 5XXX gateways. Debugging TBCT Gateway Configuration Problems Note: If the gateway is instructed to perform a TBCT transfer (either from a Unified ICME script label, a VXML Server label, or from survivability), if the gateway trunk group and dial-peer are not correctly configured for TBCT according to the instructions in this guide, the caller will be disconnected when the called party answers the phone The following are useful settings for debugging TBCT Gateway configuration problems: debug isdn q931 debug isdn err debug cdapi event debug voip application script Verifying that TBCT Is Working Correctly The TBCT feature is working correctly if: The caller was connected to the transfer destination, and The gateway log (using the above debug settings) shows the following (abbreviated) messages:
014349: *Jul 4 11:20:23.483: ISDN Se6/7:23 Q931: RX <- ALERTING 014387: *Jul 4 11:20:23.487: ISDN Se6/7:23 Q931: TX -> FACILITY Operation = EnhancedExplicitECTExecute (TBCT) 014388: *Jul 4 11:20:23.587: ISDN Se6/7:23 Q931: RX <- FACILITY Operation = SetCallTag (TBCT) 014434: *Jul 4 11:20:23.599: //-1//TCL2:HN0B1453B0:/tcl_PutsObjCmd:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
450
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
Configuring TBCT When Using a Unified CVP Label Node 1. Configure the originating gateway for TBCT call transfer by following the instructions in the "Configuring the Gateway for Two B-Channel Transfer (TBCT) (page 449)" section. 2. Configure your Unified CVP incoming pots dial-peer to use the Unified CVP survivability Tcl script. See How to Configure the Gateway for Call Survivability (page 426) in Chapter 14, "Configuring the H.323 Devices and VoIP." If survivability is already configured on your gateways, go to the next step
dial-peer voice 111111 pots trunkgroup 1 service someName dial-peer voice 222222 voip session target [your Unified CVP H.323 Service] service someName flash:survivability.tcl paramspace english index 0 paramspace english language en paramspace english location flash: paramspace english prefix en param icm-tbct 1
4. Add a label node to your Unified ICME script with the following syntax:
TBCT99#8005551212#
replacing 8005551212 with your transfer destination target. Note that the TBCT99 and the # signs are mandatory. 5. In the event that the TBCT fails (for example, bad number, bad gateway config, et cetera), you can specify alternate transfer targets under the survivability service according to survivability rules as defined in the How to Configure the Gateway for Call Survivability (page 426) section in Chapter 14, "Configuring the H.323 Devices and VoIP." Configuring TBCT for Survivability
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
451
Chapter 13: Transferring and Queuing Calls with Unified CVP Performing External Transfers in Unified CCE
1. Configure the originating gateway for TBCT call transfer, by following the instructions in the "Configuring the Gateway for Two B-Channel Transfer (TBCT) (page 449)" section. 2. Follow the instructions for configuring survivability in the How to Configure the Gateway for Call Survivability (page 426) section in Chapter 14, "Configuring the H.323 Devices and VoIP." See the TBCT target for open-hours-agent and after-hours-agent.
Label Definition
Labels are part of the Unified ICME configuration. Unified ICME determines which label to send and includes it in the request to transfer the caller. Then, for IP transfers, Unified CVP does a Gatekeeper look-up on the label from Unified ICME to determine the IP address of the called party. For more information on this process, see Chapter 14, "Configuring the H.323 Devices and VoIP (page 453)." There are some caveats regarding label definition for use with Unified CVP: For requery and network transfer to work, you must define dummy VRU labels, even if Unified CVP is the main routing client. In addition, in a NAM/CICM configuration, these labels must be defined identically on both the NAM and CICM. You cannot use Unified ICME's feature of substitution variables (such as %1). Labels for Unified CVP calls which will require outpulse transfer mode must be pre-pended with the characters DTMF. By configuring the target label with the form DTMFnnnnn (where nnnnn are the digits to outpulse), Unified CVP will send the digits to the Ingress gateway for outpulsing. (Conversely, a label not intended for outpulse transfer mode use cannot begin with DTMF.) For example, to use the AT&T Transfer Connect feature to transfer the call to the number 4441234 the label would be configured as DTMF*84441234. Note: In outpulse transfer mode, Unified CVP will send whatever digits are in the label to the Gateway for outpulsing. It is the customers responsibility to confirm interpretability with the target switch.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
452
Chapter 14
Configuring the H.323 Devices and VoIP
This chapter describes how to configure the H.323 devices. Once these devices have been configured, you can add them to the Operations Console network control panel. Once added, you can execute a subset of IOS Gateway and Gatekeeper commands on the Gateway and Gatekeeper from the Operations Console, along with adding the Unified ICME Server to a device pool (see the "Configuring a Gateway (page 471)," "Configuring a Gatekeeper (page 479)," and "Configuring a Unified ICME Server (page 486)" sections). This chapter contains the following topics: About Call Routing, page 453 Gatekeeper Redundancy, page 462 Configuring Unified CVP to Propagate UUI to Unified ICME, page 467 Unified CVP Endpoint Limitations, page 470 Configuring a Gateway, page 471 Configuring a Gatekeeper, page 479 Configuring an ICM Server, page 486
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
453
Chapter 14: Configuring the H.323 Devices and VoIP About Call Routing
You can accomplish call routing using the tech-prefix method, the zone prefix method, or a combination of both. The sections that follow describe the tech-prefix and zone-prefix methods. Note: There are variations to the routing methods described below, for example, the branch office model.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
454
Chapter 14: Configuring the H.323 Devices and VoIP About Call Routing
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
455
Chapter 14: Configuring the H.323 Devices and VoIP About Call Routing voice translation-profile techprefix translate called 1 dial-peer voice 111 voip service isnapp * \ Next two commands are specific to tech-prefix routing translation-profile incoming techprefix incoming called-number 4#T dtmf-relay h245-signal h245-alphanumeric codec g711ulaw no vad
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
456
Chapter 14: Configuring the H.323 Devices and VoIP About Call Routing
Enter the DNIS value that will route to Unified CVP. Under Gateway/Route List, select the Gatekeeper Trunk created in the previous step. In Prefix Digits (Outgoing Calls), enter the tech-prefix of Unified CVP (2#).
4. Use Device > Trunk to create a second H.225 Gatekeeper Controlled trunk. (This is the trunk to enable outbound call routing to agents from Unified CVP to Cisco Unified Communications Manager. ) Ensure that Media Termination Point required is disabled. Under Gatekeeper Information: Select the gatekeeper that was defined in the previous step. Select Gateway as the Terminal Type. Set the technology prefix to 1#. Select a zone. (If left blank, Cisco Unified Communications Manager will register to the first local zone defined in the gatekeeper.)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
457
Chapter 14: Configuring the H.323 Devices and VoIP About Call Routing
2. Define the zone prefix(es) for all DNIS values that should be routed to Unified CVP.
zone prefix zoneA 5900* gw-priority 10 h323-id-of-CVP1 h323-id-of-CVP2
The H323-id is what must be specified in the zone-prefix command. Although by default the H323-id is the IP address of the Unified CVP machine, it can be changed using the setH323ID VBAdmin command so care must be taken to make sure this matches. This is a very common mistake when configuring the gatekeeper. If multiple Unified CVP devices are specified, the gatekeeper will perform an approximate round-robin selection algorithm when selecting a Unified CVP endpoint to which to route the call. It is best to use the wildcard (*) syntax for all zone prefixes. Mixing the dot syntax with * syntax can have unpredictable routing results
3. Define the zone prefix for the Network VRU label. This is how Unified CVP will locate a VoiceXML gateway to process the IVR leg of the call. 4. Define the zone prefix(es) for agent phone device target ids. Typically, the H.323-ids of all subscribers in the Cisco Unified Communications Manager cluster are listed here 5. Define alternate endpoints for all egress gateways (both VoiceXML gateways and ACD egress gateways, if present). In the event Unified CVP sends a call setup to an egress gateway which fails, Unified CVP will then try the all the alternate endpoints in turn, until it receives a successful response.
endpoint alt-ep h323id <h323-id-of-failed-gateway> <ip-address-of-alternate-gateway>
Caution: Do not use outbound alternate endpoint functionality for agent routing. It should be used only for IVR routing. This will prevent the undesirable condition where the agent reserve timer expires before the call arrives, allowing a different call to reach the agent that does not match the call data previously sent to the agent by the Unified ICME software. Router requery is the preferred method in the agent case.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
458
Chapter 14: Configuring the H.323 Devices and VoIP About Call Routing
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
459
Chapter 14: Configuring the H.323 Devices and VoIP About Call Routing
zzzz is the DNIS (Dialed Number Identification Service), identifying an ACD agent skillgroup, service, extension, et cetera. Unified CVP initiates the transfer using all these digits: The gatekeeper uses the xxxx digits to determine a destination gateway. The gateway uses the yy digits to determine the correct ACD trunk group. The gateway outpulses the zzzz digits to the proper ACD trunk group, which uses them to connect the call to an agent.
interface Loopback0 ip address 22.22.22.14 255.255.255.255 h323-gateway voip interface h323-gateway voip id zoneA ipaddr 10.86.129.36 1719 h323-gateway voip h323-id egressgw1-zoneA * \ Next command is specific to tech-prefix routing h323-gateway voip tech-prefix 1# dial-peer voice 1 pots * \ GW to route calls with leading digits 888800 to * \ GWvoice port 0:1 * \ (T1/E1 controller # :D Channel), with highest * \ preference (0) destination-pattern 888800. port 0:1 preference 0 dial-peer voice 2 pots * \ Defines backup voice port (0:2) for same digits destination-pattern 888800. port 0:2 preference 1 dial-peer voice 3 pots * \ Routes calls with different yy digits (01) to a * \ different GW voice port (1:1). * \ This is how the GW differentiates the ACD trunkgroups. destination-pattern 888801. port 1:1 preference 0 dial-peer voice 4 pots * \ Defines backup voice port (1:2) for the same trunkgroup destination-pattern 888801. port 1:2 preference 1 dial-peer voice 5 pots * \ Routes calls to a third trunk group destination-pattern 888802. port 2:1 preference 0 dial-peer voice 6 pots * \ Backup voice port for third trunk group destination-pattern 888802. port 2:2 preference 1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
460
Chapter 14: Configuring the H.323 Devices and VoIP About Call Routing
4. Use Device > Trunk to create a second H.225 Gatekeeper Controlled trunk. (This is the trunk to enable outbound call routing from Unified CVP to Cisco Unified Communications Manager.) Make sure that Media Termination Point required is disabled. Under Gatekeeper information: Select the gatekeeper that was defined in the previous step. Select Gateway as the Terminal Type.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
461
Chapter 14: Configuring the H.323 Devices and VoIP Gatekeeper Redundancy
Set technology prefix to 1#. Select a zone. (If left blank, Cisco Unified Communications Manager will register to the first local zone defined in the gatekeeper.)
Gatekeeper Redundancy
Host Standby Router Protocol (HSRP) Support
This section describes how to configure HSRP for Unified CVP.
H.323 Service
Depending on the registration interval configured in the gateways and Unified CM, there might be a period ranging from 30 seconds to a few minutes immediately after gatekeeper failure (when using HSRP) where you cannot transfer calls to the desired endpoint and callers lose connectivity. You should follow these configuration steps below to ensure that this does not happen. The configuration specified below provides seamless HSRP failover behavior. Note: Using this method, the caller can experience a 60 second wait period while the system stabilizes before being transferred to an agent.
Gatekeeper
Step 1
From the VBAdmin, set the Gatekeeper to the HSRP VIP of the Gatekeeper failover pair. If necessary, set the desired H.323 zone using the VBAdmin setGatekeeper command. Set up the Gatekeeper for HSRP failover. (Refer to your Gatekeeper and IOS documentation.) This process should include putting the HSRP VIP in both a standby command on the FastEthernet interface and on the zone local command. Include all your IOS gateways in your zone as transfer candidates. You can prioritize them using the gw-priority on the zone prefix commands. By using all the gateways in the zone, the possibility of not finding a registered gateway immediately after HSRP failover are virtually eliminated, provided the gateway dial- peers are configured as defined in the following bullet.
Step 2
Step 3
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
462
Chapter 14: Configuring the H.323 Devices and VoIP Gatekeeper Redundancy
Gateway
Step 1 Step 2
Register your gateways with the VIP of the HSRP failover pair. Define a dial-peer of the highest preference (preference 0) that performs a gatekeeper search for an available Unified CVP H.323 Service (that is, session target ras). Set the tech-prefix to the tech prefix of your Unified CVP H.323 Service. Define at least one other dial-peer with lower preference (preference 1) that uses a static Unified CVP H.323 Service address instead of a gatekeeper lookup (for example, session target ipv4:10.86.137.68).
Step 3 Step 4
Unified CM
Step 1
Under Device > Gatekeeper, set the gatekeeper name to the HSRP VIP of the gatekeeper failover pair. Set Registration Request Time to Live to 30 seconds. Set Registration Retry Timeout to 30 seconds.
Step 2
Unified ICME
Step 1 Step 2
Enable the router requery on all Queue to Skill Group nodes. Coming off the X path from the Queue to Skill Group node, add an IF node that checks the value of the variable Call.RequeryStatus. If the value is 1, play a 60 second prompt and go to a second Queue to Skill Group node. If the value is not 1, immediately go to the second Queue to Skill Group Node.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
463
Chapter 14: Configuring the H.323 Devices and VoIP Gatekeeper Redundancy
The ability of an H.323 endpoint, such as a gateway, to statically configure two gatekeepers to provide a backup in the event the primary fails. The ability of an H.323 endpoint to register to a GUP cluster. Best results are achieved when Unified CVP uses the GUP cluster method of alternate gatekeeper since solution tests have shown that proper load-balancing to Unified CVP devices is difficult to achieve with straight alternate gatekeeper methods. Although Unified CVP itself cannot process GUP messages, it can participate in the GUP cluster. It simply ignores GUP messages and functions as a straight alternate gatekeeper client as described below. The following is a simple example of Unified CVP being used in a gatekeeper cluster.
Figure 48: Example of a Gatekeeper Cluster
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
464
Chapter 14: Configuring the H.323 Devices and VoIP Gatekeeper Redundancy
gatekeeper zone local zoneB cisco.com 10.86.129.118 zone local zoneA_GK2 cisco.com zone cluster local B_Cluster zoneB element zoneB_GK1 10.86.129.36 1719 zone cluster local A_Cluster zoneA_GK2 element zoneA 10.86.129.36 1719 zone prefix zoneA_GK2 111111* gw-priority 10 gw1-zoneA zone prefix zoneB 112233* gw-priority 10 gw2-zoneB zone prefix zoneA_GK2 2222* gw-priority 10 ccm1-zoneA_1 zone prefix zoneB 3333* gw-priority 10 ccm2-zoneB_1 zone prefix zoneA_GK2 5900* gw-priority 10 cvp1-zoneA zone prefix zoneB 6900* gw-priority 10 cvp2-zoneB gw-type-prefix 1#* default-technology lrq forward-queries no shutdown
How It Works
The Unified CVP H.323 Service can be configured with a list of up to five gatekeepers. When the H.323 Service starts, it attempts to register to the first gatekeeper in the list. If the registration is not successful, it proceeds to sequentially try the remainder of the gatekeepers in the list until a successful registration occurs. The H.323 Service stays registered to that gatekeeper until either: That gatekeeper experiences a failure. The Voice Brower recognizes a gatekeeper failure in the following ways: The periodic RAS RRQ (registration request) to the gatekeeper times out or is rejected. An ARQ (admission request) on a transfer times out. The gatekeeper proactively tells the H.323 Service to unregister, such as when the administrator does a shutdown on the gatekeeper configuration. The user executes another setGK from VBAdmin. This will cause the H.323 Service to register with the first gatekeeper in the list, if that gatekeeper is available; otherwise, it will once again do a sequential attempt. The Unified CVP H.323 Service goes out of service when it detects a gatekeeper failure and stays out of service until it can successfully register to another gatekeeper. During the period that it is out of service, new calls will be rejected by the Unified CVP H.323 Service. The ingress gateway will need to take an alternate routing action for those incoming calls (for example, invoke Unified CVP survivability, or reject the call back to the PSTN network to take alternate call routing action). Calls that are in service will generally be unaffected. This is because either the call has already been transferred or by the time the call needs to be transferred (the only time that the gatekeeper is needed by the Unified CVP H.323 Service). The Unified CVP H.323 Service has most likely already registered to an alternate gatekeeper. However, there is a risk of a timing condition where one or both of the endpoints involved in the transfer (Unified CVP or the target H.323 endpoint) may not have had a chance to register to the alternate gatekeeper.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
465
Chapter 14: Configuring the H.323 Devices and VoIP Gatekeeper Redundancy
There is a possibility that these calls may be dropped unless survivability and Unified ICME scripting actions have been taken to compensate for the failure. Note: See the "About the H.323 Service and the Gatekeeper (page 358)" section in Chapter 9, "Administering the Unified CVP H.323 Service," in Part 2. Although the Unified CVP H.323 Service does not support Gatekeeper Update Protocol (GUP) clustering, there is no reason that the gatekeepers cannot be defined as part of a GUP cluster. In this way, other H.323 endpoints that do support clustering (such as Cisco Unified Communications Manager and IOS gateways) can take advantage of the benefits of GUP. Unified CVP will simply ignore GUP messages, such as when one of the gatekeepers in the cluster becomes overloaded. Unified CVP would use one or more of the gatekeepers in the cluster as the alternate gatekeepers in its list and detect failure according to the rules mentioned in the bullets above. It is important to note that you must explicitly itemize all the gatekeepers in the cluster using setGK in VBAdmin. If Unified CVP supported GUP clustering, it would only need to register to one of the gatekeepers and the gatekeeper would send Unified CVP the list of gatekeepers in the cluster upon registration.
From Unified CVP VBAdmin, enter setGK 10.86.129.33. This command sets up a single gatekeeper to which the H.323 Service will register.
Step 2
Enter setGK 10.86.129.33:zonename1. This command sets up a single gatekeeper to which the H.323 Service will register to the zone in the gatekeeper named zonename1.
Step 3
Enter setGK 10.86.129.33, 10.86.129.34, 10.86.129.35. This command sets up three gatekeepers to which the H.323 Service can register. In each case, the H.323 Service registers to the first local zone that is configured in that gatekeeper and uses the default RAS port 1719.
Step 4
Enter setGK 10.86.129.33:zonename1:1718, 10.86.129.34. The H.323 Service first attempts to register to gatekeeper 10.86.129.33 with local zone zonename1 on port 1718. If that gatekeeper fails, the H.323 Service attempts to register to 10.86.129.34 on port 1719 with the first local zone defined on that gatekeeper.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
466
Chapter 14: Configuring the H.323 Devices and VoIP Configuring Unified CVP to Propagate UUI to Unified ICME
gatekeeper zone local zoneA cisco.com 10.86.129.36 zone local zoneB_GK1 cisco.com zone cluster local A_Cluster zoneA element zoneA_GK2 10.86.129.118 1719 zone cluster local B_Cluster zoneB_GK1 element zoneB 10.86.129.118 1719 zone prefix zoneA 111111* gw-priority 10 gw1-zoneA zone prefix zoneB_GK1 112233* gw-priority 10 gw2-zoneB zone prefix zoneA 2222* gw-priority 10 ccm1-zoneA_1 zone prefix zoneB_GK1 3333* gw-priority 10 ccm2-zoneB_1 zone prefix zoneA 5900* gw-priority 10 cvp1-zoneA zone prefix zoneB_GK1 6900* gw-priority 10 cvp2-zoneB gw-type-prefix 1#* default-technology lrq forward-queries no shutdown
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
467
Chapter 14: Configuring the H.323 Devices and VoIP Configuring Unified CVP to Propagate UUI to Unified ICME
6616807: *Jan 31 17:12:41.220: gtd msg = "IAM, PRN,isdn*,,ATT5*, USI,rate,c,s,c,1 USI,lay1,ulaw TMR,00 CPN,00,,u,5900 CPC,09 FCI,,,,,,,y, UUS,3,3132333435 GCI,87c0c79d91dd11daa9c4000bfda207f2
The data that will appear in Unified ICME UserToUserInfo will look as follows:
uus.dat,12345;;cpc.cpc,09;;
Note: The NSS parameters are delimited by two semicolons; fields within the NSS parameter are delimited by a comma.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
468
Chapter 14: Configuring the H.323 Devices and VoIP Configuring Unified CVP to Propagate UUI to Unified ICME
Note: The ":2" means convert the second field in the UUS parameter string to ASCII before sending to Unified ICME. The data that will appear in the Unified ICME UserToUserInfo will look as follows:
UUS,3,12345;;CPN,00,,u,5900;;
Note: The NSS parameters are delimited by two semicolons; fields within the NSS parameter are delimited by a comma. If extracting OLI from the GTD, several things need to be done: OLI will arrive in the FDC NSS param. You need to enter the isdn ie oli hex value indicates the IE identifier of the OLI in the setup. Note: This step is necessary because different switches place OLI in different ISDN IE locations. The service provider might need to specifically configure the switch to pass OLI to the gateway.
Look for the GTD values sent to the Unified ICME using the Unified CVP Call Server:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
469
Chapter 14: Configuring the H.323 Devices and VoIP Unified CVP Endpoint Limitations
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
470
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gateway
Limitation
Description
If a Gatekeeper fails and no hot standby is configured, the following features of call routing will be affected: The H.323 Service will go out of service. No switch transfers will succeed.
Outbound Alternate Endpoint functionality The agent reserve timer can expire before the call arrives, allowing a different call to reach the agent that does not match the call data previously not fully supported when transferring to sent to the agent by the Unified ICME software. agents reserved by Unified ICME. Use the router requery feature instead. G711ulaw is required codec when doing ASR/TTS. Calls from Cisco Unified Communications Manager to Unified CVP require MTP resources. In Unified CVP Standalone model or VRU-only model, calls from IP phones require an IPIPGW IOS if transfering to another IP endpoint. When an IP-originated call arrives to an IOS gateway for VoiceXML treatment in either Unified CVP Standalone or VRU-only model, and that call is to be transferred to an IP endpoint, it is necessary to enable the following IOS command:
voice service voip Allow-connections XXX to YYY
The ASR/TTS vendors currently only support g711ulaw for voice recognition and synthesis.
where xxx = sip or h323, depending on the protocol of the calling party and yyy = sip or h323, depending on the protocol of the called party. H323 Fast Start is not supported for calls Disable Cisco Unified Communications Manager Fast Start by changing originating from or being sent to Unified CM "H323 FastStart Inbound" flag to false in Cisco Unified Communications from the Unified CVP H.323 Service. Manager service parameters (for Cisco Unified Communications Manager 4.0 and earlier) or by unchecking the "Enable Inbound Fast Start" on the Unified CVP H.323 Service Gateway Device (Cisco Unified Communications Manager 4.1 and later).
Configuring a Gateway
From the Device Management menu, Gateway option, you can add a pre-configured IOS Gateway to the Operations Console. Once added, you can execute a subset of IOS Gateway commands on the Gateway from the Operations Console. The Ingress Gateway is the point at which an incoming call enters the Unified CVP solution. It terminates TDM phone lines on one side and implements VoIP on the other side. It also provides for sophisticated call switching capabilities at the command of other Unified solution components. It works with either H.323 or SIP protocols, and also supports MGCP for use with Unified CM.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
471
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gateway
The Ingress Gateway may be deployed separately from the VoiceXML Gateway, but in most implementations they are one and the same: one gateway performs both functions. Gateways are often deployed in farms, for centralized deployment models. In Branch deployment models, one combined gateway is usually located at each branch office. The VoiceXML Gateway hosts the IOS voice browser, the component which interprets VoiceXML pages from either the Unified CVP IVR service or the VXML Server, plays .wav files and Text-to-Speech (TTS), inputs voice and DTMF, and sends results back to the VoiceXML requestor. It also mediates between Media Servers, VXML Servers, ASR and TTS Servers, and the IVR service. Unless it is combined with the Ingress Gateway, the VoiceXML Gateway does not require any TDM hardware. All its interfaces are VoIP on one side and HTTP (carrying VXML or .wav files) and MRCP (carrying ASR and TTS traffic) on the other side. As with Ingress Gateways, VXML Gateways are often deployed in farms for centralized deployment models, or one per office in Branch deployments. Voice Codec class configuration should be symmetrical on the Ingress gateway and the Egress gateway. Use the voice class codec command to define the list of codecs available and the order in which they should be tried. For example, if G.729 is the preferred codec, the codec class should be configured to prefer G.729 and then G.711 on both gateways as shown in the example below. Codec class 2 is used for Codec negotiation.
voice class codec 1 codec preference 1 g729r8 codec preference 2 g711ulaw
You can perform the following tasks: Adding a Gateway (page 472) Editing a Gateway (page 474) Deleting a Gateway (page 473) Executing Gateway Commands (page 476) Getting Gateway Statistics (page 477) Transferring a File to a Gateway (page 476) Finding a Gateway (page 478)
Adding a Gateway
You can add a pre-configured IOS gateway to the Operations Console.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
472
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gateway
Before You Begin Collect the following information from the IOS Gateway before adding the gateway: Needed Information: IP address Device type: 28xx, 37xx, 38xx, 5xxxx Username and password Enable password
Procedure
To add a gateway:
Step 1
Choose Device Management > Gateway. The Find, Add, Delete, Edit Gateways window opens. Note: To use an existing gateway as a template for creating the new gateway, select the gateway by clicking the radio button preceding it and then click Use As Template.
Step 2
Step 3
Fill in the IP address, hostname, user password, and enable password for the gateway. Optionally, fill in additional configuration settings on the General tab. Select the Device Pool tab and add the gateway to a device pool. When you finish configuring the gateway, click Save to save the configuration.
Step 4 Step 5
See Also Gateway Configuration Settings (page 475) Adding and Removing a Device from a Device Pool (page ?) Viewing Device State (page ?)
Deleting a Gateway
Deleting a gateway deletes the configuration of the selected gateway in the Operations Console database and removes the gateway from the displayed list of gateways.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
473
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gateway
Procedure
To delete a gateway:
Step 1
Choose Device Management > Gateway. The Find, Add, Delete, Edit Gateways window displays.
Find the gateway by using the procedure in the Finding a Gateway (page 478) topic. From the list of matching records, choose the gateway that you want to delete. Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
Editing a Gateway
You can change most information that configures a gateway that has been added to the Operations Console. You cannot change the IP address of the gateway.
Procedure
To edit a gateway:
Step 1
Choose Device Management > Gateway. The Find, Add, Delete, Edit Gateways window opens.
Find the gateway by using the procedure in the Finding a Gateway (page 478) topic. From the list of matching records, choose the gateway that you want to edit. Click Edit. The Gateway Configuration window opens with the current settings displayed on the General tab.
Change the appropriate configuration settings. Optionally, select the Device Pool tab and add the gateway to a device pool. When you finish configuring the gateway, click Save to save the configuration.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
474
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gateway
See Also Gateway Configuration Settings (page 475) Adding and Removing a Device from a Device Pool (page ?) Executing IOS Commands on the Gateway (page 476) Getting Gateway Statistics (page 477) Transferring Script Files (page 288) Viewing Device State (page ?)
Field
Description
Default
Range
General IP Address Hostname The IP address of the gateway The name of the gateway None None Valid IP address Valid DNS name, which can include letters in the alphabet, the numbers 0 through 9, and a dash 28xx, 37xx, 38xx, 5xxxx , other Up to 1,024 characters enabled or disabled
None None
Select On to enable secure None Enable Secure Communication with communications between the the Ops console Operations Server and this component. The device is accessed using SSH and files are transferred using HTTPS. Select only if security is enabled and configured on Gateway. You must configure secure communications before you enable this option. See Chapter 6 in the Configuration and Administration Guide for Unified Customer Voice Portal. Username and Passwords Username (Optional) User name to access the device (telnet or ssh Username). If specified, the user name must be configured on the device. None
None
User Password
Password to access the device (telnet None or ssh password), needs to be configured on device.
None
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
475
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gateway
Field
Description
Default
Range
Enable Password
None
Command
Description
Procedure
To execute a gateway commands:
Step 1
Choose Device Management > Gateway. The Find, Add, Delete, Edit Gateways window opens.
You are editing an existing gateway configuration, click Edit. Select IOS Commands from the Gateway Configuration toolbar. From the IOS Commands drop-down menu, select an IOS command to execute on the gateway. If the command fails, the error will be displayed in an error web page.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
476
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gateway
Procedure
To transfer files between the Operations Server and a gateway:
Step 1
Choose Device Management > Gateway. The Find, Add, Delete, Edit Gateway window lists any gateways that have been added to the Operations Console.
Step 2
Select a gateway by clicking on the link in its name field or by clicking the radio button preceding it and then clicking Edit. The Edit Gateway Configuration window opens.
Step 3
Select File Transfer > Scripts from the Gateway configuration toolbar. The File Transfer window opens.
Step 4
If the script is located on your local machine, click Select a script file from your local PC, then click Browse and select the script file to transfer to the Operations Server. If the script is located on the Operations Server, click Select from available script files.
b. Step 5
When you have selected the file to transfer, click Transfer to copy the selected file to the Operations Console.
Procedure
To get gateway statistics:
Step 1
Choose Device Management > Gateway. The Find, Add, Delete, Edit Gateways window opens.
Step 2
Select a gateway by clicking on the link in the Hostname field or by clicking the radio button preceding it and then clicking Edit. Note: If the list of gateways is long, you can search for a gateway. See the Finding a Gateway (page 478) help topic. The Edit Gateway Configuration window opens to the General tab.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
477
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gateway
Step 3
Click Statistics in the toolbar and then select the type of statistics to view from the drop-down menu. The Gateway Statistics Results window opens, displaying the selected statistics. If the statistics fill the display area, use the scroll bar to move forward and backward or up and down in the display. See Gateway Statistics. (page 344)
Finding a Gateway
Because you most likely have several gateways in your network, the Operations Console lets you locate specific gateways on the basis of specific criteria. Use the following procedure to locate a gateway.
Procedure
To find a gateway:
Step 1
Choose Device Management > Gateway from the Main menu. The Find, Add, Delete, Edit Window lists the available gateways, 10 at a time, sorted by name.
Step 2 Step 3
If the list is long, click Next to view the next group of available gateways. If you know the exact name of a particular gateway, enter the name in the Search text box and then click Go. Note: Basic Search and Advanced Search are not case sensitive, and wildcard characters are not allowed. If the Search text box is empty, all gateways are listed.
Step 4
To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
478
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gatekeeper
is exactly is empty
Step 6
Configuring a Gatekeeper
From the Device Management menu, Gatekeeper option, you can add a pre-configured IOS Gatekeeper to the Unified CVP Operations Console. Once added, you can execute a subset of IOS Gatekeeper commands on the Gatekeeper from the Operations Console. You can perform the following tasks: Finding a Gatekeeper (page ?) Adding a Gatekeeper (page 472) Deleting a Gatekeeper (page 473) Editing a Gatekeeper (page 482) Executing Gatekeeper Commands (page 476) Getting Device Statistics (page ?) Transferring Files (page ?)
Finding a Gatekeeper
Because you most likely have several gatekeepers in your network, the Operations Console lets you locate specific gatekeepers on the basis of specific criteria. Use the following procedure to locate a gatekeeper.
Procedure
To find a gatekeeper:
Step 1
Choose Device Management > Gatekeepers from the Main menu. The Find, Add, Delete, Edit Gatekeepers window lists the available gatekeepers of the type you selected, 10 at a screen, sorted by name.
Step 2
If the list is long, click Next to view the next group of available devices.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
479
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gatekeeper
Step 3
If you know the exact name of a particular gatekeeper, enter the name in the Search text box and then click Go. Note: Basic Search is not case sensitive, and wildcard characters are not allowed. If the Search text box is empty, all gatekeepers are listed.
Step 4
To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with is exactly is empty
Step 6
Adding a Gatekeeper
You can add a pre-configured Gatekeeper to the Operations Console. Before You Begin Collect the following information from the gatekeeper before adding the device: Information You Will Need: IP address Username and password Enable password
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
480
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gatekeeper
Procedure
To add a gatekeeper:
Step 1
Choose Device Management > Gatekeeper. The Find, Add, Delete, Edit Gatekeepers window opens. Note: To use an existing gatekeeper as a template for creating the new gatekeeper, select the gatekeeper by clicking the radio button preceding it and then click Use As Template.
Step 2
Step 3
Fill in the appropriate configuration settings on the General tab as described in Gatekeeper Configuration Settings (page 483). Optionally, select the Device Pool tab and add the Gatekeeper to a device pool. See Adding and Removing a Device from a Device Pool (page ?) for detailed instructions.
Step 4
Step 5
When you finish configuring the Gatekeeper, click Save to save the settings in the Operations Console database.
Deleting a Gatekeeper
Deleting a gatekeeper from the Operations Console deletes the configuration of the selected gatekeeper in the Operations Console database and removes the gatekeeper from the displayed list of gatekeepers.
Procedure
To delete a gatekeeper:
Step 1
Choose Device Management > Gatekeeper. The Find, Add, Delete, Edit Gatekeeper window displays.
Step 2 Step 3
Find the gatekeeper by using the procedure in the Finding a Gatekeeper (page 479) topic. From the list of matching records, choose the gatekeeper that you want to delete.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
481
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gatekeeper
Step 4 Step 5
Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
Editing a Gatekeeper
You can edit most configuration settings for a Gatekeeper that has been added to the Operations Console. You cannot change the IP address of the Gatekeeper.
Procedure
To edit a gatekeeper:
Step 1
Choose Device Management > Gatekeeper. The Find, Add, Delete, Edit Gatekeeper window opens.
Find the gatekeeper by using the procedure in the Finding a Gatekeeper (page 479) topic. From the list of matching records, choose the gatekeeper that you want to edit. Click Edit. The Gatekeeper Configuration window opens to the General tab, with the current settings displayed.
Change the desired configuration settings. You cannot change the IP address of the Gatekeeper. Optionally, select the Device Pool tab and add the Gatekeeper to a device pool. When you finish configuring the gateway, click Save to save the configuration.
See Also Executing Gatekeeper Commands (page 483) Getting Device Statistics (page ?) Transferring Script Files (page 288) Gatekeeper Configuration Settings (page 483) Adding and Removing a Device from a Device Pool (page ?) Viewing Device State (page ?)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
482
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gatekeeper
Procedure
To execute gatekeeper commands:
Step 1
Choose Device Management > Gatekeeper. The Find, Add, Delete, Edit Gatekeeper window opens.
Step 2 Step 3
To edit an existing gateway configuration, click Edit. From the IOS Commands drop-down menu, select an IOS command to execute on the gatekeeper. If the command fails, the error will be displayed.
Field
Description
Default
Range
General IP Address Hostname The IP address of the gatekeeper The host name of the gatekeeper None None Valid IP address Valid DNS name, which can include letters in the alphabet, the numbers 0 through 9, and a dash Any string On or Off
Description Security
None
Select On to enable secure communications None between the Operations Server and this component. The device is accessed using SSH and files are transferred using HTTPS. Select only if security is enabled and configured on the gatekeeper.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
483
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gatekeeper
Field
Description
Default
Range
You must configure secure communications before you enable this option. Note: Refer to Chapter 6 in the Configuration and Administration Guide for Cisco Unified Customer Voice Portal. User Name and Passwords User Name User name to access the device (telnet or ssh None user name). This user name is optional. If the user name is filled in, it must be configured on the device. Password to access the device (telnet or ssh None password), needs to be configured on device. Password to change to exec mode on device. None None
None None
Command
Description
Show running-config Show startup-config Show version show gatekeeper gw-type prefix show gatekeeper endpoint show gatekeeper standby See Also
Displays running-config Displays startup-config Displays IOS version Displays string of the IOS command as executed on the device Displays full string of the IOS command as executed on the device. Value stored in database. After command is executed field value will be refreshed Displays string of the IOS command as executed on the device
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
484
Chapter 14: Configuring the H.323 Devices and VoIP Configuring a Gatekeeper
Gateway Gatekeeper Content Services Switch Scripts transferred to a VXML Server or VXML Server (standalone) must be stored in the . zip archive format, otherwise the Operations Console returns an invalid format error message and the file is not transferred. You can use the Call Studio archive feature to create .zip script files to be transferred to a VXML Server or VXML Server (standalone). To create an Archive file using Call Studio: 1. Right-click on a project in the Navigator view, and choose Deploy. 2. Under Deploy Destination, choose Archive File. 3. Enter the location and filename of the destination file in the Archive File text field. Note: The filename must end with a ".zip" extension. 4. Click Finish. Transferring a file is a two-step process: 1. Upload the file to the Operations Console. 2. Select one or more servers to transfer the uploaded file to.
Procedure
To transfer a script file:
Step 1
From the Device Management menu, choose the type of server to which to transfer the script file. For example, to transfer a script file to a VXML Server, choose Device Management > VXML Server. The Find, Add, Delete, Edit window lists any servers that have been added to the Operations Console.
Step 2
Select a server by clicking on the link in its Hostname field or by clicking the radio button preceding it and then clicking Edit. Select File Transfer in the toolbar and then click Scripts. The Script File Transfer page opens, listing the host name and IP address for the selected device. Script files currently stored in the Operations Server database are listed in the Select From available Script Files box.
Step 3
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
485
Chapter 14: Configuring the H.323 Devices and VoIP Configuring an ICM Server
Step 4
If the script file is not listed in the Select From Available Script Files box:
a. b.
Click Select a Script File from Your Local PC. Enter the file name in the text box or click Browse to search for the script file on the local file system.
Step 5 Step 6
If the script file is listed in the Select From Available Script Files box, select the script file. Click Transfer to send the file to the device. The script file is transferred to the selected server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
486
Chapter 14: Configuring the H.323 Devices and VoIP Configuring an ICM Server
Procedure
To add an ICM Server:
Step 1
Choose Device Management > ICM Server. The Find, Add, Delete, Edit ICM Server window opens. Note: To use an existing ICM Server as a template for creating the new ICM Server, select the ICM Server by clicking the radio button preceding it and then click Use As Template.
Step 2
Fill in the appropriate ICM configuration settings on the General tab. Optionally, select the Device Pool tab and add the ICM Server to a device pool. When you finish configuring the ICM Server, click Save to save the configuration.
See Also ICM Server Configuration Settings (page 489) Adding and Removing an ICM Server from a Device Pool (page ?) Viewing Device State (page ?)
Procedure
To delete an ICM Server:
Step 1
Choose Device Management > ICM Server. The Find, Add, Delete, Edit ICM Server window displays.
Step 2 Step 3
From the list of matching records, choose the ICM Server that you want to delete. Click Delete.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
487
Chapter 14: Configuring the H.323 Devices and VoIP Configuring an ICM Server
Step 4
When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
Procedure
To edit an ICM Server:
Step 1
Choose Device Management > ICM Server. The Find, Add, Delete, Edit ICM Server window opens.
Step 2 Step 3
From the list of matching records, choose the ICM Server that you want to edit. Click Edit. The ICM Server Configuration window opens with the current settings displayed.
Step 4
Fill in the appropriate ICM Server configuration settings on the General tab. You cannot change the IP address of the ICM Server. Optionally, select the Device Pool tab and add the ICM Server to a device pool. When you finish configuring the ICM Server, click Save to save the configuration.
Step 5 Step 6
See Also ICM Server Configuration Settings (page 489) Adding and Removing a Device form a Device Pool (page ?) Viewing Device State (page ?) Finding an ICM Server (page 488)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
488
Chapter 14: Configuring the H.323 Devices and VoIP Configuring an ICM Server
Procedure
To find an ICM Server:
Step 1
Choose Device Management > ICM Server from the Main menu. The Find, Add, Delete, Edit ICM Servers window lists the available ICM Servers of the type you selected, sorted by name, 10 at a time.
Step 2 Step 3
If this list is longer then 10 devices, click Next to view the next group of available devices. If you know the host name of a particular ICM Server, enter its name in the Search text box and then click Go. To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP Address Description
Step 4
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with is exactly is empty
Step 6
General
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
489
Chapter 14: Configuring the H.323 Devices and VoIP Configuring an ICM Server
Field
Description
Default
Range
Restart Required
IP Address Hostname
None
Valid IP address
Yes
Valid DNS name, which Yes can include letters in the alphabet, the numbers 0 through 9, and a dash. Up to 1,024 characters No
Description
None
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
490
Chapter 15
Configuring High Availability for Unified CVP
This chapter provides information about how to accommodate load balancing and redundancy in Unified CVP deployments. This chapter contains the following topics: Using Cisco Content Services Switch (CSS) for Load Balancing in Unified CVP, page 491 CSS Configuration for Media Servers, page 492 CSS Configuration for Call Servers, page 496 CSS Configuration for ASR/TTS Servers, page 499 CSS Configuration for VXML Servers, page 502 Redundancy and Failover for Unified CVP, page 504 Configuring a Content Services Switch (CSS), page 510 Configuring a Speech Server, page 517
Using Cisco Content Services Switch (CSS) for Load Balancing in Unified CVP
A Content Services Switch (CSS) provides load-balancing services for HTTP and MRCP traffic, but not for call control signaling SIP or H.323 messages. You can add a CSS to the network map that is displayed in the control center. Once added, you can add a CSS to a device pool and execute a subset of IOS commands on the CSS from the Operations Console and transfer files between the CSS and the Unified CVP Operations Server (see the "Configuring a Content Services Switch (CSS) (page 510)" and the "Configuring a Speech Server (page 517)" sections). In this application of CSS, the engine is used primarily to direct initial session requests for a particular type of service. There are four types of services: http prompts ASR/TTS Unified CVP Call Server
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
491
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for Media Servers
VXML Server The following general approach will apply to configuring each Unified CVP component type for use with CSS. Specific component-type configuration is covered in the following sections. ServicesOne CSS Service is configured for each Unified CVP component that needs CSS load balancing. For general step-by-step guidelines for configuring Services, refer to the CSS Basic Configuration Guide. RulesA content rule should be established for each Unified CVP component type. In order to define a content rule, a content owner must be defined on the Content Switch. (Refer to the CSS Basic Configuration Guide.) Media Servers, Call Servers, ASR/TTS Servers and VXML Servers might each have their own content rules defined. For general step-by-step guidelines for configuring content rules, refer to the CSS Basic Configuration Guide. GroupsIt may be necessary to define source groups for each service. Group configuration will vary depending upon whether a single VLAN or multiple VLANs are used for the CSS inbound and outbound traffic from the voice gateway and the Unified CVP component servers. If the servers and the voice gateway clients are on the same VLAN, then destination services will need to be specified. This configuration is sometimes referred to as a one-arm configuration because all traffic passes through one interface. Refer to the online documentation for the Cisco Content Switch entitled, How to Configure the CSS to Load Balance Using One Interface. At the time of this writing, the document was located here: http://www.cisco.com/en/US/products/hw/contnetw/ps789/ products_configuration_example09186a0080093dff.shtml Also, refer to the CSS Basic Configuration Guide for help determining whether your setup will require destination services. The examples in the next section incorporate the use of destination services. KeepalivesEach Unified CVP component type will also have a varying type of keepalive defined. The CSS keepalive definitions will allow for an appropriate method of determining whether the component is functional and able to participate in receiving requests.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
492
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for Media Servers
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
493
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for Media Servers
The following content rule implements a layer 5 http round-robin routing rule for two media servers, with the third server reserved for failover.
Example of Content Rule for Media Servers content MEDIA vip address 10.1.1.4 protocol any port 80 url "/*" add service mediaserver1 add service mediaserver2 primarySorryServer mediaserver3 active
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
494
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for Media Servers
Activate services, group, and rules Activate each service and group of media-servers
group mediaservers add destination service mediaserver1 add destination service mediaserver2 add destination service mediaserver3 vip address 10.1.1.4
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
495
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for Call Servers
For example: If a Unified CVP system deployment includes multiple language prompts, English and Spanish, the company may elect to house all Spanish versions of media server prompts on 3 media servers, and all English prompts on three separate media servers. Note: This choice would be independent of the virtual directory setting, which is controlled by the Unified CVP language parameter. While this parameter alters the path in the url of media, our example assumes that the company further wants to house different languages on different serversperhaps for traffic volume purposes. For more information on the language parameter, see Chapter 16, "Configuring the Media Servers (page 525)." In this example, the Unified ICME routing script that constructs the VRU call flow would identify and set the media-server name differently depending upon whether the caller initially has chosen English or Spanish. If they choose English, you might re-set the Media Server name to "media-english" and if Spanish is selected, "media-spanish." To support this, six services would be configured within CSS, one service for each media server. Two (2) content rules would also be configured. Each content rule would map to a different vip address and contain only those services which match the language the rule is configured for. Finally, the voice gateways would have separate host entries for the English and Spanish media-server names (and their backup version) as set within the Unified ICME scripts. After the content rules are applied, the following host entries would then appear on the voice gateways:
ip ip ip ip host host host host media-english 10.2.1.1 media-english-backup 10.2.1.1 media-spanish 10.2.1.2 media-spanish-backup 10.2.1.2
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
496
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for Call Servers
Note: The Unified CVP H.323 Service maintains a list of its own Call Servers used as an interface between the H.323 Service and the Unified ICME for route requests. Retry logic within the H.323 Service controls requests to the H.323 Services Call Servers for routing requests via the CallServerList H.323 Service definitions. If separate Call Servers are used for a Unified CVP H.323 Services interface to Unified ICME for route requests, these Call Servers do not require configuration within CSS.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
497
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for Call Servers
ap-kal-httpvxml
Assign the keepalive script to each of the Call Server services. The ap-kal-httpvxml keepalive script accepts one parameter, which is the ipaddress of the Call Server for which the service is configured.
keepalive maxfailure 1
Note: If no keepalive retry period is specified, the default value of 5 seconds (recommended value) is used.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
498
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for ASR/TTS Servers
CSS Configuration for Call Servers: Activate Services, Group, and Rules
Activate each service and group of Call Servers.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
499
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for ASR/TTS Servers service asrtts2 port 554 protocol tcp keepalive retryperiod 2 keepalive maxfailure 1 keepalive type tcp keepalive port 554 ip address 10.1.1.10 service asrtts3 port 554 protocol tcp keepalive retryperiod 2 keepalive maxfailure 1 keepalive type tcp keepalive port 554 ip address 10.1.1.11
500
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for ASR/TTS Servers
group asrtts add destination service asrtts1 add destination service asrtts2 add destination service asrtts3 vip address 10.1.1.12
CSS Configuration for ASR/TTS Servers: Activate Services, Group, and Rules
Activate each service and group of ASR/TTS servers.
sr-en-us
and
asr-en-us-backup
For TTS:
tts-en-us
and
tts-en-us-backup
These host names should be set to resolve to the VIP address of the content rule that governs each service. (Note that in the CSS sample above, both ASR and TTS functions are handled by the same content rule and group of resources.) And the gateway entries at the voice gateway would look like this:
ip host asr-en-us 10.1.3.12 ip host asr-en-us-backup 10.1.3.12
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
501
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for VXML Servers ip host tts-en-us 10.1.3.13 ip host tts-en-us-backup 10.1.3.13
If a network design contains separate MRCP servers for ASR and TTS functions, CSS would contain separate services, separate source groups (if needed), and two separate content rules / vip addressesone for ASR and another for TTS resources. In this case, the CSS content rules might look like this:
content ASR add service asr1 add service asr2 primarySorryServer asr3 protocol tcp port 554 vip address 10.1.3.13 content TTS add service tts1 add service tts2 primarySorryServer tts3 protocol tcp port 554 vip address 10.1.3.13
And the gateway entries at the voice gateway would look like this:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
502
Chapter 15: Configuring High Availability for Unified CVP CSS Configuration for VXML Servers
keepalive type http keepalive type 7000 keepalive uri "/index.jsp" protocol tcp active
Example: Content Rule for VXML Servers content CVPVoicexml2_content protocol tcp add service CVPVoicexml1 add service CVPVoicexml2 vip address 209.165.200.227 port 7000 url "/*" advanced-balance arrowpoint-cookie active
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
503
Chapter 15: Configuring High Availability for Unified CVP Redundancy and Failover for Unified CVP
ASR, TTS, and Media Server Redundancy for VXML Server Applications (with CSS)
If you use a CSS for ASR or TTS servers, then the IP address specified in the following ivr commands should be the Virtual IP (VIP) address for the corresponding ASR or TTS service. VXML Server applications rely on the gateways configured default for ASR and TTS servers, which allow only a single host name or IP address to be specified for each. This differs from the Unified CVP micro-applications based applications, which support automatic retries to specifically named backup ASR and TTS servers. Use the following configuration on the gateway if you are using Nuance, Scansoft, or IBM WebSphere ASR/TTS servers:
ip host asr-en-us 10.10.10.1 ip host tts-en-us 10.10.10.2
Use the following configuration on the gateway if you are using Nuance, Scansoft, or IBM WebSphere ASR/TTS servers:
mrcp client rtpsetup enable ivr asr-server rtsp://asr-en-us/recognizer ivr tts-server rtsp://tts-en-us/synthesizer http client cache memory pool 15000 http client cache memory file 500 ivr prompt memory 15000 ivr prompt streamed none
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
504
Chapter 15: Configuring High Availability for Unified CVP Redundancy and Failover for Unified CVP
mrcp client timeout connect 5 mrcp client timeout message 5 rtsp client timeout connect 10 rtsp client timeout message 10 vxml tree memory 1000 no http client connection persistent
The URL configured by the above ivr commands defines the gateway's default target for ASR and TTS services, and is in effect for all calls handled by that gateway. You can override it dynamically in your VXML Server application by populating the Cisco-proprietary VoiceXML properties "com.cisco.asr-server" or "com.cisco.tts-server." Media servers require no special gateway configuration to work with a CSS for automatic failover.
ASR, TTS, and Media Server Redundancy for VXML Server Applications (without CSS)
If you do not use a CSS for ASR or TTS servers, the IVR Service plays a significant role in implementing a failover mechanism for Media Servers, ASR/TTS Servers and VXML Servers. Up to two of each such servers are supported, and the IVR Service orchestrates retries and failover between them. Note: For information about setting up the IVR Service to accommodate failover, refer to the Operations Console online help.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
505
Chapter 15: Configuring High Availability for Unified CVP Redundancy and Failover for Unified CVP
Note: If user.microapp.media_server is configured as the hard-coded IP Address of the media server, then the IVR Service will not perform any failover for the media server. If the IVR Service receives a Call Result error code value of 9 (MEDIA_FILE_NOT_FOUND), 33 (GENERAL_ASR_TTS), 31 (MEDIA_RESOURCE_ASR) or 32 (MEDIA_RESOURCE_TTS), it does the following: When attempting to connect to a Media Server, the IVR Service: Resends the request the number of times defined in the IVR Service Configuration's Media Server Retry Attempts field. If the connection is not successful after the specified number of attempts, and the IVR Service Configuration's Use Backup Media Servers field is set to Yes (the default), the IVR Service makes the same number of attempts to retrieve the media from a backup media server before failing and generating an error. Note: The backup media server is defined on the gateway as <mediaserver>-backup. Passes the error in a Call State Event to the ICM Service, which then passes it to Unified ICME. When attempting to connect to an ASR/TTS Server, the IVR Service: Resends the request the number of times defined in the IVR Service Configuration's ASR/TTS Server Retry Attempts field. If the connection is not successful after the specified number of attempts, and the IVR Service Configuration's Use Backup ASR/TTS Servers field is set to Yes (the default), the IVR Service makes the same number of attempts to connect to a backup ASR/TTS server before failing and generating an error. Note: The backup ASR and TTS servers are defined on the gateway as asr-<locale>-backup and tts-<locale>-backup. Passes the error in a Call State Event to the ICM Service, which then passes it to Unified ICME. Each new call attempts to connect to the primary server. If failover occurs, the backup server is used for the duration of the call; the next new call will attempt to connect to the primary server. Note: This failover mechanism differs from that used in prior releases of Unified CVP software. Legacy releases used a sticky connection. In a sticky connection, if failover occurs to a backup server, subsequent new calls automatically connect to the backup server, rather than attempt to connect with the primary server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
506
Chapter 15: Configuring High Availability for Unified CVP Redundancy and Failover for Unified CVP
CSS Redundancy
CSS supports several types of failover mechanisms. The Virtual IP redundancy mechanism will allow for a rapid failover from a defined Master CSS to its backup using VRRP. This failover takes less than three seconds and might or might not additionally incorporate the use of ASR. Unified CVP transactions to servers do not require a stateful connection to the gateway. If the CSS fails during a prompt, the VoiceXML documents that drive Unified CVP will retry and re-stream the prompt from the new CSS access. For this reason, general VIP redundancy is implemented. The sample below shows the redundant section for each of the two CSSs.
!************ CIRCUIT (CSS1)************ circuit VLAN1 ip address 10.1.1.100 255.255.255.0 ip virtual-router 1 priority 230 preempt ip redundant-interface 1 10.1.1.200 ip redundant-vip 1 10.1.1.4 ip redundant-vip 1 10.1.1.8 ip redundant-vip 1 10.1.1.12 !************ CIRCUIT (CSS2) ************ circuit VLAN1 ip address 10.1.1.101 255.255.255. ip virtual-router 1 priority 130 ip redundant-interface 1 10.1.1.200 ip redundant-vip 1 10.1.1.4 ip redundant-vip 1 10.1.1.8 ip redundant-vip 1 10.1.1.12
See Also For information and step-by step configuration guidelines on implementing CSS Redundancy using the VIP and VRRP mechanism, refer to the CSS Advanced Configuration Guide.
*************** GLOBAL **************** ip route 0.0.0.0 0.0.0.0 10.1.1.20 1 !************** INTERFACE ************** interface 2/6 phy 100Mbits-FD interface 2/16 bridge vlan 2
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
507
Chapter 15: Configuring High Availability for Unified CVP Redundancy and Failover for Unified CVP
!************** CIRCUIT **************** circuit VLAN1 ip address 10.1.1.100 255.255.255.0 ip virtual-router 1 priority 230 preempt ip redundant-interface 1 10.1.1.200 ip redundant-vip 1 10.1.1.4 ip redundant-vip 1 10.1.1.8 ip redundant-vip 1 10.1.1.12 !************* SERVICE ***************** service mediaserver1 ip address 10.1.1.1 type redirect port 80 domain 10.1.1.1 keepalive type http keepalive retryperiod 2 keepalive maxfailure 1 keepalive uri "/index.html" active service mediaserver2 ip address 10.1.1.2 type redirect port 80 domain 10.1.1.2 keepalive type http keepalive retryperiod 2 keepalive maxfailure 1 keepalive uri "/index.html" active service mediaserver3 ip address 10.1.1.3 type redirect port 80 domain 10.1.1.3 keepalive type http keepalive retryperiod 2 keepalive maxfailure 1 keepalive uri "/index.html" active service appserver1 ip address 10.1.1.5 keepalive retryperiod 2 keepalive maxfailure 1 keepalive type script ap-kal-httpvxml "10.1.1.5" active service appserver2 ip address 10.1.1.6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
508
Chapter 15: Configuring High Availability for Unified CVP Redundancy and Failover for Unified CVP
keepalive retryperiod 2 keepalive maxfailure 1 keepalive type script ap-kal-httpvxml "10.1.1.6" active service appserver3 ip address 10.1.1.7 keepalive retryperiod 2 keepalive maxfailure 1 keepalive type script ap-kal-httpvxml "10.1.1.7" active service asrtts1 port 554 protocol tcp keepalive retryperiod 2 keepalive maxfailure 1 keepalive type tcp keepalive port 554 ip address 10.1.1.9 active service asrtts2 port 554 protocol tcp keepalive retryperiod 2 keepalive maxfailure 1 keepalive type tcp keepalive port 554 ip address 10.1.1.10 active service asrtts3 port 554 protocol tcp keepalive retryperiod 2 keepalive maxfailure 1 keepalive type tcp keepalive port 554 ip address 10.1.1.11 active !************** OWNER ***************** owner CVP content MEDIA vip address 10.1.1.4 protocol any port 80 url "/*" add service mediaserver1 add service mediaserver2 primarySorryServer mediaserver3
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
509
Chapter 15: Configuring High Availability for Unified CVP Configuring a Content Services Switch (CSS)
active content APPSERVERS protocol tcp port 8000 add service appserver1 add service appserver2 primarySorryServer appserver3 vip address 10.1.1.8 active content ASRTTS add service asrtts1 add service asrtts2 primarySorryServer asrtts3 protocol tcp port 554 vip address 10.1.1.12 active !************** GROUP ***************** group mediaservers add destination service mediaserver1 add destination service mediaserver2 add destination service mediaserver3 vip address 10.1.1.4 active group appservers add destination service mediaserver1 add destination service mediaserver2 add destination service mediaserver3 vip address 10.1.1.8 active group asrtts add destination service mediaserver1 add destination service mediaserver2 add destination service mediaserver3 vip address 10.1.1.12 active
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
510
Chapter 15: Configuring High Availability for Unified CVP Configuring a Content Services Switch (CSS)
Servers, and ASR/TTS Servers. Various mechanisms allow it to implement transparent load balancing and failover across these types of devices. CSS is an optional device, but it comes highly recommended. Without it, the CVP IVR Service implements a failover mechanism for up to two of each of the above components, but they are not load balanced, and various retries and delays are part of the algorithm, all of which is avoided if CSS is used. The CSS is normally deployed as a Virtual Router Redundancy Protocol (VRRP) pair. It is useful in all deployment models except for Call Director. You can perform the following tasks: Adding a Content Services Switch (page 511) Editing a Content Services Switch (page 512) Deleting a Content Services Switch (page 513) Finding a Content Services Switch (page 513) Executing IOS Commands on a Content Services Switch (page 515) Transferring a Script File to a Content Services Switch (page 516) Getting Device Statistics (page ?)
Procedure
To add a Content Services Switch:
Step 1
Choose Device Management > Content Services Switch. The Find, Add, Delete, Edit Content Services Switch window opens.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
511
Chapter 15: Configuring High Availability for Unified CVP Configuring a Content Services Switch (CSS)
Step 2
Click Add New. The Content Services Switch Configuration window opens.
Step 3
Fill in the appropriate configuration settings on the General tab as described in Content Services Switch Configuration Settings. Select the Device Pool tab and add the Content Services Switch to a device pool. When you finish configuring the Content Services Switch, click Save to save the configuration.
Step 4 Step 5
See Also Viewing Device State (page ?) Content Services Switch Configuration Settings (page 514)
Procedure
To edit a Content Services Switch:
Step 1
Choose Device Management > Content Services Switch. The Find, Add, Delete, Edit Content Services Switches window opens.
Step 2 Step 3
From the list of matching records, choose the Content Services Switch that you want to edit. Click Edit. The Content Services Switch Configuration window opens with the current settings displayed.
Step 4
Fill in the appropriate configuration settings on the General tab as described in Content Services Switch Configuration Settings. Optionally, select the Device Pool tab and add the Content Services Switch to a device pool. When you finish configuring the Content Services Switch, click Save to save the configuration.
Step 5 Step 6
See Also Viewing Device State (page ?) Finding a Content Services Switch (page 513)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
512
Chapter 15: Configuring High Availability for Unified CVP Configuring a Content Services Switch (CSS)
Procedure
To delete a Content Services Switch:
Step 1
Choose Device Management > Content Services Switch. The Find, Add, Delete, Edit Content Services Switches window displays.
From the list of matching records, choose the Content Services Switch that you want to delete. Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
Procedure
To find a Content Services Switch:
Step 1
Choose Device Management > Content Services Switch from the Main menu. The Find, Add, Delete, Edit Content Services Switches window lists the available Content Services Switch of the type you selected, sorted by name, 10 at a time.
Step 2 Step 3
If the list is long, click Next to view the next group of available devices. If you know the host name of a particular Content Services Switch, enter its name in the Search text box and then click Go.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
513
Chapter 15: Configuring High Availability for Unified CVP Configuring a Content Services Switch (CSS)
Step 4
To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains is exactly ends with is empty
Step 6
Field
Description
Default
Range
Restart Required
General IP Address Hostname The IP address of the Content Services None Switch The host name of the Content Services None Switch Valid IP address Yes
Valid DNS name, Yes which can include letters in the alphabet, the numbers 0 through 9, and a dash 11xxxx Any string On or Off No No No
The type of device The description of the Content Services Switch Select to enable secure communications between the
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
514
Chapter 15: Configuring High Availability for Unified CVP Configuring a Content Services Switch (CSS)
Field
Description
Default
Range
Restart Required
Operations Server and this component. The device is accessed using SSH and files are transferred using HTTPS. You must configure secure communications before you enable this option. See Chapter 6 in the Configuration and Administration Guide for Cisco Unified Customer Voice Portal.
User Name and Passwords User Name User name to access the device (telnet None or ssh user name). This user name must be configured on the device. Password to access the device (telnet None or ssh password), needs to be configured on device. Password to change to exec mode on None device. None No
User Password
None
Yes
Enable Password
None
Yes
Command
Description
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
515
Chapter 15: Configuring High Availability for Unified CVP Configuring a Content Services Switch (CSS)
Open the Microsoft Services application and right-click FTP Publishing Service in the Services (Local) area. Select Properties from the drop-down list. The FTP Publishing Service Properties (Local Computer) window displays. Select Disabled from the Startup type list box. Click Apply, then click OK.
Step 2
Step 3 Step 4
Procedure
To transfer files from the Operations Console to a Content Service Switch:
Step 1
Choose Device Management > Content Service Switch. The Find, Add, Delete, Edit Content Services Switches window lists any Content Services Switches that have been added to the Operations Console.
Step 2
Select a Content Services Switch by clicking on the link in its name field or by clicking the radio button preceding it and then clicking Edit. You can also search for a Content Services Switch. The Content Services Switch Configuration window opens.
Step 3
Select File Transfer > Scripts from the toolbar. The Script File Transfer page opens, listing the IP address and host name of the currently selected Content Services Switch.
Step 4
If the script is located on your local machine, click Select a script file from your local PC, then click Browse and select the script file to transfer to the Operations Console.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
516
Chapter 15: Configuring High Availability for Unified CVP Configuring a Speech Server
b. Step 5
If the script is located on the Operations Console, click Select from available script files.
When you have selected the file to transfer, click Transfer to copy the selected file to the Content Services Switch.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
517
Chapter 15: Configuring High Availability for Unified CVP Configuring a Speech Server
Procedure
To add a speech server:
Step 1
Choose Device Management > Speech Server. The Find, Add, Delete, Edit Speech Server window opens. Note: To use an existing speech server as a template for creating the new speech server, select the speech server by clicking the radio button preceding it and then click Use As Template.
Step 2
Step 3
Fill in the appropriate configuration settings on the General tab as described in Speech Server Configuration Settings. Note: For the License file location field, the license file is the license file for the respective speech server. The location must be the absolute path to where the license file exists on the speech server. The license file must exist at that path before you can successfully save and deploy.
Step 4 Step 5
Select the Device Pool tab and add the speech server to a device pool. When you finish configuring the speech server, click Save to save the settings in the Operations Console database. Click Save & Deploy to deploy the changes to the speech server.
See Also Viewing Device State (page ?) Speech Server Configuration Settings (page 518)
Field
Description
Default
Range
Restart Required
General IP Address Hostname The IP address of the speech server None The host name of the speech server None Valid IP address Yes Valid DNS name, which Yes can include letters in the alphabet, the numbers 0 through 9, and a dash
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
518
Chapter 15: Configuring High Availability for Unified CVP Configuring a Speech Server
Field
Description
Default
Range
Restart Required
The description of the speech server None The path of the license file on the None speech server. The Operations Console transfers the license file to this location. Select On to enable secure None communications between the Operations Server and this component. The device is accessed using SSH and files are transferred using HTTPS.
On or Off
No
Procedure
To edit a speech server:
Step 1
Choose Device Management > Speech Server. The Find, Add, Delete, Edit Speech Server window opens.
From the list of matching records, choose the speech server that you want to edit. Click Edit. Change the appropriate configuration settings on the General tab. Select the Device Pool tab and add or remove the speech server from a device pool. When you finish configuring the speech server, click Save to save the settings in the Operations Console database. Click Save & Deploy to deploy the changes to the speech server.
See Also Adding and Removing a Speech Server from a Device Pool (page 521) Speech Server Configuration Settings (page 518) Viewing Device State (page ?) Finding a Speech Server (page 522)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
519
Chapter 15: Configuring High Availability for Unified CVP Configuring a Speech Server
Procedure
To apply a license file:
Step 1
Choose Device Management > Speech Server. The Find, Add, Delete, Edit speech server window opens.
From the list of matching records, choose the speech server that you want to edit. Click Edit. Make sure the License File Location lists the correct path of the license file on the speech server. The Operations Console transfers the license file to this location. Select File Transfer in the toolbar and then click Licensing. The License File Transfer page displays, listing the host name and IP address for the currently selected speech server.
Step 5
Step 6
If the license file is not listed in the Select From Available License Files text box:
a. b.
Click Select a License File from Your Local PC. Enter the file name in the text box or click Browse to search for the license file on the local file system.
Step 7 Step 8
If the license is listed in the Select From Available License Files text box, select the license file. Click Transfer to transfer the selected license file to the selected device. The license is applied to the selected server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
520
Chapter 15: Configuring High Availability for Unified CVP Configuring a Speech Server
Procedure
To delete a speech server:
Step 1
Choose Device Management > Speech Server. The Find, Add, Delete, Edit speech server window opens.
From the list of matching records, choose the speech server that you want to delete. Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
Choose Device Management > Speech Server. The Find, Add, Delete, Edit Speech Server window opens.
From the list of matching records, choose the speech server that you want to edit. Click Edit. Select the Device Pool tab.
If: You want to add a device to a device pool Then: Select the device pool from the Available pane, and then click the right arrow to move the pool to the Selected pane.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
521
Chapter 15: Configuring High Availability for Unified CVP Configuring a Speech Server
If: You want to remove a device from a device pool Then: Select the device pool from the Selected pane, and then click the left arrow to move the device pool to the Available pane.
Step 6
Click Save.
Procedure
To find a speech server:
Step 1
Choose Device Management > Speech Server from the Main menu. The Find, Add, Delete, Edit window lists the available speech servers, sorted by name, 10 at a time.
Step 2 Step 3
To scroll through the list, click Next to view the next group of available devices. If you know the name of a particular speech server, enter the name in the Search text box and then click Go. From the first Find window drop-down list box, choose one of the following criteria: Search criteria: Host Name IP Address Description
Step 4
Step 5
From the second Find Servers window drop-down list box, choose one of the following criteria: Search criteria: begins with contains is exactly
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
522
Chapter 15: Configuring High Availability for Unified CVP Configuring a Speech Server
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
523
Chapter 15: Configuring High Availability for Unified CVP Configuring a Speech Server
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
524
Chapter 16
Configuring the Media Servers
A Media Server administers the media files that contain messages and prompts callers hear. You can add a pre-configured Media Server to the Operations Console Control Center. Once added, you can add a Media Server to one or more device pools (see the "Configuring a Media Server (page 545)" section). This chapter contains the following topics: Media File Overview, page 525 System Media Files, page 530 Configuring a Media Server, page 545
Media Server
In Unified CVP, the Media Server is a computer or set of computers, which serve the media files that contain messages and prompts that callers will hear. Media files can be installed on an individual server or colocated with Unified CVP CallServer or VXML Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
525
There is no artificial limit on the number of prompts; prompts will be limited only by system capacity. Note: To maximize Unified CVP performance, do not install the HTTP Media Server on the same machine as the Unified CVP H.323 Service. Tools for prompt creation are off-the-shelf, such as Audition by Adobe (formerly known as Cool Edit Pro by Syntrillium Software Corporation), and Vox Studio (http://www.xentec.be). Note: It is the customers responsibility to select the tool, select a voice talent, record the system and application media files in the supported locales, format and encoding, and contact the person who is responsible for the media files on the Media Server(s).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
526
Parameter
Location of Data
Description
Examples
File location or base URL for Base URL example: the Media Server. http://www.machine1.com/dir1/ dirs/cust1 When the Media Server URL is the DNS name and the Note: By convention, the service DNS Server is configured to provider may include their return multiple IP addresses customers name at the end of the for a host name, the Unified Media Server set. Customer Voice Portal will attempt to get the media files from each Media Server IP address in sequence with the priority given to those on the subnet.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
527
Parameter
Location of Data
Description
Examples
Note: Unified Customer Voice Portal supports playing prompts from flash on the GW. In order to do this, set the media_server to "flash:" instead of the hostname or IP address of the media server. When using the Media Server set for external grammars or external VXML, if the Media Server URL is the DNS name with multiple IP addresses for the hostname, it is the ASR Engines responsibility to decide which machine to retrieve the grammar file from. Locale ECC variable: user.microapp.locale Default: en-us Media Library Type This field is a combination of en-us language and country with a default of en-us for English spoken in the United States.
The Media Library Type value The media library (directory) A (user.microapp.app_media_ passed from the VRU Script for the prompt is either the lib= app_banking) Name field. Valid options are: application prompt library defined by ECC variable A - Application prompt library. user.microapp.app_media_lib (default app) or the system S - System prompt library. prompt library defined by ECC variable V - External VXML. user.microapp.sys_media_lib (default sys). Default: A Note: When the Media Library Type is V (external VXML), the VXML file will reside in the Application Prompt Library. When the Media Library Type is A (Application prompt library), you must create the directory specified by this variable. For example, if you use the default app directory,
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
528
Parameter
Location of Data
Description
Examples
you must create an app directory in ./MediaFiles/en-us Media File Name Name of media file or The Media File Name value external VXML file to be passed from the VRU Script Name field. Valid options are played. the name of the .wav file to be played, or external VXML file name, or <blank>, which translates to playing no media. This file name will be ignored if TTS is being used (that is, if the user.microapp.inline_tts ECC variable contains a value.) Default: none Media File Name Type If not given as part of the Media Type of media file to be File Name, the type is .wav played. .wav Main_menu
Based on the examples shown in the table above, a valid address for the Media File might be: http://www.machine1.com/dir1/dirs/cust1/en-us/app_banking/main_menu.wav
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
529
To use the Unified CVP Version 1.1 default locale directory (for example, en_US), you must explicitly set it. When you upgrade to the current version of Unified CVP, only the new files are installed under the Unified CVP default locale directory, en-us. You want to have all your system prompts under one directory and all your application prompts and, optionally, external VXML in another directory. Use the user.microapp.locale ECC variable to set the locale directory to use, such as en_US. Note: You do not need to set the user.microapp.locale ECC variable if you used the default en-us. Also, remember that all locale values are case-sensitive.
Decimal Value
6
point minus 0 1 2 3 4 5 6 7 8 9 48 49 50 51 52 53 54 55 56 57 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14
6) ANSI Code Page 1252
one (masculine version), uno All except DOW (es-mx and es-es) two three four five six seven eight nine ten eleven twelve thirteen fourteen All except DOW All except DOW All except DOW All except DOW All except DOW All except DOW All except DOW All except DOW Same for the rest of all the numbers
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
530
Decimal Value
6
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46
6) ANSI Code Page 1252
fifteen sixteen seventeen eighteen nineteen twenty twenty-one twenty-two twenty-three twenty-four twenty-five twenty-six twenty-seven twenty-eight twenty-nine thirty thirty-one thirty-two thirty-three thirty-four thirty-five thirty-six thirty-seven thirty-eight thirty-nine forty forty-one forty-two forty-three forty-four forty-five forty-six
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
531
Decimal Value
6
47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78
6) ANSI Code Page 1252
forty-seven forty-eight forty-nine fifty fifty-one fifty-two fifty-three fifty-four fifty-five fifty-six fifty-seven fifty-eight fifty-nine sixty sixty-one sixty-two sixty-three sixty-four sixty-five sixty-six sixty-seven sixty-eight sixty-nine seventy seventy-one seventy-two seventy-three seventy-four seventy-five seventy-six seventy-seven seventy-eight
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
532
Decimal Value
6
seventy-nine eighty eighty-one eighty-two eighty-three eighty-four eighty-five eighty-six eighty-seven eighty-eight eighty-nine ninety ninety-one ninety-two ninety-three ninety-four ninety-five ninety-six ninety-seven ninety-eight ninety-nine oh hundred thousand million billion trillion 24TOD, Date Number, 24TOD, Date, Currency Number, Date, Currency Number, Currency Number, Date, Currency Number, Currency
The table that follows lists the System Media File information for ordinal numbers. Note: If ordinal system prompts are to be used in a script for a purpose other than dates, they should be recorded as application prompts with the true ordinal values.
6) ANSI Code Page 1252
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
533
Decimal Value
1ord 2ord 3ord 4ord 5ord 6ord 7ord 8ord 9ord 10ord 11ord 12ord 13ord 14ord 15ord 16ord 17ord 18ord 19ord 20ord 21ord 22ord 23ord 24ord 25ord 26ord 27ord 28ord 29ord 30ord
7) ANSI Code Page 1252
first second third fourth fifth sixth seventh eighth nineth tenth eleventh twelveth thirteenth fouteenth fifteenth sixteenth seventeenth eighteenth nineteenth twentieth twenty-first twenty-second twenty-third twenty-fourth twenty-fifth twenty-sixth twenty-seventh twenty-eight twenty-nineth thirtieth
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
534
Decimal Value
31ord
thirty-first
The table that follows lists the System Media File information for measurements.
Table 76: System Media Files, Measurements
Decimal Value
A, a B,b C, c D, d E, e F, f G, g H, h I, i J, j K, k L, l M, m N, n O, o P, p Q, q R, r S, s T, t U, u V, v W, w
7) 8)
189 188 190 65,97 66,98 67,99 68,100 69,101 70,102 71,103 72,104 73,105 74,106 75,107 76,108 77,109 78,110 79,111 80,112 81,113 82,114 83,115 84,116 85,117 86,118 87,119
Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
535
Decimal Value
X, x Y, y Z, z , , , , , , , , , , , , , , , , , , , , , x , , , , , ,
8)
88,120 89,121 90,122 140,156 192,224 193,225 194,226 195,227 196,228 197,229 198,230 200,232 201,233 202,234 203,235 204,236 205,237 206,238 207,239 208 240 210,242 211,243 212,244 213,245 214,246 215 216,248 217,249 218,250 219,251 220,252 221,253
x y z oe_140_156 a_192_224 a_193_225 a_194_226 a_195_227 a_196_228 a_197_229 ae_198_230 e_200_232 e_201_233 e_202_234 e_203_235 i_204_236 i_205 i_206 i_207 char_208 char_240 o_210_242 o_211_243 o_212_244 o_213_245 o_214_246 multiply o_216_248 u_217_249 u_218_250 u_219_251 u_220_252 y_221_253
X Y Z Ligature OE A grave A acute A circumflex A tilde A umlaut A with ring above Ligature AE E grave E acute E circumflex E umlaut I grave I acute I circumflex I umlaut character 208 character 240 O grave O acute O circumflex O tilde O umlaut multiplication sign oh stroke U grave U acute U circumflex U umlaut Y acute
Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
536
Decimal Value
character 222 double s division sign character 254 character 159 or 255
The table that follows lists the System Media File information for month values.
Table 77: System Media Files, Months
Decimal Value
January February March April May June July August September October November December
January February March April May June July August September October November December
Date Date Date Date Date Date Date Date Date Date Date Date
The table that follows lists the System Media File information for month values.
Table 78: System Media Files, Days
Decimal Value
10
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
537
Decimal Value
10
The table that follows lists the System Media File information for month values.
Table 79: System Media Files, Time
Decimal Value
11
Etime, 24TOD per locale, TOD per locale Etime,24TOD per locale,TOD per locale Etime Etime Etime,24TOD Etime,24TOD per locale(unused for en-us) per locale(unused for en-us) TOD TOD TOD
The table that follows lists the System Media File information for currency values. Note: The customers Media Administrator may prefer to replace the contents of currency_minus (for the negative amount) and currency_and (the latter can even be changed to contain silence).
10) 11)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
538
Decimal Value
12
Note: Unified CVP uses the USD_dollar.wav and USD_dollars.wav media files; the dollar.wav and dollars.wav used by ISN Version 1.0 are no longer installed. $ 36 CAD_dollar CAD_dollars HKD_dollar HKD_dollars 162 cent cents euro 163 GBP_pound GBP_pounds penny pence MXN_peso MXN_pesos centavo centavos dollar dollars dollar dollars cent cents euro pound pounds penny pence peso pesos centavo centavos Currency Currency Currency Currency Currency Currency Currency Currency Currency Currency Currency Currency Currency Currency Currency
The table that follows lists the System Media File information for gaps of silence and miscellaneous phrases.
Table 81: System Media Files, Silence and Miscellaneous Phrases
Decimal Value
13
silence_.1_ sec
12) 13) ANSI Code Page 1252 ANSI Code Page 1252
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
539
Decimal Value
13
Used for pauses where needed Used for pauses where needed Used for pauses where needed Etime,TOD,25TOD
The table that follows lists the System Media File informaiton for ANSI characters.
Table 82: System Media Files, ANSI Characters
space exclamation_ mark double_ quote pound percent ampersand apostrophe open_ parenthesis close_ parenthesis asterisk plus comma hyphen period slash colon semicolon less_than equal greater_than question_ mark
space exclamation mark double quote pound percent ampersand apostrophe open parenthesis close parenthesis asterisk plus comma hyphen period slash colon semicolon less than equal greater than question mark
Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char
33 34 35 37 38 39 40 41 42 43 44 45 46 47 58 59 60 61 62 63
ANSI Code Page 1252 ANSI Code Page 1252
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
540
@ [ \ ] ^ _ ` { | } ~ <
14)
64 91 92 93 94 95 96 123 124 125 126 130 131 132 133 134 135 136 137 138 139 145 146 147 148 149 150 151 152 153 154 155 161 164
ANSI Code Page 1252
at_symbol left_square_bracket backslash right_square_bracket caret underscore single_quote open_brace pipe close_brace tilde char_130 char_131 low double quote ellipsis char_134 char_135 char_136 per_mille char_138 left_pointing _angle left_single_ quote right_single_ quote left_double_ quote right_double _quote bullet en_dash em_dash small_tilde trade_mark char_154 char_155 exclamation_ mark_ inverted char_164
at left square bracket backslash right square bracket caret underscore single quote open brace pipe close brace tilde low single quote F with hook low double quote ellipsis character 134 character 135 character 136 per mille character 138 left pointing angle left single quote right single quote left double quote right double quote bullet en dash em dash small tilde trade mark character 154 character 155 character 164
Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
541
166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 191
broken_pipe section char_168 copyright char_170 left_double_ angle_ quote not char_173 registered char_175 degree plus_minus superscript_ 2 superscript_ 3 acute_accent micro paragraph middle_dot cedilla superscript_ 1 char_186 right_double _angle_ quote question_ mark_ inverted
broken pipe section character 168 copyright character 170 left double angle quote not character 173 registered character 175 degree plus or minus superscript two superscript three acute accent micro paragraph middle dot cedilla superscript one character 186 right double angle quote inverted question mark
Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char Char
Miscellaneous Files
The table that follows lists files that are not used by Unified CVP micro-applications; these files are included for use in customer scripts.
Table 83: Miscellaneous Media Files
Error
14) 15)
invalid_entry_error
Error message
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
542
v v
no_entry_error system_error
Error message
We are currently Error message experiencing technical difficulties with this site. Please try again later when we can service you much better. We are currently Error message experiencing technical difficulties with this site. Please try again later when we can service you much better. We are currently Error message experiencing technical difficulties with this site. Please try again later when we can service you much better We are currently Error message experiencing technical difficulties with this site. Please try again later when we can service you much better. <single beep tone> <single busy tone> Unused Unused
critical_error
critical_error_ULaw .
critical_error_ALaw
v v v v v v v v v
<busy tone 1 per second for Unused 30 seconds> Central Credit Of dash daylight <4 seconds of dial tone> Unused Unused Unused Unused Unused
<9 seconds of dialtone> Unused followed by <30 seconds of fast busy tone> dot Eastern Unused Unused
v v
15) ANSI Code Page 1252
dot eastern
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
543
v v v v v v v v v v v v
ENTER_PHONE_NUMBER Please enter the phone number. fastbusy fastbusy60 FINISHED goodbye Mountain negative of pmgr_sys pacific positive ringback
Unused
<a single fastbusy tone + Unused silence (total of 1 second)> 30 seconds of <fastbusy tone> When you have finished, press Goodbye Mountain negative of pmgr_sys Pacific positive <ring back tone for 1 second followed by 2 seconds of silence> savings Standard star Thank you the time Please try again Unused Unused Unused Unused Unused Unused Unused Unused Unused Unused
v v v v v v v
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
544
For H.323 Service, the critical_error_Alaw.wav and critical_error_Ulaw.wav media files are located in <install path>\VoiceBrowser (for example, C:\Cisco\CVP\VoiceBrowser). For SIP Service, the critical_error.wav media file is located in <install path>\OpsConsoleServer\GWDownload (for example, C:\Cisco\CVP\OpsConsoleServer\GWDownload). For non-Unified CVP H.323 or SIP Service, an error.wav media file is located in <install path>\CVP\audio (for example, C:\Cisco\VXMLServer\Tomcat\webapps\CVP\audio). Note: You can record override prompts to replace the critical media files. However, you must save them with their original hard-coded names and place them in their original locations. no_entry_error. Message played when the caller does not respond to a menu prompt. (Example content for en-us: Please make a selection.) The original prompt is then repeated. invalid_entry_error. Message played when the caller enters an incorrect response to a menu prompt. (Example content for en-us: Your entry is invalid.) The original prompt is then repeated. Note: These files are shared by all applications. If a dialogue needs to be altered for a specific Get Digits, Get Speech or Menu request in the Unified ICME script, override flags can be set in the Network VRU Script Configuration Parameters. Note: Override flags are available for the Get Digits, Get Speech, and Menu micro-applications, only. For more information, see Chapter 4, "Writing Scripts for Unified CVP (page 175). You must record the override prompts, save them with the hard coded names <prompt name>_no_entry_error.wav and <prompt_name>_invalid_entry_error.wav, and place them with other application-specific media files in the Application Media library. Note: This override will not work when there is not a specific file name used (for instance, when Unified CVP is using the TTS feature).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
545
You can perform the following tasks: Adding a Media Server (page 546) Editing a Media Server Configuration (page 547) Deleting a Media Server (page 548) Adding and Removing a Media Servers from a Device Pool (page 548) Finding a Media Server (page 549)
Procedure
To add a media server:
Step 1
Choose Device Management > Media Server. The Find, Add, Delete, Edit Media Server window opens. Note: To use an existing media server as a template for creating the new media server, select the media server by clicking the radio button preceding it and then click Use As Template.
Step 2
Fill in the appropriate configuration settings on the General tab. Optionally, select the Device Pool tab. When you finish configuring the media server, click Save to save the configuration.
See Also Media Server Configuration Settings (page 547) Adding and Removing a Media Server from a Device Pool (page 548) Viewing Device State (page ?)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
546
Field
Description
Default
Range
General IP Address Hostname The IP address of media server The name of the media server None None Valid IP address Valid DNS name, which can include letters in the alphabet, the numbers 0 through 9, and a dash Up to 1,024 characters
Description
None
Procedure
To edit a media server:
Step 1
Choose Device Management > Media Server. The Find, Add, Delete, Edit Media Server window opens.
From the list of matching records, choose the media server that you want to edit. Click Edit. Change appropriate configuration settings on the General tab. You cannot change the IP address of the media server. Optionally, select the Device Pool tab and add the media server to a device pool. When you finish configuring the media server, click Save to save the configuration.
Step 5 Step 6
See Also Media Server Configuration Settings (page 547) Adding and Removing a Media Server from a Device Pool (page 548) Viewing Device State (page ?)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
547
Procedure
To delete a media server:
Step 1
Choose Device Management > Media Server. The Find, Add, Delete, Edit Media Server window opens.
From the list of matching records, choose the media server that you want to delete. Click Delete. When prompted to confirm the delete operation, click OK to delete or click Cancel to cancel the delete operation.
Choose Device Management > Media Server. The Find, Add, Delete, Edit Media Server window opens.
From the list of matching records, choose the media server that you want to edit. Click Edit. Select the Device Pool tab. To add a device to a device pool, select the device pool from the Available pane, and then click the right arrow to move the pool to the Selected pane. To remove a device from a device pool, select the device pool from the Selected pane, and then click the left arrow to move the device pool to the Available pane.
Step 6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
548
Step 7
Click Save.
Procedure
To find a media server:
Step 1
Choose Device Management > Media Server from the Main menu. The Find, Add, Delete, Edit window lists the available media servers, sorted by name, 10 at a time.
Step 2 Step 3
If the list is long, click Next to view the next group of available Media Servers. If you know the name of a particular media server, enter the name in the Search text box and then click Go. To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 4
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with is exactly is empty
Step 6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
549
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
550
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
551
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
552
Chapter 17
Configuring the Unified CVP Basic Video and Full Video Call Flow Models
Overview of Using Video with Unified CVP
Unified CVP, coupled with video components from Cisco and Radvision Corporation, provides video self-service and queuing, integrated with Cisco Unified Contact Center Enterprise video-enabled agents. The following diagram presents a high-level overview of how video-enabled callers interact with the system. Note: This diagram is a high-level overview and is not intended to represent a particular model. See the Basic Video (page 558) and Full Video (page 568) call flow models sections for detailed information about these components.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
553
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Overview of Using Video with Unified CVP
The components used in the diagram above are described in the following sections.
Similar to the Unified CVP 4.x Comprehensive call flow model, using VoiceXML gateways
Unique call flow model that enables video capabilities from every phase of the caller interaction with the call center
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
554
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Overview of Using Video with Unified CVP
Provides audio-only self-service and queuing for calls to Video capabilities are enabled for every phase of the caller Video-enabled Contact Center Enterprise agents (the call interaction with the call center is audio-only until it reaches the agent; then it becomes a point-to-point video call) Supports Cisco Unified Video Advantage (CUVA), Cisco Supports 3G mobile video phones, Cisco Unified Video TelePresence, and 7985G video phones Advantage (CUVA), and 7985G video phones Radvision components are not required Radvision components are required
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
555
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Video Endpoints
Cisco Unified Customer Voice Portal Video Media Server Administration (Cisco Unified CVP VMS Administration): Graphical user interface from which you can manage video files and metadata on a Video Media Server. The VMS Administration interface is installed as part of the CVP Video Media Server package. The Operations Console provides single sign-on capability, which allows you to access the VMS Administration interface without having to log in an additional time. Cisco Unified Customer Voice Portal Video Desktop (Cisco Unified CVP Video Desktop): A web interface that provides a Call Center Agent access to both recorded and live video content provided by their administrator (or Call Center). During a call, the Agent can use the Video Desktop to play relevant videos to the caller. The Video Desktop provides the Agent with the tools to search for an appropriate video, preview its content, play and control the video to the caller, and record (both audio and video) the Agent and Caller interaction, and in addition provides multi-language support. The Full Video Service requires the following additional components: Multipoint Conference Unit (MCU): This is a Cisco product that is OEM'ed from Radvision. The Cisco MCU is a real-time voice and video conferencing unit that delivers multipoint conferencing and advanced media processing. The MCU consists of three components: MCU chassis, MCU card, and EMP card (sometimes referred to as an MVP card). The EMP card is a video processing card that provides mixing, transcoding, and text overlay functionalities. The Cisco MCU chassis, MCU card, and EMP card are available under the "IPVC-3545-xxx" Cisco part numbers. Note: Important! A firmware modification--available from Radvision or their designated channel partners--is required to make the Cisco MCU compatible with the Unified CVP Full Video Service. An out-of-the-box Cisco MCU will not work with the Unified CVP Full Video Service until the Radvision firmware modification is performed. Radvision Components: Includes the Interactive Video Platform (IVP), iContact software, and MSP software. These components will be discussed in this chapter as necessary to describe how they need to be configured to work with the Unified CVP Full Video Service.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
556
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Video Endpoints
Unified IP Phone. CUVA is intended for desktop-to-desktop IP video telephony environments, not as a general purpose video conferencing solution for use in conference rooms. Note: Cisco IP Communicator is not supported. See Also Refer to the Installation and Troubleshooting Guide for Cisco Unified Video Advantage Release 2.0 at http://www.cisco.com/en/US/docs/video/cuva/2_0/english/adminstration/guide/ admin2_0.html for detailed information about installing and administering Cisco Unified Video Advantage. For information about using the Cisco Unified Video Advantage software, refer to the Cisco Unified Video Advantage User Guide, which is available from the Cisco Unified Video Advantage link online: http://www.cisco.com/en/US/products/sw/voicesw/ps5662/ tsd_products_support_series_home.html.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
557
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model
all the components to enable a video callcamera, LCD screen, speaker, keypad, and a handsetincorporated into one easy-to-use unit. As a result, a video call is just a phone call. See Also Refer to the documentation for information about using the Cisco Unified IP Phone 7985G, which is available online: http://wwwin.cisco.com/voice/products/7985.shtml.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
558
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model
Call Studio Speech Servers Caution: The Operations Console can only manage speech servers installed on Windows (or AIX if supported by vendors), not on Linux. If the speech server is installed on Linux, the server cannot be managed. Media Servers DNS Server Content Services Switch Gatekeeper SIP Proxy Server (if the Call Server is configured to use SIP signaling, a SIP Proxy Server is optional) Note: The MCU and Radvision components are not required with this service. The Unified CVP SIP Service is used as the call control platform to broker the video call between the caller and Cisco Unified Communications Manager (Unified CM). In this call flow model, both the Voice Gateway and the Call Server see two call legs for the same call: One for the Switch leg. One for the VRU leg. For the Switch leg, the Gateway simply provides Gateway capabilities from TDM to VoIP and call-switching capabilities. For the VRU leg, the Gateway provides VRU voice treatment. Note: Although the following figures show two Gateways (one where the call arrives and a separate one for the VRU leg), these could be the same physical Gateway. For simplicity, the figures do not illustrate a call flow model for redundancy and failover. The following figure shows the call flow for this call flow model using SIP with a Proxy Server. Note: In the following diagrams, solid lines indicate voice paths and dashed lines indicate signaling paths.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
559
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
560
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model
Note: Refer to the Cisco Unified Videoconferencing and Cisco Unified CM documentation at http://www.cisco.com/en/US/products/hw/video/ps1870/ prod_installation_guides_list.html and http://www.cisco.com/en/US/products/sw/voicesw/ ps556/prod_installation_guides_list.html, respectively, for instructions on installing and setting up a video conference bridge. Note: Agents taking TelePresence calls must use the TelePresence phone to answer the call; the Agent cannot use the phone controls on the Agent desktop to answer the TelePresence call.
Configuration Instructions for the Unified CVP Basic Video Call Flow Model
The following table contains the configuration instructions for the Basic Video Call Flow Model.
Table 85: Configuration Checklist, Unified CVP Basic Video Call Flow Model
Where to Go/What to Do
[]
Perform the configuration steps listed for the Unified For detailed configuration instructions, see the CVP Comprehensive Call Flow Model Using SIP. Configuration Checklist, Unified CVP Comprehensive Call Flow Model, Unified ICME and Unified ICMH Using SIP (page 82) table in the "Configuration Instructions for the Unified CVP Comprehensive Call Flow Model Using SIP" section in Chapter 2. On the Unified CM server, CCMAdmin Publisher, From the Unified CM Administration page: configure the following: 1. For Step 1, do the following: 1. Enable the video phones. Log on to Unified CM. Do the following: Select Device > Phone, then click Find. Register the phone with Unified CM. A list of all phones registered with this Configure the video phone by setting the Unified CM displays. Video Capabilities option to Enabled. Note: The phone you registered is listed here, and its status displays as "Registered." (This Note: The video phone must be connected to phone must be a SCCP phone, not a SIP a CUVA station, which is installed on the CTI phone.) OS desktops. Click the phone's Device Number, then set 2. Create SIP trunks: the Video Capabilities option to Enabled. If you are using a SIP Proxy Server, set up a SIP trunk to the SIP Proxy Server. If you are not using a SIP Proxy Server, set the SIP trunk to point to Unified CVP. Add this device to the PG on Unified CM. Select User Management > Application User, then associate the device with the user. Verify the phone is listed in the Controlled Devices section or the Available Devices
[]
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
561
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model
Where to Go/What to Do
If you are using the 7985 Video Phone, you need to use a video pass-through MTP device because the video phone does not support RFC 2833 DTMF method. Allocation of an MTP resource that does not support video passthrough might result in no video media on calls that are offering media capabilities. Software MTP in Unified CM does not support video passthrough, but external IOS-based MTP does support video codec passthrough.
section (depends on which Unified CM version you are using). Note: Refer to the Unified CM documentation for instructions on setting up the phones. 2. For Step 2, select Device > Trunk > Add New. Add the following: Trunk Type: SIP trunk. Device Protocol: SIP. Destination Address: IP address or host name of the SIP Proxy Server (if using a SIP Proxy Server). If not using a SIP Proxy Server, enter the IP address or host name of the Unified CVP Call Server. DTMF Signaling Method: RFC 2833. Do not check the Media Termination Point Required checkbox.
3. Create a route pattern for outbound video calls and associate it with the SIP trunk.
3. For Step 3, select Call Routing > Route/Hunt > Route Pattern > Add New. Add the following: Route Pattern: Specify the route pattern; for example: 3XXX" for an IP phone that dials 9+3xxx and all Unified ICME scripts are set up for 3xxx dialed numbers. Gateway/Route List: Select the SIP Trunk defined in Step 2. Note the username and password for Unified CM. If you are using a SIP Proxy Server, you will need the Unified CM username and password when installing the CUP Proxy Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
562
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model
Where to Go/What to Do
[]
On the Unified ICME or Unified ICMH Server in the ICM Script Editor tool: 1. Create a routing script that handles the incoming call.
Create a routing script using the ICM Script Editor. (See the "Sample Script for Basic Video Call Flow Model (page 563)" section.) For more information about creating scripts, see Chapter 4, "Writing Scripts for Unified CVP (page 175)."
Note: See the "Sample Script for Basic Video Call Flow Model (page 563)" section for an Refer to the ICM Scripting and Media Routing Guide example of a Basic Video script. for Cisco ICM/IPCC Enterprise & Hosted Editions for more information. [] Configure video conferencing. Follow the instructions in the "How to Configure Video Conferencing for the Basic Video Call Flow Model (page 564)" section.
Configuring Video Conferencing for the Basic Video Call Flow Model
The video conferencing setup consists of configuring three pieces of equipment:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
563
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model
Cisco Unified Video Conferencing (CUVC) (page 564) IOS Voice Gateway (page 564) Cisco Unified Communications Manager (Unified CM) (page 566) The following sections describe how to configure the video conferencing setup on this equipment.
Log into the MCU interface. On the Protocols tab, click SCCP. Check Enable SCCP protocol. Click Add to add a TFTP Server. Enter the IP address of your Unified CM and click OK. Click Upload and then click Reset for the changes to take effect. (The reset process will take a few minutes.) Note: You do not need to configure the Unified CMs. Once the MCU and TFTP Server synchronize, that information updates.
See Also Refer to the CUVC and Unified CM documentation for more information.
Note: The following configuration uses the 2851 model with the IOS system image c2800nm-advipservicesk9-mz.124-15.T2.fc5.
Current configuration : 2074 bytes ! ! Last configuration change at 15:32:01 EST Wed Jan 2 2008 ! NVRAM config last updated at 16:35:49 EST Wed Jan 2 2008 ! version 12.4 service timestamps debug datetime msec service timestamps log datetime localtime no service password-encryption ! hostname GW179
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
564
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model ! boot-start-marker boot system flash c2800nm-advipservicesk9-mz.124-15.T2.fc5 boot system flash c2800nm-advipservicesk9-mz.124-15.T.bin boot-end-marker ! !card type command needed for slot 1 enable secret 5 $1$GKKe$XiQZ4Yvsam2AQW5wxGzBq. ! no aaa new-model clock timezone EST -5 clock summer-time EDT recurring no network-clock-participate slot 1 ! ! ip cef ! ! no ip domain lookup ip auth-proxy max-nodata-conns 3 ip admission max-nodata-conns 3 ! multilink bundle-name authenticated ! ! voice-card 0 dspfarm dsp services dspfarm ! voice-card 1 dspfarm dsp services dspfarm ! ! voice class codec 1 codec preference 1 g711ulaw codec preference 2 g729r8 ! ! archive log config hidekeys ! ! interface GigabitEthernet0/0 ip address 10.30.30.179 255.255.255.0 duplex auto speed auto h323-gateway voip interface h323-gateway voip bind srcaddr 10.30.30.179 ! interface GigabitEthernet0/1 ip address dhcp shutdown duplex auto speed auto ! ip forward-protocol nd ip route 0.0.0.0 0.0.0.0 10.30.30.1 ! ! no ip http server no ip http secure-server ! logging 10.30.30.101 ! ! control-plane ! !
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
565
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model sccp local GigabitEthernet0/0 sccp ccm 10.30.30.21 identifier 2 priority 2 version 5.0.1 sccp ccm 10.30.30.20 identifier 1 priority 1 version 5.0.1 sccp ccm 10.30.30.22 priority 3 sccp ! sccp ccm group 1 bind interface GigabitEthernet0/0 associate ccm 1 priority 1 associate profile 100 register gw179mtp ! dspfarm profile 100 mtp codec g711ulaw codec pass-through maximum sessions hardware 20 maximum sessions software 20 associate application SCCP ! ! line con 0 line aux 0 line vty 0 4 password cisco login ! scheduler allocate 20000 1000 ntp clock-period 17179929 ntp update-calendar ntp server 10.86.130.136 prefer ! end
Access the Unified CM Admin page. Select Media Resources > Conference Bridge. Click Add New to open the Conference Bridge Configuration page. Select Cisco Video Conference Bridge (IPVC-35xx) as the Conference Bridge Type. Enter the MAC Address of the MCU, which is located on the MCU Admin page. Click Board > Addressing. Select a Device Pool. Note: Accept the Product Specific Configuration Layout default information.
Step 6
Select a Location. Click Save. Add a Media Termination Point (MTP) by doing the following:
a.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
566
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Basic Video Call Flow Model
b. c. d. e. f. g. Step 10
Select Media Resources > Media Termination Point. Click Add New to open the Media Termination Point Configuration page. Select Cisco IOS Enhanced Software Media Termination Point. Enter the MTP name you used in the IOS configuration. In this case, it is gw179mtp. Select a Device Pool. Click Save.
Access the Unified CM Admin page. Select Media Resources > Media Resource Group. Click Add New to open the Media Resource Group Configuration page. Enter a Name for the MRG. In the Available Media Resources list, select both the CFB and MTP that you created. With both the CFB and MTP highlighted, click the arrow to move them to the Selected Media Resources list. Click Save.
g. Step 11
Access the Unified CM Admin page. Select Media Resources > Media Resource Group List. Click Add New to open the Media Resource Group List Configuration page. Enter a Name for the MRGL. In the Available Media Resource Groups list, select the MRG that you created. With the MRG highlighted, click the arrow to move it to the Selected Media Resource Groups list. Click Save.
g. Step 12
Access the Unified CM Admin page. Select System > Device Pool. Find and select the Device Pool that you want to use for the MRGL.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
567
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
d.
From the Roaming Sensitive Settings group box, select the MRGL from the Media Resource Group List. Click Save.
e.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
568
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
Video Push. While the caller and agent are in a video conversation, the agent has the option to "push" videos or live streaming video to the caller. The agent does this from the Cisco Unified CVP Video Desktop, which is accessed by clicking a video button on the CTI OS agent desktop. For the CAD desktop, the VMS page automatically loads in the integrated browser when the video call is established. The Unified CVP Full Video call flow model requires the following components: Call Server (using SIP call signaling) Unified ICME Operations Console Radvision components (IVP, iContact, MSP) CVP Video Media Server (VMS) Cisco MCU (MCU chassis, MCU card, EMP card) Note: Important! A firmware modification--available from Radvision or their designated channel partners--is required to make the Cisco MCU compatible with the Unified CVP Full Video Service. An out-of-the-box Cisco MCU will not work with the Unified CVP Full Video Service until the Radvision firmware modification is performed. 3G Mobile Video Phone, Cisco Unified Video Advantage (CUVA), 7985G Video Phone Unified CM The following optional components can be used in this call flow model: Reporting Server 3G Gateway DNS Server Content Services Switch SIP Proxy Server (a SIP Proxy Server is optional) Note: For simplicity, the figures do not illustrate a call flow model for redundancy and failover. The following figures show the call flow for this call flow model using SIP with a Proxy Server. Note: In the following diagrams, solid lines indicate voice paths and dashed lines indicate signaling paths.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
569
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
Figure 53: Unified CVP Full Video Call Flow Model with 3G Gateway-Originated Caller
Note: The Full Video call flow supports SIP as the signaling protocol.
Figure 54: Unified CVP Full Video Call Flow Model with CUVA-Originated Caller
Note: Refer to the Radvision documentation for detailed information about the Interactive Video Platform.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
570
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
If the SIP INVITE cannot be sent to the destination (CUP or IVP), then the call will fail. Unified CM video callers will typically hear an error message played back in this event. 3G callers will likely hear a fast busy since the survivability TCL script as used in the CVP Comprehensive audio-only call flow is not being used in this case (that is, the gateway is not an IOS gateway). IVP sends an iContact XML message to the Call Server notifying Unified CVP of the new call. This starts a call dialog between IVP and Unified CVP. Unified CVP sends a request to Unified ICME, which runs a script based on the DNIS of the new call. Unified ICME returns responses back to the Call Server, which translates the messages into iContact XML messages and sends them back to IVP. IVP plays videos or collects DTMF tones, depending on the commands sent from Unified CVP. Responses from the action are sent back to Unified CVP, which in turn relays the responses to the Unified ICME script. If the script writer has enabled VCR controls on a micro-app definition, the caller can elect to stop, pause, resume, forward, or rewind the video using administrator-configurable DTMF keys. Eventually, an agent becomes available. Unified ICME sends a CONNECT request to Unified CVP with instructions to transfer the caller to an agent extension. Unified CVP transfers the caller (video and audio) to a CUVA agent by sending an iCONTACT XML message to IVP, which in turn sends a SIP invite to the Proxy Server with the e164id of the agent extension. The Proxy Server selects a Unified CM based on the extension and forwards the SIP message to Unified CM. The caller is connected to the agent using video/audio provided that the agent is video-enabled. Unlike the Basic Video service, the agent can push videos to the caller. If the agent puts the caller on hold, the caller will hear Unified CM music-on-hold and can view a video.
Configuration Instructions for the Unified CVP Full Video Call Flow Model
The following table contains the configuration instructions for the Full Video Call Flow Model. Note: These instructions assume that IVP is installed and configured to accept Full Video calls.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
571
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
Table 86: Configuration Checklist, Unified CVP Full Video Call Flow Model
Where to Go/What to Do
[]
On the Unified CM server, CCMAdmin Publisher, From the Unified CM Administration page: configure the following: 1. For Step 1, do the following: 1. Enable the video phones. Log on to Unified CM. Do the following: Select Device > Phone, then click Find. Register the phone with Unified CM. A list of all phones registered with this Configure the video phone by setting the Unified CM displays. Video Capabilities option to Enabled. Note: The phone you just registered is listed here, and its status displays as "Registered." Note: The video phone must be connected to (This phone must be a SCCP phone, not a SIP a CUVA station, which is installed on the CTI phone.) OS desktops. Click the phone's Device Number, then set 2. Create SIP trunks: the Video Capabilities option to Enabled. If you are using a SIP Proxy Server, set up a SIP trunk to the SIP Proxy Server. Add this device to the PG on Unified CM. Select User Management > Application User, then associate the device with the user. Verify the phone is listed in the Controlled Devices section or the Available Devices section (depends on which Unified CM version you are using).
3. Create a route pattern for CUVA calls to send a call to IVP using the SIP trunk that points to IVP or the SIP Proxy Server. 4. Create a route pattern on the IVP SIP trunk for the sendtovru label.
Note: Refer to the Unified CM documentation for instructions on setting up the phones. 2. For Step 2, select Device > Trunk > Add New. Add the following: Trunk Type: SIP trunk. Device Protocol: SIP. Destination Address: IP address or host name of the SIP Proxy Server (if using a SIP Proxy Server). If not using a SIP Proxy Server, enter the IP address or host name of the IVP. DTMF Signaling Method: RFC 2833.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
572
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
Where to Go/What to Do
3. For Step 3, select Call Routing > Route/Hunt > Route Pattern > Add New. Add the following: Route Pattern: Specify the route pattern; for example: 3XXX" for an IP phone that dials 3xxx and all Unified ICME scripts are set up for 3xxx dialed numbers. Gateway/Route List: Select the SIP Trunk defined in Step 2.
4. For Step 4, select Call Routing > Route/Hunt > Route Pattern > Add New. Add a new route pattern to route the call to IVP via the SIP trunk. [] Configure Radvision IVP components for Unified CVP. On the Operations Console, configure the Call Server. For detailed instructions, see the "Setting Up Communication with Radvision's Interactive Video Platform (IVP) (page 579)" section. In the Operations Console: 1. Select Device Management > CVP Call Server. 2. Select the ICM and IVR checkboxes. [] On the Operations Console, configure the SIP Proxy See the "Configuring a SIP Proxy Server (page 397)" Server, if using a SIP Proxy Server for routing video section in Chapter 12, "Configuring the SIP Devices," calls. in Part 3. On the Operations Console, configure the IVP Server. In the Operations Console: 1. Select Device Management > IVP Server. 2. Follow the instructions in the "Adding IVP Server to Operations Consoloe (page 610)" section. [] On the Operations Console, enable the IVR Video Service. In the Operations Console, on the IVR Service tab, do the following: 1. In the Video Configuration section, check the Enable Full Service Video checkbox.
[]
[]
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
573
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
Where to Go/What to Do
2. If using a SIP Proxy Server for routing video calls, select the appropriate SIP Proxy Server you configured in step 2. If not, under the Local Static Routes, enter a mapping of Dialed Numbers/Static Routes. See dialed number pattern (page 63) for more information. 3. In the IVP Servers section, select the IVP Server(s) you created earlier, which associates the IVP Server(s) with this particular Call Server/IVR. 4. Optionally, select which phone key to associate with which functionality in the VCR-type Controls section; for example, select number 8 for Play, number 9 for Stop, et cetera. 5. In the Recording section, enter the default path where all videos will be stored, if call recording is enabled. The default value is /home/rv/movies/local/rv, which is a folder on the IVP Server. All videos will be stored on the IVP Server, which is a Linux machine. Optionally, in the same section, select the views that agents will record. 6. In the Special Purpose Videos section, enter the location of the Default media server/hostname, which is the Video Media Server. Note: The default language locale is en_us. See Copying Video Files to the Video Media Server (page 627) for information about additional locale folders. If you select the Enable secure connection with IVP servers checkbox, follow all the steps for enabling security on both the IVR and IVP Servers. This process involves exchanging signed certificates between the two machines. 7. Click Save and Deploy to enable changes. [] On the Operations Console, configure the VMS Server. In the Operations Console:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
574
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
Where to Go/What to Do
1. Select Device Management > CVP Video Media Server. 2. Follow the instructions in the "Configuring Video Media Server (page 624)" section. [] On Unified ICME, set up scripts to use the video ECC variables and the video micro-applications. For detailed instructions on how to set up scripts to use the video ECC variables and the video micro-applications, see the "Using the Video ECC See the "Sample Script for Full Video Call Flow Variables (page 592)" and the "Using the Unified CVP Model (page 578)" section for an example of a Full Video Micro-Applications (page 595)" sections. Video script. For more information about creating scripts, see Chapter 4, "Writing Scripts for Unified CVP (page 175)." Refer to the ICM Scripting and Media Routing Guide for Cisco ICM/IPCC Enterprise & Hosted Editions for more information. [] [] [] Configure video on the CTI OS or CAD desktops. For detailed instructions, see the "Configuring Video on the CTI OS or CAD Desktops (page 635)" section. Use the Cisco Unified Customer Voice Portal VMS For detailed instructions, see the "Using the Video Media Server Administration Interface (page 625)" section. Administration to manage media files. Customize languages and prompts for your video. For detailed instructions, see the "How to Change the Unified CVP Video Desktop Language (page 638)" section. Do the following: 1. Set the NetworkTransferEnabled ECC variable to 1 at the beginning of all Unified ICME scripts. 2. Use a Type 10 Network VRU and define the label for both the Unified CVP VRU Peripheral and the Unified CM EA Peripheral. 3. Define a route pattern in Unified CM, such as "777!," with the correct wildcard character. Note: Important! The route pattern must point to the IVP SIP Trunk configured with the RFC2833 DTMF Signaling Method. 4. Add the access number for the VRU labels to the iContact XML file. The access number entered can be the complete number or just the prefix of many numbers; for example, a prefix of "777" will match all numbers that start with "777."
[]
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
575
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
Where to Go/What to Do
Note: Adding the prefix without the correlation ID is sufficient. See the "Modifying the Access Number in the iContact XML File" section below, which displays the XML file modification. 5. Add the wildcard VRU label to the Settings section in the IVP Manager iContact application interface. For a complete number, enter it in the "Access numbers ..." text box. For a prefix, enter it in the "Prefix numbers ..." text box. The prefix or access numbers here should match the ones configured in Step 4, above. Generally, prefix numbers are preferred over access numbers because they can match multiple numbers. Note: For transfers with queuing involving the Unified CM peripheral, only one VRU label can be configured per peripheral. Therefore, warm transfers with queuing for audio only and Basic Video calls need to use one Unified CM peripheral with one VRU label. The same call for Full Video requires a separate peripheral (eapim) with a different VRU label. The labels can then match their respective Route Pattern/SIP Trunks, one for the IVP SIP Service and another for the CVP SIP Service. See Step 2 in the "How to Configure Radvision IVP Components for Unified CVP (page 579)" section for more details.
Modifying the Access Number in the iContact XML File The following screen shot displays the iContact XML file modification you must perform when configuring warm transfer with queuing (Step 4, above):
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
576
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
The following screen shot displays the IVP's Application Properties window, where you add the access number for the VRU labels:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
577
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Unified CVP Full Video Call Flow Model
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
578
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
579
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Controller (that is, IVP Server) is a component of the IVP platform that communicates and controls the various components of the IVP. The following instructions list the necessary configuration changes to IVP components after IVP is installed. When the changes are completed, restart the IVP using the IVP Manager.
Step 1
Use SSH to access the IVP machine. Edit the iContactConfiguration.xml file. Change only the configuration settings that are shown in red text in the example below.
Note: Comments are contained within the <!-- and --> characters; they are shown in blue text. Italicized text is used only as an example.
Caution: The terminate-on-disconnection element must be set to false as shown in the following example. This setting applies to the agent, and not to the customer.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
580
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Note: The bg-media element must be set to rtsp://<CVP VMS Server>/en-us/app/myholdmovie.3gp. iCONTACT views are defined by the view configuration file specified in the XML <views-set-file> element in the iCONTACT configuration file. Dynamic layout of views using the Radvision MCU administration interface is not supported by iCONTACT or Unified CVP.
Step 2
Load the iContact application by performing the following steps in the IVP Manager (access the IVP Manager from http://<ivp_ip_address>):
a. b. c.
Select Network > IVP IVP-1. Click the Applications tab, then click New. In the New Application dialog, select Load from File, then select /applications/iCONTACT/iCONTACT.app and click Continue. In the Application Properties dialog box (page 578), enter Prefix numbers, Access numbers, or a combination of both.
d.
A Prefix number is comparable to a wildcard. Prefix numbers are numeric patterns used for matching multiple Dial Numbers. For example, if you entered 18882 in the Prefix number field, the IVP would pick up all calls starting with 18882. An Access number is a complete Dial Number, such as 18001233456. Note: The Prefix numbers and/or Access numbers entered in the Application Properties dialog box must match the access number element in the iContact configuration file (page 577). In this example, the iContactConfiguration.xml file would have to contain the Prefix number and Access number in the following format: <access-number>18882</access-number> <access-number>18001233456</access-number>. To minimize errors, considering using only Prefix numbers in the Application Properties dialog box.
e. f.
Click Upload to save the changes. In the applications list view, if iCONTACT is not active, highlight it and click Activate.
Use SSH to access the IVP machine. Configure the ivp.xml file in the /home/rv/ivp/conf directory.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
581
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Configure the MCU block by entering: set mcu enable="true" host=<IP of MCU> Configure MSP block by entering: msp enable = "true" host=<IP of IVP> (if MSP is installed on same machine, use default value) Save the ivp.xml file.
c. d. e.
Launch the IVP Manager (http://<IP address of IVP machine>). Login with admin (no password by default). Restart the IVP service by selecting the IVP tab and clicking Network > IVP IVP-1. On the Monitor tab, click Maintenance and select Restart.
Refer to the Radvision documentation set for detailed IVP configuration instructions.
Step 4
Use SSH to log in to the IVP machine as user rv. Configure the msp.xml file in the /home/rv/msp/conf directory.
Add transportDestination="enabled" attribute to the 'rtsp' xml element under the 'signaling' xml element; for example:
<signaling bindAddress="0.0.0.0"> ... <rtsp serverPort="554" connectionTimeout="20" transportDestination="enabled"/> </signaling>
Note: This attribute instructs the MSP to add its IP address to the destination parameter in the Transport Header of the RTSP SETUP message. This change causes Darwin Streaming Server to send the RTP packets directly to the MSP instead of transported through the CSS.
c. d.
Restart the MSP after the change. From the command line, run msp stop, then run msp start.
Note: If using a CSS between the MSP and a third-party streaming server (including live streaming servers), the streaming server must support alternate destination for streaming video to work correctly. The version of Darwin Streaming Server that ships with CVP is configured to support alternate destination.
Step 5
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
582
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Note: It is important to remove any shared media, if it exists. If there are no demo applications, then it is likely that none will be there. To remove all shared media, do the following:
a. b.
Click the IVP link in the left frame, then click the Shared Media tab. Deactivate all media that displays in the "active" state, making sure it now displays in the "not active" state.
Step 6
Optionally, follow the instructions in the "How to Set Up TLS Communication (page 584)" section. Revisit the Configuration Checklist (page 571) to proceed with the configuration instructions for the Full Video Call Flow Model.
Step 7
How to Configure Playing Multiple Audio Files in Unified CVP Video Micro-Applications
The Video micro-applications provide the ability to play multiple audio files in sequence along with a video. Note: See the "Using the Unified CVP Video Micro-Applications (page 595)" section for detailed information about these applications. Notes about audio-only files: The audio files to be played in sequence can be in .3gp or .wav format. If .wav files are used, you must place the files on the IVP Server instead of on the VMS server because .wav files are not supported by the rtsp:// protocol. When using .wav files, access them via the file:// protocol instead. For the least amount of delay between playing of multiple audio files, use the files in .wav format and place them locally on the IVP Server. If .3gp files are used, access the files via the rtsp:// protocol just like .3gp video files. The delay between the playing of each file when there are more than one is greater than if the same files are in .wav format. Use .wav files for minimal delay between playing of files. The following instructions document the setup required for the Video Play Data (VPD) micro-application. The VPD micro-application uses the same en-us .wav files as the Play Data (PD) micro-application. These .wav files must be copied over to the IVP Server.
Step 1
Locate the utteranceFiles.tar file in the <install_dir>\Cisco\CVP\OPSConsoleServer\IVP directory. Copy this file to the IVP machine (using WinScp or other software) to the /home/rv/cvp folder. If the cvp folder does not exist, create one in /home/rv.
Step 2
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
583
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Step 3
Use a SSH client (for example, Putty) to login to the IVP machine as root, then change directory to the /home/rv/cvp folder. Un-tar the utteranceFiles.tar file in that folder with the linux command: tar -xvf utteranceFiles.tar.
Step 4
In the ICM script, when using a VPD node, the media server should be set to "file://home/rv/cvp." If you do not set this, the audio file will not be found. Note: Since the media server is set to "file://home/rv/cvp" for VPD, the video that is to be played with the audio must also reside in the same location and must be in .3gp format. In general, any videos that are to be played with VPD must reside on the same location as the .wav files.
If the IVP Server is running, stop it using the IVP Manager. Change the iCONTACTConfiguration.xml property file under /home/rv/ivp/applications/iCONTACT/conf to set connection type from TCP to TLS in the <connection-type> XML element. It should look like this after editing: <connection-type>TLS</connection-type>. Save the file. Make sure that the following lines exist in the security.properties file under /home/rv/ivp/applications/iCONTACT/WEB-INF/classes directory:
c.
##key store type:JKS javax.net.ssl.keyStoreType=jceks and in the same file, make sure that the folowing property is set to true client.authentication=true
d. e.
Change to /home/rv/ivp/applications/iCONTACT/utils directory. Create a security key using Sun's keytool by entering the following: keytool -genkey
-alias icontact -keyalg RSA -keysize 2048 -validity 3600 -keypass
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
584
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
iContact -keystore ./server.jks -storetype jceks -storepass iContact -dname "CN=<IVP Server IP Address>, OU=PS, O=Radvision, L=Beijing, ST=Beijing, C=CN".
For example, for the IVP Server on 10.86.111.222, enter: keytool -genkey -alias
icontact -keyalg RSA -keysize 2048 -validity 3600 -keypass iContact -keystore ./server.jks -storetype jceks -storepass iContact -dname "CN=10.86.111.222, OU=PS, O=Radvision, L=Beijing, ST=Beijing, C=CN".
Note: It is important to enter the dname fields exactly as specified in the example. Omitting or changing them might prevent the SSL handshake from succeeding.
f.
Import a workaround certificate to the keystore that was just created in the previous step. This is a workaround for a possible Java SSL handshake bug on a Linux machine. (The Unified CVP installation process creates a workaround certificate file, workaround.cer, when the Call Server is installed.)
First, obtain the workaround.cer file from the <CVP_HOME>\conf\security directory on the Call Server and copy it to the /home/rv/ivp/applications/iCONTACT/utils directory. Then, import the certificate by entering: keytool -import -alias workaround-cert -file
./workaround.cer -keystore ./server.jks -storetype jceks -storepass iContact.
Enter yes when prompted to "Trust this certificate?" and then press Enter.
g.
Use the following command to verify the keys are in the new keystore: keytool -list -keystore ./server.jks -storetype jceks -storepass iContact .
h.
Run the keytool command to export a key certificate, which needs to be imported into Unified CVP Server's key store: keytool -export -alias icontact -file ./
ivp-<IVP Server IP Address>.cer -keystore ./server.jks -storetype jceks -storepass iContact.
For example: keytool -export -alias icontact -file ./ivp-10.86.111.222.cer -keystore ./server.jks -storetype jceks -storepass iContact. Check the ivp-<IVP Server IP Address>.cer file created in the current directory.
i.
Copy the ivp-<IVP Server IP Address>.cer file to any Unified CVP Server, which needs to comminucate with this IVP Server, and save the file in the <CVP_HOME>\conf\security directory.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
585
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Step 2
This file contains the security.keystorePW property. The property value is the password generated by the Unified CVP Installer, which looks like an encrypted text; for example:
Security.keystorePW = A6.,G8o@!82c{hjSE7{D1*r~,v+{A)0 b. c.
Change directory to <CVP_HOME>\conf\security. Use the keytool to import the certificate created in the step above into Unified CVP's keystore: <CVP_HOME>\jre\bin\keytool -import -alias ivp-<IVP Server
IP Address> -file .\ivp-<IVP Server IP Address>.cer -keystore .\. keystore -storetype jceks.
When the keytool prompts for the store password, cut and paste the value part of the property found in the step above and press Enter to finish the command. When prompted with "Trust this certificate?," enter yes.
d.
For example, for the Unified CVP Server on 10.86.111.222 and its key store password retrieved in the step above is: A6.,G8o@!82c{hjSE7{D1*r~,v+{A)0
C:\Cisco\CVP\jre\bin\keytool -genkey -alias ivr_key -keyalg RSA -keysize 2048 -validity 3600 -keypass "A6.,G8o@!82c{hjSE7{D1*r~,v+{A)0" -keystore .\.keystore -storetype jceks -storepass "A6.,G8o@!82c{hjSE7{D1*r~,v+{A)0" -dname "CN=10.86.111.222, OU=CCBU, O=cisco.com, L=Boxborough, ST=MA, C=US".
Note: The store password must be typed inside the double quotes (" "). Do not omit any dname field (doing so might prevent the key from working).
e.
Use the keytool command to verify the certificates and keys in the key store:
<CVP_HOME>\jre\bin\keytool -list -keystore .\.keystore -storetype jceks.
Note: Use the same password as above. In the listing produced by the keytool -list command, verify that 'ivr_key' (or whatever key name you used in Step d) exists.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
586
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
f.
Run the keytool command to export the key ivr_key just created in the Unified CVP keystore to a certificate file, which needs be imported into IVP's keystore:
<CVP_HOME>\jre\bin\keytool -export -alias ivr_key -file .\ivr-<CVP server IP address>.cer -keystore .\.keystore -storetype jceks.
Note: Use the same password as above, and make sure the certificate file is created.
g.
Copy the certificate file to the IVP Server and save it in the /home/rv/ivp/applications/iCONTACT/utils directory. Using the Operations Console, for the Call Server on the IVR tab, check Enable secure connection with IVP servers, then click Save and Deploy.
h.
Step 3
Change directory to /home/rv/ivp/applications/iCONTACT/utils. Run the keytool to import the Unified CVP Server's certificate into the IVP Server's keystore: keytool -import -alias ivr-<CVP Server IP Address> -file
./ivr-<CVP Server IP Address>.cer -keystore ./server.jks -storetype jceks -storepass iContact.
For example: keytool -import -alias ivr-192.168.111.222 -file ./ ivr-192.168.111.222.cer -keystore ./server.jks -storetype jceks -storepass iContact.
c.
Verify that the certificate is imported in the key store as trusted certificate entry: keytool -list -keystore ./server.jks -storetype jceks -storepass iContact .
Note: If your deployment model has multiple IVP Servers and/or multiple Unified CVP Servers, you need to perform the same tasks for each IVP Server and Unified CVP Server. In general, in order to use secure socket, a Unified CVP Server's keystore should have a security key entry for itself and a trusted certificate entry for each IVP Server it communicates with, and an IVP Server's keystore must have a security key for itself and a trusted certificate entry for each Unified CVP Server it communicates with. It might also need the workaround trust certificate entry, if it only connects to one Unified CVP Server. You only need to create one security key for the server itself, and the exported certificate file can be reused by all the servers it connects to. For example, if you have two IVP Servers (IVP1 and IVP2) and two Unified CVP Servers (CVP1 and CVP2), each Unified CVP Server connects to both IVP Servers and each IVP Server connects to both Unified CVP Servers. Listed below are keys and ceritificates needed in the keystore of each server: CVP1: ivr_key (keyEntry) and IVP1 (trustCertEntry), IVP2 (trustCertEntry), plus other key and trust certificate entries created by CVP Installer. CVP2: ivr_key (keyEntry) and IVP1 (trustCertEntry), IVP2 (trustCertEntry), plus other key and trust certificate entries created by CVP Installer.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
587
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
IVP1: icontact (keyEntry) and CVP1 (trustCertEntry), CVP2 (trustCertEntry), workaround-cert (tustCertEntry) IVP2: icontact (keyEntry) and CVP1 (trustCertEntry), CVP2 (trustCertEntry), workaround-cert (trustCertEntry)
Step 4
Stop and restart each IVP Server and Unified CVP Server.
Repeat steps 1a through 1h in the "How to Set Up TLS Communication (page 584)" section for IVP2, if this task has not been performed. Copy the ivp2 certificate from IVP2 to CVP1's <CVP_HOME>\conf\security; for example, copy ivp-10.86.111.222.cer.
b.
Step 2
Import the IVP2's certificate into CVP1's keystore; for example, <CVP_HOME\jre\bin\keytool -import -alias ivp-10.86.111.222 -file .\ivp-10.86.111.222.cer -keystore .\.keystore -storetype jceks.
Enter the keystore password found in the <CVP_HOME>\CVP\conf\security.properties file. Enter yes when prompted, "Trust this certificate?"
Step 3 Step 4 Step 5
Import the certificate to c:\Cisco\CVP\jre\bin\keytool -list -keystore .\.keystore -storetype jceks. On the IVP2 Server, import CVP1's key into IVP2's keystore. Copy CVP1's ivr certificate from CVP1 to IVP2 (copy under /home/rv/ivp/applications/iCONTACT/utils). Import CVP1's certificate into IVP2's keystore: keytool -import -alias
ivr-10.86.111.222 -file ./ivr-10.86.111.222.cer -keystore ./server.jks -storetype jceks -storepass iContact.
Step 6
Step 7
Import the key: keytool -list -keystore ./server.jks -storetype jceks -storepass iContact.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
588
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Step 8
In the Operations Console, add an IVP device entry for IVP2, and then add that IVP2 to the list of IVP Servers in the IVR tab of CVP1. Click Save and deploy.
Note: Confirm the connection is established by opening the diagnostic servlet. When the IVR Service is active, click Dump IVR Subsystem in the middle frame. In the right frame, the connectionID displays for the iContact client; for example, IContactClient{[10.86.129.238]:9981}, connectionId:iCONTACT-Connection-1. If the connectionID is blank, then the connection is not established. (The Unified CVP log file provides more details.)
How to Configure Load-balancing and Failover Mechanism for Full Video Service
This section provides detailed instructions on how to configure the load-balancing and failover mechanism between the Call Server and IVP for the Full Video Service. It also describes how to use a CSS to load-balance VMS boxes. Failover and load-balancing of new calls from IVP to Unified CVP can be accomplished using these two mechanisms: Configure a Call Server to communicate with multiple IVPs. Configure each IVP to perform a round-robin distribution of new calls to different Call Servers. Note: IVP might take up to 45 seconds to reject incoming SIP calls in the event the MCU fails on the network. Calls might encounter RONA until IVP sends a rejection response. After IVP sends rejection responses, the CUP Proxy Server might roll the call to the next destination IVP in the static route configuration.
Step 1
To configure a Call Server to communicate with multiple IVPs, associate the IVP Servers with the Call Server by accessing the IVR tab in the Operations Console. On startup, the Call Server will establish a TCP connection with each of the IVPs. In addition, configure each IVP to perform a round-robin distribution of new calls to the Call Servers that are connected to it; for example, if CallServer1 and CallServer2 are both connected to IVP1, then IVP1 will send a new call to CallServer1 and the next new call will go to CallServer2. Should CallServer1 becomes unavailable, then the new calls will go to CallServer2 only. To configure iContact on each IVP for round-robin distribution of new calls, modify the following line in /home/rv/ivp/applications/iCONTACT/conf/iCONTACTConfiguration.xml on the IVP Server and then restart IVP using the IVP Manager by changing:
<notification-type>First-served</notification-type>
Step 2
to:
<notification-type>Round-robin</notification-type>
The following steps describe how to use a CSS to load-balance VMS boxes.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
589
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Step 3
Note: Using a scripted keepalive verifying both port 8443 and 554 is another alternative.
Step 4
Note: Since the RTP protocol must not be load-balanced, use a L4/TCP rule.
Step 5
When using a one-arm setup, configure a destination service group to insure return RTSP traffic passes through CSS.
group vms add destination service vms_machine1 add destination service vms_machine2 vip address 192.168.1.10 active
Note: Other, more advanced load-balancing/failover methods can be implemented, but they are outside the scope of this document.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
590
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Setting Up Communication with Radvision's Interactive Video Platform (IVP)
Language
Dutch English French German Italian Portuguese Russian Spanish Swedish Chinese traditional Chinese simplified Japanese Korean MCU TradChin File MCU Simkai File MCU Japanese File MCU Korean File Note: Arabic is not supported in this release. Refer to the Radvision documentation for full details on how to perform an MCU upgrade. The following instructions are specifically focused on adding extended fonts support. Note: In order to upgrade the MCU, make sure you launch the upgrade program from a machine on the same subnet as the MCU. To upgrade, follow these instructions:
Step 1 Step 2
Launch the MCU Upgrade Utility. Enter the IP address of the target MCU and specify the user credentials (default user is "admin" with no password). Click Customize.... Enable the MCU Config File checkbox in the Customize dialog (leave the components that are already pre-selected as they are). Enable the extended font that you want. (Only one extended font should be selected.) Click OK. Click Upgrade.
Step 3 Step 4
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
591
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video ECC Variables
Step 8 Step 9
Click Yes on the confirmation dialog. Click Exit when upgrade finishes. After upgrading the MCU and all the other components, reboot the IVP computer. After rebooting, open the IVP Manager GUI and log in. On the MCU tab, if "MCU not registered with corresponding IVP B2BUA" displays, click Fix to set the IVP B2BUA as the SIP server for the MCU. To verify that the MCU has the correct extended font, do the following:
a. b. c. d.
Launch the MCU GUI. Click the Settings tab. Click Themes on the left-hand side of the Settings tab. Verify that the Enable extended font checkbox is checked and that the correct font displays in the Extended font readonly textbox.
Name
Length
Definition
user.cvpmovies_bg_media
Maximum Length: 255 The bg-media is played when the agent puts the caller on hold or when there is no video stream from Note: This ECC variable is only used with Min Length: 9 the agent's video camera. The caller will see the the Full Video call flow model. bg-media during that time. Required: false This ECC variable's value contains the name of the video plus the relative directory name where it is located; for example, sys\movie.3gp. If the video name is shortened to 1 character ( for example, app\x.3gp), then the minimum length would be 9 characters. An alternative way to specify the bg-media-url is to statically configure the background video in the iCONTACT XML configuration file. See the "How to Configure Radvision IVP Components for Unified CVP (page 579)" section; specifically, the <bg-media> element under the <type>agent</type> element. If the bg-media-url is specified using the
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
592
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video ECC Variables
Name
Length
Definition
user.cvpmovies_bg_media ECC variable, it will override the one configured in the iCONTACT XML configuration file. If neither is defined, the caller will just see a black screen when the agent puts the caller on hold. user.microapp.cvpmovies_params Maximum Length: 256 Basic Video: The ICM Service populates this ECC variable with "B" for basic when it receives Min Length: 1 (if only a basic video call from the SIP Service. using Basic Video call flow model) or 50 Full Video: The IVR Service populates this ECC variable with the parameters that will be passed Required: true if using to the agent desktop. Basic Video or Full Video call flow models This ECC variable is automatically populated and the script writer must not create a script node to set this ECC variable in the Unified ICME script. Maximum Length: 1 Controls the recording session from a Unified ICME script. Note: See "Recording Sessions (page 594)" for more information about using this ECC variable to record sessions using a Unified ICME script. Allows the Unified ICME script writer to specify the language of the text overlay message. The valid language choices are: CHS - Chinese simplified (x-mswin-936) CHT - Chinese traditional (x-windows-950) JPN - Japanese (windows-31j) KOR - Korean (x-windows-949) RUS - Russian (windows-1251) LAT (default) - English, Danish, Spanish, French, German, Italian, Dutch, Portuguese, Swedish (windows-1252) ARB - Arabic (windows-1256) Note: Only use the three-character language option (for example, CHS), not the full language option (for
user.microapp.recording
Note: This ECC variable is only used with Required: false the Full Video call flow model.
user.microapp.charset
Maximum Length: 3
Note: This ECC variable is only used with Required: false the Full Video call flow model.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
593
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Recording Sessions
Name
Length
Definition
example, CHS - Chinese simplified (x-mswin-936). LAT is the default value, if this ECC variable is not set. ARB is not currently supported by IVP.
Recording Sessions
Recording a session between the agent and the caller (both video and audio) can be initiated either using Unified ICME scripting or by agent initiation using the Cisco Unified Customer Voice Portal Video Desktop. Note: Recording is only available with the Full Video call flow model. Refer to the Cisco Unified Customer Voice Portal Video Desktop online help for detailed information about recording sessions by agent initiation.
594
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
Viewname Name of recorded view (customer, agent, or all). SeqNum Sequential number. A number that is incremented for each recording file that is created during the session. ICM or Agent Initiated - Depends on how the recording was initiated (icm or agent). For example, a recording of all the call legs that were initiated by a script could be named: 0019BBE5F94A-33128689677622847128_all_1_icm.3gp A recording of the customer view that was initiated by the agent could be named: 0019BBE5F94A-33128689677622847128_customer_1_agent.3gp Note: It is the user's responsibility to manage the recorded files (archiving, etc.) to ensure that there is always enough disk space for recordings.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
595
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
Configure VRU Script Name field parameters: Micro-application type. For Video Play Media, valid options are: VPM or vpm. Movie File Name. Name of the video to be played. Note: This is a required field. An error is generated if no video is specified. The valid options are: A 3gp file name. Note: Movie file names are case-sensitive. (number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. Media Library Type. Flag indicating the location of the media files to be played. The valid options are: A - (default) Application S - System Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Step 2
Configure the Configuration Param field parameters: Barge-in Allowed. Specifies whether barge-in (digit entry to interrupt media playback) is allowed. The valid options are: Y - (default) barge-in allowed. N - barge-in not allowed. Note: If barge-in is not allowed, Unified CVP continues prompt play when a caller starts entering digits and the entered digits are discarded. If barge-in is allowed, Unified CVP discontinues prompt play when the caller starts entering digits. For VPM, the barge-in flag is ignored if the "Enable VCR-type Control" flag is true. No error will be generated when both flags are set to true, but any barge-in will be ignored.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
596
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
Text Overlay. Specifies the dynamic text overlay that is shown as a single line of text at the bottom of the video. (Default is that no text overlay is displayed.) Note: See the "Text Overlay Option Guidelines (page 599)" section for more information. The valid options are: Null - (default) No text overlay is displayed. (number 1-10) - Unified CVP gets the text for the text overlay in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. Show/Display options. Specifies whether the video will be shown as audio-only, video-only, or both audio and video. (The default is audio and video.) The valid options are: B - Video and Audio (default). V - Video only. Note: The "V" (Video only) option can be used to suppress the audio from the video if audio-only files are played along with the video and you do not want both audio streams to be heard at the same time. A Audio only. Audio Only File Name(s). Name of one or more audio files to be played simultaneously with the video. (The default is that no audio file is played.) Note: If no file extension is specified for an audio-only file, the default file extension is ".wav" (not ".3gp" as it is for videos). Audio-only file names are not allowed if the "Enable VCR-type control" parameter is set to true because they are not compatible. An error will be generated in this case. In the case where a video is specified along with audio-only files, the IVR Service will play the video and simultaneously start the first audio-only video. It will then play any remaining audio-only files in sequential succession. It will not return to Unified ICME until both the video and all audio-only videos have finished or barge-in occurs. To specify a single audio file to be played, specify the file name in the configuration parameter. To specify multiple audio files, a call variable is required. In the call variable, the names of the audio files to play must be comma separated. When there are multiple audio files to be played: If the first audio file is not found, no audio files will be played.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
597
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
If the first audio file is found but the second or subsequent audio file is not found, the audio files before the missing file are played. In both of of the above cases, a media error is returned. The valid options are: A 3gp or .wav audio file name. Note: Media file names are case-sensitive. This option only allows a singe audio file to be played. <Null> - (default) No audio-only file name. Note: <Null> indicates empty or no entry. Do not enter the literal "Null." (number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. If there is more than one audio file, the file names must be separated by a comma. Note: As stated under the Movie File Name parameter above, the video is a required parameter. An error will be generated if there are audio files specified, but no video is specified. Enable VCR-type control. Enables caller to use VCR-type controls to control the video using DTMF. If this option is enabled, the caller can pause, resume, stop, forward, and rewind a pre-recorded video. For live streaming video, the only VCR-type control available is stop. You cannot enable this option when there is one or more audio-only file name(s) also specified. The valid options are: Y Enable VCR-type control (see restrictions below). N (default) Disable VCR-type control. Note: An error is generated if this is set to Y and there are one or more "Audio Only File Names." If this parameter is set to Y, the "Barge-in Allowed" parameter is ignored. Live streaming video. Indicates whether the video is live streaming video or pre-recorded video. Refer to the Enable VCR-type control (page 607) parameter for restrictions. The valid options are: Y Live streaming video. N (default) Pre-recorded video. Note: An error is generated if this is set to Y and the "Looping" flag is also set to Y. Looping. Indicates whether the video should be looped.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
598
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
The valid options are: Y Loop the media. N (default) Do not loop the media. Note: An error is generated if this is set to Y and the "Live Streaming video" flag is also set to Y.
Configure VRU Script Name field parameters: Micro-application type. For Video Play Data, valid options are: VPD or vpd. Movie File Name. Name of the video to be played.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
599
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
Note: This is a required field. An error is generated if no video is specified. The valid options are: A 3gp file name. Note: Movie file names are case-sensitive. (number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. Media Library Type. Flag indicating the location of the media files to be played. The valid options are: A - (default) Application S - System Data Playback Type. The kind of the data to be returned ("played") to the caller. Valid options are: Number Char (character) Date Etime (elapsed time) TOD (Time of Day) 24TOD (24-hour Time of Day) DOW (Day of Week) Currency Note: For more information about each of these playback types, including input format and output examples, see the "Play Back Types for Voice Data (page 203)" section in Chapter 4, "Writing Scripts for Unified CVP," in Part 1. Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Step 2
Configure the Configuration Param field parameters: Location of the data to be played. The valid options are:
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
600
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
<null> - (default) If you leave this option empty, uses the ECC variable user.microapp.play_data. A number representing a Call Peripheral Variable number (for example, a 1 represents Call.PeripheralVariable1). Barge-in Allowed. Specifies whether barge-in (digit entry to interrupt media playback) is allowed. The valid options are: Y - (default) barge-in allowed. N - barge-in not allowed. Note: If barge-in is not allowed, Unified CVP continues prompt play when a caller starts entering digits and the entered digits are discarded. If barge-in is allowed, Unified CVP discontinues prompt play when the caller starts entering digits. Time Format. Valid only for the time Data Playback types (Etime, TOD, 24TOD). The available formats are: <null> - (default) Leave this option empty for non-time formats. HHMM - Default for time formats. HHMMSS. HHMMAP- Includes am or pm; valid only for TOD. Show/Display options. Specifies whether the video will be shown as audio-only, video-only, or both audio and video. (The default is video only.) The valid options are: B - Video and audio. V - Video only (default). Note: The "V" (Video only) option can be used to suppress the audio from the video if audio-only files are played along with the video and you do not want both audio streams to be heard at the same time. A Audio only.
When there are multiple audio files to be played: If the first audio file is not found, no audio files will be played.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
601
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
If the first audio file is found but the second or subsequent audio file is not found, the audio files before the missing file are played. In both of the above cases, a media error is returned.
Configure VRU Script Name field parameters: Micro-application type. For Video Play Media, valid options are: VGD or vgd. Movie File Name. Name of the video to be played. Note: This is a required field. An error is generated if no video is specified. The valid options are: A 3gp file name. Note: Movie file names are case-sensitive. (number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. Media Library Type. Flag indicating the location of the media files to be played. The valid options are: A - (default) Application S - System Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Step 2
Configure the Configuration Param field parameters: Maximum Field Length. Maximum number of digits expected from the caller. The valid options are: 1-32 (the default is 1). Any digits entered after the maximum field length will be discarded. Inter-digit Timeout. The number of seconds the caller is allowed between entering digits. If exceeded, the system times-out.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
602
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
The valid options are: 1-99 (the default is 3). No Entry Timeout. The number of seconds a caller is allowed to begin entering digits. If exceeded, the system times-out. The valid options are: 2-99 (the default is 10). Note: Set this timeout value to a value that accommodates both the time it takes to play the audio prompt as well as a reasonable time for user entry. Number of No Entry Tries. Unified CVP repeats the "Get Digits" cycle when the caller does not enter any data after the prompt has been played. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Number of Invalid Tries. Unified CVP repeats the "Get digits" cycle when the caller enters invalid data. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Timeout Message Override. The valid options are: Y - Override the system default with a pre-recorded Application Media Library file. N - (default) Do not override the system default. Note: The system default is specified in the No-entry video option on the Operations Console's IVR tab. Invalid Entry Message Override. The valid options are: Y - Override the system default with a pre-recorded Application Media Library file. N - (default) Do not override the system default. Note: The system default is specified in the Invalid-entry video option on the Operations Console's IVR tab.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
603
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
DTMF Termination Key. A single character that, when entered by the caller, indicates digit entry is complete. The valid options are: 0-9 * (asterisk) # (pound sign) - (default) N (No termination key). DTMF Abort Key. A single character that, when entered by the caller, indicates that the DTMF digit collection should be aborted. In this case, no digits will be returned. (The default is that there is no abort key.) The valid options are: 0-9 * (asterisk) # (pound sign) N - (default) (No abort key) Note: The abort key cannot be the same as the DTMF Termination key or the DTMF Backspace key (if specified). When the caller enters the DTMF abort key, any previously entered digits are discarded. Unified CVP will treat the receipt of the abort key the same as if the caller did not enter any keys at all. In addition, Unified CVP will not re-prompt the caller again (that is, the "Number of No Entry Tries" is ignored) and will immediately return an error code of 'no entry' to Unified ICME. DTMF Backspace Key. A single character that is used as a backspace (delete last received digit). (The default is that there is no backspace key.) The valid options are: 0-9 * (asterisk) # (pound sign) N - (default) (No backspace key)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
604
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
Note: The backspace key cannot be the same as the DTMF Termination key or the DTMF Abort key (if specified). Text Overlay. Specifies the dynamic text overlay that is shown as a single line of text at the bottom of the video. (Default is that no text overlay is displayed.) Note: See the "Text Overlay Option Guidelines (page 599)" section for more information. The valid options are: Null - (default) No text overlay is displayed. (number 1-10) - Unified CVP gets the text for the text overlay in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. For the VGD and VM micro-applications, if the text overlay is specified, then the user-entered digits are shown after the text overlay. If the script writer wants to suppress the display of the user-entered digits, then the text overlay should not be specified. There is no option of displaying the text overlay, but not displaying the user-entered digits. Show/Display options. Specifies whether the video will be shown as audio-only, video-only, or both audio and video. (The default is audio and video.) The valid options are: B - Video and Audio (default). V - Video only. Note: The "V" (Video only) option can be used to suppress the audio from the video if audio-only files are played along with the video and you do not want both audio streams to be heard at the same time. A Audio only. Audio Only File Name(s). Name of one or more audio files to be played simultaneously with the video. (The default is that no audio file is played.) In the case where a video is specified along with audio-only files, the IVR Service will play the video and simultaneously start the first audio-only video. It will then play any remaining audio-only files in sequential succession. It will not return to Unified ICME until both the video and all audio-only videos have finished or barge-in occurs. To specify a single audio file to be played, specify the file name in the configuration parameter. To specify multiple audio files, a call variable is required. In the call variable, the names of the audio files to play must be comma separated. When there are multiple audio files to be played: If the first audio file is not found, no audio files will be played.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
605
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
If the first audio file is found but the second or subsequent audio file is not found, the audio files before the missing file are played. If a file is discovered missing before the digit collection is completed, any collected digits are discarded and a media error is returned. If digit collection is completed before a a file is discovered missing, the digit collection is treated as successful. The valid options are: A 3gp or .wav audio file name. Note: Media file names are case-sensitive. This option only allows a singe audio file to be played. Null - (default) No audio-only file name. (number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. If there is more than one audio file, the file names must be separated by a comma. Looping. Indicates whether the video should be looped. The valid options are: Y - Loop the media. N (default) - Do not loop the media. You might want to set looping to Y, if the expected time for digit collection might take longer than the video. This can happen if the timeout values for "No-Entry Timeout" and/or "Inter-digit Timeout" are long. If the looping parameter is set to N and the video ends before the digit collection completes, the digit collection will be aborted. Suppress digit display. Suppress display of user entered digits on screen. The valid options are: Y - Suppress the display of user-entered digits. N (default) - Do not suppress the display of user entered digits.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
606
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
Configure VRU Script Name field parameters: Micro-application type. For Video Play Media, valid options are: VM or vm. Movie File Name. Name of the video to be played. Note: This is a required field. An error is generated if no video is specified. The valid options are: A 3gp file name. Note: Movie file names are case-sensitive. (number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. <null> - No video will be played. Media Library Type. Flag indicating the location of the media files to be played. The valid options are: A - (default) Application S - System Uniqueness value. Optional. A string identifying a VRU Script Name as unique.
Step 2
Configure the Configuration Param field parameters: List of menu choices. The valid options are: 0-9 * (asterisk) # (pound sign) (default) Formats allowed include: Individual options delimited by a / (forward slash). Ranges delimited by a - (hyphen) with no space.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
607
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
No Entry Timeout. The number of seconds a caller is allowed to begin entering digits. If exceeded, the system times-out. The valid options are: 2-99 (the default is 10) Note: Set this timeout value to a value that accommodates both the time it takes to play the audio prompt as well as a reasonable time for user entry. Number of No Entry Tries. Unified CVP repeats the "Get Digits" cycle when the caller does not enter any data after the prompt has been played. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Number of Invalid Tries. Unified CVP repeats the "Get digits" cycle when the caller enters invalid data. (Total includes the first cycle.) The valid options are: 1-9 (the default is 3). Timeout Message Override. The valid options are: Y - Override the system default with a pre-recorded Application Media Library file. N - (default) Do not override the system default. Note: The system default is specified in the No-entry video option on the Operations Console's IVR tab. Invalid Entry Message Override. The valid options are: Y - Override the system default with a pre-recorded Application Media Library file. N - (default) Do not override the system default. Note: The system default is specified in the Invalid-entry video option on the Operations Console's IVR tab. Text Overlay. Specifies the dynamic text overlay that is shown as a single line of text at the bottom of the video. (Default is that no text overlay is displayed.) Note: See the "Text Overlay Option Guidelines (page 599)" section for more information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
608
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Unified CVP Video Micro-Applications
The valid options are: Null - (default) No text overlay is displayed. (number 1-10) - Unified CVP gets the text for the text overlay in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. For the VGD and VM micro-applications, if the text overlay is specified, then the user-entered digits are shown after the text overlay. If the script writer wants to suppress the display of the user-entered digits, then the text overlay should not be specified. There is no option of displaying the text overlay, but not displaying the user-entered digits. Show/Display options. Specifies whether the video will be shown as audio-only, video-only, or both audio and video. (The default is audio and video.) The valid options are: B - Video and Audio (default). V - Video only. Note: The "V" (Video only) option can be used to suppress the audio from the video if audio-only files are played along with the video and you do not want both audio streams to be heard at the same time. A Audio only. Audio Only File Name(s). Name of one or more audio files to be played simultaneously with the video. (The default is that no audio file is played.) In the case where a video is specified along with audio-only files, the IVR Service will play the video and simultaneously start the first audio-only video. It will then play any remaining audio-only files in sequential succession. It will not return to Unified ICME until both the video and all audio-only videos have finished or barge-in occurs. To specify a single audio file to be played, specify the file name in the configuration parameter. To specify multiple audio files, a call variable is required. In the call variable, the names of the audio files to play must be comma separated. When there are multiple audio files to be played: If the first audio file is not found, no audio files will be played. If the first audio file is found but the second or subsequent audio file is not found, the audio files before the missing file are played. If a file is discovered missing before the digit collection is completed, any collected digits are discarded and a media error is returned. If digit collection is completed before a a file is discovered missing, the digit collection is treated as successful.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
609
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Adding IVP Server to Operations Console
The valid options are: A 3gp or .wav audio file name. Note: Media file names are case-sensitive. This option only allows a singe audio file to be played. Null - (default) No audio-only file name. (number 1-10) - Unified CVP plays the file in the corresponding Call.PeripheralVariable file. For example, a value of 2 instructs Unified CVP to look at Call.PeripheralVariable2. If there is more than one audio file, the file names must be separated by a comma. Looping. Indicates whether the video should be looped. The valid options are: Y - Loop the media. N (default) - Do not loop the media. You might want to set looping to Y, if the expected time for digit collection might take longer than the video. This can happen if the timeout value for "No-Entry Timeout" is long. If the looping parameter is set to N and the video ends before the digit collection completes, the digit collection will be aborted. Suppress digit display. Suppress display of user entered digits on screen. The valid options are: Y - Suppress the display of user-entered digits. N (default) - Do not suppress the display of user entered digits.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
610
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Adding IVP Server to Operations Console
You can also configure a link to the IVP Manager web page of the IVP Server, so that it can be accessed from the Operations Console. You can perform the following tasks: Adding an IVP Server (page 611) Editing an IVP Server Configuration (page 612) Finding an IVP Server (page 614) Adding and Removing an IVP Server from a Device Pool (page 613) Deleting an IVP Server (page 614)
Procedure
To add an IVP Server:
Step 1
Choose Device Management > IVP Server. Any IVP Servers that have been added to the Operations Console are listed.
Step 2
Fill in the appropriate IVP Server configuration settings on the General tab. Optionally, select the Device Pool tab and add the IVP Server to a device pool. When you finish configuring the IVP Server click Save..
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
611
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Adding IVP Server to Operations Console
See Also IVP Server Configuration Settings (page 612) Adding and Removing an IVP Server from a Device Pool (page 613) Viewing Device State (page ?) Review the Configuration Checklist (page 571)
Procedure
To edit an IVP Server:
Step 1
Choose Device Management > IVP Server. The Find, Add, Delete, Edit IVP Server window opens.
From the list of matching records, choose the IVP Server that you want to edit. Click Edit. Change appropriate configuration settings on the General tab. You cannot change the IP address of the IVP Server. Optionally, select the Device Pool tab and add the IVP Server to a device pool. When you finish configuring the IVP Server, click Save.
Step 5 Step 6
See Also IVP Server Configuration Settings (page 612) Adding and Removing an IVP Server from a Device Pool (page 613) Viewing Device State (page ?) Finding an IVP Server (page 614)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
612
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Adding IVP Server to Operations Console
Field
Description
Default
Range
Restart Required
General IP Address Hostname The IP address of IVP server The hostname of the IVP server None None Valid IP address Valid DNS name, which can include letters in the alphabet, the numbers 0 through 9, and a dash Yes Yes
The description of None the IVP server The Administration http://ip/ URL of the device. The port to which 9981 the Call Server connects when establishing initial contact
The maximum length is 1026 characters No A valid URL that begins with an http:/ No / prefix and contains no spaces 0 through 65000 Yes
Choose Device Management > IVP Server. The Find, Add, Delete, Edit Media Server window opens.
From the list of matching records, choose the IVP Server that you want to edit. Click Edit. Select the Device Pool tab.
a.
To add a device to a device pool, select the device pool from the Available pane, and then click the right arrow to move the pool to the Selected pane To remove a device from a device pool, select the device pool from the Selected pane, and then click the left arrow to move the device pool to the Available pane.
b.
Step 5
Click Save.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
613
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Adding IVP Server to Operations Console
Choose Device Management > IVP Server. The Find, Add, Delete, Edit IVP Server window opens.
From the list of matching records, choose the IVP Server that you want to delete. Click Delete. Click OK to confirm the delete operation; click Cancel to abort the delete operation.
Choose Device Management > IVP Server from the Main menu. The Find, Add, Delete, Edit window lists the available IVP Servers, sorted by name, 10 at a time.
Step 2 Step 3
If the list is long, click Next to view the next group of available IVP Servers. If you know the name of a particular IVP Server, enter the name in the Search text box and then click Go. To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 4
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
614
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Installing and Setting Up the CVP Video Media Server (VMS)
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with is exactly is empty
Step 6
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
615
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Installing and Setting Up the CVP Video Media Server (VMS)
Install Unified CVP on the video media server. This installs Unified CVP software, which contains: The Darwin Streaming Server. An ORM to process service start/stop requests from the Operations Console. The Video Media Server Administration Interface, which is a graphical user interface invoked from the Operations Console from which you can manage video files and metadata on a Video Media Server. The Cisco Unified Customer Voice Portal Video Desktop, which processes video file data requests from the agent desktops. The system media video files. These files consist of: -- 3gp files to be played for error conditions. -- Sample videos that the customer can use as background. An HTTPS certificate. Create the customer 3gp videos and associated thumbnail jpgs (if desired). Note: Thumbnail display size is limited to 120x80. Large images use more network bandwidth and will; therefore, impact Video Media Server performance when they are displayed to agents. The "Creating Videos (page 639)" section provides a sample video creation process and thumbnail creation process. Using Windows Explorer, put the 3gp videos and thumbnails in the correct location on the video media server. (This process is consistent with the process for placing audio media files.) The thumbnail must reside in the same folder as the 3gp video and must have the same name; for example, if the video is Welcome.3gp, the thumbnail must be named Welcome.jpg. The folder structure used for videos has a fixed component and a customer configurable component. The fixed portion specifies: Root folder of the Darwin Streaming Server. Language locale. The word "app" or "sys." All customized videos reside under app and all CVP-installed videos reside under sys. A sample folder hierarchy could be: C:\<Darwin-root-folder>\en-us\app\plumbing\soldering\FluxTechniques.3gp
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
616
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video Media Server
C:\<Darwin-root-folder>\en-us\app\plumbing\soldering\FluxTechniques.jpg C:\<Darwin-root-folder>\en-us\app\plumbing\pipefittings\ElbowInstallation.3gp C:\<Darwin-root-folder>\en-us\app\plumbing\pipefittings\ElbowInstallation.jpg An administrator must assign metadata (description, title, search keywords) for any video to be searchable by the agent. Videos without metadata will be accessible only by a Unified ICME script. Note: For instructions on adding metadata, see the "Adding or Editing Metadata (page 628)" section. Additionally, for each recorded/live video use the Video Media Server administration to enter the running time/duration of a video clip the administrator adds to the file system. (The system does not automatically compute the running time of the video.) Press Save. The metadata is stored as an xml file in the same folder as the corresponding video. Once the web application picks up metadata modifications from the file system or via the administrative metadata entry page, the changes will be visible upon the next web page refresh of VMS (whether it be on the Video Media Server Administration pages or the Video Desktop pages). Administrators can easily replicate the videos and metadata to another video media server by simply using Windows Explorer to copy the Darwin video root folder to the new server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
617
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video Media Server
Adding a Video Media Server (page 618) Editing a Video Media Server (page 619) Adding and Removing a Video Media Server from a Device Pool (page 622) Deleting a Video Media Server (page 622) Finding a Video Media Server (page 623)
Procedure
To add a Video Media Server:
Step 1
Choose Device Management > CVP Video Media Server. Any Video Media Servers that have been added to the Operations Console are listed in the Find, Add, Delete, Edit CVP Video Media Servers list.
Step 2
Click Add New. The CVP Video Media Server Configuration window opens to the General Tab.
Step 3 Step 4
Enter the IP Address and Hostname of the Video Media Server. Optionally, provide a description and/or click Enable secure communications with the Ops Console. When you enable this option, the Video Media Server is accessed using SSH. Note: It is recommended that you manually copy the security certificates between the Operations Console and the Video Media Server before you enable the secure communications option.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
618
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video Media Server
Refer to the Configuration and Administration Guide for Cisco Unified Customer Voice Portal for detailed information about securing communications between Operations Console and Unified CVP components. Note: See the "How to Enable Security on Unified CVP Devices" section for more information.
Step 5 Step 6 Step 7
Click Device Pool to add the Video Media Server to a device pool. Optionally, select the Infrastructure tab and configure log file and syslog settings. When you finish configuring the Video Media Server click Save to save the settings in the Operations Console database. Click Save & Deploy to deploy the changes to the Video Media Server.
See Also Adding and Removing a Video Media Server from a Device Pool (page 622) Configuring Video Media Server Infrastructure Settings (page 620) Viewing Device State (page ?) Review the Configuration Checklist (page 571)
Procedure
To edit a Video Media Server:
Step 1
Choose Device Management > CVP Video Media Server. The Find, Add, Delete, Edit CVP Video Media Server Configuration window opens.
Step 2 Step 3
From the list of matching records, choose the Video Media Server that you want to edit. Click Edit. The Edit CVP Video Media Server Configuration window opens.
Step 4
Change configuration settings on the General tab at your discretion. You cannot change the IP address of the Video Media Server. Optionally, select Device Pool and add or remove the Video Media Server from one device pool to another.
Step 5
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
619
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video Media Server
Step 6 Step 7
Optionally, select the Infrastructure tab and configure log file and syslog settings. When you finish configuring the Video Media Server, click Save to save the settings in the Operations Server database. Click Save & Deploy to apply the changes to the Video Media Server.
See Also Adding and Removing a Video Media Server from a Device Pool (page 622) Configuring Video Media Server Infrastructure Settings (page 620) Viewing Video Media Server Statistics (page 624) Uploading a Log Messages XML File (page 291) Downloading a Log Messages XML File (page 289) Viewing Device State (page ?) Finding a Video Media Server (page 623) Launching Video Media Server Administration (page 624)
Field
Description
Default
Range
Configuration: Thread Management Maximum Threads Advanced Statistics Aggregation Interval Log File Properties Max Log File Size (Required) Maximum size of the log file in 10 MB Megabytes. The log file name follows this format: CVP.DateStamp.SeqNum.log example: For example: CVP.2006-07-04.00.log After midnight each day, a new log file is automatically created with a new date stamp. Also, when a log file exceeds the max log file size, a 1 MB - Max Log Directory Size Max Log Dir Size divided by Max Log File Size cannot be greater than 5,000. The Video Media Server publishes statistics at this interval. 30 minutes 10 - 1440 (Required) The maximum thread pool size in the 300 Video Media Server Java Virtual Machine. 100 - 1000
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
620
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video Media Server
Field
Description
Default
Range
new one with the next sequence number is created, for example, when CVP.2006-07-04.00.log reaches 5 Mb, CVP.2006-07-04.01.log is automatically created. Max Log Directory Size (Required) Maximum size of the directory containing Video Media Server log files. Note: Modifying this value to a setting that is below the default value might cause logs to be rolled over quickly. Consequently, log entries might be lost, which can affect troubleshooting. 20,000 MB 500 - 50000 MB Max Log File size < Max Log Directory Size Max Log File size > 1 Max Log Dir Size / Max Log File Size cannot be greater than 5,000 Configuration: Syslog Settings Syslog Server Syslog Server Port Number Name of the server to which the Video Media Server writes log messages. Port number of the Syslog server. None None Not applicable Any available port number. Valid port numbers are integers between 1 and 65535. Not applicable Any available port number. Valid port numbers are integers between 1 and 65535.
Name of a backup server to which the Video Media Server writes log messages. Port number of the backup Syslog server.
None None
Field
Description
Default
Range
Restart Required
General IP Address The IP address of None Video Media Server Yes Yes No No Valid IP address Yes
Valid DNS name, which Yes can include letters in the alphabet, the numbers 0 through 9, dot and hyphen.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
621
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video Media Server
Field
Description
Default
Range
Restart Required
None Description An optional text description for the Video Media Server Enable Secure Communication with the Operations Console Select to secure None communications between the Operations Console and this component. The Video Media Server will be accessed using SSH.
No
No
Up to 1026 characters
No
No
Yes
Enabled or Disabled
No
Adding and Removing a Video Media Server from a Device Pool Procedure
To add or remove a Video Media Server from a Device Pool:
Step 1
Choose Device Management > CVP Video Media Server. The Find, Add, Delete, Edit CVP Video Media Server window opens.
From the list of matching records, choose the Video Media Server that you want to edit. Click Edit. Select the Device Pool tab.
a.
To add a device to a device pool, select the device pool from the Available pane, and then click the right arrow to move the pool to the Selected pane To remove a device from a device pool, select the device pool from the Selected pane, and then click the left arrow to move the device pool to the Available pane.
b.
Step 5
Click Save.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
622
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video Media Server
The Find, Add, Delete, Edit CVP Video Media Server window opens.
Step 2 Step 3 Step 4
From the list of matching records, choose the Video Media Server that you want to delete. Click Delete. Click OK to confirm the delete operation; click Cancel to abort the delete operation.
Choose Device Management > CVP Video Media Server from the Main menu. The Find, Add, Delete, Edit window lists the available Video Media Servers, sorted by name, 10 at a time.
Step 2 Step 3
If the list is long, click Next to view the next group of available Video Media Servers. If you know the name of a particular Video Media Server, enter the name in the Search text box and then click Go. To perform an advanced search, click Advanced. From the first Advanced Search window drop-down list box, choose one of the following criteria: Search criteria: Hostname IP address Description
Step 4
Step 5
From the second window drop-down list box, choose one of the following criteria: Search criteria: begins with contains ends with
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
623
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video Media Server
is exactly is empty
Step 6
Procedure
To view device statistics:
Step 1
Choose Device Management > CVP Video Media Server. The Find, Add, Delete, Edit Video Media Servers window opens.
Step 2
Locate the Video Media Server in the list. If the list is lengthy, use the procedure in Finding a Video Media Server (page 623) topic. From the list of matching records, choose the Video Media Server that interests you and click Edit. The Edit Video Media Server Configuration window displays.
Step 3
Step 4
From the toolbar, click Statistics. Statistics display for the selected Video Media Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
624
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
Procedure
To launch the CVP Video Media Server Administration interface:
Step 1
Choose Device Management > CVP Video Media Server. The Find, Add, Delete, Edit CVP Video Media Server window opens.
Step 2 Step 3
From the list of matching records, choose the Video Media Server that you want to edit. Click Edit. The Edit CVP Video Media Configuration window opens to the General tab.
Step 4
Select Video Management in the toolbar. The Cisco Unified CVP VMS Administration Media Management window opens.
See Also Using the Video Media Server Administration Interface (page 625) Adding or Editing Metadata (page 628) Searching Metadata (page 632) Previewing Video Files (page 635)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
625
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
using CTI OS or CAD and use the Unified CVP Video Desktop to search for, select, and play live or recorded videos to video-enabled callers. A video family is comprised of the following video media files.
Table 91:
File
Description
Video
A .3gp file that is local to Video Media Server. Video files are contained in the VMS media library. VMS also supports remote video files hosted on other servers. In this case, the .3gp file does not reside in the VMS media library.
Metadata
An .xml file that contains all the metadata necessary to describe the video file and make it searchable and accessible to call center agents. Metadata files are stored in the VMS media library. A metadata file contains the following information: audio/narrative (spoken) language of the video an automatically generated URL (for local videos) or manually entered URL (for remote videos) (a fully qualified path for video hosted remotely; VMS determines the local path automatically) media type (live or recorded videos) agent show status (controls whether the video is shown/hidden from the agent view) duration (media playtime of recorded videos only) localized title, description, and keywords. These are relevant words or phrases that the agents might use to search for a video file. Since Video Media Server supports 17 languages, you should be mindful when entering this information for each language used by call center agents. Note: Metadata for a remote video file also includes the URL to the video.
Thumbnail
(Optional). An image file associated with the video file. Thumbnail files are stored in the VMS media library. Supported file extensions are: .jpg , .png and .gif. You can perform the following tasks: Copying Video Files to the Video Media Server (page 627) Adding or Editing Metadata (page 628) Searching Metadata (page 632)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
626
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
Sorting and Filtering Media (page 633) Previewing Media (page 635)
Procedure
Step 1
Create 3GP and/or image files. You can find information about creating 3GP files in the Configuration and Administration Guide for Cisco Unified Customer Voice Portal.
Step 2
If: You want to host media files locally Then: Use Windows Explorer, FTP, SCP, or a tool of your choice to copy media files to the location you specified during CVP Video Media Server installation. If: You want to host media files remotely
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
627
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
The Video Media Server periodically polls the local disk for changes to video media files and folders contained in the media library. It generally takes no more than one minute for file system to discover changes and display them in the VMS Administration interface. At present, the poll interval is not configurable from the Video Media Server Administration interface. See Also Adding or Editing Metadata (page 628) Review the Configuration Checklist (page 571)
Procedure
To add or edit metadata:
Step 1
From the Media Management toolbar, click Add New to add metadata for files hosted remotely. Files that are hosted locally display in the Media list. The Adding / Editing Metadata window opens to the Non-localized Data tab. Non-localized metadata is language-independent. With the exception of narrative language, duration, and thumbnail metadata, non-localized data is not shown to call center agents. The VMS administrator does not need to provide separate non-localized metadata to support each language.
Step 2 Step 3
Enter metadata and select the configuration settings that are appropriate for the video file. Click Localized Data. All of the languages that are supported display on the left side of the window. Localized Data is metadata that is searchable by call center agents. The CVP Video Media Server Administration interface supports multilingual queries, which allows agents to choose which language they prefer to use when searching for video files. It is imperative that the VMS administrator consider the call center agent population when adding metadata. In addition, it is as important to provide comprehensive metadata, which leads to more effective search results.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
628
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
Step 4
Select the language locale and assign metadata. You must provide separate metadata entries for each language available for use by call center agents. Note: To input metadata entries in non-English languages, you must configure your keyboard for that language.
Step 5
Click Save and close the Adding Metadata window. Note: An asterisk (*) displays in the title bar to indicate unsaved changes. Note: The Preview button operates according to the current saved URL. A video can be previewed only when it is pointing to a valid rtsp:// URL and the metadata additions/changes are saved.
Step 6
In the Media Management window, click Refresh to refresh the Media list and see newly added files. The new metadata is now available for agent selection.
Note: If you rename a video file, you must also rename all of the files in the video family (that is, the image and metadata .xml files). This ensures that the Video Desktop application can detect the video deletion and addition and update its cache. See Also Metadata Configuration Settings (page 630) Deleting Metadata (page 629) Previewing a Video File (page 635)
Deleting Metadata
You can delete metadata (XML file) from the Video Media Server. Note: If you replace or delete metadata while its associated video is being played to a call center agent, the video will not play to the agent. Instead the CVP Video Desktop will display an error message to the call center agent.
Procedure
To delete the metadata file:
Step 1
From the Media list, select the video you want to delete and click Delete.
The delete operation does not remove the video (3gp) or thumbnail files from the Video Media Server.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
629
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
Field
Description
Default
Range
Non-localized Data Name The name of the video file. None or Read-Only (local files) The name can contain alphanumeric characters, underscore, spaces, and the following special characters: !$&().,= '-;@_~+ The maximum length is 50 characters. Note: A file name cannot lead with a space or period (.). Path (folder names) cannot lead or end with a space or period (.). Language The narrative (spoken) language the video media English file is configured to use. An automatically generated or manually entered None URL. When a file is local to the Video Media Server, VMS automatically determines the URL used by other components (such as, IVP server) to locate the video file. Provide a manual URL to point the Video Media Server to video files that reside on a remote device. Type
15) file://
All of the supported languages are listed in the Language drop-down list box. Valid URLs must have a Real Time Streaming Protocol (rtsp://) or file:/ / 15 prefix. The maximum length is 1000 characters.
URL
None
Live or Recorded
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
630
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
Field
Description
Default
Range
A Live file is a media stream that is delivered in real time, such as a traffic or security camera video. A live file has only Play and Stop VCR-like controls.
Note: When the Video Media Server is unable to determine metadata file Additional VCR-like controls can be applied to type, it a Recorded file. automatically sets the Type to Recorded. Show By default, valid video media files are immediately available to call center agents. However, you can populate the Video Media Server with video media files and withhold the files from call center agents until you are ready to publicize video files. Select No to make video files unavailable to call center agents. Note: A video media file is available to a call center agent only when its status is Valid. A valid video media file must be configured to be shown to the agent and have valid metadata. Duration The duration of the video media file in hours, minutes, and seconds. 00:00:00 Time is represented in HH:MM:SS format. Minutes and seconds must be within the range of 0 through 59. Valid thumbnail image pixel size is 120 x 80 (width x height). Thumbnail images must have the same name as the XML file, with exception of file extension. Supported file extensions are: .jpg, .gif, and .png. Note: Large images use more network bandwidth and will impact Video Media Server performance when they are displayed to agents. Images that are larger or smaller than 120 x 80 will be resized for display to the Administrator only. The content on the image itself does not change on the file system. Localized Data Title The title of the video media file. None 255 character length maximum Yes Yes or No
Thumbnail
The reduced-size version of an image representing None the video file, if available. VMS automatically detects an image file when it resides in the media library.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
631
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
Field
Description
Default
Range
Description
The description of the video media file. For best None results, provide a description that corresponds to the keywords. Relevant words or phrases that the user might use None to search for a video media file. Keywords are not shown to agents.
Keywords
Searching Metadata
VMS administrators can search all administrator-enabled metadata fields: video media filenames and folders; as well as localized titles, localized descriptions, and localized keywords using relevant search terms. Filenames and folders are represented in English, which means you can enter a search term, in English, to search for a particular filename or folder. The Advanced link displays additional search options. Use the advanced search operators to refine your search, be more precise, and gather more useful results. When you select Search Results, only the metadata shown in the Media list will be searched. To re-display all video files and metadata click Show All. The Video Media Server periodically polls the local disk for changes to media and metadata (3GP and XML) files and folders contained in the media library. It generally takes no more than one minute for the file system to discover changes and display them in the VMS Administration interface. This helps to ensure that your search operation returns the most current media metadata.
Procedure
To search metadata fields:
Step 1
If: You want to search all administrator-enabled metadata fields, Then: In the Search field, type a search term and click Go. If: You want to narrow your search, Then: Click the Advanced link.
The Advanced Search dialog box opens. By default, all of the administrator-enabled metadata checkboxes are selected. Select the search operators that will best match your query and click Apply, then click Go.
Step 2
Click Refresh to display recently polled data to see the latest system view.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
632
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
Note: English is used as the default search language, which means only English-localized metadata is searched. If you want to search for localized metadata in another language, click the Advanced link and select a language from the Search language drop-down list box. See Also Sorting the Media List (page 633) Filtering the Media List (page 633)
Procedure
To sort the media list by file or folder name:
Step 1
On the Media list, click the Name column heading. The Media list is sorted alphabetically. Click the up arrow to sort the list in ascending order; click the down arrow to sort the list in descending order.
See Also Searching Metadata (page 632) Filtering the Media List (page 633)
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
633
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Video Media Server Administration Interface
Show Thumbnail
Procedure
To filter the media list:
Step 1
From the Media Management toolbar, click Filters. The Filters dialog box opens. By default, all filter operators are selected.
Step 2
Click to select/clear filter checkboxes, and click Go. The Media list is refreshed and displays the filtered search results. Note: You must select at least one checkbox from each category. If you decide not to apply filters, click Cancel to undo your selections and close the Filter dialog box.
Step 3 Step 4
Sort the filtered search results by clicking the Name, Duration, or URL Value column heading. Click Show All to clear all search terms and filters. All media and metadata folders re-display in the Media list.
See Also Metadata configuration settings (page 630) Searching Metadata (page 632)
Procedure
To browse the media library:
Step 1
On the Media Management window, in Browse: click the folder you want to browse.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
634
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video on the Cisco CTI OS or CAD Desktops
The contents of the selected media library folder display. Click the Up icon to move up one level in the media library folder.
Procedure
To preview a video:
Step 1
From the Media list, select the video file that you want to preview, then click Preview. The media player plays the video file.
Note: A video can be previewed only when it is pointing to a valid rtsp:// URL. See Also Adding or Editing Metadata (page 628)
How to Enable Video on the CTI OS Agent and CTI OS Supervisor Desktops
This section describes how to enable the video feature on the CTI OS Agent and CTI OS Supervisor Desktops. Before following the instructions below, install CTI OS 7.x and apply the CTI OS 7.2(3) patch using Patch Manager.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
635
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video on the Cisco CTI OS or CAD Desktops
Step 1
To enable video, open a DOS window and go to the directory where the CTI OS Client's Setup.exe file resides. Enter the following command to enable video: Setup /VideoEnable. To disable video, open a DOS window and go to the directory where the CTI OS Client's Setup.exe file resides. Enter the following command to disable video: Setup /VideoDisable. After enabling the video feature, launch the desktop. When a video call arrives, the Video button enables on the desktop. Click the Video button to launch the Unified CVP Video Desktop.
Step 2
Open the CTIOSSoftphoneCSharp.exe.config file in the CTIOS Toolkit directory. Add the following line: <add key = "VideoEnabled" value="1" />. Save the file. After enabling the video feature, launch the desktop. When a video call arrives, the Video button enables on the desktop. Click the Video button to launch the Unified CVP Video Desktop.
Using the Cisco Desktop Administrator, add the video ECC variables to CAD:
a. b. c.
Step 2 Step 3
Open the Voice Contact Work window and add a new work flow. Select Inbound as the call type.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
636
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Configuring Video on the Cisco CTI OS or CAD Desktops
Step 4
Specify the three video ECC variables as the Data Field Conditions and set their field filter to Is Not Empty, then select the apply All option. Click OK to complete the first level filter. Select the Answered event to be associated with the new action. Under the Actions pane, click Add. The Select Action dialog displays. Select the HTTP Action tab. Click New. The HTTP Action Setup dialog displays. Complete the HTTP Action Setup dialog as follows:
a. b. c. d.
Action Name: Enter a name for the new action; for example, VMS. Protocol: https. Method: GET. Host: Enter the host name or IP address of the Video Media Server. Do not include the http prefix. Port: Enter the port 8443. Path: Enter cvp-vms/Agent.do. Browser Tab: Select the browser tab in which you want the action results to be displayed.
e. f. g. Step 11 Step 12
Click Add to display the HTTP Request Data dialog box. Complete the HTTP Request Data dialog box as follows:
a. b. c.
Value Name: Leave blank. Value Type: DataFieldOnly. Value: Select theuser.microapp.cvpmovies_params ECC variable from the drop-down list. Test Data: leave blank.
Click OK. Click Add again to display a new HTTP Request Data dialog box. Complete the HTTP Request Data dialog box as follows:
a. b.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
637
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Using the Cisco Unified Customer Voice Portal Video Desktop
Value: Select theuser.media.id ECC variable from the drop-down list. Test Data: Leave blank.
Click OK. Click Add again to display a new HTTP Request Data dialog box. Complete the HTTP Request Data dialog box as follows:
a. b. c. d.
Value Name: agentID. Value Type: DataField Value: Select the [AGENT_ID] variable from the drop-down list. Test Data: Leave blank.
Step 19 Step 20
Click OK on the HTTP Request Data dialog. Click OK on the HTTP Action Setup dialog.
How to Change the Cisco Unified Customer Voice Portal Video Desktop Language
Follow the instructions below to change the language used in the Cisco Unified Customer Voice Portal Video Desktop.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
638
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Agent Partitioning
Step 1
Access the CVP Video Media Server by clicking Video on the desktop. The Cisco Unified CVP Video Desktop displays.
Step 2 Step 3
From the drop down at the top right of the Video Desktop, select your Video Desktop language. As soon as your language is selected, all text in the Video Desktop is immediately displayed in the selected language. Your keyboard setting should be the same as the Video Desktop language. Note: The Search mechanism uses the selected Video Desktop language for locating video information. If localized text is not available in the given language for a video, the Title field displays the filename in English and the Description field states that 'no description is available' [in the selected language].
Step 4
Revisit the Configuration Checklist (page 571) to proceed with the configuration instructions for the Full Call Flow Model.
See Also Refer to the Video Desktop online help for detailed information on using this application. Refer to the Operations Console online help for details on using the VMS Administration.
Agent Partitioning
In a case where a Service Provider hosts Unified CVP video services for multiple customers, it is desirable to prevent an agent from enterprise customer A from seeing the content of the video media library hosted for enterprise customer B. To address this situation, the agent is directed to a VMS Server on a per-call basis based on the media server ECC variable that is specified in the Unified ICME script. Typically, in a hosted/partitioned environment, the caller will be executing different sets of scripts for different partitions/companies. Each of those scripts can specify their own VMS Server. Each of the VMS Servers would be deployed in the Operations Console as their own devices, with their own sets of videos.
Creating Videos
The following instructions describe how to convert wav audio files into 3gp audio-only files. Also included in the following sections are a few examples on how to create a suitable 3gp file. There are many ways to create a 3gp file, so you can use other methods instead of the given examples. Videos must first be created and then converted into a format that the IVP can understand. Videos can be created and converted according to the three examples provided in this section; however, if you choose to use another method to create videos, the required specifications for creating and encoding the videos are listed in the following tables.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
639
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Creating Videos
Frame rate Video bit rate Size File format Key frame every Video data format Audio format
30 192-320 Kbps CIF .3gp 10 seconds H.263/1998 baseline AAC-LC, 32 Kbps, sampling rate 32 KHz, mono
Table 94: Format for Intermediate Files to be Converted to .3gp files as Specified Above
Frame rate Video bit rate Size File format Key frame every Video data format Audio format
30 320 Kbps CIF Raw .AVI or .WMV N/A Raw or WMV Raw or WMV Note: Refer to the Radvision IVP User Guide for more information.
How to Add a Static Image to an Audio File Using Windows Movie Maker
Before starting this task, you must have the following installed: Microsoft Windows Movie Maker FFmpeg (http://ffmpeg.mplayerhq.hu/) Follow these instructions to create the ffmpeg.exe: Access the official ffmpeg web site at http://ffmpeg.mplayerhq.hu/. Manually check out ffmpeg from your SVN (Subversion) version control system. Compile ffmpeg using a C compiler. Note: Some web sites, such as http://arrozcru.no-ip.org/ffmpeg_builds/, offer fully compiled versions of ffmpeg. MP4Box (http://www.softpedia.com/get/Multimedia/Video/Video-Editors/MP4Box.shtml) Note: Refer to the Windows Movie Maker documentation for detailed information.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
640
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Creating Videos
Open Windows Movie Maker. Select File > Import to Collections... and select your image file. Select File > Import to Collections... and select your audio file. Create the video by first dragging the audio file to the "Audio/Music" bar at the bottom of the screen. Then drag the image file to the "Video" bar. (Make sure the ends of the image bar lines up with the audio bar.) Preview your file and check that everything is in order. Save this video by selecting File > Save Movie File..... On the first dialog, select My Computer, then click Next.
Step 5 Step 6
On the new dialog, enter the video name and select a folder for it. Click Next. Click Next again, which creates a file. After making the video, use ffmpeg to convert the file to a 3gp file using the following command:
ffmpeg.exe -i <inout_file>.wmv -acodec mpeg4aac -ab 32k -ar 32000 -ac1 -s cif -b 192k -r 30 <output_file>.3gp.
Step 10
Add hinting using MP4Box and enter the following command: mp4box.exe -hint <input file>.3gp.
See Also Refer to the Microsoft Windows Movie Maker documentation for more details.
Create or edit agent avatars and add backgrounds. Open Codebaby Production Studio.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
641
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Creating Videos
Step 3
Import characters by selecting File > Import Assets.... Select the character you want to import. If you want to use the sample characters that Codebaby provides, access them in the C:\Program Files\Codebaby\Production Studio\Sample Content folder. Import a background by selecting File > Import Assets.... Select the background you want to use. Sample backgrounds can also be found in the C:\Program Files\Codebaby\Production Studio\Sample Content folder. Select File > Import Assets... and select the audio file to import. (A menu displays asking how you want your audio imported.) Select Create lip sync and scene and check Auto animate. ClickImport. The scene is created, which allows you to preview the finished product. Check that everything is in order. Save this project as a video file by selecting File > Export.... In the top box, select the scene that corresponds to your video. (It generally has the same name as your audio file.) Do not check "Scene001," as this will generally be an empty file. Make sure the "Export Format" is set to AVI. After you create the file, use ffmpeg to convert the file to a 3gp file using the following command:
ffmpeg.exe -i <inout_file>.wmv -acodec mpeg4aac -ab 32k -ar 32000 -ac1 -s cif -b 192k -r 30 <output_file>.3gp.
Step 4
Step 5
Step 6
Step 7
Step 8
Step 9
Add hinting using MP4Box and enter the following command: mp4box.exe -hint <input file>.3gp.
See Also Refer to the Codebaby Production Studio documentation for more details.
Create one of the videos above, but do not convert it using ffmpeg. Open Nokia Multimedia Converter.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
642
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Creating Videos
Import a file by selecting File > Open and select your file. Click Convert... in the bottom right-hand corner. At this point, you can preview the final version. If necessary, change the settings and reconvert. Save your file by selecting File > Save and select the folder where the file must be saved. Add hinting using MP4Box and enter the following command: mp4box.exe -hint <input file>.3gp.
See Also Refer to the Nokia Multimedia Converter documentation for more details.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
643
Chapter 17: Configuring the Unified CVP Basic Video and Full Video Call Flow Models Creating Videos
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
644
Appendix A
Localization Customization
Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
The VPD micro-application enables a Unified ICME script writer to "play data" to callers via Unified CVP in the Full Video call flow model. The data for the VPD is sent to the IVR Service from Unified ICME via the Unified CVP ICM Service. The data can consist of different types; for example, Number, Date, etc. Note: For a detailed description of the VPD micro-application, see the "Video Play Data (VPD) Micro-Application (page 599)" section. Playing data consists of three processes that happen at approximately the same time when the VPD micro-application is executed: Showing a movie usually this movie has no audio or the audio is suppressed using the''V" (Video only) option in the VPD 'Display' configuration parameter. Playing one or more locale-dependent sequenced audio files. Displaying a textual representation of the locale-dependent data. The audio is locale-sensitive because it can be in different languages. The text is also locale-sensitive due to the language and because different regions of the world use different formats for dates, numbers, etc. The movie is not as locale-sensitive and can be locale-neutral if one is chosen that is acceptable for all cultures and languages. Unified CVP only ships with support for the en-us (American English) locale in the VPD micro-application. The Unified CVP IVR Service provides an API whereby support for other locales can be implemented. Using the API, a developer can return the list of file names to be played as well as the text-overlay to be displayed as part of the VPD.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
645
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
This section describes the processes and application programming interfaces (API) provided for a developer to construct and deploy custom components that add additional language support for the VPD micro-application. A developer can use the API to customize the audio and text-overlay components of the VPD based on the locale. Note: The API does not provide support for customizing the video component of the VPD other than the text overlay.
API Requirements
Localization customization requires programming effort to construct. In order to build these components, Unified CVP provides a Java API. Therefore, you must possess a familiarity with the Java programming language.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
646
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
You must understand Java interfaces and abstract classes, extending classes and overriding methods, static variables and methods, Java collections, and compiling and deploying Java classes and JAR files. The API does not require very complex Java coding, but the algorithm for sequencing the list of audio file names can be complex depending on the language. Most of the information about the Java API is encapsulated in the APIs Javadocs. This document will serve to provide a starting point and the Javadocs will provide the details. Note: It is important to note that Sun JDK 1.5 Update 13 or higher is required for the API. Since no testing has been performed with JDK 1.6, it is recommended that developers only use JDK 1.5. The creation of audio files for different languages is the responsibility of the developer. Once the audio files are created, they must be deployed to the Radvision IVP box the same way that "en-us" audio files are deployed, except that they reside in their own folder. The folder name must be the same name as the locale; for example, the files for en-us reside in the /home/rv/cvp/en-us folder on the Radvision IVP machine. Note: Only implement custom localization for languages that are supported by Radvision and Unified CVP.
The default mapping specifies that for the en-us locale, Unified CVP will use the com.cisco.cvp.ivr.microapp.customgrammar.EN_US_Localizer class. This class is provided as part of the Unified CVP installation. To add support for an additional language, you can add another line to customGrammar.properties that maps the locale to a different localizer class. For example, if you have implemented a localizer class that supports es-mx (Mexican Spanish) locale, the content of customGrammer.properties can be modified to look like this instead:
en-us=com.cisco.cvp.ivr.microapp.customgrammar.EN_US_Localizer es-mx=com.mycompany.ES_MX_Localizer
Note: The name of the class, "com.mycompany.ES_MX_Localizer," is just an example. The custom localizer class must implement the Unified CVP-defined Java interface "com.cisco.cvp.ivr.microapp.customgrammar.Localizer" in order for it to be used by the VPD localization framework. A base class called "com.cisco.cvp.ivr.microapp.customgrammar.BaseLocalizer" is provided by Unified CVP to ease the implementation of custom localizer classes. The BaseLocalizer class provides a default implementation for generating the textual representation of the text overlay based on the locale.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
647
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
Usually, new localizer classes would extend BaseLocalizer class, although this is not required. If this is done, the customized localizer class might override selected methods of the BaseLocalizer class if it is necessary to override the default implementation.
Design Considerations
This section provides a few notes on the Unified CVP Call Server (specifically IVR Service) and how it interacts with custom localizer classes written in Java. This information is important to remember since how a developer approaches the design of the classes they want to build is impacted by them: The localizer class is loaded into memory when the IVR Service first starts up. If the class is modified, it is not updated until the Unified CVP Call Server is restarted. During the startup of the IVR Service, a single instance of the custom localizer object is created and cached. Whenever a VPD is executed that requires the service of that custom localizer class, IVR Service will call the execution methods of that single instance. This means that a single object instance will handle requests made across all VPD execution for all calls for a particular locale (for example, if the call flow contains two VGD micro-applications, IVR Service will actually use the same instance for both across all calls). This is very important because in this design, the localizer class acts as if it is static. The consequence of this is that all member variables defined in the localizer class act as static variables, meaning that once changed, every caller experiencing that VPD execution is exposed to the same value. It is highly recommended to use only static final member variables where possible, and keep all other variables local to the execution method. The member variables might be initialized during the init( ) method and will not change after that. Everything a localizer class needs is provided by the API, so while this is important to be aware of, this design restriction will not prevent a developer from implementing any desired functionality within the class. The Unified CVP Call Server runs in a multi-threaded environment. The developer must ensure that their classes are thread-safe and implement the necessary synchronization where necessary (for example, accessing external resources such as files). Localizer class implementation must ensure that they do not cause any errors that can affect the VPD operation. Subtle errors like memory leak or synchronization errors are especially insidious because they can affect the entire Unified CVP Call Server and thus potentially disrupt normal call center operations. It is the developers responsibility to fully test and debug the code before deploying to a production Unified CVP Call Server. When called upon, the localizer class methods should return the requested data with minimal delay as the call is active and in progress. Any delay will affect the caller experience and long delays might cause call errors.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
648
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
Once compiled, the custom localizer class files should be packaged into a jar file. The jar file is then deployed to <CVP_HOME>\CallServer\Tomcat\common\lib. Modify the <CVP_HOME>\cvp\conf\customgrammar\customgrammar.properties file as described above. The Unified CVP Call Server needs to be restarted after the deployment is completed.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
649
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
Once the data for the text and/or audio is received from the localizer class, IVR Service continues execution of the VPD using the data returned by the localizer class.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
650
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization public void shutdownNotice(); }
Note: Only one instance of the Localizer implementation class is instantiated during Unified CVP Call Server startup. The init(String locale, CustomLogger logger, String confDirPath) method is called after a localizer class is instantiated during IVR Service startup. The locale string parameter is the locale that maps to this localizer class. The logger is a facility to allow the localizer class to log trace messages to the Unified CVP log files. The confDirPath parameter is the full path name of the <CVP_HOME>\cvp\conf folder where Unified CVP configuration files are stored. This is provided in case the localizer class needs to store its own configuration properties files. The custom property files can be stored under a sub-folder of the confDirPath. The methods that start with localizeText and localizeAudio are called based on the VPD data type. Each of these methods is passed the call identifier (Call GUID), data, and additional information if the data type requires it. The format of the data passed into these methods is the same as specified for the PD (Play Data) micro-application, which is described in the Data Play Back Types table (page 204) in Chapter 4, "Writing Scripts for Unified CVP." The shutdownNotice( ) method is called when the IVR Service is shutting down. This provides a hook for the localizer class to free resources if it needs to.
Interface: CustomLogger
The com.cisco.cvp.ivr.microapp.customgrammar.CustomLogger interface provides a hook for custom localizer classes to log messages to the Unified CVP log files for logging and tracing.
public interface CustomLogger { public void log(Level level, String message); public void traceCall(String callId, String message); public enum Level { ALERT, CRITICAL, ERROR, WARN, NOTICE, INFO } }
The log( ) method can be used to log significant errors or notices. The trace( ) method can be used to log trace messages. The Java API doc for CustomLogger provides guidelines that describe how the enum Level will be used. Note that excessively verbose logging will cause delays and could affect system performance.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
651
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
Enum: TimeFormat
TimeFormat defines Java enums for the time format types used by the VPD data types that are related to time. The data types that are related to time are: TOD (Time of Day), 24TOD (24 hour Time of Day), Etime (Elapsed Time).
Create the locale specific audio files - Create the audio files. The files must be in .wav format. (Note: Although .3gp files can be used, it is highly recommended that .wav files be used instead for minimal delay between playing of the audio files).
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
652
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
Step 2
Create and deploy localizer class - Create a Java localizer class for each language that will be supported. Package the class(es) into a jar file and deploy to Unified CVP Call Server installation. Create mapping for locale to localizer class - Modify the customGrammar.properties file to include the locale to localizer class (created in Step 2) mapping. Deploy audio files - Copy the audio files created in Step 1 to the Radvision IVP machine that they will be retrieved from. The audio files for VPD must be placed on /home/rv/cvp/<locale-name> on the IVP machine. Create a folder with the same name as the locale under /home/rv/cvp. For example, the files for en-us reside in the /home/rv/cvp/en-us folder on the Radvision IVP machine. In addition, create the necessary "app" and "sys" folder under /home/rv/cvp/<locale-name>. Restart Call Server - After all the above steps are completed, restart the Call Server. Look for errors in the Call Server error log for possible issues (for example, class load issues) if the localizer class does not seem to have been loaded.
Step 3
Step 4
Step 5
Create the audio files - Create the Spanish audio files in .wav format or use the Spanish files shipped with Unified CVP. Note: Unified CVP also ships with Spanish language audio files besides US English files. These files are the same as those provided in Unified CVP 4.0 and earlier; however, there is no localizer class implementation for Spanish. No other audio files besides US English and Spanish are provided by Unified CVP.
Step 2
Create and deploy localizer class - Create a custom class (for example, com.mycompany.ES_MX_Localizer.java) that implements the methods defined in the Localizer interface. The class can optionally extend BaseLocalizer class, if desired. The audio methods return a list of audio file names to be played. Each file name corresponds to a part of the input data. Most of the work involved in the localizer class is implementing the algorithm that generates the list of audio files. For example, if the VPD data type is currency (pesos) and the data is "1034.34," Unified CVP invokes the localizeAudioCurrency() method implemented in the localizer class. The localizer class might then return a java.util.List, which has eight entries that might contain the following file names: One, Thousand, Thirty, Four, Point, Thirty, Four, Pesos, where each string value is the name of a Spanish audio file. If the file name does not have a file extension, Unified CVP will automatically append ".wav" to the file name. If a file extension already exists, then Unified CVP will not append anything. Once the class is completed, package it and any supporting classes into a jar file. Place the jar file under the CVP_HOME\CallServer\Tomcat\common\lib folder.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
653
Localization Customization Unified CVP Support for Video Play Data (VPD) Micro-Application Localization
Step 3
Create mapping for locale to localizer class - Modify the customGrammar.properties file, located under the CVP_HOME\conf\customgrammar folder to add a mapping from the locale to the new localizer class. For example, add the following line to the end of customGrammar.properties
es-mx=com.mycompany.ES_MX_CustomLocalizer
Step 4
Deploy audio files - Copy the audio files for the locale to the IVP Server.
a.
Log in to the IVP machine as root with an SSH client, then change directory to the /home/rv/cvp folder. Create a folder under /home/rv/cvp that is named the same as the locale; for example, /home/rv/cvp/es-mx. Under /home/rv/cvp/<locale_created>, create "app" and "sys" folder and copy the audio files to the appropriate folder.
b.
c.
Step 5
Restart the Call Server for your changes to take effect - If the custom localizer class cannot be loaded for some reason, alerts will display in the Unified CVP log. For example, the following message is logged if the custom localizer class cannot be found:
IVR-1-CANNOT_INSTANTIATE_CUSTOM_LOCALIZER_CLASS: Localizer for locale: 'en-mx' class: 'com.mycompany.ES_MX_Localizer' in file: 'customGrammar.properties' could not be instantiated: Exception: java.lang.ClassNotFoundException
A possible cause for the above error is if the localizer class or jar file was not copied to the appropriate folder in Step 1, above.
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
654
Appendix B
Case#1 There are 2 downstream sites(siteA/siteB), each with 2 nodes(node1, node2), calls should be distributed evenly among all 4 downstream endpoints. 1. 9193921* siteA.node1 priority=1 weight=10 2. 9193921* siteA.node2 priority=1 weight=10 3. 9193921* siteB.node1 priority=1 weight=10 4. 9193921* siteB.node2 priority=1 weight=10
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
655
CUP Proxy Static Route Provisioning Use Cases CUP Proxy Static Route Provisioning Use Cases
Case #2 There are 2 downstream sites(siteA/siteB), each with 2 nodes(node1, node2). Calls should be distributed with 80% being split evenly between the 2 nodes at siteA, the 20% of calls to siteB should be distributed with 75% going to node1 and 25% going to node2 1. 9193921* siteA.node1 priority=1 weight=40 2. 9193921* siteA.node2 priority=1 weight=40 3. 9193921* siteB.node1 priority=1 weight=15 4. 9193921* siteB.node2 priority=1 weight=5 Case#3 There are 2 downstream sites(siteA/siteB), each with 2 nodes(node1, node2). All calls should be splilt evenly between the 2 nodes of siteA. Only if both of those nodes fail, should calls be sent to siteB, split evenly. 1. 9193921* siteA.node1 priority=1 weight=10 2. 9193921* siteA.node2 priority=1 weight=10 3. 9193921* siteB.node1 priority=2 weight=10 4. 9193921* siteB.node2 priority=2 weight=10 Case#4 There are 3 downstream nodes (node1, node2, node3), calls should be sent 50% to node1, 33% to node2, 17% to node3 1. 9193921* node1 priority=1 weight=30 2. 9193921* node2 priority=1 weight=20 3. 9193921* node3 priority=1 weight=10 Case #5 There are 2 downstream nodes (node1, node2), all calls sent to node 1, and failover to node 2 1. 9193921* node1 priority=1 weight=1 2. 9193921* node2 priority=2 weight=1 Case #6 There are 2 down stream nodes (node1,node2). Calls to 919392* should go to node1. Calls to 919393* should go to node2. There is a backup node (node3) that all calls should failover to. 1. 919392* node1 priority=1 weight=1 2. 919393* node2 priority=1 weight=1 3. 91939* node3 priority=2 weight=1
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
656
Index
configuration instructions....561
Index
abstract base class for VPD micro-application....651 accessing micro-application by specifying Run VRU Script Node....189 account, resetting password for Administrator....173 adding additional language support to VPD micro-application....652 agent avatar using Codebaby Production Studio....641 static image to audio file using Windows Movie Maker....640 videos....638 Adding metadata Video Media Server Administration....628 administering H.323 Service....353 Agent Avatar, adding using Codebaby Production Studio....641 agents partitioning in video call flow models....639 Unified CVP Video Desktop language, changing...638 AIX systems, Support Tools....252 alarm definitions for CUPS....349 API requirements for VPD micro-application....646, 648 application logging, VoiceXML....327 array formulas, ECC variable....232 ASR, type-ahead support....239 asynchronous communication H.323 Service....356 out of band communications....356 audio file names list for VPD micro-application....646 Automatic Speech Recognition for micro-applications.190 bandwidth requirements for WAN link to remote branch....437 Basic Video call flow model call flow description....560
configuring video conferencing....563 sample script....563 using....558 before you begin tasks....33 adding a Communications Manager Server....392 adding a Content Services Switch....511 adding a gatekeeper....480 adding a gateway....473 adding a media server....546 adding an ICM Server....486 adding a SIP Proxy Server....398 adding a speech server....517 adding a VXML Server....278 adding a VXML Server (Standalone)....298 applying contact center gateway debug settings....35 editing Communications Manager Server....393 installation....34 logging in to the Operations Console....165 naming schemes....34 routing calls through the network to the VRU....33 setting speed and duplex for Unified CVP....35 Blind Transfer feature configuring in H.323 Service for H.323....382 configuring in Ingress Gateway for H.323....382 configuring in Unified ICME script for H.323....382 performing H.323 blind transfers....381 using with Type 10 VRU....390 Bulk Administration menu file transfer....170 overview....170 CAC configuring for locations-based....433 configuring H.323 Service to transfer calls....436 caching
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 657
Index
configuring on the gateway....438 considerations for gateway prompt....438 properly, determining if gateway is....438 call control protocol, choosing....16 Call Director, Unified ICME, with SIP Refer Transfer featurel....403 Call Director call flow model using H.323 configuration instructions....66 Call Director call flow model using SIP configuration instructions....56 Call Director with Unified ICME call flow model configuring....54 Call Director with Unified ICMH call flow model configuring....76 call flow models Call Director, Unified ICME, with SIP Refer Transfer feature....403 Call Director with Unified ICME....54 Call Director with Unified ICMH....76 Comprehensive call flows for pre-routed calls....147 differences between video....554 NetworkVRU types....31 overview....19, 29 overview, video....554 Queue and Transfer....19 Standalone with ICM Lookup....47 VXML Server (Standalone)....38, 298 call flows Basic Video....560 Full Video....570 typical....20 WAN bandwidth required for prompts....437 calls arriving at Unified ICME through a pre-route-only NIC....148 egress gateway configuration for routing, zone-prefix method....459
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
gatekeeper configuration for routing, tech-prefix method....454 gatekeeper configuration for routing, zone-prefix method....458 Ingress gateway configuration for routing, tech-prefix method....455 Ingress gateway configuration for routing, zone-prefix method....459 originated by an ACD or call routing interface based VRU using a PG....152 originated by Cisco Unified Communications Manager....150 pre-routed through a GKTMP NIC....150 routing....453 routing, tech-prefix method....454 routing, zone-prefix method....457 survivability, configuring....423 survivability, configuring the gateway....426 survivability script, installing....424 tranferring with the Select node....452 transferring and queuing....409 transferring from agent to agent....415 transferring using SIP Service....410 transferring using Unified CVP in Comprehensive mode....409 Unified CM configuration for routing, tech-prefix method....456 Unified CM configuration for routing, zone-prefix method....461 Unified CVP configuration for routing, tech-prefix method....457 Unified CVP configuration for routing, zone-prefix method....462 VoiceXML gateway configuration for routing, tech-prefix method....455 VoiceXML gateway configuration for routing, zone-prefix method....459 Call Server communicating with VXML Server....295
Index 658
Index
configuring TLS when adding additional IVP....588 connecting to H.323 Service....356 downloading Log Messages XML file....289, 324 evaluation licensing....24 setting up with redundant proxy servers....403 uploading Log Messages XML file....291, 324 call statistics H.323 Service....340 ICM Service....333 IVR service....336 SIP Service....338 Call Studio about....240, 275 deploying scripts....245 integrating scripts with Unified ICME scripts....244 using ReqICMLabel ....241 Call Studio scripts elements in reporting data....279 call survivability examples....429 gateway configuration....426 installing the script....424 script, about....423 Capture micro-application error code settings....186 CA-signed certificates adding for HTTPS web access....259 adding to the keystore....258 using Tomcat to present to inbound HTTPS clients....264 using WebSphere to present to inbound HTTPS clients....265 Centralized Call Control with Distributed Queuing call flow model example....436 changing Unified CVP Video Desktop language....638 choosing a call control protocol....16 Cisco Developer Services Program....25
Cisco Unified CM configuration for call routing (zone-prefix method)....461 classes, creating customized grammar....652 CLI field, overriding on outgoing transfers....416 Codebaby Production Studio, adding agent avatar....641 Codecs configuration for preferred codec on Ingress gateways....471 configuration for preferred codec on VoiceXML gateways....471 command syntax, VBAdmin....359 communications, securing between VoiceXML Gateway and VXML Server....263 Communications Manager configuration for call routing (tech-prefix method)....456 configuration settings....394 configuration tasks....392 configuring H.323 Service to transfer calls....418 deleting....395 finding....395 Multiservice IP-to-IP Gateway....319 prerequisites for adding....392 prerequisites for editing....393 comparing SIP and H.323....17 components, video....555 Comprehensive call flows for pre-routed calls....147 Comprehensive call flow model using H.323 configuration instructions....99 Comprehensive call flow model using SIP configuration instructions....82 conferencing, video for Basic Video call flow model...563 configuration, DNS zone file Linux NAMED for VoiceXML Gateway....115
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 659
Index
configuration example, DNS zone file Linux NAMED for Ingress Gateway....75 configuration instructions Basic Video call flow model using SIP....561 Call Director call flow model using H.323....66 Call Director call flow model using SIP....56 Comprehensive call flow model using H.323....99 Comprehensive call flow model using SIP....82 Full Video call flow model using SIP....571 Type 3 or 7 VRU-Only call flow model....139 Type 8 VRU-Only call flow model....121 Unified CVP switch leg....153 VXML Server (Standalone) call flow model adding reporting....44 VXML Server (Standalone) call flow model without reporting....41 VXML Server (Standalone) call flow model with reporting....42 configuration parameters....189 Play Media micro-application....194 configuration settings Communications Manager....394 configuring Ingress gateway....434 configuring Unified CM Service....434 configuring Unified CVP H.323 Service....435 Content Services Switch....514 gatekeeper....483 gateway....475 ICM Server....489 IVP Server....612 media server....547 SIP Proxy Server....401 speech server....518 Video Media Server....621 configuration tabs Communications Manager....394 Content Services Switch....514
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
gatekeeper....483 ICM Server....489 IVP Server....612 media server....547 SIP Proxy Server....401 Video Media Server....621 Video Media Server Infrastructure Tab....620 VXML Server....283 VXML Server properties....282 configuring ASR/TTS Server for Call Servers....499 caching on the gateway....438 Call Director with Unified ICME call flow model...54 Call Director with Unified ICMH call flow model...76 Cisco Unified CM for call routing (zone-prefix method)....461 Cisco Unified Video Conferencing....564 CLI override....417 common Unified ICMH: defining Unified CVP ECC variables....155 Comprehensive call flow model example of Unified CVP to propagate UUI to Unified ICME....468 CSS for Call Server ....496 CVP components, with and without the Operations Console....174 determining if gateway is caching properly....438 differentiating VRUs based on dialed number....160 egress gateway for call routing (zone-prefix method)....459 gatekeeper for call routing (tech-prefix method)....454 gatekeeper for call routing (zone-prefix method)...458 gateway for call survivability....426 gateway for hookflash relay....447 gateway for Two B-Channel Transfer....449 H.323 devices and VoIP....453 H.323 Service settings for CAC....435 H.323 Service to hairpin VRU call leg....435
Index 660
Index
H.323 Service to transfer calls to CAC....436 H.323 Service to transfer calls to Unified CM cluster....418 hookflash relay for survivability....448 hookflash relay when using a Unified ICME Label node....448 Ingress gateway configuration settings....434 Ingress gateway for call routing (tech-prefix method)....455 Ingress gateway for call routing (zone-prefix method)....459 IOS voice gateway for video conferencing....564 IVP....581 IVP components for Unified CVP....579 load-balancing and failover for Full Video....589 locations-based call admission control....433 logging....326 logging and event notifications....321 network transfer from CTI OS Agent Desktop....416 network transfer from IP phone....415 Network VRU Script....188 Network VRU script for VGD micro-application...602 Network VRU script for VM micro-application....607 Network VRU script for VPD micro-application...599 Network VRU script for VPM micro-application...596 Radvision MCU for additional languages....590 Re-route on No Answer agent desk settings....419 Re-route on No Answer for Unified CVP....419 Re-route on No Answer operation for Unified CCE with Unified IP IVR....419 Re-route on No Answer operation with Unified CVP....419 Router Requery....420 secure access to the router using Protocol SSH Version 2....261 security....251 services for Call Server for CSS....497
services for MRCP ASR/TTS Servers for CSS....499 services for VXML Servers for CSS....502 setting up VXML Server connection to Call Server....317 SIP devices....397 Standalone with ICM Lookup call flow model....47 TLS when adding additional IVP to Call Server....588 Unified CCE Re-route on No Answer for Unified CVP....419 Unified CM for call routing (tech-prefix method)..456 Unified CM for video conferencing....566 Unified CM service configuration settings....434 Unified CVP for call routing (tech-prefix method)....457 Unified CVP for call routing (zone-prefix method)....462 Unified CVP switch leg, common configuration instructions....153 Unified CVP to propagate UUI to Unified ICME..467 Unified CVP with a script to transfer calls with critical application error or WAN failure....423 video conferencing for Basic Video call flow model....563 voice gateway for Call Servers....499 voice gateway for for MRCP ASR/TTS Servers....501 voice gateway for media servers....495 VoiceXML gateway for call routing (tech-prefix method)....455 VoiceXML gateway for call routing (zone-prefix method)....459 VRU-Only call flow model example of Unified CVP to propagate UUI to Unified ICME....468 VXML....273 VXML Server (Standalone) call flow model....38 connecting H.323 Service to a Call Server....355 connecting socket between IVP and Unified CVP IVR Service....584 content rule for Call Servers....497
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 661
Index
for MRCP ASR/TTS Servers....500 for Unified CVP Media Servers....493 for VXML Servers....503 Content Services Switch activating services, groups, and rules for Call Servers....499 activating services, groups, and rules for MRCP ASR/TTS Servers....501 Call Server configuration....496 configuration sample....507 configuration settings....514 configuring....510 configuring Media Server....492 content rule for Call Servers....497 content rule for MRCP ASR/TTS Servers....500 content rule for Unified CVP Media Servers....493 content rule for VXML Servers....503 deleting....513 disabling the Microsoft FTP Publishing Service....516 editing....512 executing IOS commands....515 finding....513 general approach to configuring....492 groups for Call Servers....498, 499 groups for media servers....494 groups for MRCP ASR/TTS Servers....501 groups for VXML Servers....504 http redirects....493 keepalives for Call Servers....498 keepalives for media servers....494 keepalives for MRCP ASR/TTS Servers....500 keepalives for VXML Servers....503 keepalive times....494 keepalive times for Call Servers....498 keepalive times for MRCP ASR/TTS Servers....500 prerequisites for adding....511
redundancy....507 service configuration per Call Server....497 service for MRCP ASR/TTS Servers....499 service for VXML Servers....502 supported IOS commands....515 transferring script files....516 types of services....491 voice gateway for Call Servers....499 voice gateway for for MRCP ASR/TTS Servers....501 Content Services Swtich transferring script files....288, 484 Control Center viewing device statistics....330 converting from H.323 to SIP....18 Copying Media Files Video Media Server Admininstration....627 correlation ID how it works....439 incoming UUI....439 creating customized grammar classes....652 Unified ICME applications....187 videos....639 video using Nokia Multimedia Converter....642 CSS Service, configuring per Media Server....493 CTI OS Agent Desktop, configuring network transfer.416 CUPS alarm definitions....349 customized grammar classes, creating....652 CUVC, configuring....564 CVP components, Operations Console, overview....163 CVP devices enabling security....257 CVPLogMessages.properties file....290, 322 CVPLogMessages.xml file editing....290, 322
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 662
Index
CVP scripting about....175 Capture micro-application....193 considerations for ICM Enterprise....178 data handling....182 error checking....183 Get Digits (GD) micro-application....209 Get Speech (GS) micro-application....222 information exchange....182 Menu (M) micro-application....216 micro-applications....179 Play Data (PD) micro-application....200 Play Media (PM) micro-application....194 with Call Studio....240 with ICM Enterprise....177 CVPSNMPLogger, viewing for VXML Server....319 CVP Video Desktop changing language....638 using....638 data format, Get Speech micro-application....228 data handling in scripting....182 data storage for Play Data micro-application....201 debugging tips Comprehensive call flow model....470 trace settings for the gateway....440 Unified ICME data....470 VRU-Only call flow model....469 defining Unified ICME script label for hookflash transfer...441 Unified ICME script label for outpulse transfer....440 Unified ICME script label for Two B-Channel Transfer....441 deploying scripts with Call Studio....245 with Operations Console....246 design considerations for VPD micro-application....648
desktops enabling video on CAD desktop....636 enabling video on CTI OS Agent and CTI OS Supervisor Desktops....635 enabling video on CTI Toolkit Combo Desktop (.NET)....636 Unified CVP Video Desktop....638 Device Management menu Call Server option....168 Content Services Switch....169 CUIS option....170 Device Past Configurations option....170 Device Versions option....170 Gatekeeper option....169 Gateway option....169 ICM Server option....169 IVP Server option....170 Media Server option....169 overview....168 Recording Server option....170 Reporting Server option....168 SIP Proxy Server option....169 Speech Server option....169 Unified CM option....169 Video Media Server option....169 VXML Server (standalone) option....168 VXML Server option....168 device pools adding or removing a media server....548 adding or removing a speech server....521 Device Pools adding or removing an IVP Server....613 adding or removing a Video Media Server....622 devices adding an IVP Server....611 adding a Video Media Server....618
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 663
Index
editing an IVP Server....612 editing a Video Media Server....619 viewing....330 device statistics gateway....477 viewing....330 Dialed Number Patterns, setting the expiration timeout of an outbound call....405 digit entry completion Get Digits micro-application....214 Menu micro-application....221 disabling the Microsoft FTP Publishing Service Content Services Switch....516 DNIS, restart to alternate....447 documents VoiceXML, WAN bandwidth....437 DTMF input collection, Get Speech micro-application.227 duplex, settings for Ethernet Switch/Server NIC settings....35 dynamic audio file capability....191 dynamic prompt, using....192 Early Media feature H.245 connection....470 ECC variables defining for common Unified ICMH call flow models....155 using metadata....159 video....592 egress gateways, configuration for call routing (zone-prefix method) ....459 enabling CLI override....417 video on CAD Desktop ....636 video on CTI OS Agent and Supervisor desktops..635 video on CTI Toolkit Combo Desktop (.NET)....636 endpoint limitations Unified CVP....470
endpoints, video....556 entry completion Get Speech micro-application....229 enum:TimeFormat for VPD micro-application....652 error checking in scripting....183 error codes user.microapp.error_code ECC....186, 187 VXML Server....304 error code settings Capture micro-application....186 Get Digits micro-application....186 Get Speech micro-application....186 Menu micro-application....186 Play Data micro-application....186 Play Media micro-application....186 Video Get Digits micro-application....187 Video Menu micro-application....187 Video Play Data micro-application....187 Video Play Media micro-application....187 error code settings user.microapp.error_code ECC variable for non-video....184 user.microapp.error_code ECC variable for video.186 error message playback on abnormal disconnects with SIP....405 Ethernet Switch/Server NIC settings for speed and duplex....35 events notifications, configuring....321 severity levels for....291, 323 SNMP raise/clear....349 using logs to interpret....322 event statistics viewing....329 examples
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 664
Index
call received with DNIS-provided DN....418 determining bandwidth consumed by prompts....437 DNS zone file Linux NAMED configuration for Ingress Gateway ....75 DNS zone file Linux NAMED configuration for VoiceXML Gateway....115 Get Digits micro-application configuration....211 Get Speech micro-application configuration....225 implementation (en-us) for VPD micro-application....652 Menu micro-application configuration....218 Play Data micro-application configuration....208 Play Media micro-application configuration....199 supporting Mexican-Spanish language....653 using a dynamic audio file....191 using the dynamic prompt....192 WAN bandwidth requirements in Centralized Call Control....436 exporting Operations Console certificate to a file....260 external VoiceXML error handling, Get Speech micro-application....230 file contents....237 for micro-applications....191 Get Speech micro-application....230 passing data back to Unified ICME....233 passing information....230 failover mechanisms configuring for Full Video....589 IVR Service....505 failover mechanisms, CSS....507 features, video....553 features and benefits Unified CVP....10 file configuration example for SIP messaging redundancy....162 file contents, external VoiceXML....237 file transfer
Content Services Switch....516 gateway....476 single script file at a time....288, 484 filtering metadata....633 filters for reporting VXML Server....284 Full Video call flow model call flow description....570 configuration instructions....571 configuring load-balancing and failover....589 sample script....578 using....568 gatekeeper adding....480 configuration settings....483 deleting....481 editing....482 executing commands....483 finding....479 HSRP configuration....161 prerequisities for adding....480 redundancy....161 supported IOS commands....484 transferring script files....288, 484 gatekeeper statistics....342 gatekeepers configuration for call routing (tech-prefix method)....454 configuration for call routing (zone-prefix method)....458 redundancy....462 Unified CVP in cluster example....466 using with H.323 Service....358 gateway
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 665
Index
adding....473 applying debug settings....35 configuration settings....475 configuring for Unified CVP....471 deleting....473 editing....474 executing IOS commands....476 finding....478 prerequisites for adding....473 supported IOS comamnds....476 transferring files....476 transferring script files....288, 484 viewing statistics....477 gateway statistics....344 supported IOS commands....35 gateways configuring caching....438 configuring for hookflash relay....447 configuring for Two B-Channel Transfer....449 debug trace settings....440 log, GTD values....440 prompt caching methods....438 Get Digits micro-application configuration examples....211 digit entry completion....214 error code settings....186 if no entry timeout occurs....216 Get Speech micro-application configuration example....225 data format....228 DTMF input collection....227 entry completion....229 error code settings....186 external VoiceXML....230
grammar specification....222 if no entry timeout occurs....229 grammar specification, Get Speech micro-application.222 GTD, debugging....440 H.245 connection Early Media feature....470 H.323 converting to SIP....18 using....17 H.323 devices, configuring....453 H.323 Service about alternate gatekeeper support, HSRP support.463 call statistics....340 configuration settings for CAC....435 configuring alternate gatekeeper support, HSRP support....465 configuring alternate gatekeeper support in Unified CVP, HSRP support....466 configuring blind transfer in H.323 Service....382 configuring blind transfer in Ingress Gateway....382 configuring blind transfer in Unified ICME script.382 configuring to hairpin a VRU call leg....435 configuring to transfer calls for CAC....436 configuring to transfer calls to Unified CM cluster....418 connecting to Call Server....355 connecting to the Call Server....356 debugging....418 endpoint limitations....470 HSRP support....462 media file, critical error .WAV file....356 Out of Service state....358 overview....353 performing blind transfers....381 setting Cisco Unified CM, HSRP support....463 setting gatekeeper, HSRP support....462
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 666
Index
setting gateway, HSRP support....463 setting Unified ICME, HSRP support....463 VBAdmin tool....358 H.323 vs. SIP protocol....16 Help menu about....171 contents....171 this page....171 hookflash relay configuring for survivability....448 configuring the gateway....447 configuring when using a Unified ICME Label node....448 hookflash transfer, defining a Unified ICME script label....441 HSRP support configuring H.323 Service, alternate gatekeeper support....465 configuring H.323 Service, alternate gatekeeper support in Unified CVP....466 H.323 Service....462 H.323 Service, about alternate gatekeeper support.463 H.323 Service, setting Cisco Unified CM....463 H.323 Service, setting gatekeeper....462 H.323 Service, setting gateway....463 H.323 Service, setting Unified ICME....463 http keepalives, CSS commands....494 http keepalive times....494 http redirect services....493 HTTPS securing between Unified CVP and IOS devices...268 setting up SSL....266 support....263 using Tomcat to present CA-signed certificates....264 using WebSphere to present CA-signed certificates....265 ICM Server
adding....486 configuration settings....489 configuring....486 deleting....487 editing....488 finding....488 prerequisites for adding....486 ICM Service statistics....333 importing Operations Console certificate to a gatekeeper or gateway....261 inbound call routing....453 incoming UUI configuring the gateway....439 correlation ID....439 information exchange in scripting....182 Infrastructure Settings Video Media Server....620 infrastructure statistics descriptions....331 Ingress Gateway, setting up to use redundant proxy servers....402 Ingress gateways configuration for call routing (tech-prefix method)....455 configuration for call routing (zone-prefix method)....459 configuration for preferred codec....471 installing call survivability script....424 integrating scripts Call Studio and ICME....244 interface:CustomLogger for VPD micro-application....651 IOS commands Content Services Switch....515
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 667
Index
gateway....476 gateway debug settings....35 IOS devices securing communications....260 IOS voice gateway, configuring for video conferencing....564 IP phone, configuring network transfer....415 IPSEC and Support Tools....252 IP transfer example for Unified CCE routing....416 ISDN call parameters....406 IVP configuring....581 configuring components for Unified CVP....579 configuring TLS when adding to Call Server....588 setting up TLS communication....584 IVP Server adding....611 adding and removing from a device pool....613 configuration settings....612 deleting....614 editing....612 finding....614 IVRs, types of....409 IVR Service statistics....336 IVR Service failover mechanism....505 Java API details for VPD micro-application....650 JMX communications securing....252 keepalives for Call Servers....498 times for Call Servers....498 times for MRCP ASR/TTS Servers....500 keystore and trusted certificates....253
keytool and trusted certificates....253 label definition, use with Unified CVP....452 labels definition....452 languages changing Unified CVP Video Desktop....638 configuring Radvision MCU for additional....590 example of supporting Mexican-Spanish....653 license applying to VXML Server....292 licensing Call Server, evaluation....24 port licensing....23 Reporting Server, evaluation....24 Unified CVP....23 licensing statistics....331 load balancing SIP calls....402 localizing customizing languages and prompts....645 framework for VPD micro-application....647 support for VPD micro-application....645 VPD Java API....649 locations-based call admission control, configuring....433 logging and event notifications, configuring....321 logging in Operations Console....165 logging out Operations Console....172 log messages CVPLogMessages.xml....290, 322 logs using to interpret events....322 logs, VXML Server....326
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 668
Index
main Cisco Unified Customer Voice Portal page Operations Console....166 media files critical error .WAV file (H.323 Service)....356 media server adding....546 adding and removing from a device pool....548 configuration settings....547 deleting....548 editing....547 finding....549 prerequisites for adding....546 using with Unified CVP....545 media servers configuring CSS Service....493 configuring voice gateway....495 CSS configuration....492 groups for Call Servers....498 groups for media servers....494 groups for MRCP ASR/TTS Servers....501 groups for VXML Servers....504 keepalives....494 keepalives for Call Servers....498 keepalives for MRCP ASR/TTS Servers....500 keepalives for VXML Servers....503 keepalive times....494 keepalive times for Call Servers....498 keepalive times for MRCP ASR/TTS Servers....500 multiple rules....495 Menu micro-application configuration examples....218 digit entry completion....221 error code settings....186 if no entry timeout occurs....221 menu options
for Operations Console....167 metadata adding....628 copying....627 filtering....633 localized....630 non-localized....630 sorting ....633 micro-applications....179 accessing....187 Capture....193 dynamic audio file support....191 Get Digits (GD)....209 Get Speech (GS)....222 Menu (M)....216 Play Data (PD)....200 Play Media (PM)....194 specifying Run External Script Node to access....189 using Automatic Speech Recognition and Text-to-Speech....190 using external VoiceXML....191 using for scripting....190 using video....595 My Account screen....166 network transfer script example....414 Network VRU Script configuring....188 Nokia Multimedia Converter, creating video....642 non-system components, Unified CVP....12 Operations Console configuring components with and without....174 deploying Call Studio scripts....246 logging in....165 logging out....172 main Cisco Unified Customer Voice Portal page...166 menu options....167
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 669
Index
overview....163, 164 viewing event statistics....329 Operations Console accessing Support Tools....249 out of band communications....356 outpulse transfer, defining a Unified ICME script label....440 overview, Unified CVP call flow models....29 param elements, using....231 parameter element, URL....232 partitioning, agent in video call flow models....639 passing data to Unified ICME....317 password, resetting Operations Console....173 play back types for voice data Play Data micro-application....203 Play Data micro-application configuration examples....208 data storage....201 error code settings....186 play back types for voice data....203 playing multiple audio files in Unified CVP Video micro-applications....583 Play Media micro-application configuration example, play welcome message....199 error code settings....186 port licensing....23 pre-routed calls Comprehensive call flows....147 Previewing Media File Video Media Server Administration....635 prompts proper gateway caching methods....438 retrieval....437 property file:customGrammar.properties for VPD micro-application....652
Protocol SSH Version 2, configuring secure access to the router....261 Quality of Service (QoS) for Unified CVP....22 on VXML Server....297 Queue and Transfer call flow model....31 Queue and Transfer call flow models description....19 queue and transfer to a skill group script example....412 Radvision MCU, configuring for additional languages.590 recording sessions....594 recording Unified CVP system-specific information....325 redundancy CSS....507 local SRV file configuration example for SIP messaging....162 remote services....493 Remote VBAdmin....359 removing shared media....582 reporting VXML Server....276 reporting filters for VXML Server....284 Reporting Server communicating with VXML Server....295 downloading Log Messages XML file....289, 324 evaluation licensing....24 statistics....348 uploading Log Messages XMLfile....291, 324 ReqICMLabel using to pass data....241 requirements minimal component version for Unified ICME Warm Consult Transfer/Conference to Unified CVP feature....388 VoiceXML....234 Re-route on No Answer
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 670
Index
agent desk settings configuration....419 configuring Unified CCE for Unified CVP....419 operation for Unified CCE with Unified IP IVR....419 operation with Unified CVP....419 resetting Operations Console password....173 resource properties file....290, 322 restrictions, SIP....18 Router Requery configuration....420 routing calls, Cisco Unified CM configuration zone-prefix method....461 calls, egress gateway configuration zone-prefix method....459 calls, gatekeeper configuration tech-prefix method....454 calls, gatekeeper configuration zone-prefix method....458 calls, Ingress gateway configuration tech-prefix method....455 calls, Ingress gateway configuration zone-prefix method....459 calls, tech-prefix method....454 calls, Unified CM configuration tech-prefix method....456 calls, Unified CVP configuration tech-prefix method....457 calls, Unified CVP configuration zone-prefix method....462 calls, VoiceXML gateway configuration tech-prefix method....455 calls, VoiceXML gateway configuration zone-prefix method....459 calls, zone-prefix method....457 inbound calls....453 scripting for CVP about....175 Basic Video sample script....563 Capture micro-application....193 considerations for ICM Enterprise....178
data handling....182 error checking....183 Full Video sample script....578 Get Digits (GD) micro-application....209 Get Speech (GS) micro-application....222 information exchange....182 Menu (M) micro-application....216 micro-applications....179 Play Data (PD) micro-application....200 Play Media (PM) micro-application....194 with Call Studio....240 with ICM Enterprise....177 scripts delivering H.323 incoming UUI to a Unified ICME routing script....374 incoming UUI to be delivered to Unified ICME routing....406 integrating VXML and ICME scripts....303 recording sessions using a Unified ICME....594 transferring to devices....288, 484 securing access to the router using Protocol SSH Version 2.261 HTTPS between Unified CVP and IOS devices....268 JMX communications between Unified CVP components....254 security Cisco Unified Contact Center Security Wizard....249 communications between Unified CVP and IOS devices....260 communications between VoiceXML Gateways and VXML Server....263 configuring....251 enabliing on VXML Server....295 enabling on CVP devices....257 JMX communications....252 security Support Tools....251
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 671
Index
self-signed certificate, adding....254 Service Control tool, using....356 service creation environments (script eidtors) Call Studio....175 ICM Script Editor....175 services developer....25 Session Initiation Protocol (SIP)....16 setting Call Server with redundant proxy servers....403 Ingress Gateway to use redundant proxy servers....402 speed and duplex for Ethernet Switch/Server NIC settings....35 TLS communication....584 settings, sendtooriginator in the SIP Service....404 severity log messages....290, 322 of events....291, 323 shared media, removing....582 signaling, H.323 requirements....437 SIP critical error message playback on abnormal disconnects....405 local SRV file configuration example for messaging redundancy....162 restrictions....18 using Dialed Number Patterns....405 SIP calls using Warm Transfer feature....388 SIP calls, load balancing....402 SIP Proxy Server adding....398 configuration settings....401 configuring for Unified CVP....397 deleting....399 editing....400
finding....400 prerequisites for adding....398 qualified server....398 SIP Service call statistics....338 SIP Service sendtooriginator setting....404 SIP vs. H.323 protocol....16 SNMP raise/clear events....349 raise/clear mappings....349 viewing CVPSNMPLogger for VXML Server....319 SNMP menu overview....170 system group option....170 v1/v2 option....170 v3 option....170 sorting metadata....633 specifying Run External Script Node to access Unified CVP micro-applications....189 speech server adding....518 applying a license....520 configuration settings....518 configuring for Unified CVP....517 deleting....521 editing....518, 519 finding....522 prerequisites for adding....517 speed, settings for Ethernet Switch/Server NIC settings.35 SSL CVP and Support Tools communication....251 CVP component communication....252 Standalone call flow model Standalone with Request ICM Label variation....317 Standalone call flow models VXML Server....38
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 672
Index
with ICM Lookup....47 Standalone with Request ICM Label variation....317 static images, adding to audio file using Windows Movie Maker....640 statistics gatekeeper....342 gateway....344 H.323 Service....340 ICM service....333 infrastructure....331 IVR Service....336 licensing....331 Reporting Server....348 SIP Service....338 thread pool....332 Video Media Server....624 VXML Server....345 Statistics Video Media Server....346 STNA (Support Tools Node Agents)....247 STPA (Support Tools Protocol Adapter)....248 support for VPD localization....645 Support Tools about....247 accessing from Operations Console....249 and CVP on AIX systems....252 and CVP on Windows systems....252 Cisco Unified Contact Center Security Wizard....249 overview....247 security....251 SSL....251 support for IPSEC....247 utilities supported for Unified CVP....248 switch leg, common configuration....153 syslog, using....321 system components, Unified CVP....11
system id for VXML Server....293 System menu control center option....167 device pool option....167 export system configuration option....167 import system configuration option....167 Location....168 overview....167 Realtime Database....168 service advertisement framework....168 SIP server groups....168 web services....168 system statistics licensing....331 thread pool....332 tasks, setting up Unified ICME for scripting....187 text overlay for VPD micro-application....646 Text Overlay option....599 Text-to-Speech for micro-applications....190 thread pool statistics....332 TLS communication configuring when adding additional IVP to Call Server....588 setting up....584 Tools menu configure option....170 Diagnostic Portal option....170 overview....170 SNMP monitor....170 Support Tools option....170 transferring call from agent to agent....415 calls using SIP Service....410 calls using Unified CVP in Comprehensive mode.409
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 673
Index
call with the Select node....452 transferring and queuing calls....409 transfers configuring network from CTI OS Agent Desktop....416 configuring network from IP phone....415 label script example....410 overriding the CLI field on outgoing....416 using "RFXXXX" type Unified ICME labels with Call Director, Unified ICME....403 trusted certificate adding for HTTPS web access....259 adding to the keystore....258 self-signed ....254 Two B-Channel Transfer, defining a Unified ICME script label....441 Type 3 or 7 VRU-Only call flow models configuration instructions....139 overview....139 Type 8 VRU-Only call flow models configuration instructions....121 overview of Unified ICME version....121 overview of Unified ICMH version....130 Unified CM, configuring for video conferencing....566 Unified CVP call flow models....19 configuration for call routing (tech-prefix method)....457 configuration for call routing (zone-prefix method)....462 key features and benefits....10 licensing....22 non-system components....12 system components....11 Unified CVP Quality of Service (QoS)....22 Unified ICME
creating applications to access Unified CVP micro-applications....187 passing data....317 passing data back with external VoiceXML....233 scripting....176 setting up for scripting....187 Unified ICME setup for scripting....187 Unified Presense Server (CUPS) for use with Unified CVP....398 User Management menu overview....170 user groups option....170 user roles option....170 users option....170 using 3G mobile video phone with Unified CVP Video call flow models....558 Automatic Speech Recognition and Text-to-Speech for micro-applications....190 Basic Video call flow model....558 Blind Transfer feature with Type 10 VRU....390 Cisco TelePresence with Unified CVP Video call flow models....557 Cisco Unified IP Phone 7985G with Unified CVP Video call flow models....557 Cisco Unified Personal Communicator with Unified CVP Video call flow models....557 Cisco Unified Video Advantage (CUVA) with Unified CVP Video call flow models....556 Full Video call flow model....568 H.323....17 logs to interpret events....322 param elements....231 syslog....321 Unified ICME script to record session....594 Warm Transfer feature with SIP calls....388
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 674
Index
Warm Transfer feature with Type 10 VRU....389 utilities using Support Tools....247 UUI configuring Comprehensive call flow model example Unified CVP to propagate to Unified ICME....468 configuring Unified CVP to propagate to Unified ICME....467 configuring VRU-Only call flow model example Unified CVP to propagate to Unified ICME....468 delivering H.323 incoming to a Unified ICME routing script....374 VBAdmin command syntax....359 configuration commands....361 error handling....381 logging commands....376 metric and control commands....377 mhelp....360 set command....359 show command....359 VBAdmin Tool H.323 Service....358 running locally or remotely....359 using....358 using locally....360 using remotely....361 VGD configuring Network VRU script for VGD micro-application....602 using....602 Video Get Digits micro-application error code settings....187 Video Media Server adding....618 adding and removing from a device pool....622 configuration settings....621
deleting....622 editing....619 finding....623 infrastructure settings....620 statistics....346, 624 Video Media Server Administration Adding metadata....628 copying media files....627 launching....624 preview media file....635 Video Menu micro-application error code settings....187 Video Play Data micro-application error code settings....187 Video Play Media micro-application error code settings....187 videos adding....638 call flow models, overview....554 components, overview....555 conferencing for Basic Video call flow model....563 configuring load-balancing and failover for Full Video....589 configuring Network VRU script for VGD micro-application....602 configuring Network VRU script for VM micro-application....607 configuring Network VRU script for VPD micro-application....599 configuring Network VRU script for VPM micro-application....596 creating....639 creating using Nokia Multimedia Converter....642 differences between video call flow models....554 ECC variables....592 enabling on CAD Desktop....636
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 675
Index
enabling on CTI OS Agent and Supervisor desktops....635 enabling on CTI Toolkit Combo Desktop (.NET)..636 endpoints....556 error code settings for Full Video....186 features, overview....553 micro-applications....595 micro-applications, Text Overlay option....599 recording sessions....594 setup required for playing multiple audio files in Unified CVP micro-applications....583 using 3G mobile video phone with Unified CVP Video call flow models....558 using Cisco TelePresence with Unified CVP Video call flow models....557 using Cisco Unified IP Phone 7985G with Unified CVP Video call flow models....557 using Cisco Unified Personal Communicator with Unified CVP Video call flow models....557 using Cisco Unified Video Advantage (CUVA) with Unified CVP Video call flow models....556 VGD micro-application....602 VM micro-application....606 VPD micro-application....599 VPM micro-application....595 viewing SNMP for the VXML Server....319 VM configuring Network VRU script for VM micro-application....607 using....606 voice data, play back types....203 VoiceML Service....273 voice prompts, storing....437 Voice Response Unit call leg, configuring H.323 Service to hairpin....435 VoiceXML error handling, Get Speech micro-application....230 external, Get Speech micro-application....230
file contents, external....237 passing data back to Unified ICME with external..233 passing information to the external....230 requirements....234 scripting....176 VoiceXML application logging ....327 VoiceXML filters example inclusive and exclusive....287 example wildcards....286 rules....285 VoiceXML gateways configuration for call routing (tech-prefix method)....455 configuration for call routing (zone-prefix method)....459 configuration for preferred codec....471 securing communications....263 VoiceXML logs....325 VoiceXML platform features and benefits....11 VoiceXML Service, about....274 VoIP, configuring....453 VPD configuring Network VRU script for VPD micro-application....599 VPD micro-application abstract base class:BaseLocalizer....651 API requirements....646 compiling and deploying custom localizer Java classes....648 design considerations....648 enum:TimeFormat....652 example implementation (en-us)....652 interface:CustomLogger....651 Java API details....650 list of audio file names....646 localization framework support....647
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 676
Index
localization Java API....649 property file:customGrammar.properties....652 support for localization....645 text overlay....646 using....599 VPM configuring Network VRU script for VPM micro-application....596 using....595 VRU call leg, configuring H.323 Service to hairpin....435 Run VRU Script node....189, 196 VXML configuring....273 configuring VXML Server....278 Server....273 VXML Server about....274 adding....279 applying license....292 as an add-on component....274 as a standalone component....274 communicating with Reporting Server....295 configuration properties....283 configuring....278 configuring Standalone....298 correlating logs with CVP and ICME logs....304 creating reporting filters for....284 deleting....281 downloading Log Messages XML file....289, 324 editing....280 enabling security....295 error codes....304 example filter wildcards....286 example reporting filters....287 filters for reporting....284, 296
finding....294 gateway sample configuration....310 general configuration settings....282 getting the System Id....293 integrating VXML and ICME scripts....303 prerequisites for adding....278 Quality of Service (QoS)....297 redundancy (with CSS)....504 redundancy without CSS)....505 reporting....276 rules for reporting filters....285 securing communications....263 setting up to connect to Call Server....317 Standalone solution, ICM Lookup....305 Standalone solution, withou ICM Lookup....308 Standalone solution configuration....305 statistics....345 transferring Log Messages XML file....291, 324 transferring script files....288, 484 uploading Log Messages XML file....291, 324 viewing CVPSNMPLogger....319 VXML Server (Standalone) adding....298 configuring....298 deleting....300 editing....299 finding....301 getting System ID....302 prerequisites for adding....298 VXML Server (Standalone) call flow model adding reporting configuration instructions....44 VXML Server (Standalone) call flow model without reporting configuration instructions....41 VXML Server (Standalone) call flow model with reporting
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 677
Index
configuration instructions....42 VXML Server logs about....326 correlating Unified CVP/Unified ICME logs....326 WAN bandwidth consumed by VoiceXML documents....437 contributing factors....436 Warm Transfer feature using with SIP calls....388 using with Type 10 VRU....389 Windows Movie Maker, adding static image to audio file....640 Windows systems CVP and Support Tools....252
Configuration and Administration Guide for Cisco Unified Customer Voice Portal Release 7.0(2)
Index 678