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.
A 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 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.
For more information on SIPREC functionality and feature interaction, refer to to SIPREC Support or Session Recording Support.
SIPREC Start and Stop Commands
On the SBC main screen, navigate to All > Global > SIPrec
Use the commands provided to start recording and stop recording of a specific call using the SIPREC protocol.
| Caption |
|---|
| 0 | Figure |
|---|
| 1 | Siprec SIPREC Commands |
|---|
|
|
To start recording
Select the Start Record command and click Select. A startRecord pop-up window is displayed:opens.
| Caption |
|---|
| 0 | Figure |
|---|
| 1 | startRecord window |
|---|
|
| Image Modified |
| Info |
|---|
|
- For SIPREC SIP-based session recording, by default the SBC, as the SRC, sends the INVITE to the SRS over UDP by defaulttransport. The SBC also supports sending SIPREC INVITE INVITEs to the SRS over 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 set to sip-tcp.
|
Set the start recording parameters using the following table.
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Start Recording Parameters |
|---|
|
Parameter | Description |
|---|
GCID | Specifies the GCID of the call to start recording. | | Call Leg | Call leg associated with this recording session. The options are: | | Num 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 SRS. | | Srs Port | Specifies the UDP |
Port | port of the SRS. | | Srs IP Address2 | 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 Port2 | 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.
| | SrsFqdn1 | Specifies the FQDN of the SRS. | | SrsFqdn2 | Specifies the FQDN of the secondary recording server to which the media stream is forked. |
|
Make the required changes and click startRecord on the pop-up window to initiate the SIP-based session recording.
| Info |
|---|
|
If the parameter Num of Streams is set to "1", and secondary SRS details are provided for the parameters Srs IP Address2, Srs Port2, and Trunk Group2, then the information about the secondary SRS information is used for redundancy if the 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 and click Select. A stopRecord pop-up window is displayed
| Caption |
|---|
| 0 | Figure |
|---|
| 1 | Global - Siprec - StopRecord |
|---|
|
Image Modified |
Set the stop recording parameters using the following table.
| Caption |
|---|
| 0 | Table |
|---|
| 1 | 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. | | Recorder Port | Specifies the port number of the recorder on which to stop the recording. | | Recorder FQDN | Specifies the FQDN of the recorder on which to stop a recording. | | Recorder ID | Specifies the unique identifier of the recording session to stop. |
|
Make the required changes and click stopRecord on the pop-up window to stop the SIP-based session recording.
| Info |
|---|
|
For the stopRecord command, if only the GCID value is provided, all recordings for that GCID are stopped at once. |