Table Of Contents
ip mobile mobile-networks
ip mobile prefix-length
ip mobile proxy-host
ip mobile radius disconnect
ip mobile realm
ip mobile registration-lifetime
ip mobile router
ip mobile router-service
ip mobile router-service collocated
ip mobile router-service collocated registration nat traversal
ip mobile router-service collocated registration retry
ip mobile router-service description
ip mobile router-service link-type
ip mobile router-service roam
ip mobile router-service tunnel mode
ip mobile secure aaa-download
ip mobile secure foreign-agent
ip mobile secure home-agent
ip mobile secure host
ip mobile secure mn-aaa
ip mobile secure proxy-host
ip mobile secure visitor
ip mobile tunnel
ip mobile virtual-network
ip mobile vpn-realm
mobile-network
mode bypass
multi-path (mobile networks)
multi-path (mobile router)
ip mobile mobile-networks
To associate one or more networks with a mobile router configured as a mobile host and enter mobile networks configuration mode, use the ip mobile mobile-networks command in global configuration mode. To disassociate the networks from the mobile router, use the no form of this command.
ip mobile mobile-networks lower [upper]
no ip mobile mobile-networks lower [upper]
Syntax Description
lower [upper]
|
Range of mobile host or mobile node group IP addresses. The upper end of the range is optional but can only be used for dynamic registration of mobile networks. Static mobile network configurations are not permitted for a range of hosts.
|
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)T
|
This command was introduced.
|
12.2(13)T
|
The upper argument was added to allow a range of mobile host or mobile node group addresses.
|
Usage Guidelines
The home agent supports mobile routers configured with the mobile networks that are roaming with the mobile routers.
The lower [upper] arguments associate the mobile networks with the IP address of the mobile router, which was configured using the ip mobile host command. You can use the upper range only with dynamic mobile network registration. Static mobile network configurations are not permitted for a range of hosts.
You can configure the home agent to dynamically learn of the mobile networks during registration as shown in the following example:
ip mobile host 10.0.0.1 10.0.0.10 virtual-networks 10.0.0.0 255.0.0.0
ip mobile mobile-networks 10.0.0.1 10.0.0.10
You can configure the home agent to learn of the mobile networks through static configuration as shown in the following example:
ip mobile host 10.0.0.1 virtual-networks 10.0.0.0 255.0.0.0
ip mobile host 10.0.0.2 virtual-networks 10.0.0.0 255.0.0.0
ip mobile mobile-networks 10.0.0.1
network 172.16.1.0 255.255.255.0
ip mobile mobile-networks 10.0.0.2
network 172.16.2.0 255.255.255.0
You cannot configure the range as shown in the following static configuration:
!static configuration not permitted for range of hosts
ip mobile mobile-networks 10.0.0.1 10.0.0.10
The mobile router configuration is allowed only for one mobile router or an entire range of mobile routers in the mobile host group, exclusively. You cannot configure a partial range of mobile routers as shown in the following example:
ip mobile host 10.0.0.1 10.0.0.10 virtual-network 10.0.0.0 255.0.0.0
!Partial range shown below is prohibited
ip mobile mobile-networks 10.0.0.1 10.0.0.3
You cannot combine full ranges and partial ranges of IP addresses in a configuration as shown in the following example:
ip mobile host 10.0.0.1 10.0.0.10 virtual-network 10.0.0.0 255.0.0.0
ip mobile mobile-networks 10.0.0.1 10.0.0.10
ip mobile mobile-networks 10.0.0.2
network 172.16.2.0 255.255.255.0
Examples
The following example configures the mobile host, which is a mobile router at 10.1.1.10, and associates it with the mobile networks that it is supporting:
ip mobile host 10.1.1.10 virtual-network 10.0.0.0 255.0.0.0
ip mobile mobile-networks 10.1.1.10
network 172.6.2.0 255.255.255.0
ip mobile secure host 10.1.1.10 spi 100 key hex 12345678123456781234567812345678
The following example shows the mobile router configured for both static and dynamic mobile networks:
ip mobile host 10.1.1.10 virtual-network 10.0.0.0 255.0.0.0
ip mobile mobile-networks 10.1.1.10
network 172.16.1.0 255.255.255.0
Related Commands
Command
|
Description
|
ip mobile host
|
Associates a mobile router with mobile networks.
|
register (mobile router)
|
Dynamically registers the mobile networks with the home agent.
|
show ip mobile mobile-networks
|
Displays a list of mobile networks associated with the mobile router.
|
ip mobile prefix-length
To append the prefix-length extension to the advertisement, use the ip mobile prefix-length command in interface configuration mode. To restore the default, use the no form of this command.
ip mobile prefix-length
no ip mobile prefix-length
Syntax Description
This command has no arguments or keywords.
Defaults
The prefix-length extension is not appended.
Command Modes
Interface and Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.3(11)T
|
Global configuration mode was added.
|
Usage Guidelines
The prefix-length extension is used for movement detection. When a mobile node registered with one foreign agent receives an agent advertisement from another foreign agent, the mobile node uses the prefix-length extension to determine whether the advertisements arrived on the same network. The mobile node needs to register with the second foreign agent if it is on a different network. If the second foreign agent is on the same network, reregistration is not necessary.
Examples
The following example appends the prefix-length extension to agent advertisements sent by a foreign agent:
Router(config-if)# ip mobile prefix-length
Related Commands
Command
|
Description
|
show ip mobile interface
|
Displays advertisement information for interfaces that are providing foreign agent service or are home links for mobile nodes.
|
ip mobile proxy-host
To locally configure the proxy Mobile IP attributes, use the ip mobile proxy-host command in global configuration mode. To remove the configuration, use the no form of this command.
ip mobile proxy-host nai username@realm [flags rrq-flags] [home-agent ip-address] [home-addr
home-address] [lifetime seconds] [local-timezone]
no ip mobile proxy-host nai username@realm [flags rrq-flags] [home-agent ip-address]
[home-addr home-address] [lifetime seconds] [local-timezone]
Syntax Description
nai username@realm
|
Network access identifier.
|
flags rrq-flags
|
(Optional) Registration request flags.
|
home-agent ip-address
|
(Optional) IP address of the home agent.
|
home-addr home-address
|
(Optional) Home IP address of the mobile node.
|
lifetime seconds
|
(Optional) Global registration lifetime for a mobile node. Note that this can be overridden by the individual mobile node configuration. Values are from 3 to 65535 (infinity). Default is 36000 seconds (10 hours). Registrations requesting a lifetime greater than this value will still be accepted, but will use this lifetime value.
|
local-timezone
|
(Optional) Adjusts the UTC time based on the local time zone configured and uses the adjusted time for proxy mobile IP registration.
|
Defaults
No security association is specified.
Command Modes
Global configuration
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 Packet Data Serving Node (PDSN) platforms.
|
Usage Guidelines
This command is only available on PDSN platforms running specific PDSN code images; consult Feature Navigator for your Cisco IOS software release.
All proxy Mobile IP attributes can be retrieved from the AAA server. You can use this command to configure the attributes locally.
If only a realm is specified, the home address cannot be specified.
Examples
The following example configures the Mobile IP proxy host with an IP address of 10.3.3.1 and a lifetime value of 6000 seconds:
Router(config)# ip mobile proxy-host nai moiproxy1@cisco.com flags 40 home-agent 10.3.3.1
lifetime 6000
Related Commands
Command
|
Description
|
ip mobile host
|
Configures the mobile host or mobile node group.
|
ntp server
|
Allows the system clock to be synchronized by a time server.
|
ip mobile secure
|
Configures the mobility security associations for mobile host, mobile visitor, foreign agent, home agent, or proxy mobile host.
|
show ip mobile proxy
|
Displays information about the proxy host configuration.
|
ip mobile radius disconnect
To enable the home agent to process Radius Disconnect messages, use the ip mobile radius disconnect command in global configuration mode. To disable the processing of Radius Disconnect messages on the home agent, use the no form of this command.
ip mobile radius disconnect
no ip mobile radius disconnect
Syntax Description
This command has no arguments or keywords.
Command Default
Radius Disconnect messages are not processed by the home agent.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.3(7)XJ
|
This command was introduced.
|
12.4(11)T
|
This command was integrated into Cisco IOS Release 12.4(11)T.
|
Usage Guidelines
In order for packet of disconnect (POD) requests to be processed by AAA, you need to configure the aaa server radius dynamic-author global configuration command.
You must configure radius-server attribute 32 include-in-access-req for the home agent to send the fully qualified domain name (FQDN) in the access request.
Examples
The following example enables the home agent to process Radius Disconnect messages:
Router(config)# ip mobile radius disconnect
ip mobile realm
To enable inbound user sessions to be disconnected when specific session attributes are presented, use the ip mobile realm command in global configuration mode. To disable this functionality, use the no form of this command.
ip mobile realm @xyz.com vrf vrf-name ha-addr ip-address [aaa-group [accounting
aaa-acct-group | authentication aaa-auth-group]] [dns dynamic-update method word] [dns
server primary dns server address secondary dns server address [assign]] [hotline]
no ip mobile realm ip mobile realm @xyz.com vrf vrf-name ha-addr ip-address [aaa-group
[accounting aaa-acct-group | authentication aaa-auth-group]] [dns dynamic-update method
word] [dns server primary dns server address secondary dns server address [assign]] [hotline]
Syntax Description
realm
|
Name of the specified realm.
|
vrf vrf name
|
Enables VRF support for a specific group.
|
ha-addr ip-address
|
IP address of the Home Agent.
|
aaa-group
|
(Optional) Denotes a AAA group.
|
accounting aaa-acct-group
|
(Optional) Specifies a AAA accounting group.
|
authentication aaa-auth-group
|
(Optional) Specifies a AAA authentication group.
|
dns dynamic-update method word
|
(Optional) Enables the DNS Update procedure for the specified realm. word is the dynamic DNS update method name.
|
dns server primary dns server address secondary dns server address
|
(Optional) Enables you to locally configure the DNS Server address.
|
assign
|
(Optional) Enables this feature for the specified realm.
|
hotline
|
(Optional) Enables Hotlining of the mobile hosts.
|
Defaults
There are no default values for this command.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.3(7)XJ
|
This command was introduced.
|
12.3(14)YX
|
The dns server assign, and dns dynamic-update method variables were introduced.
|
12.4(11)T
|
This command was integrated into Cisco IOS Release 12.4(11)T.
|
Usage Guidelines
This CLI defines the VRF for the domain "@xyz.com". The IP address of the Home Agent corresponding to the VRF is also defined, at which the MOIP tunnel will terminate. The IP address of the Home Agent should be a routable IP address on the box. Optionally, the AAA accounting and/or authentication server groups can be defined per VRF. If a AAA accounting server group is defined, all accounting records for the users of the realm will be sent to the specified group. If a AAA authentication server group is defined, HA-CHAP is sent to the server(s) defined in the group.
Examples
The following example identifies the DNS dynamic update keyword:
Router(config)#ip mobile realm @ispxyz1.com dns ?
dynamic-update Enable 3GPP2 IP reachability
server DNS server configuration
The following example identifies the hotlining and vrf keywords:
Router(config)# ip mobile realm @ispxyz1.com ?
dns Configure DNS details
hotline Hotlining of the mobile hosts
ip mobile registration-lifetime
To set the registration lifetime value advertised, use the ip mobile registration-lifetime command in interface or global configuration mode. To reset the registration lifetime value advertised to its default value, use the no form of this command.
ip mobile registration-lifetime seconds
no ip mobile registration-lifetime
Syntax Description
seconds
|
Lifetime value in seconds. Range is from 3 to 65535 (infinity). Default is 36000 seconds.
|
Defaults
36000 seconds
Command Modes
Interface and global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.3(11)T
|
Global configuration mode was added.
|
Usage Guidelines
This command allows an administrator to control the advertised lifetime on the interface. The foreign agent uses this command to control duration of registration. Visitors requesting longer lifetimes will be denied.
Examples
The following example sets the registration lifetime to 10 minutes on interface Ethernet 1 and 1 hour on interface Ethernet 2:
ip mobile registration-lifetime 600
ip mobile registration-lifetime 3600
Related Commands
Command
|
Description
|
show ip mobile interface
|
Displays advertisement information for interfaces that are providing foreign agent service or are home links for mobile nodes.
|
ip mobile router
To enable the mobile router and enter mobile router configuration mode, use the ip mobile router command in global configuration mode. To disable the mobile router, use the no form of this command.
ip mobile router
no ip mobile router
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)T
|
This command was introduced.
|
Usage Guidelines
The mobile router is a router that operates as a mobile node. The mobile router can roam from its home network and still provide connectivity for devices on its networks. The mobile networks are locally attached to the router.
Examples
The following example enables the mobile router:
Related Commands
Command
|
Description
|
show ip mobile router
|
Displays configuration information and monitoring statistics about the mobile router.
|
ip mobile router-service
To enable mobile router service on an interface, use the ip mobile router-service command in interface configuration mode. To disable this service, use the no form of this command.
ip mobile router-service {hold-down [foreign-agent seconds | reassociate msec] | roam [priority
value] | solicit [interval seconds] [retransmit initial minimum maximum seconds retry
number]}
no ip mobile router-service {hold-down [foreign-agent seconds | reassociate msec] | roam
[priority value] | solicit [interval seconds] [retransmit initial minimum maximum seconds
retry number]}
Syntax Description
hold-down
|
Specifies a delay period for mobile router registration.
|
foreign-agent seconds
|
(Optional) Time (in seconds) to wait before the mobile router registers to agents heard on an interface. The default is zero. The range is from 0 to 3600 seconds.
|
reassociate msec
|
(Optional) Specifies the delay (in milliseconds), after receiving a linkDown trap, that the mobile router waits for a linkUp trap. The default is 1000 msec. The range is from 0 to 5000 seconds.
|
roam
|
Enables the mobile router interface to roam.
|
priority value
|
(Optional) Priority value that is compared among multiple configured interfaces to select the interface in which to send the registration request. When multiple interfaces have highest priority, the highest bandwidth is the preferred choice. When multiple interfaces have the same bandwidth, the interface with the highest IP address is preferred. The range is from 0 to 255; the default is 100. Higher values equate to a higher priority.
|
solicit
|
Instructs the mobile router to send agent solicitation messages periodically.
|
interval seconds
|
(Optional) Interval (in seconds) to wait before the mobile router sends the next agent solicitation message after an advertisement is received on an interface. The range is from 1 to 65535 seconds; the default interval is 600 seconds (10 minutes).
|
retransmit initial
|
(Optional) Wait period before a retransmission of a registration request when no reply is received. The range is from 10 to 10000 milliseconds (10 seconds); the default is 1000 milliseconds (1 second).
|
minimum
|
(Optional) Minimum wait period (in seconds) before retransmission of a registration request when no reply is received.
|
maximum seconds
|
(Optional) Maximum wait period (in seconds) before retransmission of a registration request when no reply is received. Each successive retransmission timeout period is twice the previous period, as long as that is less than the maximum value.
|
retry number
|
(Optional) Number of times to retry sending the retransmission request. Retransmission stops after the maximum number of retries are attempted. The range is from 0 to 10; the default retry is 3. A value of 0 means no retransmission.
|
Defaults
hold-down foreign agent seconds: zero
hold-down reassociate msec: 1000
priority value: 100
interval seconds: 600 seconds
retransmit initial minimum maximum seconds: 1000 milliseconds (1 second)
retry number: Three retries
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.2(4)T
|
This command was introduced.
|
12.3(14)T
|
The foreign-agent seconds and reassociate msec keywords and arguments were added.
|
Usage Guidelines
The mobile router discovers home agents and foreign agents by receiving agent advertisements.
Note
In Release 12.3(14)T, the ip mobile router-service hold-down command was changed to the ip mobile router-service hold-down foreign-agent command. The previous version of the command is still accepted but the new command will appear in the running configuration.
When a wireless link connected to an interface is lossy, the mobile router must not immediately register with the foreign agent even when heard on a preferred interface. The ip mobile router-service hold-down foreign-agent seconds command allows existing communications to continue with mobile networks while the mobile router gauges the quality of the link to the new foreign agent.
The ip mobile router-service solicit command instructs the mobile router to send agent solicitation messages periodically. Some networks only send out agent advertisements periodically or when solicited. For networks on which agents do not advertise periodically, this function must be enabled to detect agents. The mobile router always sends solicitation messages when roaming interfaces come up.
If a mobile router interface is configured for solicitations, you should set both ip irdp maxadvertinterval seconds and ip irdp holdtime seconds to 0 seconds on the foreign agent. These settings ensure that the foreign agent will not send out any IRDP advertisements unless solicited. If a foreign agent or home agent are sending IRDP advertisements periodically, then a solicitation will trigger the agent to send an advertisement immediately instead of at the next time interval.
The solicit timer for the ip mobile router-service solicit command is reset and no solicitation is sent out on the roaming interface if the mobile router receives an advertisement from a foreign agent before the solicit timer expires. For example, if the mobile router is configured to solicit every 10 seconds and the foreign agent advertises every 3 seconds, the mobile router will never solicit.
Use the ip mobile router-service hold-down reassociate msec command to specify the interval of time that the mobile router will wait, after receiving an SNMP linkDown trap, for a linkUp trap from the Wireless Mobile Interface Card (WMIC) indicating that the wireless link is available for use. This hold-down delay should be long enough for the WMIC to establish connectivity with a new AP or bridge when roaming.
Use the show ip mobile router agent command to display agents learned from advertisements and the mobile router's available CCoAs. Use the show ip mobile router interface command to display the configuration of the interfaces used for roaming.
Examples
The following example configures roaming interfaces, solicitation services, and hold-down timers on serial interface 0 and roaming interfaces and hold-down timers on Ethernet interface 0 of the mobile router.
In this example, the mobile router has two interfaces. The serial interface is connected to a serial interface of a foreign agent and the Ethernet interface is connected to an Ethernet interface of a foreign agent. The mobile router will prefer to register on the Ethernet interface if possible because it has a higher priority than the serial interface. If the mobile router does not receive any agent advertisements on the Ethernet interface, it will use the serial interface to solicit foreign agents.
If the Ethernet interface hears a new foreign agent advertisement after the mobile router has already registered using the serial interface, it will wait the duration of the hold-down timer (20 seconds) before registering with the foreign agent on the Ethernet interface. The ip mobile router-service hold-down foreign-agent seconds command allows communications to continue with mobile networks while the mobile router gauges the quality of the link to the new foreign agent. The Ethernet interface is configured with a higher priority so the mobile router prefers to register with this interface.
Once it receives an agent advertisement on the Ethernet interface, it will use the Ethernet interface to register to its home agent.
ip mobile router-service roam
! s0 solicits every 5 seconds after last advertisement received on the interface
ip mobile router-service solicit interval 5
ip mobile router-service hold-down foreign-agent 20
ip mobile router-service roam priority 101
ip mobile router-service hold-down foreign-agent 20
In the following example, the mobile router is configured to receive dynamic CCoA from DHCP. The mobile router will wait 2000 milliseconds for the SNMP linkUp trap from the WMIC indicating that layer 2 has reassociated. This interval of time allows the mobile router to roam and still maintain wireless connectivity.
ip dhcp client mobile renew count 3 interval 20
ip mobile router-service roam
ip mobile router-service collocated
ip mobile router-service hold-down reassociate 2000
Related Commands
Command
|
Description
|
show ip mobile router agent
|
Displays information about the agents for the mobile router.
|
show ip mobile router interface
|
Displays information about the interface that the mobile router is using for roaming.
|
ip mobile router-service collocated
To enable static or dynamic collocated care-of address (CCoA) processing on a mobile router interface, use the ip mobile router-service collocated command in interface configuration mode. To disable static or dynamic CCoA processing, use the no form of this command.
ip mobile router-service collocated [gateway ip-address] [ccoa-only]
no ip mobile router-service collocated [gateway ip-address] [ccoa-only]
Syntax Description
gateway ip-address
|
(Optional) Next hop IP address for the mobile router to forward packets. The gateway ip-address combination is only seen while configuring an Ethernet interface.
|
ccoa-only
|
(Optional) Enables the interface to use CCoA processing only.
|
Defaults
No default behavior or values
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.2(15)T
|
This command was introduced.
|
12.3(4)T
|
The ccoa-only keyword was added. Dynamic CCoA functionality was added.
|
Usage Guidelines
The primary IP address of the interface is used as the CCoA. The interface must already be configured as a roaming interface using the ip mobile router-service roam interface configuration command for both static and dynamic CCoA processing.
The mobile router can register with the home agent using a CCoA that was acquired dynamically via the IP Control Protocol (IPCP).
The gateway IP address is the next-hop IP address for registration packets. Upon successful registration, this address will be used as the default gateway and default route.
You need not specify the gateway ip-address combination if using a serial interface. The gateway ip-address combination is required on all non point-to-point interfaces such as Ethernet LANs and must be on the same logical subnet as the primary interface IP address.
You can configure the mobile router interface to register only its CCoA and ignore foreign agent advertisements by using the ip mobile router-service collocated ccoa-only option. Using this command on an interface already registered with a foreign agent CoA will cause the mobile router to re-register immediately with a CCoA.
Using the no ip mobile router-service collocated ccoa-only command on an interface already registered with a CCoA will cause the interface to deregister its CCoA and begin foreign agent discovery.
Examples
The following example enables static CCoA processing on a mobile router interface:
interface FastEthernet0/0
! Primary IP address is the static CCoA
ip address 172.21.58.23 255.255.255.0
ip mobile router-service roam
! Gateway IP address is next-hop destination
ip mobile router-service collocated gateway 172.21.58.1
The following example enables dynamic CCoA processing on a mobile router interface:
ip mobile router-service roam
ip mobile router-service collocated
The following example enables static CCoA-only processing. The interface will not listen to foreign agent advertisements.
ip address 10.0.1.1 255.255.255.0
ip mobile router-service roam
ip mobile router-service collocated gateway 10.0.1.2 ccoa-only
ip mobile router-service collocated registration retry 30
The following example enables dynamic CCoA-only processing. The interface will not listen to foreign agent advertisements.
ip mobile router-service roam
ip mobile router-service collocated ccoa-only
Related Commands
Command
|
Description
|
ip mobile router-service collocated registration retry
|
Configures the time period that the mobile router waits before sending another registration request after a registration failure.
|
ip mobile router-service roam
|
Enables the mobile router to discover on which configured interface it will discover foreign agents.
|
ip mobile router-service collocated registration nat traversal
To enable Network Address Translation (NAT) traversal support for the mobile router, use the ip mobile router-service collocated registration nat traversal command in interface configuration mode. To disable NAT traversal support for the mobile router, use the no form of this command.
ip mobile router-service collocated registration nat traversal [keepalive seconds] [force]
no ip mobile router-service collocated registration nat traversal [keepalive seconds] [force]
Syntax Description
keepalive seconds
|
(Optional) Configures the keepalive interval, in seconds, that the mobile router will use when the home agent does not offer a specific value and just returns zero. The range is from is 0 to 65535. The default is 110.
Note When the value zero is chosen, the keepalive timer is disabled.
|
force
|
(Optional) Allows the mobile router to force the home agent to allocate a NAT UDP tunnel without performing detection presence of NAT along the HA-MR path.
|
Command Default
The mobile router does not support NAT traversal.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(6)XE
|
This command was introduced.
|
12.4(11)T
|
This command was integrated into Cisco IOS Release 12.4(11)T.
|
Usage Guidelines
UDP tunneling is negotiated only when the mobile router registers to the home agent in collocated care-of address (CCoA) mode.
If you configure the mobile router to force the home agent to allocate a UDP tunnel but do not configure the home agent to force UDP tunneling, the home agent will reject the forced UDP tunneling request. The decision of whether to force UDP tunneling is controlled by the home agent.
Examples
The following example shows a mobile router configured with a keepalive timer set to 56 seconds and forced to request UDP tunneling.
ip mobile router-service collocated registration nat traversal keepalive 56 force
Related Commands
Command
|
Description
|
ip mobile home-agent nat traversal
|
Enables NAT traversal support for Mobile IP home agents.
|
ip mobile foreign-agent nat traversal
|
Enables NAT traversal support for Mobile IP foreign agents.
|
show ip mobile binding
|
Displays the mobility binding table.
|
show ip mobile globals
|
Displays global information for mobile agents.
|
show ip mobile tunnel
|
Displays information about active tunnels.
|
show ip mobile visitor
|
Displays the table that contains the visitor list of the foreign agent.
|
ip mobile router-service collocated registration retry
To configure the time period that the mobile router waits before sending another registration request after a registration failure, use the ip mobile router-service collocated registration retry command in interface configuration mode. To disable this functionality, use the no form of this command.
ip mobile router-service collocated registration retry seconds
no ip mobile router-service collocated registration retry
Syntax Description
seconds
|
Retry interval (in seconds) for registration requests. The range is from 1 to 65535.
|
Defaults
60 seconds
Command Modes
Interface configuration.
Command History
Release
|
Modification
|
12.2(15)T
|
This command was introduced.
|
Usage Guidelines
An interface configured for static collocated care-of address (CCoA) will not have foreign agent advertisements to use to trigger new registration attempts. Any foreign agent advertisements detected on that interface are ignored.
The default retry value is 60 seconds. You need to use this command only when a different retry interval is desired.
Examples
The following example shows that the mobile router will wait 30 seconds before sending another registration request after a registration failure:
interface FastEthernet0/0
! Primary IP address is the CCoA
ip address 172.21.58.23 255.255.255.0
ip mobile router-service roam
ip mobile router-service collocated gateway 172.21.58.1
ip mobile router-service collocated registration retry 30
Related Commands
Command
|
Description
|
ip mobile router-service collocated
|
Enables static CCoA processing on a mobile router interface.
|
ip mobile router-service description
To add a description for the type of roaming interface that is active on the mobile router, use the ip mobile router-service description command in interface configuration mode. To remove the description, use the no form of this command.
ip mobile router-service description string
no ip mobile router-service description string
Syntax Description
string
|
Alphanumeric character string of the description of the roaming interface.
|
Command Default
If this command is not issued, a description does not exist.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.4(9)T
|
This command was introduced.
|
Usage Guidelines
If the ip mobile router-service description command is configured, the description of the roaming interface is sent to the home agent during registration and will display in the output of the show ip mobile binding command.
Examples
The following example shows the description for the type of roaming interface on the mobile router:
interface FastEthernet0/0
ip mobile router-service description Wireless LAN
Related Commands
Command
|
Description
|
show ip mobile binding
|
Displays the mobility binding table on the home agent.
|
ip mobile router-service link-type
To enable a link-type roaming interface, use the ip mobile router-service link-type command in interface configuration mode. To disable the link-type roaming interface, use the no form of this command.
ip mobile router-service link-type link-type
no ip mobile router-service link-type
Syntax Description
link-type
|
Link-type associated with a roaming interface. The following link-types are available:
• 1xRTT, 4.9G, 802.11a, 802.11b, 802.11g, EDGE, EVDO, GPRS, UMTS, WORD, WiMAX
|
Command Default
No link-type roaming interface is configured.
Command Modes
Interface configuration (config-if)
Command History
Release
|
Modification
|
12.4(24)T
|
This command was introduced.
|
Usage Guidelines
Use this command to configure label-based application routing and the mobile router (MR) roaming interfaces. The link-type label on the interfaces is passed to the home agent (HA) when the interface registers. This label is used during registration on both the MR and the HA to generate dynamic route maps from mobile map templates.
Example:
ip mobile router-service roam
ip mobile router-service link-type 802.11g
Access Control Lists
You can use one or more extended named access control lists (ACLs) on both the MR and the HA to identify the application traffic. MR and HA are used as templates at registration time to generate dynamic ACLs that are used in the dynamic route maps.
Example:
ip access-list extended WEB
permit udp any any eq port 8080
Mobile Map Mobile Policy Templates
You can use one or more mobile map mobile policy templates on the MR and HA.
Example:
ip mobile mobile-map MPATH_1 10
set link-type 802.11g UMTS
You need to apply the mobile map to access interfaces. The mobile map is associated with a mobile network interface on the MR in the mobile network configuration. The mobile map configuration on the HA can specify up to three ingress interfaces.
Example:
MR:
mobile-network e 3/0 policy mobile-map MPATH_1
HA:
ip mobile home-agent policy mobile-map e 2/0 e 3/0 e 4/0
On the MR, a dynamic route map is created when each mobile-map template is configured. The dynamic route map has a long name that contains the first seven characters of the mobile map tag.
Example: A mobile map with the tag "MPATH_1" creates the following dynamic route map:
MIP-00/00/00-01:02:03-1-MPATH_1
The dynamic name contains the application that generated the MIP, a date and time stamp, and a sequence number.
On the HA, a single dynamic route map is created when the first mobile map is configured. It has the following name:
MIP-10/11/06-01:02:03-1-MP-HA
Examples
The following example shows how to enable the link-type roaming interface using the ip mobile router-service link-type command:
Router# configure terminal
Router(config)# interface FastEthernet0/2
Router(config-if)# ip mobile router-service link-type 802.11g
Related Commands
Command
|
Description
|
ip mobile router-service roam
|
Enables the roaming interface of the IP mobile router service.
|
ip mobile router-service roam
To enable the roaming interface of the IP mobile router service, use the ip mobile router-service roam command in interface configuration mode. To disable a roaming interface, use the no form of this command.
ip mobile router-service roam [priority priority-level]
no ip mobile router-service roam [priority priority-level]
Syntax Description
priority
|
(Optional) Sets the roaming interface priority of the router service.
|
priority-level
|
(Optional) Roaming priority level. The priority level can be 50, 100, 200, and so on.
|
Command Default
No priority is set for roaming interfaces.
Command Modes
Interface configuration (config-if)
Command History
Release
|
Modification
|
12.4(24)T
|
This command was introduced.
|
Usage Guidelines
Use this command to configure label-based application routing and the mobile router (MR) roaming interfaces. The link type label on the interfaces is passed to the home agent (HA) when the interface registers. This label is used during registration on both the MR and the HA to generate dynamic route maps from mobile map templates.
Example:
ip mobile router-service roam
ip mobile router-service link-type 802.11g
Access Control Lists (ACL)
You can use one or more extended named ACLs on both the MR and the HA to identify the application traffic. MR- and HA-named ACLs are used as templates at registration time to generate dynamic ACLs that are used in the dynamic route maps.
Example:
ip access-list extended WEB
permit udp any any eq port 8080
Mobile Map Mobile Policy Templates
You can use one or more mobile map mobile policy templates on the MR and HA.
Example:
ip mobile mobile-map MPATH_1 10
set link-type 802.11g UMTS
You need to apply the mobile map to access interfaces. The mobile map is associated with a mobile network interface on the MR in the mobile network configuration. The mobile map configuration on the HA can specify up to three ingress interfaces.
Example:
MR:
mobile-network e 3/0 policy mobile-map MPATH_1
HA:
ip mobile home-agent policy mobile-map e 2/0 e 3/0 e 4/0
On the MR, a dynamic route map is created when each mobile map template is configured. The dynamic route map has a long name that contains the first seven characters of the mobile map tag.
Example: A mobile map with the tag "MPATH_1" creates the following dynamic route map:
MIP-00/00/00-01:02:03-1-MPATH_1
The dynamic name contains the application that generated the MIP, a date and time stamp, and a sequence number.
On the HA, a single dynamic route map is created when the first mobile map is configured. It has the following name:
MIP-10/11/06-01:02:03-1-MP-HA
Examples
The following example shows how to enable a roaming interface and assign a priority for it:
Router# configure terminal
Router# interface FastEthernet0/2
Router(config-if)# ip mobile router-service roam priority 101
Related Commands
Command
|
Description
|
ip mobile router-service link-type
|
Configures the link type of the roaming interface defined for a mobile router service.
|
ip mobile router-service tunnel mode
To set the encapsulation mode for a mobile router interface, use the ip mobile router-service tunnel mode command in interface configuration mode. To restore the default encapsultion mode on an interface, use the no form of this command.
ip mobile router-service tunnel mode {gre | ipip}
no ip mobile router-service tunnel mode
Syntax Description
gre
|
Specifies that the mobile router will attempt to register with Generic Routing Encapsulation (GRE) on the interface.
|
ipip
|
Specifies that IP-in-IP encapsulation will be used on the interface.
|
Defaults
The default encapsulation mode for Mobile IP is IP-in-IP encapsulation.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.3(7)T
|
This command was introduced.
|
Usage Guidelines
If the ip mobile router-service tunnel mode gre command is configured, the mobile router will request GRE encapsulation in the registration request only if the foreign agent (FA) advertises that it is capable of GRE encapsulation (the G bit is set in the advertisement). If the registration request is successful, packets will be tunneled using GRE.
If the ip mobile router-service tunnel mode gre command is enabled and collocated care-of address (CCoA) is configured, the mobile router will attempt to register with the home agent (HA) using GRE encapsulation. If the registration request is successful, packets will be tunneled 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 ip mobile router-service tunnel mode command instructs the mobile router to revert to the default encapsulation mode 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 on an interface 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, the mobile router will attempt to reregister. GRE keepalives must be configured on the mobile router only—no configuration is required on the HA.
Note
If the GRE keepalive messages time out, indicating an interruption in the end-to-end tunnel, only the mobile router will tear down the GRE tunnel. The HA will not tear down its side of the tunnel.
Examples
The following example configures GRE encapsulation and GRE keepalive messages on an interface of a mobile router:
interface FastEthernet0/0
ip address 10.52.52.2 255.255.255.0
ip mobile router-service roam
ip mobile router-service tunnel mode gre
Related Commands
Command
|
Description
|
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 mode gre
|
Sets the global encapsulation mode on all roaming interfaces of a mobile router to GRE.
|
ip mobile secure aaa-download
To specify that authentication, authorization, and accounting (AAA) mobility security associations (SAs) are downloaded from the AAA server and the rate at which the information is downloaded, use the ip mobile secure aaa-download command in global configuration mode. To delete the AAA download rate, use the no form of this command.
ip mobile secure aaa-download rate seconds
no ip mobile secure aaa-download rate seconds
Syntax Description
rate
|
Rate at which the AAA SA is downloaded.
• seconds—Download rate, in seconds. Range is from 1 to 100.
|
Defaults
No AAA SAs are downloaded.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
Usage Guidelines
SAs are downloaded from a AAA server on the first use. This command allows the home agent (HA) to prepopulate an SA table.
Examples
The following example shows a download rate of 35 seconds:
ip mobile secure aaa-download rate 35
Related Commands
Command
|
Description
|
ip mobile host
|
Configures the mobile host or mobile node group.
|
ip mobile proxy-host
|
Configures the proxy Mobile IP attributes.
|
ip mobile secure foreign-agent
|
Configures the mobility SAs for an FA.
|
ip mobile secure home-agent
|
Configures the mobility SAs for an HA.
|
ip mobile secure host
|
Configures the mobility SAs for a mobile host.
|
ip mobile secure mn-aaa
|
Specifies non-standard SPI values in the MN-AAA authentication extension that need to be accepted by the home agent or the foreign agent.
|
ip mobile secure proxy-host
|
Configures the mobility SAs for a proxy host.
|
ip mobile secure visitor
|
Configures the mobility SAs for a visitor.
|
ntp server
|
Allows the system clock to be synchronized by a time server.
|
show ip mobile secure
|
Displays the mobility SAs for a mobile host, mobile visitor, FA, or HA.
|
ip mobile secure foreign-agent
To specify the mobility security associations (SAs) for a foreign agent (FA), use the ip mobile secure foreign-agent command in global configuration mode. To remove the mobility SAs, use the no form of this command.
ip mobile secure foreign-agent lower-address [upper-address] {inbound-spi {hex-in | decimal
decimal-in} outbound-spi {hex-out | decimal decimal-out} | spi {hex-value | decimal
decimal-value}} key {ascii string | hex string} [replay timestamp within seconds] [algorithm
{hmac-md5 | md5 mode prefix-suffix}]
no ip mobile secure foreign-agent lower-address [upper-address] {inbound-spi {hex-in | decimal
decimal-in} outbound-spi {hex-out | decimal decimal-out} | spi {hex-value | decimal
decimal-value}}
Syntax Description
lower-address
|
IP address of an FA or lower range of IP address pool.
• upper-address—(Optional) Upper range of IP address pool. If specified, SAs for multiple FAs are configured.
Note The upper-address value must be greater than the lower-address value.
|
inbound-spi
|
Bidirectional 4-byte security parameter index (SPI) used for authenticating inbound registration packets.
• hex-in—Index for inbound registration packets. The range is from 100 to ffffffff.
|
decimal
|
Decimal SPI. The arguments are as follows:
• decimal-in—SPI expressed as a decimal number for inbound registration packets. The range is from 256 to 4294967295.
• decimal-out—SPI expressed as a decimal number for outbound registration packets. The range is from 256 to 4294967295.
|
outbound-spi
|
SPI used for calculating the authenticator in outbound registration packets.
• hex-out—Index for outbound registration packets. The range is from 100 to ffffffff.
|
spi
|
SPI authenticates a peer. The argument and keyword are as follows:
• hex-value—SPI expressed as a hexadecimal number. The range is from 100 to ffffffff.
Note Cisco recommends that you use hexadecimal values instead of decimal values for interoperability.
• decimal—Decimal SPI. The argument is as follows:
– decimal-value—SPI expressed as a decimal number. The range is from 256 to 4294967295.
|
key
|
Security key. The arguments and keywords are as follows:
• ascii string—Security key expressed as an ASCII string. A maximum of 32 characters is allowed. No spaces are allowed.
• hex string—Security key expressed in hexadecimal digits. A maximum of 32 hex digits is allowed. The range is from 100 to ffffffff. No spaces are allowed.
|
replay timestamp within
|
(Optional) Specifies the number of seconds that the router uses for replay protection.
• seconds—Time, in seconds, that a router uses for replay protection. The range is from plus or minus 255. The default is plus or minus 7.
Note The registration packet is considered "not replayed" if the time stamp in the packet is within plus or minus the configured number of seconds of the router clock.
|
algorithm
|
(Optional) Algorithm used to authenticate messages during registration. The keywords are as follows:
• hmac-md5—Hash-based Message Authentication Code (HMAC) MD5.
Note The HMAC-MD5 authentication algorithm or MD5 (prefix-suffix) authentication algorithm is mandatory for mobile-home authentication (MHAE), mobile-foreign authentication (MFAE), or foreign-home authentication (FHAE).
• md5 mode—Message Digest 5 (MD5) mode used to authenticate packets during registration.
• prefix-suffix—Wrapped registration information for authentication (for example, key registration information key) that calculates the message digest.
Note Cisco no longer recommends this method of authentication, but it is retained for backward compatibility.
|
Defaults
No SA is specified for FAs.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.2
|
The lower-address and upper-address arguments were added.
|
12.2(13)T
|
The hmac-md5 keyword was added.
|
Usage Guidelines
The SA consists of an entity address, SPI, key, replay protection method, authentication algorithm, and authentication algorithm mode (prefix-suffix).
On a FA, the SA of the visiting mobile host and the SA of the home agent (HA) are optional. Multiple SAs for each entity can be configured.
The SA of a visiting mobile host on the MFAE and the SA of the HA on the FHAE are optional on the FA as long as they are not specified on the other entity. Multiple SAs for each entity can be configured.
Note
NTP is not required for operation, but NTP can be used to synchronize time for all parties.
Examples
The following example shows the configuration of an FA with an IP address of 209.165.200/254:
ip mobile secure foreign-agent 209.165.200/254 inbound-spi 203 outbound-spi 150 key
hex ffffffff
Related Commands
Command
|
Description
|
ip mobile host
|
Configures the mobile host or mobile node group.
|
ip mobile proxy-host
|
Configures the proxy Mobile IP attributes.
|
ip mobile secure aaa-download
|
Configures the rate at which AAA security associations are downloaded.
|
ip mobile secure home-agent
|
Configures the mobility SAs for an HA.
|
ip mobile secure host
|
Configures the mobility SAs for a mobile host.
|
ip mobile secure mn-aaa
|
Specifies non-standard SPI values in the MN-AAA authentication extension that need to be accepted by the home agent or foreign agent.
|
ip mobile secure proxy-host
|
Configures the mobility SAs for a proxy host.
|
ip mobile secure visitor
|
Configures the mobility SAs for a visitor.
|
show ip mobile secure
|
Displays the mobility SAs for a mobile host, mobile visitor, FA, or HA.
|
ip mobile secure home-agent
To specify the mobility security associations (SAs) for a home agent (HA), use the ip mobile secure home-agent command in global configuration mode. To remove the mobility SAs, use the no form of this command.
ip mobile secure home-agent lower-address [upper-address] {inbound-spi {hex-in | decimal
decimal-in} outbound-spi {hex-out | decimal decimal-out} | spi {hex-value | decimal
decimal-value}} key {ascii string | hex string} [replay timestamp within seconds] [algorithm
{hmac-md5 | md5 mode prefix-suffix}] [ignore-spi]
np ip mobile secure home-agent lower-address [upper-address] {inbound-spi {hex-in | decimal
decimal-in} outbound-spi {hex-out | decimal decimal-out} | spi {hex-value | decimal
decimal-value}}
Syntax Description
lower-address
|
IP address of an HA or lower range of IP address pool.
• upper-address—(Optional) Upper range of IP address pool. If specified, SAs for multiple HAs are configured.
Note The upper-address value must be greater than the lower-address value.
|
inbound-spi
|
Bidirectional 4-byte security parameter index (SPI) used for authenticating inbound registration packets.
• hex-in—Index for inbound registration packets. The range is from 100 to ffffffff.
|
decimal
|
Decimal SPI. The arguments are as follows:
• decimal-in—SPI expressed as a decimal number for inbound registration packets. The range is from 256 to 4294967295.
• decimal-out—SPI expressed as a decimal number for outbound registration packets. The range is from 256 to 4294967295.
|
outbound-spi
|
SPI used for calculating the authenticator in outbound registration packets.
• hex-out—Index for outbound registration packets. The range is from 100 to ffffffff.
|
spi
|
SPI authenticates a peer. The argument and keyword are as follows:
• hex-value—SPI expressed as a hexadecimal number. The range is from 100 to ffffffff.
Note Cisco recommends that you use hexadecimal values instead of decimal values for interoperability.
• decimal—Decimal SPI. The argument is as follows:
– decimal-value—SPI expressed as a decimal number. The range is from 256 to 4294967295.
|
key
|
Security key. The arguments and keywords are as follows:
• ascii string—Security key expressed as an ASCII string. A maximum of 32 characters is allowed. No spaces are allowed.
• hex string—Security key expressed in hexadecimal digits. A maximum of 32 hex digits is allowed. The range is from 100 to ffffffff. No spaces are allowed.
|
replay timestamp within
|
(Optional) Specifies the number of seconds that the router uses for replay protection.
• seconds—Time, in seconds, that a router uses for replay protection. The range is from plus or minus 255. The default is plus or minus 7.
Note The registration packet is considered "not replayed" if the time stamp in the packet is within plus or minus the configured number of seconds of the router clock.
|
algorithm
|
(Optional) Algorithm used to authenticate messages during registration. The keywords are as follows:
• hmac-md5—Hash-based Message Authentication Code (HMAC) MD5.
Note The HMAC-MD5 authentication algorithm or MD5 (prefix-suffix) authentication algorithm is mandatory for mobile-home authentication (MHAE), mobile-foreign authentication (MFAE), or foreign-home authentication (FHAE).
• md5 mode—Message Digest 5 (MD5) mode used to authenticate packets during registration.
• prefix-suffix—Wrapped registration information for authentication (for example, key registration information key) that calculates the message digest.
Note Cisco no longer recommends this method of authentication, but it is retained for backward compatibility.
|
ignore-spi
|
(Optional) Allows authentications that ignore SPI.
|
Defaults
No SA is specified for HAs.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.2
|
The lower-address and upper-address arguments were added.
|
12.2(13)T
|
The hmac-md5 keyword was added.
|
Usage Guidelines
The SA consists of an entity address, SPI, key, replay protection method, authentication algorithm, and authentication algorithm mode (prefix-suffix).
The HA may have multiple SAs for each peer. The SPI specifies which SA to use for the peer and selects the specific security parameters to be used to authenticate the peer.
On an HA, the SA of the mobile host is mandatory for mobile host authentication and allows the HA to compute the MHAE for mobile host authentication. If desired, configure a foreign agent (FA) SA on your HA.
The mobile IP protocol automatically synchronizes the time stamp used by the mobile node (MN) in its registration requests. If the MN registration request time stamp is outside the HA permitted replay protection time interval, the HA will respond with the number of seconds by which the MN time stamp is off relative to the HA clock. This allows the MN to adjust its time stamp and use synchronized time stamps in subsequent registration attempts.
If you prefer that the MN first registration attempt always fall within the HA replay protection time interval, use Network Time Protocol (NTP) to synchronize the MN and HA.
Note
NTP is not required for operation, but NTP can be used to synchronize time for all parties.
Examples
The following example shows the configuration of an SA for an HA with an IP address of 10.0.0.4:
ip mobile secure home-agent 10.0.0.4 spi 100 key hex ffffffff
Related Commands
Command
|
Description
|
ip mobile host
|
Configures the mobile host or mobile node group.
|
ip mobile proxy-host
|
Configures the proxy Mobile IP attributes.
|
ip mobile secure aaa-download
|
Configures the rate at which AAA security associations are downloaded.
|
ip mobile secure foreign-agent
|
Configures the mobility SAs for an FA.
|
ip mobile secure host
|
Configures the mobility SAs for a mobile host.
|
ip mobile secure mn-aaa
|
Specifies non-standard SPI values in the MN-AAA authentication extension that need to be accepted by the home agent or foreign agent.
|
ip mobile secure proxy-host
|
Configures the mobility SAs for a proxy host.
|
ip mobile secure visitor
|
Configures the mobility SAs for a visitor.
|
ntp server
|
Allows the system clock to be synchronized by a time server.
|
show ip mobile secure
|
Displays the mobility SAs for a mobile host, mobile visitor, FA, or HA.
|
ip mobile secure host
To specify the mobility security associations (SAs) for a mobile host, use the ip mobile secure host command in global configuration mode. To remove the mobility SAs, use the no form of this command.
ip mobile secure host {lower-address [upper-address] | nai nai-string} {inbound-spi {hex-in |
decimal decimal-in} outbound-spi {hex-out | decimal decimal-out} | spi {hex-value | decimal
decimal-value}} key {ascii string | hex string} [replay timestamp within seconds] [algorithm
{hmac-md5 | md5 mode prefix-suffix }]
no mobile secure host {lower-address [upper-address] | nai nai-string} {inbound-spi {hex-in |
decimal decimal-in} outbound-spi {hex-out | decimal decimal-out} | spi {hex-value | decimal
decimal-value}}
Syntax Description
lower-address
|
IP address of a host or lower range of IP address pool.
• upper-address—(Optional) Upper range of IP address pool. If specified, SAs for multiple hosts are configured.
Note The upper-address value must be greater than the lower-address value.
|
nai
|
Network access identifier (NAI) of the mobile node (MN).
• nai-string—NAI username or username@realm.
|
inbound-spi
|
Bidirectional 4-byte security parameter index (SPI) used for authenticating inbound registration packets.
• hex-in—Index for inbound registration packets. The range is from 100 to ffffffff.
|
decimal
|
Decimal SPI. The arguments are as follows:
• decimal-in—SPI expressed as a decimal number for inbound registration packets. The range is from 256 to 4294967295.
• decimal-out—SPI expressed as a decimal number for outbound registration packets. The range is from 256 to 4294967295.
|
outbound-spi
|
SPI used for calculating the authenticator in outbound registration packets.
• hex-out—Index for outbound registration packets. The range is from 100 to ffffffff.
|
spi
|
SPI authenticates a peer. The argument and keyword are as follows:
• hex-value—SPI expressed as a hexadecimal number. The range is from 100 to ffffffff.
Note Cisco recommends that you use hexadecimal values instead of decimal values for interoperability.
• decimal—Decimal SPI. The argument is as follows:
– decimal-value—SPI expressed as a decimal number. The range is from 256 to 4294967295.
|
key
|
Security key. The arguments and keywords are as follows:
• ascii string—Security key expressed as an ASCII string. A maximum of 32 characters is allowed. No spaces are allowed.
• hex string—Security key expressed in hexadecimal digits. A maximum of 32 hex digits is allowed. The range is from 100 to ffffffff. No spaces are allowed.
|
replay timestamp within
|
(Optional) Specifies the number of seconds that the router uses for replay protection.
• seconds—Time, in seconds, that a router uses for replay protection. The range is from plus or minus 255. The default is plus or minus 7.
Note The registration packet is considered "not replayed" if the time stamp in the packet is within plus or minus the configured number of seconds of the router clock.
|
algorithm
|
(Optional) Algorithm used to authenticate messages during registration. The keywords are as follows:
• hmac-md5—Hash-based Message Authentication Code (HMAC) MD5.
Note The HMAC-MD5 authentication algorithm or MD5 (prefix-suffix) authentication algorithm is mandatory for mobile-home authentication (MHAE), mobile-foreign authentication (MFAE), or foreign-home authentication (FHAE).
• md5 mode—Message Digest 5 (MD5) mode used to authenticate packets during registration.
• prefix-suffix—Wrapped registration information for authentication (for example, key registration information key) that calculates the message digest.
Note Cisco no longer recommends this method of authentication, but it is retained for backward compatibility.
|
Defaults
No SA is specified for mobile hosts.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.2
|
The lower-address and upper-address arguments were added.
|
12.2(2)XC
|
The nai keyword was added.
|
12.2(13)T
|
The hmac-md5 keyword was added.
|
Usage Guidelines
The SA consists of an entity address, SPI, key, replay protection method, authentication algorithm, and authentication algorithm mode (prefix-suffix).
The SA of a visiting mobile host on the MFAE and the SA of the home agent (HA) on the FHAE are optional as long as they are not specified on the other entity. Multiple SAs for each entity can be configured.
The HMAC-MD5 authentication algorithm is mandatory for MHAE, MFAE, and FHAE.
Note
NTP is not required for operation, but NTP can be used to synchronize time for all parties.
Examples
The following example shows the configuration of an SA for a host:
ip mobile secure host 10.0.0.4 spi 100 key hex 12345678123456781234567812345678
Related Commands
Command
|
Description
|
ip mobile host
|
Configures the mobile host or mobile node group.
|
ip mobile proxy-host
|
Configures the proxy Mobile IP attributes.
|
ip mobile secure aaa-download
|
Configures the rate at which AAA security associations are downloaded.
|
ip mobile secure foreign-agent
|
Configures the mobility SAs for an FA.
|
ip mobile secure home-agent
|
Configures the mobility SAs for an HA.
|
ip mobile secure mn-aaa
|
Specifies non-standard SPI values in the MN-AAA authentication extension that need to be accepted by the home agent or foreign agent.
|
ip mobile secure proxy-host
|
Configures the mobility SAs for a proxy host.
|
ip mobile secure visitor
|
Configures the mobility SAs for a visitor.
|
ntp server
|
Allows the system clock to be synchronized by a time server.
|
show ip mobile secure
|
Displays the mobility SAs for a mobile host, mobile visitor, FA, or HA.
|
ip mobile secure mn-aaa
To specify non-standard security parameter index (SPI) values in the MN-AAA authentication extension that need to be accepted by the home agent or the foreign agent, use the ip mobile secure mn-aaa command in global configuration mode. To disable this functionality, use the no form of this command.
ip mobile secure mn-aaa spi {hex-value | decimal decimal-value} algorithm md5 mode
ppp-chap-style
no ip mobile secure mn-aaa spi {hex-value | decimal decimal-value} algorithm md5 mode
ppp-chap-style
Syntax Description
spi
|
Bidirectional security parameter index (SPI). The index can be a hexadecimal or decimal value. The arguments and keyword are as follows:
• hex-value—SPI expressed in hexadecimal digits. The range is from 100 to ffffffff. No spaces are allowed. The maximum is 32 characters.
• decimal decimal-value—SPI expressed as a decimal number. The range is from 256 to 4294967295. No spaces are allowed. The maximum is 32 characters.
|
algorithm md5 mode ppp-chap-style
|
Message Digest 5 (MD5) authentication algorithm used during authentication by the Challenge-Handshake Authentication Protocol (CHAP).
|
Defaults
The home agent or foreign agent only accept the standard SPI value in the MN-AAA authentication extension that specifes CHAP-style authentication using MD5. The standard value for the SPI is 2.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2
|
This command was introduced.
|
Usage Guidelines
The SPI is the 4-byte index that selects the specific security parameters to be used to authenticate the peer. The security parameters consist of the authentication algorithm and mode.
A mobile node configured to be authenticated via an MN-AAA authentication extension is required to use an SPI value of 2 to indicate CHAP-style authentication using MD5 as specified by RFC 3012, Mobile IPv4 Challenge/Response Extensions.
Some network implementations need the flexibility to allow an SPI value other than 2 even though the mobile node is authenticated using CHAP. The ip mobile secure mn-aaa command maps new SPI values in the MN-AAA extension of the registration message to the SPI value pre-defined by RFC 3012. When a registration request arrives at the foreign agent or home agent with the MN-AAA extension containing an SPI value specified by the ip mobile secure mn-aaa command, the foreign agent or home agent will process it as if the value was 2 instead of rejecting the request.
Use this command with caution because it is non-standard behavior. For example, different vendors might use the same non-standard SPI to denote different authentication methods and this could affect interoperability. Cisco recommends the use of standard SPI values if possible to be used in the MN-AAA authentication extension by the mobile node.
Examples
In the following example, the foreign agent or home agent will process the registration request even though the CHAP SPI value is not 2:
ip mobile secure mn-aaa spi 1234 algorithm md5 mode ppp-chap-style
ip mobile secure proxy-host
To specify the mobility security associations (SAs) for a proxy host, use the ip mobile secure proxy-host command in global configuration mode. To remove the mobility SAs, use the no form of this command.
ip mobile secure proxy-host {lower-address [upper-address] | nai nai-string} {inbound-spi spi-in
outbound-spi spi-out | spi {hex-value | decimal decimal-value}} key {ascii string | hex string}
[replay timestamp seconds] [algorithm {md5 mode prefix-suffix | hmac-md5}]
no ip mobile secure proxy-host {lower-address [upper-address] | nai nai-string} {inbound-spi
spi-in outbound-spi spi-out | spi {hex-value | decimal decimal-value}} key {ascii string | hex
string} [replay timestamp seconds] [algorithm {md5 mode prefix-suffix | hmac-md5}]
Syntax Description
lower-address
|
IP address of a proxy host or lower range of IP address pool.
• upper-address—(Optional) Upper range of IP address pool. If specified, SAs for multiple proxy hosts are configured.
Note The upper-address value must be greater than the lower-address value.
|
nai
|
Network access identifier (NAI) of the mobile node (MN).
• nai-string—NAI username or username@realm.
|
inbound-spi
|
Bidirectional 4-byte security parameter index (SPI) used for authenticating inbound registration packets.
• spi-in—Index for inbound registration packets. The range is from 100 to ffffffff.
|
outbound-spi
|
SPI used for calculating the authenticator in outbound registration packets.
• spi-out—Index for outbound registration packets. The range is from 100 to ffffffff.
|
spi
|
SPI authenticates a peer. The argument and keyword are as follows:
• hex-value—SPI expressed as a hexadecimal number. The range is from 100 to ffffffff.
Note Cisco recommends that you use hexadecimal values instead of decimal values for interoperability.
• decimal—Decimal SPI. The argument is as follows:
– decimal-value—SPI expressed as a decimal number. The range is from 256 to 4294967295.
|
key
|
Security key. The arguments and keywords are as follows:
• ascii string—Security key expressed as an ASCII string. A maximum of 32 characters is allowed. No spaces are allowed.
• hex string—Security key expressed in hexadecimal digits. A maximum of 32 hex digits is allowed. The range is from 100 to ffffffff. No spaces are allowed.
|
replay timestamp
|
(Optional) Specifies the number of seconds that the router uses for replay protection.
• seconds—Time, in seconds, that a router uses for replay protection. The range is from plus or minus 255. The default is plus or minus 7.
Note The registration packet is considered "not replayed" if the time stamp in the packet is within plus or minus the configured number of seconds of the router clock.
|
algorithm
|
(Optional) Algorithm used to authenticate messages during registration. The keywords are as follows:
• md5 mode—Message Digest 5 (MD5) mode used to authenticate packets during registration.
• prefix-suffix—Wrapped registration information for authentication (for example, key registration information key) that calculates the message digest.
Note Cisco no longer recommends this method of authentication, but it is retained for backward compatibility.
• hmac-md5—Hash-based Message Authentication Code (HMAC) MD5.
Note The HMAC-MD5 authentication algorithm or MD5 (prefix-suffix) authentication algorithm is mandatory for mobile-home authentication (MHAE), mobile-foreign authentication (MFAE), or foreign-home authentication (FHAE).
|
Defaults
No SA is specified for proxy hosts.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.2
|
The lower-address and upper-address arguments were added.
|
12.2(2)XC
|
The nai keyword was added.
|
12.2(13)T
|
The hmac-md5 keyword was added.
|
12.3(4)T
|
The proxy-host keyword was added for Packet Data Serving Node (PDSN) platforms only.
|
Usage Guidelines
The SA consists of an entity address, SPI, key, replay protection method, authentication algorithm, and authentication algorithm mode (prefix-suffix).
The HMAC-MD5 authentication algorithm is mandatory for MHAE, MFAE, and FHAE.
Note
The proxy-host keyword is available only on PDSN platforms that are running specific PDSN code images; consult Cisco Feature Navigator for your Cisco IOS software release.
Note
NTP is not required for operation, but NTP can be used to synchronize time for all parties.
Examples
The following example shows the configuration of SAs for a proxy host:
ip mobile secure proxy-host 10.0.0.4 spi 100 key hex 12345678123456781234567812345678
Related Commands
Command
|
Description
|
ip mobile host
|
Configures the mobile host or mobile node group.
|
ip mobile proxy-host
|
Configures the proxy Mobile IP attributes.
|
ip mobile secure aaa-download
|
Configures the rate at which AAA security associations are downloaded.
|
ip mobile secure foreign-agent
|
Configures the mobility SAs for an FA.
|
ip mobile secure home-agent
|
Configures the mobility SAs for an HA.
|
ip mobile secure host
|
Configures the mobility SAs for a mobile host.
|
ip mobile secure mn-aaa
|
Specifies non-standard SPI values in the MN-AAA authentication extension that need to be accepted by the home agent or the foreign agent.
|
ip mobile secure visitor
|
Configures the mobility SAs for a visitor.
|
ntp server
|
Allows the system clock to be synchronized by a time server.
|
show ip mobile secure
|
Displays the mobility SAs for a mobile host, mobile visitor, FA, or HA.
|
ip mobile secure visitor
To specify the mobility security associations (SAs) for a visitor, use the ip mobile secure visitor command in global configuration mode. To remove the mobility security associations, use the no form of this command.
ip mobile secure visitor {lower-address [upper-address] | nai nai-string} {inbound-spi spi-in
outbound-spi spi-out | spi {hex-value | decimal decimal-value}} key {ascii string | hex string}
[replay timestamp seconds] [algorithm {md5 mode prefix-suffix | hmac-md5}]
no ip mobile secure visitor {lower-address [upper-address] | nai nai-string} {inbound-spi spi-in
outbound-spi spi-out | spi {hex-value | decimal decimal-value}} key {ascii string | hex string}
[replay timestamp seconds] [algorithm {md5 mode prefix-suffix | hmac-md5}]
Syntax Description
lower-address
|
IP address of a visitor or lower range of IP address pool.
• upper-address—(Optional) Upper range of IP address pool. If specified, SAs for multiple visitors are configured.
Note The upper-address value must be greater than the lower-address value.
|
nai
|
Network access identifier (NAI) of the mobile node (MN).
• nai-string—NAI username or username@realm.
|
inbound-spi
|
Bidirectional 4-byte security parameter index (SPI) used for authenticating inbound registration packets.
• spi-in—Index for inbound registration packets. The range is from 100 to ffffffff.
|
outbound-spi
|
SPI used for calculating the authenticator in outbound registration packets.
• spi-out—Index for outbound registration packets. The range is from 100 to ffffffff.
|
spi
|
SPI authenticates a peer. The argument and keyword are as follows:
• hex-value—SPI expressed as a hexadecimal number. The range is from 100 to ffffffff.
Note Cisco recommends that you use hexadecimal values instead of decimal values for interoperability.
• decimal—Decimal SPI. The argument is as follows:
– decimal-value—SPI expressed as a decimal number. The range is from 256 to 4294967295.
|
key
|
Security key. The arguments and keywords are as follows:
• ascii string—Security key expressed as an ASCII string. A maximum of 32 characters is allowed. No spaces are allowed.
• hex string—Security key expressed in hexadecimal digits. A maximum of 32 hex digits is allowed. The range is from 100 to ffffffff. No spaces are allowed.
|
replay timestamp
|
(Optional) Specifies the number of seconds that the router uses for replay protection.
• seconds—Time, in seconds, that a router uses for replay protection. The range is from plus or minus 255. The default is plus or minus 7.
Note The registration packet is considered "not replayed" if the time stamp in the packet is within plus or minus the configured number of seconds of the router clock.
|
algorithm
|
(Optional) Algorithm used to authenticate messages during registration. The keywords are as follows:
• md5 mode—Message Digest 5 (MD5) mode used to authenticate packets during registration.
• prefix-suffix—Wrapped registration information for authentication (for example, key registration information key) that calculates the message digest.
Note Cisco no longer recommends this method of authentication, but it is retained for backward compatibility.
• hmac-md5—Hash-based Message Authentication Code (HMAC) MD5.
Note The HMAC-MD5 authentication algorithm or MD5 (prefix-suffix) authentication algorithm is mandatory for mobile-home authentication (MHAE), mobile-foreign authentication (MFAE), or foreign-home authentication (FHAE).
|
Defaults
No SA is specified for visitors.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.2
|
The lower-address and upper-address arguments were added.
|
12.2(2)XC
|
The nai keyword was added.
|
12.2(13)T
|
The hmac-md5 keyword was added.
|
Usage Guidelines
The SA consists of an entity address, SPI, key, replay protection method, authentication algorithm, and authentication algorithm mode (prefix-suffix).
The SA of a visiting mobile host on the MFAE and the SA of the home agent (HA) on the FHAE are optional as long as they are not specified on the other entity. Multiple SAs for each entity can be configured.
The mobile IP protocol automatically synchronizes the time stamp used by the MN in its registration requests. If the MN registration request time stamp is outside the visitor permitted replay protection time interval, the visitor will respond with the number of secondsby which the MN time stamp is off relative to the visitor clock. This allows the MN to adjust its time stamp and use synchronized time stamps in subsequent registration attempts.
If you prefer that the MN first registration attempt always fall within the visitor replay protection time interval, use Network Time Protocol (NTP) to synchronize the MN and visitor.
The HMAC-MD5 authentication algorithm is mandatory for MHAE, MFAE, and FHAE.
Note
NTP is not required for operation, but NTP can be used to synchronize time for all parties.
Examples
The following example shows the configuration of SAs for a visitor:
ip mobile secure visitor 10.0.0.4 spi 100 key hex 12345678123456781234567812345678
Related Commands
Command
|
Description
|
ip mobile host
|
Configures the mobile host or mobile node group.
|
ip mobile proxy-host
|
Configures the proxy Mobile IP attributes.
|
ip mobile secure aaa-download
|
Configures the rate at which AAA security associations are downloaded.
|
ip mobile secure foreign-agent
|
Configures the mobility SAs for an FA.
|
ip mobile secure home-agent
|
Configures the mobility SAs for an HA.
|
ip mobile secure host
|
Configures the mobility SAs for a mobile host.
|
ip mobile secure mn-aaa
|
Specifies non-standard SPI values in the MN-AAA authentication extension that need to be accepted by the home agent or the foreign agent.
|
ip mobile secure proxy-host
|
Configures the mobility SAs for a proxy host.
|
ntp server
|
Allows the system clock to be synchronized by a time server.
|
show ip mobile secure
|
Displays the mobility SAs for a mobile host, mobile visitor, FA, or HA.
|
ip mobile tunnel
To specify the settings of tunnels created by Mobile IP, use the ip mobile tunnel command in global configuration mode. To disable the setting of tunnels created by Mobile IP, use the no form of this command.
ip mobile tunnel {crypto map map-name | route-cache [cef] | path-mtu-discovery [age-timer
{minutes | infinite}] | nat {inside | outside} | route-map map-tag}
no ip mobile tunnel {crypto map map-name | route-cache [cef] | path-mtu-discovery [age-timer
{minutes | infinite}] | nat {inside | outside} | route-map map-tag}
Syntax DescriptionI
crypto map
|
Enables encryption or decryption on new tunnels. This keyword is only available on platforms running specific Packet Data Serving Node (PDSN) code images.
|
map-name
|
The name of the crypto map. This argument is available only on platforms running specific PDSN code images.
|
route-cache
|
Sets tunnels to fast-switching mode.
|
cef
|
Sets tunnels to Cisco Express Forwarding (CEF) switching mode if CEF is enabled on the router.
|
path-mtu-discovery
|
Specifies when the tunnel MTU should expire if set by Path MTU Discovery.
|
age-timer minutes
|
(Optional) Time interval in minutes after which the tunnel reestimates the path MTU.
|
infinite
|
(Optional) Turns off the age timer.
|
nat
|
Applies Network Address Translation (NAT) on the tunnel interface.
|
inside
|
Sets the dynamic tunnel as the inside interface for NAT.
|
outside
|
Sets the dynamic tunnel as the outside interface for NAT.
|
route-map map-tag
|
Defines a meaningful name for the route map.
|
Defaults
Disabled.
If enabled, default value for the minutes argument is 10 minutes.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.1(1)T
|
The nat, inside, and outside keywords were added.
|
12.2T
|
The cef keyword was added.
|
12.2(13)T
|
The route-map keyword and map-tag argument were added.
|
12.3(4)T
|
The crpto map keyword and map-name argument were added for PDSN platforms.
|
Usage Guidelines
Path MTU Discovery is used by end stations to find a packet size that does not need to be fragmented when being sent between the end stations. Tunnels must adjust their MTU to the smallest MTU interior to achieve this condition, as described in RFC 2003.
The discovered tunnel MTU should be aged out periodically to possibly recover from a case where suboptimum MTU existed at time of discovery. It is reset to the outgoing MTU of the interface.
The no ip mobile tunnel route-cache command disables fast switching and CEF switching (if CEF is enabled) on Mobile IP tunnels. The no ip mobile tunnel route-cache cef command disables CEF switching only.
CEF switching is currently not supported on a foreign agent when reverse tunneling is enabled. If reverse tunneling is enabled at the foreign agent, disable CEF on the foreign agent using the no ip cef global configuration command. If the foreign agent does not support reverse tunneling, there is no need to disable CEF at the global configuration level.
The crypto map map-name keyword and argument combination are available only on platforms running specific PDSN code images; consult Feature Navigator for your Cisco IOS software release.
Examples
The following example sets the discovered tunnel MTU to expire in 10 minutes (600 seconds):
ip mobile tunnel path-mtu-discovery age-timer 600
Related Commands
Command
|
Description
|
ip cef
|
Enables CEF on the RP card.
|
show ip mobile tunnel
|
Displays active tunnels.
|
ip mobile virtual-network
To define a virtual network, use the ip mobile virtual-network command in global configuration mode. To remove the virtual network, use the no form of this command.
ip mobile virtual-network net mask [address address]
no ip mobile virtual-network net mask
Syntax Description
net
|
Network associated with the IP address of the virtual network.
|
mask
|
Mask associated with the IP address of the virtual network.
|
address address
|
(Optional) Specifies an IP address of a home agent on a virtual network.
|
Defaults
No home agent addresses are specified.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(1)T
|
This command was introduced.
|
12.0(2)T
|
The address keyword and address argument were added.
|
Usage Guidelines
This command inserts the virtual network into the routing table to allow mobile nodes to use the virtual network as their home network. The network is propagated when redistributed to other routing protocols.
Note
You may need to include virtual networks when configuring the routing protocols. If this is the case, use the redistribute mobile router configuration command to redistribute routes from one routing domain to another.
Examples
The following example adds the virtual network 20.0.0.0 to the routing table and specifies that the home agent IP address is configured on the loopback interface for that virtual network:
ip address 1.0.0.1 255.0.0.0
ip address 20.0.0.1 255.255.255.255
ip mobile virtual-network 20.0.0.0 255.255.0.0 address 20.0.0.1
ip mobile home-agent standby SanJoseHA virtual-network
ip mobile secure home-agent 1.0.0.2 spi 100 hex 00112233445566778899001122334455
Related Commands
Command
|
Description
|
ip mobile host
|
Configures the mobile host or mobile node group.
|
redistribute mobile
|
Redistributes routes from one routing domain into another routing domain.
|
ip mobile vpn-realm
To define the virtual private network (VPN) realms to be used in home agent policy routing, use the ip mobile vpn-realm command in global configuration mode. To remove the VPN realms, use the no form of this command.
ip mobile vpn-realm realm-name {route-map-sequence sequence-number}
no ip mobile vpn-realm realm-name {route-map-sequence sequence-number}
Syntax Description
realm-name
|
Network access identifier (NAI) realm name.
|
route-map-sequence
|
Sequence of the route map.
|
sequence-number
|
Number that indicates the position a new route map is to have in the list of route maps already configured with the same name. If given with the no form of this command, it specifies the position of the route map that should be deleted. The sequence number range is from 0 to 65535.
|
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(13)T
|
This command was introduced.
|
Usage Guidelines
The sequence-number argument must match that configured in the route-map sequence-number command.
Examples
The following example shows two realms configured on the router:
ip mobile vpn-realm company1.com route-map-sequence 20
ip mobile vpn-realm company2.com route-map-sequence 10
Related Commands
Command
|
Description
|
route map
|
Defines the conditions for redistributing routes from one routing protocol into another, or to enable policy routing.
|
show ip mobile vpn-realm
|
Displays VPN realms configured for Mobile IP.
|
mobile-network
To specify the mobile router interface that is connected to the dynamic mobile network, use the mobile-network command in mobile router configuration mode. To disassociate the networks from the mobile router, use the no form of this command.
mobile-network interface
no mobile-network interface
Syntax Description
interface
|
Mobile router interface that is connected to the dynamic network.
|
Defaults
No default behavior or values.
Command Modes
Mobile router configuration
Command History
Release
|
Modification
|
12.2(13)T
|
This command was introduced.
|
Usage Guidelines
The IP address and mask of the interface are added to the registration request to notify the home agent of the mobile networks. Once the home agent acknowledges the mobile network, the mobile router will no longer add the mobile network information in subsequent requests.
Examples
The following example shows how to enable mobile router services. In this example, the mobile router located at 10.0.0.3 is dynamically registering the primary interface address on Ethernet interface 3/2:
address 10.0.0.3 255.0.0.0
!specifies the Mobile Router interface connected to the mobile network
mobile-network Ethernet3/2
Related Commands
Command
|
Description
|
register (mobile networks)
|
Dynamically registers the mobile networks with the home agent.
|
mode bypass
To enable Virtual Multipoint Interfaces (VMI) to support multicast traffic, use the mode bypass command in interface configuration mode. To return the interface to the default mode of aggregate, use the no form of this command.
mode [aggregate | bypass]
no mode bypass
Syntax Description
aggregate
|
Sets the mode to aggregate. All virtual-access interfaces created by PPPoE sessions are logically aggregated under the VMI.
|
bypass
|
Sets the mode to bypass.
|
Defaults
No mode
Command Modes
Interface configuration
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 multicast traffic on Virtual Multipoint Interfaces (VMIs).
|
Usage Guidelines
Use the mode bypass command when you need to support multicast traffic in router-to-radio configurations.
Aggregate Mode
The default mode for operation of the VMI is aggregate mode. In aggregate mode, all of the virtual-access interfaces created by PPPoE sessions are logically aggregated under the VMI. As such, applications above Layer 2, such as, EIGRP and OSPFv3, should be defined on the VMI interface only. Packets sent to the VMI will be correctly forwarded to the correct virtual-access interface.
Bypass Mode
Using bypass mode is recommended for multicast applications.
In bypass mode, the virtual-access interfaces are directly exposed to applications running above Layer2. In bypass mode, definition of a VMI is still required because the VMI will continue to manage presentation of cross-layer signals, such as, neighbor up, neighbor down, and metrics. However, applications will still be aware on the actual underlying virtual-access interfaces and send packets to them directly.
Using bypass mode can cause databases in the applications to be larger because knowledge of more interfaces are required for normal operation.
After you enter the mode bypass command, Cisco recommends that you copy the running configuration to NVRAM. because the default mode of operation for VMI is to logically aggregate the virtual-access interfaces.
Examples
Bypass Mode on VMI Interfaces
Enabling Multicast on VMI interfaces includes changing the VMI interface to bypass mode and enabling Protocol Independent Multicast (PIM) sparse mode on the virtual-template interface.
Router# configure terminal
Router(config)#interface Virtual-Template1
Router(config-if)#ip address 10.3.3.1 255.255.255.0
Router(config-if)# load-interval 30
Router(config-if)# no keepalive
Router(config-if)# ip pim sparse-dense-mode
Router(config-if)#service-policy output FQ
Router(config)#interface vmi1
Router(config-if)#ip address 10.3.9.1 255.255.255.0
Router(config-if)# load-interval 30
Router(config-if)# physical-interface FastEthernet0/0
Router(config-if)# mode bypass
OSPF v3 Using Bypass Mode for IPv6 Multicast Traffic Example
The ipv6 ospf network point-to-multipoint command in this OSPF example is needed to allow OSPFv3 to learn dynamic metrics from the link.
subscriber authorization enable
pppoe service manet_radio
multilink bundle-name authenticated
no virtual-template subinterface
ipv6 address 2001:0DB1::1/64
interface FastEthernet0/0
interface FastEthernet2/0
interface FastEthernet2/1
switchport access vlan 503
interface FastEthernet2/2
interface FastEthernet2/3
interface Virtual-Template1
ipv6 address 2001:0DB2::1/64
ipv6 ospf network point-to-multipoint
ipv6 address 2001:0DB5::1/64
ipv6 address 2001:0DB8::1/64
physical-interface FastEthernet0/0
redistribute connected metric-type 1
EIGRP IPv4 with Bypass Mode Example
In this example, the IP address of the VMI1 interface needs to be defined, but it will not be routable because the vmi interface will be configured as down/down.
subscriber authorization enable
pppoe service manet_radio
multilink bundle-name authenticated
no virtual-template subinterface
ip address 10.9.1.1 255.255.255.0
interface FastEthernet0/0
interface FastEthernet2/0
interface FastEthernet2/1
switchport access vlan 503
interface FastEthernet2/2
interface FastEthernet2/3
interface Virtual-Template1
ip address 10.3.3.1 255.255.255.0
ip address 10.15.60.144 255.255.255.0
ip address 10.2.2.2 255.255.255.0
ipv6 address 3514:8::1/64
ip address 10.3.9.1 255.255.255.0
physical-interface FastEthernet0/0
network 10.2.0.0 0.0.255.255
network 10.3.0.0 0.0.255.255
EIGRP for IPv6 Example
subscriber authorization enable
pppoe service manet_radio
multilink bundle-name authenticated
no virtual-template subinterface
ipv6 address 2001:)DB1::1/64
interface FastEthernet0/0
interface FastEthernet2/0
interface FastEthernet2/1
switchport access vlan 503
interface FastEthernet2/2
interface FastEthernet2/3
interface Virtual-Template1
ipv6 address 2001:0DB2::1/64
ipv6 address 2001:0DB5::1/64
ipv6 address 2001:0DB8::1/64
physical-interface FastEthernet0/0
EIGRP with IPv4 and IPv6 Traffic Using Bypass Mode Example
subscriber authorization enable
pppoe service manet_radio
multilink bundle-name authenticated
no virtual-template subinterface
ip address 10.9.1.1 255.255.255.0
ipv6 address 2001:0DB1::1/64
interface FastEthernet0/0
interface FastEthernet2/0
interface FastEthernet2/1
switchport access vlan 503
interface FastEthernet2/2
interface FastEthernet2/3
interface Virtual-Template1
ip address 10.3.3.1 255.255.255.0
ipv6 address 2001:0DB8:0000:0000::/64
ip address 10.15.60.144 255.255.255.0
ip address 10.2.2.2 255.255.255.0
ipv6 address 2001:0DB8::1/64
ip address 10.3.9.1 255.255.255.0
physical-interface FastEthernet0/0
network 10.2.0.0 0.0.255.255
network 10.3.0.0 0.0.255.255
Related Commands
Command
|
Description
|
interface vmi
|
Creates a VMI interface.
|
multi-path (mobile networks)
To override the global default setting and enable the home agent to process requests with multiple path support for a specific mobile router, use the multi-path command in mobile networks configuration mode. To disable this functionality, use the no form of this command.
multi-path [metric {bandwidth | hopcount}]
no multi-path [metric {bandwidth | hopcount}]
Syntax Description
metric
|
(Optional) Metric for multipath load balancing.
|
bandwidth
|
(Optional) Specifies that bandwidth is used as the metric. Bandwidth is the default metric.
|
hopcount
|
(Optional) Specifies that hop count is used as the metric.
|
Command Default
Multiple path support is disabled on the home agent.
Command Modes
Mobile networks configuration
Command History
Release
|
Modification
|
12.4(9)T
|
This command was introduced.
|
Usage Guidelines
Multiple path support is enabled by default on the mobile router but is disabled by default on the home agent.
Examples
The following example shows how to configure the home agent to disable multiple path support for a specific mobile router:
ip mobile mobile-networks 10.1.1.14
Related Commands
Command
|
Description
|
ip mobile home-agent multi-path
|
Enables the home agent to process registration requests with multiple path support for all mobile routers.
|
multi-path (mobile router)
|
Enables the mobile router to request multiple path support.
|
multi-path (mobile router)
To enable the mobile router to request multiple path support, use the multi-path command in mobile router configuration mode. To disable this functionality, use the no form of this command.
multi-path [metric {bandwidth | hopcount}]
no multi-path [metric {bandwidth | hopcount}]
Syntax Description
metric
|
(Optional) Metric for multipath load balancing.
|
bandwidth
|
Specifies that bandwidth is used as the metric. Bandwidth is the default metric.
|
hopcount
|
Specifies that hop count is used as the metric.
|
Command Default
Multiple path support is enabled on the mobile router.
Command Modes
Mobile router configuration.
Command History
Release
|
Modification
|
12.4(9)T
|
This command was introduced.
|
Usage Guidelines
Multiple path support is enabled by default on the mobile router but disabled by default on the home agent.
Examples
The following example shows how to configure the mobile router to request multiple path support:
Related Commands
Command
|
Description
|
ip mobile home-agent multi-path
|
Enables the home agent to process registration requests with multiple path support for all mobile routers.
|
multi-path (mobile networks)
|
Overrides the global default setting and enables the home agent to process requests with multiple path support for a specific mobile router.
|