Reference13r2:Concept App Service Recordings: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
Line 98: Line 98:


=== License Changes ===
=== License Changes ===
With V13r2 required License Type for the Recordings App changes from a Service License to an App License. Customers with already activated Service Licenses should ask for License Conversion at <code>license@innovaphone.com</code>.
With V13r2 required License Type for the Recordings App changes from a Service License (''Service(innovaphone-recordings)'') to an App License (''App(innovaphone-recorder)''). Customers with already activated Service Licenses should ask for License Conversion at <code>license@innovaphone.com</code>.


=== Database Conversion ===
=== Database Conversion ===

Revision as of 12:58, 8 July 2021

Description

Recordings is an application running on the App platform which allows to capture the audio streams during a telephone call. The users phone can be configured to send bi-directional audio streams to the Recordings App and store them into the database.

Applies To

  • innovaphone PBX from version 13r2

Requirements

  • innovaphone PBX
  • innovaphone Application Platform
  • Firmware V13r2xx
  • Recordings App
  • Device with PCAP Recording Interface:
    • innovaphone deskphones (not V13-SoftphoneApp)
    • innovaphone gateway interfaces

Apps

recordings

Usrrecord.png

  • User version of the App allow you to :
  • Access to the user specific records
  • Access to the user specific logs
  • Filter records by name, by date
  • Play, Listen or Download the recording as a .WAV file

Protect against deleting or delete a recording

recordingsadmin

Adminrecord.png Admin version of the app allow you to :

  • Access to all records
  • Access to all logs
  • Set up the records auto deletion retention time in days
  • Set the recordings group name
  • Set specific trace levels
  • Filter records by name, by date
  • Play, Listen or Download the recording as a .wav file
  • Protect against deleting or delete a recording

PBX Manager Plugin

With the Recordings PBX Manager Plugin an App Objects can be created, edited and deleted on the PBX.


Configuration

  • Download the Recordings App via App Store.
  • Install the App on the App Platform Manager.
  • Create a instance for the Recordings App on the App Platform Manager.
  • Create a new PBX recordings Object with the PBX Manager Plugin.
  • Create a new PBX recordingsadmin Object with the PBX Manager Plugin.
  • Assign recordingsadmin App to authorized (admin) users, which will be allowed to open the Admin UI of the Recordings App.
  • Assign recordings App to users who will use the Recordings App.
  • Start recordings App and configure with recordingsadmin App the name of the PBX

Licensing

An appropriate license App(innovaphone-recorder) must be installed on the PBX to enable Recordings App functionality for specified users. During installation and configuration of the recordings App Object via PBX Manager a certain amount from the total of installed licenses

Is allocated to the object. There are different modes of licence operation depending on number of users and the number of licences:

  • open mode

If the number of licenses allocated to the recordings object are greater or equal to the number of users there is no need to configure a specific recordings group. All users can record.

If the number of licenses allocated to the recordings object are less than the number of users on the PBX the licenses will be allocated on a first come first serve basis. Unlicensed recordings will nevertheless be kept in the DB, however they will not be accessible. They will be made accessible automatically when a sufficient number of additional licenses is installed/allocated to the recordings object. These unlicensed recordings will be kept as long as the licensed ones.

  • Group mode

If the number of licenses allocated to the recordings object is less that the number of users and when it must be ensured that a certain group of user can record and access their recordings, these users who must be put into a group. If the members in the group exceeds the number of allocated licenses, the licenses are allocated first come first serve. As in the open mode unlicensed recordings will be kept, however the grace period of adding additional licenses is one day, after which these recordings are physically, unrecoverably deleted.

Recording on Special Interfaces

  • Trunk Interface

The Trunk Interface acts as a substitute for the users phone. For outgoing calls the call initiator is the owner of the recording and for him a license is claimed. With incoming calls, the first user answering the call own the recording and a license for this user is claimed.

  • Waiting Queue

The user answering the call is owner, a license for him is claimed.

Upgrade from V13r1 to V13r2 Recordings App

Compatibility

A V13r1 Recordings App can be used in the V13r2 PBX and App Platform environment.

License Changes

With V13r2 required License Type for the Recordings App changes from a Service License (Service(innovaphone-recordings)) to an App License (App(innovaphone-recorder)). Customers with already activated Service Licenses should ask for License Conversion at license@innovaphone.com.

Database Conversion

On first start after update from V13r1 to V13r2 Recordings App, the App Service will start a database conversion procedure. Depending on the number of recordings in the database, time for conversion my take up to 30 minutes for a database with 100000 recordings.

It is recommended to export the Recordings App database for backup purposes, prior updating the App.

Troubleshooting

Recordings App Service

The App Service for Recordings App provides a log output on the App instance, after the Diagnostics option "App" is activated for the selected instance.

Additional Trace Level Options for the App Service are configurable via Recordings Admin App. This settings are available via additional Menu in the upper right corner of the REcordings Admin UI:

  • Recording - PCAP interface related traces, useful on issues with IP-Phone and Interface Media transmission from Endpoint to the App Service
  • Call Information - traces related to the CDR information
  • Converting - traces for conversion process from VoIP codecs to WAV
  • License - traces for on licensing issues
  • UI - traces related to the user interface of the Recordings App

The name of the MAster PBX must be configured via the Recordings Admin App, otherwise a message PBX Name missing will be displayed.

PBX Configuration

  • WebSocket connection from App Object to the recordings app should show connected
  • A correct configuration of the CDR interface is required for transmission of metadata to the recordings service. In case this transmission is not successful, a recording will show a NoCDR message, instead of username

PCAP Recording Interfaces