debug mobile-gateway command descriptions

mobile-gateway

Syntax

  • mobile-gateway

Context

Description

Commands in this context enable and configure call trace debugging.

call-insight

Syntax

  • call-insight

Context

  • [Tree] debug mobile-gateway call-insight

Description

This command enables the context for debugging call trace.

bng

Syntax

  • bng [mac-address mac] [remote-id rem] [circuit-id circ] [up up-node-id] [l2-access-id l2-acc] [l2-circuit l2-circ] [profile profile-name] [max-sessions max]
  • no bng [mac-address mac] [remote-id rem] [circuit-id circ] [up up-node-id] [l2-access-id l2-acc] [l2-circuit l2-circ]
  • no bng all

Context

  • [Tree] debug mobile-gateway call-insight bng

Description

This command enables the call trace debugging of the BNG sessions matching the specified parameters using the specified profile.

The no form of this command removes either a specific trace matching the specified filters or all configured traces.

Parameters

all
Specifies to remove all traces.
mac
Specifies the MAC address of the BNG session.
Values: xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx (where x is an hexadecimal digit)
rem
Specifies the remote ID of the BNG session, up to 255 characters. The wildcard character (*) can be used only at the start or the end.
circ
Specifies the circuit ID of the BNG session, up to 255 characters. The wildcard character (*) can be used only at the start or the end.
up-node-id
Specifies the UP node ID of the UPF where the session is active.
Values:
  • IPv4 address – a.b.c.d
  • IPv6 address – x:x:x:x:x:x:x:x (eight 16-bit pieces) or x:x:x:x:x:x:d.d.d.d

    where

    x – [0..FFFF]H

    d – [0..255]D

  • fqdn – up to 255 characters (per label max 63); the wildcard character (*) can be used only at the start or the end
l2-acc
specifies the layer 2 access ID where the session is active, up to 50 characters. The wildcard character (*) can be used only at the start or the end.
l2-circ
specifies the layer 2 circuit ID where the session is active, up to 50 characters. The wildcard character (*) can be used only at the start or the end.
profile-name
specifies an existing call-insight profile, as configured with the ue command in the configure mobile-gateway profile call-insight context. It is a string of up to 32 characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.
max
specifies the maximum number of BNG sessions that can be traced for the specified criteria. Additional sessions matching the specified criteria are not traced.
Values: 1 to 50

ue

Syntax

  • ue {imei | imsi | msisdn} value [profile profile-name]
  • no ue {imei | imsi | msisdn} value
  • no ue all
  • no ue {imei | imsi | msisdn} mask pattern
  • no ue mask-name mask-name
  • ue {imei | imsi | msisdn} value

Context

  • [Tree] debug mobile-gateway call-insight ue

Description

This command enables adding and removing of specified call trace jobs.

Parameters

all
removes all call trace jobs
imei
adds or removes an imei call trace job, up to 16 digits
imsi
adds or removes an imsi call trace job. up to 15 digits
msisdn
adds or removes an msisdn call trace job, up to 15 digits
mask-name
removes call trace jobs matching a specified mask name. The mask name is up to 16 characters. The default mask name is “default”.
pattern
removes call trace jobs matching a unique mask type and pattern. The pattern is up to 16 characters long composed of digits 0-9, '*' and '.'
profile-name
specifies an existing profile name. Allowed values are any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.
value
removes call trace jobs matching a specified IMEI, IMSI, or MSISDN value
Note:
The parameters of the following commands are not supported with metadata for call trace:
  • no ue {imei | imsi | msisdn} mask pattern
  • no ue mac-address mac-address
  • no ue mask-name mask-name
  • ue mac-address mac-address [profile profile-name]

ue-mask

Syntax

  • ue-mask {imei | imsi | msisdn} pattern [name mask-name] [profile profile-name] [max-ues num]
  • no ue-mask {imei | imsi | msisdn} pattern
  • no ue-mask name mask-name
  • no ue-mask all

Context

  • [Tree] debug mobile-gateway call-insight ue-mask

Description

This command adds or removes a mask template for call-trace jobs to be generated automatically. If the name is not specified, a default name is used. If the profile is not specified, a default profile is used. If the max-ues is not specified, a default value of 50 is used.

Parameters

all
removes all mask templates
imei
adds or removes an IMEI mask template
imsi
adds or removes an IMSI mask template
msisdn
adds or removes an MSISDN mask template
mask-name
specifies the mask name, up to 16 characters. The default mask name is “default”.
num
specifies the maximum number of UEs. The default is 50.
Values: 1 to 50
pattern
The pattern is a maximum of 16 characters composed of digits 0-9, '*' and '.'
profile-name
specifies an existing profile name. Allowed values are any string up to 32 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.