Yang Data Model for DHCP Protocol
draft-liu-dhc-dhcp-yang-model-05
The information below is for an old version of the document.
| Document | Type |
This is an older version of an Internet-Draft whose latest revision state is "Expired".
|
|
|---|---|---|---|
| Authors | Bing Liu , Kunkun Lou , Chin Chen | ||
| Last updated | 2016-09-04 | ||
| RFC stream | (None) | ||
| Formats | |||
| Stream | Stream state | (No stream defined) | |
| Consensus boilerplate | Unknown | ||
| RFC Editor Note | (None) | ||
| IESG | IESG state | I-D Exists | |
| Telechat date | (None) | ||
| Responsible AD | (None) | ||
| Send notices to | (None) |
draft-liu-dhc-dhcp-yang-model-05
Internet Engineering Task Force B. Liu, Ed.
Internet Draft K. Lou
Intended status: Standards Track Huawei Technologies
Expires: March 2017 C. Chen
Ericsson
September 5, 2016
Yang Data Model for DHCP Protocol
draft-liu-dhc-dhcp-yang-model-05.txt
Abstract
This document defines a YANG data model for DHCP Server, relay, and
client, including configuration and running state.
Status of this Memo
This Internet-Draft is submitted in full conformance with the provisions
of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering Task
Force (IETF), its areas, and its working groups. Note that other groups
may also distribute working documents as Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference material
or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html
This Internet-Draft will expire on March 5, 2009.
Copyright Notice
Copyright (c) 2016 IETF Trust and the persons identified as the document
authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal Provisions
Relating to IETF Documents (http://trustee.ietf.org/license-info) in
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 1]
Internet-Draft DHCP Yang Data Model September 2016
effect on the date of publication of this document. Please review these
documents carefully, as they describe your rights and restrictions with
respect to this document. Code Components extracted from this document
must include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
Table of Contents
1. Introduction ................................................ 2
1.1. Terminology ............................................ 2
1.2. Tree Diagrams .......................................... 3
2. Design of Data Model......................................... 3
2.1. Overview ............................................... 3
2.2. DHCP Server ............................................ 4
2.3. DHCP Relay ............................................. 5
2.4. DHCP Client ............................................ 5
2.5. DHCP State ............................................. 6
3. DHCP YANG Module ............................................ 7
4. Security Considerations ..................................... 19
5. Contributors ............................................... 19
6. IANA Considerations ........................................ 19
7. Normative References........................................ 19
1. Introduction
This document defines a YANG [RFC6020] data model that can be used to
configure and manage DHCP.
This data model includes configuration data and state data, in which
DHCP server, replay, and client nodes are defined.
1.1. Terminology
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in BCP 14
[RFC2119].
The following terms are used within this document:
The following terms are defined in [RFC6241] and are not redefined here:
o client
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 2]
Internet-Draft DHCP Yang Data Model September 2016
o configuration data
o server
o state data
The following terms are defined in [RFC6020] and are not redefined here:
o augment
o data model
o data node
o presence container
1.2. Tree Diagrams
A simplified graphical representation of the data model is used in this
document. The meaning of the symbols in these diagrams is as follows:
o Brackets "[" and "]" enclose list keys.
o Abbreviations before data node names: "rw" means configuration (read-
write), and "ro" means state data (read-only).
o Symbols after data node names: "?" means an optional node, "!" means
a presence container, and "*" denotes a list and leaf-list.
o Parentheses enclose choice and case nodes, and case nodes are also
marked with a colon (":").
o Ellipsis ("...") stands for contents of subtrees that are not shown.
2. Design of Data Model
The goal of this document is to define a data model that provides a
common user interface to the DHCP protocol. There is very information
that is designated as "mandatory", providing freedom for vendors to
adapt this data model to their respective product implementations.
2.1. Overview
The overall structure of the model is described as the following.
module: ietf-dhcp
+--rw dhcp
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 3]
Internet-Draft DHCP Yang Data Model September 2016
| +--rw server
| | ...
| | ...
| +--rw relay
| | ...
| | ...
| +--rw client
| | ...
| | ...
+--ro dhcp-state
+--ro server
| ...
| ...
+--ro relay
| ...
| ...
+--ro client
...
...
2.2. DHCP Server
Server configurations contain lease time, ping packet, IP address
pool and option configuration.
The most important part is the IP pool configuration. Specifying IP
address section is for dynamic allocation. Configuring the mapping
between IP address and MAC address is for manual allocation.
module: ietf-dhcp
+--rw dchp
+--rw server
+--rw lease-time? uint32
+--rw ping-packet-number? uint8
+--rw ping-packet-timeout? uint16
+--rw option
| +--rw dhcp-server-identifier? inet:ip-address
| +--rw domain-name? string
| +--rw domain-name-server? inet:ip-address
| +--rw interface-mtu? uint32
| +--rw netbios-name-server? inet:ip-address
| +--rw netbios-node-type? uint32
| +--rw netbios-scope? string
+--rw dhcp-ip-pool* [ip-pool-name]
+--rw ip-pool-name string
+--rw interface? -> /if:interfaces/interface/name
+--rw gateway-ip? inet:ip-address
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 4]
Internet-Draft DHCP Yang Data Model September 2016
+--rw gateway-mask? inet:ip-prefix
+--rw lease-time? uint32
+--rw manual-allocation* [mac-address ip-address]
| +--rw mac-address yang:mac-address
| +--rw ip-address inet:ip-address
+--rw section* [section-index]
| +--rw section-index uint16
| +--rw section-start-ip inet:ipv4-address
| +--rw section-end-ip? inet:ipv4-address
+--rw option
+--rw dhcp-server-identifier? inet:ip-address
+--rw domain-name? string
+--rw domain-name-server? inet:ip-address
+--rw interface-mtu? uint32
+--rw netbios-name-server? inet:ip-address
+--rw netbios-node-type? uint32
+--rw netbios-scope? string
2.3. DHCP Relay
The relay function is configured per interface. Enable/disable relay
functionality on a specific interface, and specify the DHCP server.
module: ietf-dhcp
+--rw dchp
+--rw server
...
...
+--rw relay
+--rw server-group* [server-group-name]
+--rw server-group-name string
+--rw interface? -> /if:interfaces/interface/name
+--rw gateway-address? inet:ipv4-address
+--rw server-address* inet:ipv4-address
2.4. DHCP Client
DHCP client is also managed per interface, including enable/disable
client DHCP client function, client id and lease time.
module: ietf-dhcp
+--rw dchp
+--rw server
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 5]
Internet-Draft DHCP Yang Data Model September 2016
...
...
+--rw relay
...
...
+--rw client
+--rw interfaces* [interface]
+--rw interface -> /if:interfaces/interface/name
+--rw client-id? string
+--rw lease? uint32
2.5. DHCP State
The " dhcp-state" records the package statistic information and host
allocated status, including server, relay and client.
module: ietf-dhcp
+--rw dhcp
+--rw server
...
...
+--rw relay
...
...
+--rw client
...
...
+--ro dhcp-state
+--ro server
| +--ro packet-statistics
| | +--ro receive
| | | +--ro decline-packet? uint32
| | | +--ro discover-packet? uint32
| | | +--ro request-packet? uint32
| | | +--ro release-packet? uint32
| | | +--ro inform-packet? uint32
| | +--ro send
| | +--ro offer-packet? uint32
| | +--ro ack-packet? uint32
| | +--ro nack-packet? uint32
| +--ro host
| | +--ro interface? string
| | +--ro host-ip? string
| | +--ro host-hardware-address? string
| | +--ro lease? uint32
| | +--ro type? enumeration
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 6]
Internet-Draft DHCP Yang Data Model September 2016
| +--ro ip-pool* [ip-pool-name]
| +--ro ip-pool-name string
| +--ro gateway-ip? inet:ip-address
| +--ro gateway-mask? inet:ip-prefix
| +--ro used-ip-count? uint32
| +--ro idle-ip-count? uint32
| +--ro conflict-ip-count? uint32
| +--ro total-ip-count? uint32
+--ro relay
| +--ro packet-statistics
| +--ro receive
| | +--ro discover-packet? uint32
| | +--ro offer-packet? uint32
| | +--ro request-packet? uint32
| | +--ro decline-packet? uint32
| | +--ro ack-packet? uint32
| | +--ro nack-packet? uint32
| | +--ro release-packet? uint32
| | +--ro inform-packet? uint32
| +--ro send
| +--ro discover-packet? uint32
| +--ro offer-packet? uint32
| +--ro request-packet? uint32
| +--ro decline-packet? uint32
| +--ro ack-packet? uint32
| +--ro nack-packet? uint32
| +--ro release-packet? uint32
| +--ro inform-packet? uint32
+--ro client
+--ro packet-statistics
+--ro receive
| +--ro offer-packet? uint32
| +--ro ack-packet? uint32
| +--ro nack-packet? uint32
+--ro send
+--ro decline-packet? uint32
+--ro discover-packet? uint32
+--ro request-packet? uint32
+--ro release-packet? uint32
+--ro inform-packet? uint32
3. DHCP YANG Module
<CODE BEGINS> file "ietf-dhcp@2016-08-25.yang"
module ietf-dhcp {
namespace "urn:ietf:params:xml:ns:yang:ietf-dhcp";
prefix "dhcp";
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 7]
Internet-Draft DHCP Yang Data Model September 2016
import ietf-inet-types {
prefix "inet";
}
import ietf-yang-types {
prefix "yang";
}
import ietf-interfaces {
prefix "if";
}
organization "IETF dhc (Dynamic Host Configuration Protocol)
Working Group";
contact "leo.liubing@huawei.com
loukunkun@huawei.com
chin.chen@ericsson.com";
description "The module for implementing DHCP protocol";
revision "2016-08-25" {
description "initial draft revision";
reference "rfc6020";
}
grouping dhcp-option {
description "Configuration option";
leaf dhcp-server-identifier {
type inet:ip-address;
description "DHCP server identifier";
}
leaf domain-name {
type string;
description "Name of the domain";
}
leaf domain-name-server {
type inet:ip-address;
description "IPv4 address of the domain";
}
leaf interface-mtu {
type uint32 {
range "0..65535";
}
description "Minimum Transmission Unit (MTU) of the interface";
}
leaf netbios-name-server {
type inet:ip-address;
description "NETBIOS name server";
}
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 8]
Internet-Draft DHCP Yang Data Model September 2016
leaf netbios-node-type {
type uint32 {
range "0..65535";
}
description "NETBIOS node type";
}
leaf netbios-scope {
type string;
description "NETBIOS scope";
}
}
container dhcp {
description
"DHCP configuration";
container server {
description
"DHCP server configuration";
leaf lease-time {
type uint32{
range "180..31536000";
}
description
"Default network address lease time assigned to DHCP
clients";
}
leaf ping-packet-number{
type uint8 {
range "0..10";
}
default "0";
description "Number of ping packets";
}
leaf ping-packet-timeout {
type uint16 {
range "0..10000";
}
default "500";
description "Timeout of ping packet";
}
container option {
description "Configuration option";
uses dhcp-option;
}
list dhcp-ip-pool {
key "ip-pool-name";
description "Global IP pool configuration";
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 9]
Internet-Draft DHCP Yang Data Model September 2016
leaf ip-pool-name {
type string {
length "1..64";
}
description "Name of the IP pool";
}
leaf interface {
type leafref {
path "/if:interfaces/if:interface/if:name";
}
description
"Name of the interface";
}
leaf gateway-ip {
type inet:ip-address;
description "IPv4 address of the gateway";
}
leaf gateway-mask {
type inet:ip-prefix;
description "Network submask of the gateway";
}
leaf lease-time {
type uint32 {
range "180..31536000";
}
description
"Default network address lease time assigned to DHCP
clients";
}
list manual-allocation {
key "mac-address ip-address";
description "Mapping from MAC address to IP address";
leaf mac-address {
type yang:mac-address;
description "MAC address of the host";
}
leaf ip-address {
type inet:ip-address;
description "IPv4 address of the host";
}
}
list section {
key "section-index";
description "IPv4 address for the range";
leaf section-index {
type uint16 {
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 10]
Internet-Draft DHCP Yang Data Model September 2016
range "0..255";
}
description "Index of IPv4 address range";
}
leaf section-start-ip {
type inet:ipv4-address;
mandatory "true";
description "Starting IPv4 Address of a section";
}
leaf section-end-ip {
type inet:ipv4-address;
description "Last IPv4 Address of a section";
}
}
container option {
description "Configuration option";
uses dhcp-option;
}
}
}
container relay {
description
"DHCP relay agent configuration";
list server-group {
key "server-group-name";
description
"DHCP server group configuration that DHCP relays to";
leaf server-group-name {
type string;
description "Name of a DHCP server group";
}
leaf interface {
type leafref {
path "/if:interfaces/if:interface/if:name";
}
description
"Name of the interface";
}
leaf gateway-address {
type inet:ipv4-address;
description "IPv4 address of the gateway";
}
leaf-list server-address {
type inet:ipv4-address;
description
"IPv4 address of the server";
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 11]
Internet-Draft DHCP Yang Data Model September 2016
}
}
}
container client {
description "DHCP client configuration";
list interfaces {
key "interface";
description "Interface configuration";
leaf interface {
type leafref {
path "/if:interfaces/if:interface/if:name";
}
description "Name of the interface";
}
leaf client-id {
type string;
description "DHCP client identifier";
}
leaf lease {
type uint32 {
range "1..4294967295";
}
description "Default network address lease time assigned to
DHCP clients";
}
}
}
}
container dhcp-state {
config "false";
description
"DHCP state data";
container server {
description
"DHCP server state data";
container packet-statistics {
description
"Packet statistics";
container receive {
description
"Number of received packets";
leaf decline-packet {
type uint32;
config "false";
description "Total number of DHCPDECLINE packets";
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 12]
Internet-Draft DHCP Yang Data Model September 2016
}
leaf discover-packet {
type uint32;
config "false";
description "Total number of DHCPDISCOVER packets";
}
leaf request-packet {
type uint32;
config "false";
description "Total number of DHCPREQUEST packets";
}
leaf release-packet {
type uint32;
config "false";
description "Total number of DHCPRELEASE packets";
}
leaf inform-packet {
type uint32;
config "false";
description "Total number of DHCPINFORM packets";
}
}
container send {
description
"Number of sent packets";
leaf offer-packet {
type uint32;
config "false";
description "Total number of DHCPOFFER packets";
}
leaf ack-packet {
type uint32;
config "false";
description "Total number of DHCPACK packets";
}
leaf nack-packet {
type uint32;
config "false";
description "Total number of DHCPNAK packets";
}
}
}
container host {
description
"Host status information";
leaf interface {
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 13]
Internet-Draft DHCP Yang Data Model September 2016
type string;
config "false";
description "Name of the interface";
}
leaf host-ip {
type string;
config "false";
description "IPv4 address of the host";
}
leaf host-hardware-address {
type string;
config "false";
description "MAC address of the host";
}
leaf lease {
type uint32;
config "false";
description "Default network address lease
time assigned to DHCP clients";
}
leaf type {
type enumeration {
enum automatic{
description
"DHCP assigns a permanent IP address to a client";
}
enum dynamic{
description
"DHCP assigns an IP address to a client
for a limited period of time";
}
enum manual{
description
"a client's IP address is assigned by the
network administrator, and DHCP is used
simply to convey the assigned address to the client";
}
}
config "false";
description "Mechanisms for IP address allocation";
}
}
list ip-pool {
key "ip-pool-name";
description "Global IP pool configuration";
leaf ip-pool-name {
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 14]
Internet-Draft DHCP Yang Data Model September 2016
type string {
length "1..64";
}
description "Name of an IP pool";
}
leaf gateway-ip {
type inet:ip-address;
description "IPv4 address of the gateway";
}
leaf gateway-mask {
type inet:ip-prefix;
description "Network submask of the gateway";
}
leaf used-ip-count {
type uint32;
config "false";
description "Total number of used IPv4 addresses";
}
leaf idle-ip-count {
type uint32;
config "false";
description "Total number of idle IPv4 addresses";
}
leaf conflict-ip-count {
type uint32;
config "false";
description "Total number of conflict IPv4 addresses";
}
leaf total-ip-count {
type uint32;
config "false";
description "Total number of IPv4 addresses";
}
}
}
container relay {
description
"DHCP reply agent state data";
container packet-statistics {
description
"Packet statistics";
container receive {
description
"Number of received packets";
leaf discover-packet {
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 15]
Internet-Draft DHCP Yang Data Model September 2016
type uint32;
config "false";
description "Total number of DHCPDISCOVER packets";
}
leaf offer-packet {
type uint32;
config "false";
description "Total number of DHCPOFFER packets";
}
leaf request-packet {
type uint32;
config "false";
description "Total number of DHCPREQUEST packets";
}
leaf decline-packet {
type uint32;
config "false";
description "Total number of DHCPDECLINE packets";
}
leaf ack-packet {
type uint32;
config "false";
description "Total number of DHCPACK packets";
}
leaf nack-packet {
type uint32;
config "false";
description "Total number of DHCPNAK packets";
}
leaf release-packet {
type uint32;
config "false";
description "Total number of DHCPRELEASE packets";
}
leaf inform-packet {
type uint32;
config "false";
description "Total number of DHCPINFORM packets";
}
}
container send {
description
"Number of sent packets";
leaf discover-packet {
type uint32;
config "false";
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 16]
Internet-Draft DHCP Yang Data Model September 2016
description "Total number of DHCPDISCOVER packets";
}
leaf offer-packet {
type uint32;
config "false";
description "Total number of DHCPOFFER packets";
}
leaf request-packet {
type uint32;
config "false";
description "Total number of DHCPREQUEST packets";
}
leaf decline-packet {
type uint32;
config "false";
description "Total number of DHCPDECLINE packets";
}
leaf ack-packet {
type uint32;
config "false";
description "Total number of DHCPACK packets";
}
leaf nack-packet {
type uint32;
config "false";
description "Total number of DHCPNAK packets";
}
leaf release-packet {
type uint32;
config "false";
description "Total number of DHCPRELEASE packets";
}
leaf inform-packet {
type uint32;
config "false";
description "Total number of DHCPINFORM packets";
}
}
}
}
container client {
description
"DHCP client state data";
container packet-statistics {
description
"Packet statistics";
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 17]
Internet-Draft DHCP Yang Data Model September 2016
container receive {
description
"Number of received packets";
leaf offer-packet {
type uint32;
config "false";
description "Total number of DHCPOFFER packets";
}
leaf ack-packet {
type uint32;
config "false";
description "Total number of DHCPACK packets";
}
leaf nack-packet {
type uint32;
config "false";
description "Total number of DHCPNAK packets";
}
}
container send {
description
"Number of sent packets";
leaf decline-packet {
type uint32;
config "false";
description "Total number of DHCPDECLINE packets";
}
leaf discover-packet {
type uint32;
config "false";
description "Total number of DHCPDISCOVER packets";
}
leaf request-packet {
type uint32;
config "false";
description "Total number of DHCPREQUEST packets";
}
leaf release-packet {
type uint32;
config "false";
description "Total number of DHCPRELEASE packets";
}
leaf inform-packet {
type uint32;
config "false";
description "Total number of DHCPINFORM packets";
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 18]
Internet-Draft DHCP Yang Data Model September 2016
}
}
}
}
}
}
<CODE ENDS>
4. Security Considerations
The data model defined does not create any security implications.
5. Contributors
The following people all contributed significantly to the initial
YANG model:
- Gang Yan (Huawei)
- Hongying Sheng (Ericsson)
6. IANA Considerations
This draft does not request any IANA action.
7. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2131] Droms, R., "Dynamic Host Configuration Protocol", RFC 2131,
DOI 10.17487/RFC2131, March 1997, <http://www.rfc-
editor.org/info/rfc2131>.
[RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, DOI
10.17487/RFC2629, June 1999, <http://www.rfc-
editor.org/info/rfc2629>.
[RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for the
Network Configuration Protocol (NETCONF)", RFC 6020, DOI
10.17487/RFC6020, October 2010, <http://www.rfc-
editor.org/info/rfc6020>.
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 19]
Internet-Draft DHCP Yang Data Model September 2016
[RFC6021] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC 6021,
DOI 10.17487/RFC6021, October 2010, <http://www.rfc-
editor.org/info/rfc6021>.
Authors' Addresses
Bing Liu
Huawei Technologies
Q14, Huawei Campus, No.156 Beiqing Road
Hai-Dian District, Beijing, 100095
P.R. China
Email: leo.liubing@huawei.com
Kunkun Lou
Huawei Technologies
Huawei Nanjing R&D Center
101 Software Avenue, Yuhua District, Nanjing, Jiangsu, 210012
P.R. China
Email: loukunkun@huawei.com
Chin Chen
Ericsson (China) Communications Company Ltd.
Ericsson Tower, No. 5 Lize East Street,
Chaoyang District Beijing 100102, P.R. China
Email: chin.chen@ericsson.com
Liu, Ed. & Lou & Chen Expires March 5, 2017 [Page 20]