Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Add_workflow_for_techpubs
AUTH1UserResourceIdentifier{userKey=8a00a0c85fd202bb0160132c449a0026, userName='null'}
JIRAIDAUTHSBX-96023
REV5UserResourceIdentifier{userKey=8a00a0c85fd202bb0160132c449a0026, userName='null'}
REV6UserResourceIdentifier{userKey=8a00a0c85fd202bb0160132c449a0026, userName='null'}
REV3UserResourceIdentifier{userKey=8a00a0c86af1a8d3016afe2f47e10008, userName='null'}
REV1UserResourceIdentifier{userKey=8a00a0c8674c8a57016753eb895d0007, userName='null'}



Panel

In This Section:

Table of Contents


Use the following procedure to configure the

Spacevars
0product
to establish call recordings triggered from the PSX or from the SBC Embedded Routing Engine (ERE) .

Triggering Call Recording from PSX

  1. Configure the
    Spacevars
    0product
     for for a basic call.
  2. Install SIPREC license on the
    Spacevars
    0product
     using the EMS
    using
    Spacevars
    0model3
    .
  3. Configure the external PSX.

    Code Block
    languagenone
    % set system policyServer localServer PSX_LOCAL_SERVER mode outOfService state disabled
    % set system policyServer remoteServer <psx name> ipAddress <psx_ip> portNumber <psx_port> state enabled mode active


  4. Create a recorder profile on the PSX and configure call recording criteria of the recorder profile.

    Include Page
    _Recordertype_recordingtype
    _Recordertype_recordingtype

    Create Recorder Profile


  5. Configure Call Recording Criteria


  6. Create a SIP signaling port on the

    Spacevars
    0product
     towards the recorder, and enable SIPREC. The Supported Transport protocols must match the protocol used in PSX. If TLS is used, set the corresponding TLS Profile in the SIP Sig port.

    Code Block
    languagenone
    % set addressContext <ADDRESS-CONTEXT> zone <ZONE> sipSigPort <SIP SIGNALLING PORT> siprec enabled 


    Info
    titleNote

    A Trunk group is configured towards the SRS server. As this is not a call processing TG, only the following TG attributes are used by the SBC when allocating resources towards SRS for a Recording session:

    • Media IP Inteface Group Name
    • SIP Signaling Port ( with "siprec" attribute enabled) 


  7. Create a trunk group from the

    Spacevars
    0product
     for recording, including the following configurations:

    1. Configure Media IP Interface Group name

    2. Configure Metadata profile

      Info
      titleNote

      Ensure the name of the trunk group is is identical to the one used above while creating the Recorder profile in the PSX.


  8. Add static routes toward the recorder.

  9. The SIP SRS (SIPREC Recording Servers) redundancy requires the SRS servers to be provisioned as ipPeers in the SBC under specific zone and a pathCheck profile must be assigned with pathCheck pings enabled on IP Peer level. Follow these steps to configure pathCheck Profile for an SRS IP:

    1. Create a pathCheck Profile.

      Code Block
      languagetext
      % set profiles services pathCheckProfile <pathCheckProfile_name> protocol sipOptions
      % commit 


    2. Configure the SRS as an ipPeer in the SIPREC zone (the zone containing the Trunk Group configured for the SRS) and attach the pathcheck profile to it.

      Code Block
      languagetext
      % set addressContext <addressContext_name> zone SIPREC_ZONE ipPeer <ipPeer_name> ipAddress <SRS IP> ipPort <port> pathCheck profile <pathCheckProfile_name> state enabled
      % commit 


    3. Check the pathCheck status.

      Code Block
      languagetext
      > show table addressContext <addressContext_name> zone SIPREC_ZONE peerPathchkStatus


Triggering Call Recording from ERE

The SRS information and call recording criteria are configured for ERE using the SBC CLI or EMA.

  1. Create a SIP signaling port on the SBC towards the recorder, and enable SIPREC.

    Code Block
    languagenone
    % set addressContext <ADDRESS-CONTEXT> zone <ZONE> sipSigPort <SIP SIGNALLING PORT> siprec enabled 


    Info
    titleNote

    To support SIPREC INVITE over TCP, the sipSigPort, which is configured in the zone for SIPREC must have transportProtocolsAllowed as sip-tcp.


    Code Block
    % set addressContext <ADDRESS-CONTEXT> zone <ZONE> sipSigPort <SIP SIGNALLING PORT> transportProtocolsAllowed sip-tcp


  2. Create a trunk group from the SBC for recording.

    Code Block
    % set addressContext <ADDRESS-CONTEXT> zone <ZONE> sipTrunkGroup <sipTrunkGroup>


    Info
    titleNote

    The same trunk group name must be used in CLI startRecord command and Start Record command of EMA GUI.


  3. Add static routes toward the recorder.

  4. Create an SRS group profile. SRS group profiles group together a set of SRS servers to receive SIP call recordings. 

    1. CLI method:

      Code Block
      % set global servers srsGroupProfile <srs_group name> loadDistribution <roundRobin | sequence> description <string, min: 0 chars, max: 199 chars> numSimultaneousStream <range 1..2> srsGroupData <Priority_range 0..7> ipAddress <signaling ipv4/ipv6address_of_the_SRS> ipPort <signaling_port_of_the_SRS> fqdn <FQDN _of_the_SRS> fqdnPort <port_of_the_SRS> ipTGId <Ip_Trunkgroup_Id> srtp <disable | enable> cryptoSuiteProfile <cryptoSuiteProfile> transport <udp | tcp>


      Info
      titleNotes
      • The option cryptoSuiteProfile is visible only when the flag srtp is enabled. 
      • Specify either an FQDN or IP address for the SRS in the srsGroupData entry, not both.


    2. EMA method: Go to All > Global > Servers > Srs Group Profile
      Enabling SRTP in an SRS Group Profile


  5. Create an SRS group cluster. You can add up to four SRS group profiles to an SRS group cluster to enable sending four simultaneous recordings. An SRS group cluster is then associated with call recording criteria you configure on the SBC
    1. CLI method:
      For more information, refer to Servers - SRS Group Cluster - CLI

    2. EMA method:
      For more information, refer to Global - Servers - Srs Group Cluster - Srs Group Cluster Data
  6. Create sets of call recording criteria to trigger recording of calls that match.
    1. CLI method:

      Code Block
      % set global servers callRecordingCriteria <call_recording_criteria_ID>  srsGroupId <srs_group_ID> calledPartyId <called_party_number> callingPartyId <calling_party_number> egressTgId <egressTrunkGroup_ID> ingressTgId <IngressTrunkGroup_ID> nextHopIP <ipv4/ipv6_address_of_the_next_hop> nextHopIP <ipv4/ipv6address_of_the_next_hop> previousHopIP <ipv4/ipv6address_of_the  previous_hop> recordingStopCriteria <manual | numOfCalls> numberOfCalls <Range 0 .. 99999>  recorderType <SIPRec | mct> recordingDuration <Range 0..3600> recordingType <allLegs | bothLegs | egressLeg | ingressLeg> criteriaState <disable | enable>

      Refer to Servers - Call Recording Criteria - CLI for more information.

    2. EMA method: Go to All > Global > Servers > Call Recording Criteria
      Create New Call Recording Criteria Window


Refer to Global - Servers - Call Recording Criteria for more information.

To Trigger Recording of a Specific Call

Start recording of a specific call from the CLI or EMA using its GCID.

Info
titleNote

When recording is initiated from CLI/EMA, disable call recording criteria (or check that call recording criteria does not match); otherwise, recording is not initiated through CLI/EMA.

  • CLI method:

    To start a recording, issue a siprec startRecord request. Execute the command for both the ingress and egress legs:

    Code Block
    languagenone
    % request global sipRec startRecord gcid <GCID> callLeg ingress numOfStreams <Number of recorders  1 or 2> srsIpAddress <SRS IP ADDRESS> srsPort <SRS PORT> transport <tcp | udp> trunkGroup <TRUNK GROUP NAME> srsIpAddress2 <SRS IP ADDRESS> srsPort2 <SRS Port> transport2 <tcp | udp> trunkGroup2 <SIP Trunk Group> 
    
    % request global sipRec startRecord gcid <GCID> callLeg egress numOfStreams <Number of recorders  1 or 2> srsIpAddress <SRS IP ADDRESS> srsPort <SRS PORT> transport <tcp | udp> trunkGroup <TRUNK GROUP NAME> srsIpAddress2 <SRS IP ADDRESS> srsPort2 <SRS Port> transport2 <tcp | udp> trunkGroup2 <SIP Trunk Group> 


  • EMA method:

  1. On the SBC main screen, navigate to All > Global > SIPrec.
  2. Select Start Record from the commands drop-down list.
  3. Enter the start record options.  Refer to Global - SIPrec for more information.
    EMA Start Record Command




  4. Click startRecord.

To Stop a Recording

Use one of the following methods to stop a recording.

  • CLI method:

    Code Block
    languagenone
    % request global sipRec stopRecord gcid <GCID> [recorderAddress <SRS IP address> | recorderFqdn <SRS FQDN>] recorderId <session ID> recorderPort <port number>

    Refer to Request Global - CLI for more information.

  • EMA method:

  1. On the SBC main screen, navigate to All > Global > SIPrec.
  2. Select Stop Record from the Commands drop-down list.
  3. Enter the stop record options.  Refer to Global - SIPrec for more information.
    EMA Stop Record Command




  4. Click stopRecord.
Info
titleNote

Use the following combinations of parameters to specify which recording(s) to stop.

  • GCID: This parameter stops all the recordings for the call.
  • GCID, IP, recorderPort:This combination stops all the recordings on the IP specified. 
  • GCID, FQDN: This combination stops all the recordings that were initiated with this FQDN.
  • GCID, RecorderId: This combination stops only the specific recording.

To View Information on Calls Being Recorded

To view the details of the calls being recorded from CLI or EMA:

  • CLI method:

    Code Block
    languagenone
    > show table global SipRecStatus                
           RECORDER          RECORDING  RX RTP           TX RTP           RECORDER  RECORDER
    GCID   ADDRESS           LEG        ADDRESS          ADDRESS          FQDN      ID
    555281 10.11.12.13:5060  ingress   10.11.12.13:8000  10.11.12.13:8002           1614567899
    


  • EMA method:

    On the SBC main screen, navigate to All > Global > SIP Rec Status
    SIP Rec Status Window