Cisco MediaSense User guide

Category
Software
Type
User guide

This manual is also suitable for

Cisco MediaSense User Guide, Release 10.5(1)
First Published: July 10, 2014
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-0883
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 UCB's 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.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned 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. (1110R)
©2014 Cisco Systems, Inc. All rights reserved.
CONTENTS
Preface
Preface ix
About this Document ix
Audience ix
Change History x
Related Documentation x
Support xi
Field Alerts and Field Notices xi
Documentation Feedback xi
Documentation Conventions xi
CHAPTER 1
MediaSense Features and Services 1
Overview 1
Network Services 2
Feature Services 2
Search and Play 3
Search for, Play, or Download a Recorded Call 4
Media Player 5
Architecture 5
Cisco Unified Communications Manager Network-based Recording 6
Unified Communications Manager Deployments 7
Cisco Unified Border Element Deployments 7
Cisco Unified Communications Manager and Cisco Unified Border Element Scenario
Differences 9
Supported Deployments 10
MediaSense Cluster Deployments 11
Single-Server Deployments 12
Dual-Server Deployments 13
Cisco MediaSense User Guide, Release 10.5(1)
iii
Three-Server Deployments 14
Four-Server and Five-Server Deployments 15
MediaSense High Availability Deployments 16
Data Replication Considerations 17
Data Replication and Recovery for Primary or Secondary Node 17
Deployment Considerations for High Availability 18
Failure Condition Considerations 18
MediaSense Requirements 19
Media Storage Requirements 19
Hardware Requirements 19
Software Requirements 20
License Requirements 20
Other Requirements 20
Port Usage 20
CHAPTER 2
Install or Upgrade MediaSense 23
Install MediaSense 23
Pre-Installation Tasks and Tools 23
Installation and Configuration Worksheet 23
Answer Files for Unattended Fresh Installations 25
Navigate the Installation Wizard 25
Installation Process 26
Install MediaSense and Unified OS 26
Post-Installation Tasks 29
Complete Setup for Primary Server 30
MediaSense Server Configuration 32
Details for Secondary and Expansion Servers 33
Finish Setup for Subsequent Servers 33
System Verification 34
Unified Communications Manager Provisioning for MediaSense 35
Setup Call Control Service Connection 35
Disable iLBC and iSAC for Recording Device 37
Reorder the G.722.1 codecs 37
Upgrade MediaSense 37
Upgrade Considerations 38
Cisco MediaSense User Guide, Release 10.5(1)
iv
Contents
Upgrade Cluster to Release 10.x(x) 39
Node Upgrade Procedures 40
Upgrade Nodes from a Local Source 40
Remote Sources 41
Upgrade Nodes Using Unified OS Administration 42
Upgrade Nodes Using Unified OS CLI 43
Rollback Cluster 44
Install COP Files 44
Language Pack 45
CHAPTER 3
Administer and Configure MediaSense 47
Access MediaSense Administration 47
Single Sign-in 48
MediaSense Administration 48
Unified Communications Manager Configuration 49
Unified Communications Manager User Information and MediaSense Setup 49
Select AXL Service Providers 49
Select Call Control Service Providers 50
Replace Unified Communications Manager Service Providers 51
MediaSense Setup with Finesse 52
Cisco Finesse Configuration 52
Provision Users for MediaSense Deployment 52
MediaSense API Users 53
API User Configuration 53
Storage Management Agent 54
Pruning Options 54
Prune Policy Configuration 55
Storage Threshold Values and Pruning Avoidance 56
System Thresholds 58
View Disk Space Use 58
Storage Use Information Obtained Using HTTP 59
Storage Use Information Obtained by Using Unified RTMT 59
Incoming Call Configuration 60
Add Incoming Call Rule 61
Edit Incoming Call Rule 61
Cisco MediaSense User Guide, Release 10.5(1)
v
Contents
Edit System Default Incoming Call Rule 62
Delete Incoming Call Rule 63
Media File Management 63
Media File Details 64
Add Media File 64
Edit Media File 65
Redeploy Media File 66
Delete Media File 66
Refresh Media File 66
Archival 67
MediaSense Server Configuration 68
Media Partition Management 68
Configure Media Partitions 69
Event Management 70
Enable Event Forwarding 70
MediaSense Setup with Cisco Unified Border Element 71
Manage Unified Communications Manager Users 71
Cisco MediaSense Provisioning for Unified Border Element 71
Unified Border Element and MediaSense Setup 72
Unified Border Element Gateway Accessibility 72
Unified Border Element View Configuration Commands 72
Global-Level Interoperability and MediaSense Setup 73
Setup Global Level 73
Dial-Peer Level Setup 75
Set up Unified Border Element Dial-Peers for MediaSense Deployments 75
Unified Border Element Deployments Log Commands 78
Access MediaSense Serviceability 79
MediaSense Serviceability 80
Trace Setup 80
Trace Files 80
Trace Log Levels 81
Trace Flags 81
Trace File Location 83
Setup Trace File Information 83
Trace File Interpretation 83
Cisco MediaSense User Guide, Release 10.5(1)
vi
Contents
Performance Logging 83
Dump Trace Parameters 84
Serviceability Tools 85
Control Center Network Services 85
Manage Network Services 85
Control Center Feature Services 86
Manage Feature Services 86
Media Service Call Control Service or Database Service Reactivation 86
Access Serviceability User Interface for Other Servers in Cluster 87
Unified RTMT Administration 87
Unified RTMT Installation and Setup 88
Download the Unified RTMT Plug-in 88
Unified RTMT Upgrade 88
Unified RTMT Multiple Copy Installations 89
Server Status Monitoring 89
Performance Monitoring Counters 89
Unified RTMT for Performance Monitoring 89
System Condition and Perfmon Counter Alerts 89
AMC Service and Unified Communications Manager Setup 92
Trace and Log Central Unified RTMT Setup 93
File Collection 94
Crash Dump Collection 94
Remote Browse Folder Names and Services 94
Perfmon Agent and Counters 95
Other Browser-Based Serviceability Tools 99
Server IP Address Changes 100
Prepare System for IP Address Change 100
Change IP Address of Primary Server 101
Change IP Address of Secondary Server 104
Change IP Address of Expansion Server 106
Change Multiple IP Addresses in a MediaSense Cluster 108
MediaSense Command Line Interface Commands 110
CLI Access 110
Utils Commands 110
utils media recording_sessions 111
Cisco MediaSense User Guide, Release 10.5(1)
vii
Contents
utils service 111
utils system maintenance 112
Run Commands 113
run db_reset_replication 113
run db_synchronization 113
Set Network Commands 113
set network cluster server ip 114
set network cluster primary ip 115
set network cluster secondary ip 115
set network ip eth0 116
Show Commands 116
show db_synchronization status 117
show network cluster 117
show tech call_control_service 118
CHAPTER 4
Troubleshoot MediaSense 119
CHAPTER 5
MediaSense Terminology 121
Playback 121
Blog Recording 122
Media Forking 122
Sessions and Recording Sessions 122
Glossary 123
Cisco MediaSense User Guide, Release 10.5(1)
viii
Contents
Preface
•About this Document, page ix
•Audience, page ix
•Change History, page x
•Related Documentation, page x
•Support, page xi
•Field Alerts and Field Notices, page xi
•Documentation Feedback, page xi
•Documentation Conventions, page xi
About this Document
The User Guide for Cisco MediaSense provides the following information:
•MediaSense features and services
•MediaSense installation and upgrade
•MediaSense administration and configuration
•MediaSense troubleshooting
•MediaSense terminology
Audience
This document is written for system administrators who have the domain-specific knowledge required to
install, set up, configure, maintain, and troubleshoot MediaSense.
System administrators need experience with or training in Java to make the best use of the capabilities of
MediaSense and of the entire Cisco Unified Communications family of products.
Cisco MediaSense User Guide, Release 10.5(1)
ix
Change History
This document may be updated at any time without notice. Obtain the latest version of this document online
at http://www.cisco.com/c/en/us/support/customer-collaboration/mediasense/products-user-guide-list.html .
Visit this Cisco.com website periodically and check for documentation updates by comparing the revision
date (on the front title page) of your copy with the revision date of the online document.
The following table lists the change history for this document.
LinkRevision DateChange
05/15/14Minor Update
Search for, Play, or Download a Recorded Call, on page 4Updated the Simple
Search method in the
Search for, play, or
download a recorded
call section.
Port Usage, on page 20Added a new port in
the Port Usage
section.
06/18/14Initial Release of
Document for
Release 10.5(1)
Cisco Unified Communications Manager Network-based
Recording, on page 6
Unified
Communications
Manager
Network-based
Recording
Archival, on page 67Archival
Other Browser-Based Serviceability Tools, on page 99Other Browser-based
Serviceability Tools
Related Documentation
LinkDocument or Resource
http://www.cisco.com/c/en/us/support/customer-collaboration/
mediasense/products-documentation-roadmaps-list.html
Cisco MediaSense Documentation
Guide
http://www.cisco.com/c/en/us/support/customer-collaboration/
mediasense/tsd-products-support-series-home.html
Cisco.com site for Cisco MediaSense
Cisco MediaSense User Guide, Release 10.5(1)
x
Preface
Change History
LinkDocument or Resource
http://docwiki.cisco.com/wiki/Category:Cisco_MediaSense
Doc Wiki for Cisco MediaSense
http://www.cisco.com/c/en/us/support/customer-collaboration/
mediasense/products-troubleshooting-guides-list.html
Troubleshooting tips for Cisco
MediaSense
Support
For information on obtaining documentation, submitting a service request, and gathering additional information;
see the monthly What's New in Cisco Product Documentation page, which also lists all new and revised
Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to 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.
Cisco currently supports RSS Version 2.0.
Field Alerts and Field Notices
Note that Cisco products may be modified or key processes may be determined important. These are announced
through use of the Cisco Field Alert and Cisco Field Notice mechanisms. You can register to receive Field
Alerts and Field Notices through the Product Alert Tool on Cisco.com. This tool enables you to create a profile
to receive announcements by selecting all products of interest.
Log into www.cisco.com and access the tool at: http://www.cisco.com/cisco/support/notifications.html.
Documentation Feedback
You can provide comments about this document by sending an email to the following address:
We appreciate your comments.
Documentation Conventions
This document uses the following conventions:
DescriptionConvention
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.
boldface font
Cisco MediaSense User Guide, Release 10.5(1)
xi
Preface
Support
DescriptionConvention
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.
italic 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>
window font
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.
< >
Cisco MediaSense User Guide, Release 10.5(1)
xii
Preface
Documentation Conventions
CHAPTER 1
MediaSense Features and Services
•Overview, page 1
•Network Services, page 2
•Feature Services, page 2
•Search and Play, page 3
•Media Player, page 5
•Architecture, page 5
•Cisco Unified Communications Manager Network-based Recording, page 6
•Unified Communications Manager Deployments, page 7
•Cisco Unified Border Element Deployments, page 7
•Supported Deployments, page 10
•MediaSense Cluster Deployments, page 11
•MediaSense High Availability Deployments, page 16
•MediaSense Requirements, page 19
•Port Usage, page 20
Overview
MediaSense is the media-capture platform for Cisco Unified Communications. It can be used to record calls
in Cisco and non-Cisco contact centers; however, non-Cisco contact centers must use the Cisco Unified Border
Element as the ingress point.
MediaSense can be used by compliance recording companies whose regulatory environment requires all
sessions to be recorded and maintained. These recordings can later be used by a compliance auditor or a
contact center supervisor to resolve customer issues or for training purposes. The recordings can also be used
by speech analytics servers or transcription engines.
MediaSense uses Unified Communications Manager to provide user-authentication services. It uses Web 2.0
application programming interfaces (APIs) to expose its functionality to third-party customers to enable them
to create custom applications. The product is supported on Microsoft Windows 7 and the Apple Mac OS.
Cisco MediaSense User Guide, Release 10.5(1)
1
Network Services
Network services include the following:
•Cisco MediaSense Administration: Enables you to configure MediaSense using a graphical user
interface.
•Cisco MediaSense Serviceability Administration: Enables you to configure the MediaSense
Serviceability application using a graphical user interface.
•System Service: Enables you to control service operations within the MediaSense clusters. This service
manages the clustering and setup functionality for the secondary server and expansion servers.
•Perfmon Agent: Enables you to control the performance monitoring infrastructure within the MediaSense
Serviceability Administration interface. The Java Management Extensions (JMX) technology, which
allows you to manage and monitor applications and other system objects, is represented by objects called
Managed Beans (MBeans). The Perfmon Agent retrieves the counter values from the JMX MBeans and
writes them to the Unified Communications Manager database.
•Diagnostics Service: Enables you to troubleshoot and debug MediaSense. This service is available in
all MediaSense servers.
In the MediaSense and Unified OS user interfaces, each MediaSense service name is preceded by the product
name. To avoid redundancy in this document, service names are sometimes referred to without the preceding
product name.
Network services are started automatically after installation in each server in the cluster. If advised to do so
by Cisco support personnel, network services can be stopped.
Feature Services
MediaSense contains the following feature services:
•Configuration Service: saves and updates all changes made to the MediaSense configuration database.
Each multiple-server cluster can have only two instances of the configuration service, one instance is
in the primary server and the other instance is in the secondary server. If a cluster has more than two
servers, the expansion servers cannot have a configuration service.
•API Service: processes API requests and enables communication between the user interface and the
server. You can enable the API service only after the database service is enabled. Each multiple-server
cluster can have only two instances of the API service, one instance is in the primary server and the
other instance is in the secondary server. If a cluster has more than two servers, the expansion servers
do not have an API service.
•Database Service: contains and controls the meta database and the configuration database. Each
multiple-server cluster can only have two instances of the database service, one instance is in the primary
server and the other instance is in the secondary server. Each server writes data only to its local database.
The primary and secondary servers interact to synchronize data.
•Storage Management Agent (SM agent): monitors the overall storage in each server in the cluster and
generates threshold events based on disk usage. This service is available in all servers and should be
activated before the media service and call control service.
Cisco MediaSense User Guide, Release 10.5(1)
2
MediaSense Features and Services
Network Services
•Media Service: receives, saves, and plays back media. The media service must be enabled before the
call control service. This service is available in all servers in the cluster.
•Call Control Service: coordinates call receiving and recording. The call control service can only be
enabled if the media service is already enabled. This service is available in all servers in the cluster. The
call control service is referred to as a SIP trunk in the Unified Communications Manager user interface
and Unified Communications Manager documentation.
All feature services are installed on the primary and secondary nodes (servers) in a cluster. Expansion nodes
have only the media service, call control service, and SM agent.
Search and Play
After MediaSense is installed and configured, use the Search and Play application to search for specific media
files, play them, or download them to your desktop.
Access the Search and Play application from
•a Firefox or IE browser at URL https://<hostname>:8440/mediasense
or
•Click the Cisco MediaSense Search and Play link from the main MediaSense access window at URL
http://<MediaSense hostname>.
Before launching Search and Play, you need to install the 32-bit version of JDK on 32-bit Windows
machine, the 64-bit version of JDK on 64-bit Windows machine, and the 64-bit version on Macs. Also,
ensure that you have JDK7 update 25 or later installed.
Note
The MediaSense media player is implemented as a downloadable Java application. Due to recent security
enhancements in Java, users have to accept a pop-up security warning every time the Java application is
executed; meaning that users must accept a security warning every time a recording is played.
Because the application does not run as part of the browser executable, it is subject to the security requirements
of the Java Virtual Machine (JVM) that is installed on the user's computer (rather than those of the browser).
A troubleshooting tip provides instructions for setting up each client desktop where Search and Play is executed
to avoid the warning (http://docwiki.cisco.com/wiki/Administration:_Search_and_Play_application_users_
encounter_security_warning_before_each_playback#Search_and_Play_application_users_encounter_security_
warning_before_each_playback).
The media player takes longer to start in IE than in Firefox. IE users may also see an option to open a
downloaded jnlp file.
Note
When prompted for login credentials, use the API user credentials defined on the MediaSense API User
Configuration page of the Administration application.
You are logged out from the Search and Play application if the session remains idle for 30 minutes.Note
Cisco MediaSense User Guide, Release 10.5(1)
3
MediaSense Features and Services
Search and Play
Search for, Play, or Download a Recorded Call
There are multiple ways to search for the recorded media files in the Search and Play window.
Procedure
Step 1 When you first access the Search and Play application, the page opens to the Recent Calls default search
results (all calls within last 7 days). You may select the Recent Calls or Active Calls searches by clicking
those tabs at any time.
Step 2 For a simple search, enter either a participant identifier or a tag in the search box and click Search.
For participant Id, enter the complete value of the identifier. To search for multiple participants, use a space
to separate each entry; the delimiter is considered as an OR operator.
For tags, you can enter one or two letters as a complete value is not required. For more information, refer
Tags in Advanced Search (Step 3).
Use a space to separate each entry; the delimiter is considered as an OR operator. By default, the simple search
returns calls within the last 7 days.
Step 3 For an advanced search, enter values in any of the search parameters from the Search Recordings drop-down
menu.
The search properties include:
•Session ID—The identifier of a recording session with one or more tracks associated with it. Enter a
session identifier in the text box. Only one SessionId can be searched at a time.
•Participant(s)—The identifier for recording session participants which is a phone extension. Enter a
participant identifier in the text box. Multiple participants can be searched by separating the identifiers
with a comma. When multiple participants are defined, the search returns only those calls containing all
of the participants (the delimiter is treated as an AND operator).
•Tag—Enter any text. Searches for tags are treated as CONTAINS, so entering a single letter results in
all tags that contain that letter. Spaces used in the search box are considered part of the value being
searched, not as a delimiter. Therefore, searching for two words separated by a space returns only those
calls with a tag containing both words separated by a space.
•XRefCI—The recording session identifier. Enter a recording session identifier in the text box. Only one
XRefCI can be searched at a time.
•CCID—The identifier of an individual track within a recording session. Enter a track identifier in the
text box. Only one CCID can be searched at a time.
•Range—The date the recording session started. Select to search Within a specific time frame or Between
a range of dates. If no time frame is selected, the system defaults to within the last 7 days.
When selecting a range of times, choose short time periods. Searches that result in large numbers of
recordings may take an exceptionally long time to process and impacts system performance.
•Duration—Select a time unit, then use the slide bar to select the interval amount for the recorded session
in seconds, minutes, or hours.
•Show—Use the check boxes to indicate if you want to search for completed calls, active calls, or calls
with recording errors.
Cisco MediaSense User Guide, Release 10.5(1)
4
MediaSense Features and Services
Search for, Play, or Download a Recorded Call
Step 4 Click Search.
•Click the Sort by drop-down menu to sort the files by age or duration.
•Click the download icon to download a recording.
•Click the Expand Call icon to view the strongly associated recording sessions displayed in the Associated
Session box. Strongly associated sessions have at least one common xRefci value. Each session in the
displayed list can be individually played or downloaded.
MediaSense 10.5 supports call association for the Built-in-Bridge
recordings.
Note
•Click the play icon to play a recording.
•Users can select the number of results to display on each page and step through the result pages using
the Previous and Next buttons.
When exiting the media player, users may receive a warning stating that the 'MediaSense player quit
unexpectedly while using the lib... plug-in'. This warning may be reported as an error, but it is not
an error and can be disregarded.
Note
Media Player
MediaSense has an inbuilt media player in the Search and Play application to play a recording. To run the
media player, you should have the updated Java version (For Java version, refer the Web Browsers section in
the Cisco MediaSense Design Guide at http://www.cisco.com/c/en/us/support/customer-collaboration/
mediasense/products-implementation-design-guides-list.html). The track slider displays the progress of the
audio/video recordings. The slider can be dragged to right to forward or left to rewind the recording being
played.
When a recording finishes, and you want to replay it, drag the slider back to the starting point, however, it
should be done in less than 30 seconds. After 30 seconds, the playback session ends and the player get closed.
You can increase/decrease the volume by dragging the slider on the Volume bar.
Limitations of the media player:
•Time is not displayed while you drag the slider for rewind or forward.
•Pause button does not automatically convert to the Play button after a recording ends.
•Media Player session gets aborted if the Play and Pause button is clicked more than twice after the slider
reached the end of the playback stream.
•During a playback session, when you click any point to rewind/forward, the track slider moves nearby
the clicked point but not the exact point.
Architecture
MediaSense is part of the solution for Unified Communications and runs on Cisco Unified Operating System,
Release 9.0.
Cisco MediaSense User Guide, Release 10.5(1)
5
MediaSense Features and Services
Media Player
MediaSense architecture contains the following components:
•Application layer:
â—¦The Search and Play application allows you to play back recordings.
â—¦APIs support real-time recording controls (such as hold, pause, and resume) for third-party
applications.
â—¦Application and media APIs incorporate requirements from various industry partners and are
published for use by third-party applications.
â—¦The API Service provides web service interfaces to enable applications to search for and retrieve
recordings and associated session history and metadata. This metadata information is stored in the
Meta database.
•Media processing layer:
â—¦The media service terminates media streams to be stored on a local disk for archiving and playback.
â—¦Running media service on all the servers in a deployment allows for load balancing.
•Network layer:
â—¦Gateway and session border controller (SBC) media forking and media forking at endpoints.
â—¦Integration with Cisco Unified Communications Manager (Unified Communications Manager)
for audio recording.
â—¦Integration with Cisco Unified Border Element (Unified Border Element) for audio and video
recording.
Cisco Unified Communications Manager Network-based
Recording
With Unified Communications Manager network-based recording (NBR), you can use a gateway to record
calls. NBR allows the Unified Communications Manager to route recording calls, regardless of device, location,
or geography.
With NBR, call recording media can be sourced from either the IP phone or from a gateway that is connected
to the Unified Communications Manager over a SIP trunk. Unified Communications Manager dynamically
selects the right media source based on the call flow and call participants.
NBR offers an automatic fallback to Built-in-Bridge (BiB) when the Integrated Services Routers (ISR) are
unavailable as no separate recording configuration is required. This is useful in cases where customers want
to include agent-agent consult calls in the recording policies as Unified Border Element cannot record consult
calls, so BiB needs to be enabled separately.
For more information on Unified Communications Manager NBR, refer to Features and Services Guide for
Cisco Unified Communications Manager at http://www.cisco.com/c/en/us/support/unified-communications/
unified-communications-manager-callmanager/products-maintenance-guides-list.html
Cisco MediaSense User Guide, Release 10.5(1)
6
MediaSense Features and Services
Cisco Unified Communications Manager Network-based Recording
Call Correlation
Both NBR and BiB calls can be correlated using xRefci, which is available from Unified Communications
Manager JTAPI; CISCO-GUID is not needed, which means neither CTI server nor CTIOS connections are
required. As there is a single correlation identifier, correlation across components is stronger and can be done
in a uniform way independent of the call flow. Using NBR, directly-dialed as well as dialer-initiated outbound
calls can be correlated with their appearance in other solution components. Using NBR, TDM gateway
recording is automatically used without splitting the capacity of the router.
MediaSense 10.5(1) does not support TDM gateway recording.Note
Unified Communications Manager Deployments
Unified Communications Manager must be configured appropriately to direct recordings to MediaSense
recording servers. This includes configuring a recording profile, various SIP parameters, and, because
MediaSense uses the Administrative XML layer (AXL) to authenticate users, the Unified Communications
Manager AXL service must be enabled on at least one of its servers.
A basic Unified Communications Manager deployment for MediaSense requires one of the phones to be
configured for recording. If both phones are configured for recording, two separate recording sessions are
captured. Media forked by a phone is sent to the recording device where the forked streams are captured. See
the Cisco MediaSense Design Guide at http://www.cisco.com/en/US/products/ps11389/products_
implementation_design_guides_list.html for further details.
All Cisco IP Phones that MediaSense supports have a built-in bridge (BIB) that allows incoming and outgoing
media streams to be forked. MediaSense makes use of this capability to record inbound and outbound forked
media. For more details about media forking, see the Unified Communications Manager documentation at
http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html.
Cisco Unified Border Element Deployments
Cisco Unified Border Element (Unified Border Element) is the Cisco session border controller (SBC) gateway
that facilitates connectivity between independent VoIP networks by enabling SIP, H.323, VoIP, and video
conference calls from one IP network to another.
MediaSense integrates with Unified Border Element to enable recording without regard to the endpoint type.
Because of this capability, MediaSense can use Unified Border Element to record inbound and outbound
media.
See the Unified Border Element documentation for more information about Unified Border Element.
•Generic Unified Border Element configuration details are found at http://www.cisco.com/en/US/docs/
ios/ios_xe/voice_cube_-_ent/configuration/guide/cube_ent/vb_book_xe.html.
•Specific recording configuration details are found at http://www.cisco.com/en/US/docs/ios-xml/ios/
voice/cube_proto/configuration/15-2mt/cube-network-based.html.
The following figure illustrates a MediaSense deployment with Unified Border Element. Even in a Unified
Border Element deployment, MediaSense depends on Unified Communications Manager to provide
authentication services.
Cisco MediaSense User Guide, Release 10.5(1)
7
MediaSense Features and Services
Unified Communications Manager Deployments
In the preceding illustration, the real time protocol (RTP) carries voice data between the endpoints and Unified
Border Element. The session initiation protocol (SIP) carries call signaling information between the endpoints
and Unified Border Element. Two RTP unidirectional streams represent two audio streams forked from Unified
Border Element to MediaSense. Streams from Unified Border Element to MediaSense are unidirectional
because only Unified Border Element sends data to MediaSense; MediaSense does not send any media to
Unified Border Element. Unified Border Element has three dial-peers: inbound, outbound, and forking. (See
Dial-peer level setup for more information.)
Typically, Unified Border Elementcan fork only SIP-to-SIP calls. However, because you can use the same
Cisco router as both a TDM-to-IP gateway and a media-forking device for call recording, you can also record
incoming TDM or analog calls—if you have the required licensing and an appropriate IOS version. (For more
information, see the Unified Border Element documentation at http://www.cisco.com/go/cube.)
To use this feature, you must enable both gateway and border-element functionality in the device. You can
configure the gateway to receive the TDM or analog call and then to feed the call back to itself as a SIP call
with a different dialed number. When you configure this loop, the router actually handles each call twice.
(This cuts the router capacity in half and Unified Border Element can process only half as many calls.) For
more information, see the Media forking on a TDM gateway section in the Cisco MediaSense Developer
Guide at http://www.cisco.com/en/US/products/ps11389/products_programming_reference_guides_list.html
and the MediaSense FAQ article at http://docwiki.cisco.com/wiki/FAQs_for_Cisco_MediaSense#How_to_
Configure_a_TDM_Gateway_for_Media_Forking.
Cisco MediaSense User Guide, Release 10.5(1)
8
MediaSense Features and Services
Cisco Unified Border Element Deployments
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138

Cisco MediaSense User guide

Category
Software
Type
User guide
This manual is also suitable for

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI