The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes the Proxy Mobile IPv6 (PMIPv6) feature.
The Proxy Mobile IPv6 (PMIPv6) feature is a network-based mobility management protocol that provides mobility without requiring the participation of the mobile node in any PMIPv6 mobility related signaling. The core functional entities Mobile Access Gateway (MAG) and the Local Mobility Anchor (LMA), set up tunnels dynamically to manage mobility for a mobile node.
The PMIPv6 Heartbeat or Path management mechanism through Heartbeat messages between the MAG and LMA is important to know the reachability of the peers, to detect failures, quickly inform peers in the event of a recovery from node failures, and allow a peer to take appropriate action.
The PMIP Heartbeat feature support on HSGW/MAG and P-GW/LMA is based on RFC 5847.
The MAG and the LMA exchange Heartbeat messages at regular intervals to detect the current status of reachability between the two of them. The MAG initiates the heartbeat exchange to test if the LMA is reachable by sending a Heartbeat Request message to the LMA. Each Heartbeat Request contains a sequence number that is incremented monotonically. Heartbeat Request messages are sent to LMA only if the MAG has at least one PMIPv6 session with a corresponding LMA. Similarly, the LMA also initiates a heartbeat exchange with the MAG by sending a Heartbeat Request message to check if the MAG is reachable.
Refer to the heartbeat CLI command in the LMA Service mode or MAG Service mode respectively to enable this heartbeat and configure the heartbeat variables.
The heartbeat messages are used only for checking reachability between the MAG and the LMA. They do not carry information that is useful for eavesdroppers on the path. Therefore, confidentiality protection is not required.
The sequence number sent in the Heartbeat Request message is matched when the Heartbeat response is received at the MAG/LMA. Before sending the next Heartbeat Request, the missing heartbeat counter is incremented if it has not received a Heartbeat Response for the previous request.
When the missing heartbeat counter exceeds the configurable parameter max-heartbeat-retransmission, the MAG/LMA concludes that the peer is not reachable. The heartbeat request to the peer will be stopped and a notification trap is triggered to indicate the failure.
If a heartbeat response message is received, then the missing heartbeat counter is reset.
The starPMIPPathFailure trap is cleared and the periodic heartbeat starts when the heartbeat request is received or when a new session is established from the corresponding peer.
MAG/LMA generates restart counter when the service is started. This counter is generated based on the service start timestamp. The restart counter is stored as part of the config and it is incremented whenever the service is restarted. The counter is not incremented if the sessions are recovered properly after a crash. MAG/LMA includes the restart counter mobility option in a heartbeat response message to indicate the current value of the restart counter. MAG/LMA also stores the restart counter values of all the peers with which it currently has PMIPv6 sessions.
After receiving the Heartbeat Response message, MAG/LMA compares the Restart Counter value with the previously received value. If the value is different, then it assumes that the peer had crashed and recovered. If the restart counter value changes or if there was no previously stored values, then the new value is stored for the corresponding peer.
The second heartbeat request in the Restart Detection figure is shown as a dashed arrow because the restart detection can happen even when an unsolicited heartbeat response is received with a change in restart counter.
The starPMIPPathFailure trap is cleared when the Heartbeat request is received or when a new session is established with the corresponding peer.
The PMIPv6 Heartbeat functionality complies with the following standards:
RFC 5847 (June 2010): Heartbeat Mechanism for Proxy Mobile IPv6
3GPP TS 29.275 Proxy Mobile IPv6 (PMIPv6) based Mobility and Tunnelling protocols Stage 3
The configuration examples in this section can be used to control the heartbeat messages interval and retransmission timeout and max retransmission.
The following command configures the PMIPv6 heartbeat message interval and retransmission timeout and max retransmission for the MAG/HSGW Service.
configure context context_name mag-service hsgw_svc_name heartbeat { interval seconds | retransmission { max number | timeout seconds } } default heartbeat { interval | retransmission { max | timeout } } no heartbeat end
Notes:
interval: The interval in seconds at which heartbeat messages are sent from 30-3600 seconds. Default: 60 seconds.
retransmission max: The maximum number of heartbeat retransmissions allowed from 0-15. Default: 3.
retransmission timeout: The timeout in seconds for heartbeat retransmissions from 1-20 seconds. Default: 3 seconds.
The following command configures the PMIPv6 heartbeat message interval, retransmission timeout, and max retransmission for the LMA/P-GW Service.
configure context context_name lma-service pgw_lma_name heartbeat { interval seconds | retransmission { max number | timeout seconds } } default heartbeat { interval | retransmission { max | timeout } } no heartbeat end
Notes:
interval: The interval in seconds at which heartbeat messages are sent.
seconds must be an integer from 30 to 2600. Default: 60
retransmission max: The maximum number of heartbeat retransmissions allowed.
number must be an integer from 0 to 15.
Default: 3
retransmission timeout: The timeout in seconds for heartbeat retransmissions.
seconds must be an integer from 1 to 20.
Default: 3
The following show commands can be used to verify the configured heartbeat configuration.
Heartbeat support: Enabled Heartbeat Interval: 60 Heartbeat Retransmission Timeout: 5 Heartbeat Max Retransmissions: 5
Heartbeat support: Enabled Heartbeat Interval: 60 Heartbeat Retransmission Timeout: 5 Heartbeat Max Retransmissions: 5
This section includes show commands in support of the PMIPv6 Heartbeat, traps that are triggered by the MAGMGR/HAMGR after path failure and Heartbeat bulk statistics.
PMIPv6 Heartbeat messages can be monitored using monitor protocol. HAMGR and MAGMGR log messages can be enabled to troubleshoot and debug PMIPv6 Heartbeat scenarios.
SNMP traps are generated on failure detection and restart detection. The traps can be enabled to know path failure or node restart
Heartbeat message statistics and path failure statistics on MAG and LMA can be used to troubleshoot and debug PMIPv6 Heartbeat scenarios.
This section provides information regarding show commands and/or their outputs in support of the PMIPv6 Heartbeat.
This show command displays heartbeat output similar to the following for heartbeat statistics.
Path Management Messages: Heartbeat Request: Total TX: 0 Total RX: 0 Initial TX: 0 Initial RX: 0 Retrans TX: 0 Heartbeat Response: Total TX: 0 Total RX: 0 Bind Error: 0 Heartbeat Messages Discarded: Total: 0 Decode error: 0 Invalid Buffer Length: 0 Heartbeat Rsp From Unknown Peer: 0 Heartbeat Rsp Seq. Num Mismatch: 0 Reasons for path failure: Restart counter change: 0 No Heartbeat Response received: 0 Total path failures detected: 0
This show command displays heartbeat output similar to the following for heartbeat statistics.
Path Management Messages: Heartbeat Request: Total TX: 0 Total RX: 0 Initial TX: 0 Initial RX: 0 Retrans TX: 0 Heartbeat Response: Total TX: 0 Total RX: 0 Bind Error: 0 Heartbeat Messages Discarded: Total: 0 Decode error: 0 Invalid Buffer Length: 0 Heartbeat Rsp From Unknown Peer: 0 Heartbeat Rsp Seq. Num Mismatch: 0 Reasons for path failure: Restart counter change: 0 No Heartbeat Response received: 0 Total path failures detected: 0
The trap name is starPMIPPathFailure.
The following trap notifications are triggered by the MAGMGR/HAMGR when path failure or node restart is detected.
The trap name is starPMIPPathFailureClear.
The following trap notifications are generated by MAGMGR/HAMGR to clear the Path Failure Trap when a node is responding for heartbeat messages.
The following Schema bulk statistics have been introduced for the PMIPv6 Heartbeat feature:
The following bulkstats have been added for PMIPv6 heartbeat statistics:
For descriptions of these variables, see "MAG Schema Statistics" in the Statistics and Counters Reference.
The following bulkstats have been added for PMIPv6 heartbeat statistics:
For descriptions of these variables, see "LMA Schema Statistics" in the Statistics and Counters Reference.