Related articles:

The request global command is available from both System-level and Configure CLI modes.

Request Global 

To initiate action on global objects, use the following command syntax.

Command Syntax

> request global 
	callCountReset
	callTrace action command start
	dnsClearCache
	mediaCapture disabledByGcid gcid <0-2147483647> 
	siprec
	terminateCall GCID <0-2147483647>

Command Parameters

request global Parameters

Parameter

Description

global

Global objects applicable node-wide.

callCountReset

This object resets all statistics counts to zero.

callTrace

Call Trace Group configuration for the Node. Use this parameter to restart call trace when it is halted due to MaxTrigger or some other reason. Full syntax is:

> request global callTrace action command start

NOTE: This command is only exposed after a callTrace configuration is performed. If no entries are present in the callTrace, this command is not available from CLI.

dnsClearCache
Clear the full DNS cache.
mediaCapture

Reset call count for media capture with following arguments:

  • disabledByGcid
  • gcid <gcid#> (range: 0-2147483647)
sipRec

Use this object to start/stop recording for the specified call. (See SIPREC Global Parameters table below for parameter details)

terminateCall

Terminates call based on the specified Global Call Identifier (GCID). 

  • GCID <gcid #>

SIPREC Commands


Note
  • If there is more than one SRS associated with the SRS Cluster, the SBC records on both the legs (Ingress and Egress). The first two recordings are on Ingress leg and the rest on Egress.
  • For Quad SIPREC, there are four recordings triggered. Two recordings are triggered on the Ingress leg and two on the Egress leg.
  • If there is more than one SRS Group configured, it is recommended to set recordingType to "both legs" or "all legs".
  • When SIPREC is selected as the Recorder Type, and Recording Type is selected as “both legs” and “all legs”, the SBC by default records the ingress leg.

Note

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.

To support SIPREC INVITE over TCP, the sipSigPort configured in this zone must have transportProtocolsAllowed set to "sip-tcp". (Refer to Zone - SIP Sig Port - CLI).


Command Syntax

> request global siprec
	startRecord
		callLeg
			egress
			ingress
		gcid <0-2147483647>
		numOfStreams
		srsIpAddress <SRS IP ADDRESS>
		srsIpAddress2 
		srsPort <IP port number>
		srsPort2 <Ip port number>
		transport <tcp | udp>
		transport2  <tcp | udp>
		trunkGroup <TRUNK GROUP NAME>
		trunkGroup2
	stopRecord 
		gcid <0-2147483647>
		recorderAddress
		recorderPort

Command Parameters

SIPREC Global Parameters

Parameter

Description

startRecord

Use this configuration to define and initiate a SIPREC recording session.

    • callLeg – Call leg associated with this recording session.
      • egress
      • ingress
    • gcid <0-2147483647> – GCID of call to start recording.

    • numOfStreams – The number of simultaneous streaming to different Session Recording Server (SRS) IP addresses. (default = 1).

    • srsIpAddress – The IP address of the primary recording server.

    • srsIpAddress2 – The IP address of the secondary recording server to which the media stream is forked. (only applies when numOfStreams = 2)

    • srsPort – The IP port number of the primary recording server.

    • srsPort2 – The IP port number of the secondary recording server to which the media stream is forked. (only applies when numOfStreams = 2)

    • transport – The transport protocol for recording sessions on the primary SRS IP.

      • tcp
      • udp (default)

    • transport2 – The transport protocol for recording sessions on the secondary SRS IP (only applies when numOfStreams = 2)

      • tcp

      • udp (default)

    • trunkGroup  – The name of the SIPREC trunk group towards primary SRS IP for this recording session.

    • trunkGroup2 –  The name of the SIPREC trunk group towards secondary SRS IP for this recording session. (only applies when numOfStreams = 2)

NOTE: If the number of streams is one and secondary SRS details are provided in the srsIpAddress2, srsPort2, and trunkGroup2, this information will be used for redundancy when primary server goes down.

stopRecord

Use this configuration to halt a recording session.

    • gcid – GCID of the call to stop recording.
    • recorderAddress – The IP address of the recorder to stop the recording of a GCID value.
    • recorderPort – The port number of the recorder to stop the recording of a GCID value.

NOTE: If only the GCID value is mentioned in this command, all recordings for that GCID are stopped at once.


  • No labels