Router configuration
The 7705 SAR-Hm series of routers supports standard IP routing as covered in the following topics:
IP router configuration
This section describes the following functionality on 7705 SAR-Hm series nodes:
For general information about IP router configuration support, see the following topics in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Router Configuration Guide, "IP router configuration":
Configuring IP router command options
Interfaces
Network interface
Network domains
System interface
Router ID
Autonomous systems
Confederations
Exporting an inactive BGP route from a VPRN
DHCP relay
Internet protocol versions
Aggregate next hop
Invalidate next-hop based on ARP/neighbor cache state
Router interface encryption with NGE
Process overview
Configuration notes
Configuring an IP router with CLI
Service management tasks
For descriptions of IP router commands, see the 7450 ESS, 7750 SR, 7950 XRS, and VSR Classic CLI Command Reference Guide and the 7450 ESS, 7750 SR, 7950 XRS, and VSR Clear, Monitor, Show, and Tools CLI Command Reference Guide.
PDN router interfaces
A packet data network (PDN) router interface is a type of router interface specific to a cellular port. PDN router interfaces are network-facing only and provide the main routing function over a cellular port. Each PDN connection that operates on a cellular port requires a PDN router interface.
A specific PDN router interface is associated with a specific SIM. Port 1/1/1 is always associated with SIM 1 and port 1/1/2 is always associated with SIM2. Therefore, a PDN router interface configured against port 1/1/1 is associated with SIM 1 and a PDN router interface configured against port 1/1/2 is associated with SIM 2. For information about configuring cellular ports, see the 7705 SAR-Hm and SAR-Hmc Interface Configuration Guide.
A PDN router interface is configured using the command config>router>interface interface-name pdn. A PDN router interface supports either IPv4 or IPv6 operation. The address type is determined by the protocol, either IPv4 or IPv6, configured for the PDN profile. A PDN profile must be configured and associated with the PDN router interface in order for a cellular port to attach to a cellular network. The address type is learned by the router interface during the PDN attachment process. For information about configuring a PDN profile, see the 7705 SAR-Hm and SAR-Hmc Interface Configuration Guide.
IPv4 PDN router interface
When a cellular port is configured for IPv4 operation, the associated PDN router interface is always an unnumbered interface; therefore, it cannot be directly configured with an IPv4 address. The IPv4 address assigned to a PDN interface must be specified from a loopback interface or learned directly from the cellular network during the cellular network attachment process. An IPv4 address specified from a loopback interface is used in the following ways:
as the source IPv4 address for GRE-MPLS packets that are sent over a cellular port
as the BGP local-address for BGP sessions over a cellular port
as the T-LDP local-lsr-id for T-LDP signaling sessions
An IPv4 PDN router interface can operate in one of three modes:
static cellular system IPv4 mode
static cellular interface IPv4 mode
dynamic cellular interface IPv4 mode
The mode of operation dictates the way in which the IPv4 address is assigned to the PDN router interface and how it is used in conjunction with services.
For information about the types of services supported on an IPv4 PDN router interface and how an IPv4 PDN interface IP addresses is used by services, see Services over the cellular PDN interface.
An IPv4 PDN router interface supports Network Group Encryption (NGE). For information about NGE, see Network group encryption.
An IPv4 PDN router interface supports IPSec secure interfaces. For information about IPSec secure interfaces, see IPSec secured interface over cellular.
IPv6 PDN router interface
When a cellular port is configured for IPv6 operation, the associated PDN router interface is always a numbered interface.
An IPv6 PDN router interface can operate in one of two modes:
static cellular interface IPv6 mode
dynamic cellular interface IPv6 mode
The ipv6>address command is used to determine the mode of operation of the PDN router interface. When the address is specified, the IPv6 PDN router interface is operating in static cellular interface IPv6 mode. When the address is not specified, then it is operating in the dynamic cellular interface IPv6 mode.
For information about the types of services supported on an IPv6 PDN router interface, see Services over the cellular PDN interface.
An IPv6 PDN router interface supports IPSec secure interfaces. For information about IPSec secure interfaces, see IPSec secured interface over cellular.
An IPv6 PDN router interface does not support NGE.
Static routing on an IPv6 PDN router interface
When IPv6 is enabled on the PDN router interface, any static routes configured to use the PDN interface name as the next hop do not require the explicit configuration of the link-local address. This is because cellular networks do not require a next hop.
The following CLI output shows an example of a static route configuration on an IPv6-enabled PDN router interface.
*A:DUT# config# router
interface "pdn-itf" pdn
port 1/1/1
ipv6
address 1::1/64
exit
exit
static-route-entry ::/0
next-hop "pdn-itf"
exit
exit
exit
Static cellular system IPv4 mode
In the static cellular system IPv4 mode of operation, the unnumbered interface under the PDN router interface is configured as the system interface. When the cellular port associated with the PDN interface attaches to the cellular network, the cellular network statically assigns an IP address to the node for the Access Point Name (APN) and associated installed Subscriber Identity Module (SIM). The system interface is then configured with the IP address that matches the cellular network-assigned IP address. The result is that the IP address provided by the cellular network for the PDN router interface and the system IP address of the node are identical.
A PDN router interface is considered operationally up only when the associated cellular port attaches to the network and an IP address is learned from the cellular attachment. The system checks whether the LTE network-assigned IP address matches the system IP address configured on the PDN interface. If it does not match, the PDN router interface is considered down and an alarm is raised.
The following CLI output shows an example of a PDN interface configured for static cellular system IPv4 mode.
*A:DUT# config# router
interface "system"
address 88.0.0.1/32
no shutdown
exit
interface "pdn1-sim1" pdn
port 1/1/1
unnumbered "system"
no shutdown
exit
exit
exit
When operating in static cellular system IPv4 mode, the following points apply.
Only one cellular IP address can be used on the node. This affects dual SIM operation. If the PDN router interface of one of the dual SIM cellular ports is operating in static cellular system IPv4 mode, then the other PDN router interface must also operate in static cellular system IPv4 mode. The cellular network for each SIM must allocate the same system IP address when the node attaches to the cellular network over either cellular port.
Some wireless service providers require that all packets entering their network from user equipment (UE) attached to their network have a source IP address that matches the IP address that the cellular network assigned to the UE. When this is a requirement and the node is using static cellular system IP mode, the PDN interface must be configured with an IP filter that allows only egress packets with a source IP address that matches the system IP address.
The NSP NFM-P does not require an in-band management VPRN service to manage the node. Instead, the NSP NFM-P uses the system IP address to reach the node.
Static cellular interface IPv4 mode
In the static cellular interface IPv4 mode of operation, the unnumbered interface configured under the PDN router interface is a loopback interface that is assigned a static address on the associated cellular port. This statically assigned IP address does not match the system IP address, which is a private address. When the cellular port associated with the PDN interface attaches to the cellular network, the cellular network assigns the same static IP address to the cellular port as the address assigned to the loopback address under the PDN router interface.
The cellular IP address assigned to the PDN router interface never changes after each subsequent cellular attachment. The static address assigned during the PDN attachment process is then used as the PDN router interface IP address for services operation. The PDN router interface is declared operationally up only when the PDN attachment completes and the IP address assigned by the cellular network matches the PDN router interface loopback address. If the address is not the same, the PDN interface stays operationally down and an alarm is raised.
The following CLI output shows an example of a PDN interface configured for static cellular interface IPv4 mode.
*A:DUT# config# router
interface "pdn-loopback"
address 88.0.0.1/32
loopback
no shutdown
exit
interface "pdn1-sim1" pdn
port 1/1/1
unnumbered "pdn-loopback"
no shutdown
exit
exit
exit
When operating in static cellular interface IPv4 mode, consider the following points.
Some wireless service providers require that all packets entering their network from UE attached to their network have a source IP address that matches the IP address that the cellular network assigned to the UE. When this is a requirement and the node is using static cellular interface IPv4 mode, the PDN interface must be configured with an IP filter that allows only egress packets that have a source IP address that matches the IP address that was assigned during the PDN attachment. A filter must be configured on each PDN router interface that requires filtering.
The system IP address used by the NSP NFM-P to manage the node is a private IP address. An in-band management VPRN service is required for the NSP NFM-P to reach the node.
Dynamic cellular interface IPv4 mode
In the dynamic cellular interface IPv4 mode of operation, the unnumbered interface configured under the PDN router interface is a loopback interface that has no IP address assigned to it. When the cellular port associated with the PDN interface attaches to the cellular network, the cellular network assigns a dynamic IP address to the cellular port, which is then used as the IP address for the loopback interface under the PDN router interface.
Because cellular IP address allocation is dynamic, the address changes during every PDN attachment. Because the loopback interface associated with the PDN router interface is not configured with any IP address, this allows the node to learn the IP address assigned during the PDN attachment process and then assign that address to the loopback interface. The PDN router interface remains fixed to that address until the cellular port goes down and another PDN attachment is performed. This mode of operation is useful in applications where using dynamic address pools simplifies management and deployment of large numbers of nodes.
In this mode, the PDN router interface is operationally up when the system verifies that the IP address assigned to the interface does not conflict with any other IP address configured on the system. If there is a conflict, the PDN router interface is kept down.
The following CLI output shows an example of a PDN router interface configured for dynamic cellular interface IPv4 mode.
*A:DUT# config# router
interface "pdn1-loopback"
loopback
no shutdown
exit
interface "pdn1-sim1" pdn
port 1/1/1
unnumbered "pdn-loopback"
no shutdown
exit
exit
exit
When using dynamic cellular interface IPv4 mode, consider the following points:
IP/MPLS services cannot be anchored to a fixed address on the node. Instead, only those IP/MPLS services that support dynamic IP address learning and behaviors are supported, such as VPRNs with auto-bind or Layer 2 services using pseudowire templates configured with auto-gre-sdp. See Services overview for more information.
Some wireless service providers require that all packets entering their network from UE attached to their network have a source IP address that matches the IP address that the cellular network assigned to the UE. When this is a requirement, dynamic cellular interface IPv4 mode should not be used; instead, static cellular interface IPv4 mode should be used. When dynamic cellular interface IPv4 mode is used, there is no way to ensure all packets will meet the source IP address requirement as the node cannot filter a dynamically changing source IP address.
The system IP address used by the NSP NFM-P to manage the node is a private IP address. An in-band management VPRN service is required for the NSP NFM-P to reach the node.
Static cellular interface IPv6 mode
In the static cellular interface IPv6 mode of operation, the PDN router interface IPv6 address is configured using the config>router>interface interface-name pdn>ipv6>address command. The cellular IP address assigned to the PDN router interface is never expected to change after each subsequent attachment to the cellular network. The address configured for the PDN router interface must be within the subnet of the network-assigned static IPv6 address upon PDN attachment, and the configured address cannot be the exact address assigned during the attachment. If the configured address is not within the subnet of the network-assigned IPv6 address or matches the network-assigned IPv6 address, then an alarm is raised and the PDN router interface is kept down.
The following CLI output shows an example of a PDN interface configured for static cellular interface IPv6 mode.
A:DUT# config# router
interface "pdn1-sim1" pdn
port 1/1/1
ipv6
address fd00:1:1:1::1/64
exit
no shutodwn
exit
exit
exit
When operating in static cellular interface IPv6 mode, consider the following points:
GRE-MPLS based services are not supported as those packets use IPv4 addresses.
IPSec secure interfaces are supported.
Some wireless service providers require that all packets entering their network from UE attached to their network have a source IP address that is within the IPv6 subnet assigned during the PDN attachment process. When this is a requirement and the node is using static cellular interface IPv6 mode, the PDN interface must be configured with an IP filter that allows only egress packets that have a source IP address that is within the subnet that was assigned during the PDN attachment. A filter must be configured on each PDN router interface that requires filtering.
The system IP address used by the NSP NFM-P to manage the node is a private IPv4 address. An in-band management VPRN service is required for the NSP NFM-P to reach the node.
Dynamic cellular interface IPv6 mode
In the dynamic cellular interface IPv6 mode of operation, the PDN router interface is not configured with an IPv6 address using the config>router>interface interface-name pdn>ipv6>address command. Instead, the IP address and subnet is learned by the PDN router interface each time the cellular interface attaches to the network. The IP address can change with each attachment. This mode of operation is useful in applications where using a dynamic address pool simplifies the management and deployment of large numbers of nodes.
Upon PDN attachment, the system dynamically allocates an IPv6 address that exists within the subnet of the IPv6 address assigned by the network during the cellular attachment. The PDN router interface remains fixed to that address until the cellular port goes down and another cellular attachment is performed.
In this mode, the PDN router interface is operationally up when the system verifies that the IP address and subnet assigned to the interface does not conflict with any other IP address and subnet configured on the system. If there is a conflict, the PDN router interface is kept down.
The following CLI output shows an example of a PDN router interface configured for dynamic cellular interface IPv6 mode.
*A:DUT# config# router
interface "pdn1-sim1" pdn
port 1/1/1
ipv6
exit
no shutdown
exit
exit
exit
When using dynamic cellular interface IPv6 mode, the following points apply.
GRE-MPLS based services are not supported as those packets use IPv4 addresses.
IPSec secure interfaces are supported.
Some wireless service providers require that all packets entering their network from UE attached to their network have a source IP address that is within the subnet -assigned IPv6 address and the subnet assigned to the UE during the cellular network attachment. When this is a requirement, dynamic cellular interface IPv6 mode should not be used; instead, static cellular interface IPv6 mode should be used. When dynamic cellular interface IPv6 mode is used there is no way to ensure that all packets will meet the source IP address requirement as the node cannot filter a dynamically changing source IP address.
The system IP address used by the NSP NFM-P to manage the node is a private IPv4 address. An in-band management VPRN service is required for the NSP NFM-P to reach the node.
DHCP client
In the base router context, Ethernet ports and the WLAN station port can be configured with a router interface that supports a DHCP client. When the node operates as a DHCP client, it learns the IP address of the interface via dynamic IP address assignment. The DHCP client functionality is enabled by issuing the no shutdown command on the DHCP client in the config>router>interface>autoconfigure>dhcp-client context. The following output shows an example of a router interface enabled as a DHCP client.
*A:DUT# config# router interface "station-wlan-ifc"
port 1/4/4
autoconfigure dhcp-client
no shutdown
exit
exit
The 7705 SAR-Hm supports up to three DHCP clients per node, one on the WLAN station port and two on Ethernet ports. The 7705 SAR-Hmc supports up to three DHCP clients on Ethernet ports.
When the DHCP client is enabled, changes to the DHCP client configuration take effect when the shutdown command is issued followed by the no shutdown command.
If DHCP relay configurations exist on the node, the DHCP client cannot be enabled until the DHCP relay configurations are removed. Similarly, if DHCP client configurations exist on the node, DHCP relay cannot be enabled until the DHCP client configurations are removed.
The DHCP client only supports IPv4.
When the DHCP client first becomes operational, learns an IP address from a remote DHCP server using a DHCP DISCOVER message.
The node will only send a DHCP DISCOVER message if:
the DHCP client is enabled and the router interface is operationally up. Shutting down the DHCP client forces the release of the IP address.
a DHCP NAK message is received from the DHCP server that invalidates the previous DHCP DISCOVER message or any existing lease
When a DHCP client is shut down, all cached values (such as IP addresses and DHCP options) are cleared. They are rediscovered by issuing the no shutdown command.
If the port comes operationally up while the DHCP client is enabled and a DHCP discovery was not previously completed or a DHCP release was previously issued, then DHCP discovery is performed. If the port comes operationally up while the DHCP client is enabled and there was a previously completed DHCP discovery, then the DHCP client performs a DHCP REQUEST using the previously cached DHCP information from the discovery.
The operator can force a rediscovery procedure by executing the restart command in the tools>perform>router>autoconfigure>dhcp-client interface context.
The requested DHCP lease time can be configured using the CLI; however, the DHCP server can override this value. The node tracks the DHCP lease time and sends a DHCP REQUEST when half the lease time has elapsed. An IP address lease can be renewed manually using the tools>perform>router>autoconfigure>dhcp-client interface lease-renew command.
If the router interface goes down, the DHCP client parameters are cached for the interface. When the interface comes back up, if an IP address has been allocated and the lease time has not expired, the DHCP router interface will send a DHCP REQUEST to confirm that it can continue to use the IP address associated with the lease.
DHCP options must be configured in the CLI to make use of options received by the DHCP server. Any options received from the DHCP server are ignored if the corresponding options are not specified in the CLI. The DHCP client options are router, static-route, and dns-server. They are configured in the config>router> interface>autoconfigure>dhcp-client>request-options context.
The operator can use the show>router>route-table protocol dhcp-client command to view the active routes in the routing table that have been learned by the DHCP client. If the same route is received from more than one DHCP client, the route received from the DHCP server with the lowest ID (option 54) is installed in the route table.
The operator can use the show>router>dns command to view whether the DNS server has been configured to send request messages to the DHCP server. The node supports up to six DNS server entries learned by the DHCP clients. Only the first six DNS servers are stored by the node; any subsequent DNS servers that are learned will be ignored.
The CLI provides the option to use the router from the DHCP OFFER as the default gateway. In some scenarios, the router that is reachable via the WLAN port or an Ethernet port will be the default gateway. In other scenarios, the cellular interface will have reachability to the default gateway. The DHCP client router CLI option (under request-options) enables the router request option in the DHCP OFFER message. If the router option is enabled, the default gateway is assigned by the DHCP server.
The DHCP DISCOVER message sent from the node to the DHCP server contains the following options:
chaddr—the MAC address of the client, either the WLAN or Ethernet port
Option 51—the configured IP address lease time
Option 53—the DHCP message type (DISCOVER)
Option 60—a user-configurable vendor class identifier, either a hexadecimal string or an ASCII string
Option 61—a user-defined client identifier: a hexadecimal string, an ASCII string, an interface name, or the client MAC address
Option 55—the parameter request list:
Option 1—the subnet mask value
Option 3—the router option, a list of IP addresses for routers on the client subnet (unused if not enabled in the CLI)
Option 54—the DHCP server address
The DHCP OFFER message from the DHCP server must contain the following options at a minimum:
yiaddr—the DHCP router interface IP address
Option 1—the subnet mask value
Option 3—the router option, a list of IP addresses for routers on the client subnet
Option 51—the configured IP address lease time
Option 53—the DHCP message type (OFFER)
Option 54—the DHCP server address
When responding to the server DHCP OFFER or when extending the time of an existing lease, the DHCP REQUEST message sent from the node to the DHCP server contains the following options:
chaddr—the client MAC address
Option 50—the requested IP address; this address is the same as the address contained in the yiaddr field that was received in the DHCP OFFER message
Option 53—the DHCP message type (REQUEST)
Option 54—the DHCP server address; this address is the same as the address received in the OFFER message
Option 51—the IP address lease time; this value is the same as the lease time received in the OFFER message
Option 60—the vendor class identifier; this value is the same as the vendor class identifier in the DISCOVER message
Option 61—the client identifier; this value is the same as the client identifier in the DISCOVER message
Option 55—the parameter request list:
Option 1—the subnet mask value
Option 3—the router option (unused if not enabled in the CLI)
Option 6—the DNS server option (unused if not enabled in the CLI)
Option 54—the DHCP server address
Option 121—the static-route option (unused if not enabled in the CLI)
When the DHCP client is shut down, a DHCP RELEASE message is sent to the DHCP server.
For BGP peers to other nodes behind the WLAN AP, the BGP local address can be set using the router interface name where the DHCP client is configured so that changes in the interface address because of DHCP messages are reflected in the local address of BGP sessions using this interface as the local address. For information about configuring services over a router interface enabled as a DHCP client, see Services over Ethernet with DHCP client.
Restrictions on configuring a router interface with DHCP client enabled
When a DHCP client is enabled on a router interface, the following commands cannot be configured in the config>router>interface context:
address
secondary
dhcp
unnumbered
loopback
If any of the commands listed above are enabled, the no shutdown command is not available for the DHCP client until the commands are removed.
Route policy option for DHCP client
Routes can be imported from the DHCP client to other routing protocols with the config>router>policy-options>policy-statement>entry>from>protocol dhcp-client command.
GRE termination for services over a DHCP client
A router interface configured as a DHCP client supports the following service types: VLL, VPLS, and VPRN. These services use a GRE SDP as a transport tunnel.
When a DHCP client is enabled on a router interface and an address is learned by the client, there is no configuration required in order to terminate GRE SDPs on that interface IP address. GRE termination is enabled on a DHCP client address when the client learns the address. For information about configuring services over a router interface enabled as a DHCP client, see Services over Ethernet with DHCP client.
Router interface command reference
PDN router interface configuration and show command hierarchies
The following PDN router interface commands are supported on the 7705 SAR-Hm series of routers.
For a description of the commands shown in black text, see the 7450 ESS, 7750 SR, 7950 XRS, and VSR Classic CLI Command Reference Guide and the 7450 ESS, 7750 SR, 7950 XRS, and VSR Clear, Monitor, Show, and Tools CLI Command Reference Guide.
The commands shown in red text apply specifically to the PDN interface on the 7705 SAR-Hm series and are described in this guide.
config
- router [router-name]
- [no] interface interface-name pdn
- cpu-protection policy-id
- no cpu-protection
- description description-string
- no description
- [no] enable-ingress-stats
- group-encryption
- no group-encryption
- encryption-keygroup keygroup-id direction {inbound | outbound}
- no encryption-keygroup direction {inbound | outbound}
- ip-exception filter-id direction {inbound | outbound}
- no ip-exception direction {inbound | outbound}
- hold-time
- up ip seconds
- no up ip
- down ip seconds [init-only]
- no down
- icmp
- [no] mask-reply
- param-problem [number seconds]
- no param-problem
- redirects [number seconds]
- no redirects
- ttl-expired [number seconds]
- no ttl-expired
- unreachables [number seconds]
- no unreachables
- if-attribute
- [no] admin-group group-name [group-name...(up to 5 max)]
- no admin-group
- [no] srlg-group group-name [group-name...(up to 5 max)]
- no srlg-group
- ingress
- filter ip ip-filter-id
- no filter ip ip-filter-id
- ip-mtu octets
- no ip-mtu
- [no] ipv6
- address ipv6-address/prefix-length [eui-64] [track-srrp srrp-instance] [modifier cga-modifier] [dad-disable] [primary-preference primary-reference]
- no address ipv6-address/prefix-length
- [no] ntp-broadcast
- port port-id
- no port
- qos network-policy-id [egress-port-redirect-group queue-group-name] [egress-instance instance-id]] [ingress-fp-redirect-group queue-group-name ingress-instance instance-id]
- no qos
- [no] shutdown
- tos-marking-state {trusted | untrusted}
- no tos-marking-state
- unnumbered [ip-addr | ip-int-name]
- no unnumbered
show
- router interface interface-name
DHCP client configuration, show, tools, debug, and clear command hierarchies
The following router interface commands are supported on the 7705 SAR-Hm series of routers for a DHCP client in the IPv4 mode of operation.
The commands shown in red text apply specifically to a DHCP client on the 7705 SAR-Hm series and are described in this guide.
For a description of the commands shown in black text, see the 7450 ESS, 7750 SR, 7950 XRS, and VSR Classic CLI Command Reference Guide and the 7450 ESS, 7750 SR, 7950 XRS, and VSR Clear, Monitor, Show, and Tools CLI Command Reference Guide.
config
- router [router-name]
- [no] interface interface-name
- autoconfigure
- dhcp-client
- class-id [hex hex-string] [string ascii-string]
- no class-id
- client-id [hex hex-string] [interface] [string ascii-string] [use-mac]
- no client-id
- lease-time [days days] [hrs hours] [min minutes] [sec seconds] [infinite]
- request-options
- [no] dns-server
- [no] router
- [no] static-route
- [no] shutdown
show
- router
- autoconfigure
- dhcp-client interface ip-int-name
- dhcp-client interface ip-int-name routes
- dhcp-client interface ip-int-name statistics
- interface interface-name detail
- dns
- route-table [family] [ip-prefix[/prefix-length] [longer | exact | protocol protocol-name] [instance instance-id] [all] [next-hop-type type] [qos] [alternative]
- route-table [family] summary
- route-table family [ip-prefix[/prefix-length] [longer | exact | protocol protocol-name] [instance instance-id] extensive [all]
tools
- dump
- router
- autoconfigure
- dhcp-client interface ip-int-name offer
- dhcp-client interface ip-int-name offer config-apply-status
- dhcp-client interface ip-int-name offer raw
tools
- perform
- router
- autoconfigure
- dhcp-client interface ip-int-name lease-renew
- dhcp-client interface ip-int-name restart
debug
- router
- autoconfigure
- dhcp-client interface ip-int-name
- [no] events
- [no] packet
- detail-level {low | medium | high}
- no detail-level
- mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}
- no mode
- [no] rtm
clear
- router
- autoconfigure
- dhcp-client interface ip-int-name statistics
PDN router interface command descriptions
The commands and parameters described in this section apply specifically to the PDN router interface on the 7705 SAR-Hm series of routers. All other applicable commands, as listed in PDN router interface configuration and show command hierarchies, are described in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Classic CLI Command Reference Guide.
interface
Syntax
interface interface-name pdn
no interface pdn
Context
config>router
Description
This command creates a logical IP router interface for the packet data network (PDN). PDN router interfaces are always network-facing interfaces. When created, attributes such as IP address, port, or system can be associated with the IP interface.
A PDN router interface can be configured for each cellular port.
The no form of the command removes the interface.
Parameters
- interface-name
-
an alphanumeric character string describing the interface name, up to a maximum of 32 characters. The interface name must begin with a letter.
- pdn
-
a mandatory keyword specifying that the interface represents a PDN
port
Syntax
port port-id
no port
Context
config>router>interface
Description
This command binds the PDN router interface to a physical port. The default value is the only supported port identifier.
Default
1/1/1
Parameters
- port-id
-
a value equal to the cellular port identifier on the 7705 SAR-Hm series, configured in the config>port context and in the format slot/mda/port
router
Syntax
router interface interface-name
Context
show
Description
This command displays PDN router interface information.
Output
The following output is an example of PDN router interface information.
*A:Dut# show router interface "pdntest"
===============================================================================
Interface Table (Router: Base)
===============================================================================
Interface-Name Adm Opr(v4/v6) Mode Port/SapId
IP-Address PfxState
-------------------------------------------------------------------------------
pdntest Up Down/Down Pdn n/a
- -
-------------------------------------------------------------------------------
Interfaces : 1
===============================================================================
*A:Dut#
DHCP client command descriptions
The commands and parameters described in this section apply specifically to a DHCP client operating in IPv4 mode on the 7705 SAR-Hm series of routers. All other applicable commands, as listed in DHCP client configuration, show, tools, debug, and clear command hierarchies, are described in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Classic CLI Command Reference Guide.
autoconfigure
Syntax
autoconfigure
Context
config>router>interface
Description
This command enables the context to autoconfigure a DHCP client.
dhcp-client
Syntax
dhcp-client
Context
config>router>interface>autoconfigure
Description
This command enables the context to configure DHCP client parameters.
class-id
Syntax
class-id [hex hex-string][string ascii-string]
no class-id
Context
config>router>interface>autoconfigure>dhcp-client
Description
This command configures the vendor class identifier (option 60) for the DHCP client.
The no form of the command deletes the vendor class identifier configuration.
Default
n/a
Parameters
- hex-string
-
specifies the vendor class identifier for the DHCP client as a hexadecimal string
- ascii-string
-
specifies the vendor class identifier for the DHCP client as an ASCII string
client-id
Syntax
client-id [hex hex-string][interface][string ascii-string][use-mac]
no client-id
Context
config>router>interface>autoconfigure>dhcp-client
Description
This command configures the identifier for the DHCP client (option 61).
The no form of the command deletes the client identifier configuration.
Default
use-mac
Parameters
- hex-string
-
specifies the client identifier as a hexadecimal string
- interface
-
specifies the IPv4 interface name as the client identifier
- ascii-string
-
specifies the client identifier as an ASCII string
- use-mac
-
specifies the IPv4 MAC address of the associated port as the client identifier
lease-time
Syntax
lease-time [days days] [hrs hours] [min minutes] [sec seconds] [infinite]
Context
config>router>interface>autoconfigure>dhcp-client
Description
This command configures the lease time granted by the DHCP server to the DHCP client.
Default
1 day
Parameters
- days
-
specifies the lease time in days
- hours
-
specifies the lease time in hours
- minutes
-
specifies the lease time in minutes
- seconds
-
specifies the lease time in seconds
- infinite
-
specifies that the lease never expires
request-options
Syntax
request-options
Context
config>router>interface>autoconfigure>dhcp-client
Description
This command configures the DHCP options for the request messages sent to the DHCP server.
Default
n/a
dns-server
Syntax
[no] dns-server
Context
config>router>interface>autoconfigure>dhcp-client>request-options
Description
This command enables the DNS server request option in the DHCP OFFER message from the DHCP server if the server supports it. If this option is enabled, it specifies a list of DNS servers available to the client.
The no form of the command disables DNS server as a request option.
Default
n/a
router
Syntax
[no] router
Context
config>router>interface>autoconfigure>dhcp-client>request-options
Description
This command enables the router request option in the DHCP OFFER message from the DHCP server if the server supports it. If this option is enabled, the default gateway is assigned by the DHCP server.
The no form of the command disables router as a request option.
Default
n/a
static-route
Syntax
[no] static-route
Context
config>router>interface>autoconfigure>dhcp-client>request-options
Description
This command enables the static route request option in the DHCP OFFER message from the DHCP server if the server supports it. If this option is enabled, it specifies a list of classless static routes (that is, the destination network addresses in these static routes include subnet masks) that a client should add to its routing table.
The no form of the command disables static route as a request option.
Default
n/a
shutdown
Syntax
[no] shutdown
Context
config>router>interface>autoconfigure>dhcp-client
Description
This command administratively disables the DHCP client.
The no form of the command enables the DHCP client.
Default
n/a
dhcp-client
Syntax
dhcp-client interface ip-int-name
dhcp-client interface ip-int-name routes
dhcp-client interface ip-int-name statistics
Context
show>router>autoconfigure
Description
This command displays DHCP client information.
Parameters
- ip-int-name
-
displays DHCP client information associated with the specified IP interface name
- routes
-
displays routing table information for routes received by the DHCP protocol
- statistics
-
displays DHCP client statistics
Output
The following outputs are examples of DHCP client information:
-
DHCP client information associated with the specified interface name (Output example (for the specified interface name)
-
DHCP client routing table information for routes received by the DHCP protocol (Output example (for DHCP client routing table information)
-
DHCP client statistics (Output example (for DHCP client statistics)
*A:Dut-B# show router autoconfigure dhcp-client interface "to-dhcp"
===============================================================================
DHCP Client state
===============================================================================
Client IP address : 51.53.2.17/24
Client MAC address : 90:3a:a0:f0:ba:d5
Server Identifier : 51.54.2.1
Router IP address : (Not Specified)
Primary DNS : 138.120.252.55
Secondary DNS : 138.120.252.57
Tertiary DNS : (Not Specified)
Lease acquired time : 2021/05/06 23:09:46
Lease renew time : 2021/05/07 05:09:46
Lease rebind time : 2021/05/07 09:39:46
Lease end time : 2021/05/07 11:09:46
DHCP RFC protocol state : bound
DHCP client user status : established
Description : nexthop 51.53.2.1 is reachable (for
routes 135.0.0.0/8)
===============================================================================
*A:Dut-B# show router autoconfigure dhcp-client interface "to-dhcp" routes
===============================================================================
DHCP client interface route table
===============================================================================
Prefix Status
Next-hop
(Reason)
-------------------------------------------------------------------------------
135.0.0.0/8 installed
51.53.2.1
-------------------------------------------------------------------------------
No. of routes: 1
===============================================================================
*A:Dut-B# show router autoconfigure dhcp-client interface "to-dhcp" statistics
===============================================================================
DHCP Client statistics
===============================================================================
DHCPDISCOVER messages : 10
DHCPREQUEST messages : 8
DHCPRELEASE messages : 7
DHCPDECLINE messages : 0
DHCPOFFER messages : 8
DHCPACK messages : 8
DHCPNAK messages : 0
messages dropped : 0
Statistics last cleared time : N/A
===============================================================================
autoconfigure
Syntax
autoconfigure
Context
tools>dump>router
Description
This command enables the context to display autoconfiguration information for debugging purposes.
dhcp-client
Syntax
dhcp-client interface ip-int-name offer
dhcp-client interface ip-int-name offer config-apply-status
dhcp-client interface ip-int-name offer raw
Context
tools>dump>router>autoconfigure
Description
This command displays IPv4 DHCP client information for debugging purposes.
Parameters
- ip-int-name
-
the IP interface name associated with the DHCP client
- offer
-
displays the contents of the OFFER message
- config-apply-status
-
displays the configured DHCP options from the DHCP server OFFER message that are applied to the DHCP client and the status of these options
- offer raw
-
displays the contents of the OFFER message in hexadecimal format
autoconfigure
Syntax
autoconfigure
Context
tools>perform>router
Description
This command enables the context to perform autoconfiguration operations.
dhcp-client
Syntax
dhcp-client interface ip-int-name lease-renew
dhcp-client interface ip-int-name restart
Context
tools>perform>router>autoconfigure
Description
This command performs IPv4 DHCP client lease operations.
Parameters
- ip-int-name
-
the IP interface name associated with the DHCP client
- lease-renew
-
performs DHCP client operations associated with lease renewals
- restart
-
performs DHCP client operations associated with lease restarts
autoconfigure
Syntax
autoconfigure
Context
debug>router
Description
This command enables the context to perform autoconfiguration debugging operations.
dhcp-client
Syntax
dhcp-client interface ip-int-name
Context
debug>router>autoconfigure
Description
This command enables debugging for an IPv4 DHCP client.
Parameters
- ip-int-name
-
the IP interface name associated with the DHCP client
events
Syntax
[no] events
Context
debug>router>autoconfigure>dhcp-client
Description
This command enables or disables debugging for all DHCP client events.
packet
Syntax
[no] packet
Context
debug>router>autoconfigure>dhcp-client
Description
This command enables or disables debugging for all DHCP client packets.
detail-level
Syntax
detail-level {low | medium | high}
no detail-level
Context
debug>router>autoconfigure>dhcp-client>packet
Description
This command sets the level of detail for packet tracing.
Parameters
- low
-
specifies a low tracing detail level
- medium
-
specifies a medium tracing detail level
- high
-
specifies a high tracing detail level
mode
Syntax
mode {dropped-only | ingr-and-dropped | egr-ingr-and-dropped}
no mode
Context
debug>router>autoconfigure>dhcp-client>packet
Description
This command specifies the types of packets to be debugged.
Parameters
- dropped-only
-
specifies to debug dropped packets only
- ingr-and-dropped
-
specifies to debug ingress packets and dropped packets
- egr-ingr-and-dropped
-
specifies to debug egress packets, ingress packets, and dropped packets
rtm
Syntax
[no] rtm
Context
debug>router>autoconfigure>dhcp-client
Description
This command enables or disables debugging for the addition, removal, and modification of DHCP client routes to the system Route Table Manager.
autoconfigure
Syntax
autoconfigure
Context
clear>router
Description
This command enables the context to clear autoconfigured DHCP client information.
dhcp-client
Syntax
dhcp-client interface ip-int-name statistics
Context
clear>router>autoconfigure
Description
This command clears IPv4 DHCP client statistics.
Parameters
- ip-int-name
-
the IP interface name associated with the DHCP client
- statistics
-
clears DHCP client statistics
Filter policy support
For general information about filter policy support, see the following topics in the 7450 ESS, 7750 SR, 7950 XRS, and VSR Router Configuration Guide, "Filter Policies":
ACL filter policy overview
Filter policy basics
Filter policy packet match criteria
IPv4/IPv6 filter policy entry match criteria
IP exception filters
Filter policy actions
Viewing filter policy actions
Filter policy statistics
Filter policy logging
Filter policy management
Filter policy advanced topics
Match list for filter policies
Filter policy scope and embedded filters
IP exception filters
Configuring filter policies with CLI
Common configuration tasks
Creating an IPv4 filter policy
Creating an IPv6 filter policy
Creating an IPv4 exception filter policy
Creating an IPv6 exception filter policy
Creating a match list for filter policies
Applying filter policies
Creating a redirect policy
Filter management tasks
For descriptions of filter commands, see the 7450 ESS, 7750 SR, 7950 XRS, and VSR Classic CLI Command Reference Guide and the 7450 ESS, 7750 SR, 7950 XRS, and VSR Clear, Monitor, Show, and Tools CLI Command Reference Guide.