Implementing the Dynamic Host Configuration Protocol

This module describes the concepts and tasks you will use to configure Dynamic Host Configuration Protocol (DHCP).

Feature History for Implementing the Dynamic Host Configuration Protocol

Release

Modification

Release 5.0.0

This feature was introduced.

Release 7.6.3

DHCP Proxy on PWHE Interfaces is added.

Prerequisites for Configuring DHCP Relay Agent

The following prerequisites are required to configure a DHCP relay agent:

  • You must be in a user group associated with a task group that includes the proper task IDs. The command reference guides include the task IDs required for each command. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

  • A configured and running DHCP client and DHCP server

  • Connectivity between the relay agent and DHCP server

Information About DHCP Relay Agent

A DHCP relay agent is a host that forwards DHCP packets between clients and servers that do not reside on a shared physical subnet. Relay agent forwarding is distinct from the normal forwarding of an IP router where IP datagrams are switched between networks transparently.

DHCP clients use User Datagram Protocol (UDP) broadcasts to send DHCPDISCOVER messages when they lack information about the network to which they belong.

If a client is on a network segment that does not include a server, a relay agent is needed on that network segment to ensure that DHCP packets reach the servers on another network segment. UDP broadcast packets are not forwarded, because most routers are not configured to forward broadcast traffic. You can configure a DHCP relay profile and configure one or more helper addresses in it. You can assign the profile to an interface.

Forwarding UDP Broadcasts to a DHCP Server Using a Helper Address demonstrates the process. The DHCP client broadcasts a request for an IP address and additional configuration parameters on its local LAN. Acting as a DHCP relay agent, Router B picks up the broadcast, changes the destination address to the DHCP server's address and sends the message out on another interface. The relay agent inserts the IP address of the interface, on which the into the gateway address (giaddr) field of the DHCP packet, which enables the DHCP server to determine which subnet should receive the offer and identify the appropriate IP address range. The relay agent unicasts the messages to the server address, in this case 172.16.1.2 (which is specified by the helper address in the relay profile).

Figure 1. Forwarding UDP Broadcasts to a DHCP Server Using a Helper Address

How to Configure and Enable DHCP Relay Agent

This section contains the following tasks:

Configuring and Enabling DHCP Relay Agent with DHCP MAC Address Verification

This section discusses how to configure and enable DHCP Relay Agent with DHCP MAC address verification.

Configuration Example

Router# configure

Router(config)# dhcp ipv4
/* Configures DHCP for IPv4 and enters the DHCPv4 configuration submode. */

Router(config-dhcpv4)# profile client relay
/* Enables DHCP relay profile */

Router(config-dhcpv4)# client-mac-mismatch action drop
/* Enables MAC address verification. If MAC address in the DHCPv4 protocol header does not match the L2 header source MAC address in the DHCPv4 relay profile,
 the frame is dropped  */

Router(config-dhcpv4-relay-profile)# relay information option
/* Inserts the DHCP relay agent information option (option-82 field) in forwarded 
BOOTREQUEST messages to a DHCP server. */

Router(config-dhcpv4-relay-profile)# relay information check
/* (Optional) Configures DHCP to check the validity of the relay agent information 
option in forwarded BOOTREPLY messages. */

Router(config-dhcpv4-relay-profile)# relay information policy drop
/* (Optional) Configures the reforwarding policy for a DHCP relay agent; 
that is, whether the relay agent will drop or keep (using the 'keep' keyword)
 the relay information. */

Router(config-dhcpv4-relay-profile)# relay information option allow-untrusted
/* (Optional) Configures the DHCP IPv4 Relay not to discard BOOTREQUEST packets that have an existing 
relay information option and the giaddr set to zero. */

Router(config-dhcpv4-relay-profile)# giaddr policy drop
/* Drops the packet that has an existing nonzero giaddr value. Use the 'replace' keyword
 to replace the existing giaddr value with a value that it generates (the default behavior).  */

Router(config-dhcpv4-relay-profile)# helper-address vrf vrf1 10.1.1.1
/* Forwards UDP broadcasts, including DHCP. */

Router(config-dhcpv4-relay-profile)# commit

Router(config-dhcpv4-relay-profile)# exit
Router(config-dhcpv4)# vrf vrf1 relay profile client
Router(config-dhcpv4)# commit
/* Configures DHCP Relay on a VRF and commits the entire configuration. */

Running Configuration

Confirm your configuration.

Router# show run
Thu May 11 09:00:57.839 IST
Building configuration...
!! IOS XR Configuration 0.0.0
!! Last configuration change at Thu May 11 09:00:54 2017 by annseque
!
dhcp ipv4
vrf vrf1 relay profile client
profile client relay
client-mac-match action drop
helper-address vrf vrf1 10.1.1.1
giaddr policy drop
relay information check
relay information option
relay information policy drop
relay information option allow-untrusted
!
!

DHCP MAC Address Verification

Use the following show command to check if DHCP MAC address is being verified on the router.

Router# show dhcp ipv4 relay statistics raw all
packet_drop_mac_mismatch                      :         0

The output validates that the DHCP MAC address of the packets is verified.

Enabling DHCP Relay Agent on an Interface

This task describes how to enable the Cisco IOS XR DHCP relay agent on an interface.


Note


On Cisco IOS XR software, the DHCP relay agent is disabled by default.


SUMMARY STEPS

  1. configure
  2. dhcp ipv4
  3. interface type interface-path-id relay profile profile-name
  4. commit

DETAILED STEPS

  Command or Action Purpose

Step 1

configure

Step 2

dhcp ipv4

Example:


RP/0/RP0/CPU0:router(config)# dhcp ipv4 

Enters DHCP IPv4 configuration submode.

Step 3

interface type interface-path-id relay profile profile-name

Example:


RP/0/RP0/CPU0:router(config-dhcpv4)# interface 
/0 relay profile client

Attaches a relay profile to an interface.

Step 4

commit

Disabling DHCP Relay on an Interface

This task describes how to disable the DHCP relay on an interface by assigning the none profile to the interface.

SUMMARY STEPS

  1. configure
  2. dhcp ipv4
  3. interface type interface-path-id none
  4. commit

DETAILED STEPS

  Command or Action Purpose

Step 1

configure

Step 2

dhcp ipv4

Example:


RP/0/RP0/CPU0:router(config)# dhcp ipv4

Enters DHCP IPv4 configuration submode.

Step 3

interface type interface-path-id none

Example:


RP/0/RP0/CPU0:router(config-dhcpv4-relay-profile)# interface 
0/1/4/1 none

Disables the DHCP relay on the interface.

Step 4

commit

Configuring the Relay Agent Information Feature

This task describes how to configure the DHCP relay agent information option processing capabilities.

A DHCP relay agent may receive a message from another DHCP relay agent that already contains relay information. By default, the relay information from the previous relay agent is replaced (using the replace option).

SUMMARY STEPS

  1. configure
  2. dhcp ipv4
  3. profile profile-name relay
  4. relay information option
  5. relay information check
  6. relay information policy {drop | keep}
  7. relay information option allow-untrusted
  8. commit

DETAILED STEPS

  Command or Action Purpose

Step 1

configure

Step 2

dhcp ipv4

Example:


RP/0/RP0/CPU0:router(config)# dhcp ipv4

Enters DHCP IPv4 configuration .

Step 3

profile profile-name relay

Example:


RP/0/RP0/CPU0:router(config-dhcpv4)# profile client relay

Enters DHCP IPv4 profile relay .

Step 4

relay information option

Example:


RP/0/RP0/CPU0:router(config-dhcpv4-relay-profile)# relay information option

Enables the system to insert the DHCP relay agent information option (option-82 field) in forwarded BOOTREQUEST messages to a DHCP server.

  • This option is injected by the relay agent while forwarding client-originated DHCP packets to the server. Servers recognizing this option can use the information to implement IP address or other parameter assignment policies. When replying, the DHCP server echoes the option back to the relay agent. The relay agent removes the option before forwarding the reply to the client.

  • The relay agent information is organized as a single DHCP option that contains one or more suboptions. These options contain the information known by the relay agent.

    The supported suboptions are:

    • Remote ID

    • Circuit ID

Note

 

This function is disabled by default.

Step 5

relay information check

Example:


RP/0/RP0/CPU0:router(config-dhcpv4-relay-profile)# relay information check

(Optional) Configures DHCP to check the relay agent information option in forwarded BOOTREPLY is

  • By default, DHCP the field in DHCP reply packets, received from the DHCP server.

Note

 

Use the relay information check command to reenable this functionality if the functionality has been disabled.

Step 6

relay information policy {drop | keep}

Example:


RP/0/RP0/CPU0:router(config)# dhcp relay information policy drop

(Optional) Configures the reforwarding policy for a DHCP relay agent; that is, whether the relay agent will drop or keep the relay information.

Step 7

relay information option allow-untrusted

Example:


RP/0/RP0/CPU0:router(config-dhcpv4-relay-)# relay information 

(Optional) Configures the DHCP IPv4 Relay not to discard packets that have an existing relay information option and the giaddr set to zero.

Step 8

commit

Configuring Relay Agent Giaddr Policy

This task describes how to configure for that already contain a nonzero giaddr attribute.

SUMMARY STEPS

  1. configure
  2. dhcp ipv4
  3. profile relay
  4. giaddr policy {replace | drop}
  5. commit

DETAILED STEPS

  Command or Action Purpose

Step 1

configure

Step 2

dhcp ipv4

Example:


RP/0/RP0/CPU0:router(config)# dhcp ipv4

Enables the DHCP IPv4 configuration submode.

Step 3

profile relay

Example:


RP/0/RP0/CPU0:router(config-dhcpv4)# profile client relay

Enables profile relay submode.

Step 4

giaddr policy {replace | drop}

Example:


RP/0/RP0/CPU0:router(config-dhcpv4-relay-profile)# giaddr policy drop

Specifies the giaddr policy.

  • replaceReplaces the existing giaddr value with a value that it generates.

  • dropDrops the packet that has an existing nonzero giaddr value.

Step 5

commit

Configuring a DHCP Proxy Profile

The DHCP proxy performs all the functions of a relay and also provides some additional functions. The DHCP proxy conceals DHCP server details from DHCP clients. The DHCP proxy modifies the DHCP replies such that the client considers the proxy to be the server. In this state, the client interacts with the proxy as if it is the DHCP server.

This task describes how to configure and enable the DHCP proxy profile.

SUMMARY STEPS

  1. configure
  2. dhcp ipv4
  3. profile profile-name proxy
  4. helper-address address [ giaddr gateway-address ]
  5. commit

DETAILED STEPS

  Command or Action Purpose

Step 1

configure

Step 2

dhcp ipv4

Example:


RP/0/RP0/CPU0:router(config)# dhcp ipv4

Enters DHCP IPv4 configuration .

Step 3

profile profile-name proxy

Example:


RP/0/RP0/CPU0:router(config-dhcpv4)# profile client proxy

Enters DHCP IPv4 profile proxy submode.

Step 4

helper-address address [ giaddr gateway-address ]

Example:


RP/0/RP0/CPU0:router(config-dhcpv4-proxy-profile)# helper-address  
10.10.1.1

Forwards UDP broadcasts, including DHCP.

  • The value of the address argument can be a specific DHCP server address or a network address (if other DHCP servers are on the destination network segment). Using the network address enables other servers to respond to DHCP requests.

  • For multiple servers, configure one helper address for each server.

Step 5

commit

DHCPv4 Client

The Dynamic Host Configuration Protocol (DHCP) client functionality enables the router interfaces to dynamically acquire the IPv4 address using DHCP.

The DHCP provides configuration parameters to Internet hosts. DHCP consists of two components:
  • a protocol to deliver host-specific configuration parameters from a DHCP server to a host.
  • a mechanism to allocate network addresses to hosts.

DHCP is built on a client-server model, where designated DHCP server hosts allocate network addresses, and deliver configuration parameters to dynamically configured hosts.

A relay agent is required if the client and server are not on the same Layer 2 network. The relay agent usually runs on the router, and is required because the client device does not know its own IP address initially. The agent sends out a Layer 2 broadcast to find a server that has this information. The router relays these broadcasts to the DHCP server, and forwards the responses back to the correct Layer 2 address so that the correct device gets the correct configuration information.

DHCP has the ability to allocate IP addresses only for a configurable period of time, called the lease period. If the client is required to retain this IP address for a longer period beyond the lease period, the lease period must be renewed before the IP address expires. The client renews the lease based on configuration that was sent from the server. The client unicasts a REQUEST message using the IP address of the server. When a server receives the REQUEST message and responds with an ACK message. The lease period of the client is extended by the lease time configured in the ACK message.

Restrictions and Limitations

  • DHCP client can be enabled only on management interfaces.
  • Either DHCP or static IP can be configured on an interface.

Enabling DHCP Client on an Interface

The DHCPv4 or DHCPv6 client can be enabled at an interface level. The DHCP component receives a notification when DHCPv4 or DHCPv6 is enabled or disabled on an interface.

Router# configure
Router(config)# interface MgmtEth rack/slot/CPU0/port
Router(config)# interface interface_name ipv6 address dhcp  

Configuration Examples for the DHCP Relay Agent

This section provides the following configuration examples:

DHCP Relay Profile: Example

The following example shows how to configure the Cisco IOS XR relay profile:


dhcp ipv4 
 profile client relay
  helper-address  foo 10.10.1.1
 !        
! ...

DHCP Relay on an Interface: Example

The following example shows how to enable the DHCP relay agent on an interface:


dhcp ipv4
 interface HundredGigE 0/1/1/0 relay profile client
!

Relay Agent Information Option Support: Example

The following example shows how to enable the relay agent and the insertion and removal of the DHCP relay information option:


dhcp ipv4
 profile client relay
relay information 

 !
!

Relay Agent Giaddr Policy: Example

The following example shows how to configure relay agent giaddr policy:


dhcp ipv4
 profile client relay
  giaddr policy drop
 !
!

Cisco IOS XR Broadcast Flag Policy: Example

The following example shows how to configure Cisco IOS XR broadcast flag policy:


dhcp ipv4
profile client relay
broadcast-flag policy check
!

DHCP Proxy on PWHE Interfaces

Table 1. Feature History Table

Feature Name

Release Information

Description

DHCP Proxy on Pseudowire Headend Interfaces

Release 7.6.3

The DHCP proxy functionality is now available on the Pseudowire Headend (PWHE) interfaces. By using PWHE as a proxy in the DHCP process, this feature provides enhanced security for DHCP servers by preventing them from directly receiving client requests, and protecting the DHCP server from external attacks, such as Denial of Service (DoS). Also, because the DHCP-proxy functionality is enabled and centralised at the Service-side-PE (Provider Edge) devices, it simplifies the on-premise network management solutions.

The feature introduces these changes:

YANG Data Model:

New XPaths for:
  • platforms/panini/plat_mdata/scripts/role_mdata.pl

Overview of DHCP Proxy on PWHE Interfaces

The DHCP on PWHE interfaces feature enables you to configure the DHCP functionality, such as DHCP server, relay, or proxy on the PWHE interface. The Cisco IOS XR Release 7.6.3 introduces the DHCP proxy functionality.

The DHCP proxy conceals DHCP server details from DHCP clients and modifies the DHCP replies such that the client considers the proxy to be the server. In this state, the client interacts with the proxy as if it is the DHCP server. Because this functionality is enabled and centralised at the Service-side-PE (Provider Edge) devices, the costs are lower by eliminating the need for an extra Layer 3 (L3) router at your branch site, and simplifying the on-premise solutions.


Note


This feature is only supported on the Cisco IOS XR 64-Bit operating system.

Some of the key benefits of the DHCP proxy services are:

  • It minimizes the L3 devices needed at the end-customer premises, leading to lower costs.

  • It simplifies the connectivity of enterprise branch sites requiring LAN DHCP services from their service provider.

Consider a topology, where:

  • You have an ASR 9000 router facing the access side, also known as the Access-side Provider Edge (A-PE). And an NCS 6000 router facing the core side, also known as Service-side Provider Edge (S-PE).

  • You create a PWHE tunnel between these two routers. The PWHE tunnel originates at L2 on the ASR 9000 router and terminates at L3 on the NCS 6000 router

  • Then, configure EVPN-VPWS cross-connect between the NCS 6000 router and the ASR 9000 router

You can configure the NCS 6000 router as a DHCP proxy on the PWHE main interface or sub-interface.

The access-side router carries the traffic in its native form; that is, Ethernet frames with or without VLAN tagging, depending on whether you are creating a VLAN-based pseudowire or an Ethernet-based pseudowire.

Figure 2. DHCP Proxy Functionality for PWHE Interfaces

If you configure the NCS 6000 router as a DHCP server on the PWHE interface, it processes the request received from the DHCP client. The DHCP server accepts address assignment requests and renewals, and assigns the IP addresses from predefined groups of addresses contained within Distributed Address Pools (DAPS). You can also configure the DHCP server to provide additional information to the requesting client, such as subnet mask, domain-name, the IP address of the DNS server, the default router, and other configuration parameters.

If you configure the NCS 6000 router as a DHCP proxy on the PWHE interface, it forwards the request received from the DHCP client to the remote server. The remote server processes the request and provides information back to the DHCP proxy server.


Note


This feature supports both DHCP IPv4 and IPv6 addresses.


Configure DHCP on Pseudowire Headend

To configure DHCP on Pseudowire Headend feature, perform the following tasks:

  • Configure PWHE on Service-side Provider Edge (S-PE) and Access-side Provide Edge (A-PE)

  • Configure DHCP on S-PE

Configure PWHE on both S-PE and A-PE

This section describes how you can configure pseudowire headend on both S-PE and A-PE.

S-PE Configuration

/* S-PE Configuration */

Router# configure
Router(config)# generic-interface-list pwhe-list-pwhe2
Router(config-gen-if-list)# interface pw-ether 2
Router(config-gen-if-list)# exit
Router# configure 
Router(config)# interface pw-ether 2 
Router(config-if)# ipv4 address 10.0.0.1 255.0.0.0
Router(config-if)# attach generic-interface-list pwhe-list-pwhe2
Router(config-if)# exit
Router# configure 
Router(config)# l2vpn 
Router(config-l2vpn)# xconnect group evpn_vpws
Router(config-l2vpn-xc)# p2p vpws_1
Router(config-l2vpn-xc-p2p)# PW-Ether2
Router(config-l2vpn-xc-p2p-pw)# neighbor evpn evi 25 target 200 source 100
Router(config-l2vpn-xc-p2p-pw)# exit
Router(config)# generic-interface-list pwhe2
Router(config-gen-if-list)#  interface TenGigE0/4/0/6/1

A-PE Configuration

/* A-PE Configuration */

Router# configure 
Router(config)# interface TenGigE0/0/0/0 l2transport 
Router(config-subif)# encapsulation dot1q 1001
Router(config-subif)# rewrite ingress tag pop 1 symmetric
Router(config-subif)# exit
Router# configure 
Router(config)# l2vpn 
Router(config-l2vpn)# xconnect group evpn_vpws
Router(config-l2vpn-xc)# p2p vpws_1
Router(config-l2vpn-xc-p2p)# interface TenGigE0/4/0/4/2
Router(config-l2vpn-xc-p2p-pw)# neighbor evpn evi 25 target 100 source 200

Running Configuration

This section shows pseudowire headend running configuration.

/* On S-PE */

configure
 generic-interface-list pwhe-list-pwhe2
  interface pw-ether 2
  
  !

 interface pw-ether 2
  ipv4 address 10.0.0.1 255.0.0.0
  attach generic-interface-list pwhe-list-pwhe2

!


l2vpn
 xconnect group evpn_vpws
  p2p vpws_1
   interface pw-ether 2
   neighbor evpn evi 25 target 200 source 100
   !
generic-interface-list pwhe2
 interface TenGigE0/4/0/6/2


-------------------------------------------------------------------------------------------------------------------------------------

/* On A-PE */

configure
 interface TenGigE0/0/0/0 l2transport
  encapsulation dot1q 1001
  rewrite ingress tag pop 1 symmetric
!
!
l2vpn
 xconnect group evpn_vpws
  p2p vpws_1
   interface TenGigE0/4/0/4/2
   neighbor evpn evi 25 target 100 source 200
   !
!

Verification

The show command outputs given in this section display the details of the configuration of PW Ethernet interface and cross-connect, and the status of their configuration.



Router#  show l2vpn xconnect

Legend: ST = State, UP = Up, DN = Down, AD = Admin Down, UR = Unresolved,
        SB = Standby, SR = Standby Ready, (PP) = Partially Programmed

XConnect                   Segment 1                       Segment 2                
Group      Name       ST   Description            ST       Description            ST    
------------------------   -----------------------------   -----------------------------
evpn_vpws  vpws_1     UP   PE2                    UP       EVPN 25,172.16.0.1   UP    

-------------------------------------------------------------------------------------------------------------------------------------

Configure DHCP Proxy

Perform these tasks to configure DHCP proxy on PWHE interface.


Router# configure 
Router(config)# dhcp ipv4 
Router(config-dhcpv4)# profile prox1 proxy
Router(config-dhcpv4-proxy-profile)# helper-address vrf default 10.0.0.1 giaddr 0.0.0.0
Router(config-dhcpv4-proxy-profile)# relay information check
Router(config-dhcpv4-proxy-profile)# relay information option
Router(config-dhcpv4-proxy-profile)# relay information option allow-untrusted
Router(config-dhcpv4-proxy-profile)# exit
Router(config-dhcpv4)#interface PW-Ether2.201 proxy profile prox
Router(config-dhcpv4)#interface PW-Ether2.202 proxy profile prox
Router(config-dhcpv4)#commit
Running Configuration

This section shows DHCP proxy running configuration.


configure
 dhcp ipv4
  profile prox1 proxy
   helper-address vrf default 10.0.0.1 giaddr 0.0.0.0
   relay information check
   relay information option
   relay information option allow-untrusted
 !
 !

 interface PW-Ether2.101 proxy profile prox
 interface PW-Ether2.102 proxy profile prox
Verification

Verify DHCP proxy configuration.


Router#show dhcp ipv4 proxy binding summary 
Wed Jun  5 08:07:22.537 IST

Total number of clients: 3724

     STATE                |     COUNT     |
------------------------------------
  INIT                    |            0  |
  INIT_DPM_WAITING        |            0  |
  SELECTING               |            0  |
  OFFER_SENT              |            0  |
  REQUESTING              |            0  |
  REQUEST_INIT_DPM_WAITING|            0  |
  ACK_DPM_WAITING         |            0  |
  BOUND                   |         3724  |
  RENEWING                |            0  |
  INFORMING               |            0  |
  REAUTHORIZE             |            0  |
  DISCONNECT_DPM_WAIT     |            0  |
  ADDR_CHANGE_DPM_WAIT    |            0  |
  DELETING                |            0  |
  DISCONNECTED            |            0  |
  RESTARTING              |            0  |

Geographical Redundancy By Using a Session Redundancy Group (SERG)

In large scale network implementations, it becomes essential to have redundancy between routers that share the same core network (IP and MPLS), but are geographically apart. A redundancy thus achieved is known as geographical redundancy, and often consists of a switchover (SO) from the active (primary) router to the standby (subordinate) router.

To achieve geographical redundancy for IPv6 Neighbor Discovery (ND) entries, or for DHCPv6 bindings, we use a Session Redundancy Group (SERG). A SERG comprises of sessions mapped to the access interfaces on the active RP of the router. If a single SERG is configured on the active RPs of the primary and subordinate routers, then the router hosting the primary SERG serves as the primary, and the router hosting the subordinate SERG serves as the subordinate. This is illustrated in the following figure.

Figure 3. Geo Redundancy with a Single SERG

When multiple SERGs are configured on the active RPs, you could have both primary and subordinate SERGs on a single router. This is illustrated in the following figure.

Figure 4. Geo Redundancy with Multiple SERGs

Each router has an inbuilt redundancy between the RPs. When the active RP fails, the session (s) is transferred to the standby RP. This is known as a failover (FO).

The Session Redundancy Manager (SERM) runs on the active RP of both primary and subordinate routers. The SR clients running on the routers interact with the Session Redundancy Infrastructure (Session Redundancy Agent (SRA) and the Session Redundancy Library (SRL)).

The various components and their functions are briefly described as follows:

  • Session Redundancy Manager (SERM): The SERM runs as a separate process on the active RP and manages the SERG configuration. The SERM peers with other routers that need to form a redundancy relationship, and establishes a point-to-multipoint communication channel to Session Redundancy Agents (SRAs) on the RP.

  • Session Redundancy Agent (SRA): One or more SRAs run as a a separate process on the active RP and supported line cards. A SRA acts on the SERG configuration, setting up operational context and database tables. The SRA implements the state machine for primary/subordinate selection and role change and orchestrates it using the TCP channel and provided APIs.The SRA receives the session entries on the primary router and updates its database prior to synchronizing with the database on the subordinate router. The SRA orchestrates the session context setup on the subordinate router during the FO or SO. The SRA maintains a separate session database for each session client configured in the SERG.


    Note


    The SRA works only on specific, defined keys, such as the IPv6 address, DHCPv6 client ID, and so on. Any undefined session data is handled as opaque data by the SRA. The respective session components must provide their access library to the SRA for handling any transformation or data retrieval.
  • Session Redundancy Library (SRL): The SRL is used by session components for communicating with the SRA. The SRL uses IPC semantics for communicating with the SRA. SERG clients use an asychronous API for storing and retrieving the session state from the SRL.

You can configure object tracking for one or more access interfaces in the SERG to enable automatic switchovers when an interface goes down. For more information on this configuration, see the BNG Command Reference Guide for Cisco ASR 9000 Series Routers.

Limitations for SERG

  • If the Address Cached in the primary router: When the device configured as a primary router loses connectivity with the device configured as a subordinate router, the primary router continues to provide addresses assigned to the group. If one or more subscribers restart, the previously assigned IP addresses remain in the cache until communication is restored between both SERG entities. This situation could potentially exhaust the address pool if many subscribers frequently disconnect and reconnect, if a few subscribers continuously flap, or if the clear subscribers command is used.

  • If a device is configured as a subordinate router: This device does not provide any address if the connectivity to the primary device is lost. In case this device assumes the role of primary, for example, after a session-redundancy switchover group was executed or for any other reason, there could be situations where address duplication occurs.

Guidelines for SERG

  • The connectivity between SERG devices should be stable, as communication occurs over a TCP session using port 4001. It is good practice to prioritize this traffic.

  • In the event of a prolonged disconnection between devices configured for SERG, it is advisable to configure a peer removal due to the caching mechanism. During the disconnection, addresses provided by the pool are tagged as local. Once the connection is restored, they will be tagged as local and remote.

Configuring and Verifying Session Redundancy for DHCPv6 Clients

Use the following procedure to configure geo-redundancy through session redundancy for DHCPv6 clients.

In this example, we configure Router 1 as Primary and Router 2 as Subordinate.

  1. On Routers R1 and R2, enter the global configuration mode and configure session redundancy by specifying Loopback 0 as the source interface.

    
    Router# configure
    Router(config)# session redundancy
    Router(config-session-red)# hold-timer 5
    Router(config-session-red)# source-interface loopback0
    

    Note


    The hold timer values on Routers R1 and R2 must match for them to peer with each other.


  2. Configure the session redundancy group by specifying the preferred role as Primary for Router R1 using the master keyword, and as subordinate for Router R2 using the slave keyword.

    Router R1:

    Router(config)# session redundancy group 1
    Router(config-session-red-group)# preferred-role master
    Router(config-session-red-group)# hold-timer 7
    Router(config-session-red-group)# peer 2.2.2.2
    Router(config-session-red-group)# revertive-timer 5 maximum 15
    Router(config-session-red-group)# interface-list 
    Router(config-session-red-grp-intf)# interface GigabitEthernet0/1/0/0 id 1
    

    Router R2:

    Router(config)# session redundancy group 1
    Router(config-session-red-group)# preferred-role slave
    Router(config-session-red-group)# hold-timer 7
    Router(config-session-red-group)# peer 1.1.1.1
    Router(config-session-red-group)# revertive-timer 5 maximum 15
    Router(config-session-red-group)# interface-list 
    Router(config-session-red-grp-intf)# interface GigabitEthernet0/1/0/0 id 1
    

    Note


    The hold timer, revertive timer, and interface ID values on Routers R1 and R2 must match for them to peer with each other.


  3. Exit to the global configuration mode and commit your configuration on Routers R1 and R2.

    Router(config)# commit
  4. Confirm your configuration on Router R1.

    Router# show running-config session-redundancy 
    ...
    session-redundancy
     source-interface Loopback0
     hold-timer 5
     group 1
      preferred-role master
      hold-timer 7
      peer 2.2.2.2
      revertive-timer 5 maximum 15
      interface-list
       interface GigabitEthernet0/1/0/0 id 1
      !
     !
    !
  5. Confirm your configuration on Router R2.

    Router# show running-config session-redundancy 
    ...
    session-redundancy
     source-interface Loopback0
     hold-timer 5
     group 1
      preferred-role slave
      hold-timer 7
      peer 1.1.1.1
      revertive-timer 5 maximum 15
      interface-list
       interface GigabitEthernet0/1/0/0 id 1
      !
     !
    !
  6. Verify the session redundancy group on the routers by running the following show commands.

    Router# show session-redundancy group 
    ...
    Session Redundancy Agent Group Summary
    Flags    : E - Enabled, D - Disabled, M - Preferred Master, S - Preferred Slave
               H - Hot Mode, W - Warm Mode, T - Object Tracking Enabled
    P/S      : Peer Status
               I - Initialize, Y - Retry, X - Cleanup, T - Connecting
               L - Listening, R- Registered, C - Connected, E - Established
    I/F Count: Interface Count
    SS Count : Session Count
    ----------------------------------------------------------------------------------------------------------------------
       Node Name   | Group ID | Role | Flags  |         Peer Address        | P/S | I/F Count |  SS Count  | Sync Pending
    ----------------------------------------------------------------------------------------------------------------------
     0/1/CPU0               1  Master   EMH-   2.2.2.2                         E            1           0               0
    ----------------------------------------------------------------------------------------------------------------------
    Session Summary Count(Master/Slave/Total): 0/0/0
    
    
    Router# show session-redundancy group 1
    ...
    Session Redundancy Group ID: 1
      Description         : <<not-configured>>
      Status              : Enabled
    
      Init-Role           : Master 
      Negotiated-Role     : Master 
      Current-Role        : Master 
    
      Hold Time           : 7                          
      Revert Time         : 5                          
    
      Tracking Status     : Enabled
        Core-Tracking     : <<not-configured>>
          Status          : n/a
        Access-Tracking   : <<not-configured>>
          Status          : n/a
    
      Peer:
        IP-address        : 2.2.2.2                         
        Status            : Established
        Role(Init/Neg/Cur): Slave/Slave/Slave
        Tracking Status   : Up
    
        Last Neg-Time     : 2017 Mar  2 18:14:42
        Last Up-Time      : 2017 Mar  2 18:14:42
        Last Down-Time    : 2017 Mar  2 18:14:26
    
      Switchover:
        Last Switchover   : 2017 Mar  2 18:14:42       Reason         : Peer Up
        Switchover Count  : 1
        Hold Time         : Not-Running
        Revert Time       : Not-Running
    
      Session Statistics:
        Count             : 0                          Slave-Upd-Fail : 0        
        Pending Update    : 0                          Pending Delete : 0         
        Client:
          IPv6ND          : 0        
          DHCPv6          : 0        
    
      Interface Count     : 1
        GigabitEthernet0/1/0/0                         Map-ID         : 1
    
    
    
    Router# show session-redundancy summary interface 
    ...
    Session Redundancy Interface Summary
    Status: E - Exists, F - Forward Reference
    -----------------------------------------------------------------------------
           Interface Name                  | Status | Group ID | Map ID |  Role
    -----------------------------------------------------------------------------
     GigabitEthernet0/1/0/0                   E              1        1   Master
    -----------------------------------------------------------------------------
    
    
  7. Verify the SRG session information on the routers.

    
    Router# show session-redundancy group 1 session verbose 
    ...
    Session Redundancy Agent Group Session
           Flags: M-Master, V-Valid MAC, N-Neg Ack
            Comp: SA-Agent, ND-ipv6nd, D6-dhcpv6
      Comp Flags: U-Update, D-Delete, S-InSync, F-TxListFail, T-Dirty, C-Cleanup
        Err Info: X-xxxx-ec - H/S - Hard/Soft, xxxx - No. of Times, ec - Error Code
    -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
     Parent Interface              | Key index                                | Flags |      Comp Flags                 | Synchronization Error Info
    -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
     GigabitEthernet0/1/0/0          00030001ca011bba000000000000000000000000   M-       SA{S} D6{S}                                       -
    -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
    
  8. Verify the SRA information and statistics.

    Router# show session-redundancy agent interface 
    ...
    Session Redundancy Agent Interface
    Status   : F - Forward Referenced, S - Stale, R - Registered,
               A - CAPS Added, O - Resource Owned, P - EOMS Pending
               C - Pending CAPS Remove, U - Pending Reg Disable
    Err Stats: Enable - Disable - Caps Add - Caps Remove - Attr Updated
    -----------------------------------------------------------------------------------------
           Interface Name           |  ID  | Group ID | Role  |  Status  | Oper  | Err Stats
    -----------------------------------------------------------------------------------------
     GigabitEthernet0/1/0/0               1         1   Master  --RA----   -----  0-0-0-0-0
    ---------------------------------------------------------------------------------------
    Router# show session-redundancy agent statistics 
    ...
    Session Redundancy Agent Summary - Node 0/0/CPU0
      Process State                   : Active
    
      Source Interface                : Loopback0
        VRF Name                      : default
        IPv4 Address                  : 1.1.1.1
        IPv6 Address                  : 192::2
    
      Restart Client Sync In Progress : No
        Client Init Sync TimeStamp    : -
      Restart Peer Sync In Progress   : No
        Peer Init Sync TimeStamp      : -
      Sync in Progress                : No
      Peer Action Timer               : Not-Running
      Retry Timer                     : Not-Running
      Interface Status Statistics 
          Bound to group              : 1
          Non stale                   : 0
          Pending caps remove         : 0
          Pending reg disable         : 0
          Pending other batch oper    : 0
      Sync in Progress                : No
    
    Client Statistics:
      Status: U - Connection UP, S - Init-Sync Pending, E - Sync EOD Pending
    --------------------------------------------------------------------------------
      Comp  | Status |     Up Timestamp     |    Down Timestamp    | Cleanup Timer
    --------------------------------------------------------------------------------
     SERGAGT     ---    -                      -                             0
     IPv6ND     U--    2017 Mar  2 18:14:25   -                             0
     DHCPv6     U--    2017 Mar  2 18:14:25   -                             0
    --------------------------------------------------------------------------------
    
    TxList Statistics:                                     Ok   Part-Write        Clean
    ------------------------------------------------------------------------------------
      Marker Encode                            :            4            0            4
      Command Encode                           :            0            0            0
      Negotiation Encode                       :            0            0            0
    
    Client Statistics:                                     Ok        NotOk
    -----------------------------------------------------------------------
      Invalid Registration                     :                         0
      Invalid DeRegistration                   :                         0
      Connection Up Count                      :            2
      Connection Down Count                    :                         0
      Message CallBack Count                   :            2
      Message Received                         :            4            0
      Command Message Received                 :            0            0
      Session Message Received                 :            4            0
      Peer Done                                :            2
    
    Peer Statistics:                                       Ok        NotOk
    -----------------------------------------------------------------------
      Timer Handler                            :            0
      Invalid Registration                     :                         0
      Invalid DeRegistration                   :                         0
      Message CallBack Count                   :            0            0
      Command Connection Up                    :                         0
      Command Connection Down                  :                         0
      Session Connection Up                    :                         0
      Session Connection Down                  :                         0
      Peer Done                                :            0
    -----------------------------------------------------------------------
    
    
  9. Verify the DHCPv6 SR client information on the routers.

    Router#show session-redundancy agent client dhcpv6 
    ...
    Session Redundancy Agent Client Statistics - Node 0/0/CPU0
    Component - DHCPv6
    Statistics:                                            Ok        NotOk
    -------------------------------------------------------------------------------
    Sent To Client:
      Command
        Start of Download  - SOD               :            1            0
        End of Download    - EOD               :            1            0
        End of Master Sync - EOMS              :            0            0
        Clear              - All               :            0            0
        Clear              - Selected          :            0            0
        Replay             - All               :            0            0
        Replay             - Selected          :            0            0
      Session                                  :            0            0
        Update                                 :            0            0
        Delete                                 :            0
    
    TxList Operation:
      Encode - Complete Write                  :            0
      Encode - Partial Write                   :            0
      Cleanup CallBack                         :            0
    Last Replay Count                          :            0
    
    Received From Client:
      Command
        Start of Download  - SOD   - All       :            1
        Start of Download  - SOD   - Selected  :            0
        End of Download    - EOD   - All       :            1
        End of Download    - EOD   - Selected  :            0
        End of Master Sync - EOMS              :            0
        Clear              - All               :            0
        Clear              - Selected          :            0
        Replay             - All               :            0
        Replay             - Selected          :            0
      Session
        Update                                 :            0            0
        Delete                                 :            0            0
      Negative Acknowledgement                 :            0            0
    
    Client Activity Statistics:
      Active                                   :            1            0
      Deactive                                 :            0            0
      Registration                             :            1            0
      DeRegistration                           :            0
      Connection Down                          :            0
      Cleanup                                  :            0
    -------------------------------------------------------------------------------
    
    Session Redundancy Agent Client Statistics - Node 0/1/CPU0
    Component - DHCPv6
    Statistics:                                            Ok        NotOk
    -------------------------------------------------------------------------------
    Sent To Client:
      Command
        Start of Download  - SOD               :            1            0
        End of Download    - EOD               :            1            0
        End of Master Sync - EOMS              :            1            0
        Clear              - All               :            0            0
        Clear              - Selected          :            0            0
        Replay             - All               :            0            0
        Replay             - Selected          :            0            0
      Session                                  :            0            0
        Update                                 :            0            0
        Delete                                 :            0
    
    TxList Operation:
      Encode - Complete Write                  :            0
      Encode - Partial Write                   :            0
      Cleanup CallBack                         :            0
    Last Replay Count                          :            0
    
    Received From Client:
      Command
        Start of Download  - SOD   - All       :            1
        Start of Download  - SOD   - Selected  :            0
        End of Download    - EOD   - All       :            1
        End of Download    - EOD   - Selected  :            0
        End of Master Sync - EOMS              :            0
        Clear              - All               :            0
        Clear              - Selected          :            0
        Replay             - All               :            0
        Replay             - Selected          :            0
      Session
        Update                                 :            0            3
        Delete                                 :            0            2
      Negative Acknowledgement                 :            0            0
    
    Client Activity Statistics:
      Active                                   :            1            0
      Deactive                                 :            0            0
      Registration                             :            1            0
      DeRegistration                           :            0
      Connection Down                          :            0
      Cleanup                                  :            0
    -------------------------------------------------------------------------------
    
    Session Redundancy Agent Client Statistics - Node 0/2/CPU0
    Component - DHCPv6
    Statistics:                                            Ok        NotOk
    -------------------------------------------------------------------------------
    Sent To Client:
      Command
        Start of Download  - SOD               :            1            0
        End of Download    - EOD               :            1            0
        End of Master Sync - EOMS              :            0            0
        Clear              - All               :            0            0
        Clear              - Selected          :            0            0
        Replay             - All               :            0            0
        Replay             - Selected          :            0            0
      Session                                  :            0            0
        Update                                 :            0            0
        Delete                                 :            0
    
    TxList Operation:
      Encode - Complete Write                  :            0
      Encode - Partial Write                   :            0
      Cleanup CallBack                         :            0
    Last Replay Count                          :            0
    
    Received From Client:
      Command
        Start of Download  - SOD   - All       :            1
        Start of Download  - SOD   - Selected  :            0
        End of Download    - EOD   - All       :            1
        End of Download    - EOD   - Selected  :            0
        End of Master Sync - EOMS              :            0
        Clear              - All               :            0
        Clear              - Selected          :            0
        Replay             - All               :            0
        Replay             - Selected          :            0
      Session
        Update                                 :            0            0
        Delete                                 :            0            0
      Negative Acknowledgement                 :            0            0
    
    Client Activity Statistics:
      Active                                   :            1            0
      Deactive                                 :            0            0
      Registration                             :            1            0
      DeRegistration                           :            0
      Connection Down                          :            0
      Cleanup                                  :            0
    
    

You have successfully configured and verified geo redundancy using session redundancy groups for DHCPv6 clients.

Managing Session Redundancy Groups

After you have configured and verified the session redundancy groups (SERGs), you can use the commands in this section to trigger a manual switchover, trigger a manual synchronization, or clear sessions for all or a specific SERG.

Triggering a Manual Switchover

After you have configured SERGs on the primary and subordinate routers, if you want to remove/replace the primary router, you can trigger a manual switchover from the primary to the subordinate by running the following commands.


Note


The following commands can be executed only on the primary router.


  • To trigger a redundancy switchover for all SERGs, run the following command.

    
    RP/0/RP0/CPU0:router# session redundancy switchover 
    
    
  • To trigger a redundancy switchover for a specific SERG, run the following command.

    
    RP/0/RP0/CPU0:router# session redundancy switchover group 210
    
    

Triggering Manual Synchronization

If the sessions between the primary and subordinate routers are not getting synchronized, either because of some change in the network topology, or some network latency, you can trigger synchronization manually by running the following commands.


Note


The following commands can be executed on either the Primary or the Subordinate router.


  • To trigger a redundancy synchronization for all SERGs, run the following command.

    
    RP/0/RP0/CPU0:router# session redundancy synchronize
    
    
  • To trigger a redundancy synchronization for a specific SERG, run the following command.

    
    RP/0/RP0/CPU0:router# session redundancy synchronize group 210
    
    

Clearing Sessions in a SERG

If you want to clear the existing sessions on the primary and subordinate routers, either because of a switchover, or a change in network topology, you can run the following commands.


Note


The following commands can be executed on either the primary or the subordinate router.

When issued on the subordinate, the session context is deleted from the router and a synchronization is requested with the primary. If the router is in hot-standby mode, the sessions are deleted on the subordinate.

When issued on the primary, the session entries are deleted first on the primary and later on the subordinate. The SRA then requests a fresh session from the SR client, which is eventually synchronized with the subordinate.


  • To clear sessions for all SERGs, run the following command.

    
    RP/0/RP0/CPU0:router# clear session-redundancy 
    
    
  • To clear sessions for a specific SERG, run the following command.

    
    RP/0/RP0/CPU0:router# clear session-redundancy group 1
    
    

Configuring and Verifying Session Redundancy for IPv6 ND Clients

Use the following procedure to configure geo-redundancy through session redundancy for IPv6 ND clients.

In this example, we configure Router 1 as Primary and Router 2 as Subordinate.

  1. On Routers R1 and R2, enter the global confiiguration mode and configure session redundancy by specifying Loopback 0 as the source interface.

    
    RP/0/RP0/CPU0:router# configure
    RP/0/RP0/CPU0:router(config)# session redundancy
    RP/0/RP0/CPU0:router(config-session-red)# hold-timer 5
    RP/0/RP0/CPU0:router(config-session-red)# source-interface loopback0
    

    Note


    The hold timer values on Routers R1 and R2 must match for them to peer with each other.


  2. Configure the session redundancy group by specifying the preferred role as Primary for Router R1 using the master keyword, and as subordinate for Router R2 using the slave keyword.

    Router R1 :

    RP/0/RP0/CPU0:router(config)# session redundancy group 1
    RP/0/RP0/CPU0:router(config-session-red-group)# preferred-role master
    RP/0/RP0/CPU0:router(config-session-red-group)# hold-timer 7
    RP/0/RP0/CPU0:router(config-session-red-group)# peer 2.2.2.2
    RP/0/RP0/CPU0:router(config-session-red-group)# revertive-timer 5 maximum 15
    RP/0/RP0/CPU0:router(config-session-red-grp-intf)# interface GigabitEthernet0/1/0/0 id 1
    

    Router R2:

    RP/0/RP0/CPU0:router(config)# session redundancy group 1
    RP/0/RP0/CPU0:router(config-session-red-group)# preferred-role slave
    RP/0/RP0/CPU0:router(config-session-red-group)# hold-timer 7
    RP/0/RP0/CPU0:router(config-session-red-group)# peer 1.1.1.1
    RP/0/RP0/CPU0:router(config-session-red-group)# revertive-timer 5 maximum 15 
    RP/0/RP0/CPU0:router(config-session-red-grp-intf)# interface GigabitEthernet0/1/0/0 id 1
    

    Note


    The hold timer, revertive timer, and interface ID values on Routers R1 and R2 must match for them to peer with each other.


  3. Exit to the global configuration mode and commit your configuration on Routers R1 and R2.

    RP/0/RP0/CPU0:router(config)# commit
    
  4. Confirm your configuration on Router R1 (Primary).

    RP/0/RP0/CPU0:router# show running-config session-redundancy 
    ...
    session-redundancy
     source-interface Loopback0
     hold-timer 5
     group 1
      preferred-role master
      hold-timer 7
      peer 2.2.2.2
      revertive-timer 5 maximum 15
       interface GigabitEthernet0/1/0/0 id 1
      !
     !
    !
  5. Confirm your configuration on Router R2.

    RP/0/RP0/CPU0:router# show running-config session-redundancy 
    ...
    session-redundancy
     source-interface Loopback0
     hold-timer 5
     group 1
      preferred-role slave
      hold-timer 7
      peer 1.1.1.1
      revertive-timer 5 maximum 15
       interface GigabitEthernet0/1/0/0 id 1
      !
     !
    !
  6. Verify the session redundancy group on the routers by running the following show commands.

    RP/0/RP0/CPU0:router# show session-redundancy group 
    ...
    Session Redundancy Agent Group Summary
    Flags    : E - Enabled, D - Disabled, M - Preferred Master, S - Preferred Slave
               H - Hot Mode, W - Warm Mode, T - Object Tracking Enabled
    P/S      : Peer Status
               I - Initialize, Y - Retry, X - Cleanup, T - Connecting
               L - Listening, R- Registered, C - Connected, E - Established
    I/F Count: Interface Count
    SS Count : Session Count
    ----------------------------------------------------------------------------------------------------------------------
       Node Name   | Group ID | Role | Flags  |         Peer Address        | P/S | I/F Count |  SS Count  | Sync Pending
    ----------------------------------------------------------------------------------------------------------------------
     0/1/CPU0               1  Master   EMH-   2.2.2.2                         E            1           0               0
    ----------------------------------------------------------------------------------------------------------------------
    Session Summary Count(Master/Slave/Total): 0/0/0
    
    
    RP/0/RP0/CPU0:router# show session-redundancy group 1
    ...
    Session Redundancy Group ID: 1
      Description         : <<not-configured>>
      Status              : Enabled
    
      Init-Role           : Master 
      Negotiated-Role     : Master 
      Current-Role        : Master 
    
      Hold Time           : 7                          
      Revert Time         : 5                          
    
      Tracking Status     : Enabled
        Core-Tracking     : <<not-configured>>
          Status          : n/a
        Access-Tracking   : <<not-configured>>
          Status          : n/a
    
      Peer:
        IP-address        : 2.2.2.2                         
        Status            : Established
        Role(Init/Neg/Cur): Slave/Slave/Slave
        Tracking Status   : Up
    
        Last Neg-Time     : 2017 Mar  2 18:14:42
        Last Up-Time      : 2017 Mar  2 18:14:42
        Last Down-Time    : 2017 Mar  2 18:14:26
    
      Switchover:
        Last Switchover   : 2017 Mar  2 18:14:42       Reason         : Peer Up
        Switchover Count  : 1
        Hold Time         : Not-Running
        Revert Time       : Not-Running
    
      Session Statistics:
        Count             : 0                          Slave-Upd-Fail : 0        
        Pending Update    : 0                          Pending Delete : 0         
        Client:
          IPv6ND          : 0        
          DHCPv6          : 0        
    
      Interface Count     : 1
        GigabitEthernet0/1/0/0                         Map-ID         : 1
    
    
    
    RP/0/RP0/CPU0:router# show session-redundancy summary interface 
    ...
    Session Redundancy Interface Summary
    Status: E - Exists, F - Forward Reference
    -----------------------------------------------------------------------------
           Interface Name                  | Status | Group ID | Map ID |  Role
    -----------------------------------------------------------------------------
     GigabitEthernet0/1/0/0                   E              1        1   Master
    -----------------------------------------------------------------------------
    
    
  7. Verify the SRG session information on the routers.

    
    RP/0/RP0/CPU0:router# show session-redundancy group 1 session verbose 
    ...
    Session Redundancy Agent Group Session
           Flags: M-Master, V-Valid MAC, N-Neg Ack
            Comp: SA-Agent, ND-ipv6nd, D6-dhcpv6
      Comp Flags: U-Update, D-Delete, S-InSync, F-TxListFail, T-Dirty, C-Cleanup
        Err Info: X-xxxx-ec - H/S - Hard/Soft, xxxx - No. of Times, ec - Error Code
    -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
     Parent Interface              | Key index                                | Flags |      Comp Flags                 | Synchronization Error Info
    -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
     GigabitEthernet0/1/0/0          00030001ca011bba000000000000000000000000   M-       SA{S} D6{S}                                       -
    -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
    
  8. Verify the SRA information and statistics.

    RP/0/RP0/CPU0:router# show session-redundancy agent interface 
    ...
    Session Redundancy Agent Interface
    Status   : F - Forward Referenced, S - Stale, R - Registered,
               A - CAPS Added, O - Resource Owned, P - EOMS Pending
               C - Pending CAPS Remove, U - Pending Reg Disable
    Err Stats: Enable - Disable - Caps Add - Caps Remove - Attr Updated
    -----------------------------------------------------------------------------------------
           Interface Name           |  ID  | Group ID | Role  |  Status  | Oper  | Err Stats
    -----------------------------------------------------------------------------------------
     GigabitEthernet0/1/0/0               1         1   Master  --RA----   -----  0-0-0-0-0
    ---------------------------------------------------------------------------------------
    
    RP/0/RP0/CPU0:router# show session-redundancy agent statistics 
    ...
    Session Redundancy Agent Summary - Node 0/0/CPU0
      Process State                   : Active
    
      Source Interface                : Loopback0
        VRF Name                      : default
        IPv4 Address                  : 1.1.1.1
        IPv6 Address                  : 192::2
    
      Restart Client Sync In Progress : No
        Client Init Sync TimeStamp    : -
      Restart Peer Sync In Progress   : No
        Peer Init Sync TimeStamp      : -
      Sync in Progress                : No
      Peer Action Timer               : Not-Running
      Retry Timer                     : Not-Running
      Interface Status Statistics 
          Bound to group              : 1
          Non stale                   : 0
          Pending caps remove         : 0
          Pending reg disable         : 0
          Pending other batch oper    : 0
      Sync in Progress                : No
    
    Client Statistics:
      Status: U - Connection UP, S - Init-Sync Pending, E - Sync EOD Pending
    --------------------------------------------------------------------------------
      Comp  | Status |     Up Timestamp     |    Down Timestamp    | Cleanup Timer
    --------------------------------------------------------------------------------
     SERGAGT     ---    -                      -                             0
     IPv6ND     U--    2017 Mar  2 18:14:25   -                             0
     DHCPv6     U--    2017 Mar  2 18:14:25   -                             0
    --------------------------------------------------------------------------------
    
    TxList Statistics:                                     Ok   Part-Write        Clean
    ------------------------------------------------------------------------------------
      Marker Encode                            :            4            0            4
      Command Encode                           :            0            0            0
      Negotiation Encode                       :            0            0            0
    
    Client Statistics:                                     Ok        NotOk
    -----------------------------------------------------------------------
      Invalid Registration                     :                         0
      Invalid DeRegistration                   :                         0
      Connection Up Count                      :            2
      Connection Down Count                    :                         0
      Message CallBack Count                   :            2
      Message Received                         :            4            0
      Command Message Received                 :            0            0
      Session Message Received                 :            4            0
      Peer Done                                :            2
    
    Peer Statistics:                                       Ok        NotOk
    -----------------------------------------------------------------------
      Timer Handler                            :            0
      Invalid Registration                     :                         0
      Invalid DeRegistration                   :                         0
      Message CallBack Count                   :            0            0
      Command Connection Up                    :                         0
      Command Connection Down                  :                         0
      Session Connection Up                    :                         0
      Session Connection Down                  :                         0
      Peer Done                                :            0
    -----------------------------------------------------------------------
    ...
    
  9. Verify the IPv6 ND SR client information on the routers.

    RP/0/RP0/CPU0:router# show session-redundancy client ipv6nd 
    Session Redundancy Client Statistics - Node 0/0/CPU0
    
      Config    : True                                 
      Status : Enabled 
      Active    : True        
    
      Connection Status         : Connected
      Last Connection Up Time   : 2017 Mar  7 10:28:03
      Last Connection Down Time : 1970 Jan  1 05:30:00
    
    TxList Operation:
      Message CallBack                         :            2
      Encode - Complete Write                  :            7
      Encode - Partial Write                   :            0
      Cleanup CallBack                         :            0
      Decode Message Error                     :            0
      Unknown Operation Error                  :            0
    
    TxList Statistics:                                     Ok   Part-Write        Clean
    ------------------------------------------------------------------------------------
      Marker Encode                            :            2            0            2
      Command Encode                           :            0            0            0
      Negotiation Encode                       :            0            0            0
    
    Statistics:                                            Ok        NotOk
    -------------------------------------------------------------------------------
    Sent To Agent:
      Command
        Start of Download  - SOD               :            1            0
        End of Download    - EOD               :            1            0
        End of Master Sync - EOMS              :            0            0
        Clear              - All               :            0            0
        Clear              - Selected          :            0            0
        Replay             - All               :            0            0
        Replay             - Selected          :            0            0
      Session
        Add                                    :            7            0
        Delete                                 :            7            0
      Negative Acknowledgement
        Synchronous                            :            0            0
        Asynchronous                           :            0            0
    
    Received From Agent:
    Message                                    :            9            0
      Command                                  :            0            0
        Start of Download  - SOD   - All       :            1
        Start of Download  - SOD   - Selected  :            0
        End of Download    - EOD   - All       :            1
        End of Download    - EOD   - Selected  :            0
        End of Master Sync - EOMS              :            7
        Clear              - All               :            0
        Clear              - Selected          :            0
        Replay             - All               :            1
        Replay             - Selected          :            0
      Session                                  :            9            0
        Update                                 :            0            0
        Delete                                 :            0            0
    
    Agent Activity Statistics:
      Active                                   :            1            0
      Deactive                                 :            0            0
      Connection Up                            :            1            0
      Connection Down                          :            0
      Peer Done                                :            8
    ...
    
    
    RP/0/RP0/CPU0:router# show ipv6 nd statistics
    
    Service Attrib  Oper      Success#  Failure#  MinTime   MaxTime     AvgTime     
                                                  (usec)    (usec)      (usec)      
    AIB     IDB     Init      1         0         84110     84110       84110       
    AIB     IDB     Reg       1         0         295       295         295         
    
    CHKPT   IDB     Init      1         0         73        73          73          
    CHKPT   IDB     Update    47        0         23        100         27          
    CHKPT   NBR     Create    4         0         68        110         80          
    CHKPT   NBR     Del       2         0         150       1475        812         
    CHKPT   NBR     Init      1         0         232       232         232         
    CHKPT   NBR     Update    4         0         54        166         120         
    
    GSP     BATCH   Sent      4         32        0         2411        68          
    GSP     IDB     Init      1         0         5197      5197        5197        
    GSP     IDB     Reg       1         0         1816      1816        1816        
    GSP     IDB     Sent      24        0         13        104         15          
    GSP     MNODE   Sent      8         0         14        2482        322         
    GSP     PING    Recv      4         0         0         0           0           
    GSP     PING    Sent      4         0         76        1476        475         
    GSP     Ucast   Recv      5         0         0         0           0           
    
    IM      IDB     Create    10        0         0         0           0           
    IM      IDB     Init      2         0         670       4831        2750        
    IM      IDB     Reg       1         0         465       465         465         
    IM      MAC     Recv      8         0         0         0           0           
    IM      MAC     Reg       1         0         134       134         134         
    IM      MTU     Recv      8         0         0         0           0           
    IM      MTU     Reg       1         0         121       121         121         
    IM      VLAN    Recv      7         0         0         0           0           
    IM      VLAN    Reg       1         0         144       144         144         
    IM      MEMBER  Recv      24        0         0         0           0           
    IM      MEMBER  Reg       1         0         1603      1603        1603        
    
    LPTS    IDB     Add       8         0         2         174         25          
    LPTS    IDB     Init      1         0         4545      4545        4545        
    LPTS    IDB     Update    10        0         0         1           0           
    
    IPV6-MA BATCH   Recv      3         0         0         0           0           
    
    NETIO   IDB     Init      1         0         244787    244787      244787      
    NETIO   RA      Recv      14        0         0         0           0           
    NETIO   NA      Recv      4         0         0         0           0           
    NETIO   NS      Recv      4         0         0         0           0           
    
    STATS   IDB     Init      1         0         21410     21410       21410       
    STATS   IDB     Reg       8         0         2         19532       2449        
    
     Session Redundancy Stats 
     --------------------------------------------- 
    
     Type                          Success   Error     
     --------------------------------------------- 
    serg_init                        1         0         
    serg_shutdown                    0         0         
    serg_activate                    1         0         
    serg_active_txlist_add           0         0         
    serg_active_txlist_del           0         0         
    serg_active_txlist_encode        6         0         
    serg_active_txlist_clean         6         0         
    serg_active_replay               1         0         
    serg_active_cleanup              0         0         
    serg_standby_receive             0         0         
    serg_standby_sess_update         0         0         
    serg_standby_sess_delete         0         0         
    serg_standby_sess_nack           0         0         
    serg_standby_sess_mark           1         0         
    serg_standby_sess_sweep          1         0         
    serg_standby_cleanup             0         0   
    
    

You have successfully configured and verified geo redundancy using session redundancy groups for IPv6 ND clients.

For information on managing SERGs, see Managing Session Redundancy Groups.

Additional References

The following sections provide references related to implementing the Cisco IOS XR DHCP relay agent.

Related Documents

Related Topic

Document Title

Cisco IOS XR

DHCP commands

DHCP Commands module in the IP Addresses and Services Command Reference for Cisco NCS 6000 Series Routers

Information about user groups and task IDs

Configuring AAA Services module in the System Security Configuration Guide for Cisco NCS 6000 Series Routers

Standards

Standards

Title

No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.

MIBs

MIBs

MIBs Link

To locate and download MIBs, use the Cisco MIB Locator found at the following URL and choose a platform under the Cisco Access Products menu: https://mibs.cloudapps.cisco.com/ITDIT/MIBS/servlet/index

RFCs

RFC

Title

RFC 2131

Dynamic Host Configuration Protocol

Technical Assistance

Description

Link

The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/techsupport