DHCP Server Port-Based Address Allocation

The DHCP Server Port-Based Address Allocation feature provides port-based address allocation support on the Cisco IOS Dynamic Host Configuration Protocol (DHCP) server for the Ethernet platform. The DHCP server provides address assignment support based on the point of attachment of the client network.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Restrictions for DHCP Server Port-Based Address Allocation

The DHCP Server Port-Based Address Allocation feature does not support Virtual routing and forwarding (VRF) and virtual private network (VPNs).

Information About DHCP Server Port-Based Address Allocation

DHCP Server Port-Based Address Allocation Feature Design

When Cisco industrial Ethernet switches are deployed on the factory floor, they offer connectivity to the directly connected manufacturing devices. A failure manufacturing device must be repaired immediately in the existing network or replaced by a new device. The DHCP protocol recognizes DHCP clients by the client identifier (ID) option in the DHCP packet. Clients who do not include the client ID option are identified by the client hardware address. The DHCP Server Port-Based Address Allocation feature introduces the capability to ensure that the same IP address is always offered to the replacement device as the device being replaced. This IP address is always offered to the same connected port even as the client ID or client hardware address (chaddr) changes in the DHCP messages received on that port.

If this feature is configured, the port name of the interface overrides the information the client sends and the actual point of connection. Then a port on the switch becomes the client ID.

In all cases, if you connect the Ethernet cable to the same port, the same IP address is allocated through the DHCP to the attached device. The figure below shows an industrial Ethernet switch using DHCP to assign one IP address per port to directly connected manufacturing devices.

Figure 1. DHCP Server Port-Based Address Assignment to Directly Connected Manufacturing Devices

How to Configure DHCP Server Port-Based Address Allocation

Automatically Generating a Subscriber Identifier for a DHCP Message Received on a Port

Perform this task to automatically generate a unique ID, called a subscriber ID for a DHCP message received on a port.

If the DHCP Server Port-Based Address Allocation feature is configured, the subscriber ID value is used in place of the client ID to provide stable IP address assignment. The subscriber ID value is based on the short name of the port to which the directly connected device is attached. If this device is removed and replaced with a new device, the new device maintains the same subscriber ID.

The subscriber ID is used at the same point where the client ID or the client MAC address is currently captured during the DHCP IP address assignment process.

SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    ip dhcp use subscriber-id client-id

    4.    interface type number

    5.    ip dhcp server use subscriber-id client-id


DETAILED STEPS
     Command or ActionPurpose
    Step 1 enable


    Example:
    Router> enable
     

    Enables privileged EXEC mode.

    • Enter your password if prompted.

     
    Step 2 configure terminal


    Example:
    Router# configure terminal
     

    Enters global configuration mode.

     
    Step 3 ip dhcp use subscriber-id client-id


    Example:
    Router(config)# ip dhcp use subscriber-id client-id
     

    Configures the DHCP server to globally use the subscriber ID as the client ID on all incoming DHCP messages.

    • DHCP uses the subscriber ID configured on the interface to generate the client ID. If no subscriber ID is configured then the client ID is automatically generated based on the short name of the interface. The client ID already present in the message is ignored.

    • For port based address allocation, do not configure any subscriber ID on the interface. It must be generated automatically from interface name.

     
    Step 4 interface type number


    Example:
    Router(config)# interface Ethernet 0/0
     

    (Optional) Configures an interface and enters interface configuration mode.

     
    Step 5 ip dhcp server use subscriber-id client-id


    Example:
    Router(config-if)# ip dhcp server use subscriber-id client-id
     

    (Optional) Configures the DHCP server to use the subscriber ID as the client ID on all incoming DHCP messages on the interface.

     

    Troubleshooting Tips

    Use the following command to debug any errors that you may encounter when you configure DHCP to automatically generate a unique ID:

    • debug ip dhcp server packets

    Preassigning IP Addresses and Associating Them to a Client

    Perform this task to preassign an IP address and associate it to a client identified by a client ID or MAC address.

    For port-based address assignment, you must perform the task in the Automatically Generating a Subscriber Identifier for a DHCP Message Received on a Port task to associate the client ID with the subscriber ID. The subscriber ID value is based on the short name of the port to which the directly connected device is attached.

    Configure a normal DHCP pool by supplying any DHCP options and lease time. Preassigned addresses are automatically excluded from normal dynamic IP address assignment. Preassigned addresses cannot be used in host pools, but there can be multiple preassigned addresses per DHCP address pool.


    Note
    • Only one IP address can be assigned per port.
    • Preassigned addresses (also called reserved addresses) cannot be cleared by using the clear ip dhcp binding command.
    >
    SUMMARY STEPS

      1.    enable

      2.    configure terminal

      3.    ip dhcp pool name

      4.    network network-number [mask | / prefix-length]

      5.    address ip-address client-id string [ascii]

      6.    address ip-address hardware-address mac-address [hardware-number]

      7.    end

      8.    show ip dhcp pool [name]

      9.    show ip dhcp binding


    DETAILED STEPS
       Command or ActionPurpose
      Step 1 enable


      Example:
      Router> enable
       

      Enables privileged EXEC mode.

      • Enter your password if prompted.

       
      Step 2 configure terminal


      Example:
      Router# configure terminal
       

      Enters global configuration mode.

       
      Step 3 ip dhcp pool name


      Example:
      Router(config)# ip dhcp pool pool1
       

      Creates a name for the DHCP server address pool and enters DHCP pool configuration mode.

       
      Step 4 network network-number [mask | / prefix-length]


      Example:
      Router(dhcp-config)# network 10.10.10.0 /24
       

      Specifies the subnet network number and mask of the DHCP address pool.

       
      Step 5 address ip-address client-id string [ascii]


      Example:
      Router(dhcp-config)# address 10.10.10.2 client-id Et1/0 ascii
       

      Reserves an IP address for a DHCP client identified by the client ID.

      • The string argument can be an ASCII value or a hexadecimal value.

      • For port-based address allocation the string argument must be the name of the port and the ascii keyword must be specified.

       
      Step 6 address ip-address hardware-address mac-address [hardware-number]


      Example:
      Router(dhcp-config)# address 10.10.10.3 hardware-address b708.1388.f166
       

      (Optional) Reserves an IP address for a client identified by the hardware address.

      • This command is used for clients identified by the hardware address included in the fixed-size header of the DHCP message.

       
      Step 7 end


      Example:
      Router(dhcp-config)# end
       

      Returns to privileged EXEC mode.

       
      Step 8 show ip dhcp pool [name]


      Example:
      Router> show ip dhcp pool
       

      (Optional) Displays information about DHCP address pools.

       
      Step 9 show ip dhcp binding


      Example:
      Router> show ip dhcp binding


      Example:
      

        
      
 
            		 
          
      
(Optional) Displays infinite binding for the configured addresses.
      

         
      
      

      

      

      

      Preassigning IP Addresses and Associating Them to a Client
      

      
      

      Note
      
        
      
Perform this task to restrict address assignments from the DHCP address pool only to preconfigured reservations.
      

        
      
When the DHCP Server Port-Based Address Allocation feature is configured on multiple switches, devices connected to one switch may also receive an IP address assignment from the neighboring switches rather than the local DHCP address pool switch. If you want the switch to serve only the client directly connected to the switch, you can configure a group of switches with pools that share a common IP subnet and ignore the requests from other clients (not connected to this switch). 
      

>
      

    
      

      
SUMMARY STEPS
        1.   
      
          
            enable
          
        
        

        2.   
      
          
            configure
          
          
            terminal
          
        
        

        3.   
      
          
            ip
            dhcp
            pool
          
          
            name
          
        
        

        4.   
      
          
            reserved-only
          
        
        


      DETAILED STEPS
         Command or ActionPurpose
        Step 1
          
            enable
          
        
         

        Example:
        
          
        Router> enable
        

        
        
 
              		 
          
        
Enables privileged EXEC mode. 
        

          
        • 
Enter your password if prompted.
          

          • 

        

         
      
        

        Step 2
          
            configure
          
          
            terminal
          
        
         

        Example:
        
          
        Router# configure terminal
        

        
        
 
              		 
          
        
Enters global configuration mode.
        

         
      
        

        Step 3
          
            ip
            dhcp
            pool
          
          
            name
          
        
         

        Example:
        
          
        Router(config)# ip dhcp pool pool1
        

        
        
 
              		 
          
        
Configures a DHCP address pool on a DHCP server and enters DHCP pool configuration mode.
        

         
      
        

        Step 4
          
            reserved-only
          
        
         

        Example:
        
          
        Router(dhcp-config)# reserved-only
        

        
        
 
              		 
          
        
Restricts address assignments from the DHCP address pool only to the preconfigured reservations.
        

         
      
        

        

        

        

        

        Configuration Examples for DHCP Server Port-Based Address Allocation
        

         
	 
        

        

        DHCP Server Port-Based Address Allocation  Example
        

        
      
        
In the following example, a subscriber ID will be automatically generated based on the short name of the interface (port) specified by the address client-id command. The DHCP server will ignore any client ID fields in the DHCP messages and use this subscriber ID as the client ID. The DHCP client is preassigned IP address 10.1.1.7.
        

      
        !
ip dhcp use subscriber-id client-id
ip dhcp subscriber-id interface-name
ip dhcp excluded-address 10.1.1.1 10.1.1.3
!         
ip dhcp pool dhcppool
 network 10.1.1.0 255.255.255.0
 address 10.1.1.7 client-id Et1/0 ascii

        

      
        
The following example shows that the preassigned address was correctly reserved in the DHCP pool:
        

      
        Router# show ip dhcp pool dhcppool
Pool test :
 Current index        IP address range                    Leased/Total
 10.1.1.1              10.1.1.1 - 10.1.1.254         0     / 254
 3 reserved addresses are currently in the pool :
Address          Client
 10.1.1.07         Et1/0
 10.1.1.20         xyz
 10.1.1.30         aabb.cc00.1501
        

    
        

        

        

        

        Additional References
        

         
	 
        

        Related Documents
         
		 
		

         
					 
         Related Topic
					 
        
 
				          		
 
					 
         Document Title
					 
        
 
				          		

        
        

         
					 
         DHCP commands: complete command syntax, command mode, command history, defaults, usage guidelines, and examples 
					 
        
 
				          		
 
					 
         
						Cisco IOS IP Addressing Services Command Reference 
					 
        
 
				          		

        
        

        

        
 
	 
        

        Standards
         
		 
		

         
					 
         Standard
					 
        
 
				          		
 
					 
         Title
					 
        
 
				          		

        
        

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

        
        

        

        
 
	 
        

        MIBs
         
		 
		

         
					 
         MIB
					 
        
 
				          		
 
					 
         MIBs Link
					 
        
 
				          		

        
        

         
					 
         No new or modified standards are supported by this feature and support for existing standards has not been modified by this feature.
					 
        
 
				          		
 
					 
         To locate and download MIBs for selected platforms, Cisco software releases, and feature sets, use Cisco MIB Locator found at the following URL:
					 
        
 
					 
         
						http:/​/​www.cisco.com/​go/​mibs 
					 
        
 
				          		

        
        

        

        
 
	 
        

        RFCs
         
		 
		

         
					 
         RFC
					 
        
 
				          		
 
					 
         Title
					 
        
 
				          		

        
        

         
					 
         No new or modified RFCs are supported by this feature.
					 
        
 
				          		
 
					 
         --
					 
        
 
				          		

        
        

        

        
 
	 
        

        Technical Assistance
         
		 
		

         
					 
         Description
					 
        
 
				          		
 
					 
         Link
					 
        
 
				          		

        
        

         
					 
         The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. 
					 
        
 
				          		
 
					 
         
						http:/​/​www.cisco.com/​cisco/​web/​support/​index.html 
					 
        
 
				          		

        
        

        

        
 
	 
        

        

        

        Feature Information for
	 DHCP Server Port-Based Address Allocation
        

         
		
        The following table
		  provides release information about the feature or features described in this
		  module. This table lists only the software release that introduced support for
		  a given feature in a given software release train. Unless noted otherwise,
		  subsequent releases of that software release train also support that feature. 
		
        
 Use Cisco Feature Navigator to find information about platform
		support and Cisco software image support. To access Cisco Feature Navigator, go
		to 
		.
		An account on Cisco.com is not required. 
	 
        

         
		

        Table 1 Feature Information for
		  DHCP Port-Based Address Allocation
         
				  
         Feature
					 Name 
				  
        
 
				        		
 
				  
         Releases 
				  
        
 
				        		
 
				  
         Feature
					 Information 
				  
        
 
				        		

        
        

         
				  
         DHCP
					 Server Port-Based Address Allocation 
				  
        
 
				        		
 
				   
				   
				   
				  
         Cisco IOS XE Release 3.2SE 
				  
        
 
				        		
 
				  
         The DHCP
					 Server Port-Based Address Allocation feature provides port-based address
					 allocation support on the Cisco IOS DHCP server for the industrial Ethernet
					 platform. The DHCP server provides address assignment support based on the
					 point of attachment of the client to the network. 
				  
        
 
				  
         The
					 following commands were introduced or modified: 
					 address 
						client-id, 
					 address 
						hardware-address, 
					 ip 
						dhcp 
						server 
						use 
						subscriber-id 
						client-id, 
					 ip 
						dhcp 
						subscriber-id 
						interface-name, 
					 ip 
						dhcp 
						use 
						subscriber-id 
						client-id, 
					 reserved-only, and 
					 show 
						ip 
						dhcp 
						pool.