Internet DRAFT - draft-walton-bgp-hostname-capability
draft-walton-bgp-hostname-capability
Network Working Group D. Walton
Internet-Draft D. Dutt
Intended status: Standards Track Cumulus Networks
Expires: July 9, 2016 January 6, 2016
Hostname Capability for BGP
draft-walton-bgp-hostname-capability-02
Abstract
In this document, we introduce a new BGP capability that allows the
advertisemnet of a BGP speaker's hostname.
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). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
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."
This Internet-Draft will expire on July 9, 2016.
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 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.
Walton & Dutt Expires July 9, 2016 [Page 1]
Internet-Draft Hostname Capability for BGP January 2016
1. Introduction
BGP is increasingly used inside the data center. Due to the sheer
scale of devices involved, simplifying troubleshooting BGP would be
very useful. One simple way to ease the troubleshooting is to
display the hostname of the speaker in addition to the speaker's IP
address. This document defines a new BGP capability that allows the
exchange of a speaker's FQDN.
2. Specification of Requirements
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [RFC2119].
3. FQDN Capability
The FQDN Capability is a new BGP capability [RFC5492]. The
Capability Code for this capability is specified in the IANA
Considerations section of this document. The Capability Length field
of this capability is variable. The Capability Value field consists
of the following:
+--------------------------------+
| Hostname Length (1 octet) |
+--------------------------------+
| Hostname (variable) |
+--------------------------------+
| Domain Name Length (1 octet) |
+--------------------------------+
| Domain Name (variable) |
+--------------------------------+
Hostname Length:
The number of characters in the Hostname
Hostname:
The hostname encoded via UTF-8
Domain Name Length:
The number of characters in the Domain Name
Domain Name:
The domain name encoded via UTF-8
Walton & Dutt Expires July 9, 2016 [Page 2]
Internet-Draft Hostname Capability for BGP January 2016
4. Operation
The FQDN Capability SHOULD only be used for displaying the hostname
and/or domain name of a speaker in order to make troubleshooting
easier. The hostname and domain name used are assumed to be
extracted from the hostname and domain name set on the device. While
there are other ways to potentially obtain the same information,
having standard BGP show commands use the hostname makes the use of
this option quite powerful.
An example of showing hostname in various displays is show below in
the output of the summary of BGP peering relationships, the first
being the typical display today, and the second the display when
displaying hostnames is enabled:
cumulus@r1$ sudo cl-bgp summary
BGP router identifier 10.0.0.1, local AS number 10
BGP table version 7000
RIB entries 7999, using 937 KiB of memory
Peers 16, using 268 KiB of memory
Peer groups 4, using 224 bytes of memory
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd
10.0.0.2 4 10 103 204 0 0 0 00:01:21 1000
10.0.0.3 4 10 103 204 0 0 0 00:01:21 1000
10.0.0.4 4 10 203 204 0 0 0 00:01:21 2000
20.1.1.6 4 20 403 589 0 0 0 00:01:37 1000
20.1.1.7 4 20 403 589 0 0 0 00:01:35 1000
40.1.1.2 4 40 403 689 0 0 0 00:01:40 1000
40.1.1.6 4 40 403 689 0 0 0 00:01:48 1000
40.1.1.10 4 40 403 689 0 0 0 00:01:40 1000
Total number of neighbors 8
cumulus@r1$
Walton & Dutt Expires July 9, 2016 [Page 3]
Internet-Draft Hostname Capability for BGP January 2016
cumulus@r1$ sudo cl-bgp summary
BGP router identifier 10.0.0.1, local AS number 10
BGP table version 7000
RIB entries 7999, using 937 KiB of memory
Peers 16, using 268 KiB of memory
Peer groups 4, using 224 bytes of memory
Neighbor V AS MsgRcvd MsgSent TblVer InQ OutQ Up/Down State/PfxRcd
r2(10.0.0.2) 4 10 104 205 0 0 0 00:02:05 1000
r3(10.0.0.3) 4 10 104 205 0 0 0 00:02:05 1000
r4(10.0.0.4) 4 10 204 205 0 0 0 00:02:05 2000
r6(20.1.1.6) 4 20 404 590 0 0 0 00:02:21 1000
r7(20.1.1.7) 4 20 404 590 0 0 0 00:02:19 1000
r8(40.1.1.2) 4 40 404 690 0 0 0 00:02:24 1000
r9(40.1.1.6) 4 40 404 690 0 0 0 00:02:32 1000
r10(40.1.1.10) 4 40 404 690 0 0 0 00:02:24 1000
Total number of neighbors 8
cumulus@r1$
5. IANA Considerations
IANA has assigned capability number 73 for the FQDN Capability
described in this document. This registration is in the BGP
Capability Codes registry.
6. Security Considerations
This document introduces no new security concerns to BGP or other
specifications referenced in this document.
7. References
7.1. Normative References
[RFC5492] Scudder, J. and R. Chandra, "Capabilities Advertisement
with BGP-4", RFC 5492, DOI 10.17487/RFC5492, February
2009, <http://www.rfc-editor.org/info/rfc5492>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997,
<http://www.rfc-editor.org/info/rfc2119>.
Walton & Dutt Expires July 9, 2016 [Page 4]
Internet-Draft Hostname Capability for BGP January 2016
7.2. Implementation References
[quagga] Dutt, D., "Quagga - BGP FQDN Capability", January 2016,
<https://github.com/CumulusNetworks/quagga/
commit/45d4b165b9d01c0e98082e7d1e90a3b1a60b1085>.
Authors' Addresses
Daniel Walton
Cumulus Networks
3701 NW Cary Parkway, Suite #300
Cary, NC 27513
US
Email: dwalton@cumulusnetworks.com
Dinesh Dutt
Cumulus Networks
185 E. Dana Street
Mountain View, CA 94041
US
Email: ddutt@cumulusnetworks.com
Walton & Dutt Expires July 9, 2016 [Page 5]
