Configuring BT ITS media recording

Media recording involves the BT Heartbeat and Directory service which acts as a proxy/mediator between the Media Recorder and the BT ITS IPSI system. Once the recorder service is started, it controls the state of the BT services as well, i.e. it starts/stops and monitors their state. When the BT service is up, it periodically checks the recorder service for TTPs in interest and establishes PWE3 streams to media ports provided by the recorder service. The configuration consists of configuring the BT services and Media Recorder (Unified Recorder service).

Prerequisites

  • Create NICs as per failover/redundancy requirements and configure static IP routing

  • Install BT Voice Recorder Heartbeat service (3.0.0 or newer)

  • Create c:\ITS\TFTP_Root\local_ipconfig.txt

The ITS Heartbeat Voice Recorder Service and the ITS Directory Service must set with "manual" startup mode (default after installation). Do not change it to automatic or disabled.

The local_ipconfig.txt file

The config file should enumerate the friendly name of NICs. It tells the BT services which NICs should be used for specific network communications

Example for unicast setup

[Adapters]
ITSdataLan=Management LAN
ITSVoiceLanA=VLAN A
ITSVoiceLanB=VLAN B
[Physical]
CardId=VoiceRecorder

[Unicast Directory Services]
VoiceRecorder=ds_proxy.1,ds_proxy.2

Example for multicast setup

[Adapters]
ITSdataLan=Management LAN
ITSVoiceLanA=VLAN A
ITSVoiceLanB=VLAN B
[Physical]
CardId=VoiceRecorder

The global_ipconfig.txt file

This file is provided by the ITSProfile server via TFTP share and is populated automatically by the recorder service at startup. Please make sure the following setting is present:

[VR]
SwapTTPonHealthy=false

Configuring the Unified Recorder service

Mandatory configuration steps

Related configuration can be found under Unified Call Recorder\BT ITS\IPSI

Active the Unified Call Recorder service on the Recording Servers

Step 1 - In the Verba Web Interface go to System \ Servers

Step 2 - Select the Recording Server from the list

Step 3 - Click on the Service Activation tab

Step 4 - Activate the Verba Unified Call Recorder Service by clicking on the  icon.

Step 5 - Repeat the steps on all Recording Servers (all servers with either a Media Recorder or Recording Director role or both)  if there are multiple.

Configure the Media Recorder servers

Step 1 - In the Verba Web Interface go to System \ Servers

Step 2 - Select the Recording Server from the list

Step 3 - Click on the Change Configuration Settings tab and navigate to Unified Call Recorder / Recording Providers / BT ITS/IPSI

Step 4 - Enable Media Recorder mode at Recording Server Role

Step 5 - Configure TTP Codec as per BT side codec being used (TTP Codec)

Step 6 - Configure the IPv4 address of the IPSI Management VLAN NIC at Management VLAN IP*. If the setting is empty, it defaults to "Network \ System \ Server IPv4 Address".

Step 7 - Configure the IPv4 address of the IPSI Voice A VLAN NIC at Voice VLAN1 IP*. If the setting is empty it defaults to "Network \ System \ Server IPv4 Address".

Step 8 - Configure the IPv4 address of the IPSI Voice B VLAN NIC at Voice VLAN2 IP*. If the setting is empty it defaults to "Network \ System \ Server IPv4 Address".

Step 9 - Configure the TFTP address(es) of the ITS Profile server at IPSI TFTP1/2 URL**,  where the global_ipconfig.txt file is shared.

Step 10 - Review the Media Recorder and Media Processing configuration. For more information on voice activity detection and call splitting, see Configuring voice activity detection and call splitting for trader voice recording.

Step 11 - Save the changes by clicking on the  icon.

Step 12 - A notification banner will appear on the top. Click on the click here link, so you will be redirected to the Configuration Tasks tab. Click on the Execute button in order to execute the changes.

Step 13 - Click on the Service Control tab.

Step 14 - Start the Verba Unified Call Recorder Service by clicking on the  icon.

Step 15 - Repeat the steps on all Media Recorder servers.

* Addresses must be consistent with the NIC names provided in local_ipconfig.txt.

** At least one TFTP URL is required. The config file is retrieved at service startup. If it cannot be retrieved then the previous local copy is used and alert is raised.

Configure the Recording Director servers

Step 1 - In the Verba Web Interface go to System \ Servers

Step 2 - Select the Recording Server from the list

Step 3 - Click on the Change Configuration Settings tab and navigate to Unified Call Recorder / Recording Providers / BT ITS/IPSI

Step 4 - Enable Recording Director or Recording Director & Media Recorder mode under Recording Server Role. In case both Recording Director and Media Recorder roles are required, configuring the Media Recorder component as well.

Step 5 - Configure the list of the Voice Recorder IDs (previously configured on the BT side) the service should handle. It must contain both primary and secondary IDs in case of 2N recording.

Step 6 - Set 2N mode depending on the deployment architecture at IPSI / Media Recording 2N Mode.

Step 7 - In case it is a Standby Recording Director, define the API address of the Active Recording Director at Active TTP Manager. 

If TTP Manager redundancy is configured (standby Recording Director), there must be a very stable network connection between the two hosts. NIC teaming or crossover cable connection is required. If the network is lost between the two servers but both have an active connection to the BT infrastructure and to the Media Recorder servers, it could lead to unexpected situations and possible media loss, because both Recording Directors will actively try to control TTPs.

Step 8 - Save the changes by clicking on the  icon.

Step 9 - A notification banner will appear on the top. Click on the click here link, so you will be redirected to the Configuration Tasks tab. Click on the Execute button in order to execute the changes.

Step 10 - Click on the Service Control tab.

Step 11 - Start the Verba Unified Call Recorder Service by clicking on the  icon.

Step 12 - Repeat the steps on all Recording Director servers.

Configuration reference

NameDescription
Recording Server RoleDefines the role of the server:
  • Recording Director: deals only with TTP management only, it distributes and moves TTPs across media recorders
  • Media Recorder: deals only with media recording. It receives TTPs to be handled from the Recording Director, establishes PWE3 streams via BT Heartbeat and Directory services and creates media records on the channels we are interested in
  • Recording Director + Media Recorder: includes both functionality

For Recording Director functionality either TMS or LDAP based BT ITS platform provisioning and Voice Recorder IDs must be configured

Voice Recorder IDsNew line separated list of the Voice Recorder IDs configured in the BT ITS switch. The Recording Director will allocate only the TTPs to the Media Recorder(s) which are assigned to the configured Voice Recorder IDs in the BT ITS configuration.
TTP CodecVoice codec which is being used to compress voice streams, it can be G.711 A-Law or U-Law
IPSI / Media 2N Recording Mode

Defines if this Recording Director should deal with primary or secondary TTPs for 2N recording, or no 2N recording is configured. The following valid values apply:

  • Disabled
  • Primary
  • Secondary
Active TTP Manager

Defines the IP address / hostname (and port number) of the active Recording Director in case it is a Standby Recording Director. The standby Recording Director monitors the state of the active Recording Director and once there is no connectivity, it takes control over for TTP management across the Media Recorders.

In case the default API port (10031) is configured on the active Recording Director, only the IP address /hostname has to be defined.

In case the API port is not the default 10031 on the active Recording Director, define the port number as well: ip_address_or_hostname:port

Management VLAN IPIPv4 address of the NIC connecting IPSI management LAN. If it is not defined, it defaults to Server Local IPv4 address configuration.
Voice VLAN1 IPIPv4 address of the NIC connecting IPSI VLAN A. If it is not defined, it defaults to Server Local IPv4 address configuration.
Voice VLAN2 IPIPv4 address of the NIC connecting IPSI VLAN B. If it is not defined, it defaults to Server Local IPv4 address configuration.
Number of Media Processing ThreadsNumber of media processing threads to be used by the Media Recorder component
BT Heartbeat Listening PortUDP port on which the Media Recorder listens to BT Heartbeat Service requests
TTP Timeout (seconds)Defines media timeout in seconds on a TTP. After the timeout value, it is considered unhealthy and, if possible, the Recording Director moves the TTP to another Media Recorder.
TTP Distribution Timer (seconds)Defines how often the Recording Director checks the state of the TTPs on the Media Recorders and changes TTP allocation when needed. The value should be set to TTP Timeout / 2 or less.
BT Heartbeat Service Timeout (seconds)The timeout value in seconds for the BT Heartbeat service. The Media Recorder controls when the BT Heartbeat and Directory services should start and stop and also monitors their state. If the BT service is not responding within the configured timeout value, the BT services will be restarted to recover from error states.
IPSI TFTP 1 URLTFTP address on the IT Profile server where the global_ipconfig.txt is downloaded from.
tftp://itslnkserver/global_ipconfig.txt
IPSI TFTP 2 URLTFTP address on the IT Profile server where the global_ipconfig.txt is downloaded from.
tftp://itslnkserver/global_ipconfig.txt