Cisco IOS IP Mobility Command Reference
nai (proxy mobile ipv6) through tunnel mode gre
Downloads: This chapterpdf (PDF - 2.16MB) The complete bookPDF (PDF - 4.44MB) | The complete bookePub (ePub - 526.0KB) | Feedback

nai (proxy mobile ipv6) through tunnel mode gre

Contents

nai (proxy mobile ipv6) through tunnel mode gre

network

To associate a network, to which an IPv4 or IPv6 pool can be configured, with a Local Mobility Anchor (LMA) or a mobile node (MN), use the network command in LMA configuration mode or MN configuration mode. To disassociate the network from the LMA or MN, use the no form of this command.

network name

no network name

Syntax Description

name

Name of the network to be associate with the LMA.

Command Default

No network is associated.

Command Modes

Mobile node configuration (config-ipv6-pmipv6-domain-mn)

LMA configuration mode (config-ipv6-pmipv6-lma)

Command History

Release

Modification

Cisco IOS XE Release 3.6S

This command was introduced.

Usage Guidelines

Use the network command in LMA configuration mode or MN configuration mode, to associate a network, to which an IPv4 or IPv6 pool can be configured, with an LMA or MN. You can associate only one IPv4 or IPv6 pool to a network. The name of the network configured in an LMA is recorded as an attribute in the MN profile.

Examples

The following example shows how to associate a network with an LMA:

Device(config)# ipv6 mobile pmipv6-lma lma1 domain dn1
Device(config-ipv6-pmipv6-lma)# address ipv4 192.0.2.1
Device(config-ipv6-pmipv6-lma)# network network1

The following example shows how to associate a network to with an MN:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# nai example1@example.com
Device(config-ipv6-pmipv6-domain-mn)# network network1

Related Commands

Command

Description

ipv6 mobile pmipv6-lma

Configures the LMA for the PMIP domain.

ipv6 mobile pmipv6-domain

Configures a PMIP domain.

nai (proxy mobile IPv6)

To configure the Network Access Identifier (NAI) for the mobile node (MN) within the PMIPV6 domain, use the nai command in PMIPV6 domain configuration mode. To disable the NAI configuration, use the no form of this command.

nai [user] @realm

no nai [user] @realm

Syntax Description

user@realm

Fully qualified specific user address and realm. The @ symbol is required.

@realm

Any user address at a specific realm. The @ symbol is required.

Command Default

NAI for the MN is not specified.

Command Modes


PMIPV6 domain configuration (config-ipv6-pmipv6-domain)

Command History

Release

Modification

Cisco IOS XE Release 3.4S

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Examples

The following example shows how to configure the NAI within the PMIPV6 domain:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# nai example@example.com
Device(config-ipv6-pmipv6-domain-mn)#

Related Commands

Command

Description

ipv6 mobile pmipv6-domain

Configures the PMIPV6 domain.

network (mobile networks)

To specify a list of mobile networks for a mobile router, use the network command in mobile networks configuration mode. To remove an entry, use the no form of this command.

network net mask

no network net mask

Syntax Description

net

IP address of the directly connected networks.

mask

Network mask.

Command Default

No networks are specified.

Command Modes


Mobile networks configuration

Command History

Release

Modification

12.2(4)T

This command was introduced.

Usage Guidelines

When the mobile router is registered, the home agent injects the mobile networks into its routing table.

Examples

The following configuration example shows how to associate the mobile router address, 10.1.1.10, with the mobile networks:

Examples

ip mobile router
  address 10.1.1.10 255.255.255.0
  home-agent 10.1.1.20
ip mobile secure home-agent 10.1.1.20 spi 100 key hex 12345678123456781234567812345678

Examples

! mobile host is mobile router address
ip mobile host 10.1.1.10 virtual-network 10.0.0.0 255.0.0.0
! associates mobile router address with mobile networks
ip mobile mobile-networks 10.1.1.10
  description jet
  network 172.6.1.0 255.255.255.0
ip mobile secure host 10.1.1.10 spi 100 key hex 12345678123456781234567812345678

Related Commands

Command

Description

show ip mobile mobile-networks

Displays a list of mobile networks associated with the mobile router.

outdscp

To specify a differentiated services code point (DSCP) value used for the outbound IP multiplexed superframe for the policy, use the outdscp command in IPv4 multiplexing policy configuration or IPv6 multiplexing policy configuration mode. To return to the default setting, use the no form of this command.

outdscp DSCP-value

no outdscp

Syntax Description

DSCP-value

DSCP value. The range is 0 to 63. The following DSCP values are also valid:

  • af11 —Match packets with AF11 DSCP (001010)
  • af12 —Match packets with AF12 DSCP (001100)
  • af13 —Match packets with AF13 DSCP (001110)
  • af21 —Match packets with AF21 DSCP (010010)
  • af22 —Match packets with AF22 DSCP (010100)
  • af23 —Match packets with AF23 DSCP (010110)
  • af31 —Match packets with AF31 DSCP (011010)
  • af32 —Match packets with AF32 DSCP (011100)
  • af33 —Match packets with AF33 DSCP (011110)
  • af41 —Match packets with AF41 DSCP (100010)
  • af42 —Match packets with AF42 DSCP (100100)
  • af43 —Match packets with AF43 DSCP (100110)
  • cs1 —Match packets with CS1 (precedence 1) DSCP (001000)
  • cs2 —Match packets with CS2 (precedence 2) DSCP (010000)
  • cs3 —Match packets with CS3 (precedence 3) DSCP (011000)
  • cs4 —Match packets with CS4 (precedence 4) DSCP (100000)
  • cs5 —Match packets with CS5 (precedence 5) DSCP (101000)
  • cs6 —Match packets with CS6 (precedence 6) DSCP (110000)
  • cs7 —Match packets with CS7 (precedence 7) DSCP (111000)
  • default —Match packets with default DSCP (000000)
  • ef —Match packets with EF DSCP (101110)

Command Default

Superframes are sent with the DSCP bit set to 0.

Command Modes


IP multiplexing policy configuration (config-ipmux-policy)


IPv6 multiplexing policy configuration (config-ipmux-policy-v6)

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

If you do not enter a value for the outdscp command, superframes are sent with the DSCP bit set as 0.

Examples

The following example shows how to configure the DSCP value to 10 for the outbound multiplexed superframe in the IPv6 multiplexing policy routeRTP-SJ :

Router# configure terminal
Router(config)# ipv6 mux policy routeRTP-SJ
Router(config-ipmux-policy-v6)# outdscp 10
Router(config-ipmux-policy-v6)# exit
Router(config)#

Related Commands

Command

Description

ip mux policy

Creates an IPv4 multiplexing DSCP policy with a specified name.

ipv6 mux policy

Creates an IPv6 multiplexing DSCP policy with a specified name.

show mux

Displays general IP multiplexing information.

physical-interface

To create a physical subinterface and to associate it with the Virtual Multipoint Interface (VMI) on a router, use the physical-interface command in interface configuration mode. To return to the default mode, use the no form of this command.

physical-interface interface-type /slot

no physical-interface interface-type /slot

Syntax Description

interface-type

Type of interface or subinterface.

/ slot

Slot in which the interface is present.

Command Default

No physical interface exists.

Command Modes

Interface configuration (config-if)

Command History

Release

Modification

12.4(15)XF

This command was introduced.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T to support VMIs in Mobile Adhoc Router-to-Radio Networks.

12.4(24)T

This command was modified. This command supports the subinterfaces and VLANS associated with an interface.

Usage Guidelines

The physical-interface command supports the subinterfaces and VLANs associated with an interface. This command also allows VMI interface to operate over encapsulated interfaces, if required. Only one physical interface can be assigned to a VMI interface. Because there is very high number of VMI interfaces that can be used, assign a new VMI for each physical interface.

Examples

The following example shows how to create a physical subinterface:

Router(config)# interface vmi1
Router(config-if)# physical-interface FastEthernet0/1

Related Commands

Command

Description

debug vmi

Displays debugging output for VMIs.

eigrp interface

Sets a threshold value to minimize hysteresis in a router-to-radio configuration.

interface vmi

Creates a VMI interface.

mode bypass

Enables VMIs to support multicast traffic

pool ipv4

To specify the name of the IPv4 address pool, from which a home address is allocated to a mobile node (MN), in a Local Mobility Anchor (LMA), use the pool ipv4 command in LMA-network configuration mode. To disassociate an IPv4 address pool from an LMA, use the no form of this command.

pool ipv4name pfxlen length

no pool ipv4name pfxlen length

Syntax Description

name

Name of the IPv4 address pool.

pfxlen length

Specifies the prefix length of the pool address.

Command Default

No IPv4 address pool is specified in the LMA for the MN.

Command Modes

LMA-network configuration (config-ipv6-pmipv6lma-network)

Command History

Release

Modification

Cisco IOS XE Release 3.6S

This command was introduced.

Usage Guidelines

Configure the ip local pool command in global configuration mode before using the pool ipv4 command. Use the same pool name that you specified in the ip local pool command, in the pool ipv4 command.

Use the pool ipv4 command in LMA-network configuration mode to specify the name of the IPv4 address pool, from which a home address is allocated to a MN subscriber, in a Local Mobility Anchor (LMA).

Examples

The following example shows how to specify the name of the IPv4 address pool in an LMA:

Device(config)# ipv6 mobile pmipv6-lma lma1 domain dn1
Device(config-ipv6-pmipv6-lma)# network network1
Device(config-ipv6-pmipv6lma-network)# pool ipv4 v4pool pfxlen 24
      

Related Commands

Command

Description

ip local pool

Configures a local pool of IPv4 addresses.

pool ipv6

To specify the name of the IPv6 prefix pool, from which a home network prefix is allocated to a mobile node (MN), in a Local Mobility Anchor (LMA), use the pool ipv6 command in LMA-network configuration mode. To disassociate an IPv6 prefix pool from an LMA, use the no form of this command.

pool ipv6name pfxlen length

no pool ipv6name pfxlen length

Syntax Description

name

Name of the IPv6 prefix pool.

pfxlen length

Specifies the prefix length of the pool address.

Command Default

No IPv6 address pool is specified in the LMA for the MN.

Command Modes


LMA-network configuration (config-ipv6-pmipv6lma-network)
      

Command History

Release

Modification

Cisco IOS XE Release 3.6S

This command was introduced.

Usage Guidelines

Configure the ipv6 local pool in global configuration mode before using the pool ipv6 command. Use the same pool name that you specified in the ipv6 local pool command, in the pool ipv6 command.

Use the pool ipv6 command in LMA-network configuration mode to specify the name of the IPv4 address pool, from which a home address is allocated to a mobile node (MN) subscriber, in a Local Mobility Anchor (LMA).

Examples

The following example shows how to specify the name of the IPv6 address pool in an LMA:

Device(config)# ipv6 mobile pmipv6-lma lma1 domain dn1
Device(config-ipv6-pmipv6-lma)# network network1
Device(config-ipv6-pmipv6lma-network)# pool ipv4 v4pool pfxlen 24
      

Related Commands

Command

Description

ipv6 local pool

Configures a local pool of IPv6 prefixes.

rat

To set the priority of a Radio Access Technology (RAT) type, use the rat command in the third-generation mobility anchor (3GMA) role configuration mode. To remove the priority of a RAT type, use the no form of this command.

rat rat-type priority priority-number

no rat rat-type priority priority-number

Syntax Description

rat-type

Specifies the RAT type.

priority priority-number

Specifies the priority number for the RAT type.

Command Default

None

Command Modes


3GMA role configuration  (config-ipv6-pmipv6lma-role)

Command History

Release

Modification

Cisco IOS XE Release 3.9S

This command was introduced.

Usage Guidelines

The mobility anchor routes packets through tunnels associated with RAT of higher priority. You can set the same priority number for multiple RAT types for load balancing for downstream traffic. For example, you can set priority number 2 to Worldwide Interoperability for Microwave Access(WIMAX) and Wireless Local Area Network (WLAN). The mobility anchor balances traffic and forwards packets by sharing packets between WIMAX and WLAN tunnels.

Examples

The following example show how to set 2 as the priority for WIMAX:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# exit
Device(config)# ipv6 mobile pmipv6-lma lma1 domain dn1
Device(config-ipv6-pmipv6-lma)# rat wimax priority 2
      

The following example show how to set 2 as the priority for WLAN:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# exit
Device(config)# ipv6 mobile pmipv6-lma lma1 domain dn1
Device(config-ipv6-pmipv6-lma)# rat wlan priority 2
      

Related Commands

Command Description
ipv6 mobile pmipv6-lma

Configures the LMA for the PMIP domain.

ipv6 mobile pmipv6-domain

Configures a PMIPv6 domain.

redundancy group

To configure fault tolerance for the mobile router, use the redundancy group command in mobile router configuration mode. To disable this functionality, use the no form of this command.

redundancy group name

no redundancy group name

Syntax Description

name

Name of the mobile router group.

Command Default

No default behavior or values.

Command Modes

Mobile router configuration

Command History

Release

Modification

12.2(4)T

This command was introduced.

Usage Guidelines

The redundancy group command provides f ault tolerance by selecting one mobile router in the redundancy group name argument to provide connectivity for the mobile networks. This mobile router is in the active state. The other mobile routers are passive and wait until the active mobile router fails before a new active mobile router is selected. Only the active mobile router registers and sets up proper routing for the mobile networks. The redundancy state is either active or passive.

Examples

The following example selects the mobile router in the sanjose group, to provide fault tolerance:

ip mobile router
 redundancy group sanjose
 address 10.1.1.10 255.255.255.0
 home-agent 10.1.1.20
 register lifetime 600

Related Commands

Command

Description

standby name

Configures the name of the standby group, which is associated with the mobile router.

register (mobile networks)

To dynamically register the mobile networks with the home agent, use the register command in mobile networks configuration mode. To disable the registration, use the no form of this command.

register

no register

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values.

Command Modes


Mobile networks configuration

Command History

Release

Modification

12.2(13)T

This command was introduced.

Usage Guidelines

When the mobile router registers its mobile networks on the home agent, the home agent looks up the mobile network configuration and verifies that the register command is configured before adding forwarding entries into the home agent forwarding table for the mobile router. If the mobile router is not configured properly, the home agent will reject the request with error code 129.

It is possible to have both statically configured mobile networks and dynamically registered mobile networks. However, static mobile network configurations take precedence over dynamic mobile network registrations. For example, if a mobile router tries to dynamically add (or delete) a mobile network and that network is already statically configured for that mobile router or any other mobile router, then the dynamic mobile network is ignored and an error message is generated.

Similarly, if a mobile router has dynamically added a mobile network, an attempt by another mobile router to dynamically add or delete the same mobile network is ignored and an error message is generated.

Examples

In the following example, the mobile router is configured to dynamically register its mobile networks with the home agent:

router mobile
 ip mobile home-agent
 ip mobile host 10.20.30.4 interface Ethernet 1
!Associated host address that informs HA that 10.20.30.4 is actually an MR
 ip mobile mobile-networks 10.20.30.4
  register
ip mobile secure host 10.20.30.4 spi 100 key hex 12345678123456781234567812345678

Related Commands

Command

Description

ip mobile host

Configures the mobile host or mobile node group.

mobile-network

Specifies the mobile router interface that is connected to the dynamic mobile network.

register (mobile router)

To con trol the registration parameters of the IPv6 mobile router, use the register command in mobile router configuration mode or IPv6 mobile router configuration mode. To return the registration parameters to their default settings, use the no form of this command.

register { extend expire seconds retry number interval seconds | lifetime seconds | retransmit initial milliseconds maximum milliseconds retry number }

no register { extend expire seconds retry number interval seconds | lifetime seconds | retransmit initial milliseconds maximum milliseconds retry number }

Syntax Description

extend

Reregisters before the lifetime expires.

expire seconds

Specifies the time (in seconds) in which to send a registration request before expiration. In IPv4, the range is from 1 to 3600; the default is 120. In IPv6, the range is from 1 to 600.

retry number

Specifies the number of times the mobile router retries sending a registration request if no reply is received. In both IPv4 and IPv6, the range is from 0 to 10; the default is 3. A value of 0 means no retry. The mobile router stops sending registration requests after the maximum number of retries is attempted.

interval seconds

Specifies the time (in seconds) that the mobile router waits before sending another registration request if no reply is received. In IPv4, the range is from 1 to 3600; the default is 10. In IPv6, the range is from 1 to 60.

lifetime seconds

Specifies the requested lifetime (in seconds) of each registration. The shortest value between the configured lifetime and the foreign agent advertised registration lifetime is used. In IPv4, the range is from 3 to 65534; the default is 65534 (infinity). In IPv6, the range is from 4 to 262143; the default is 262143 (infinity). This default ensures that the advertised lifetime is used, excluding infinity.

retransmit initial milliseconds

Specifies the wait period (in milliseconds) before sending a retransmission the first time no reply is received from the foreign agent. In IPv4, the range is from 10 to 10000 milliseconds (10 seconds); the default is 1000 milliseconds (1 second). In IPv6, the range is from 1000 to 256000.

maximum milliseconds retry number

Specifies the maximum wait period (in milliseconds) before retransmission of a registration request. In IPv4, the range is 10 to 10000 (10 seconds); the default is 5000 milliseconds (5 seconds). In IPv6, the maximum range is from 1000 to 256000. In IPv6, the retry number range is from 0 to 10. Each successive retransmission timeout period is twice the previous period, if the previous period was less than the maximum value. Retransmission stops after the maximum number of retries.

Command Default

The registration parameters of the IPv6 mobile router are used.

Command Modes


Mobile router configuration
IPv6 mobile router configuration (IPv6-mobile-router)

Command History

Release

Modification

12.2(4)T

This command was introduced.

12.4(20)T

Support for IPv6 was added.

Usage Guidelines

The register lifetimesecondscommand configures the lifetime that the mobile router requests in a registration request. The home agent also has lifetimes that are set. If the registration request from a mobile router has a greater lifetime than the registration reply from the home agent, the lifetime set on the home agent will be used for the registration. If the registration request lifetime from the mobile router is less than the registration reply from the home agent, the lifetime set on the mobile router will be used. Thus, the smaller lifetime between the home agent and mobile router is used for registration.

Examples

The following example specifies a registration lifetime of 600 seconds:

ip mobile router
 address 10.1.1.10 255.255.255.0
 home-agent 10.1.1.20
 register lifetime 600

Related Commands

Command

Description

ipv6 mobile router

Enables IPv6 NEMO functionality on the router and places the router in IPv6 mobile router mode.

show ip mobile router

Displays configuration information and monitoring statistics about the mobile router.

show ip mobile router registration

Displays the pending and accepted registrations of the mobile router.

replay-protection

To configure the replay protection mechanism within the Proxy Mobile IPv6 (PMIPV6) domain, the Mobile Access Gateway (MAG), or the Local Mobility Anchor (LMA), use the replay-protection command in the appropriate configuration mode. To disable the replay protection mechanism, use the no form of this command.

replay-protection timestamp [ window seconds ]

no replay-protection timestamp

Syntax Description

timestamp

Enables the time stamp.

window seconds

(Optional) Specifies the maximum time difference, in seconds, between the time stamp in the received Proxy Binding Update (PBU) message and the current time of day on the Local Mobility Anchor (LMA).
  • The range is from 1 to 255.

Command Default

The replay protection mechanism is configured with the default time stamp window period is 7 seconds.

Command Modes

LMA configuration (config-ipv6-pmipv6-lma)

MAG configuration (config-ipv6-pmipv6-mag)

PMIP domain configuration (config-ipv6-pmipv6-domain)

Command History

Release

Modification

Cisco IOS XE Release 3.4S

This command was introduced.

Cisco IOS XE Release 3.6S

This command was modified. This command was made available in LMA configuration mode.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

The window period is the maximum time difference, in seconds, between the time stamp in the received PBU message and the current time of day on the LMA that is allowed by the LMA for the received message to be considered valid. The timestamp window seconds keyword-argument pair is the TimestampValidityWindow configuration variable that is documented in RFC 5213, where the default value for the variable is 300 milliseconds, which must be adjusted to suit the deployment.

Use the replay-protection command in PMIPV6 domain configuration mode to configure the replay protection mechanism within the Proxy Mobile IPv6 (PMIPv6) domain.

Use the replay-protection command in MAG configuration mode to configure the replay protection mechanism within the MAG.

Use the replay-protection command in LMA configuration mode to configure the replay protection mechanism within the LMA.

Use the replay-protection timestamp command in PMIPV6 domain configuration mode to configure the replay protection mechanism. If the PMIPV6 domain is configured using the ipv6 mobile pmipv6-domain domain-name load-aaa command, use the replay-protection timestamp command to override the time stamp configuration.

Use the replay-protection timestamp command in MAG configuration mode to configure the replay protection mechanism for the MAG.

While configuring the replay-protection timestamp command, preferably configure Network Time Protocol (NTP) in the device. If the device clocks are not configured with NTP, synchronize the clocks manually.

Examples

The following example shows how to configure the replay protection mechanism with a window period of 200 seconds within the PMIPV6 domain:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# replay-protection timestamp window 200

The following example shows how to reset the replay protection mechanism to the default window period within the MAG:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# exit
Device(config)# ipv6 mobile pmipv6-mag mag1 domain dn1
Device(config-ipv6-pmipv6-mag)# no replay-protection timestamp
 

The following example shows how to reset the replay protection mechanism to the default window period within the LMA:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# exit
Device(config)# ipv6 mobile pmipv6-lma lma1 domain dn1
Device(config-ipv6-pmipv6-mag)# no replay-protection timestamp
 

Related Commands

Command

Description

ipv6 mobile pmipv6-domain

Configures the PMIPV6 domain.

ipv6 mobile pmipv6-mag

Configures the MAG for the PMIPV6 domain.

reverse-tunnel

To enable the reverse tunnel function on the mobile router, use the reverse-tunnelcommand in mobile router configuration mode. To disable the reverse tunnel function, use the no form of this command.

reverse-tunnel

no reverse-tunnel

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values.

Command Modes


Mobile router configuration

Command History

Release

Modification

12.2(4)T

This command was introduced.

Examples

The following example configures reverse tunneling on the mobile router:

ip mobile router
 address 10.1.1.2 255.0.0.0
 home-agent 10.1.1.1
 register extend expire 10 retry 2 interval 2
 reverse-tunnel

Related Commands

Command

Description

show ip mobile router

Displays configuration information and monitoring statistics about the mobile router.

show ip mobile router registration

Displays the pending and accepted registrations of the mobile router.

show ip mobile tunnel

Displays active tunnels.

roaming interface

To specify an interface as a roaming interface for a Mobile Access Gateway (MAG) and set its parameters, use the roaming interface command in the MAG dynamic address configuration mode. To stop an interface from being a roaming interface, use the no form of this command.

roaming interface type number priority priority-value egress-att access-tech-type label egress-label

no roaming interface type number

Syntax Description

interface typenumber

Specifies an interface as the roaming interface.

priority priority-value

Specifies the priority value for the roaming interface. The range is from 1 to 100.

egress-att access-tech-type

Specifies the access technology type of the roaming interface.

label egress-label

Specifies the label for the roaming interface. It can be one of the following values:

  • Ethernet
  • WLAN (Wireless LAN)
  • 3G (third generation)
  • LTE (Long Term Evolution)

Command Default

No roaming interfaces are specified for the MAG.

Command Modes

MAG dynamic address configuration (config-ipv6-pmipv6-mag-addr-dyn)

Command History

Release Modification

15.4(1)T

This command was introduced.

Usage Guidelines

When the multipath feature is not involved in the roaming interface, the higher the priority value that is set in the interface the greater is the preference given to the interface specified as the roaming interface. However, when the multipath feature is involved, the priority value does not make a difference.

Examples

The following example shows how to specify an interface as the roaming interface for the MAG:

Device(config)# ipv6 mobile pmipv6-mag mag1 domain dn1
Device(config-ipv6-pmipv6-mag)# address dynamic
Device(config-ipv6-pmipv6-mag-addr-dyn)# roaming interface ethernet 0/0 priority 2 egress-att LTE label egress1

Related Commands

Command

Description

multipath

Enables multipath support in LMA.

role

To configure the role of the Mobile Access Gateway (MAG), use the role command in MAG configuration mode. To remove the configuration, use the no form of this command.

role { 3gpp | lte | wimax | wlan }

no role { 3gpp | lte | wimax | wlan }

Syntax Description

3gpp

Specifies the role as third Generation Partnership Project (3GPP).

lte

Specifies the role as Long Term Evaluation (LTE).

wimax

Specifies the role as WiMAX.

wlan

Specifies the role as wireless LAN (WLAN).

Command Default

The default role is WLAN.

Command Modes


MAG configuration (config-ipv6-pmipv6-mag)

Command History

Release

Modification

Cisco IOS XE Release 3.4S

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

The default role, WLAN, cannot be disabled, but can only be configured to 3GPP, LTE, or WiMAX.

In Cisco IOS XE Release 3.4S and Cisco IOS Release 15.2(4)M, the only supported roles for the MAG are 3GPP and WLAN.

Examples

The following example shows how to configure the role of the MAG as 3GPP:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# exit
Device(config)# ipv6 mobile pmipv6-mag mag1 domain dn1
Device(config-ipv6-pmipv6-mag)# role 3gpp

Related Commands

Command

Description

ipv6 mobile pmipv6-domain

Configures the PMIPV6 domain.

ipv6 mobile pmipv6-mag

Configures the MAG for the PMIPV6 domain.

role 3gma

To enable the third-generation mobility anchor (3GMA) functionality, use the role 3gma command in Local Mobility Anchor (LMA) configuration mode. To disable 3GMA functionality, use the no form of this command.

role 3gma

no role 3gma

Syntax Description

This command has no arguments or keywords.

Command Default

None.

Command Modes


LMA configuration (config-ipv6-pmipv6-lma)

Command History

Release

Modification

Cisco IOS XE Release 3.9S

This command was introduced.

Usage Guidelines

The role 3gma command can be used only in the LMA configuration mode.

Examples

The following example shows how to configure the 3GMA functionality:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# exit
Device(config)# ipv6 mobile pmipv6-lma lma1 domain dn1
Device(config-ipv6-pmipv6-lma)# role 3gma

Related Commands

Command

Description

ipv6 mobile pmipv6-domain

Configures the PMIPV6 domain.

ipv6 mobile pmipv6-lma

Configures the LMA for the PMIPV6 domain.

router mobile

To enable Mobile IP on the router, use the router mobile command in global configuration mode. To disable Mobile IP, use the no form of this command.

router mobile

no router mobile

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled

Command Modes


Global configuration

Command History

Release

Modification

12.0(1)T

This command was introduced.

Usage Guidelines

This command must be used in order to run Mobile IP on the router, as either a home agent or a foreign agent. The process is started, and counters begin. Disabling Mobile IP removes all related configuration commands, both global and interface.

Examples

The following example enables Mobile IP:

router mobile

Related Commands

Command

Description

show ip mobile globals

Displays global information for mobile agents.

show ip protocols

Displays the parameters and current state of the active routing protocol process.

show processes

Displays information about the active processes.

sessionmgr

To enable mobile access gateway (MAG) to process the notifications it receives through the mobile client service abstraction (MCSA) from Intelligent Services Gateway (ISG), use the sessionmgr command in MAG configuration mode. To disable this function, use the no form of this command.

sessionmgr

no sessionmgr

Syntax Description

This command does not have any arguments or keywords.

Command Default

MAG does not process the notification it receives through MCSA from the ISG.

Command Modes

MAG configuration (config-ipv6-pmipv6-mag)

Command History

Release

Modification

Cisco IOS XE Release 3.8S

This command was introduced.

Usage Guidelines

This command is not supported in standalone MAG configuration. Use this command only when a MAG is configured to coexist with an ISG.

Examples

The following example shows how to enable the MAG to process the notifications it receives through MCSA from the ISG:

Device> enable
Device# configuration terminal
Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# exit
Device(config)# ipv6 mobile pmipv6-mag mag1 domain dn1
Device(config-ipv6-pmipv6-mag)# sessionmgr

service (proxy mobile IPv6)

To configure the service provided to a mobile node (MN), use the service command in PMIPV6 domain mobile node configuration mode. To disable the service configuration, use the no form of this command.

Cisco IOS XE Release 3.4S

service ipv4

no service ipv4

Cisco IOS XE Release 3.7S and Later Releases

service { dual | ipv4 | ipv6 }

no service { dual | ipv4 | ipv6 }

Syntax Description

dual

Configures both IPv4 and IPv6 services to an MN.

ipv4

Configures the IPv4 service to an MN. This is the default.

ipv6

Configures the IPv6 service to an MN.

Command Default

The IPv4 service is provided to the MN.

Command Modes


PMIPV6 domain mobile node configuration (config-ipv6-pmipv6-domain-mn)

Command History

Release

Modification

Cisco IOS XE Release 3.4S

This command was introduced.

Cisco IOS XE Release 3.5S

This command was modified. The dual and ipv6 keywords were added.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Examples

The following example shows how to provide the IPv6 service to the MN:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)# nai example@example.com
Device(config-ipv6-pmipv6-domain-mn)# service ipv6

Related Commands

Command

Description

ipv6 mobile pmipv6-domain

Configures the PMIPV6 domain.

nai

Configures the NAI for the MN within the PMIPV6 domain.

set link-type

To specify the link type for a match clause, use the set link-type command in PMIPv6 domain mobile-map configuration mode. To disable this function, use the no form of this command.

set link-type link-name1 [link-name2] [link-name3] [null]

no set link-type

Syntax Description

link-name1

Name of the outgoing interface link type.

link-name2

Name of the outgoing interface link type.

link-name3

Name of the outgoing interface link type.

null

Drops the traffic that matches the configured access-list.

Command Default

No link type exists for the configured match clause.

Command Modes

  PMIPv6 domain mobile map configuration (config-ipv6-pmipv6-domain-mobile-map)

Command History

Release

Modification

Cisco IOS XE Release 3.10S

This command was introduced.

Usage Guidelines

Create a match clause in the mobile-map configuration mode. Use the set link-type command to choose the appropriate outgoing interface types that match the configured access-list.

Examples

The following example shows how to specify the link types for a match clause:

Device(config)# ipv6 mobile pmipv6-domain dn1
Device(config-ipv6-pmipv6-domain)#  mobile-map map1 10
Device(config-ipv6-pmipv6-domain-mobile-map)# match access-list acl1
Device(config-ipv6-pmipv6-domain-mobile-map)# set link-type wifi 3g lte null

Related Commands

Command

Description

match access-list

Creates a match clause and specifies access lists.

show ip mobile aaa requests host

To display pending requests sent to the accounting, authentication, and authorization (AAA) host, use the show ip mobile aaa requests hostcommand in privileged EXEC mode.

show ip mobile aaa requests host [ ip-address | nai network-address-id ]

Syntax Description

ip-address

(Optional) IP address of the mobile node (MN).

nai network -address-id

(Optional) Specifies the network access identifier (NAI) of the mobile node.

Command Modes


Privileged EXEC (#)

Command Default

If the IP address of a mobile node is not specified, information for all mobile nodes is displayed.

Command History

Release

Modification

15.0(1)M

This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.

Examples

The following is sample output from the show ip mobile aaa requests host command for IP address 192.168.0.0:

Router# show ip mobile aaa requests host 192.168.0.0
Host 1.1.1.1 has sent author request to AAA
Reason: HOST_AUTHEN

The following is sample output from the show ip mobile aaa requests host command for network access identifier user06@example.com:

Router# show ip mobile aaa requests host
 nai user06@example.com
Host user06@cisco.com has sent author request to AAA
Reason: HOST_AUTHEN

Related Commands

Command

Description

show ip mobile host

Displays mobile node information.

show ip mobile binding

To display the mobility binding table on the home agent (HA), use the show ip mobile bindingcommand in privileged EXEC mode.

show ip mobile binding [ home-agent ip-address | nai string [ session-id string ] | summary ]

Syntax Description

home-agent

(Optional) Mobility bindings for a specific home agent (HA).

ip-address

(Optional) IP address for the HA.

nai string

(Optional) Mobile node (MN) identified by the network access identifier (NAI).

session-id string

(Optional) Session identifier. The string argument must be fewer than 25 characters in length.

summary

(Optional) Total number of bindings in the table.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

12.0(2)T

The home-agentkeyword and ip-addressargument were added.

12.1(2)T

The summary keyword was added.

12.2(2)XC

The nai keyword was added.

12.2(13)T

This command was enhanced to display the service options field and to include information about the mobile networks registered on the home agent.

12.3(4)T

The session-id keyword was added.

12.3(8)T

The output was enhanced to display UDP tunneling information.

12.4(9)T

The output was enhanced to display multipath support.

Usage Guidelines

You can display a list of all bindings if you press enter. You can also specify an IP address for a specific home agent using the show ip mobile binding home-agent ip-addresscommand.

If the session-id string combination is specified, only the binding entry for that session identifier is displayed. A session identifier is used to uniquely identify a Mobile IP flow. A Mobile IP flow is the set of {NAI, IP address}. The flow allows a single NAI to be associated with one or multiple IP addresses, for example, {NAI, ipaddr1}, {NAI, ipaddr2}, and so on. A single user can have multiple sessions for example, when logging through different devices such as a PDA, cellular phone, or laptop. If the session identifier is present in the initial registration, it must be present in all subsequent registration renewals from that MN.

Examples

The following is sample output from the show ip mobile bindingcommand:

Router# show ip mobile binding
Mobility Binding List:
Total 1
10.0.0.1: 
 Care-of Addr 10.0.0.31, Src Addr 10.0.0.31, 
 Lifetime granted 02:46:40 (10000), remaining 02:46:32
 Flags SbdmGvt, Identification B750FAC4.C28F56A8, 
 Tunnel100 src 10.0.0.5 dest 10.0.0.31 reverse-allowed
 Routing Options - (G)GRE
  Service Options:
  NAT detect

The following is sample output from the show ip mobile bindingcommand when mobile networks are configured or registered on the home agent:

Router# show ip mobile binding
Mobility Binding List:
Total 1
10.0.4.1:
 Care-of Addr 10.0.0.5, Src Addr 10.0.0.5
 Lifetime granted 00:02:00 (120), remaining 00:01:56
 Flags sbDmgvT, Identification B7A262C5.DE43E6F4
 Tunnel0 src 10.0.0.3 dest 10.0.0.5 reverse-allowed
 MR Tunnel1 src 10.0.0.3 dest 10.0.4.1 reverse-allowed
 Routing Options - (D)Direct-to-MN (T)Reverse-tunnel
 Mobile Networks: 10.0.0.0/255.255.255.0(S)
  10.0.0.0/255.255.255.0 (D)
  10.0.0.0/255.0.0.0(D)

The following is sample output from the show ip mobile bindingcommand with session identifier information:

Router# show ip mobile binding
Mobility Binding List:
Total 1
 10.100.100.19: 
 Care-of Addr 10.70.70.2, Src Addr 10.100.100.1, 
 Lifetime granted 00:33:20 (20000), remaining 00:30:56
 Flags SbdmGvt, Identification BC1C2A04.EA42659C, 
 Tunnel0 src 10.100.100.100 dest 10.70.70.2 reverse-allowed
 Routing Options 
 Session identifier 998811234
 SPI 333 (decimal 819) MD5, Prefix-suffix, Timestamp +/-255, root key
 Key 38a38987ad0a399cb80940835689da66
 SPI 334 (decimal 820) MD5, Prefix-suffix, Timestamp +/-255, session key
 Key 34c7635a313038611dec8c16681b55e0

The following sample output shows that the home agent is configured to detect network address translation (NAT):

Router# show ip mobile binding nai mn@cisco.com
Mobility Binding List:
 mn@cisco.com (Bindings 1):
 Home Addr 10.99.101.1
 Care-of Addr 192.168.1.202, Src Addr 192.168.157.1
 Lifetime granted 00:03:00 (180), remaining 00:02:20
 Flags sbDmg-T-, Identification BCF5F7FF.92C1006F
 Tunnel0 src 192.168.202.1 dest 192.168.157.1 reverse-allowed
 Routing Options - (D)Direct-to-MN (T)Reverse-tunnel
 Service Options:
 NAT detect

The following sample output shows that multipath support is enabled:

Router# show ip mobile binding 
Mobility Binding List:
Total 1
10.1.1.1: 
    Care-of Addr 10.1.1.11, Src Addr 10.1.1.11
    Lifetime granted 10:00:00 (36000), remaining 09:52:40
    Flags sbDmg-T-, Identification C5441314.61D36B14
    Tunnel1 src 12.1.1.10 dest 10.1.1.11 reverse-allowed
    MR Tunnel1 src 12.1.1.10 dest 10.1.1.11 reverse-allowed
    Routing Options - (D)Direct-to-MN (T)Reverse-tunnel
    Mobile Networks: 10.38.0.0/255.255.0.0 (D)
    Roaming IF Attributes: BW 10000 Kbit, ID 3247 
     Description First Lan Interface
    Multi-path Metric bandwidth 

The below table describes the significant fields shown in the display.

Table 1 show ip mobile binding Field Descriptions

Field

Description

Total

Total number of mobility bindings.

<IP Address>

Home IP address of the mobile node. The NAI is displayed if configured.

Care-of Addr

Care-of address of the mobile node.

Src Addr

IP source address of the registration request as received by the home agent. Will be either the colocated care-of address of a mobile node or an address on the foreign agent or the active HA address. If it is the active HA address, then this is a binding update from the active HA to the standby HA and not a registration directly received from the MN or FA.

Lifetime granted

The lifetime (in hh:mm:ss) granted to the mobile node for this registration. Number of seconds appears in parentheses.

remaining

The time (in hh:mm:ss) remaining until the registration expires. It has the same initial value as lifetime granted and is counted down by the home agent.

Flags

Services requested by the mobile node. The mobile node requests these services by setting bits in the registration request. Uppercase characters denote bit set.

Identification

Identification used in that binding by the mobile node. This field has two purposes: unique identifier for each request and replay protection.

Tunnel

The tunnel used by the mobile node is characterized by the source and destination addresses and reverse-allowed or reverse-off for reverse tunnel. The default encapsulation is IP-in-IP. The mobile node can request GRE.

Routing Options

Routing options identify the services that the home agent is currently providing. The mobile node must request these services in its registration request by setting the services flag (see Flags field description). For example, the V bit may have been requested by the mobile node (shown in the Flags field), but the home agent will not provide such service. Possible options are B (broadcast), D (direct-to-mobile node), G (GRE), and T (reverse-tunnel).

Service Options

Service options configured.

NAT detect

Indicates that the mobile node is registering from behind a NAT-enabled router.

Mobile Networks

Mobile networks configured or registered on the home agent. D denotes dynamic (registered) mobile networks, and S denotes static (configured) mobile networks.

Session identifier

The ID used to uniquely identify a Mobile IP flow.

SPI

The security parameter index (SPI) is the 4-byte opaque index within the mobility security association that selects the specific security parameters to be used to authenticate the peer.

MD5

Message Digest 5 authentication algorithm. HMAC-MD5 is displayed if configured.

Prefix-suffix

Authentication mode.

Timestamp

Replay protection method.

root key

Dynamic key based on the Microsoft Windows password shared between the mobile node and AAA or Windows domain controller or active directory. Once a mobile node registers, this key is established until the binding persists on the home agent. Subsequent registration requests can be authenticated using the root key.

session key

Dynamic key that is derived using the root key. This key can be refreshed, and the refreshed keys are based off the root key. Subsequent registration renewal messages can be authenticated using the session key. The period or frequency for the session key refresh is determined by the mobile node. Registration requests that also request session key refresh are authenticated using the root key.

Roaming IF Attributes

Attributes associated with the roaming interface. BW denotes the bandwidth of the roaming interface.

Description

Description of the roaming interface on the mobile router.

Multi-path Metric bandwidth

Metric that the mobile router uses for multipath support.

Related Commands

Command

Description

debug ip mobile

Displays IP mobility activities.

ip mobile foreign-agent nat traversal

Enables NAT UDP traversal support for Mobile IP foreign agents.

ip mobile home-agent nat traversal

Enables NAT UDP traversal support for Mobile IP HAs.

show ip mobile globals

Displays global information about Mobile IP home agents, foreign agents, and mobile nodes.

show ip mobile tunnel

Displays information about UDP tunneling.

show ip mobile visitor

Displays the table that contains a visitor list of foreign agents.

show ip mobile globals

To display global information for mobile agents, use the show ip mobile globalscommand in privileged EXEC mode.

show ip mobile globals

Syntax Description

This command has no arguments or keywords.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

12.2(13)T

This command was enhanced to display the NAT detect field and the Strip realm domain field.

12.2(15)T

This command was enhanced to display the HA Accounting field.

12.3(7)T

This command was enhanced to display information about foreign agent route optimization.

12.3(8)T

This command was enhanced to display information about UDP tunneling.

12.4(9)T

This command was enhanced to display information about multipath support.

Usage Guidelines

This command shows the services provided by the home agent or foreign agent. Note the deviation from RFC 3344: the foreign agent will not display busy or registration required information. Both are handled on a per-interface basis (see the show ip mobile interface command), not at the global foreign agent level.

Examples

The following is sample output from the show ip mobile globalscommand:

Router# show ip mobile globals
IP Mobility global information:
Home Agent
    Registration lifetime: 10:00:00 (36000 secs)
    Broadcast enabled
    Replay protection time: 7 secs
    Reverse tunnel enabled
    ICMP Unreachable enabled
    Strip realm enabled
    NAT detect disabled
    HA Accounting enabled using method list: mylist
    Address 1.1.1.1
    Virtual networks
        10.0.0.0/8
Foreign Agent
    Pending registrations expire after 120 seconds	
    Care-of address advertised
    Mobile network route injection enabled
    Mobile network route redistribution disabled
    Mobile network route injection access list mobile-net-list
    Ethernet2/2 (10.10.10.1) - up
Mobility Agent
1 interfaces providing service
Encapsulations supported: IPIP and GRE
Tunnel fast switching enabled, cef switching enabled
Discovered tunnel MTU aged out after 1:00:00

The following example shows that home agent UDP tunneling is enabled with a keepalive timer set at 60 seconds and forced UDP tunneling enabled.

Router# show ip mobile globals
IP Mobility global information:
Home agent
 Registration lifetime: 10:00:00 (36000 secs)
 Broadcast disabled
 Replay protection time: 7 secs
 Reverse tunnel enabled
 ICMP Unreachable enabled
 Strip realm disabled
 NAT Traversal disabled
 HA Accounting disabled
 NAT UDP Tunneling support enabled
 UDP Tunnel Keepalive 60
 Forced UDP Tunneling enabled
 Virtual networks
 10.99.101.0/24
Foreign agent is not enabled, no care-of address
0 interfaces providing service
Encapsulations supported: IPIP and GRE
Tunnel fast switching enabled, cef switching enabled
Tunnel path MTU discovery aged out after 10 min

The following example shows that NAT UDP tunneling support is enabled on the foreign agent with a keepalive timer set at 110 seconds and forced UDP tunneling disabled.

Router# show ip mobile globals
IP Mobility global information:
Foreign Agent
Pending registrations expire after 120 secs
Care-of addresses advertised
Mobile network route injection disabled
Ethernet2/2 (10.30.30.1) - up
1 interface providing service
Encapsulations supported: IPIP and GRE
Tunnel fast switching enabled, cef switching enabled
Tunnel path MTU discovery aged out after 10 min
NAT UDP Tunneling support enabled
UDP Tunnel Keepalive 110
Forced UDP Tunneling disabled

The following example output shows that multipath support is enabled:

Router# show ip mobile globals
IP Mobility global information:
Home Agent
    Registration lifetime: 10:00:00 (36000 secs)
    Broadcast disabled
    Replay protection time: 7 secs
    ....
    UDP Tunnel Keepalive 110
    Forced UDP Tunneling disabled
    Multiple Path Support enabled 

The below table describes the significant fields shown in the sample output.

Table 2 show ip mobile globals Field Descriptions

Field

Description

Home Agent

Registration lifetime

Default lifetime (in hh:mm:ss) for all mobile nodes. Number of seconds given in parentheses.

Roaming access list

Determines which mobile nodes are allowed to roam. Displayed if defined.

Care-of access list

Determines which care-of addresses are allowed to be accepted. Displayed if defined.

Broadcast

Whether broadcast is enabled or disabled.

Replay protection time

Time, in seconds, that the time stamp on a registration request (RRQ) from a mobile node may differ from the router’s internal clock.

Reverse tunnel

Whether reverse tunnel is enabled or disabled.

ICMP Unreachable

Sends ICMP unreachable messages, which are enabled or disabled for the virtual network.

Strip realm

Whether strip realm is enabled or disabled.

NAT detect

Whether NAT detect is enabled or disabled. If NAT detect is enabled, the home agent can detect a registration request that has traversed a NAT-enabled device and can apply a tunnel to reach the Mobile IP client.

HA Accounting

Whether home agent accounting is enabled or disabled.

NAT UDP Tunneling support

Whether NAT UDP tunneling is enabled or disabled on the home agent.

UDP Tunnel Keepalive

Keepalive interval, in seconds, configured on the home agent that avoids a NAT translation entry on a NAT device from expiring when there is no active Mobile IP data traffic going through the UDP tunnel.

Forced UDP Tunneling

Whether the home agent is configured to accept forced UDP tunneling.

Address

Home agent address.

Virtual networks

Lists virtual networks serviced by the home agent. Displayed if defined.

Multiple Path Support

Whether multiple path support is enabled or disabled.

Foreign Agent

Pending registrations expire after

The amount of time, in seconds, before a pending registration will time out.

Care-of addresses advertised

Displayed if care-of addresses are defined.

Mobile network route injection

Mobile network route injection can be enabled or disabled.

Mobile network route redistribution

Mobile network route redistribution can be enabled or disabled.

Mobile network route injection access list

The name of the access list used if mobile network route injection is enabled.

NAT UDP Tunneling support

Whether NAT UDP tunneling is enabled or disabled on the foreign agent

UDP Tunnel Keepalive

Keepalive interval, in seconds, configured on the foreign agent that avoids a NAT translation entry on a NAT device from expiring when there is no active Mobile IP data traffic going through the UDP tunnel.

Forced UDP Tunneling

Whether the foreign agent is configured to force UDP tunneling.

up, interface-only, transmit-only

Up status is displayed if the foreign agent is configured to function in an asymmetric link environment. Interface-only status is displayed if the foreign agent is configured to advertise only its own address as the care-of address in an asymmetric link environment. Transmit-only status is displayed if the foreign agent is configured to transmit only from the interface in an asymmetric link environment.

Mobility Agent

Number of interfaces providing service

See the show ip mobile interface command for more information on the interfaces providing service. Agent advertisements are sent when ICMP Router Discovery Protocol (IRDP) is enabled.

Encapsulations supported

The encapsulation types that are supported. Possible encapsulation types are IPIP and GRE.

Tunnel fast switching

Whether tunnel fast switching is enabled or disabled.

cef switching

Whether CEF switching is enabled or disabled.

Discovered tunnel MTU

Aged out after amount of time (in hh:mm:ss).

Related Commands

Command

Description

show ip mobile interface

Displays advertisement information for interfaces that are providing foreign agent service or that are home links for mobile nodes.

show ip mobile host

To display mobile node information, use the show ip mobile hostcommand inprivileged EXEC mode.

show ip mobile host [ address | interface interface | network address | nai string | group [ nai string ] | summary ]

Syntax Description

address

(Optional) IP address of specific mobile node. If not specified, information for all mobile nodes is displayed.

interface interface

(Optional) Displays all mobile nodes whose home network is on this interface.

network address

(Optional) Displays all mobile nodes residing on this network or virtual network.

nai string

(Optional) Network access identifier.

group

(Optional) Displays all mobile node groups configured using the ip mobile host command.

summary

(Optional) Displays all values in the table.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

12.2(2)XC

The nai keyword was added.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

Examples

The following is sample output from the show ip mobile hostcommand:

Router# show ip mobile host
10.34.253.147:
   Allowed lifetime 10:00:00 (36000/default)
   Roam status -Registered-, Home link on virtual network 10.34.253.128 /26
   Accepted 2082, Last time 02/13/03 01:03:24
   Overall service time 1w0d
   Denied 32, Last time 01/03/03 21:13:43
   Last code 'registration id mismatch (133)'
   Total violations 32
   Tunnel to MN - pkts 0, bytes 0
   Reverse tunnel from MN - pkts 0, bytes 0

The following is sample output from the show ip mobile host naistringcommand:

Router# show ip mobile host nai 
jane@cisco.com
jane@cisco.com
   Allowed lifetime 10:00:00 (36000/default)
   Roam status -Registered-, Home link on interface Loopback0
   Bindings 10.34.253.205
   Accepted 3705, Last time 02/13/03 01:02:37
   Overall service time 6d05h
   Denied 4918, Last time 01/30/03 20:59:14
   Last code 'administratively prohibited (129)'
   Total violations 262
   Tunnel to MN - pkts 0, bytes 0
   Reverse tunnel from MN - pkts 0, bytes 0

The below table describes the significant fields shown in the display.

Table 3 show ip mobile host Field Descriptions

Field

Description

IP address

Home IP address of the mobile node. The network access identifier (NAI) is displayed if configured.

Allowed lifetime

Allowed lifetime (in hh:mm:ss) of the mobile node. By default, it is set to the global lifetime (ip mobile home-agent lifetimecommand). Setting this lifetime will override global value.

Roaming status

When the mobile node is registered, the roaming status is - Registered - ; otherwise, it is - Unregistered -. Use the show ip mobile binding command for more information when the user is registered.

Home link

Interface or virtual network.

Accepted

Total number of service requests for the mobile node accepted by the home agent.

Last time

The time at which the most recent registration request was accepted by the home agent for this mobile node.

Overall service time

Overall service time that has accumulated for the mobile node since the router has booted or cleared.

Denied

Total number of service requests for the mobile node denied by the home agent (sum of all registrations denied with Code 128 through Code 159).

Last time

The time at which the most recent registration request was denied by the home agent for this mobile node.

Last code

The code indicating the reason why the most recent registration request for this mobile node was rejected by the home agent.

Total violations

Total number of security violations.

Tunnel to mobile node

Number of packets and bytes tunneled to mobile node.

Reverse tunnel from mobile node

Number of packets and bytes reverse tunneled from mobile node.

NAI string

NAI associated with the mobile node.

Bindings

Addresses currently assigned to the NAI.

The following is sample output from the show ip mobile host groupcommand for groups configured with the ip mobile host command:

Router# show ip mobile host group
20.0.0.1 - 20.0.0.20: 
    Home link on virtual network 20.0.0.0 /8, Care-of ACL -none-
    Security associations on router, Allowed lifetime 10:00:00 (36000/default)

The below table describes the significant fields shown in the display.

Table 4 show ip mobile host group Field Descriptions

Field

Description

IP address

Mobile host IP address or grouping of addresses.

Home link

Interface or virtual network.

Care-of ACL

Care-of address access list.

Security association

Router or AAA server.

Allowed lifetime

Allowed lifetime for mobile host or group.

Related Commands

Command

Description

clear ip mobile host-counters

Clears the mobile node counters.

show ip mobile binding

Displays the mobility binding table.

show ip mobile interface

To display advertisement information for interfaces that are providing foreign agent service or are home links for mobile nodes, use the show ip mobile interfacecommand inprivilegedEXEC mode.

show ip mobile interface [interface]

Syntax Description

interface

(Optional) IP address of mobile node. If not specified, all interfaces are shown.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

Examples

The following is sample output from the show ip mobile interfacecommand:

Router# show ip mobile interface
IP Mobility interface information:
IRDP disabled
Interface Ethernet3:
    Prefix Length not advertised
    Lifetime is 36000 seconds
    Home Agent service provided

The below table describes the significant fields shown in the display.

Table 5 show ip mobile interface Field Descriptions

Field

Description

Interface

Name of the interface.

IRDP

IRDP (includes agent advertisement) enabled or disabled. IRDP must be enabled for an advertisement to be sent out. Use the ip irdp command to enable IRDP.

Prefix Length

Prefix-length extension to be included or not in the advertisement.

Lifetime

Advertised registration lifetime.

Home Agent service provided

Displayed if home agent service is enabled on the interface.

Foreign Agent service provided

Displayed if foreign agent service is enabled on the interface.

Registration required

Foreign agent requires registration even from those mobile nodes that have acquired their own collocated care-of address.

Busy

Foreign agent is busy for this interface.

Home Agent access list

Which home agent is allowed.

Maximum number of visitors allowed

Displayed if defined.

Current number of visitors

Number of visitors on the interface.

Related Commands

Command

Description

description (mobile networks)

Enables foreign agent service.

ip mobile host

Configures the mobile host or mobile node group.

ip mobile prefix-length

Appends the prefix-length extension to the advertisement.

show ip irdp

Displays IRDP values.

show ip mobile mobile-networks

To display a list of mobile networks associated with the mobile router, use the show ip mobile mobile-networkscommandinprivilegedEXEC mode.

show ip mobile mobile-networks [ip-address]

Syntax Description

ip-address

(Optional) Address of a specific mobile router. If not specified, information for all mobile networks is displayed.

Command Default

No default behavior or values.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.2(4)T

This command was introduced.

12.2(13)T

This command was enhanced to display information about the dynamically registered mobile networks.

12.4(9)T

This command was enhanced to display information about multipath support.

Usage Guidelines

The home agent maintains a list of static and dynamic mobile networks associated with mobile routers.

Examples

The following is sample output from the show ip mobile mobile-networks command:

Router# show ip mobile mobile-networks
Mobile Networks:
MR 20.0.4.1:
Dynamic registration
    Configured:10.2.0.0/255.255.255.0
    Registered:10.3.0.0/255.255.255.0
               10.4.0.0/255.0.0.0
               10.5.0.0/255.255.255.0

The following is sample output from the show ip mobile mobile-networks command when multipath support is enabled:

Router# show ip mobile mobile-networks
Mobile Networks:
MR 10.1.1.1:
    Multiple Paths Support Enabled
    Dynamic registration
    Registered:10.2.0.0/255.255.255.0

The below table describes the significant fields in the display.

Table 6 show ip mobile mobile-networks Field Descriptions

Field

Description

MR

IP address of the mobile router.

Multiple Paths Support Enabled

Configured for multiple path support between the mobile router and the home agent.

Dynamic registration

Configured for dynamic registration of mobile networks.

Configured

Mobile networks statically configured on the home agent.

Registered

Mobile networks dynamically registered on the home agent.

Related Commands

Command

Description

ip mobile mobile-networks

Associates one or more networks with a mobile router configured as a mobile host and enters mobile networks configuration mode.

show ip mobile proxy

To display information about a proxy Mobile IP host, use the show ip mobile proxycommand in privileged EXEC mode.

show ip mobile proxy [ host [ nai string ] | registration | traffic ]

Syntax Description

host

(Optional) Displays information about the proxy host.

nai string

(Optional) Network access identifier.

registration

(Optional) Displays proxy registration information.

traffic

(Optional) Displays proxy traffic information.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.2(2)XC

This command was introduced.

12.3(4)T

This command was integrated into Cisco IOS Release 12.3(4)T for PDSN platforms.

Usage Guidelines

This command is available only on Packet Data Serving Node (PDSN) platforms running specific PDSN code images; consult Feature Navigator for your Cisco IOS software release.

Examples

The following is sample output from the show ip mobile proxy hostcommand:

Router# show ip mobile proxy host
Proxy Host List:
MoIPProxy1@cisco.com:
    Home Agent Address 10.3.3.1
    Lifetime 6000
    Flags :sBdmgvt

show ip mobile router

To display configuration information and monitoring statistics about the mobile router, use the show ip mobile router command in privileged EXEC mode.

show ip mobile router

Syntax Description

This command has no arguments or keywords.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.2(4)T

This command was introduced.

12.2(13)T

This command was enhanced to display information about the mobile network interfaces.

12.2(15)T

This command was enhanced to display information about collocated care-of addresses (CCoAs).

12.3(7)T

This command was enhanced to display information about requests for generic routing encapsulation (GRE).

12.4(9)T

The command was enhanced to display information about multipath support.

Usage Guidelines

The display includes the mobile router configuration information such as the home address and network mask, home agent, and registration settings, and operational information such as status, tunnel interface, active foreign agent, and care-of address.

Examples

The following is sample output from the show ip mobile routercommand:

Router# show ip mobile router
Mobile Router
  Enabled 05/30/02 11:16:03
  Last redundancy state transition 05/30/02 11:15:01
Configuration:
  Home Address 10.0.4.1 Mask 255.255.255.0
  Home Agent 10.0.0.3 Priority 100 (best) (current)
  Registration lifetime 120 sec
  Retransmit Init 1000, Max 5000 msec, Limit 3
  Extend Expire 120, Retry 3, Interval 10
  Redundancy group AlwaysUp (active)
  Mobile Networks:Ethernet5 (10.0.0.0/255.255.255.248) 
    Ethernet2 (10.0.0.0/255.0.0.0) 
    Ethernet3 (10.1.0.0/255.255.255.0)
Monitor:
  Status -Registered-
  Active foreign agent 10.0.1.2, Care-of 10.0.1.2
  On interface Serial0
  Tunnel0 mode IP/IP

The following is sample output from the show ip mobile routercommand when a mobile router is registered using a CCoA:

Router# show ip mobile router
Mobile Router
  Enabled 02/12/02 18:29:13
  Last redundancy state transition NEVER
Configuration:
  Home Address 10.0.4.1 Mask 255.255.255.0
  Home Agent 10.0.0.3 Priority 100 (best)
  Registration lifetime 120 sec
  Retransmit Init 1000, Max 5000 msec, Limit 3
  Extend Expire 120, Retry 3, Interval 10
Monitor:
  Status -Registered-
  Using Collocated Care-of Address 10.0.0.1 
  On interface Ethernet1
  Tunnel0 mode IP/IP

The following is sample output from the show ip mobile routercommand when GRE encapsulation is globally configured on the mobile router. When GRE encapsulation is enabled, the line “Request GRE tunnel” is displayed in the output and the tunnel mode is shown as “GRE/IP.”

Router# show ip mobile router
Mobile Router 
    Enabled 01/11/00 06:59:19 
    Last redundancy state transition NEVER 
Configuration:
    Home Address 10.80.80.1 Mask 255.255.255.0 
    Home Agent 10.40.40.1 Priority 100 (best) (current) 
    Registration lifetime 65534 sec 
    Retransmit Init 1000, Max 5000 msec, Limit 3 
    Extend Expire 20, Retry 10, Interval 1 
    Request GRE tunnel
    Mobile Networks:Ethernet1/3 (172.16.143.0/255.255.255.0) 
                     TokenRing4/3 (172.16.153.0/255.255.255.0) 
Monitor:
    Status -Registered- 
    Active foreign agent 10.52.52.1, Care-of 10.52.52.1 
    On interface TokenRing4/2 
    Tunnel0 mode GRE/IP

The following is sample output when the mobile router is configured for multipath support:

Router# show ip mobile router
Mobile Router
    Enabled 11/22/05 05:37:17
    Last redundancy state transition NEVER
Configuration:
    Home Address 10.1.1.10 Mask 255.255.255.0
    Home Agent 10.1.1.2 Priority 100 (best) (current)
    Registration lifetime 90 sec
    Retransmit Init 1000, Max 5000 msec, Limit 3
    Extend Expire 120, Retry 3, Interval 10
    Reverse tunnel required
    Multi-path active, Requested metric: bandwidth, Using metric: bandwidth
    Mobile Networks: Ethernet3/0 (172.16.1.0/255.255.255.0)
                     Loopback44 (192.168.1.0/255.255.255.0)
Monitor:
    Status -Registered-
    Foreign Agent 172.20.1.1, Care-of 172.20.1.1 
         On interface Ethernet1/0 
         Tunnel0 mode IP/IP
    Collocated care-of address 172.30.1.11  
         On interface Ethernet2/0
         Tunnel2 mode IP/IP
    Collocated care-of address 172.40.1.11  
         On interface Ethernet3/0
         Tunnel3 mode GRE/IP

The below table describes the significant fields shown in the display.

Table 7 show ip mobile router Field Descriptions

Field

Description

Enabled

Date and time (in hh:mm:ss) when the mobile router was enabled.

Last redundancy state transition

Date and time (in hh:mm:ss) when the redundancy state of the mobile router changed.

Home Address/Mask

Home IP address of the mobile router, including the network mask.

Home Agent

Home agent that the mobile router registers with. The mobile router registers only to the home agent with the highest priority when multiple addresses are configured.

Registration lifetime

Registration lifetime (in seconds) granted by the home agent for the mobile router.

Retransmit Init/Max/Limit

Registration request retransmission settings. When registration requests are not responded to, the mobile router will resend. Displays the initial and maximum transmission timers and the limit on the number of retries allowed.

Extend Expire/ Retry/Interval

Extend registration lifetime. After the mobile router has registered, reregister before the lifetime expires. Retry is the number of attempts to reregister between intervals.

Request GRE tunnel

The mobile router requests GRE encapsulation when it registers.

Redundancy group

Name of the redundancy group used to provide mobile router redundancy. Mobile router is either “active” or “passive.” If redundancy is enabled or disabled, this information is displayed or absent, respectively. Active means that the mobile router is functioning fully, and passive means that the mobile router is idle.

Reverse tunnel required

If reverse tunnel is enabled or disabled, this information is displayed or absent, respectively.

Multi-path active

Multiple path support is active between the mobile router and the home agent.

Multi-path enabled

Multiple path support is enabled, but the mobile router is not registered yet.

Multi-path denied by HA

Multiple path support is disabled on the home agent.

Requested metric: bandwidth

Requested metric to use to load balance traffic among multiple paths. The metric is either bandwidth or hop count. Bandwidth is the default.

Using metric: bandwidth

Metric that is being used to load balance traffic among multiple paths. The metric is either bandwidth or hopcount. Bandwidth is the default.

Mobile Networks

Mobile networks associated with the mobile router.

Status

Indication of the state of the mobile router. Options are as follows:

  • Home--Connected to home network.
  • Registered--Registered on foreign network.
  • Pending--Sent registration and waiting for reply.
  • Isolated--Mobile router has heard an agent advertisement but is isolated from the network.
  • Unknown--Cannot determine status.

Active foreign agent/Care-of

Foreign agent and care-of address used by the registered mobile router.

Using Collocated Care-of Address

Displayed if a mobile router is registered using a CCoA.

On interface

Mobile router registered on this interface.

Tunnel

Tunnel number between mobile router and the home agent.

mode

The type of encapsulation being used. The encapsulation type can be one of the following:

  • GRE/IP--GRE encapsulation is being used.
  • IP/IP--IP-in-IP encapsulation is being used.

Related Commands

Command

Description

ip mobile router

Enables the mobile router and enters mobile router configuration mode.

show ip mobile router agent

To display information about the agents for the mobile router, use the show ip mobile router agent command inprivilegedEXEC mode.

show ip mobile router agent

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.2(4)T

This command was introduced.

12.2(15)T

This command was enhanced to display information about the retry interval used in static collocated care-of address (CCoA) processing.

12.3(4)T

This command was enhanced to display information about dynamic CCoA processing.

12.3(14)T

This command was enhanced to display the default gateway for dynamic CCoA acquired through DHCP.

Usage Guidelines

This command displays a list containing information on all foreign agents currently discovered on the mobile router. This list also displays information about each interface configured for static or dynamic CCoA. An interface must be “up” to be displayed on the list.

You can use the clear ip mobile router agent command to clear foreign agent care-of addresses (CoAs) but not static CCoAs. CCoAs cannot be cleared.

Examples

The following is sample output from the show ip mobile router agentcommand when a CCoA is configured on a mobile router interface:

Router# show ip mobile router agent
Mobile Router Agents:
Foreign agent 45.0.0.2:
  Care-of address 42.0.0.2
  Interface Ethernet1, MAC 0030.9492.6627
  Agent advertisement seq 56649, Flags rbhFmGvt, Lifetime 36000
  IRDP advertisement lifetime 30, Remaining 29
  Last received 02/13/02 17:55:48
  First heard 02/13/02 11:21:46
Collocated Care-of address 48.0.0.1 (static): 
  Interface Ethernet2
  Default gateway 48.0.0.2
  Registration retry interval 60
  Next CCoA reg attempt in 00:00:55 seconds
Collocated Care-of address 11.0.0.7 (dynamic):
  Interface Serial0
  Registration retry interval 60

The below table describes the significant fields shown in the display.

Table 8 show ip mobile router agent Field Descriptions

Field

Description

Home or Foreign Agent

IP address of the foreign agent (or home agent).

Care-of address

Attachment point in the foreign network.

Interface

Interface on which the agent was learned.

MAC

MAC address of the learned agent.

Agent advertisement seq/Flags/Lifetime

Agent advertisement sequence number, flags, and lifetime (in seconds). The sequence number can be used to detect reboot by the agent. The flags are services provided by the agent. The lifetime is the limit advertised by the agent.

IRDP advertisement lifetime/Remaining

The IRDP advertisement lifetime is the interval in which this foreign agent will provide service. When the lifetime expires, the foreign agent is disconnected from the mobile router. The remaining field shows the time before expiration.

Last received

Date and time when advertisement was received.

First heard

Date and time when the agent was first heard. This is useful information in determining which agent to use when multiple learned agents are heard by the mobile router.

Collocated Care-of address

CCoA configured on the mobile router interface. The type of CCoA (static or dynamic) is given in parentheses.

Interface

Mobile router interface.

Default gateway

The next-hop IP address for registration packets. Upon successful registration, this address will be used as the default gateway and default route. This field is displayed if the IP address is fixed (static) on an Ethernet interface or a default gateway is acquired through DHCP.

Registration retry interval

The interval that the mobile router waits before sending another registration request if a registration request failed.

Next CCoA reg attempt in 00:00:55 seconds

If the interval timer is running, the time remaining (in seconds) until the next registration attempt. Only appears if a registration attempt (and its retries) has failed and the registration retry interval timer is running.

Related Commands

Command

Description

clear ip mobile router agent

Deletes learned agents and the corresponding care-of address of the foreign agent from the mobile router agent table.

show ip mobile router interface

To display information about the interfaces configured for roaming, use the show ip mobile router interface command in privileged EXEC mode.

show ip mobile router interface

Syntax Description

This command has no arguments or keywords.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.2(4)T

This command was introduced.

12.2(15)T

This command was enhanced to display information about static collocated care-of addresses (CCoAs).

12.3(4)T

This command was enhanced to display information about dynamic CCoAs.

12.3(7)T

This command was enhanced to display information about a request for a generic routing encapsulation (GRE) tunnel.

12.3(14)T

This command was enhanced to display information about Layer 2 signaling on roaming interfaces.

Usage Guidelines

The mobile router uses the interfaces for roaming, discovering foreign agents, and registering its location on the foreign network.

Use this command to display information about roaming interfaces. If the interface is configured for a collocated care-of address (CCoA), the CCoA IP address is displayed. If it is not configured for a CCoA, “disabled” is displayed. The interface can be up or down.

Examples

The following is sample output from the show ip mobile router interface command. Fast Ethernet interface 0/0 and Fast Ethernet interface 2/0 have no CCoA configuration, serial interface 1/0 has a static CCoA configuration, and serial interface 1/1 has a dynamic CCoA address with CCoA only. GRE encapsulation is configured on Fast Ethernet interface 2/0.

Router# show ip mobile router interface
Mobile Router Interfaces:
Listed in order of preference.
FastEthernet0/0:
  Priority 102, Bandwidth 10000, Address 10.0.0.9
  Periodic solicitation disabled, Interval 600 sec
  Retransmit Init 1000, Max 5000 msec, Limit 3
  Current 0, Remaining 0 msec, Count 0
  Hold down 0 sec
  Routing disallowed
  Collocated CoA disabled
Serial1/0:
  Priority 100, Bandwidth 1544, Address 10.0.0.7
  Periodic solicitation disabled, Interval 600 sec
  Retransmit Init 1000, Max 5000 msec, Limit 3
  Current 1000, Remaining 0 msec, Count 1
  Hold down 0 sec
  Routing disallowed
  Collocated CoA 10.0.0.7 (static)
Serial1/1
  Priority 100, Bandwidth 1544, Address 10.0.0.5
  Periodic solicitation disabled, Interval 600 sec
  Retransmit Init 1000, Max 5000 msec, Limit 3
  Current 0, Remaining 0 msec, Count 0
  Hold down 0 sec
  Routing disallowed
  Collocated CoA 10.0.0.5 - Solicit FA first
FastEthernet2/0
  Priority 110, Bandwidth 16000, Address 10.52.52.2 
  Periodic solicitation disabled, Interval 600 sec 
  Retransmit Init 1000, Max 5000 msec, Limit 3 
  Current 2000, Remaining 0 msec, Count 2 
  Hold down 0 sec 
  Routing disallowed 
  Collocated CoA disabled 
  Request GRE tunnel

The following sample output shows that the mobile router is configured to support signaling on roaming interfaces via SNMP interface MIB traps.

Router# show ip mobile router interface
Mobile Router Interfaces:
Listed in order of preference.
Ethernet1:
  Priority 110, Bandwidth 10000, Address 55.0.0.8
  Periodic solicitation disabled, Interval 600 sec
  Retransmit Init 1000, Max 5000 msec, Limit 3
  Current 5000, Remaining 0 msec, Count 4
  Foreign agent hold down 0 sec
  Layer 2 reassociation hold down 5000 msec
  Last layer 2 link-state trap: linkDown
  Routing disallowed
  Collocated CoA 55.0.0.8 - Solicit FAs

The below table describes the significant fields shown in the display.

Table 9 show ip mobile router interface Field Descriptions

Field

Description

Priority

Interface priority. Comparison to decide the preferred interface to register by the mobile router. The interface with the highest priority is used to send registrations.

Bandwidth

Interface bandwidth. When multiple interfaces have the highest priority, the highest bandwidth is the preferred choice.

Address

Interface IP address. If priority and bandwidth are the same among roaming interfaces, the highest address is preferred by the mobile router.

Periodic solicitation

Send solicitations periodically (enabled) or wait for periodic advertisements (disabled).

Interval

Period of time (in seconds) to wait before sending the next periodic solicitation.

Retransmit Init/Max/Limit

Solicitation retry settings. Displays the initial and maximum transmission timers and the limit on the number of retries allowed.

Current/ Remaining

Current retransmission interval and remaining time (in milliseconds) before it expires.

Count

Retransmission count.

Hold down

Period of time (in seconds) to wait before registering to a learned agent.

Layer 2 reassociation hold down

Period of time (in milliseconds) that the mobile router will wait for an SNMP linkUp trap from the WMIC indicating that the wireless link is available for use.

Last layer 2 link-state trap

The last layer 2 linkDown and linkUp trap events signaled via SNMP.

Routing

Routing is disallowed when the mobile router is roaming and allowed when the mobile router is home.

Collocated CoA

IP address is displayed if the interface is configured for CCoA; otherwise “Collocated CoA disabled” is displayed. The CCoA is displayed if configured, even if the interface is down. The type of CCoA (static or dynamic) is given in parentheses.

Solicit FA first

Interface will solicit foreign agents first. If none are heard, CCoA processing is enabled on the interface.

Request GRE tunnel

Interface will request GRE encapsulation when it registers with an agent.

Related Commands

Command

Description

ip mobile router-service

Enables mobile router service on an interface.

ip mobile router-service collocated

Enables static or dynamic CCoA processing on a mobile router interface.

keepalive

Enables keepalive packets and specifies the number of times that the Cisco IOS software tries to send keepalive packets without response before bringing the tunnel protocol down for a specific interface.

show ip mobile router registration

To display pending and/or accepted registrations of the mobile router, use the show ip mobile router registrationcommand inprivilegedEXEC mode.

show ip mobile router registration

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes


Privileged EXEC

Command History

Release

Modification

12.2(4)T

This command was introduced.

12.2(13)T

This command was enhanced to display new extensions in the registration request.

12.2(15)T

This command was enhanced to display collocated care-of addresses (CCoAs) if configured.

Examples

The following is sample output from the show ip mobile router registration command:

Router# show ip mobile router registration
Mobile Router Registrations:
Foreign Agent 44.0.0.1:
  Registration accepted 01/15/01 10:04:01, On Ethernet2/2
  Care-of addr 41.0.0.1, HA addr 49.0.0.3, Home addr 49.0.0.5
  Lifetime requested 01:00:00 (3600), Granted 00:30:00 (1800)
  Remaining 00:20:13
  Flags sbdmgvt, Identification BE0D49E5.5E1C56E4
  Register next time 00:18:13
  Extensions
    Mobile Network 44.0.0.0/8
    MN-HA Authentication SPI 100

The following is sample output from the show ip mobile router registration command if a mobile router interface is configured with a CCoA:

Home agent 4.4.4.3:
  Registration accepted 01/01/02 10:24:46, On Ethernet5/3
  Collocated care-of addr 3.3.3.2, HA addr 4.4.4.3, Home addr 4.4.4.2
  Lifetime requested 00:01:30 (90), Granted 00:01:30 (90)
  Remaining 00:01:08
  Flags sbDmg-T-, Identification BFDC0CEE.C7A75D64
  Register next time 00:00:23
  Extensions:
    Mobile Network 95.95.95.0/24
    MN-HA Authentication SPI 100

The below table describes the significant fields shown in the display.

Table 10 show ip mobile router registration Field Descriptions

Field

Description

Home or Foreign Agent

IP address of the home agent or foreign agent.

Registration accepted

Date and time (in hh:mm:ss) when registration was accepted.

On

Which interface registration occurred on.

Care-of addr/Collocated care-of addr

Attachment point in the foreign network. The collocated care-of address is displayed if configured.

HA addr

IP address of the home agent.

Home addr

Home IP address.

Lifetime requested

Requested lifetime of registration.

Granted

Registration lifetime granted by the home agent.

Remaining

Remaining time before registration expires.

Flags

Flags in the registration reply.

Identification

Identification in the registration reply.

Register next time

Remaining time before the mobile router sends the next registration request.

Extensions

New extensions added to the registration request.

Mobile Network

Mobile network connected to mobile router.

MN-HA Authentication

Mobile node and home agent authentication. Indicates the SPI number.

Related Commands

Command

Description

register (mobile router)

Controls the registration parameters of the mobile router.

show ip mobile router traffic

To display the counters that the mobile router maintains, use the show ip mobile router trafficcommand in privileged EXEC mode.

show ip mobile router traffic [ since bootup ]

Syntax Description

since bootup

(Optional) Displays counters since the mobile router process started, regardless of how many times the counters were cleared.

Command Default

Displays counters since the counters were last cleared.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.2(4)T

This command was introduced.

Usage Guidelines

The mobile router maintains counters for agent discovery, registration, movement, and services.

Examples

The following is sample output from the show ip mobile router trafficcommand:

Router# show ip mobile router traffic
Mobile Router Counters:
Agent Discovery:
  Solicitations sent 90, advertisements received 17
  Agent reboots detected 0
Registrations:
  Register 70, Deregister 0 requests sent
  Register 70, Deregister 0 replies received
  Requests accepted 68, denied 1 by HA 1 /FA 0
  Denied due to mismatched ID 1
  Authentication failed for HA 0/FA 0
  Invalid extensions 0, ignored 0
  Invalid home address 0, ID 0
  Unknown HA 0/FA 0
  Gratuitous ARPs sent 0
Movement:
  Came up on HA 0, on FA 1
  Moved HA to FA 0, FA to FA 0, FA to HA 0
  Better interface detected 0 source 46.0.0.5 dest 49.0.0.3
Tunnel Traffic:
  Packets received 188105, sent 0
  Bytes received 142691351, sent 0
Services:
  Redundancy state active 2, passive 1

The below table describes the significant fields shown in the display.

Table 11 show ip mobile router traffic Field Descriptions

Field

Description

Agent Discovery

Counters categorized for discovering agents.

Solicitations sent

Total number of solicitations sent by the mobile router.

Advertisements received

Total number of advertisements received by the mobile router.

Agent reboots detected

Total number of agent reboots detected by the mobile router through the sequence number of the advertisement.

Registrations

Counters categorized for registration.

Register / Deregister requests sent

Total number of registration and deregistration requests sent by the mobile router.

Register / Deregister replies received

Total number of registration and deregistration replies received by the mobile router.

Requests accepted

Total number of registration requests accepted by the home agent of the mobile router (Code 0 and Code 1).

denied by HA/FA

Total number of registration requests denied by the home agent of the mobile router (sum of Code 128 through Code 191) and visited foreign agent (sum of Codes 64 through Code 127).

Denied due to mismatched ID

Total number of registration requests denied by the home agent due to identification mismatch. This means that the mobile router needs to synchronize its clock with the home agent in its request. A mobile router will adjust its time in the identification field to match the home agent’s time for subsequent requests.

Authentication failed for HA/FA

Total number of authentication failures.

Invalid extensions

Total number of registration replies dropped by the mobile router due to both poorly formed extensions and unrecognized extensions with extension number in the range from 0 to 127.

Invalid ignored

Total number of registration replies that contained one or more unrecognized extensions in the range from 128 to 255 that were ignored by the mobile router.

Invalid home address

Total number of replies with an invalid home address.

Invalid ID

Total number of replies with an invalid Identification field.

Unknown HA/FA

Total number of replies with unknown home agents or foreign agents.

Gratuitous ARPs sent

Total number of Gratuitous ARPs sent by the mobile router in order to clear out any stale ARP entries in the ARP caches of nodes on the home network.

Movement

Counters categorized for movement.

Came up on HA/on FA

Number of times the mobile router came up on its home network or some foreign network.

Moved HA to FA / FA to FA / FA to HA

Number of times that the mobile router moved between its home network and the foreign network, and among foreign networks.

Better interface detected

Number of times a better interface was detected.

Tunnel Traffic

Counters categorized for tunnel traffic while the mobile router is roaming.

Packets received / sent

Number of packets received and sent by the mobile router.

Bytes received / sent

Number of bytes received and sent by the mobile router.

Services:

Mobile router services.

Redundancy state active <2>, passive <1>

Number of times the mobile router changes between active and passive states, which occurs when a redundancy state change is detected.

Related Commands

Command

Description

clear ip mobile router traffic

Clears the counters that the mobile router maintains.

show ip mobile secure

To display the mobility security associations for the mobile host, mobile visitor, foreign agent, home agent, or proxy Mobile IP host, use the show ip mobile securecommand in privileged EXEC mode.

show ip mobile secure { host | visitor | foreign-agent | home-agent | proxy-host | summary } { ip-address | nai string }

Syntax Description

host

Displays security association of the mobile host on the home agent.

visitor

Displays security association of the mobile visitor on the foreign agent.

foreign-agent

Displays security association of the remote foreign agents on the home agent.

home-agent

Displays security association of the remote home agent on the foreign agent.

proxy-host

Displays security association of the proxy mobile user. This keyword is only available on Packet Data Serving Node (PDSN) platforms running specific PDSN code images.

summary

Displays number of security associations in table.

ip-address

IP address.

nai string

Network access identifier (NAI).

Command Modes


EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

12.2(2)XC

The nai keyword was added.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.3(4)T

The proxy-host keyword was added for PDSN platforms.

Usage Guidelines

Multiple security associations can exist for each entity.

The proxy-host keyword is only available on PDSN platforms running specific PDSN code images; consult Feature Navigator for your Cisco IOS software release.

Examples

The following is sample output from the show ip mobile securecommand:

Router# show ip mobile secure 
Security Associations (algorithm,mode,replay protection,key):
10.0.0.6
    SPI 300,  MD5, Prefix-suffix, Timestamp +/- 7,
    Key 00112233445566778899001122334455

The below table describes the significant fields shown in the display.

Table 12 show ip mobile secure Field Descriptions

Field

Description

10.0.0.6

IP address. The NAI is displayed if configured.

In/Out SPI

The SPI is the 4-byte opaque index within the mobility security association that selects the specific security parameters to be used to authenticate the peer. Allows either “SPI” or “In/Out SPI.” The latter specifies an inbound and outbound SPI pair. If an inbound SPI is received, then outbound SPI will be used when a response is sent.

MD5

Message Digest 5 authentication algorithm. HMAC-MD5 id displayed if configured.

Prefix-suffix

Authentication mode.

Timestamp

Replay protection method.

Key

The shared secret key for the security associations, in hexadecimal format.

show ip mobile traffic

To display protocol counters, use the show ip mobile trafficcommand in privileged EXEC mode.

show ip mobile traffic

Syntax Description

This command has no arguments or keywords.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

12.2(13)T

This command was enhanced to display successful registration requests with NAT detect and to display information about foreign agent reverse tunnels and foreign agent challenge and response extensions.

12.3(14)T

The command output was enhanced to display the count of UDP Port 434 input packets that were dropped by UDP.

Usage Guidelines

Counters can be reset to zero using the clear ip mobile trafficcommand, which also allows you to undo the reset.

Examples

The following is sample output from the show ip mobile trafficcommand:

Router# show ip mobile traffic
IP Mobility traffic:
UDP:
    Port: 434 (Mobile IP) input drops: 0
Advertisements:
    Solicitations received 0
    Advertisements sent 0, response to solicitation 0
Home Agent Registrations:
    Register 0, Deregister 0 requests
    Register 0, Deregister 0 replied
    Accepted 0, No simultaneous bindings 0
    Denied 0, Ignored 0 
    Unspecified 0, Unknown HA 0
    Administrative prohibited 0, No resource 0
    Authentication failed MN 0, FA 0
    Bad identification 0, Bad request form 0
    Unavailable encap 0, reverse tunnel 0
    Reverse tunnel mandatory 0
    Binding updates received 0, sent 0 total 0 fail 0
    Binding update acks received 0, sent 0 
    Binding info request received 0, sent 0 total 0 fail 0
    Binding info reply received 0 drop 0, sent 0 total 0 fail 0
    Binding info reply acks received 0 drop 0, sent 0
    Gratuitous 0, Proxy 0 ARPs sent
    Total incoming requests using NAT detect 1
Foreign Agent Registrations:
    Request in 0,
    Forwarded 0, Denied 0, Ignored 0
    Unspecified 0, HA unreachable 0
    Administrative prohibited 0, No resource 0
    Bad lifetime 0, Bad request form 0
    Unavailable encapsulation 0, Compression 0
    Unavailable reverse tunnel 0
    Reverse tunnel mandatory
    Replies in 0
    Forwarded 0, Bad 0, Ignored 0
    Authentication failed MN 0, HA 0
    Received challenge/gen. authentication extension, feature not enabled 0
    Route Optimization Binding Updates received 0, acks sent 0 neg acks sent 0
    Unknown challenge 1, Missing challenge 0, Stale challenge 0

The below table describes the significant fields shown in the display.

Table 13 show ip mobile traffic Field Descriptions

Field

Description

Port: 434 (Mobile IP) input drops

Total number of UDP Port 434 (Mobile IP) packets dropped by UDP processing due to a full input queue. These packets are not processed by the home agent or foreign agent and so are not otherwise counted or displayed by Mobile IP. This count is the same count displayed by using the show ip socket detail command.

Solicitations received

Total number of solicitations received by the mobility agent.

Advertisements sent

Total number of advertisements sent by the mobility agent.

response to solicitation

Total number of advertisements sent by the mobility agent in response to mobile node solicitations.

Home Agent

Register requests

Total number of registration requests received by the home agent.

Deregister requests

Total number of registration requests received by the home agent with a lifetime of zero (requests to deregister).

Register replied

Total number of registration replies sent by the home agent.

Deregister replied

Total number of registration replies sent by the home agent in response to requests to deregister.

Accepted

Total number of registration requests accepted by the home agent (Code 0).

No simultaneous bindings

Total number of registration requests accepted by the home agent--simultaneous mobility bindings unsupported (Code 1).

Denied

Total number of registration requests denied by the home agent.

Ignored

Total number of registration requests ignored by the home agent.

Unspecified

Total number of registration requests denied by the home agent--reason unspecified (Code 128).

Unknown HA

Total number of registration requests denied by the home agent--unknown home agent address (Code 136).

Administrative prohibited

Total number of registration requests denied by the home agent--administratively prohibited (Code 129).

No resource

Total number of registration requests denied by the home agent--insufficient resources (Code 130).

Authentication failed MN

Total number of registration requests denied by the home agent--mobile node failed authentication (Code 131).

Authentication failed FA

Total number of registration requests denied by the home agent--foreign agent failed authentication (Code 132).

Bad identification

Total number of registration requests denied by the home agent--identification mismatch (Code 133).

Bad request form

Total number of registration requests denied by the home agent--poorly formed request (Code 134).

Unavailable encap

Total number of registration requests denied by the home agent--unavailable encapsulation (Code 139).

Reverse tunnel mandatory

Total number of registration requests denied by the home agent--reverse tunnel is mandatory and the “T” bit is not set (Code 138).

Unavailable reverse tunnel

Total number of registration requests denied by the home agent--reverse tunnel unavailable (Code 137).

Binding updates

A Mobile IP standby message sent from the active router to the standby router when a registration request comes into the active router.

Binding update acks

A Mobile IP standby message sent from the standby router to the active router to acknowledge the reception of a binding update.

Binding info request

A Mobile IP standby message sent from a router coming up from reboot/or a down interface. The message is a request to the current active router to send the entire Mobile IP binding table.

Binding info reply

A reply from the active router to the standby router that has part or all of the binding table (depending on size).

Binding info reply acks

An acknowledge message from the standby router to the active router that it has received the binding info reply.

Gratuitous ARP

Total number of gratuitous ARPs sent by the home agent on behalf of mobile nodes.

Proxy ARPs sent

Total number of proxy ARPs sent by the home agent on behalf of mobile nodes.

Total incoming registration requests...

Total number incoming registration requests using NAT detect.

Foreign Agent

Request in

Total number of registration requests received by the foreign agent.

Forwarded

Total number of registration requests relayed to the home agent by the foreign agent.

Denied

Total number of registration requests denied by the foreign agent.

Ignored

Total number of registration requests ignored by the foreign agent.

Unspecified

Total number of registration requests denied by the foreign agent--reason unspecified (Code 64).

HA unreachable

Total number of registration requests denied by the foreign agent--home agent unreachable (Codes 80-95).

Administrative prohibited

Total number of registration requests denied by the foreign agent-- administratively prohibited (Code 65).

No resource

Total number of registration requests denied by the home agent--insufficient resources (Code 66).

Bad lifetime

Total number of registration requests denied by the foreign agent--requested lifetime too long (Code 69).

Bad request form

Total number of registration requests denied by the home agent--poorly formed request (Code 70).

Unavailable encapsulation

Total number of registration requests denied by the home agent--unavailable encapsulation (Code 72).

Unavailable compression

Total number of registration requests denied by the foreign agent--requested Van Jacobson header compression unavailable (Code 73).

Unavailable reverse tunnel

Total number of registration requests denied by the home agent--reverse tunnel unavailable (Code 74).

Reverse tunnel mandatory

Total number of registration requests denied by the foreign agent--reverse tunnel is mandatory and the “T” bit is not set (Code 75).

Replies in

Total number of well-formed registration replies received by the foreign agent.

Forwarded

Total number of valid registration replies relayed to the mobile node by the foreign agent.

Bad

Total number of registration replies denied by the foreign agent--poorly formed reply (Code 71).

Ignored

Total number of registration replies ignored by the foreign agent.

Authentication failed MN

Total number of registration requests denied by the home agent--mobile node failed authentication (Code 67).

Authentication failed HA

Total number of registration replies denied by the foreign agent--home agent failed authentication (Code 68).

Received challenge/gen. authentication extension, feature not enabled

Total number of registration requests dropped by the foreign agent--received challenge/generalized-authentication extension in registration request but Mobile IP foreign agent challenge/response extension is not enabled.

Unknown challenge

Total number of registration requests denied by the foreign agent--unknown challenge (Code 104).

Missing Challenge

Total number of registration requests denied by the foreign agent--missing challenge (Code 105).

Stale Challenge

Total number of registration requests denied by the foreign agent--stale challenge (Code 106).

show ip mobile tunnel

To display active tunnels, use the show ip mobile tunnelcommandinEXEC mode.

show ip mobile tunnel [interface]

Syntax Description

interface

(Optional) Displays a particular tunnel interface. The interface argument is tunnel x.

Command Modes


EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

12.2(13)T

The output was enhanced to display route maps configured on the home agent.

12.2(15)T

The output was enhanced to display tunnel templates for multicast configured on the home agent or mobile router.

12.3(8)T

The output was enhanced to display UDP tunneling.

12.4(9)T

The command was enhanced to display information about multipath support.

Usage Guidelines

This command displays active tunnels created by Mobile IP. When no more users are on the tunnel, the tunnel is released.

Examples

The following is sample output from the show ip mobile tunnelcommand:

Router# show ip mobile tunnel
Mobile Tunnels:
Tunnel0:
 src 10.0.0.32, dest 10.0.0.48
 encap IP/IP, mode reverse-allowed, tunnel-users 1
 IP MTU 1480 bytes
 HA created, fast switching enabled, ICMP unreachable enabled
 0 packets input, 0 bytes, 0 drops
 1591241 packets output, 1209738478 bytes
 Route Map is: MoIPMap
Running template configuration for this tunnel:
ip pim sparse-dense-mode

The following is sample output from the show ip mobile tunnel command that verifies that UDP tunneling is established:

Router# show ip mobile tunnel
Mobile Tunnels:
Total mobile ip tunnels 1
Tunnel0:
    src 10.30.30.1, dest 10.10.10.100
    src port 434, dest port 434
    encap MIPUDP/IP, mode reverse-allowed, tunnel-users 1
    IP MTU 1480 bytes
    Path MTU Discovery, mtu: 0, ager: 10 mins, expires: never
    outbound interface Ethernet2/3
    FA created, fast switching disabled, ICMP unreachable enabled
    5 packets input, 600 bytes, 0 drops
    7 packets output, 780 bytes

The following is sample output from the show ip mobile tunnel command that shows that the mobile node-home agent tunnel is still IP-in-IP, but that the foreign agent-home agent tunnel is UDP:

Router# show ip mobile tunnel
Mobile Tunnels:
Total mobile ip tunnels 2
Tunnel0:
 src 10.2.1.1, dest 10.99.100.2
 encap IP/IP, mode reverse-allowed, tunnel-users 1
 IP MTU 1460 bytes
 Path MTU Discovery, mtu: 0, ager: 10 mins, expires: never
 outbound interface Tunnel1
 HA created, fast switching enabled, ICMP unreachable enabled
 11 packets input, 1002 bytes, 0 drops
 5 packets output, 600 bytes
Tunnel1:
 src 10.2.1.1, dest 100.3.1.5
 src port 434, dest port 434
 encap MIPUDP/IP, mode reverse-allowed, tunnel-users 1
 IP MTU 1480 bytes
 Path MTU Discovery, mtu: 0, ager: 10 mins, expires: never
 outbound interface GigabitEthernet0/2
 HA created, fast switching disabled, ICMP unreachable enabled
 11 packets input, 1222 bytes, 0 drops
 7 packets output, 916 bytes

The following is sample output from the show ip mobile tunnel command that shows that the mobile node has UDP tunneling established with the home agent:

Router# show ip mobile tunnel
Total mobile ip tunnels 1
Tunnel0:
 src 10.10.10.100, dest 10.10.10.50
 src port 434, dest port 434
 encap MIPUDP/IP, mode reverse-allowed, tunnel-users 1
 IP MTU 1480 bytes
 Path MTU Discovery, mtu: 0, ager: 10 mins, expires: never
 outbound interface Ethernet2/1
 HA created, fast switching disabled, ICMP unreachable enabled
 5 packets input, 600 bytes, 0 drops
 5 packets output, 600 bytes

The following is sample output when the mobile router is configured for multipath support:

Router# show ip mobile tunnel
Mobile Tunnels:
Total mobile ip tunnels 1
Tunnel0:
    src 10.1.1.11, dest 10.1.1.10 Key 6
    encap IP/IP, mode reverse-allowed, tunnel-users 1
    IP MTU 1480 bytes
    Path MTU Discovery, mtu: 0, ager: 10 mins, expires: never
    outbound interface Ethernet1/0
    MR created, fast switching enabled, ICMP unreachable enabled
    4 packets input, 306 bytes, 0 drops
    6 packets output, 436 bytes
    Template configuration:
        ip pim sparse-dense-mode

The below table describes the significant fields shown in the display.

Table 14 show ip mobile tunnel Field Descriptions

Field

Description

src

Tunnel source IP address.

dest

Tunnel destination IP address.

Key

Identifies the tunnel when there are multiple tunnels between the same end points (source address and destination address) for multipath support. This situation can occur if a mobile router registers through foreign agents on different interfaces. All of the HA-MR tunnels would have the same end points.

encap

Tunnel encapsulation type.

mode

Either reverse-allowed or reverse-off for reverse tunnel mode.

tunnel-users

Number of users on the tunnel.

HA created

Entity that created the tunnel. This field can be one of three values: HA created, FA created, or MR created.

fast switching

Enabled or disabled.

ICMP unreachable

Enabled or disabled.

packets input

Number of packets in.

bytes

Number of bytes in.

drops

Number of packets dropped. Packets are dropped when there are no visitors to send to after the foreign agent deencapsulates incoming packets. This prevents loops because the foreign agent will otherwise route the de-encapsulated packets back to the home agent.

packets output

Number of packets output.

bytes

Number of bytes output.

Route Map is

Name of the route map.

Running template configuration

If tunnel templates for multicast are enabled or disabled, this information is displayed or absent, respectively.

Related Commands

Command

Description

show ip mobile binding

Displays the mobility binding table.

show ip mobile host

Displays mobile node information.

show ip mobile visitor

Displays the table that contains a visitor list of foreign agents.

show ip mobile violation

To display information about security violations, use the show ip mobile violationcommand in privileged EXEC mode.

show ip mobile violation [ address | nai string ]

Syntax Description

address

(Optional) Displays violations from a specific IP address.

nai string

(Optional) Network access identifier.

Command Modes


EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

12.2(2)XC

The nai keyword and associated parameters were added.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines

The most recent violation is saved for all the mobile nodes. A circular log holds up to 50 unknown requesters, which are the violators without security associations. The oldest violations will be purged to make room for new unknown requesters when the log limit is reached.

Security violation messages are logged at the informational level (see the logging global configuration command). When logging is enabled to include this severity level, violation history can be displayed using the show logging command.

Examples

The following is sample output from the show ip mobile violationcommand:

Router# show ip mobile violation
Security Violation Log:
 
Mobile Hosts:
20.0.0.1:
    Violations: 1, Last time: 06/18/97 01:16:47
    SPI: 300, Identification: B751B581.77FD0E40
    Error Code: MN failed authentication (131), Reason: Bad authenticator (2)

The below table describes significant fields shown in the display.

Table 15 show ip mobile violation Field Descriptions

Field

Description

IP address

IP address of the violator. The network access identifier (NAI) is displayed if configured.

Violations

Total number of security violations for this peer.

Last time

Time of the most recent security violation for this peer.

SPI

SPI of the most recent security violation for this peer. If the security violation is due to an identification mismatch, then this is the SPI from the mobile-home authentication extension. If the security violation is due to an invalid authenticator, then this is the SPI from the offending authentication extension. In all other cases, it should be set to zero.

Identification

Identification used in request or reply of the most recent security violation for this peer.

Error Code

Error code in request or reply.

Reason Codes

Reason for the most recent security violation for this peer. Possible reasons are:

  • (1) No mobility security association
  • (2) Bad authenticator
  • (3) Bad identifier
  • (4) Bad SPI
  • (5) Missing security extension
  • (6) Other

show ip mobile visitor

To display the visitor table that contains information on mobile nodes (MNs) using this foreign agent (FA), use the show ip mobile visitorcommand inprivilegedEXEC mode.

show ip mobile visitor [ [pending] [ ip-address | summary ] | nai string [ session-id string ] ]

Syntax Description

pending

(Optional) Displays the pending registration table.

ip-address

(Optional) IP address of visiting MNs.

summary

(Optional) Displays all values in the table.

nai string

(Optional) Network access identifier (NAI).

session-id string

(Optional) Session identifier. The string value must be fewer than 25 characters.

Command Modes


Privileged EXEC

Command History

Release

Modification

12.0(1)T

This command was introduced.

12.2(2)XC

The nai keyword was added.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T.

12.3(4)T

The session-id keyword was added.

12.3(8)T

The output was enhanced to display UDP tunneling.

Usage Guidelines

Use this command to find out information on MNs that are registered with their (home agent) HA via this FA. The FA updates the visitor table that contain a list of the MNs using a FA.

A session identifier is used to uniquely identify a Mobile IP flow. A Mobile IP flow is the set of {NAI, IP address}. The flow allows a single NAI to be associated with one or multiple IP addresses, for example, {NAI, ipaddr1}, {NAI, ipaddr2}, and so on. A single user can have multiple sessions for example, when logging through different devices such as a PDA, cellular phone, or laptop. If the session identifier is present in the initial registration, it must be present in all subsequent registration renewals from that MN.

Examples

The following is sample output from the show ip mobile visitorcommand:

Router# show ip mobile visitor
Mobile Visitor List:
Total 1
10.0.0.1:
 Interface Ethernet1/2, MAC addr 0060.837b.95ec
 IP src 20.0.0.1, dest 67.0.0.31, UDP src port 434
 HA addr 66.0.0.5, Identification B7510E60.64436B38
 Lifetime 08:20:00 (30000) Remaining 08:19:16
 Tunnel100 src 68.0.0.31, dest 66.0.0.5, reverse-allowed
 Routing Options - (T)Reverse-tunnel

If the mobile node has visited and is associated with a session identifier, then the visitor entry for the mobile node shows the session identifier as shown below:

Router# show ip mobile visitor
 
Mobile Visitor List:
Total 1
 user01@cisco.com
 Home addr 100.100.100.17
  Interface Ethernet3/3, MAC addr 0004.6d25.b857
  IP src 0.0.0.0, dest 100.100.100.1, UDP src port 434
  HA addr 100.100.100.100, Identification BC189864.B2FE6CC4
  Lifetime 00:33:20 (2000) Remaining 00:33:06
  Tunnel0 src 70.70.70.2, dest 100.100.100.100, reverse-allowed
  Routing Options - (B)Broadcast
  Session identifier PD

The following sample output shows that the MN is registering with the HA (at the FA):

Router# show ip mobile visitor
Mobile Visitor List:
Total 1
10.99.100.2:
 Interface FastEthernet3/0, MAC addr 00ff.ff80.002b
 IP src 10.99.100.2, dest 30.5.3.5, UDP src port 434
 HA addr 200.1.1.1, Identification BCE7E391.A09E8720
 Lifetime 01:00:00 (3600) Remaining 00:30:09
 Tunnel1 src 200.1.1.5, dest 200.1.1.1, reverse-allowed
 Routing Options - (T)Reverse Tunneling

The below table describes the significant fields shown in the display.

Table 16 show ip mobile visitor Field Descriptions

Field

Description

Total

Number of mobile nodes visiting the foreign agent.

10.0.0.1

Home IP address of a visitor. The NAI is displayed if configured.

Interface

Interface the FA received the MN’s registration on.

MAC addr

MAC address of the visitor.

IP src

Source IP address of the registration request of a visitor.

IP dest

Destination IP address of the registration request of a visitor. A MN solicits an advertisement from the FA, and the FA uses the output interface’s address (where it received the solicitation) as the source IP address in the advertisement. The MN picks up on this address and sends in a RRQ to it. This tells you which destination address the MN used when it sent in its registration request to the FA (typically the interface address). If it had sent the registration request to a broadcast or multicast address, or advertised address (not knowing the interface address), the FA will reply using the output interface address (typically the interface where it received the RRQ).

UDP src port

UDP src port used by the visiting mobile node in its registration request.

HA addr

Home agent IP address for that visiting mobile node.

Identification

Identification used in that registration by the mobile node.

Lifetime

The lifetime (in hh:mm:ss) granted to the mobile node for this registration.

Remaining

The time (in hh:mm:ss) remaining until the registration is expired. It has the same initial value as in the Lifetime field, and is counted down by the foreign agent.

Tunnel

The tunnel used by the mobile node is characterized by the source and destination addresses, and reverse-allowed or reverse-off for reverse tunnel. The options are IPIP, GRE, and UDP. The default is IPIP encapsulation.

Routing Options

Routing options list all foreign agent-accepted services, based on registration flags sent by the mobile node. Options are:

  • (S) Multi-binding (not supported on home agent)
  • (B) Broadcast
  • (D) Direct-to-mobile node
  • (M) MinIP (not supported on home agent)
  • (G) GRE
  • (T) Reverse-tunnel

Session identifier

Session identifier can be the device name or MAC address.

Related Commands

Command

Description

debug ip mobile

Displays IP mobility activities.

ip mobile foreign-agent nat traversal

Enables NAT UDP traversal support for MIP FAs.

ip mobile home-agent nat traversal

Enables NAT UDP traversal support for MIP HAs.

show ip mobile binding

Displays the mobility binding table.

show ip mobile globals

Displays global information about MIP HAs, FAs, and MNs.

show ip mobile tunnel

Displays information about UDP tunneling.

show ip mobile vpn-realm

To display virtual private network (VPN) realms configured for Mobile IP, use the show ip mobile vpn-realmcommand in EXEC mode.

show ip mobile vpn-realm

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values.

Command Modes


EXEC

Command History

Release

Modification

12.2(13)T

This command was introduced.

Usage Guidelines

Use this command to display VPN realms configured by the ip mobile vpn-realmcommand.

Examples

The following example output shows which VPN realms and corresponding sequence numbers are configured for Mobile IP:

Router# show ip mobile vpn-realm
IP Mobile VPN realm(s):
    Sequence number: 20      Realm: company1
    Sequence number: 10      Realm: company2

Related Commands

Command

Description

ip mobile vpn-realm

Defines VPN realms to be used in home agent policy routing.

show ipv6 mobile pmipv6 lma binding

To display the list of the Local Mobility Anchor (LMA) bindings established over the Proxy Mobile IPv6 (PMIPv6) signaling plane, use the show ipv6 mobile pmipv6 lma binding command in privileged EXEC mode.

show ipv6 mobile pmipv6 lma binding [ mag peer-id | nai string ]

Syntax Description

mag peer-id

(Optional) Displays the bindings for the Mobile Access Gateway (MAG).

nai string

(Optional) Displays the bindings for the mobile node (MN).

Command Default

The list of the bindings established over the Proxy Mobile IPv6 (PMIPv6) signaling plane is displayed.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS XE Release 3.6S

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Cisco IOS XE Release 3.9S

This command was modified. The command output was enhanced to display the third-generation mobility anchor (3GMA) bindings.

Examples

The following is sample output from the show ipv6 mobile pmipv6 mag binding command. The fields in the display are self-explanatory.

Device# show ipv6 mobile pmipv6 lma binding

Total number of bindings: 1
----------------------------------------
[Binding][MN]: Domain: D1, NAI: MN1@example.com
[Binding][MN]: HOA: 16.16.16.2, Prefix: 24
[Binding][MN]: HNP: 0
[Binding][MN][PEER]: Default Router: 16.16.16.1
       [Binding][MN]: ATT: 3GPP_GERAN (6)
               [Binding][MN][PEER1]:LLID: aabb.cc01.2d00:MN1@c3GMA
               [Binding][MN][PEER1]: Id: 3GMA
               [Binding][MN][PEER1]: Lifetime: 10(sec)
               [Binding][MN][PEER1]: Lifetime Remaining: 5(sec)
       [Binding][MN]: ATT: WLAN (4)
               [Binding][MN][PEER2]:LLID: aabb.cc01.2d00
               [Binding][MN][PEER2]: Id: WIFI_MAG
               [Binding][MN][PEER2]: Lifetime: 10(sec)
               [Binding][MN][PEER2]: Lifetime Remaining: 8(sec)
               [Binding][MN][PEER2]: Tunnel: Tunnel0
               [Binding][MN][GREKEY]: Upstream: 10, Downstream: 10

The table below describes the significant fields shown in the display.

Table 17 show ipv6 mobile pmipv6 lma binding Field Descriptions

Field

Description

Domain

Configured PMIPV6 domain.

HOA

Home address.

HNP

Home network prefix.

Default Router

IP address of the default router.

LLID

Link layer identifier.

Id

Peer identifier.

Lifetime

Total lifetime (in hh:mm:ss) of the 3GPP binding cache entry (BCE).

Lifetime Remaining

The time (in hh:mm:ss) remaining until the binding expires.

Tunnel

The tunnel used by the mobile node is characterized by the source and destination addresses and reverse-allowed or reverse-off for reverse tunnel.

Upstream

Upstream Generic Routing Encapsulation (GRE) Key.

Downstream

Downstream GRE Key.

The following is sample output from the show ipv6 mobile pmipv6 lma binding mag peer-id command. The fields in the display are self-explanatory.

Device# show ipv6 mobile pmipv6 lma binding mag lma1

Total number of bindings: 1
----------------------------------------
[Binding][MN]: Domain: D1, Nai: example1@example.com
        [Binding][MN]: State: ACTIVE
        [Binding][MN]: Interface: GigabitEthernet0/0/0
        [Binding][MN]: Hoa: 0x11110002, att: 3, llid: aabb.cc00.c900
        [Binding][MN][LMA]: Id: LMA1
        [Binding][MN][LMA]: lifetime: 3600

Related Commands

Command

Description

ipv6 mobile pmipv6-lma

Configures the LMA for the PMIP domain.

show ipv6 mobile pmipv6 lma globals

To display the Local Mobility Anchor (LMA) global configuration details, use the show ipv6 mobile pmipv6 lma globals command in privileged EXEC mode.

show ipv6 mobile pmipv6 lma globals

Syntax Description

This command has no arguments or keywords.

Command Default

The contents of the LMA configuration file, except for the default configuration.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS XE Release 3.6S

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Examples

The following is sample output from the show ipv6 mobile pmipv6 lma globals command. The fields in the display are self-explanatory.

Device# show ipv6 mobile pmipv6 lma globals

Domain  : D1

LMA Identifier  : lma1
        AAA Accounting                  : Disabled
        Default MN Profile              : profile1
        Network                         : n1
        IPv4 Pool Name                  : v4 Prefix Length: 24
        IPv6 Pool Name                  : v6pool Prefix Length: 48
        Max. HNPs                       : 1
        Max Bindings                    : 128000
        AuthOption                      : disabled
        RegistrationLifeTime            : 3600 (sec)
        DeleteTime                      : 10000 (msec)
        CreateTime                      : 1500 (msec)
        BRI InitDelayTime               : 1000 (msec)
        BRI MaxDelayTime                : 2000 (msec)
        BRI MaxRetries                  : 1
        BRI EncapType                   : IPV6_IN_IPV6
        Fixed Link address is           : enabled
        Fixed Link address              : 6161.6262.2e63
        Fixed Link Local address is     : enabled
        Fixed Link local address        : FE80::8
        RefreshTime                     : 300 (sec)
        Refresh RetxInit time           : 1000 (msec)
        Refresh RetxMax time            : 32000 (msec)
        Timestamp option                : enabled
        Validity Window                 : 10

Peer :  mag1
        Max. HNPs                       : 1
        Max Bindings                    : 128000
        AuthOption                      : disabled
        RegistrationLifeTime            : 3600 (sec)
        DeleteTime                      : 10000 (msec)
        CreateTime                      : 1500 (msec)
        BRI InitDelayTime               : 1000 (msec)
        BRI MaxDelayTime                : 2000 (msec)
        BRI MaxRetries                  : 1
        BRI EncapType                   : IPV6_IN_IPV6
        Fixed Link address is           : enabled
        Fixed Link address              : 6161.6262.2e63
        Fixed Link Local address is     : enabled
        Fixed Link local address        : FE80::8
        RefreshTime                     : 300 (sec)
        Refresh RetxInit time           : 1000 (msec)
        Refresh RetxMax time            : 32000 (msec)
        Timestamp option                : enabled
        Validity Window                 : 10

Peer :  mag0
        Max. HNPs                       : 1
        Max Bindings                    : 128000
        AuthOption                      : disabled
        RegistrationLifeTime            : 3600 (sec)
        DeleteTime                      : 10000 (msec)
        CreateTime                      : 1500 (msec)
        BRI InitDelayTime               : 1000 (msec)
        BRI MaxDelayTime                : 2000 (msec)
        BRI MaxRetries                  : 1
        BRI EncapType                   : GRE in IPV4
        Fixed Link address is           : enabled
        Fixed Link address              : 6161.6262.2e63
        Fixed Link Local address is     : enabled
        Fixed Link local address        : FE80::8
        RefreshTime                     : 300 (sec)
        Refresh RetxInit time           : 1000 (msec)
        Refresh RetxMax time            : 32000 (msec)
        Timestamp option                : enabled
        Validity Window                 : 10

Related Commands

Command

Description

ipv6 mobile pmipv6-lma

Configures the LMA for the PMIP domain.

show ipv6 mobile pmipv6 lma stats

To display the global Local Mobility Anchor (LMA) statistics, use the show ipv6 mobile pmipv6 lma stats command in privileged EXEC mode.

show ipv6 mobile pmipv6 lma stats [ domain domain-name peer peer-name ]

Syntax Description

domain domain-name

(Optional) Specifies the Proxy Mobile IPv6 (PMIPv6) domain.

peer peer-name

(Optional) Specifies the Mobile Access Gateway (MAG).

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS XE Release 3.6S

This command was introduced.

Examples

The following is sample output from the show ipv6 mobile pmipv6 lma stats command:

Router# show ipv6 mobile pmipv6 lma stats

----------------------------------------
[lma1] Stats: Total Bindings:1 
Proxy Binding Update Received Stats
Total                         : 2260    Drop                          : 0
AAA Accounting Stats
Start Accounting Sent         : 0       Stop Accounting Sent          : 0
-------------------------------------------------
Proxy Binding Acknowledgment Sent Stats
Total                         : 2260    Drop                          : 0
BA_ACCEPTED                   : 2259    BA_UNKNOWN                    : 0
BA_UNSPEC_FAIL                : 0       BA_ADMIN_FAIL                 : 0
BA_RESOURCE_FAIL              : 0       BA_HM_REG_FAIL                : 0
BA_HM_SUBNET_FAIL             : 0       BA_BAD_SEQ_FAIL               : 0
BA_CHANGE_FAIL                : 0       BA_AUTH_FAIL                  : 0
PROXY_REG_NOT_ENABLED         : 0       NOT_LMA_FOR_THIS_MN           : 0
MAG_NOT_AUTH_FOR_PROXY_REG    : 0       NOT_AUTHORIZED_FOR_HNP        : 0
TIMESTAMP_MISMATCH            : 0       TIMESTAMP_LOWER_THAN_PREV     : 1
MISSING_HNP_OPTION            : 0       BCE_PBU_PFX_SET_DO_NOT_MATCH  : 0
MISSING_MN_IDENTIFIER_OPTION  : 0       MISSING_HI_OPTION             : 0
NOT_AUTH_FOR_IPV4_MOBILITY    : 0       NOT_AUTH_FOR_IPV4_HOME_ADDRESS: 0
NOT_AUTH_FOR_IPV6_MOBILITY    : 0       MULTIPLE_IPV4_HOA_NO_SUPPORT  : 0
GRE_KEY_OPTION_NOT_REQUIRED   : 0
-------------------------------------------------
Proxy Binding Revocation Acknowledgment Received Stats
Total                         : 0       Drop                          : 0
BR_SUCCESS                    : 0       BR_PARTIAL_SUCCESS            : 0
BR_NO_BINDING                 : 0       BR_HOA_REQUIRED               : 0
BR_GLOBAL_REVOC_NOT_AUTH      : 0       BR_MN_IDENTITY_REQUIRED       : 0
BR_MN_ATTACHED                : 0       BR_UNKNOWN_REVOC_TRIGGER      : 0
BR_REVOC_FUNC_NOT_SUPPORTED   : 0       BR_PBR_NOT_SUPPORTED_STATS    : 0
-------------------------------------------------
Proxy Binding Revocation Acknowledgment Sent Stats
Total                         : 0       Drop                          : 0
BR_SUCCESS                    : 0       BR_PARTIAL_SUCCESS            : 0
BR_NO_BINDING                 : 0       BR_HOA_REQUIRED               : 0
BR_GLOBAL_REVOC_NOT_AUTH      : 0       BR_MN_IDENTITY_REQUIRED       : 0
BR_MN_ATTACHED                : 0       BR_UNKNOWN_REVOC_TRIGGER      : 0
BR_REVOC_FUNC_NOT_SUPPORTED   : 0       BR_PBR_NOT_SUPPORTED_STATS    : 0
-------------------------------------------------
Proxy Binding Revocation Indication Received Stats
Total                         : 0       Drop                          : 0
BR_UNSPECIFIED                : 0       BR_ADMIN_REASON               : 0
BR_MAG_HANDOVER_SAME_ATT      : 0       BR_MAG_HANDOVER_DIFF_ATT      : 0
BR_MAG_HANDOVER_UNKNOWN       : 0       BR_USER_SESS_TERMINATION      : 0
BR_NETWORK_SESS_TERMINATION   : 0       BR_OUT_OF_SYNC_BCE_STATE      : 0
BR_PER_PEER_POLICY            : 0       BR_REVOKING_MN_LOCAL_POLICY   : 0
-------------------------------------------------
Proxy Binding Revocation Indication Sent Stats
Total                         : 0       Drop                          : 0
BR_UNSPECIFIED                : 0       BR_ADMIN_REASON               : 0
BR_MAG_HANDOVER_SAME_ATT      : 0       BR_MAG_HANDOVER_DIFF_ATT      : 0
BR_MAG_HANDOVER_UNKNOWN       : 0       BR_USER_SESS_TERMINATION      : 0
BR_NETWORK_SESS_TERMINATION   : 0       BR_OUT_OF_SYNC_BCE_STATE      : 0
BR_PER_PEER_POLICY            : 0       BR_REVOKING_MN_LOCAL_POLICY   : 0

-------------------------------------------------
MM Stats
Drop                          : 0       Checksum Error                : 0

The table below describes the significant fields shown in the display. The other fields are self-explanatory.

Table 18 show ipv6 mobile pmipv6 mag stats Field Descriptions

Field

Description

Proxy Binding Update Received Stats

The Proxy Binding Update (PBU) received by the LMA.

Proxy Binding Acknowledgment Sent Stats

The Proxy Binding Revocation Acknowledgment (PBRA) message sent from the LMA to the MAG and vice versa.

Proxy Binding Revocation Acknowledgment Received Stats

The Proxy Binding Revocation Acknowledgment (PBRA) message received by the MAG from the LMA and vice versa.

Proxy Binding Revocation Acknowledgment Sent Stats

The Proxy Binding Revocation Acknowledgment (PBRA) message sent from from the LMA to the MAG and vice versa.

Proxy Binding Revocation Indication Received Stats

The Proxy Binding Revocation Indication (PBRI) message received by the MAG from the LMA and vice versa.

Proxy Binding Revocation Indication Sent Stats

The Proxy Binding Revocation Indication message sent from the LMA to the MAG and vice versa.

The following is sample output from the show ipv6 mobile pmipv6 lma stats domain command:

Device# show ipv6 mobile pmipv6 lma stats domain D1 peer MAG1
----------------------------------------
[MAG1]: PBU Sent                : 7
[MAG1]: PBA Rcvd                : 6
[MAG1]: PBRI Sent               : 0
[MAG1]: PBRI Rcvd               : 0
[MAG1]: PBRA Sent               : 0
[MAG1]: PBRA Rcvd               : 0
[MAG1]: No Of handoff   : 0

Related Commands

Command

Description

ipv6 mobile pmipv6-mag

Configures the MAG for the PMIP domain.

show interfaces tunnel 0 stats

Displays the PMIP tunnel statistics.

show ipv6 mobile pmipv6 lma tunnel

To display details of the Local Mobility Anchor (LMA) tunnels, use the show ipv6 mobile pmipv6 lma tunnel command in privileged EXEC mode.

show ipv6 mobile pmipv6 lma tunnel

Syntax Description

This command has no arguments or keywords.

Command Default

The details of the LMA tunnels are displayed.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS XE Release 3.6S

This command was introduced.

Examples

The following is sample output from the show ipv6 mobile pmipv6 lma tunnel command:

Router# show ipv6 mobile pmipv6 lma tunnel

[lma1] Tunnel Information
Peer [mag0] : Tunnel Bindings 1
  Tunnel0:
        src 10.10.10.2, dest 172.16.0.0
        encap GRE/IP, mode reverse-allowed
        key 0, Outbound Interface Ethernet0/0
    6 packets input, 600 bytes, 0 drops
    6 packets output, 600 bytes

Related Commands

Command

Description

ipv6 mobile pmipv6-lma

Configures the LMA for the PMIPv6 domain.

show ipv6 mobile pmipv6 mag binding

To display the list of the Mobile Access Gateway (MAG) bindings established over the Proxy Mobile IPv6 (PMIPv6) signaling plane, use the show ipv6 mobile pmipv6 mag binding command in privileged EXEC mode.

Cisco IOS XE Release 3.4S

show ipv6 mobile pmipv6 mag binding [ lma lma-id | nai string ]

Cisco IOS XE Release 3.6S

show ipv6 mobile pmipv6 mag binding [ lma | nai string ]

Cisco IOS Release 15.2(4)M and Later Releases

show ipv6 mobile pmipv6 mag mag-id binding [ lma | nai string ]

Syntax Description

mag-id

MAG identifier.

lma

(Optional) Displays the bindings for the Local Mobility Anchor (LMA).

lma-id

(Optional) LMA identifier.

nai string

(Optional) Displays the bindings for the mobile node (MN).

Command Default

The MAG bindings established over the PMIPv6 signaling plane are displayed.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS XE Release 3.4S

This command was introduced.

Cisco IOS XE Release 3.6S

This command was modified. The lma-identifier argument was removed.

15.2(4)M

This command was modified. This command was integrated into Cisco IOS Release 15.2(4)M. The mag-id argument was added.

Usage Guidelines

In the Cisco IOS XE Release 3.4S, the lma lma-identifier keyword-argument pair is available.

Examples

The following is sample output from the show ipv6 mobile pmipv6 mag binding command. The fields in the display are self-explanatory.

Device# show ipv6 mobile pmipv6 mag mag1 binding

Total number of bindings: 2
----------------------------------------
[Binding][MN]: Domain: D1, Nai: MN1@example.com
        [Binding][MN]: State: ACTIVE
        [Binding][MN]: Interface: GigabitEthernet0/1/0
        [Binding][MN]: Hoa: 0x11110002, att: 3, llid: aabb.cc00.c900
        [Binding][MN][LMA]: Id: LMA1
        [Binding][MN][LMA]: lifetime: 3600
----------------------------------------
----------------------------------------
[Binding][MN]: Domain: D1, Nai: MN3@example.com
        [Binding][MN]: State: ACTIVE
        [Binding][MN]: Interface: GigabitEthernet0/0/0
        [Binding][MN]: Hoa: 0x11110102, att: 3, llid: aabb.cc00.ce00
        [Binding][MN][LMA]: Id: LMA2
        [Binding][MN][LMA]: lifetime: 3600
----------------------------------------

The following is sample output from the show ipv6 mobile pmipv6 mag binding lma command. The fields in the display are self-explanatory.

Device# show ipv6 mobile pmipv6 mag mag1 binding lma

Total number of bindings: 1
----------------------------------------
[Binding][MN]: Domain: D1, Nai: MN1@example.com
        [Binding][MN]: State: ACTIVE
        [Binding][MN]: Interface: GigabitEthernet0/0/0
        [Binding][MN]: Hoa: 0x11110002, att: 3, llid: aabb.cc00.c900
        [Binding][MN][LMA]: Id: LMA1
        [Binding][MN][LMA]: lifetime: 3600
----------------------------------------

Related Commands

Command

Description

ipv6 mobile pmipv6-mag

Configures the MAG for the PMIPv6 domain.

show ipv6 mobile pmipv6 mag globals

To display the Mobile Access Gateway (MAG) global configuration details, use the show ipv6 mobile pmipv6 mag globals command in privileged EXEC mode.

show ipv6 mobile pmipv6 mag mag-id globals

Syntax Description

mag-id

MAG identifier.

Command Default

The show ipv6 mobile pmipv6 mag globals command displays contents of the MAG configuration file, except for the default configuration.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS XE Release 3.4S

This command was introduced.

15.2(4)M

This command was modified. This command was integrated into Cisco IOS Release 15.2(4)M. The mag-id argument was added.

Usage Guidelines

The show ipv6 mobile pmipv6 mag globals command displays the configuration settings related to the MAG service.

Examples

The following is sample output from the show ipv6 mobile pmipv6 mag globals command. The fields in the display are self-explanatory.

Router# show ipv6 mobile pmipv6 mag mag1 globals
Domain  : D1
Mag Identifier  : M1
        MN's detach discover            : disabled
        Local routing                   : disabled
        Mag is enabled on interface     : GigabitEthernet0/0/0
        Mag is enabled on interface     : GigabitEthernet0/1/0
        Max Bindings                    : 3
        AuthOption                      : disabled
        RegistrationLifeTime            : 3600 (sec)
        BRI InitDelayTime               : 1000 (msec)
        BRI MaxDelayTime                : 40000 (msec)
        BRI MaxRetries                  : 6
        BRI EncapType                   : IPV6_IN_IPV6
        Fixed Link address is           : enabled
        Fixed Link address              : aaaa.aaaa.aaaa
        Fixed Link Local address is     : enabled
        Fixed Link local address        : 0xFE800000 0x0 0x0 0x2
        RefreshTime                     : 300 (sec)
        Refresh RetxInit time           : 20000 (msec)
        Refresh RetxMax time            : 50000 (msec)
        Timestamp option                : enabled
        Validity Window                 : 7
          !
Peer :  LMA1
        Max Bindings                    : 3
        AuthOption                      : disabled
        RegistrationLifeTime            : 3600 (sec)
        BRI InitDelayTime               : 1000 (msec)
        BRI MaxDelayTime                : 40000 (msec)
        BRI MaxRetries                  : 6
        BRI EncapType                   : IPV6_IN_IPV6
        Fixed Link address is           : enabled
        Fixed Link address              : aaaa.aaaa.aaaa
        Fixed Link Local address is     : enabled
        Fixed Link local address        : 0xFE800000 0x0 0x0 0x2
        RefreshTime                     : 300 (sec)
        Refresh RetxInit time           : 20000 (msec)
        Refresh RetxMax time            : 50000 (msec)
        Timestamp option                : enabled
        Validity Window                 : 7
!
Peer :  LMA2
        Max Bindings                    : 3
        AuthOption                      : disabled
        RegistrationLifeTime            : 3600 (sec)
        BRI InitDelayTime               : 1000 (msec)
        BRI MaxDelayTime                : 40000 (msec)
        BRI MaxRetries                  : 6
        BRI EncapType                   : IPV6_IN_IPV6
        Fixed Link address is           : enabled
        Fixed Link address              : aaaa.aaaa.aaaa
        Fixed Link Local address is     : enabled
        Fixed Link local address        : 0xFE800000 0x0 0x0 0x2
        RefreshTime                     : 300 (sec)
        Refresh RetxInit time           : 20000 (msec)
        Refresh RetxMax time            : 50000 (msec)
        Timestamp option                : enabled
        Validity Window                 : 7

Related Commands

Command

Description

ipv6 mobile pmipv6-mag

Configures the MAG for the PMIPV6 domain.

show ipv6 mobile pmipv6 mag stats

To display global Mobile Access Gateway (MAG) statistics, use the show ipv6 mobile pmipv6 mag stats command in privileged EXEC mode.

show ipv6 mobile pmipv6 mag mag-id stats [ domain domain-name peer peer-name ]

Syntax Description

mag-id

MAG identifier.

domain domain-name

(Optional) Specifies the Proxy Mobile IPv6 (PMIPV6) domain.

peer peer-name

(Optional) Specifies the Local Mobility Anchor (LMA).

Command Default

The show ipv6 mobile pmipv6 mag stats command displays MAG statistics.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS XE Release 3.4S

This command was introduced.

15.2(4)M

This command was modified. This command was integrated into Cisco IOS Release 15.2(4)M. The mag-id argument was added.

Usage Guidelines

The show ipv6 mobile pmipv6 mag stats domain domain-name peer peer-name command displays statistics related to the LMA.

Examples

The following is sample output from the show ipv6 mobile pmipv6 mag stats command:

Device# show ipv6 mobile pmipv6 mag mag1 stats

----------------------------------------
[M1]: Total Bindings    : 2
[M1]: PBU Sent          : 14
[M1]: PBA Rcvd          : 7
[M1]: PBRI Sent         : 0
[M1]: PBRI Rcvd         : 0
[M1]: PBRA Sent         : 0
[M1]: PBRA Rcvd         : 0
[M1]: No Of handoff     : 0

The below table describes the significant fields shown in the display. The remaining fields are self-explanatory.

Table 19 show ipv6 mobile pmipv6 mag stats Field Descriptions

Field

Description

PBU Sent

The Proxy Binding Update (PBU) that is sent from the MAG to the LMA.

PBA Rcvd

The Proxy Binding Acknowledgment (PBA) that is received by the MAG.

PBRI Sent

The Proxy Binding Revocation Indication (PBRI) message that is sent from the LMA to the MAG and vice versa.

PBRI Rcvd

The PBRI message that is received by the LMA from the MAG and vice versa.

PBRA Sent

The Proxy Binding Revocation Acknowledgment (PBRA) message that is sent from the MAG to the LMA and vice versa.

PBRA Rcvd

The PBRA message that is received by the MAG from the LMA and vice versa.

No Of handoff

The number of the handoffs between different interfaces of the MAG.

The following is sample output from the show ipv6 mobile pmipv6 mag stats domain domain-name peer peer-name command:

Router# show ipv6 mobile pmipv6 mag mag1 stats domain D1 peer LMA1
----------------------------------------
[LMA1]: PBU Sent                : 7
[LMA1]: PBA Rcvd                : 6
[LMA1]: PBRI Sent               : 0
[LMA1]: PBRI Rcvd               : 0
[LMA1]: PBRA Sent               : 0
[LMA1]: PBRA Rcvd               : 0
[LMA1]: No Of handoff   : 0

Related Commands

Command

Description

ipv6 mobile pmipv6-mag

Configures the MAG for the PMIPV6 domain.

show interfaces tunnel 0 stats

Displays the PMIPV6 tunnel statistics.

show ipv6 ospf

To display general information about Open Shortest Path First ( OSPF) routing processes, use the show ipv6 ospf command in user EXEC or privileged EXEC mode.

show ipv6 ospf [process-id] [area-id] [rate-limit]

Syntax Description

process-id

(Optional) Internal identification. It is locally assigned and can be any positive integer. The number used here is the number assigned administratively when the OSPF routing process is enabled.

area-id

(Optional) Area ID. This argument displays information about a specified area only.

rate-limit

(Optional) Rate-limited link-state advertisements (LSAs). This keyword displays LSAs that are currently being rate limited, together with the remaining time to the next generation.

Command Modes


User EXEC
Privileged EXEC

Command History

Release

Modification

12.0(24)S

This command was introduced.

12.2(15)T

This command was integrated into Cisco IOS Release 12.2(15)T.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.3(4)T

Command output is changed when authentication is enabled.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(25)SG

This command was integrated into Cisco IOS Release 12.2(25)SG.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.4(9)T

Command output was updated to display OSPF for IPv6 encryption information.

12.4(15)XF

Command output was modified to include VMI PPPoE process-level values.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

12.2(33)SRC

The rate-limit keyword was added. Command output was modified to include the configuration values for SPF and LSA throttling timers.

12.2(33)SB

This command was integrated into Cisco IOS Release 12.2(33)SB.

Cisco IOS XE Release 2.1

This command was integrated into Cisco IOS XE Release 2.1.

15.0(1)M

This command was integrated into Cisco IOS Release 12.5(1)M.

15.1(2)T

This command was modified. Support for IPv6 was added to Cisco IOS Release 15.1(2)T.

12.2(50)SY

This command was integrated into Cisco IOS Release 12.2(50)SY.

15.1(1)SG

This command was integrated into Cisco IOS Release 15.1(1)SG.

15.0(1)SY

This command was integrated into Cisco IOS Release 15.0(1)SY.

15.2(2)SNG

This command was implemented on the Cisco ASR 901 Series Aggregation Services devices.

Examples

Examples

The following is sample output from the show ipv6 ospf command:

Device# show ipv6 ospf
Routing Process "ospfv3 1" with ID 10.10.10.1
 SPF schedule delay 5 secs, Hold time between two SPFs 10 secs
 Minimum LSA interval 5 secs. Minimum LSA arrival 1 secs
 LSA group pacing timer 240 secs
 Interface flood pacing timer 33 msecs
 Retransmission pacing timer 66 msecs
 Number of external LSA 0. Checksum Sum 0x000000
 Number of areas in this device is 1. 1 normal 0 stub 0 nssa
    Area BACKBONE(0)
        Number of interfaces in this area is 1
        MD5 Authentication, SPI 1000
        SPF algorithm executed 2 times
        Number of LSA 5. Checksum Sum 0x02A005
        Number of DCbitless LSA 0
        Number of indication LSA 0
        Number of DoNotAge LSA 0
        Flood list length 0

The table below describes the significant fields shown in the display.

Table 20 show ipv6 ospf Field Descriptions

Field

Description

Routing process "ospfv3 1" with ID 10.10.10.1

Process ID and OSPF device ID.

LSA group pacing timer

Configured LSA group pacing timer (in seconds).

Interface flood pacing timer

Configured LSA flood pacing timer (in milliseconds).

Retransmission pacing timer

Configured LSA retransmission pacing timer (in milliseconds).

Number of areas

Number of areas in device, area addresses, and so on.

Examples

The following sample output shows the show ipv6 ospf command with area encryption information:

Device# show ipv6 ospf 
Routing Process "ospfv3 1" with ID 10.0.0.1 
It is an area border device 
SPF schedule delay 5 secs, Hold time between two SPFs 10 secs 
Minimum LSA interval 5 secs. Minimum LSA arrival 1 secs 
LSA group pacing timer 240 secs 
Interface flood pacing timer 33 msecs 
Retransmission pacing timer 66 msecs 
Number of external LSA 0. Checksum Sum 0x000000 
Number of areas in this device is 2. 2 normal 0 stub 0 nssa 
Reference bandwidth unit is 100 mbps 
    Area BACKBONE(0) 
        Number of interfaces in this area is 2 
        SPF algorithm executed 3 times 
        Number of LSA 31. Checksum Sum 0x107493 
        Number of DCbitless LSA 0 
        Number of indication LSA 0 
        Number of DoNotAge LSA 20 
        Flood list length 0 
    Area 1 
        Number of interfaces in this area is 2 
        NULL Encryption SHA-1 Auth, SPI 1001 
        SPF algorithm executed 7 times 
        Number of LSA 20. Checksum Sum 0x095E6A 
        Number of DCbitless LSA 0 
        Number of indication LSA 0 
        Number of DoNotAge LSA 0 
        Flood list length 0 

The table below describes the significant fields shown in the display.

Table 21 show ipv6 ospf with Area Encryption Information Field Descriptions

Field

Description

Area 1

Subsequent fields describe area 1.

NULL Encryption SHA-1 Auth, SPI 1001

Displays the encryption algorithm (in this case, null, meaning no encryption algorithm is used), the authentication algorithm (SHA-1), and the security policy index (SPI) value (1001).

The following example displays the configuration values for SPF and LSA throttling timers:

Device# show ipv6 ospf
 Routing Process "ospfv3 1" with ID 10.9.4.1
 Event-log enabled, Maximum number of events: 1000, Mode: cyclic
 It is an autonomous system boundary device
 Redistributing External Routes from,
    ospf 2
 Initial SPF schedule delay 5000 msecs
 Minimum hold time between two consecutive SPFs 10000 msecs
 Maximum wait time between two consecutive SPFs 10000 msecs
 Minimum LSA interval 5 secs
 Minimum LSA arrival 1000 msecs

The table below describes the significant fields shown in the display.

Table 22 show ipv6 ospf with SPF and LSA Throttling Timer Field Descriptions

Field

Description

Initial SPF schedule delay

Delay time of SPF calculations.

Minimum hold time between two consecutive SPFs

Minimum hold time between consecutive SPF calculations.

Maximum wait time between two consecutive SPFs 10000 msecs

Maximum hold time between consecutive SPF calculations.

Minimum LSA interval 5 secs

Minimum time interval (in seconds) between link-state advertisements.

Minimum LSA arrival 1000 msecs

Maximum arrival time (in milliseconds) of link-state advertisements.

The following example shows information about LSAs that are currently being rate limited:

Device# show ipv6 ospf rate-limit
List of LSAs that are in rate limit Queue
    LSAID: 0.0.0.0 Type: 0x2001 Adv Rtr: 10.55.55.55 Due in: 00:00:00.500
    LSAID: 0.0.0.0 Type: 0x2009 Adv Rtr: 10.55.55.55 Due in: 00:00:00.500

The table below describes the significant fields shown in the display.

Table 23 show ipv6 ospf rate-limit Field Descriptions

Field

Description

LSAID

Link-state ID of the LSA.

Type

Description of the LSA.

Adv Rtr

ID of the advertising device.

Due in:

Remaining time until the generation of the next event.


 
	 

show ipv6 ospf interface

To display Open Shortest Path First (OSPF)-related interface information, use the showipv6ospfinterface command in user EXEC or privileged mode.

show ipv6 ospf [process-id] [area-id] interface [ type number ] [brief]

Syntax Description

process-id

(Optional) Internal identification. It is locally assigned and can be any positive integer. The number used here is the number assigned administratively when the OSPF routing process is enabled.

area-id

(Optional) Displays information about a specified area only.

type number

(Optional) Interface type and number.

brief

(Optional) Displays brief overview information for OSPF interfaces, states, addresses and masks, and areas on the router.

Command Modes

User EXEC Privileged EXEC

Command History

Release

Modification

12.0(24)S

This command was introduced.

12.2(15)T

This command was integrated into Cisco IOS Release 12.2(15)T.

12.2(18)S

This command was integrated into Cisco IOS Release 12.2(18)S.

12.3(4)T

Command output is changed when authentication is enabled.

12.2(28)SB

This command was integrated into Cisco IOS Release 12.2(28)SB.

12.2(25)SG

This command was integrated into Cisco IOS Release 12.2(25)SG.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.4(9)T

Command output is changed when encryption is enabled.

12.2(33)SRB

The brief keyword was added.

12.4(15)XF

Output displays were modified so that VMI PPPoE interface-based local state values are displayed in the command output when a VMI interface is specified.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T

12.2(33)SXH

This command was integrated into Cisco IOS Release 12.2(33)SXH.

Cisco IOS XE Release 2.1

Command output was updated to display graceful restart information.

12.2(33)SRE

This command was modified. It was integrated into Cisco IOS Release 12.2(33)SRE.

15.1(1)SY

This command was was modified. It was integrated into Cisco IOS Release 15.1(1)SY.

Examples

Examples

The following is sample output from the showipv6ospfinterface command:

Router# show ipv6 ospf interface
ATM3/0 is up, line protocol is up 
  Link Local Address 2001:0DB1:205:5FFF:FED3:5808, Interface ID 13
  Area 1, Process ID 1, Instance ID 0, Router ID 172.16.3.3
  Network Type POINT_TO_POINT, Cost: 1
  Transmit Delay is 1 sec, State POINT_TO_POINT,
  Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
    Hello due in 00:00:06
  Index 1/2/2, flood queue length 0
  Next 0x0(0)/0x0(0)/0x0(0)
  Last flood scan length is 12, maximum is 12
  Last flood scan time is 0 msec, maximum is 0 msec
  Neighbor Count is 1, Adjacent neighbor count is 1 
    Adjacent with neighbor 172.16.4.4
  Suppress hello for 0 neighbor(s)
FastEthernet0/0 is up, line protocol is up 
  Link Local Address 2001:0DB1:205:5FFF:FED3:5808, Interface ID 3
  Area 1, Process ID 1, Instance ID 0, Router ID 172.16.3.3
  Network Type BROADCAST, Cost: 1
  Transmit Delay is 1 sec, State BDR, Priority 1 
  Designated Router (ID) 172.16.6.6, local address 2001:0DB1:205:5FFF:FED3:6408
  Backup Designated router (ID) 172.16.3.3, local address 2001:0DB1:205:5FFF:FED3:5808
  Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
    Hello due in 00:00:05
  Index 1/1/1, flood queue length 0
  Next 0x0(0)/0x0(0)/0x0(0)
  Last flood scan length is 12, maximum is 12
  Last flood scan time is 0 msec, maximum is 0 msec
  Neighbor Count is 1, Adjacent neighbor count is 1 
    Adjacent with neighbor 172.16.6.6  (Designated Router)
  Suppress hello for 0 neighbor(s)

The table below describes the significant fields shown in the display.

Table 24 show ipv6 ospf interface Field Descriptions

Field

Description

ATM3/0

Status of the physical link and operational status of protocol.

Link Local Address

Interface IPv6 address.

Area 1, Process ID 1, Instance ID 0, Router ID 172.16.3.3

The area ID, process ID, instance ID, and router ID of the area from which this route is learned.

Network Type POINT_TO_POINT, Cost: 1

Network type and link-state cost.

Transmit Delay

Transmit delay, interface state, and router priority.

Designated Router

Designated router ID and respective interface IP address.

Backup Designated router

Backup designated router ID and respective interface IP address.

Timer intervals configured

Configuration of timer intervals.

Hello

Number of seconds until the next hello packet is sent out this interface.

Neighbor Count

Count of network neighbors and list of adjacent neighbors.

Examples

The following is sample output of the showipv6ospfinterface command when the brief keyword is entered.

Router# show ipv6 ospf interface brief
 
Interface    PID   Area            Intf ID    Cost  State Nbrs F/C
VL0          6     0               21         65535 DOWN  0/0
Se3/0        6     0               14         64    P2P   0/0
Lo1          6     0               20         1     LOOP  0/0
Se2/0        6     6               10         62    P2P   0/0
Tu0          1000  0               19         11111 DOWN  0/0

Examples

The following is sample output from the showipv6ospfinterface command with authentication enabled on the interface:

Router# show ipv6 ospf interface
Ethernet0/0 is up, line protocol is up
  Link Local Address 2001:0DB1:A8BB:CCFF:FE00:6E00, Interface ID 2
  Area 0, Process ID 1, Instance ID 0, Router ID 10.10.10.1
  Network Type BROADCAST, Cost:10
  MD5 Authentication SPI 500, secure socket state UP (errors:0)
  Transmit Delay is 1 sec, State BDR, Priority 1
  Designated Router (ID) 10.11.11.1, local address 2001:0DB1:A8BB:CCFF:FE00:6F00
  Backup Designated router (ID) 10.10.10.1, local address
2001:0DB1:A8BB:CCFF:FE00:6E00
  Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
    Hello due in 00:00:01
  Index 1/1/1, flood queue length 0
  Next 0x0(0)/0x0(0)/0x0(0)
  Last flood scan length is 1, maximum is 1
  Last flood scan time is 0 msec, maximum is 0 msec
  Neighbor Count is 1, Adjacent neighbor count is 1
    Adjacent with neighbor 10.11.11.1  (Designated Router)
  Suppress hello for 0 neighbor(s)

Examples

The following is sample output from the showipv6ospfinterface command with null authentication configured on the interface:

Router# show ipv6 ospf interface
Ethernet0/0 is up, line protocol is up
  Link Local Address 2001:0DB1:A8BB:CCFF:FE00:6E00, Interface ID 2
  Area 0, Process ID 1, Instance ID 0, Router ID 10.10.10.1
  Network Type BROADCAST, Cost:10
  Authentication NULL
  Transmit Delay is 1 sec, State BDR, Priority 1
  Designated Router (ID) 10.11.11.1, local address 2001:0DB1:A8BB:CCFF:FE00:6F00
  Backup Designated router (ID) 10.10.10.1, local address
2001:0DB1:A8BB:CCFF:FE00:6E00
  Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
    Hello due in 00:00:03
  Index 1/1/1, flood queue length 0
  Next 0x0(0)/0x0(0)/0x0(0)
  Last flood scan length is 1, maximum is 1
  Last flood scan time is 0 msec, maximum is 0 msec
  Neighbor Count is 1, Adjacent neighbor count is 1
    Adjacent with neighbor 10.11.11.1  (Designated Router)
  Suppress hello for 0 neighbor(s)

Examples

The following is sample output from the showipv6ospfinterface command with authentication configured for the area:

Router# show ipv6 ospf interface
Ethernet0/0 is up, line protocol is up
  Link Local Address 2001:0DB1:A8BB:CCFF:FE00:6E00, Interface ID 2
  Area 0, Process ID 1, Instance ID 0, Router ID 10.10.10.1
  Network Type BROADCAST, Cost:10
  MD5 Authentication (Area) SPI 1000, secure socket state UP (errors:0)
  Transmit Delay is 1 sec, State BDR, Priority 1
  Designated Router (ID) 10.11.11.1, local address 2001:0DB1:A8BB:CCFF:FE00:6F00
  Backup Designated router (ID) 10.10.10.1, local address
FE80::A8BB:CCFF:FE00:6E00
  Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
    Hello due in 00:00:03
  Index 1/1/1, flood queue length 0
  Next 0x0(0)/0x0(0)/0x0(0)
  Last flood scan length is 1, maximum is 1
  Last flood scan time is 0 msec, maximum is 0 msec
  Neighbor Count is 1, Adjacent neighbor count is 1
    Adjacent with neighbor 10.11.11.1  (Designated Router)
  Suppress hello for 0 neighbor(s)

Examples

The following display shows sample output from the showipv6ospfinterface command when the OSPF cost dynamic is configured.

Router1# show ipv6 ospf interface serial 2/0
Serial2/0 is up, line protocol is up
   Link Local Address 2001:0DB1:A8BB:CCFF:FE00:100, Interface ID 10
   Area 1, Process ID 1, Instance ID 0, Router ID 172.1.1.1
   Network Type POINT_TO_MULTIPOINT, Cost: 64 (dynamic), Cost Hysteresis: 200
   Cost Weights: Throughput 100, Resources 20, Latency 80, L2-factor 100
   Transmit Delay is 1 sec, State POINT_TO_MULTIPOINT,
   Timer intervals configured, Hello 30, Dead 120, Wait 120, Retransmit 5
     Hello due in 00:00:19
   Index 1/2/3, flood queue length 0
   Next 0x0(0)/0x0(0)/0x0(0)
   Last flood scan length is 0, maximum is 0
   Last flood scan time is 0 msec, maximum is 0 msec
   Neighbor Count is 0, Adjacent neighbor count is 0
   Suppress hello for 0 neighbor(s)

Examples

The following display shows sample output from the showipv6ospfinterface command when the OSPF graceful restart feature is configured:

Router# show ipv6 ospf interface 
Ethernet0/0 is up, line protocol is up 
  Link Local Address FE80::A8BB:CCFF:FE00:300, Interface ID 2
  Area 0, Process ID 1, Instance ID 0, Router ID 10.3.3.3
  Network Type POINT_TO_POINT, Cost: 10
  Transmit Delay is 1 sec, State POINT_TO_POINT,
  Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
   Graceful Restart p2p timeout in 00:00:19
    Hello due in 00:00:02
  Graceful Restart helper support enabled
  Index 1/1/1, flood queue length 0
  Next 0x0(0)/0x0(0)/0x0(0)
  Last flood scan length is 1, maximum is 1
  Last flood scan time is 0 msec, maximum is 0 msec
  Neighbor Count is 1, Adjacent neighbor count is 1 
    Adjacent with neighbor 10.1.1.1
  Suppress hello for 0 neighbor(s)

Examples

The following display shows that the OSPF interface is enabled for Bidirectional Forwarding Detection (BFD):

Router# show ipv6 ospf interface 
Serial10/0 is up, line protocol is up 
  Link Local Address FE80::A8BB:CCFF:FE00:6500, Interface ID 42 
  Area 1, Process ID 1, Instance ID 0, Router ID 10.0.0.1 
  Network Type POINT_TO_POINT, Cost: 64 
  Transmit Delay is 1 sec, State POINT_TO_POINT, BFD enabled 
  Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5 
    Hello due in 00:00:07 
  Index 1/1/1, flood queue length 0 
  Next 0x0(0)/0x0(0)/0x0(0) 
  Last flood scan length is 1, maximum is 1 
  Last flood scan time is 0 msec, maximum is 0 msec 
  Neighbor Count is 1, Adjacent neighbor count is 1
    Adjacent with neighbor 10.1.0.1
  Suppress hello for 0 neighbor(s)

Related Commands

Command

Description

show ipv6 ospf graceful-restart

Displays OSPFv3 graceful restart information.


 
	 

show mcsa statistics

To display the mobile client service abstraction (MCSA) notification statistics, use the show mcsa statistics command in privileged EXEC mode.

show mcsa statistics { sint | cint }

Syntax Description

sint

Specifies the service interface notification statistics.

cint

Specifies client interface notification statistics.

Command Modes


        Privileged EXEC (#)
      

Command History

Release

Modification

Cisco IOS XE Release 3.8S

This command was introduced

Usage Guidelines

Enable MCSA by using the mcsa command before you enter the show mcsa statistics command.

Examples

The following is sample output from the show mcsa statistics sint command:

Device# show mcsa statistics sint

Session Create Req               : 1
Session Create Res               : 1
Session Update Req               : 0
Session Update Res               : 0
Session Update Ind               : 0
Session Update Rep Success       : 0
Session Update Rep Failed        : 0
Session Delete Req               : 0
Session Delete Res               : 0
Session Delete Ind               : 0
Session Delete Rep Success       : 0
Session Delete Rep Failed        : 0
   

The following is sample output from the show mcsa statistics cint command:

Device# show mcsa statistics cint

Protocol : PMIPV6
Set Interest list                : 1
Attach Indication                : 1
Attach Rep Success               : 1
Attach Rep Failed                : 0
Detach Indication                : 0
Detach Rep Success               : 0
Detach Rep Failed                : 0
Cleanup Req                      : 0
Cleanup Res                      : 0
Attach Update Req                : 0
Attach Update Res                : 0
Attach Update Ind                : 0
Attach Update Rep Success        : 0
Attach Update Rep Failed         : 0

Protocol : GTP

Set Interest list                : 1
Attach Indication                : 0
Attach Rep Success               : 0
Attach Rep Failed                : 0
Detach Indication                : 0
Detach Rep Success               : 0
Detach Rep Failed                : 0
Cleanup Req                      : 0
Cleanup Res                      : 0
Attach Update Req                : 0
Attach Update Res                : 0
Attach Update Ind                : 0
Attach Update Rep Success        : 0
Attach Update Rep Failed         : 0
   

Related Commands

Command

Description

mcsa

Enables the MCSA.

clear mcsa statistics

Clears the MCSA notifications statistics.

show mux

To display general IP multiplexing information, use the show mux command in user EXEC or privileged EXEC mode.

show { ip | ipv6 } mux

Syntax Description

ip

Displays IPv4 multiplexing information.

ipv6

Displays IPv6 multiplexing information.

Command Modes


User EXEC


Privileged EXEC

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Examples

The following example shows how to display IP multiplexing statistics:

Router# show ip mux
IPv4 Multiplexing
  Superframe UDP Port: 6682
 
Multiplexing Policies
 muxpol             Outbound DSCP:     19
                     Match DSCP values: af21 19
 muxpol2            Outbound DSCP:     af11
                     Match DSCP values: 11
 muxpol3            Outbound DSCP:     2
                      Match DSCP values: 1
 
IPv4 Multiplex Cache Statistics
  Current Entries:               3
  Maximum Number of Entries:      56818
  Cache High Water Mark:          3
  Total Stale Entries:            0
  Total Do-Not-Multiplex Entries: 0
Router#

The table below describes the significant fields shown in the display.

Table 25 show mux Field Descriptions

Field

Description

Superframe UDP Port

UDP port configured for IP multiplexing.

Multiplexing Policies

List of each configured IP multiplexing policy with the policy name, configured outbound differentiated services code point (DSCP) value, and DSCP values in packets bound for multiplexing.

Current Entries

Number of entries listed in the IP multiplexing cache.

Maximum Number of Entries

Maximum number of entries that the cache can contain.

Cache High Water Mark

Maximum number of entries that have ever been in the cache at one time. This value might not represent the current number of entries in the cache.

Total Stale Entries

An entry in the cache that is older than 30 seconds and has not been referenced.

Every 30 seconds, any unreferenced entry older than 30 seconds is marked stale. Stale entries are deleted from the cache.

If the cache is full, stale entries are overwritten first.

Total Do-Not-Multiplex Entries

Number of entries in the cache designated to not multiplex.

show mux cache

To display IP multiplexing cache statistics, use the show mux cache command in user EXEC or privileged EXEC mode.

show { ip | ipv6 } mux cache [ profile profile-name | nomux | stale ]

Syntax Description

ip

Displays IPv4 multiplexing cache statistics.

ipv6

Displays IPv6 multiplexing cache statistics.

profile profile-name

(Optional) Displays IP multiplexing cache contents by profile.

nomux

(Optional) Displays IP multiplexing cache of do-not-multiplex entries.

stale

(Optional) Displays IP multiplexing cache stale entries.

Command Modes


User EXEC


Privileged EXEC

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Examples

The following example shows how to display the IPv6 multiplexing cache statistics:

Router# show ipv6 mux cache
IPv6 Multiplex Cache Statistics
 
Current Entries:                  2
  Maximum Number of Entries:      9615
  Cache High Water Mark:          2
  Total Stale Entries:            0
  Total Do-Not-Multiplex Entries: 2
IPv6 Multiplex Cache Contents
 
Destination Address                     Port      Protocol    DSCP     Profile
------------------------------------------------------------------------------
200:200:200:200:200:0:E01:5600          0         UDP         1        r1v6
200:200:200:200:200:0:E01:5600          0         UDP         af11     No mux
Router#

The table below describes the significant fields shown in the display.

Table 26 show mux cache Field Descriptions

Field

Description

Current Entries

Number of entries listed in the IP multiplexing cache.

Maximum Number of Entries

Maximum number of entries that the cache can hold.

Cache High Water Mark

Maximum number of entries that have ever been stored in the cache. If this value varies significantly from the maximum number of cache entries, consider changing the cache size.

Total Stale Entries

An entry in the cache that is older than 30 seconds and has not been referenced.

Every 30 seconds, any unreferenced entry older than 30 seconds is marked stale. Stale entries are deleted from the cache.

If the cache is full, stale entries are overwritten first.

Total Do-Not-Multiplex Entries

Number of entries in the cache designated to not multiplex.

Destination Address

Destination IPv4 or IPv6 address for the cache entry.

Port

Port configured for the cache entry.

Protocol

Protocol configured for the cache entry.

DSCP

Differentiated services code point.

Profile Name

Name of the profile

The following example shows how to display the cache statistics for do-not-multiplex entries:

Router# show ip mux cache nomux
IPv4 Multiplex Cache
Destination Address    Port    Protocol    DSCP    Profile
----------------------------------------------------------
192.0.2.1                0       ICMP        0       No mux
Router#

The following example shows how to display the cache statistics for stale entries:

Router# show ip mux cache stale
IPv4 Multiplex Cache
Destination Address    Port    Protocol    DSCP    Profile
----------------------------------------------------------
192.0.2.21            1000    UDP         1       r1 (stale)
192.0.2.21            1000    UDP         af12    r1 (stale)
Router# 

The following example shows how to display the cache statistics for the IP multiplexing profile r1:

Router# show ip mux cache profile r1
 
IPv4 Multiplex Cache
 
Destination Address    Port    Protocol    DSCP    Profile
----------------------------------------------------------
192.0.2.20             0       ICMP        0       r1
192.0.2.21             1000    UDP         1       r1 (stale)
192.0.2.21             1000    UDP         af12    r1 (stale)
192.0.2.20             1001    UDP         af21    r1
Router#

show mux interface

To display configured IP multiplexing statistics for an interface, use the show mux interface command in user EXEC or privileged EXEC mode.

show { ip | ipv6 } mux interface [ type ]

Syntax Description

ip

Displays IPv4 multiplexing statistics.

ipv6

Displays IPv6 multiplexing statistics.

type

(Optional) Interface type. These interface types are valid:

  • Ethernet: IEEE 802.3
  • Tunnel: Tunnel interface
  • Virtual-Template: Virtual template interface
  • VMI: Virtual multipoint interface

Command Modes


User EXEC


Privileged EXEC

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

If you do not specify an interface type, the show mux interface command displays statistics for all interfaces with IP multiplexing configured.

Examples

The following example shows how to display IP multiplexing statistics for Ethernet 0/1:

Router# show ip mux interface Ethernet0/1
IP multiplexing statistics for Ethernet0/1:
  Transmit:
   IPv4 superframes transmitted: 20430
   IPv4 packets multiplexed:    30555
   Average TX mux ratio:        1.49:1
  Receive:
   IPv4 superframes received:   22009
   IPv4 packets demuxed:        32634
   IPv4 format errors:          0
   Average RX mux ratio:        1.48:1
Router#

The table below describes the significant fields shown in the display.

Table 27 show mux interface Field Descriptions

Field

Description

IPv4 super frames transmitted

Number of IPv4 superframes transmitted from the interface.

IPv4 packets multiplexed

Number of packets that have been processed and put into superframes.

Average TX mux ratio

Ratio of the total number of packets put into superframes divided by the number of superframes transmitted.

IPv4 superframes received

Number of IPv4 superframes received over the interface.

IPv4 packets demuxed

Number of IPv4 packets demultiplexed from received superframes.

IPv4 format errors

Number of packets with format errors after they have been demultiplexed.

Average RX mux ratio

Ratio of the total number of successfully demultiplexed packets divided by the number of superframes received.

show mux profile

To display multiplexing statistics and the configuration for a specific IP multiplexing profile, use the show mux profile command in user EXEC or privileged EXEC mode.

show { ip | ipv6 } mux profile [ profile-name ]

Syntax Description

ip

Displays IPv4 multiplexing cache statistics.

ipv6

Displays IPv6 multiplexing cache statistics.

profile-name

(Optional) Name of the IP multiplexing profile.

Command Modes


User EXEC


Privileged EXEC

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

If you do not specify an IP multiplexing profile name, this command displays the statistics for all configured profiles.

Examples

The following example shows how to display the cache statistics for the IPv6 profile r1v6:

Router# show ipv6 mux profile rlv6
Profile r1v6
  Shutdown:                    No
  Destination:                 2000:0:1:2:A8BB:CCFF:FE01:5610
  Source:                      2000:0:1:1:A8BB:CCFF:FE01:5510  (Ethernet0/1)
  Access-list:                 muxv6acl
  TTL:                         64
  Max mux length:              1452
  MTU:                         1500
  Hold time(ms):               20
  Single packet superframes:   Enabled
  Inbound (demux) Statistics
    Superframes received:         0
    Packets demultiplexed:        0
    Avg. Inbound Multiplex ratio: N/A
  Outbound (mux) Statistics
  Default Policy
    Packets: 0/0  Full Superframes: 0  Partial Superframes: 0
    Avg. Outbound Multiplex ratio: N/A     Mux length exceeded: 0
  Policy dscp4 
    Packets: 3963/3616  Full Superframes: 0  Partial Superframes: 984
    Avg. Outbound Multiplex ratio: 3.67:1     Mux length exceeded: 0
Router#

The table below describes the significant fields shown in the display.

Table 28 show ipv6 mux profile Field Descriptions

Field

Description

Profile

Name of the configured IP multiplexing profile.

Shutdown

Current state of the profile.

  • No—the profile is enabled.
  • Yes—the profile is disabled.

Destination

Destination IPv4 or IPv6 address configured for the profile.

Source

Source IPv4 or IPv6 address configured for the profile.

Access-list

Name of the access list used by the IP multiplexing profile.

TTL

Configured time-to-live (TTL) value for outbound superframes. Number of hops before the superframe expires.

Max mux length

Maximum packet size that the multiplex profile can hold for multiplexing.

MTU

Maximum transmission unit (MTU) size for an outbound superframe.

Holdtime (ms)

Length of time IP multiplexing waits after not having not received a packet before sending the superframe.

Single packet superframes

  • Enabled—Superframes with only one packet are sent.
  • Disabled—Single packets are not sent as superframes.

Inbound (demux) Statistics

Superframes received

Number of superframes the IP multiplexing policy has received.

Packets demultiplexed

Number of packets that have been demultiplexed from superframes.

Avg. Inbound Multiplex ratio

Number of inbound packets demultiplexed divided by the number of superframes received.

Outbound (mux) Statistics (listed by policy name)

Packets

The first value is the number of outbound packets processed by the policy. The second value is the number of packets that were transmitted inside superframes.

Full Superframes

Number of full superframes that the policy has sent.

Partial Superframes

Number of partial superframes the policy has sent.

Avg. Outbound Multiplex ratio

Ratio of the number of packets processed by the policy divided by the number of full superframes and partial superframes sent by the policy.

Mux length exceeded

Number of packets processed by the policy that exceed the configured maximum packet length.

show vmi neighbors

To display information about neighbor connections to the Virtual Multipoint Interface (VMI), use the show vmi neighbors command in user and in privileged EXEC mode.

show vmi neighbors [detail] [vmi-interface]

Syntax Description

detail

(Optional) Displays details about the VMI neighbors.

vmi-interface

(Optional) Number of the VMI interface

Command Default

If no arguments are specified, information about all neighbors for all VMI interfaces is displayed.

Command Modes


User EXEC
Privileged EXEC

Command History

Release

Modification

12.4(15)XF

This command was introduced.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T.

15.1(3)T

This command was modified. When the detail keyword is used, the output is enhanced with additional PPPoE flow control statistics.

Usage Guidelines

If no arguments are specified, information about all neighbors for all VMI interfaces is displayed.

The show vmi neighborscommand provides a list of devices that have been dynamically discovered by the connected radio devices in a router-to-radio network, and for which connectivity has been achieved through PPPoE and the radio network.

Examples

The following is sample output from the show vmi neighbors command used to display dynamically created neighbors on a VMI interface.

Router# show vmi neighbors vmi1
1 vmi1 Neighbors
           IPV6       IPV4                      Transmit    Receive
Interface  Address    Address       Uptime      Packets     Packets
vmi1       ::         10.3.3.2      00:02:11    0000000008  0000000073

Below table describes the significant fields shown in the show vmi neighbors command display.

Table 29 show vmi neighbors Field Descriptions

Field

Description

Interface

The interface number.

IPv6 Address

IPv6 address of the neighbor.

IPv4 Address

IPv4 address of the neighbor.

Uptime

How long the interface has been up. Time shown in hh:mm:ss format.

Transmit Packets

Number of packets transmitted from the interface during the monitored up time.

Received Packets

Number of packets received on the interface during the monitored up time.

Examples

The following example shows the details about the known VMI neighbors.

Router# show vmi neighbors detail
 
1 vmi1 Neighbors
vmi1   IPV6 Address=::
       IPV4 Address=10.3.3.2, Uptime=00:02:16
       Output pkts=8, Input pkts=75
       No Session Metrics have been received for this neighbor.
       Transport PPPoE, Session ID=79
       INTERFACE STATS:
          VMI Interface=vmi1,
             Input qcount=0, drops=0, Output qcount=0, drops=0
          V-Access intf=Virtual-Access3,
             Input qcount=0, drops=0, Output qcount=0, drops=0
          Physical intf=FastEthernet0/0,
             Input qcount=0, drops=0, Output qcount=0, drops=0
PPPoE Flow Control Stats
	Local Credits: 65524   Peer Credits: 65524   Scalar Value 64 bytes
	Credit Grant Threshold: 28000    Max Credits per grant: 65534 
	Credit Starved Packets: 0
	PADG Seq Num: 24     PADG Timer index: 0 
	PADG last rcvd Seq Num: 24 
	PADG last nonzero Seq Num: 0 
	PADG last nonzero rcvd amount: 0
	PADG Timers:    [0]-1000    [1]-2000    [2]-3000    [3]-4000 
	PADG xmit: 24  rcvd: 24
	PADC xmit: 24  rcvd: 24
	PADQ xmit: 0  rcvd: 0 

The below table describes the significant fields shown in the show vmi neighbors detailcommand display.

Table 30 show vmi neighbors detail Field Descriptions

Field

Description

Interface

The interface number.

IPv6 Address

IPv6 address of the neighbor.

IPv4 Address

IPv4 address of the neighbor.

Uptime

How long the interface has been up. Time shown in hh:mm:ss format.

Output pkts

Number of outgoing packets during the recorded up time.

Input pkts

Number of incoming packets during the recorded up time.

Metric Data

The Metric data statistics

Total rcvd: The total number of packets received on the interface Avg arrival rate: The average arrival rate for each packet in milliseconds. CURRENT: The current values for the following statistics: metric data rate (MDR), credit data rate (CDR), latency (Lat), resource (Res), RLQ (RLQ), and the load MDR: The maximum, minimum, and average metric data rate CDR: The maximum, minimum, and average credit data rate Latency: The maximum, minimum, and average latency Resource: The maximum, minimum, and average resource RQL: The maximum, minimum, and average RQL Load: The maximum, minimum, and average load

Transport

The routing protocol, in this case-PPPoE.

Session ID

The identifier of the VMI session.

INTERFACE STATS

A series of statistics collected on the interface and shows for each of the VMI interface, virtual access interface, and the physical interface. For each interface, statistics are displayed indicating the number of packets in the input and output queues and the number of packets dropped from each queue.

PPPoE Flow Control Stats

The statistics collected for PPPoE credit flow.

Local Credits : The number of credits belonging to this node.Peer Credits: The number of credits belonging to the peer. Scalar Value: The credit grant in bytes specified by the radioCredit Grant Threshold: The number of credits below which the peer needs to dip before this node sends an inband or out-of-band grant. Credit Starved Packets: The number of packets dropped or queued due to insufficient credits from the peer.Max Credits per grant: 65534PADG Seq Num: The sequence number for the PPPoE packet discovery grantPADG Timer index: The timer index for the PPPoE packet discovery grantPADG last rcvd Seq Num: The sequence number for the previously received PPPoE packet discovery grantPADG last nonzero Seq Num: The sequence number for the last non-zero PPPoE packet discovery grantPADG last nonzero rcvd amount: The received amount in the last non-zero PPPoE packet discovery grantPADG Timers: The PPPoE packet discovery grant timersPADG xmit: numeric rcvd: The number of PPPoE packet discovery grants transmitted and receivedPADC xmit: 133 rcvd: 133:The number of PPPoE packet discovery grant confirmations transmitted and receivedPADQ xmit: 0 rcvd: The number of PPPoE packet discovery quality grants transmitted and received.

Related Commands

Command

Description

debug vmi

Displays debugging output for VMIs.

interface vmi

Creates a VMI that can be configured and applied dynamically.

shutdown (IP multiplexing)

To deactivate an IP multiplexing profile, use the shutdown command in IPv4 multiplexing profile configuration or IPv6 multiplexing profile configuration mode. To activate an IP multiplexing profile, use the no form of this command.

shutdown

no shutdown

Syntax Description

This command has no arguments or keywords.

Command Default

The IP multiplexing profile is activated.

Command Modes


IP multiplexing profile configuration (config-ipmux-profile)


IPv6 multiplexing profile configuration (config-ipmux-profile-v6)

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

You must enter the no shutdown command to activate an IP multiplexing profile so that the IP multiplexing packet handler processes packets for IP multiplexing. A disabled multiplexing profile cannot send superframes but will accept incoming superframes that match its configured source and destination addresses.

If you want to change the access control list (ACL) associated with the profile, or edit the ACL associated with the profile, you must enter the shutdown command. After you have changed either the access list or the ACL associated with the profile, you then enter the no shutdown command to clear the IP multiplexing cache and use the new information.

A source and destination address must be configured for a multiplexing profile before it can be activated.

Examples

The following example shows how to deactivate the IP multiplexing profile routeRTP-SJ:

Router# configure terminal
Router(config)# ipv6 mux profile routeRTP-SJ
Router(config-ipmux-profile-v6)# shutdown
Router(config-ipmux-profile-v6)# exit
Router(config)#

Related Commands

Command

Description

ip mux profile

Creates an IPv4 multiplexing profile with a specified name.

ipv6 mux profile

Creates an IPv6 multiplexing profile with a specified name.

show mux profile

Displays multiplexing statistics and the configuration for a specific IP multiplexing profile.

singlepacket

To enable the IP multiplexing packet handler to send single-packet superframes, use the singlepacket command in IPv4 multiplexing profile configuration or IPv6 multiplexing profile configuration mode. To prevent the creation of single-packet superframes, use the no form of this command.

singlepacket

no singlepacket

Syntax Description

This command has no arguments or keywords.

Command Default

Single-packet superframes are not sent.

Command Modes


IP multiplexing profile configuration (config-ipmux-profile)


IPv6 multiplexing profile configuration (config-ipmux-profile-v6)

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

By default, the IP multiplexing packet handler creates single-packet superframes.

Single-packet multiplexing applies to all hold queues for a given IP multiplexing profile.

Interesting data packets are always transmitted inside a superframe even if there is only one packet to transmit when the hold timer expires.

Examples

The following example shows how to configure single-packet superframes for IP multiplexing profile routeRTP-SJ :

Router# configure terminal
Router(config)# ipv6 mux profile routeRTP-SJ
Router(config-ipmux-profile-v6)# singlepacket
Router(config-ipmux-profile-v6)# exit
Router(config)#

Related Commands

Command

Description

ip mux profile

Creates an IPv4 multiplexing profile with a specified name.

ipv6 mux profile

Creates an IPv6 multiplexing profile with a specified name.

show mux profile

Displays multiplexing statistics and the configuration for a specific IP multiplexing profile.

snmp-server enable traps ipmobile

To enable Simple Network Management Protocol (SNMP) security notifications for Mobile IP, use the snmp-server enable traps ipmobilecommandin global configuration mode. To disable SNMP notifications for Mobile IP, use the noform of this command.

snmp-server enable traps ipmobile

no snmp-server enable traps ipmobile

Syntax Description

This command has no arguments or keywords.

Command Default

SNMP notifications are disabled by default.

Command Modes


Global configuration

Command History

Release

Modification

12.2(2)T

This command was introduced.

Usage Guidelines

SNMP Mobile IP notifications can be sent as traps or inform requests. This command enables both traps and inform requests. This command enables Mobile IP Authentication Failure notifications. This notification is defined in RFC2006-MIB.my as the mipAuthFailure notification type {mipMIBNotifications 1}. This notification, when enabled, is triggered when there is an authentication failure for the Mobile IP entity during validation of the mobile registration request or reply.

For a complete description of this notification and additional MIB functions, see the RFC2006-MIB.my file, available on Cisco.com at http://www.cisco.com/public/mibs/v2/.

The snmp-server enable traps ipmobilecommand is used in conjunction with the snmp-server hostcommand. Use the snmp-server host global configuration command to specify which host or hosts receive SNMP notifications. To send SNMP notifications, you must configure at least one snmp-server hostcommand.

Examples

The following example enables the router to send Mobile IP informs to the host at the address myhost.cisco.com using the community string defined as public:

snmp-server enable traps ipmobile
snmp-server host myhost.cisco.com informs version 2c public

Related Commands

Command

Description

snmp-server host

Specifies the recipient of an SNMP notification operation.

snmp-server trap-source

Specifies the interface from which an SNMP trap should originate.

source (IP multiplexing)

To specify the IPv4 or IPv6 source address for the local endpoint of an IP multiplexing path, use the source command in IPv4 multiplexing profile configuration or IPv6 multiplexing profile configuration mode. To clear the source address, use the no form of the command.

source { ip-addr | ipv6-addr | interface type }

no source

Syntax Description

ip-addr

IPv4 source address for the local endpoint of the IP multiplexing path.

ipv6-addr

IPv6 source address for the local endpoint of the IP multiplexing path.

interface type

Physical interface for the source local endpoint of the IP multiplexing path.

Command Default

Source addresses are not specified.

Command Modes


IP multiplexing profile configuration (config-ipmux-profile)


IPv6 multiplexing profile configuration (config-ipmux-profile-v6)

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

You must configure a source address for the profile in order to use it. If you attempt to issue a no shutdown command when no source address is configured, you are prompted to configure a source address. If a profile is active, you must issue a shutdown command before changing the source address.

After you specify the source address, if you enter the source command again, the new address overwrites the previously entered address.

Before a superframe can be demultiplexed, an incoming superframe must match its source and destination addresses to the destination and source addresses, respectively, in the multiplexing profile. If either address does not match, the superframe is ignored.

Examples

The following example shows how to configure an IPv6 address as the source address for superframe packets:

Router# configure terminal
Router(config)# ipv6 mux profile routeRTP-SJ
Router(config-ipmux-profile-v6)# source FE80::A8BB:CCFF:FE01:5700
Router(config-ipmux-profile-v6)# exit
Router(config)#

Related Commands

Command

Description

ip mux profile

Creates an IPv4 multiplexing profile with a specified name.

ipv6 mux profile

Creates an IPv6 multiplexing profile with a specified name.

show mux profile

Displays multiplexing statistics and the configuration for a specific IP multiplexing profile.

template tunnel (mobile networks)

To apply a tunnel template to tunnels brought up at the home agent, use the template tunnelcommand in mobile networks configuration mode. To remove the tunnel template, use the no form of this command.

template tunnel interface-number

no template tunnel interface-number

Syntax Description

interface-number

Tunnel interface number.

Command Default

No default behavior or values

Command Modes


Mobile networks configuration

Command History

Release

Modification

12.2(15)T

This command was introduced.

Usage Guidelines

This command allows the configuration of multicast on statically created tunnels to be applied to dynamic tunnels brought up on the home agent.

Examples

The following example shows the template tunnel applied at the home agent:

! Tunnel template to be applied to mobile networks
interface tunnel 100 
 ip pim sparse-mode 
!
! Select tunnel template to apply during registraton
ip mobile mobile-networks 10.1.0.1 
 template tunnel 100 

Related Commands

Command

Description

template tunnel (mobile router)

Applies a tunnel template to tunnels brought up at the mobile router.

template tunnel (mobile router)

To apply a tunnel template to tunnels brought up at the mobile router, use the template tunnelcommand in mobile router configuration mode. To remove the tunnel template, use the no form of this command.

template tunnel interface-number

no template tunnel interface-number

Syntax Description

interface-number

Tunnel interface number.

Command Default

No default behavior or values

Command Modes


Mobile router configuration

Command History

Release

Modification

12.2(15)T

This command was introduced.

Usage Guidelines

This command allows the configuration of multicast on statically created tunnels to be applied to dynamic tunnels brought up on the mobile router.

Examples

The following example shows the template tunnel applied at the mobile router:

! Tunnel template to be applied to mobile networks
interface tunnel100 
 ip pim sparse-mode 
!
! Select tunnel template to apply during registration
ip mobile router 
 template tunnel100 

Related Commands

Command

Description

template tunnel (mobile networks)

Applies a tunnel template to tunnels brought up at the home agent.

ttl (IP multiplexing)

To insert into the superframe header the time-to-live (TTL) value for outbound superframes, use the ttl command in IPv4 multiplexing profile configuration or IPv6 multiplexing profile configuration mode. To return to the default setting, use the no form of this command.

ttl hops

no ttl

Syntax Description

hops

Number of hops equivalent to the TTL value inserted into the IP header of the outbound superframe. The range is 1 to 255.

Command Default

The TTL is 64 hops.

Command Modes


IP multiplexing profile configuration (config-ipmux-profile)


IPv6 multiplexing profile configuration (config-ipmux-profile-v6)

Command History

Release

Modification

15.2(2)GC

This command was introduced.

15.2(4)M

This command was integrated into Cisco IOS Release 15.2(4)M.

Usage Guidelines

If you do not specify a TTL, the IP multiplexing packet handler uses the default value of 64 hops.

After you specify the TTL value, if you enter the ttl command again, the new TTL value overwrites the previously entered size.

Examples

The following example shows how to configure the TTL size for an IP multiplexing profile to 255 hops:

Router# configure terminal
Router(config)# ipv6 mux profile routeRTP-SJ
Router(config-ipmux-profile-v6)# ttl 255
Router(config-ipmux-profile-v6)# exit
Router(config)#

Related Commands

Command

Description

ip mux profile

Creates an IPv4 multiplexing profile with a specified name.

ipv6 mux profile

Creates an IPv6 multiplexing profile with a specified name.

show mux profile

Displays multiplexing statistics and the configuration for a specific IP multiplexing profile.

tunnel mode gre

To set the global encapsulation mode on all roaming interfaces of a mobile router to generic routing encapsulation (GRE), use the tunnel mode grecommand inmobile router configuration mode. To restore the global default encapsulation mode, use the no form of this command.

tunnel mode gre

no tunnel mode gre

Syntax Description

This command has no arguments or keywords.

Command Default

The default encapsulation mode for Mobile IP is IP-in-IP encapsulation.

Command Modes


Mobile router configuration

Command History

Release

Modification

12.3(7)T

This command was introduced.

Usage Guidelines

If the tunnel mode gre command is configured, the mobile router will try to register with the foreign agent (FA) with the G bit set if the FA advertises GRE. If the registration request is successful, packets will be routed using GRE.

If the tunnel mode gre command is enabled and collocated care-of address (CCoA) is configured, the mobile router will try to register with the home agent (HA) with the G bit set. If the registration request is successful, packets will be routed using GRE.

If the mobile router receives a denied registration reply with error code 72 (foreign agent required encapsulation unavailable) or error code 139 (home agent unsupported encapsulation), the mobile router will send another registration request with the G bit unset and IP-in-IP encapsulation will be used.

The no tunnel mode grecommand instructs the mobile router to revert to the default and register with IP-in-IP encapsulation.


Note


If an encapsulation type is configured on an interface using the ip mobile router-service tunnel mode command, that encapsulation type overrides the global encapsulation type configured with the tunnel mode gre command on that interface only. If there is no interface-level configuration, the interface inherits the global configuration.


Once GRE encapsulation is enabled, GRE keepalives can be configured using the keepalive command. GRE keepalives check for a failure in the end-to-end tunnel at a configurable interval. If the connection to the HA is lost, reregistration will be attempted.

Examples

The following example globally configures GRE encapsulation on a mobile router and enables GRE keepalive messages:

router mobile
!
ip mobile secure home-agent 10.40.40.1 spi 101 key hex 12345678123456781234567812345678      algorithm md5 mode prefix-suffix
ip mobile router
 address 10.80.80.1 255.255.255.0
 home-agent 10.40.40.1
 mobile-network Ethernet1/3
 mobile-network FastEthernet0/0
 template Tunnel 121
 tunnel mode gre
!
interface tunnel 121
 keepalive 5 3

Related Commands

Command

Description

ip mobile router-service tunnel mode gre

Sets the encapsulation mode to GRE for a mobile router interface.

keepalive

Enables keepalive packets and specifies the number of times that the Cisco IOS software tries to send keepalive packets without a response before bringing down the interface or before bringing the tunnel protocol down for a specific interface.

tunnel acl

To specify an access control list (ACL) to be applied on the Proxy mobile IPv6 (PMIPv6) tunnel in a Local Mobility Anchor (LMA), use the tunnel acl command in LMA configuration mode. To remove the ACL specification, use the no form of this command.

tunnel acl

no tunnel acl

Syntax Description

acl-name

Name of the extended ACL.

Command Default

No ACL is applied on the PMIPv6 tunnel.

Command Modes

LMA configuration (config-ipv6-pmipv6-lma)

Command History

Release Modification
Cisco IOS XE Release 3.12S

This command was introduced.

Usage Guidelines

Examples

The following example shows how to provide the IPv6 service to the mobile node (MN):

Device(config)# ip access-list extended acl1 
Device(config-ext-nacl)# deny ip host 20.20.2.2 any
Device(config-ext-nacl)# permit ip any any
Device(config-ext-nacl)# exit
Device(config)# ipv6 mobile pmipv6-lma lma1 domain d1
Device(config-ipv6-pmipv6-lma)# tunnel acl acl1

Related Commands

Command

Description

ip nat

Designates that traffic originating from or destined for the interface is subject to NAT.

tunnel mtu

To specify a maximum transmission unit (MTU) to be applied on the Proxy mobile IPv6 (PMIPv6) tunnel in a Local Mobility Anchor (LMA), use the tunnel mtu command in LMA configuration mode. To remove MTU specification, use the no form of this command.

tunnel mtu value

no tunnel mtu

Syntax Description

value

Value of the MTU.

Command Default

The default MTU value will be applied on the PMIPv6 tunnel.

Command Modes


PMIPV6 domain mobile node configuration (config-ipv6-pmipv6-domain-mn)

Command History

Release

Modification

Cisco IOS XE Release 3.10S

This command was introduced.

Examples

The following example shows how to provide the IPv6 service to the mobile node (MN):

Device(config)# ipv6 mobile pmipv6-lma lma1 domain d1
Device(config-ipv6-pmipv6-lma)# tunnel mtu 1360

Related Commands

Command

Description

ip nat

Designates that traffic originating from or destined for the interface is subject to NAT.

tunnel nat

To designate that traffic originating from or destined to the Proxy Mobile IPv6 (PMIPv6) tunnel is subject to Network Address Translation (NAT), use the tunnel nat command in MAG configuration mode. To prevent the PMIPv6 tunnel from being able to translate, use the no form of this command.

tunnel nat { inside | outside }

no tunnel nat { inside | outside }

Syntax Description

inside

Indicates that the interface is connected to the inside network which is subject to NAT translation.

outside

Indicates that the interface is connected to the outside network.

Command Default

The traffic originating from or destined to the PMIPv6 tunnel is not subject to NAT.

Command Modes


MAG configuration (config-ipv6-pmipv6-mag)

Command History

Release

Modification

15.4(1)T

This command was introduced.

Examples

The following example shows how to specify NAT for a PMIPv6 tunnel in MAG:

Device(config)# ipv6 mobile pmipv6-mag mag1 domain d1
Device(config-ipv6-pmipv6-mag)# tunnel nat outside

Related Commands

Command

Description

ip nat

Designates that traffic originating from or destined for the interface is subject to NAT.

vrfid (proxy mobile IPv6)

To specify a Virtual Private Network (VPN) Route Forwarding (VRF) for a local mobility access (LMA) peer that is configured under a mobile access gateway (MAG), use the vrfid command in MAG-LMA configuration mode. To disassociate a VRF from an LMA peer that is configured under a MAG, use the no form of this command.

vrfid

no vrfid

Syntax Description

This command has no arguments or keywords.

Command Default

No VRF is specified for an LMA peer that is configured under a MAG.

Command Modes

MAG-LMA configuration mode (config-ipv6-pmipv6mag-lma)
      

Command History

Release

Modification

Cisco IOS XE Release 3.8S

The command was introduced.

Usage Guidelines

This command is not supported in standalone MAG configuration. Use this command only when a MAG is configured to coexist with the Intelligent Services Gateway (ISG). Configure a VRF routing table instance using vrf definition command prior to using the vrfid command.

Examples

The following example shows how to specify a VRF for an LMA peer that is configured under a MAG:

Device# enable
Device# configuration terminal
Device(config)# vrf definition vrf1
Device(config-vrf)# rd 100:20  
Device(config-vrf)# exit
Device(config)# ipv6 mobile pmipv6-mag mag1 domain dn1
Device(config-ipv6-pmipv6-mag)# lma lma1
Device(config-ipv6-pmipv6mag-lma) vrfid vrf1 
Device(config-ipv6-pmipv6mag-lma) end 

Related Commands

Command

Description

vrf definition

Configures a VRF table instance.