perform command reference

perform hierarchy descriptions

This section provides the following perform hierarchy descriptions:

perform command descriptions

This section provides the following perform command descriptions:

tools perform command descriptions

mobile-gateway

Syntax
  • mobile-gateway
Context
  • [Tree] tools perform mobile-gateway
Description

Commands in this context execute mobile gateway performance commands.

pdn

Syntax
  • pdn gw-id
Context
  • [Tree] tools perform mobile-gateway pdn
Description

Commands in this context execute tools commands on a specific mobile gateway instance.

Parameters
gw-id
Specifies the gateway ID.
Values: 1 to 8

bng

Syntax
  • bng
Context
  • [Tree] tools perform mobile-gateway pdn bng
Description

Commands in this context execute tools commands specific to BNG CUPS functionality.

up-resiliency

Syntax
  • up-resiliency
Context
  • [Tree] tools perform mobile-gateway pdn bng up-resiliency
Description

Commands in this context execute tools commands specific to UP Resiliency functionality.

lookup

Syntax
  • lookup up node-identifier l2-access-id id [s-vlan s-tag] [c-vlan c-tag]
Context
  • [Tree] tools perform mobile-gateway pdn bng up-resiliency lookup
Description

This command looks up which UP group and FSG a specific UP and Layer-2 access ID belongs to. Optionally, an s-tag or c-tag can be provided, if multiple UP groups are used for different VLAN ranges.

Parameters
node-identifier
Specifies the BNG-UP to perform the lookup for, either by address or by FQDN. This is the value as passed in the Node ID Information Element in PFCP.
Values: ip-addr | fqdn
  • ip-addr -
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 - specifies a fully qualified domain name, up to 255 characters.
id
Specifies the l2-access-id, up to 64 characters.
s-tag
Specifies the s-tag/s-vlan value.
Values: 0 to 4094
c-tag
Specifies the c-tag/c-vlan value.
Values: 0 to 4094
Output

The following output example shows a UP group and FSG lookup for a specific UP and Layer-2 access ID.

UP group and FSG lookup for a specific UP and Layer-2 access ID

/tools perform mobile-gateway pdn 1 bng up-resiliency lookup up "bng_east" l2-access-id "to_access"

-------------------------------------------------------------------------------
Up-Group                               : basic_access
Up-Id                                  : bng_east (192.0.2.11)
Admin-State                            : enabled
S-Vlan Range                           : N/A
C-Vlan Range                           : N/A
FSG Id                                 : 1
FSG Role                               : Active
Locked                                 : no
-------------------------------------------------------------------------------
No of Up-Groups : 1

bearer-context

Syntax
  • bearer-context {imsi | imei | msisdn} string [local-only] [apn apn] [slave]
Context
  • [Tree] tools perform mobile-gateway pdn force-clear bearer-context
Description

This command forcefully clears the bearer context for a specific UE. All sessions of the UE at the PDN level are cleared when the APN option is not used. A rate limiting is applied to the command, by only accepting 16 commands in parallel and only allowing one command per second to proceed internally for execution.

Caution: This command performs an exhaustive search of the UE identity on all the cards/VMs of the mobile gateway and should only be used if necessary and as instructed by Nokia Technical Support.
Parameters
string
Specifies the value of the address string for the UE key (IMEI, IMSI, or MSISDN) used to locate the bearer context, up to 15 digits for IMSI or MSISDN or 16 digits for IMEI.
apn
Specifies the name of the APN; when used, only the UE sessions on this APN are cleared.
Note: Virtual APNs are not supported in this command, use only real APNs.
local-only
Specifies an internal cleanup.
slave
Specifies that the clearing is needed on the slave in an ICR deployment.

pfcp-audit

Syntax
  • pfcp-audit [peer ip-address | ipv6-address]
Context
  • [Tree] tools perform mobile-gateway pdn pfcp-audit
Description

This command performs a PFCP audit for all PFCP paths or for the paths of a specified PFCP peer.

Parameters
ip-address | ipv6-address
IPv4 or IPv6 address of a remote PFCP peer.
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

up-resiliency-sync

Syntax
  • up-resiliency-sync fsg fsg-id
  • up-resiliency-sync up-group group-name
Context
  • [Tree] tools perform mobile-gateway pdn up-resiliency-sync
Description

This command executes a download of all out-of-sync standby sessions to the standby BNG-UP in the specified up-group or FSG.

This command can be executed after resolving any error that caused session failure. For example, consider provisioning a QoS profile that was missing on the standby UP.

Parameters
fsg-id
Specifies the identifier of the FSG for which to perform the synchronixation.
Values: 1 to 4294967295
group-name
Specfies the name of the UP group, up to 32 characters, for which to perform the synchronization.

profile

Syntax
  • [no] profile profile-id
Context
  • [Tree] tools perform mobile-gateway profile
Description

Commands in this context execute profile performance management commands.

Parameters
profile-id
Specifies a profile number identifier.
Values: 0 to 255

authentication-database

Syntax
  • authentication-database name
Context
  • [Tree] tools perform mobile-gateway profile authentication-database
Description

Commands in this context execute the tool commands for the ADB.

Parameters
name
Specifies the name of the ADB, up to 32 characters.

lookup

Syntax
  • lookup [circuit-id-string string-id] [remote-id-string string-id] [circuit-id-hex hex-id] [remote-id-hex hex-id] [l2-access-id string-id] [up-ip ip-address] [username username] [c-vlan vlan-id] [s-vlan vlan-id] [vendor-class-string string-id] [vendor-class-hex hex-id] [apn apn-name] [imsi-mcc mcc value] [imsi-mnc mnc value] [imei-tac tac value] [up-group name] [up-group-derive] [up-node-id fqdn] [mac ieee-address] [client-id-string cid-string] [client-id-hex binary-cid] [source-ip ip-address] [s-nssai-sst sst value] [s-nssai-sd sd hexh string]
Context
  • [Tree] tools perform mobile-gateway profile authentication-database lookup
Description

This command performs a lookup action within the authentication-database with the specified parameters and displays the resulting entry name.

Parameters
circuit-id-string string-id
Specifies the circuit ID string filter, up to 64 characters.
remote-id-string string-id
Specifies the remote ID string filter, up to 64 characters.
circuit-id-hex hex-id
Specifies the circuit ID binary value filter.
Values: 0x0 to 0xFFFFFFFF...(max 128 hex nibbles)
remote-id-hex hex-id
Specifies the remote ID binary value filter.
Values: 0x0 to 0xFFFFFFFF...(max 128 hex nibbles)
l2-access-id string-id
Specifies the Layer 2 access ID filter, up to 64 characters.
up-ip ip-address
Specifies the UP IP address filter.
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

username
Specifies the PPP username filter, up to 253 characters.
vlan-id
Specifies the customer VLAN (inner VLAN) filter.
Values: 1 to 4096
s-vlan vlan-id
Specifies the service VLAN (outer VLAN) filter.
Values: 1 to 4096
vendor-class-string string-id
Specifies the DHCP vendor class option ASCII string, up to 64 characters.
vendor-class-hex hex-id
Specifies the DHCP vendor class option hexadecimal string.
Values: 0x0 to 0xFFFFFFFF...(max 128 hex nibbles)
apn-name
Specifies the APN filter, up to 80 characters.
mcc value
Specifies the filter on the IMSI-based MCC value.
Values: 000 to 999 (three-digit number)
mnc value
Specifies the filter on the IMSI-based MNC value.
Values: 00 to 999 (two- or three-digit number)
tac value
Specifies the filter on the IMEI-based TAC value.
Values: eight-digit number
name
Specifies the UP group filter, up to 32 characters.
up-group-derive
Specifies that the UP group filter is automatically derived based on the up-node-id, l2-access-id, and optionally s-vlan or c-vlan parameters. The parameter values are used to do a lookup in all configured UP groups, and the result is automatically used as if up-group was passed directly.
fqdn
Specifies the UP node ID filter, up to 255 characters.
ieee-address
Specifies the MAC address filter.
Values: xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx
cid-string
Specifies the client ID filter, up to 255 characters.
binary-cid
Specifies the binary client ID filter.
Values: 0x0 to 0xFFFFFFFF... (maximum of 510 hex nibbles)
source-ip ip-address
Specifies the source IP address filter.
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

sst value
Specifies the S-NSSAI SST filter.
Values: 0 to 255
sd hex string
Specifies the S-NSSAI SD filter.
Values: 000000 to FFFFFF

bng

Syntax
  • bng
Context
  • [Tree] tools perform mobile-gateway profile bng
Description

Commands in this context execute the tool commands for BNG CUPS.

entry-point

Syntax
  • entry-point entry-point-name
Context
  • [Tree] tools perform mobile-gateway profile bng entry-point
Description

Commands in this context execute the tool commands for BNG CUPS entry points.

Parameters
entry-point-name
Specifies the name of the BNG entry point, up to 32 characters.

lookup

Syntax
  • lookup [l2-access-id string-64] [up-ip ip-address] [c-vlan vlan-id] [s-vlan vlan-id]
Context
  • [Tree] tools perform mobile-gateway profile bng entry-point lookup
Description

This command performs a lookup action within the entry point with the specified parameters. It displays the matching entry name.

Parameters
string-64
Specifies the Layer 2 access ID filter, up to 64 characters.
ip-address
Specifies the UP IP address filter.
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

vlan-id
Specifies the customer VLAN (inner VLAN) filter.
Values: 1 to 4096
s-vlan vlan-id
Specifies the service VLAN (outer VLAN) filter.
Values: 1 to 4096

radius

Syntax
  • radius
Context
  • [Tree] tools perform mobile-gateway profile bng radius
Description

Commands in this context execute the tool commands for BNG CUPS RADIUS profiles.

coa

Syntax
  • coa
  • no coa
Context
  • [Tree] tools perform mobile-gateway profile bng radius coa
Description

This command creates a RADIUS CoA test action.

The action can send a CoA request to a specified destination using the following context. 
tools perform mobile-gateway profile bng radius coa deliver-request
The CoA request can be customized using the following the context.
tools perform mobile-gateway profile bng radius coa
For example, using the attribute command to include specific RADIUS attributes in the request.

The no form of this command removes the CoA test action.

attribute

Syntax
  • no attribute attribute-name
  • attribute attribute-name hex hex-string [tag tag-number]
  • attribute attribute-name ip-address ip-address | ipv6-address [tag tag-number]
  • attribute attribute-name ip-prefix ip-prefix/ip-prefix-length [tag tag-number]
  • attribute attribute-name mac-address ieee-address [tag tag-number]
  • attribute attribute-name number num [tag tag-number]
  • attribute attribute-name string ascii-string [tag tag-number]
Context
  • [Tree] tools perform mobile-gateway profile bng radius coa attribute
Description

This command adds an attribute to the CoA test message.

The no form of this command removes the specified attribute from the CoA test message.

Parameters
attribute-name
Specifies the name of a RADIUS attribute, must be a supported CoA attribute, up to 64 characters.
hex-string
Specifies a hexadecimal string.
Values: 0x0 to 0xFFFFFFFF...(max 506 hex nibbles)
tag-number
Specifies the RADIUS attribute tag.
Values: 1 to 31
ip-address | ipv6-address
Specifies the IP address.
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

ip-prefix/ip-prefix-length
Specifies the IP prefix.
  • ipv4-prefix – a.b.c.d (host bits must be 0)
  • ipv4-prefix-length – 0 to 32
  • ipv6-prefix – x:x:x:x:x:x:x:x (eight 16-bit pieces)

    x:x:x:x:x:x:d.d.d.d

    where

    x - [0..FFFF]H

    d - [0..255]D

  • ipv6-prefix-length – 0 to 128
ieee-address
Specifies the MAC address.
Values: xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx
num
Specifies a number.
Values: 0 to 4294967295
ascii-string
Specifies an ASCII string, up to 253 characters.

debug

Syntax
  • debug
  • no debug
Context
  • [Tree] tools perform mobile-gateway profile bng radius coa debug
Description

This command enables debugging for the CoA test.

The no form of this command disables the debugging.

deliver-request

Syntax
  • deliver-request
Context
  • [Tree] tools perform mobile-gateway profile bng radius coa deliver-request
Description

This command sends the CoA request.

destination-ip

Syntax
  • destination-ip ip-address | ipv6-address
  • no destination-ip
Context
  • [Tree] tools perform mobile-gateway profile bng radius coa destination-ip
Description

This command sets the destination IP address for the CoA request.

The no form of this command removes the destination IP address.

Parameters
ip-address | ipv6-address
Specifies the IP address.
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

info

Syntax
  • info
Context
  • [Tree] tools perform mobile-gateway profile bng radius coa info
Description

This command displays the configuration of the CoA test message; for example, the router, the destination IP address, the attributes.

router

Syntax
  • no router
  • router router-instance
Context
  • [Tree] tools perform mobile-gateway profile bng radius coa router
Description

This command specifies the router instance to which the request is sent.

The no form of this command sets the router instance to Base.

Parameters
router-instance
Specifies the router instance.
Values: router-name | vprn-svc-id
  • router-name - Base | management
  • vprn-svc-id - 1 to 2147483647

source-ip

Syntax
  • no source-ip
  • source-ip ip-address | ipv6-address
Context
  • [Tree] tools perform mobile-gateway profile bng radius coa source-ip
Description

This command sets the source IP address for the CoA request.

The no form of this command sets the source IP address to [::]

Parameters
ip-address | ipv6-address
Specifies the IP address.
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