Unified Call Recorder service configuration reference for Cisco network based recording

Configuration Parameter NameDescription

Secondary Recording Service

If set to Yes, the service will be marked as secondary. In this case, the conversations recorded by the service will be hidden by default in the Search menu.

Media Recorder

The following table provides detailed instructions on each configuration setting:

Configuration Parameter NameDescription

Unified Call Recorder \ Media Recorder \ Incoming Connection

UserThe username for authenticating the connection between the local Media Recorder and the Recording Directors.
PasswordThe user password for authenticating the connection between the local Media Recorder and the Recording Directors.
PriorityDefines the priority of the local Media Recorder to provide weighted load balancing among the configured recorders.
PortThe port number used for the Recording Director connections.
Unified Call Recorder \ Media Recorder \ Basic
Media Recorder EnabledEnables the Media Recorder component in the service. If the server is deployed as a Recording Director, this componentneedto be disabled.
Automatic Gain Control EnabledThe application automatically controls the gain in the audio file to provide more convenient user experience while listening back recordings
Audio FormatThe recorder application will use the selected file format and codec option to store the audio/voice conversations.
Video FormatThe recorder application will use the selected file format and codec option to store the video conversations.
Bidirectional/Stereo RecordingEnables creation of dual channel audio files (one channel for calling party, one channel for called party). Certain file format and codec options do not support stereo recording.
Call Timeout (seconds)Defines the call timeout value in seconds, which is used to terminate the call recording automatically if the last RTP packet is received before this value.
Media Port Range BeginDefines the beginning of the media port range used by the application to receive RTP streams from the UC platform.
Media Port Range EndDefines the end of the media port range used by the application to receive RTP streams from the UC platform.
Voice Activity StatisticsEnabled silence and talk-over detection.
Unified Call Recorder \ Media Recorder \ Advanced
Database Cache FolderThe path to the database cache folder without the name of the file. Use the icon to select the folder.
Skip Calls Without MediaWhen enabled, the system will not create a database record for calls without any media.
Media Format Fallback EnabledWhen enabled, the system is able to fall back to raw stream recording if certain codecs are detected toavoiddrasticdecrease in quality.
PCM Mixer Buffer Length (milliseconds)Length of the mixer buffer in milliseconds.
RTP Stream Reorder Buffer Length (packets)Size of the RTP packet capture/receiver buffer in packets used for RTP packet reordering.
Write XML MetadataEnables XML-based CDR/metadata file generation, written next to the media files. These files can be used later if the database crashes and cannot be recovered. These files are also used for various integration options.
SSL/TLS CertificatePath to the SSL/TLS certificate file used for the encryption of the communication between the Media Recorder and the Recording Director components. When the server roles are co-located, both components use the same configuration setting.
SSL/TLS KeyPath to the SSL/TLS key file.
SSL/TLS Key PasswordPassword for the SSL/TLS key.
Unified Call Recorder \ Media Recorder \ JTAPI Integration
Cisco JTAPI Integration EnabledEnables the integration with the Cisco JTAPI Service component.
Cisco JTAPI ServicesThe IP address or hostname of the Recording Director servers where the Cisco JTAPI Service is enabled. Multiple addresses can be configured.
Unified Call Recorder \ Media Recorder \ Overload Thresholds
Concurrent CallsLimitation on the maximum number of calls recorded by the server. When the threshold is reached, the system will notify the Recording Director component to stop assigning calls to the server.
CPU (%)Limitation on the maximum CPU load (%) on the server. When the threshold is reached, the system will notify the Recording Director component to stop assigning calls to the server.
Network (%)Limitation on the maximum network load (%) on the server. When the threshold is reached, the system will notify the Recording Director component to stop assigning calls to the server.
Disk Space (%)Limitation on the minimum free disk space (%) on the server. When the threshold is reached, the system will notify the Recording Director component to stop assigning calls to the server.

Disk Space (mbyte)

Limitation on the minimum free disk space in megabytes on the server. When the threshold is reached, the system will notify the Recording Director component to stop assigning calls to the server.

Recording Providers

The following table provides detailed instructions on each configuration setting:

Configuration Parameter NameDescription

Unified Call Recorder \ Recording Providers \ General

Internal Domain, Numbers Pattern

Regular expression to describe the internal numbers/domains in the organization. The system uses the setting to identify the direction of the recorded conversation (internal, outgoing, incoming, external).

In multi-tenant environments, if an internal pattern regular expression is defined in both the environment and the Unified Call Recorder service configuration, the pattern specified in the environment configuration is used to determine the internal values, not the pattern defined in the Unified Call Recorder service configuration.

For more information, see Conversation direction detection using internal domain and number patterns.

SIP URI Modification

The following valid value apply:

  • Do not modify SIP addresses - The system will not modify the SIP URIs and will insert the URIs as they appear in the SIP signaling messages to the database.
  • Remove domain part - The system will remove the domain part from all SIP URIs. E.g. john.doe@contoso.com -> john.doe
  • Remove domain part for numbers only - The system will remove the domain part for SIP URIs containing a phone number only. Other SIP URIs will not be updated. E.g. +1234778899@contoso.com -> +1234778899
Use Recording RulesWhen enabled, the system will only record configured extensions.
Unified Call Recorder \ Recording Providers \ Remote Media Recorders
Remote Media Recording Servers

List of remote Media Recorders connected to the Recording Director. Click on the icon to add a new server using the form on the right.

  • Protocol - The protocol used between the Media Recorder and the Recording Director. 

  • User - The user name configured for the connection. It has to match the value configured under Unified Call Recorder \ Media Recorder \ Incoming Connection \ User on the Media Recorder.

  • Password - The user password configured for the connection. It has to match the value configured under Unified Call Recorder \ Media Recorder \ Incoming Connection \ Password on the Media Recorder.

  • Host - Hostname of the Media Recorder selected from the list of available Recording Servers.

  • Port - Port number used for the communication on the Media Recorder.
  • Priority - Defines the priority of the Media Recorder to provide weighted load balancing among the configured recorders.
Connection Keepalive Interval (seconds)Keep aliveinterval in milliseconds between the Media Recorder and the Recording Director.
Unified Call Recorder \ Recording Providers \ SIP/SIPREC
SIP PortThe port number used for SIP communication. It has to match the valueconfiguredattheUC platform.
Secure SIP PortsSecure SIP ports with custom SSL/TLS certificate options. Click on the icon to add new secure SIP ports using the form on the right.
Cisco Partition Based Multitenant ProcessingWhen enabled, the system will use the partition information received from the Cisco JTAPI service to identify the tenant. It only works when the JTAPI integration is enabled.
Prefer Session Local RefreshingSIPkeepalivepreferredrole.
Session ExpiresTimer (seconds)SIP sessionkeep alivetimer.

SIP Trunk Status Monitoring

When enabled, the system sends alerts ifthereisnoSIP OPTIONS ping request on the SIP trunk.