The SIPREC protocol defines the interaction between a Session Recording Client (SRC) and a Session Recording Server (SRS), and controls the recording of media transmitted in the context of a communications session (CS) between multiple user agents.
The
supports the following SIP recording (SIPREC) interfaces:SIPREC SIP-based session recordingCall monitoring MCTNICE session recordingA basic call, or communication session (CS), is established between SIP phone 1 and SIP phone 2 through the
. The
establishes a Recording session (RS) for the CS
, based on configuration
, towards
the SRS.
The SRC and SRS act as SIP User Agents (UAs) user agents whereby the SRC provides additional information (called metadata) to the SRS recording session to describe the communication sessions, participants, and media streams to facilitate archival and retrieval of the recorded information.
The
determines if a call is configured to be recorded, and if SIPREC is to be used.| Info |
|---|
|
The SIPREC feature is controlled by a system-wide SBC license (SBC-SIPREC).
If the license is not available, any SIPREC recording returned by a PSX is ignored.| Include Page |
|---|
Recordertype_recordingtype | Recordertype_recordingtype | | Include Page |
|---|
NICE_vs_MediaPacketCaptureNICE_vs_MediaPacketCapture | For more information on SIPREC functionality and feature interaction, refer to Session Recording Support.
SIPREC Start and Stop Commands
SIPrec Commands
On the SBC main screen, navigate to All > Global > SIPrec
Use the commands provided to This option provides start recording and stop recording using the SIPREC protocol.
| Caption |
|---|
|
|
The following options are displayed:
| Caption |
|---|
| 0 | Table |
|---|
| 1 | SipRec Command Parameters |
|---|
|
Parameter | Description |
|---|
startRecord
| Initiates the SIPREC SIP-based session recording. |
stopRecord
| Terminates the SIPREC SIP-based session recording. |
Select the required command and click Select.
To start recording
Select the Start Record command and click Select. A dialogstartRecord pop-box up window is displayed:
| Caption |
|---|
| 0 | Figure |
|---|
| 1 | Siprec - Start RecordingstartRecord window |
|---|
|
| Image Modified |
| Info |
|---|
|
- For SIPREC SIP-based session recording, the SBC as SRC sends the INVITE to the SRS over User Datagram Protocol (UDP)UDP by default. The SBC also supports SIPREC INVITE to the SRS over Transmission Control Protocol (TCP)TCP or TLS.
- To support SIPREC INVITE over TCP, the Sip Sig Port, which is configured in the zone for SIPREC, must have Transport Protocols Allowed as sip-tcp.
|
The following fields are displayedSet the start recording parameters using the following table.
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Siprec - Start Recording Parameters |
|---|
|
Parameter | Description |
|---|
GcidGCID
| Specifies the GCID of the call to start recording. | | Call Leg | Call leg associated with this recording session. The options are: | | Num of Of Streams | Specifies the number (1 or 2) of simultaneous streaming to different SRS IP addresses. By default, the value is 1. | | Srs IP Address | Specifies the IP address of the Recording ServerSRS. | | Srs Port | Specifies the UDP Port of the Recording ServerSRS. | | Srs IP Address2Address2 | Specifies the IP address of the secondary recording server to which the media stream is forked. NOTE: This parameter is mandatory if the parameter Num Of Streams is set to 2. | | Srs Port2Port2 | Specifies the IP port of the secondary recording server to which the media stream is forked. NOTE: This parameter is mandatory if the parameter Num Of Streams is set to 2. | | Trunk Group | Specifies the name of the SIPREC trunk group associated with this recording session. | | Transport | Select the transport protocol over which you want to send the SIPREC INVITE. The options are: | | Trunk Group2 | Specifies the name (maximum 24 characters) of the SIPREC trunk group towards second SRS IP with which the calls have to be recorded. NOTE: This parameter is mandatory if the parameter Num Of Streams is set to 2. | | Transport2 | Specifies the type of transport to be used for recording session on the secondary SRS IP. The options are: NOTE: This parameter is mandatory if the parameter Num Of Streams is set to 2.
|
|
Make the required changes and click startRecord on the pop-up window to initiate the SIP-based session recording. Click the "Command Name" button to implement the option. The result of the action is displayed.
| Caption |
|---|
| 0 | Figure |
|---|
| 1 | Global - Siprec - StartRecord - Result |
|---|
|
Image Removed |
| Info |
|---|
|
If the parameter Num of Streams is set to "1", and secondary SRS details are provided for the parameters Srs Ip IP Address2, Srs Port2, and Trunk Group2, then the information about the secondary SRS information is used for redundancy when if the primary SRS goes down. |
| Info |
|---|
|
The SBC supports executing the startRecord command twice: once for the ingress call-leg and once for the egress call-leg, to establish up to two streams in both directions simultaneously to achieve quad-recording. |
To stop recording
Select the Stop Record command command and click click Select. A dialogstopRecord pop-box up window is displayed:
| Caption |
|---|
| 0 | Figure |
|---|
| 1 | Global - Siprec - StopRecord |
|---|
|
Image Modified |
The following fields are displayed Set the stop recording parameters using the following table.
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Siprec - Start Stop Recording Parameters |
|---|
|
Parameter | Description |
|---|
GCID | Specifies the GCID of the call to stop recording. | | Recorder Address | Specifies the IP address of the recorder on which to stop the recording of a GCID value. | | Recorder Port | Specifies the port number of the recorder on which to stop the recording of a GCID value. |
|
Make the required changes and click stopRecord on the pop-up window to stop the SIP-based session recording. The result of the action is displayed.
| Info |
|---|
|
For the stopRecord command, if only the GCID value is mentionedprovided, all recordings for that GCID are stopped at once. |