Guest

Cisco 7600 Mobile Wireless Home Agent

Cisco Mobile Wireless Home Agent 2.0 Command Reference for IOS Release 12.3(7)XJ2

Table Of Contents

Command Reference

aaa accounting

aaa accounting update

aaa authorization ipmobile

aaa pod server

access list

clear ip mobile binding

clear ip mobile host-counters

clear ip mobile secure

clear ip mobile traffic

crypto map (global IPSec)

debug aaa accounting

debug aaa pod

debug ip mobile

debug ip mobile host

debug ip mobile redundancy

debug radius

debug tacacs

ip mobile home-agent

ip mobile home-agent accounting

ip mobile home-agent dynamic-address

ip mobile home-agent redundancy

ip mobile home-agent reject-static-addr

ip mobile home-agent resync-sa

ip mobile home-agent revocation

ip mobile host

ip mobile radius disconnect

ip mobile realm

ip mobile secure

ip mobile tunnel

ip mobile virtual-network

radius-server attribute 32 include-in-access-req

radius-server host

router mobile

show ip mobile binding

show ip mobile binding vrf

show ip mobile binding vrf realm

show ip mobile globals

show ip mobile host

show ip mobile secure

show ip mobile traffic

show ip mobile tunnel

show ip mobile violation

show ip route vrf

snmp-server enable traps ipmobile

virtual


Command Reference


This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications.

aaa accounting

aaa authorization ipmobile

aaa pod server

access list

clear ip mobile binding

clear ip mobile host-counters

clear ip mobile secure

clear ip mobile traffic

crypto map (global IPSec)

debug aaa accounting

debug aaa pod

debug ip mobile

debug ip mobile host

debug ip mobile redundancy

debug radius

debug tacacs

ip mobile home-agent

ip mobile home-agent accounting

ip mobile home-agent dynamic-address

ip mobile home-agent redundancy

ip mobile home-agent reject-static-addr

ip mobile home-agent resync-sa

ip mobile home-agent revocation

ip mobile host

ip mobile radius disconnect

ip mobile realm

ip mobile secure

ip mobile tunnel

ip mobile virtual-network

radius-server attribute 32 include-in-access-req

radius-server host

router mobile

show ip mobile binding

show ip mobile binding vrf

show ip mobile binding vrf realm

show ip mobile binding vrf realm

show ip mobile host

show ip mobile secure

show ip mobile traffic

show ip mobile tunnel

show ip mobile violation

show ip route vrf

snmp-server enable traps ipmobile

virtual

aaa accounting

To enable authentication, authorization, and accounting (AAA) accounting of requested services for billing or security purposes when you use RADIUS or TACACS+, use the aaa accounting command in global configuration mode. To disable AAA accounting, use the no form of this command.

aaa accounting {auth-proxy | system | network | exec | connection | commands level} {default | list-name} {start-stop | stop-only | none} [broadcast] group groupname

no aaa accounting {auth-proxy | system | network | exec | connection | commands level} {default | list-name} [broadcast] group groupname

Syntax Description

auth-proxy

Provides information about all authenticated-proxy user events.

system

Performs accounting for all system-level events not associated with users, such as reloads.

network

Runs accounting for all network-related service requests, including SLIP1 , PPP2 , PPP NCPs3 , and ARAP4 .

exec

Runs accounting for EXEC shell session. This keyword might return user profile information such as what is generated by the autocommand command.

connection

Provides information about all outbound connections made from the network access server, such as Telnet, LAT5 , TN3270, PAD6 , and rlogin.

commands level

Runs accounting for all commands at the specified privilege level. Valid privilege level entries are integers from 0 through 15.

default

Uses the listed accounting methods that follow this argument as the default list of methods for accounting services.

list-name

Character string used to name the list of at least one of the accounting methods described in Table A-2.

start-stop

Sends a "start" accounting notice at the beginning of a process and a "stop" accounting notice at the end of a process. The "start" accounting record is sent in the background. The requested user process begins regardless of whether the "start" accounting notice was received by the accounting server.

stop-only

Sends a "stop" accounting notice at the end of the requested user process.

none

Disables accounting services on this line or interface.

broadcast

(Optional) Enables sending accounting records to multiple AAA servers. Simultaneously sends accounting records to the first server in each group. If the first server is unavailable, fail over occurs using the backup servers defined within that group.

group groupname

At least one of the keywords described in Table A-1.

1 SLIP = Serial Line Internet Protocol

2 PPP = Point-to-Point Protocol

3 PPP NCPs = Point-to-Point Protocol Network Control Protocols

4 ARAP = AppleTalk Remote Access Protocol

5 LAT = local-area transport

6 PAD = packet assembler/disassembler


Defaults

AAA accounting is disabled.

Command Modes

Global configuration

Command History

Release
Modification

10.3

This command was introduced.

12.0(5)T

Group server support was added.

12.1(1)T

The broadcast keyword was added on the Cisco AS5300 and Cisco AS5800 universal access servers.

12.1(5)T

The auth-proxy keyword was added.


Usage Guidelines

Use the aaa accounting command to enable accounting and to create named method lists defining specific accounting methods on a per-line or per-interface basis.

Table A-1 contains descriptions of accounting method keywords.

Table A-1 aaa accounting Methods 

Keyword
Description

group radius

Uses the list of all RADIUS servers for authentication as defined by the aaa group server radius command.

group tacacs+

Uses the list of all TACACS+ servers for authentication as defined by the aaa group server tacacs+ command.

group group-name

Uses a subset of RADIUS or TACACS+ servers for accounting as defined by the server group group-name.


In Table 1, the group radius and group tacacs+ methods refer to a set of previously defined RADIUS or TACACS+ servers. Use the radius-server host and tacacs-server host commands to configure the host servers. Use the aaa group server radius and aaa group server tacacs+ commands to create a named group of servers.

Cisco IOS software supports the following two methods of accounting:

RADIUS—The network access server reports user activity to the RADIUS security server in the form of accounting records. Each accounting record contains accounting attribute-value (AV) pairs and is stored on the security server.

TACACS+—The network access server reports user activity to the TACACS+ security server in the form of accounting records. Each accounting record contains accounting attribute-value (AV) pairs and is stored on the security server.

Method lists for accounting define the way accounting will be performed. Named accounting method lists enable you to designate a particular security protocol to be used on specific lines or interfaces for particular types of accounting services. Create a list by entering the list-name and the method, where list-name is any character string used to name this list (excluding the names of methods, such as radius or tacacs+) and method identifies the methods to be tried in sequence as given.

If the aaa accounting command for a particular accounting type is issued without a named method list specified, the default method list is automatically applied to all interfaces or lines (where this accounting type applies) except those that have a named method list explicitly defined. (A defined method list overrides the default method list.) If no default method list is defined, then no accounting takes place.

Named accounting method lists are specific to the indicated type of accounting. Method list keywords are described in Table A-2.

Table A-2 aaa accounting Methods Lists

Keyword
Description

auth-proxy

Creates a method list to provide accounting information about all authenticated hosts that use the authentication proxy service.

commands

Creates a method list to provide accounting information about specific, individual EXEC commands associated with a specific privilege level.

connection

Creates a method list to provide accounting information about all outbound connections made from the network access server.

exec

Creates a method list to provide accounting records about user EXEC terminal sessions on the network access server, including username, date, and start and stop times.

network

Creates a method list to provide accounting information for SLIP, PPP, NCPs, and ARA sessions.

resource

Creates a method list to provide accounting records for calls that have passed user authentication or calls that failed to be authenticated.



Note System accounting does not use named accounting lists; you can only define the default list for system accounting.


For minimal accounting, include the stop-only keyword to send a "stop" record accounting notice at the end of the requested user process. For more accounting, you can include the start-stop keyword, so that RADIUS or TACACS+ sends a "start" accounting notice at the beginning of the requested process and a "stop" accounting notice at the end of the process. Accounting is stored only on the RADIUS or TACACS+ server. The none keyword disables accounting services for the specified line or interface.

When AAA accounting is activated, the network access server monitors either RADIUS accounting attributes or TACACS+ AV pairs pertinent to the connection, depending on the security method you have implemented. The network access server reports these attributes as accounting records, which are then stored in an accounting log on the security server. For a list of supported RADIUS accounting attributes, refer to the appendix "RADIUS Attributes" in the Cisco IOS Security Configuration Guide. For a list of supported TACACS+ accounting AV pairs, refer to the appendix "TACACS+ Attribute-Value Pairs" in the Cisco IOS Security Configuration Guide.


Note This command cannot be used with TACACS or extended TACACS.


Examples

The following example defines a default commands accounting method list, where accounting services are provided by a TACACS+ security server, set for privilege level 15 commands with a stop-only restriction.

aaa accounting commands 15 default stop-only group tacacs+

The following example defines a default auth-proxy accounting method list, where accounting services are provided by a TACACS+ security server with a stop-only restriction. The aaa accounting command activates authentication proxy accounting.

aaa new-model
aaa authentication login default group tacacs+
aaa authorization auth-proxy default group tacacs+
aaa accounting auth-proxy default start-stop group tacacs+

Related Commands

Command
Description

aaa authentication ppp

Specifies one or more AAA authentication methods for use on serial interfaces running PPP.

aaa authorization

Sets parameters that restrict user access to a network.

aaa group server radius

Groups different RADIUS server hosts into distinct lists and distinct methods.

aaa group server tacacs

Groups different server hosts into distinct lists and distinct methods.

aaa new-model

Enables the AAA access control model.

radius-server host

Specifies a RADIUS server host.

tacacs-server host

Specifies a TACACS+ server host.


aaa accounting update

To enable periodic interim accounting records to be sent to the accounting server, use the aaa accounting update command in global configuration mode. To disable interim accounting updates, use the no form of this command.

aaa accounting update [newinfo] [periodic number]

no aaa accounting update

Syntax Description

newinfo

(Optional) Causes an interim accounting record to be sent to the accounting server whenever there is new accounting information to report relating to the user in question.

periodic

(Optional) Causes an interim accounting record to be sent to the accounting server periodically, as defined by the argument number.

number

Integer specifying number of minutes.


Defaults

Disabled

Command Modes

Global configuration

Command History

Release
Modification

11.3

This command was introduced.


Usage Guidelines

When aaa accounting update is activated, the Cisco IOS software issues interim accounting records for all users on the system. If the keyword newinfo is used, interim accounting records will be sent to the accounting server every time there is new accounting information to report. An example of this would be when IP Control Protocol (IPCP) completes IP address negotiation with the remote peer. The interim accounting record will include the negotiated IP address used by the remote peer.

When used with the keyword periodic, interim accounting records are sent periodically as defined by the argument number. The interim accounting record contains all of the accounting information recorded for that user up to the time the accounting record is sent.

When using both the newinfo and periodic keywords, interim accounting records are sent to the accounting server every time there is new accounting information to report, and accounting records are sent to the accounting server periodically as defined by the argument number. For example, if you configure aaa accounting update newinfo periodic number, all users currently logged in will continue to generate periodic interim accounting records while new users will generate accounting records based on the newinfo algorithm.


Caution Using the aaa accounting update periodic command can cause heavy congestion when many users are logged in to the network.

Examples

The following example sends PPP accounting records to a remote RADIUS server. When IPCP completes negotiation, this command sends an interim accounting record to the RADIUS server that includes the negotiated IP address for this user; it also sends periodic interim accounting records to the RADIUS server at 30 minute intervals.

aaa accounting network default start-stop group radius 
aaa accounting update newinfo periodic 30 

Related Commands

Command
Description

aaa accounting

Enables AAA accounting of requested services for billing or security purposes.


aaa authorization ipmobile

To authorize Mobile IP to retrieve security associations from the AAA server using TACACS+ or RADIUS, use the aaa authorization ipmobile global configuration command. Use the no form of this command to remove authorization.

aaa authorization ipmobile {tacacs+ | radius}

no aaa authorization ipmobile {tacacs+ | radius}

Syntax Description

tacacs+

Use TACACS+.

radius

Use RADIUS.


Defaults

AAA is not used to retrieve security associations for authentication.

Command Modes

Global configuration

Command History

Release
Modification

12.0(1)T

This command was introduced.


Usage Guidelines

Mobile IP requires security associations for registration authentication. The security associations are configured on the router or on an AAA server. This command is not need for the former; but in the latter case, this command authorizes Mobile IP to retrieve the security associations from the AAA server.


Note The AAA server does not authenticate the user. It stores the security association which is retrieved by the router to authenticate registration.


Examples

The following example uses TACACS+ to retrieve security associations from the AAA server:

aaa new-model
aaa authorization ipmobile tacacs+
tacacs-server host 1.2.3.4
tacacs-server key mykey
ip mobile host 10.0.0.1 10.0.0.5 virtual-network 10.0.0.0 255.0.0.0 aaa

Related Commands

Command
Description

show ip mobile host

Displays the mobility host information.


aaa pod server

To enable inbound user sessions to be disconnected when specific session attributes are presented, use the aaa pod server global configuration command. To disable this feature, use the no form of this command.

aaa pod server [port port-number] [auth-type {any | all | session-key}] server-key string

no aaa pod server

Syntax Description

port port-number

(Optional) The network access server port to use for packet of disconnect requests. If no port is specified, port 1700 is used.

auth-type

(Optional) The type of authorization required for disconnecting sessions. If no authentication type is specified, auth-type is the default.

any

(Optional) Specifies that the session that matches all attributes sent in the POD packet is disconnected. The POD packet can contain one or more of four key attributes (user-name, framed-IP-address, session-ID, and session-key).

all

(Optional) Only a session that matches all four key attributes is disconnected. All is the default.

session-key

(Optional) Specifies that the session that has a matching session-key attribute is disconnected. All other attributes are ignored.

server-key string

The secret text string that is shared between the network access server and the client workstation. This secret string must be the same on both systems.


Defaults

The POD server function is disabled.

Command Modes

Global configuration

Command History

Release
Modification

12.1(3)T

This command was introduced.


Usage Guidelines

For a session to be disconnected, the values in one or more of the key fields in the POD request must match the values for a session on one of the network access server ports. Which values must match depends on the auth-type attribute defined in the command. If no auth-type is specified, all four values must match. If no match is found, all connections remain intact and an error response is returned. The key fields are as follows:

User-Name

Framed-IP-Address

Session-Id

Server-Key

Examples

The following example enables POD and sets the secret key to "ab9123."

router (config)# aaa pod server server-key ab9123 

access list

To configure the access list mechanism for filtering frames by protocol type or vendor code, use the access-list global configuration command. Use the no form of this command to remove the single specified entry from the access list.

access-list access-list-number {permit | deny} {type-code wild-mask | address mask}

no access-list access-list-number {permit | deny} {type-code wild-mask | address mask}

Syntax Description

access-list-number

Integer that identifies the access list. If the type-code wild-mask arguments are included, this integer ranges from 200 to 299, indicating that filtering is by protocol type. If the address and mask arguments are included, this integer ranges from 700 to 799, indicating that filtering is by vendor code.

permit

Permits the frame.

deny

Denies the frame.

type-code

16-bit hexadecimal number written with a leading 0x; for example, 0x6000. Specify either a Link Service Access Point (LSAP) type code for 802-encapsulated packets or a SNAP type code for SNAP-encapsulated packets. (LSAP, sometimes called SAP, refers to the type codes found in the DSAP and SSAP fields of the 802 header.)

wild-mask

16-bit hexadecimal number whose ones bits correspond to bits in the type-code argument. The wild-mask indicates which bits in the type-code argument should be ignored when making a comparison. (A mask for a DSAP/SSAP pair should always be 0x0101 because these two bits are used for purposes other than identifying the SAP code.)

address

48-bit Token Ring address written in dotted triplet form. This field is used for filtering by vendor code.

mask

48-bit Token Ring address written in dotted triplet form. The ones bits in mask are the bits to be ignored in address. This field is used for filtering by vendor code.


Defaults

No numbered encryption access lists are defined, and therefore no traffic will be encrypted/decrypted. After being defined, all encryption access lists contain an implicit "deny" ("do not encrypt/decrypt") statement at the end of the list..

Command Modes

Global configuration

Command History

Release
Modification

11.2

This command was introduced.


Usage Guidelines

Use encryption access lists to control which packets on an interface are encrypted/decrypted, and which are transmitted as plain text (unencrypted).

When a packet is examined for an encryption access list match, encryption access list statements are checked in the order that the statements were created. After a packet matches the conditions in a statement, no more statements will be checked. This means that you need to carefully consider the order in which you enter the statements.

To use the encryption access list, you must first specify the access list in a crypto map and then apply the crypto map to an interface, using the crypto map (CET global configuration) and crypto map (CET interface configuration) commands.

Fragmented IP packets, other than the initial fragment, are immediately accepted by any extended IP access list. Extended access lists used to control virtual terminal line access or restrict contents of routing updates must not match the TCP source port, the type of service value, or the packet's precedence.


Note After an access list is created initially, any subsequent additions (possibly entered from the terminal) are placed at the end of the list. You cannot selectively add or remove access list command lines from a specific access list.



Caution When creating encryption access lists, we do not recommend using the any keyword to specify source or destination addresses. Using the any keyword with a permit statement could cause extreme problems if a packet enters your router and is destined for a router that is not configured for encryption. This would cause your router to attempt to set up an encryption session with a nonencrypting router. If you incorrectly use the any keyword with a deny statement, you might inadvertently prevent all packets from being encrypted, which could present a security risk.


Note If you view your router's access lists by using a command such as show ip access-list, all extended IP access lists will be shown in the command output. This includes extended IP access lists that are used for traffic filtering purposes as well as those that are used for encryption. The show command output does not differentiate between the two uses of the extended access lists.


Examples

The following example creates a numbered encryption access list that specifies a class C subnet for the source and a class C subnet for the destination of IP packets. When the router uses this encryption access list, all TCP traffic that is exchanged between the source and destination subnets will be encrypted.

access-list 101 permit tcp 172.21.3.0 0.0.0.255 172.22.2.0 0.0.0.255

clear ip mobile binding

To remove mobility bindings, use the clear ip mobile binding EXEC command.

clear ip mobile binding {all [load standby-group-name] | ip-address | nai string ip_address | vrf realm realm} [synch]

Syntax Description

all

Clears all mobility bindings.

load standby-group-name

(Optional) Downloads mobility bindings for a standby group after clear.

ip-address

IP address of a mobile node.

nai string

Network access identifier of the mobile node.

vrf realm realm

The specified vrf realm.

synch

(Optional) Specifies that the bindings that are administratively cleared on the active HA are synched to the standby HA, and the bindings will be deleted on the standby HA


Command Modes

EXEC

Command History

Release
Modification

12.0(1)T

This command was introduced.

12.1(3)T

The following keywords and argument were added:

all

load

standby-group-name

12.2(2)XC

The nai keyword and associated variables were added.

12.3(7)XJ

The vrf realm keyword and associated variable were added.

12.3(7)XJ1

The synch option was added.


Usage Guidelines

The Home Agent creates a mobility binding for each roaming mobile node. The mobility binding allows the mobile node to exchange packets with the correspondent node. Associated with the mobility binding is the tunnel to the visited network and a host route to forward packets destined for the mobile node. There should be no need to clear the binding because it expires after lifetime is reached or when the mobile node deregisters.

When the mobility binding is removed, the number of users on the tunnel is decremented and the host route is removed from the routing table. The mobile node is not notified.

When the synch option is specified, bindings that are administratively cleared on the active HA are synched to the standby HA, and the bindings will be deleted on the standby HA. When the redundancy mode is active-standby, the synch option will not take effect if the clear command is issued on the standby HA.


Note Use this command with care, because it may terminate any sessions used by the mobile node. After using this command, the visitor will need to reregister to continue roaming.


Examples

The following example administratively stops mobile node 10.0.0.1 from roaming:

Router# clear ip mobile binding 10.0.0.1

Router# show ip mobile binding

Mobility Binding List:
Total 1
10.0.0.1: 
    Care-of Addr 68.0.0.31, Src Addr 68.0.0.31, 
    Lifetime granted 02:46:40 (10000), remaining 02:46:32
    Flags SbdmGvt, Identification B750FAC4.C28F56A8, 
    Tunnel100 src 66.0.0.5 dest 68.0.0.31 reverse-allowed
    Routing Options - (G)GRE

Related Commands

Command
Description

show ip mobile binding

Displays the mobility binding table.


clear ip mobile host-counters

To clear the mobility counters specific to each mobile station, use the clear ip mobile host-counters EXEC command.

clear ip mobile host-counters [[ip-address | nai string ip_address] undo]]

Syntax Description

ip-address

(Optional) IP address of a mobile node.

nai string

(Optional) Network access identifier of the mobile node.

undo

(Optional) Restores the previously cleared counters.


Command Modes

EXEC

Command History

Release
Modification

12.0(1)T

This command was introduced.

12.2(2)XC

The nai keyword and associated variables were added.


Usage Guidelines

This command clears the counters that are displayed when you use the show ip mobile host command. The undo keyword restores the counters (this is useful for debugging).

Examples

The following example shows how the counters can be used for debugging:

Router# show ip mobile host

20.0.0.1:
    Allowed lifetime 10:00:00 (36000/default)
    Roaming status -Unregistered-, Home link on virtual network 20.0.0.0/8
    Accepted 0, Last time -never-
    Overall service time -never-
    Denied 0, Last time -never-
    Last code `-never- (0)'
    Total violations 0
    Tunnel to MN - pkts 0, bytes 0
    Reverse tunnel from MN - pkts 0, bytes 0

 
Router# clear ip mobile host-counters
Router# show ip mobile host-counters

20.0.0.1:
    Allowed lifetime 10:00:00 (36000/default)
    Roaming status -Unregistered-, Home link on virtual network 20.0.0.0/8
    Accepted 0, Last time -never-
    Overall service time -never-
    Denied 0, Last time -never-
    Last code `-never- (0)'
    Total violations 0
    Tunnel to MN - pkts 0, bytes 0
    Reverse tunnel from MN - pkts 0, bytes 0

Related Commands

Command
Description

show ip mobile host

Displays mobile station counters and information.


clear ip mobile secure

To clear and retrieve remote security associations, use the clear ip mobile secure EXEC command.

clear ip mobile secure {host lower [upper] | nai string | empty | all} [load]

Syntax Description

host

Mobile node host.

lower

IP address of mobile node. Can be used alone, or as lower end of a range of addresses.

upper

(Optional) Upper end of range of IP addresses.

nai string

Network access identifier of the mobile node.

empty

Load in only mobile nodes without security associations. Must be used with the load keyword.

all

Clears all mobile nodes.

load

(Optional) Reload the security association from the AAA server after security association has been cleared.


Command Modes

EXEC

Command History

Release
Modification

12.0(1)T

This command was introduced.

12.2(2)XC

The nai keyword and associated variables were added.


Usage Guidelines

Security associations are required for registration authentication. They can be stored on an AAA server. During registration, they may be stored locally after retrieval from the AAA server. The security association on the router may become stale or out of date when the security association on the AAA server changes.

This command clears security associations that have been downloaded from the AAA server.


Note Security associations that are manually configured on the router or not stored on the router after retrieval from the AAA server are not applicable.


Examples

In the following example, the AAA server has the security association for user 10.0.0.1 after registration:

Router# show ip mobile secure host 10.0.0.1

Security Associations (algorithm,mode,replay protection,key):
10.0.0.1:
    SPI 300,  MD5, Prefix-suffix, Timestamp +/- 7,
    Key `oldkey' 1230552d39b7c1751f86bae5205ec0c8

The security association of the AAA server changes as follows:

Router# clear ip mobile secure host 10.0.0.1 load

Router# show ip mobile secure host 10.0.0.1

10.0.0.1:
    SPI 300,  MD5, Prefix-suffix, Timestamp +/- 7,
    Key `newkey' 1230552d39b7c1751f86bae5205ec0c8

Related Commands

Command
Description

ip mobile secure

Specifies the mobility security associations for mobile host, visitor, Home Agent, and Foreign Agent.


clear ip mobile traffic

To clear counters, use the clear ip mobile traffic EXEC command.

clear ip mobile traffic

Syntax Description

This command has no arguments or keywords.

Command Modes

EXEC

Command History

Release
Modification

12.0(1)T

This command was introduced.

12.3(7)XJ

This command adds clear MIPv4 Registration Revocation related counters and Radius Disconnect related statistics.


Usage Guidelines

Mobile IP counters are accumulated during operation. They are useful for debugging and monitoring.

This command clears all Mobile IP counters. The undo keyword restores the counters (this is useful for debugging.) See the show ip mobile traffic command for a list and description of all counters.

Examples

The following example shows how the counters can be used for debugging:

Router# show ip mobile traffic

IP Mobility traffic:
Advertisements:
    Solicitations received 0
    Advertisements sent 0, response to solicitation 0
Home Agent Registrations:
    Register 8, Deregister 0 requests
    Register 7, Deregister 0 replied
    Accepted 6, No simultaneous bindings 0
    Denied 1, Ignored 1 
    Unspecified 0, Unknown HA 0
    Administrative prohibited 0, No resource 0
    Authentication failed MN 0, FA 0
    Bad identification 1, Bad request form 0
    .
    .
Router# clear ip mobile traffic

Router# show ip mobile traffic

IP Mobility traffic:
Advertisements:
    Solicitations received 0
    Advertisements sent 0, response to solicitation 0
Home Agent Registrations:
    Register 0, Deregister 0 requests
    Register 0, Deregister 0 replied
    Accepted 0, No simultaneous bindings 0
    Denied 0, Ignored 0 
    Unspecified 0, Unknown HA 0
    Administrative prohibited 0, No resource 0
    Authentication failed MN 0, FA 0
    Bad identification 0, Bad request form 0

Related Commands

Command
Description

show ip mobile traffic

Displays the protocol counters.


crypto map (global IPSec)

To create or modify a crypto map entry and enter the crypto map configuration mode, use the crypto map global configuration command. To delete a crypto map entry or set, use the no form of this command.

crypto map map-name seq-num ipsec-manual

crypto map map-name seq-num ipsec-isakmp [dynamic dynamic-map-name] [discover]

no crypto map map-name [seq-num]

Syntax Description

map name

The name you assign to the crypto map set

seq-num

The number you assign to the crypto map entry.

ipsec-manual

Indicates that IKE will not be used to establish the IPSec security associations for protecting the traffic specified by this crypto map entry.

ipsec-isakmp

Indicates that IKE will be used to establish the IPSec security associations for protecting the traffic specified by this crypto map entry.

dynamic

(Optional) Specifies that this crypto map entry is to reference a preexisting dynamic crypto map. Dynamic crypto maps are policy templates used in processing negotiation requests from a peer IPSec device. If you use this keyword, none of the crypto map configuration commands will be available.

dynamic-map-name

(Optional) Specifies the name of the dynamic crypto map set that should be used as the policy template.

discover

(Optional) Enables peer discovery. By default, peer discovery is not enabled.


Command Modes

Global configuration.

Command History

Release
Modification

12.1(1)T

This command was introduced.


Usage Guidelines

Issue the crypto map map-name seq-num command without a keyword to modify an existing crypto map entry.

Examples

The following example creates a crypto map entry and indicates that IKE will not be used to establish the IPSec security associations for protecting the traffic:

Router# crypto map map-name seq-num ipsec-manual

debug aaa accounting

To display information on accountable events as they occur, use the debug aaa accounting command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug aaa accounting

no debug aaa accounting

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Usage Guidelines

The information displayed by the debug aaa accounting command is independent of the accounting protocol used to transfer the accounting information to a server. Use the debug tacacs and debug radius protocol-specific commands to get more detailed information about protocol-level issues.

You can also use the show accounting command to step through all active sessions and to print all the accounting records for actively accounted functions. The show accounting command allows you to display the active "accountable events" on the system. It provides systems administrators a quick look at what is happening, and may also be useful for collecting information in the event of a data loss of some kind on the accounting server. The show accounting command displays additional data on the internal state of the authentication, authorization, and accounting (AAA) security system if debug aaa accounting is turned on as well.

Examples

The following is sample output from the debug aaa accounting command:

Router# debug aaa accounting 
16:49:21: AAA/ACCT: EXEC acct start, line 10 
16:49:32: AAA/ACCT: Connect start, line 10, glare 
16:49:47: AAA/ACCT: Connection acct stop: 
task_id=70 service=exec port=10 protocol=telnet address=172.31.3.78 cmd=glare bytes_in=308 
bytes_out=76 paks_in=45 paks_out=54 elapsed_time=14 

debug aaa pod

To display debug information for Radius Disconnect message processing at AAA subsystem level , use the debug aaa pod command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug aaa pod

no debug aaa pod

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(7)XJ

This command was introduced.


Examples

The following is sample output from the debug aaa pod command:

Router#sh debugging    
General OS:
  AAA POD packet processing debugging is on

The scenario is a POD request is received from RADIUS 17.17.17.18 with the set of attributes displayed below and after processing PDSN sends back an ACK

Router#
03:30:05: POD: 17.17.17.18 request queued
03:30:05:  ++++++ POD Attribute List ++++++
03:30:05: 63ECE94C 0 00000009 username(336) 12 sri-sip-user
03:30:05: 65FCEB50 0 00000009 clid(27) 11 00000000001
03:30:05: 65FCEB64 0 00000021 cdma-disconnect-reason(420) 4 1(1)
03:30:05: 65FCEB78 0 00000029 cdma-correlation-id(374) 8 00000002
03:30:05: 
03:30:05: POD: Sending ACK from port 1700 to 17.17.17.18/1700

debug ip mobile

To display IP mobility activities, use the debug ip mobile command in privileged EXEC mode.

debug ip mobile [advertise | host [access-list-number] | local-area | standby]

Syntax Description

advertise

(Optional) Advertisement information.

host

(Optional) The mobile node host.

access-list-number

(Optional) The number of an IP access list.

local-area

(Optional) The local area.

standby

(Optional) Redundancy activities.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(1)T

This command was introduced.

12.0(2)T

The standby keyword was added.

12.2(13)T

This command was enhanced to display information about Foreign Agent reverse tunnels and the mobile networks attached to the mobile router.

12.3(7)XJ

This command is enhanced to include the Resource Management capability.


Usage Guidelines

Use the debug ip mobile standby command to troubleshoot redundancy problems.

No per-user debugging output is shown for mobile nodes using the network access identifier (NAI) for the debug ip mobile host command. Debugging of specific mobile nodes using an IP address is possible through the access list.

Examples

The following is sample output from the debug ip mobile command when Foreign Agent reverse tunneling is enabled:

MobileIP:MN 14.0.0.30 deleted from ReverseTunnelTable of Ethernet2/1(Entries 0)

The following is sample output from the debug ip mobile advertise command:

Router# debug ip mobile advertise 
MobileIP: Agent advertisement sent out Ethernet1/2: type=16, len=10, seq=1, 
lifetime=36000, 
flags=0x1400(rbhFmGv-rsv-), 
Care-of address: 68.0.0.31 
Prefix Length ext: len=1 (8 ) 
FA Challenge value:769C808D 

Table A-3 Debug IP Mobile Advertise Field Descriptions

Field
Description

type

Type of advertisement.

len

Length of extension in bytes.

seq

Sequence number of this advertisement.

lifetime

Lifetime in seconds.

flags

Capital letters represent bits that are set, lower case letters represent unset bits.

Care-of address

IP address.

Prefix Length ext

Number of prefix lengths advertised. This is the bits in the mask of the interface sending this advertisement. Used for roaming detection.



debug ip mobile host

Use the debug ip mobile host EXEC command to display IP mobility events.

debug ip mobile host acl

no debug ip mobile host

Syntax Description

acl

(Optional) Access list.


Defaults

No default values.

Command History

Release
Modification

12.0(1)T

This command was introduced.


Examples

The following is sample output from the debug ip mobile host command:


Router# debug ip mobile host

MobileIP: HA received registration for MN 20.0.0.6 on interface Ethernet1 using COA
68.0.0.31 HA 66.0.0.5 lifetime 30000 options sbdmgvT
MobileIP: Authenticated FA 68.0.0.31 using SPI 110 (MN 20.0.0.6)
MobileIP: Authenticated MN 20.0.0.6 using SPI 300
MobileIP: HA accepts registration from MN 20.0.0.6
MobileIP: Mobility binding for MN 20.0.0.6 updated
MobileIP: Roam timer started for MN 20.0.0.6, lifetime 30000
MobileIP: MH auth ext added (SPI 300) in reply to MN 20.0.0.6
MobileIP: HF auth ext added (SPI 220) in reply to MN 20.0.0.6
MobileIP: HA sent reply to MN 20.0.0.6 

debug ip mobile redundancy

Use the debug ip mobile redundancy EXEC command to display IP mobility events.

debug ip mobile redundancy

no debug ip mobile redundancy

Syntax Description

This command has no keywords or arguments.

Defaults

No default values.

Command History

Release
Modification

12.0(1)T

This command was introduced.


Examples

The following is sample output from the debug ip mobile redundancy command:


Router# debug ip mobile redundancy

00:19:21: MobileIP: Adding MN service flags to bindupdate
00:19:21: MobileIP:  Adding MN service flags 0 init registration flags 1
00:19:21: MobileIP: Adding a hared version cvse - bindupdate
00:19:21: MobileIP: HARelayBindUpdate version number 2MobileIP: MN 40.0.0.20 - sent 
BindUpd to HA 7.0.0.3 HAA 7.0.0.4
00:19:21: MobileIP: HA standby maint started - cnt 1
00:19:21: MobileIP: MN 40.0.0.20 - HA rcv BindUpdAck accept from 7.0.0.3 HAA 7.0.0.4
00:19:22: MobileIP: HA standby maint started - cnt 1

debug radius

To display information associated with RADIUS, use the debug radius command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug radius [brief | hex]

no debug radius [brief | hex]

Syntax Description

brief

(Optional) Displays abbreviated debug output.

hex

(Optional) Displays debugging output in hexadecimal notation.


Defaults

Debugging output in ASCII format is enabled.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.2(1)T

This command was introduced.

12.2(11)T

The brief and hex keywords were added. The default output format became ASCII rather than hexadecimal.


Usage Guidelines

RADIUS is a distributed security system that secures networks against unauthorized access. Cisco supports RADIUS under the authentication, authorization, and accounting (AAA) security system. When RADIUS is used on the router, you can use the debug radius command to display detailed debugging and troubleshooting information in ASCII format. Use the debug radius brief command for abbreviated output displaying client/server interaction and minimum packet information. Use the debug radius hex command to display packet dump information that has not been truncated in hex format.

Examples

The following is sample output from the debug radius command:

Router# debug radius 
Radius protocol debugging is on 
Radius packet hex dump debugging is off 
Router# 
00:02:50: RADIUS: ustruct sharecount=3 
00:02:50: Radius: radius_port_info() success=0 radius_nas_port=1 
00:02:50: RADIUS: Initial Transmit ISDN 0:D:23 id 0 10.0.0.1:1824, Accounting-Request, len 
358 
00:02:50: RADIUS: NAS-IP-Address [4] 6 10.0.0.0 
00:02:50: RADIUS: Vendor, Cisco [26] 19 VT=02 TL=13 ISDN 0:D:23 
00:02:50: RADIUS: NAS-Port-Type [61] 6 Async 
00:02:50: RADIUS: User-Name [1] 12 "4085554206" 
00:02:50: RADIUS: Called-Station-Id [30] 7 "52981" 
00:02:50: RADIUS: Calling-Station-Id [31] 12 "4085554206" 
00:02:50: RADIUS: Acct-Status-Type [40] 6 Start 
00:02:50: RADIUS: Service-Type [6] 6 Login 
00:02:50: RADIUS: Vendor, Cisco [26] 27 VT=33 TL=21 h323-gw-id=5300_43. 
00:02:50: RADIUS: Vendor, Cisco [26] 55 VT=01 TL=49 h323-incoming-conf-id=8F3A3163 
B4980003 0 29BD0 
00:02:50: RADIUS: Vendor, Cisco [26] 31 VT=26 TL=25 h323-call-origin=answer 
00:02:50: RADIUS: Vendor, Cisco [26] 32 VT=27 TL=26 h323-call-type=Telephony 
00:02:50: RADIUS: Vendor, Cisco [26] 57 VT=25 TL=51 h323-setup-time=*16:02:48.681 PST Fri 
Dec 31 1999 
00:02:50: RADIUS: Vendor, Cisco [26] 46 VT=24 TL=40 h323-conf-id=8F3A3163 B4980003 0 29BD0 
00:02:50: RADIUS: Acct-Session-Id [44] 10 "00000002" 
00:02:50: RADIUS: Delay-Time [41] 6 0 
00:02:51: RADIUS: Received from id 0 1.7.157.1:1824, Accounting-response, len 20 
00:02:51: %ISDN-6-CONNECT: Interface Serial0:22 is now connected to 4085274206 
00:03:01: RADIUS: ustruct sharecount=3 
00:03:01: Radius: radius_port_info() success=0 radius_nas_port=1 
00:03:01: RADIUS: Initial Transmit ISDN 0:D:23 id 1 1.7.157.1:1823, Access-Request, len 
171 
00:03:01: RADIUS: NAS-IP-Address [4] 6 10.0.0.0 
00:03:01: RADIUS: Vendor, Cisco [26] 19 VT=02 TL=13 ISDN 0:D:23 
00:03:01: RADIUS: NAS-Port-Type [61] 6 Async 
00:03:01: RADIUS: User-Name [1] 8 "123456" 
00:03:01: RADIUS: Vendor, Cisco [26] 46 VT=24 TL=40 h323-conf-id=8F3A3163 B4980003 0 29BD0 
00:03:01: RADIUS: Calling-Station-Id [31] 12 "4085554206" 
00:03:01: RADIUS: User-Password [2] 18 * 
00:03:01: RADIUS: Vendor, Cisco [26] 36 VT=01 TL=30 h323-ivr-out=transactionID:0 
00:03:01: RADIUS: Received from id 1 1.7.157.1:1823, Access-Accept, len 115 
00:03:01: RADIUS: Service-Type [6] 6 Login 
00:03:01: RADIUS: Vendor, Cisco [26] 29 VT=101 TL=23 h323-credit-amount=45 
00:03:01: RADIUS: Vendor, Cisco [26] 27 VT=102 TL=21 h323-credit-time=33 
00:03:01: RADIUS: Vendor, Cisco [26] 26 VT=103 TL=20 h323-return-code=0 
00:03:01: RADIUS: Class [25] 7 6C6F63616C 
00:03:01: RADIUS: saved authorization data for user 62321E14 at 6233D258 
00:03:13: %ISDN-6-DISCONNECT: Interface Serial0:22 disconnected from 4085274206, call 
lasted 22 seconds 
00:03:13: RADIUS: ustruct sharecount=2 
00:03:13: Radius: radius_port_info() success=0 radius_nas_port=1 
00:03:13: RADIUS: Sent class "local" at 6233D2C4 from user 62321E14 
00:03:13: RADIUS: Initial Transmit ISDN 0:D:23 id 2 1.7.157.1:1824, Accounting-Request, 
len 775 
00:03:13: RADIUS: NAS-IP-Address [4] 6 10.0.0.0 
00:03:13: RADIUS: Vendor, Cisco [26] 19 VT=02 TL=13 ISDN 0:D:23 
00:03:13: RADIUS: NAS-Port-Type [61] 6 Async 
00:03:13: RADIUS: User-Name [1] 8 "123456" 
00:03:13: RADIUS: Called-Station-Id [30] 7 "52981" 
00:03:13: RADIUS: Calling-Station-Id [31] 12 "4085274206" 
00:03:13: RADIUS: Acct-Status-Type [40] 6 Stop 
00:03:13: RADIUS: Class [25] 7 6C6F63616C 
00:03:13: RADIUS: Undebuggable [45] 6 00000001 
00:03:13: RADIUS: Service-Type [6] 6 Login 
00:03:13: RADIUS: Vendor, Cisco [26] 27 VT=33 TL=21 h323-gw-id=5300_43. 
00:03:13: RADIUS: Vendor, Cisco [26] 55 VT=01 TL=49 h323-incoming-conf-id=8F3A3163 
B4980003 0 29BD0 
00:03:13: RADIUS: Vendor, Cisco [26] 31 VT=26 TL=25 h323-call-origin=answer 
00:03:13: RADIUS: Vendor, Cisco [26] 32 VT=27 TL=26 h323-call-type=Telephony 
00:03:13: RADIUS: Vendor, Cisco [26] 57 VT=25 TL=51 h323-setup-time=*16:02:48.681 PST Fri 
Dec 31 1999 
00:03:13: RADIUS: Vendor, Cisco [26] 59 VT=28 TL=53 h323-connect-time=*16:02:48.946 PST 
Fri Dec 31 1999 
00:03:13: RADIUS: Vendor, Cisco [26] 62 VT=29 TL=56in=0 
00:03:13: RADIUS: Vendor, Cisco [26] 23 VT=01 TL=17 pre-bytes-out=0 
00:03:13: RADIUS: Vendor, Cisco [26] 21 VT=01 TL=15 pre-paks-in=0 
00:03:13: RADIUS: Vendor, Cisco [26] 22 VT=01 TL=16 pre-paks-out=0 
00:03:13: RADIUS: Vendor, Cisco [26] 22 VT=01 TL=16 nas-rx-speed=0 
00:03:13: RADIUS: Vendor, Cisco [26] 22 VT=01 TL=16 nas-tx-speed=0 
00:03:13: RADIUS: Delay-Time [41] 6 0 
00:03:13: RADIUS: Received from id 2 1.7.157.1:1824, Accounting-response, len 20 
h323-disconnect-time=*16:03:11.306 PST Fri Dec 31 1999 
00:03:13: RADIUS: Vendor, Cisco [26] 32 VT=30 TL=26 h323-disconnect-cause=10 
00:03:13: RADIUS: Vendor, Cisco [26] 28 VT=31 TL=22 h323-voice-quality=0 
00:03:13: RADIUS: Vendor, Cisco [26] 46 VT=24 TL=40 h323-conf-id=8F3A3163 B4980003 0 29BD0 
00:03:13: RADIUS: Acct-Session-Id [44] 10 "00000002" 
00:03:13: RADIUS: Acct-Input-Octets [42] 6 0 
00:03:13: RADIUS: Acct-Output-Octets [43] 6 88000 
00:03:13: RADIUS: Acct-Input-Packets [47] 6 0 
00:03:13: RADIUS: Acct-Output-Packets [48] 6 550 
00:03:13: RADIUS: Acct-Session-Time [46] 6 22 
00:03:13: RADIUS: Vendor, Cisco [26] 30 VT=01 TL=24 subscriber=RegularLine 
00:03:13: RADIUS: Vendor, Cisco [26] 35 VT=01 TL=29 h323-ivr-out=Tariff:Unknown 
00:03:13: RADIUS: Vendor, Cisco [26] 22 VT=01 TL=16 pre-bytes- 

The following is sample output from the debug radius brief command:

Router# debug radius brief 
Radius protocol debugging is on 
Radius packet hex dump debugging is off 
Radius protocol in brief format debugging is on 
00:05:21: RADIUS: Initial Transmit ISDN 0:D:23 id 6 10.0.0.1:1824, Accounting-Request, len 
358 
00:05:21: %ISDN-6-CONNECT: Interface Serial0:22 is now connected to 4085274206 
00:05:26: RADIUS: Retransmit id 6 
00:05:31: RADIUS: Tried all servers. 
00:05:31: RADIUS: No valid server found. Trying any viable server 
00:05:31: RADIUS: Tried all servers. 
00:05:31: RADIUS: No response for id 7 
00:05:31: RADIUS: Initial Transmit ISDN 0:D:23 id 8 10.0.0.0:1823, Access-Request, len 171 
00:05:36: RADIUS: Retransmit id 8 
00:05:36: RADIUS: Received from id 8 1.7.157.1:1823, Access-Accept, len 115 
00:05:47: %ISDN-6-DISCONNECT: Interface Serial0:22 disconnected from 4085274206, call 
lasted 26 seconds 
00:05:47: RADIUS: Initial Transmit ISDN 0:D:23 id 9 10.0.0.1:1824, Accounting-Request, len 
775 
00:05:47: RADIUS: Received from id 9 1.7.157.1:1824, Accounting-response, len 20 

The following example shows debug radius hex output:

Router# debug radius hex 
Radius protocol debugging is on 
Radius packet hex dump debugging is on 
Router# 
17:26:52: RADIUS: ustruct sharecount=3 
17:26:52: Radius: radius_port_info() success=0 radius_nas_port=1 
17:26:52: RADIUS: Initial Transmit ISDN 0:D:23 id 10 10.0.0.1:1824, Accounting-Request, 
len 361 
17:26:52: Attribute 4 6 01081D03 
17:26:52: Attribute 26 19 00000009020D4953444E20303A443A3233 
17:26:52: Attribute 61 6 00000000 
17:26:52: Attribute 1 12 34303835323734323036 
17:26:52: Attribute 30 7 3532393831 
17:26:52: Attribute 31 12 34303835323734323036 
17:26:52: Attribute 40 6 00000001 
17:26:52: Attribute 6 6 00000001 
17:26:52: Attribute 26 27 000000092115683332332D67772D69643D353330305F34332E 
17:26:52: Attribute 26 57 
000000090133683332332D696E636F6D696E672D636F6E662D69643D3846334133313633204234393830303046
20302033424537314238 
17:26:52: Attribute 26 31 000000091A19683332332D63616C6C2D6F726967696E3D616E73776572 
17:26:52: Attribute 26 32 000000091B1A683332332D63616C6C2D747970653D54656C6570686F6E79 
17:26:52: Attribute 26 56 
000000091932683332332D73657475702D74696D653D2A30393A32363A35322E3838302050535420536174204A
616E20312032303030 
17:26:52: Attribute 26 48 
00000009182A683332332D636F6E662D69643D3846334133313633204234393830303046203020334245373142
38 
17:26:52: Attribute 44 10 3030303030303035 
17:26:52: Attribute 41 6 00000000 
17:26:52: %ISDN-6-CONNECT: Interface Serial0:22 is now connected to 4085274206 
17:26:52: RADIUS: Received from id 10 10.0.0.1:1824, Accounting-response, len 20 
17:27:01: RADIUS: ustruct sharecount=3 
17:27:01: Radius: radius_port_info() success=0 radius_nas_port=1 
17:27:01: RADIUS: Initial Transmit ISDN 0:D:23 id 11 10.0.0.0:1823, Access-Request, len 
173 
17:27:01: Attribute 4 6 01081D03 
17:27:01: Attribute 26 19 00000009020D4953444E20303A443A3233 
17:27:01: Attribute 61 6 00000000 
17:27:01: Attribute 1 8 313233343536 
17:27:01: Attribute 26 48 
00000009182A683332332D636F6E662D69643D3846334133313633204234393830303046203020334245373142
38 
17:27:01: Attribute 31 12 34303835323734323036 
17:27:01: Attribute 2 18 C980D8D0E9A061B3D783C61AA6F27214 
17:27:01: Attribute 26 36 
00000009011E683332332D6976722D6F75743D7472616E73616374696F6E49443A33 
17:27:01: RADIUS: Received from id 11 1.7.157.1:1823, Access-Accept, len 115 
17:27:01: Attribute 6 6 00000001 
17:27:01: Attribute 26 29 000000096517683332332D6372656469742D616D6F756E743D3435 
17:27:01: Attribute 26 27 000000096615683332332D6372656469742D74696D653D3333 
17:27:01: Attribute 26 26 000000096714683332332D72657475726E2D636F64653D30 
17:27:01: Attribute 25 7 6C6F63616C 
17:27:01: RADIUS: saved authorization data for user 61AA0698 at 6215087C 
17:27:09: %ISDN-6-DISCONNECT: Interface Serial0:22 disconnected from 4085554206, call 
lasted 17 seconds 
17:27:09: RADIUS: ustruct sharecount=2 
17:27:09: Radius: radius_port_info() success=0 radius_nas_port=1 
17:27:09: RADIUS: Sent class "local" at 621508E8 from user 61AA0698 
17:27:09: RADIUS: Initial Transmit ISDN 0:D:23 id 12 1.7.157.1:1824, Accounting-Request, 
len 776 
17:27:09: Attribute 4 6 01081D03 
17:27:09: Attribute 26 19 00000009020D4953444E20303A443A3233 
17:27:09: Attribute 61 6 00000000 
17:27:09: Attribute 1 8 313233343536 
17:27:09: Attribute 30 7 3532393831 
17:27:09: Attribute 31 12 34303835323734323036 
17:27:09: Attribute 40 6 00000002 
17:27:09: Attribute 25 7 6C6F63616C 
17:27:09: Attribute 45 6 00000001 
17:27:09: Attribute 6 6 00000001 
17:27:09: Attribute 26 27 000000092115683332332D67772D69643D353330305F34332E 
17:27:09: Attribute 26 57 
000000090133683332332D696E636F6D696E672D636F6E662D69643D3846334133313633204234393830303046
20302033424537314238 
17:27:09: Attribute 26 31 000000091A19683332332D63616C6C2D6F726967696E3D616E73776572 
17:27:09: Attribute 26 32 000000091B1A683332332D63616C6C2D747970653D54656C6570686F6E79 
17:27:09: Attribute 26 56 
000000091932683332332D73657475702D74696D653D2A30393A32363A35322E3838302050535420536174204A
616E20312032303030 
17:27:09: Attribute 26 58 
000000091C34683332332D636F6E6E6563742D74696D653D2A30393A32363A35322E3930372050535420536174
204A616E20312032303030 
17:27:09: Attribute 26 61 
000000091D37683332332D646973636F6E6E6563742D74696D653D2A30393A32373A31302E3133372050535420
536174204A616E20312032303030 
17:27:09: Attribute 26 32 000000091E1A683332332D646973636F6E6E6563742D63617573653D3130 
17:27:09: Attribute 26 28 000000091F16683332332D766F6963652D7175616C6974793D30 
17:27:09: Attribute 26 48 
00000009182A683332332D636F6E662D69643D3846334133313633204234393830303046203020334245373142
38 
17:27:09: Attribute 44 10 3030303030303035 
17:27:09: Attribute 42 6 00000000 
17:27:09: Attribute 43 6 00012CA0 
17:27:09: Attribute 47 6 00000000 
17:27:09: Attribute 48 6 000001E1 
17:27:09: Attribute 46 6 00000011 
17:27:09: Attribute 26 30 000000090118737562736372696265723D526567756C61724C696E65 
17:27:09: Attribute 26 35 
00000009011D683332332D6976722D6F75743D5461726966663A556E6B6E6F776E 
17:27:09: Attribute 26 22 0000000901107072652D62797465732D696E3D30 
17:27:09: Attribute 26 23 0000000901117072652D62797465732D6F75743D30 
17:27:09: Attribute 26 21 00000009010F7072652D70616B732D696E3D30 
17:27:09: Attribute 26 22 0000000901107072652D70616B732D6F75743D30 
17:27:09: Attribute 26 22 0000000901106E61732D72782D73706565643D30 
17:27:09: Attribute 26 22 0000000901106E61732D74782D73706565643D30 
17:27:09: Attribute 41 6 00000000 
17:27:09: RADIUS: Received from id 12 10.0.0.1:1824, Accounting-response, len 20 

debug tacacs

To display information associated with TACACS, use the debug tacacs command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug tacacs

no debug tacacs

Syntax Description

This command has no keywords or arguments.

Command Modes

Privileged EXEC

Usage Guidelines

TACACS is a distributed security system that secures networks against unauthorized access. Cisco supports TACACS under the authentication, authorization, and accounting (AAA) security system.

Use the debug aaa authentication command to get a high-level view of login activity. When TACACS is used on the router, you can use the debug tacacs command for more detailed debugging information.

Examples

The following is sample output from the debug aaa authentication command for a TACACS login attempt that was successful. The information indicates that TACACS+ is the authentication method used.

Router# debug aaa authentication 
14:01:17: AAA/AUTHEN (567936829): Method=TACACS+ 
14:01:17: TAC+: send AUTHEN/CONT packet 
14:01:17: TAC+ (567936829): received authen response status = PASS 
14:01:17: AAA/AUTHEN (567936829): status = PASS 

The following is sample output from the debug tacacs command for a TACACS login attempt that was successful, as indicated by the status PASS:

Router# debug tacacs 
14:00:09: TAC+: Opening TCP/IP connection to 192.168.60.15 using source 10.116.0.79 
14:00:09: TAC+: Sending TCP/IP packet number 383258052-1 to 192.168.60.15 (AUTHEN/START) 
14:00:09: TAC+: Receiving TCP/IP packet number 383258052-2 from 192.168.60.15 
14:00:09: TAC+ (383258052): received authen response status = GETUSER 
14:00:10: TAC+: send AUTHEN/CONT packet 
14:00:10: TAC+: Sending TCP/IP packet number 383258052-3 to 192.168.60.15 (AUTHEN/CONT) 
14:00:10: TAC+: Receiving TCP/IP packet number 383258052-4 from 192.168.60.15 
14:00:10: TAC+ (383258052): received authen response status = GETPASS 
14:00:14: TAC+: send AUTHEN/CONT packet 
14:00:14: TAC+: Sending TCP/IP packet number 383258052-5 to 192.168.60.15 (AUTHEN/CONT) 
14:00:14: TAC+: Receiving TCP/IP packet number 383258052-6 from 192.168.60.15 
14:00:14: TAC+ (383258052): received authen response status = PASS 
14:00:14: TAC+: Closing TCP/IP connection to 192.168.60.15 

The following is sample output from the debug tacacs command for a TACACS login attempt that was unsuccessful, as indicated by the status FAIL:

Router# debug tacacs 
13:53:35: TAC+: Opening TCP/IP connection to 192.168.60.15 using source 
192.48.0.79 
13:53:35: TAC+: Sending TCP/IP packet number 416942312-1 to 192.168.60.15 
(AUTHEN/START) 
13:53:35: TAC+: Receiving TCP/IP packet number 416942312-2 from 192.168.60.15 
13:53:35: TAC+ (416942312): received authen response status = GETUSER 
13:53:37: TAC+: send AUTHEN/CONT packet 
13:53:37: TAC+: Sending TCP/IP packet number 416942312-3 to 192.168.60.15 
(AUTHEN/CONT) 
13:53:37: TAC+: Receiving TCP/IP packet number 416942312-4 from 192.168.60.15 
13:53:37: TAC+ (416942312): received authen response status = GETPASS 
13:53:38: TAC+: send AUTHEN/CONT packet 
13:53:38: TAC+: Sending TCP/IP packet number 416942312-5 to 192.168.60.15 
(AUTHEN/CONT) 
13:53:38: TAC+: Receiving TCP/IP packet number 416942312-6 from 192.168.60.15 
13:53:38: TAC+ (416942312): received authen response status = FAIL 
13:53:40: TAC+: Closing TCP/IP connection to 192.168.60.15 

ip mobile home-agent

To enable and control Home Agent services on the router, use the ip mobile home-agent global configuration command. To disable these services, use the no form of this command.

ip mobile home-agent [home-agent address] [broadcast] [care-of-access acl] [lifetime number] [aaa] [nat-detect] [revocation] [replay seconds] [reverse-tunnel off] [roam-access acl] [strip-realm] [suppress-unreachable] [local-timezone] [unknown [accept | deny]] [send-mn-address]

no ip mobile home-agent [broadcast] [care-of-access acl] [lifetime number] [aaa] [nat-detect] [revocation] [replay seconds] [reverse-tunnel private address] [roam-access acl] [strip-nai-realm] [suppress-unreachable] [local-timezone] [unknown [accept | deny]] [send-mn-address]

Syntax Description

home-agent address

(Optional) IP address of the Home Agent.

broadcast

(Optional) Enables broadcast datagram routing. By default, broadcasting is disabled.

care-of-access acl

(Optional) Controls which care-of addresses (in registration request) are permitted by the Home Agent. By default, all care-of addresses are permitted. The access control list can be a string or number from 1 to 99.

lifetime number

(Optional) Specifies the global registration lifetime for a mobile node. Note that this can be overridden by the individual mobile node configuration. Range is 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.

aaa

(Optional) Specifies HA AAA access settings.

revocation

(Optional) Enables Registration Revocation.

nat-detect

(Optional) Allows the Home Agent to detect registration requests from a mobile node traversing a NAT-enabled device and apply a tunnel to reach the mobile node. By default, NAT detection is disabled.

replay seconds

(Optional) Sets the replay protection time-stamp value. Registration received within this time is valid.

reverse-tunnel-private address

(Optional) Enables support of reverse tunnel by the Home Agent. By default, reverse tunnel support is enabled. Reverse tunneling is mandatory for Private Mobile IP addresses.

roam-access acl

(Optional) Controls which mobile nodes are permitted or denied to roam. By default, all specified mobile nodes can roam.

strip-nai-realm

(Optional) Strips the realm part of the NAI before authentication is performed.

suppress-unreachable

(Optional) Disables sending ICMP unreachable messages to the source when a mobile node on the virtual network is not registered, or when a packet came in from a tunnel interface created by the Home Agent (in the case of a reverse tunnel). By default, ICMP unreachable messages are sent.

local-timezone

(Optional) Adjusts the UTC time based on the local time zone configured and uses the adjusted time for proxy mobile IP registration.

unknown [accept | deny]

When unknown accept is configured, the Home Agent will accept the Mobile IP Registration request with Home Agent address different unicast from the IP destination of the Mobile IP registration request, and the Home Agent address set in the Registration Reply is that of the IP destination address.

When unknown deny is configured, the Home Agent will deny the the Mobile IP Registration request with Home Agent address different unicast from the IP destination of the Mobile IP registration request with Error Code Unknown HomeAgent, and the Homeagent address set in the Reject Registration Reply is that of the IP destination address.

send-mn-address

Sends home address (as received in mobile IP registration request) in Access Request messages forHA-CHAP.

Note You must configure this keyword in the Home Agent to send radius-server vsa send authentication 3gpp2 attributes.


Defaults

This command is disabled by default. Broadcasting is disabled by default. Reverse tunnel support is enabled by default. ICMP Unreachable messages are sent by default.

Command Modes

Global configuration

Command History

Release
Modification

12.0(1)T

This command was introduced.

12.2(2)XC

The strip-nai-realm and local-timezone keywords were added.

12.2(8)ZB6

The unknown [accept | deny] and send-mn-address keywords were added.


Usage Guidelines

This command enables and controls Home Agent services on the router. Changes to service take effect immediately; however, broadcast and lifetime settings for previously registered mobile nodes are unaffected. Tunnels are shared by mobile nodes registered with the same endpoints, so the reverse-tunnel-off keyword also affects registered mobile nodes.

The Home Agent is responsible for processing registration requests from the mobile node and setting up tunnels and routes to the care-of address. Packets to the mobile node are forwarded to the visited network.

The Home Agent will forward broadcast packets to mobile nodes if they registered with the service. However, heavy broadcast traffic utilizes the CPU of the router. The Home Agent can control where the mobile nodes roam by the care-of-access parameter, and which mobile node is allowed to roam by the roam-access parameter.

When a registration request comes in, the Home Agent will ignore requests when Home Agent service is not enabled or the security association of the mobile node is not configured. The latter condition occurs because the security association must be available for the MH authentication extension in the reply. If a security association exists for the Foreign Agent (IP source address or care-of address in request), the Foreign Agent is authenticated, and then the mobile node is authenticated. The Identification field is verified to protect against replay attack. The Home Agent checks the validity of the request (see Table A-4) and sends a reply. (Replay codes are listed in Table A-5.) A security violation is logged when Foreign Agent authentication, MH authentication, or Identification verification fails. (The violation reasons are listed in Table A-6.)

After registration is accepted, the Home Agent creates or updates the mobility binding of the mobile node, which contains the expiration timer. If no binding existed before this registration, a virtual tunnel is created, a host route to the mobile node via the care-of address is added to the routing table, and gratuitous ARPs are sent out. For deregistration, the host route is removed from the routing table, the virtual tunnel interface is removed (if no mobile nodes are using it), and gratuitous ARPs are sent out if the mobile node is back home. Mobility binding is removed (along with its associated host route and tunnel) when registration lifetime expires or deregistration is accepted.

By default, the HA uses the entire NAI string as username for authentication (which may be with local security association or retrieved from the AAA server). The strip-nai-realm parameter instructs the HA to strip off the realm part of NAI (if it exists) before performing authentication. Basically, the mobile station is identified by only the username part of NAI.

When the packet destined for the mobile node arrives on the Home Agent, the Home Agent encapsulates the packet and tunnels it to the care-of address. If the Don't fragment bit is set in the packet, the outer bit of the IP header is also set. This allows the Path MTU Discovery to set the MTU of the tunnel. Subsequent packets greater than the MTU of the tunnel will be dropped and an ICMP datagram too big message sent to the source. If the Home Agent loses the route to the tunnel endpoint, the host route to the mobile node will be removed from the routing table until tunnel route is available. Packets destined for the mobile node without a host route will be sent out the interface (home link) or to the virtual network (see the description of suppress-unreachable keyword). For subnet-directed broadcasts to the home link, the Home Agent will send a copy to all mobile nodes registered with the broadcast routing option.

Table A-4 describes how the Home Agent treats registrations with various bits set when authentication and identification are passed.

Table A-4 Home Agent Registration Bitflags 

Bit Set
Registration Reply

S

Accept with code 1 (no simultaneous binding).

B

Accept. Broadcast can be enabled or disabled.

D

Accept. Tunnel endpoint is a collocated care-of address.

M

Deny. Minimum IP encapsulation is not supported.

G

Accept. GRE encapsulation is supported.

V

Ignore. Van Jacobsen Header compression is not supported.

T

Accept if reverse-tunnel-off parameter is not set.

reserved

Deny. Reserved bit must not be set.


Table A-5 lists the Home Agent registration reply codes.

Table A-5 Home Agent Registration Reply Codes 

Code
Reason

0

Accept.

1

Accept, no simultaneous bindings.

128

Reason unspecified.

129

Administratively prohibited.

130

Insufficient resource.

131

Mobile node failed authentication.

132

Foreign agent failed authentication.

133

Registration identification mismatched.

134

Poorly formed request.

136

Unknown Home Agent address.

137

Reverse tunnel is unavailable.

139

Unsupported encapsulation.


Table A-6 lists security violation codes.

Table A-6 Security Violation Codes

Code
Reason

1

No mobility security association.

2

Bad authenticator.

3

Bad identifier.

4

Bad SPI.

5

Missing security extension.

6

Other.


Examples

The following example enables broadcast routing and specifies a global registration lifetime of 7200 seconds (2 hours):

ip mobile home-agent broadcast lifetime 7200

Router (config)#ip mobile home-agent reverse-tunnel ?
  off              Disable reverse tunnel mode
  private-address  Reverse Tunneling Mandatory for Private Mobile IP addresses

Related Commands

Command
Description

show ip mobile globals

Displays global information for mobile agents.


ip mobile home-agent accounting

To enable the Home Agent accounting feature, use the ip mobile home-agent accounting command in global configuration mode.

ip mobile home-agent accounting list

Syntax Description

list

Specifies the accounting method used to generate accouting records. The accounting method identified by list is configured using the aaa accounting network command.


Defaults

There are no default values for this command.

Command Modes

Global configuration

Command History

Release
Modification

12.2(8)ZB7

This command was introduced.


Usage Guidelines

The Home Agent cannot open more than 100k bindings if HA Accounting feature is enabled.

Examples

The following example illustrates the ip mobile home-agent accounting command:

Router# ip mobile home-agent accounting list

ip mobile home-agent dynamic-address

To set the Home Agent Address field in a Registration Response packet, use the ip mobile home-agent dynamic-address command in global configuration. Use the no form of the command to disable this feature, or to reset the field.

ip mobile home-agent dynamic-address ip address

no ip mobile home-agent dynamic-address ip address

Syntax Description

ip address

The IP address of the Home Agent.


Defaults

The Home Agent Address field will be set to ip address.

Command Modes

Global configuration

Command History

Release
Modification

12.x(x)x

This command was introduced.


Examples

The following example illustrates the ip mobile home-agent dynamic address command:

Router# ip mobile home-agent dynamic address 1.1.1.1	

ip mobile home-agent redundancy

To configure the Home Agent for redundancy by using the Hot Standby Router Protocol (HSRP) group name, use the ip mobile home-agent redundancy subcommand under the ip mobile home-agent global configuration command. To remove the address, use the no form of this command.

ip mobile home-agent redundancy hsrp-group-name [[virtual-network] address addr] [mode active-standby]

no ip mobile home-agent redundancy hsrp-group-name [[virtual-network] address addr] [mode active-standby]

Syntax Description

hsrp-group-name

Specifies HSRP group name.

virtual-network

(Optional) Specifies that the HSRP group is used to support virtual networks.

address addr

(Optional) Home agent address.

mode active-standby

(Optional) Allows the bindings to come up (with local pool addressing for virtual-networks) with the HA IP address specified under Loopback interface


Defaults

No global Home Agent addresses are specified.

Command Modes

Subcommand of the ip mobile home-agent global configuration command.

Command History

Release
Modification

12.0(2)T

This command was introduced.

12.3(7)XJ1

The mode active-standby option was added.


Usage Guidelines

You must first configure the ip mobile home-agent command to use this sub-command.

The virtual-network keyword specifies that the HSRP group supports virtual networks.


Note Redundant Home Agents must have identical Mobile IP configurations. You can use a standby group to provide HA redundancy for either physical or virtual networks, but not both at the same time.


When Mobile IP standby is configured, the Home Agent can request mobility bindings from the peer Home Agent. When the command is deconfigured, the Home Agent can remove mobility bindings. The following describes how Home Agent redundancy operates on physical and virtual networks.

Physical network:

Only the active Home Agent will receive registrations. It updates the standby Home Agent. The standby Home Agent requests the mobility binding table from the active Home Agent. When Mobile IP standby is deconfigured, the standby Home Agent removes all bindings, but the active Home Agent keeps all bindings.

Virtual network:

Both active and standby Home Agents receive registrations if the loopback interface is used; each will update the peer after accepting a registration. Otherwise, the active Home Agent receives registrations. Both active and standby Home Agents request mobility binding tables from each other. When Mobile IP standby is deconfigured, the standby or active Home Agent removes all bindings.

Examples

The following is sample output from the ip mobile home-agent redundancy command that specifies an HSRP group name of SanJoseHA:

Router# ip mobile home-agent redundancy SanJoseHA

ip mobile home-agent reject-static-addr

To configure the HA to reject Registration Requests from MNs under certain conditions, use the ip mobile home-agent reject-static-addr sub-command under the ip mobile home-agent global configuration command.

ip mobile home-agent reject-static-addr

Syntax Description

This command has not arguments or keywords

Command Modes

Sub-command of the ip mobile home-agent global configuration command.

Command History

Release
Modification

12.2(8)BY

This command was introduced.


Usage Guidelines

You must first configure the ip mobile home-agent command to use this sub-command.

If an MN which has binding to the HA with a static address, and tries to register with the same static address again, then the HA rejects the second RRQ from MN.

Examples

The following example illustrates the ip mobile home-agent reject-static-addr command:

Router# ip mobile home-agent reject-static-addr

ip mobile home-agent resync-sa

To configure the HA to clear out the old cached security associations and requery the AAA server, use the ip mobile home-agent resync-sa command global configuration command.

ip mobile home-agent resync-sa x

Syntax Description

x

Specifies the time that the HA will use to initiate a resync.


Command Modes

Global configuration.

Command History

Release
Modification

12.1

This command was introduced.


Usage Guidelines

When a MN tries to reregister with the HA, the time change from the original timestamp is checked. If that time period is less than x, and the MN fails authentication, then the HA will not requery the AAA server for another SA.

If the MN reregisters with the HA, and the time between registrations is greater than x, and the MN fails registrations, then the HA will clear out the old SA and requery the AAA server.

Examples

The following example illustrates the ip mobile home-agent resync-sa command:

Router# ip mobile home-agent resync-sa 10

ip mobile home-agent revocation

To enable support for MIPv4 Registration Revocation on the HA, use the ip mobile home-agent revocation command in global configuration mode. Use the no form of the command to disable this feature.

ip mobile home-agent revocation [timeout 1-100] [retransmit 0-100] [timestamp msec]

no ip mobile home-agent revocation [timeout 1-100] [retransmit 0-100] [timestamp msec]

Syntax Description

timeout 1-100

(Optional) Configures the time interval (in seconds) between re-transmission of MIPv4 Registration Revocation Message. The no version restores the time interval between re-transmission of MIPv4 Registration Revocation Message to the default value. The default is 5 seconds.

retransmit 0-100

(Optional) Configures number of times MIPv4 Registration Revocation messages are retransmitted. The no version of this command restores the retransmit number to the default value. The default is 3 re-transmissions.

timestamp msec

(Optional) Configures the units in which the timestamp value in the revocation support extension and revocation message should be encoded. By default the timestamp value will be sent as seconds. If msec option is specified, the values will be encoded in milliseconds


Defaults

The timeout default setting is 5 seconds, the retransmit default setting is 3 retransmissions, and the default timestamp setting is seconds.

Command Modes

Global configuration.

Command History

Release
Modification

12.3(7)XJ.

This command was introduced.


Examples

The following example illustrates the ip mobile home-agent revocation command:

Router# (config)#ip mobile home-agent revoc timeout ?

<1-100> Wait time (default 3 secs)

Router# (config)#ip mobile home-agent revoc retransmit ?

<0-100> Number of retries for a transaction (default 3)

ip mobile host

To configure the mobile host or mobile node group, use the ip mobile host global configuration command. For PDSN, use this command to configure the static IP address or address pool for multiple flows with the same NAI.

ip mobile host {lower [upper] | nai string {static-address {addr1 [addr2] [addr3] [addr4] [addr5] | local-pool name} | address {addr | pool {local name | dhcp-proxy-client [dhcp-server addr]} {interface name | virtual-network network_address mask} [skip-chap | aaa [load-sa [permanent]] [authorized-pool pool][skip-aaa-reauthentication]] [care-of-access acl] [lifetime number]

no ip mobile host {lower [upper] | nai string {static-address {addr1 [addr2] [addr3] [addr4] [addr5] | local-pool name} | address {addr | pool {local name | dhcp-proxy-client [dhcp-server addr]} {interface name | virtual-network network_address mask} [skip-chap | aaa [load-sa [permanent]] [authorized-pool pool][skip-aaa-reauthentication]] [care-of-access acl] [lifetime number]

Syntax Description

lower [upper]

One or a range of mobile host or mobile node group IP addresses. The upper end of the range is optional.

nai string

Network access identifier. The NAI can be a unique identifier (username@realm) or a group identifier (realm).

static-address

Indicates that a static IP address is to be assigned to the flows on this NAI. This parameter is not valid if the NAI is a realm.

addr1, addr2, ...

(Optional) One or more IP addresses to be assigned using the static-address keyword.

local-pool name

Name of the local pool of addresses to use for assigning a static IP address to this NAI.

address

Indicates that a dynamic IP address is to be assigned to the flows on this NAI.

addr

IP address to be assigned using the address keyword.

pool

Indicates that pool of addresses is to be used in assigning a dynamic IP address.

local name

The name of the local pool to use in assigning addresses.

dhcp-proxy-client

Indicates that the pool should come from a DHCP client.

dhcp-server addr

IP address of the DHCP server.

interface name

Mobile node that belongs to the specified interface. When used with DHCP, this specifies the address pool from which the DHCP server should select the address.

virtual-network network_address mask

Indicates that the mobile station resides in the specified virtual network, which was created using the ip mobile virtual-network command.

skip chap

When skip-chap is configured, the Home Agent does not send Access Request to AAA for mobile IP registration requests.

aaa

(Optional) Retrieves security associations from a AAA (TACACS+ or RADIUS) server.

load-sa

(Optional) Stores security associations in memory after retrieval.

permanent

 

authorized-pool pool

Verifies the IP address assigned to the mobile if it is within the pool specified by pname.

skip-aaa-reauthentication

When configured, the Home Agent does not send Access Request for authentication for mobile IP re-registration requests. When disabled, the Home agent sends Access Request for all mobile IPregistration requests.

care-of-access acl

(Optional) Access list. This can be a string or number from 1 to 99. Controls where mobile nodes roam—the acceptable care-of addresses.

lifetime number

(Optional) Lifetime (in seconds). The lifetime for each mobile node (group) can be set to override the global value. Possible values are 3 through 65535.


Defaults

No host is configured.

Command Modes

Global configuration

Command History

Release
Modification

12.0(1)T

This command was introduced.

12.2(2)XC

The nai keyword and associated parameters were added.

12.2(8)ZB6

The skip-aaa-reauthentication and authorized-pool keywords were added.


Usage Guidelines

This command configures the mobile host or mobile node group (ranging from lower address to upper address) to be supported by the Home Agent. These mobile nodes belong to the network on an interface or a virtual network (via the ip mobile virtual-network command). The security association for each mobile host must be configured using the ip mobile secure command or downloaded from an AAA server. When using an AAA server, the router will attempt to download all security associations when the command is entered. If no security associations are retrieved, retrieval will be attempted when a registration request arrives or the clear ip mobile secure command is entered.

All hosts must have security associations for registration authentication. Mobile nodes can have more than one security association. The memory consumption calculations shown in Table A-7 are based on the assumption of one security association per mobile node.

The nai keyword allows you to specify a particular mobile station or range of mobile stations. The mobile station can request a static IP address (static-address keyword), which is configured using the addr1 variable (for a specific address) or the local-pool keyword (for an IP address from an address pool). Or, the mobile station can request a dynamic address (address keyword), which is configured using the addr variable (for a specific address) or the pool keyword (for an IP address from a pool or DHCP server). If this command is used with the PDSN proxy Mobile IP feature and a realm is specified in the ip mobile proxy-host nai command, then only a pool of addresses can be specified in this command.

The address pool can be defined by a local pool or using a DHCP proxy client. For DHCP, the interface name specifies the address pool from which the DHCP server selects and dhcp-server specifies DHCP server address.

Security associations can be stored using one of three methods:

On the router

On the AAA server, retrieve security association each time registration comes in

On the AAA server, retrieve and store security association

Each method has advantages and disadvantages, which are described in Table A-7

.

Table A-7 Methods for Storing Security Associations  

Storage Method
Advantage
Disadvantage

On the router

Security association is in router memory, resulting in fast lookup.

For Home Agents supporting fewer than 1500 mobile nodes, this provides optimum authentication performance and security (keys never leave router).

NVRAM of router is limited, cannot store many security associations. Each security association configuration takes about 80 bytes. For 125 KB NVRAM, you can store about 1500 security associations on a Home Agent.

On the AAA server, retrieve security association each time registration comes in

Central administration and storage of security association on AAA server.

If keys change constantly, administration is simplified to one server, latest keys always retrieved during registration.

Router memory (DRAM) is conserved. Router will only need memory to load in a security association, and then release the memory when done. Router can support unlimited number of mobile nodes.

Requires network to retrieve security association, slower than other storage methods, and dependent on network and server performance.

Multiple Home Agents that use one AAA server, which can become the bottleneck, can get slow response.

Key can be snooped if packets used to retrieve from AAA are not encrypted (for example, using RADIUS or unencrypted TACACS+ mode).

On the AAA server, retrieve and store security association

AAA acts as an offload configuration server, security associations are loaded into router DRAM, which is more abundant (for example, 16 MB, 32 MB, 64 MB) when the first registration comes in. Each security association takes only about 50 bytes of DRAM, so 10,000 mobile nodes will use up 0.5 MB.

If keys remain fairly constant, once security associations are loaded, Home Agent authenticates as fast as when stored on the router.

Only security associations that are needed are loaded into router memory. Mobile nodes that never register will not waste memory.

If keys change on the AAA server after the mobile node registered, then you need to use clear ip mobile secure command to clear and load in new security association from AAA, otherwise the security association of the router is stale.



Note With load-sa, the security association downloaded from AAA will be cached and stored in the HA so that no RADIUS requests are needed to download a security association for a mobile for renewal. To avoid going to AAA for authentication when mobile ip re-registration message (RRQ) is received, or during closure of session when RRQ(0) is received, use the skip-aaa-reauthentication option.


Examples

The following example configures a mobile node group to reside on virtual network 20.0.0.0 and store its security associations on the AAA server:

ip mobile host 20.0.0.1 20.0.0.3 virtual-network 20.0.0.0 aaa

The following example configures a local pool of dynamic addresses to be used in assigning IP addresses to mobile stations in the cisco.com domain.

ip mobile host nai @cisco.com address pool local mobilenodes virtual-network 9.0.0.0 
255.0.0.0 aaa lifetime 65535

The following example configures a local pool of static addresses to be used in assigning IP addresses to mobile stations in the cisco.com domain.

ip mobile host nai @cisco.com static-address local-pool mobilenodes

Related Commands

Command
Description

aaa authorization ipmobile

Authorizes Mobile IP to retrieve security associations from the AAA server using TACACS+ or RADIUS.

ip mobile secure

Specifies the mobility security associations for mobile host, visitor, Home Agent, and Foreign Agent.

show ip mobile host

Displays mobile station counters and information.

ip mobile proxy-host

Configures the proxy Mobile IP attributes of the PDSN.


ip mobile radius disconnect

To enable the processing Radius Disconnect messages on the HA, use the ip mobile radius disconnect command in global configuration mode. Use the no form of this command to disable processing Radius Disconnect messages on the HA.

ip mobile radius disconnect

no ip mobile radius disconnect

Syntax Description

There are no arguments or keywords for this command.

Defaults

The default setting is that there is no processing of Radius Disconnect messages.

Command Modes

Global configuration.

Command History

Release
Modification

12.3(7)XJ.

This command was introduced.


Usage Guidelines


Note In order for POD requests to be processed by AAA, you need to configure the aaa server radius dynamic-author command.



Note You must configure radius-server attribute 32 include-in-access-req for the HA to send the FQDN in Access Request


Examples

The following example illustrates the ip mobile radius disconnect command:

Router# 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. Use the no form of the command to disable this feature.

ip mobile realm @xyz.com vrf vrf-name ha-addr ip-address [aaa-group [accounting aaa-acct-group | authentication aaa-auth-group]]

no ip mobile realm ip mobile realm @xyz.com vrf vrf-name ha-addr ip-address [aaa-group [accounting aaa-acct-group]]

realm

Name of the realm o

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.


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.


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. 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 AAA accounting server group is defined, all accounting records for the users of the realm will be sent to the specified group. If AAA authentication server group is defined, HA-CHAP is sent to the server(s) defined in the group.

Examples

ip mobile secure

To specify the mobility security associations for the mobile host, visitor, Home Agent, Foreign Agent, and proxy host, use the ip mobile secure global configuration command. To remove the mobility security associations, use the no form of this command.

ip mobile secure {host lower-address [upper-address] | visitor address | home-agent address | foreign-agent address} {inbound-spi spi-in outbound-spi spi-out | spi spi} key hex string [replay timestamp [number] algorithm md5 mode prefix-suffix]

no ip mobile secure {host lower-address [upper-address] | visitor address | home-agent address | foreign-agent address} {inbound-spi spi-in outbound-spi spi-out | spi spi} key hex string [replay timestamp [number] algorithm md5 mode prefix-suffix]

Syntax Description

host

Security association of the mobile host on the Home Agent.

lower address

IP address of host, visitor, or mobility agent, or lower range of IP address pool.

upper-address

(Optional) Upper range of IP address pool.

visitor

Security association of the mobile host on the Foreign Agent.

home-agent

Security association of the remote Home Agent on the Foreign Agent.

foreign-agent

Security association of the remote Foreign Agent on the Home Agent.

address

IP address of visitor or mobility agent.

inbound-spi spi-in

Security parameter index used for authenticating inbound registration packets. Range is from 0x100 to 0xffffffff.

outbound-spi spi-out

Security parameter index used for calculating the authenticator in outbound registration packets. Range is from 0x100 to 0xffffffff.

spi spi

Bidirectional SPI. Range is from 0x100 to 0xffffffff.

key hex string

ASCII or hexadecimal string of values. No spaces are allowed.

replay

(Optional) Replay protection used on registration packets.

timestamp

(Optional) Used to validate incoming packets to ensure that they are not being "replayed" by a spoofer using timestamp method.

number

(Optional) Number of seconds. Registration is valid if received within the specified time. This means the sender and receiver are in time synchronization (NTP can be used).

algorithm

(Optional) Algorithm used to authenticate messages during registration.

md5

(Optional) Message Digest 5.

mode

(Optional) Mode used to authenticate during registration.

prefix-suffix

(Optional) The key is used to wrap the registration information for authentication (for example, key registration information key) to calculate the message digest.


Defaults

No security association is specified.

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.


Usage Guidelines

The security association consists of the entity address, SPI, key, replay protection method, authentication algorithm, and mode.

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, replay attack protection method, timeout, and IP address.

On a Home Agent, the security association of the mobile host is mandatory for mobile host authentication. If desired, configure a Foreign Agent security association on your Home Agent. On a Foreign Agent, the security association of the visiting mobile host and security association of the Home Agent are optional. Multiple security associations for each entity can be configured.

If registration fails because the timestamp value is out of bounds, the time stamp of the Home Agent is returned so the mobile node can reregister with the time-stamp value closer to that of the Home Agent, if desired.


Note NTP can be used to synchronize time for all parties.


Examples

The following example shows mobile node 20.0.0.1, which has a key that is generated by the MD5 hash of the string:

Router# ip mobile secure host 20.0.0.1 spi 100 key hex 12345678123456781234567812345678

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.

show ip mobile secure

Displays the mobility security associations for mobile host, mobile visitor, Foreign Agent, or Home Agent.

ip mobile proxy-host

Configures the proxy Mobile IP attributes of the PDSN.


ip mobile tunnel

To specify the settings of tunnels created by Mobile IP, use the ip mobile tunnel interface configuration command.

ip mobile tunnel {crypto map map-name | route-cache | path-mtu-discovery | nat {inside | outside}}

Syntax Description

crypto map

Enables encryption/decryption on new tunnels.

map-name

Specifies the name of the crypto map.

route-cache

Sets tunnels to default or process switching mode.

path-mtu-discovery

Specifies when the tunnel MTU should expire if set by Path MTU Discovery.

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.


Defaults

Disabled.

Command Modes

Global configuration.

Command History

Release
Modification

12.0(1)T

This command was introduced.


Usage Guidelines

Path MTU discovery is used by end stations to find a packet size that does not need fragmentation between them. Tunnels have to adjust their MTU to the smallest MTU interior to achieve this. This is described in RFC 2003.

The discovered tunnel MTU should be aged out periodically to possibly recover from case where sub-optimum MTU existed at time of discovery. It is reset to the outgoing interface's MTU.

Examples

The following example sets the discovered tunnel MTU to expire in ten minutes:

Router# ip mobile tunnel reset-mtu-time 600

ip mobile virtual-network

To define a virtual network, use the ip mobile virtual-network global configuration command. To remove the virtual network, use the no form of this command.

ip mobile virtual-network net mask [address addr]

no ip mobile virtual-network net mask [address addr]

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 addr

(Optional) 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 was 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 HA IP address is configured on the loopback interface for that virtual network:

Router# ip mobile virtual-network

int e0 
 ip addr 1.0.0.1 255.0.0.0
 standby ip 1.0.0.10
 standby name SanJoseHA

int lo0
 ip addr 20.0.0.1 255.255.255.255

ip mobile home-agent
 ip mobile virtual-network 20.0.0.0 255.255.0.0 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

radius-server attribute 32 include-in-access-req

To send RADIUS attribute 32 (NAS-Identifier) in an access-request or accounting-request, use the radius-server attribute 32 include-in-access-req global configuration command. To disable sending RADIUS attribute 32, use the no form of this command.

radius-server attribute 32 include-in-access-req [format]

no radius-server attribute 32 include-in-access-req

Syntax Description

format

(Optional) A string sent in attribute 32 containing an IP address (%i), a hostname (%h), or a domain name (%d).


Defaults

RADIUS attribute 32 is not sent in access-request or accounting-request packets.

Command Modes

Global configuration.

Command History

Release
Modification

12.1T

This command was introduced.


Usage Guidelines

Using the radius-server attribute 32 include-in-access-req makes it possible to identify the network access server (NAS) manufacturer to the RADIUS server by sending RADIUS attribute 32 (NAS-Identifier) in an access-request or accounting-request. If you configure the format argument, the string sent in attribute 32 will include an IP address, a hostname, or a domain name; otherwise, the Fully Qualified Domain Name (FQDN) is sent by default.

Examples

The following example shows a configuration that sends RADIUS attribute 32 in the access-request with the format configured to identify a Cisco NAS:

router (config)# radius-server attribute 32 include-in-access-req format cisco %h.%d %i

! The following string will be sent in attribute 32 (NAS-Identifier). 

"cisco router.nlab.cisco.com 10.0.1.67"

radius-server host

To specify a RADIUS server host, use the radius-server host command in global configuration mode. To delete the specified RADIUS host, use the no form of this command.

radius-server host {hostname | ip-address} [auth-port port-number] [acct-port port-number] [timeout seconds] [retransmit retries] [key string] [alias {hostname | ip-address}]

no radius-server host {hostname | ip-address} [auth-port port-number] [acct-port port-number] [timeout seconds] [retransmit retries] [key string] [alias {hostname | ip-address}]

Syntax Description

hostname

Domain Name System (DNS) name of the RADIUS server host.

ip-address

IP address of the RADIUS server host.

auth-port

(Optional) Specifies the UDP destination port for authentication requests.

port-number

(Optional) Port number for authentication requests; the host is not used for authentication if set to 0. If unspecified, the port number defaults to 1645.

acct-port

Optional) Specifies the UDP destination port for accounting requests.

port-number

(Optional) Port number for accounting requests; the host is not used for accounting if set to 0. If unspecified, the port number defaults to 1646.

timeout

(Optional) The time interval (in seconds) that the router waits for the RADIUS server to reply before retransmitting. This setting overrides the global value of the radius-server timeout command. If no timeout value is specified, the global value is used. Enter a value in the range 1 to 1000.

seconds

Optional) Specifies the timeout value. Enter a value in the range 1 to 1000. If no timeout value is specified, the global value is used.

retransmit

(Optional) The number of times a RADIUS request is re-sent to a server, if that server is not responding or responding slowly. This setting overrides the global setting of the radius-server retransmit command.

retries

(Optional) Specifies the retransmit value. Enter a value in the range 1 to 100. If no retransmit value is specified, the global value is used.

key

(Optional) Specifies the authentication and encryption key used between the router and the RADIUS daemon running on this RADIUS server. This key overrides the global setting of the radius-server key command. If no key string is specified, the global value is used.

The key is a text string that must match the encryption key used on the RADIUS server. Always configure the key as the last item in the radius-server host command syntax. This is because the leading spaces are ignored, but spaces within and at the end of the key are used. If you use spaces in the key, do not enclose the key in quotation marks unless the quotation marks themselves are part of the key.

string

(Optional) Specifies the authentication and encryption key for all RADIUS communications between the router and the RADIUS server. This key must match the encryption used on the RADIUS daemon. All leading spaces are ignored, but spaces within and at the end of the key are used. If you use spaces in your key, do not enclose the key in quotation marks unless the quotation marks themselves are part of the key.

alias

(Optional) Allows up to eight aliases per line for any given RADIUS server.


Defaults

The auth-port port number defaults to 1645; the acct-port port number defaults to 1646.

Command Modes

Global configuration

Command History

Release