| < draft-ietf-bfd-rfc9127-bis-03.txt | draft-ietf-bfd-rfc9127-bis-04.txt > | |||
|---|---|---|---|---|
| skipping to change at page 1, line 16 ¶ | skipping to change at page 1, line 16 ¶ | |||
| Intended status: Standards Track | Intended status: Standards Track | |||
| Expires: 8 October 2022 L. Zheng, Ed. | Expires: 8 October 2022 L. Zheng, Ed. | |||
| Huawei Technologies | Huawei Technologies | |||
| S. Pallagatti | S. Pallagatti | |||
| VMware | VMware | |||
| G. Mirsky | G. Mirsky | |||
| Ericsson | Ericsson | |||
| 6 April 2022 | 6 April 2022 | |||
| YANG Data Model for Bidirectional Forwarding Detection (BFD) | YANG Data Model for Bidirectional Forwarding Detection (BFD) | |||
| draft-ietf-bfd-rfc9127-bis-03 | draft-ietf-bfd-rfc9127-bis-04 | |||
| Abstract | Abstract | |||
| This document defines a YANG data model that can be used to configure | This document defines a YANG data model that can be used to configure | |||
| and manage Bidirectional Forwarding Detection (BFD). | and manage Bidirectional Forwarding Detection (BFD). | |||
| The YANG modules in this document conform to the Network Management | The YANG modules in this document conform to the Network Management | |||
| Datastore Architecture (NMDA) (RFC 8342). This document updates YANG | Datastore Architecture (NMDA) (RFC 8342). This document updates YANG | |||
| Data Model for Bidirectional Forwarding Detection (BFD) (RFC 9127). | Data Model for Bidirectional Forwarding Detection (BFD) (RFC 9127). | |||
| skipping to change at page 3, line 5 ¶ | skipping to change at page 3, line 5 ¶ | |||
| 3. Data Model Examples . . . . . . . . . . . . . . . . . . . . . 53 | 3. Data Model Examples . . . . . . . . . . . . . . . . . . . . . 53 | |||
| 3.1. IP Single-Hop . . . . . . . . . . . . . . . . . . . . . . 53 | 3.1. IP Single-Hop . . . . . . . . . . . . . . . . . . . . . . 53 | |||
| 3.2. IP Multihop . . . . . . . . . . . . . . . . . . . . . . . 54 | 3.2. IP Multihop . . . . . . . . . . . . . . . . . . . . . . . 54 | |||
| 3.3. LAG . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 | 3.3. LAG . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 | |||
| 3.4. MPLS . . . . . . . . . . . . . . . . . . . . . . . . . . 56 | 3.4. MPLS . . . . . . . . . . . . . . . . . . . . . . . . . . 56 | |||
| 4. Security Considerations . . . . . . . . . . . . . . . . . . . 57 | 4. Security Considerations . . . . . . . . . . . . . . . . . . . 57 | |||
| 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 61 | 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 61 | |||
| 6. References . . . . . . . . . . . . . . . . . . . . . . . . . 62 | 6. References . . . . . . . . . . . . . . . . . . . . . . . . . 62 | |||
| 6.1. Normative References . . . . . . . . . . . . . . . . . . 62 | 6.1. Normative References . . . . . . . . . . . . . . . . . . 62 | |||
| 6.2. Informative References . . . . . . . . . . . . . . . . . 65 | 6.2. Informative References . . . . . . . . . . . . . . . . . 65 | |||
| Appendix A. Echo Function Configuration Example . . . . . . . . 65 | Appendix A. Echo Function Configuration Example . . . . . . . . 66 | |||
| A.1. Example YANG Module for BFD Echo Function | A.1. Example YANG Module for BFD Echo Function | |||
| Configuration . . . . . . . . . . . . . . . . . . . . . . 66 | Configuration . . . . . . . . . . . . . . . . . . . . . . 66 | |||
| Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 68 | Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 68 | |||
| Updates since RFC 9127 . . . . . . . . . . . . . . . . . . . . . 68 | Updates since RFC 9127 . . . . . . . . . . . . . . . . . . . . . 68 | |||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 68 | Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 69 | |||
| 1. Introduction | 1. Introduction | |||
| This document defines a YANG data model that can be used to configure | This document defines a YANG data model that can be used to configure | |||
| and manage Bidirectional Forwarding Detection (BFD) [RFC5880]. BFD | and manage Bidirectional Forwarding Detection (BFD) [RFC5880]. BFD | |||
| is a network protocol that is used for liveness detection of | is a network protocol that is used for liveness detection of | |||
| arbitrary paths between systems. Some examples of different types of | arbitrary paths between systems. Some examples of different types of | |||
| paths over which we have BFD are as follows: | paths over which we have BFD are as follows: | |||
| 1. Two systems directly connected via IP. This is known as BFD over | 1. Two systems directly connected via IP. This is known as BFD over | |||
| skipping to change at page 20, line 41 ¶ | skipping to change at page 20, line 41 ¶ | |||
| /rt:routing/mpls:mpls/mpls:interfaces/mpls:interface/ | /rt:routing/mpls:mpls/mpls:interfaces/mpls:interface/ | |||
| mpls:mpls-enabled | mpls:mpls-enabled | |||
| If this configuration is set to "false", no BFD MPLS packets can | If this configuration is set to "false", no BFD MPLS packets can | |||
| be transmitted or received on that interface. | be transmitted or received on that interface. | |||
| 2.11. BFD Types YANG Module | 2.11. BFD Types YANG Module | |||
| This YANG module imports typedefs from [RFC6991] and [RFC8177]. It | This YANG module imports typedefs from [RFC6991] and [RFC8177]. It | |||
| also imports definitions from [RFC5880], [RFC5881], [RFC5883], | also imports definitions from [RFC5880], [RFC5881], [RFC5883], | |||
| [RFC5884], and [RFC7130], as well as the "control-plane-protocol" | [RFC5884], and [RFC7130], as well as the "control-plane-protocol" | |||
| identity from [RFC8349]. | identity from [RFC8349], and references [RFC9127]. | |||
| <CODE BEGINS> file "ietf-bfd-types@2022-04-06.yang" | <CODE BEGINS> file "ietf-bfd-types@2022-04-06.yang" | |||
| module ietf-bfd-types { | module ietf-bfd-types { | |||
| yang-version 1.1; | yang-version 1.1; | |||
| namespace "urn:ietf:params:xml:ns:yang:ietf-bfd-types"; | namespace "urn:ietf:params:xml:ns:yang:ietf-bfd-types"; | |||
| prefix bfd-types; | prefix bfd-types; | |||
| import iana-bfd-types { | import iana-bfd-types { | |||
| prefix iana-bfd-types; | prefix iana-bfd-types; | |||
| reference | reference | |||
| skipping to change at page 36, line 17 ¶ | skipping to change at page 36, line 17 ¶ | |||
| <mailto:mjethanandani@gmail.com>"; | <mailto:mjethanandani@gmail.com>"; | |||
| description | description | |||
| "This module contains the YANG definition for BFD parameters as | "This module contains the YANG definition for BFD parameters as | |||
| per RFC 5880. | per RFC 5880. | |||
| Copyright (c) 2021 IETF Trust and the persons identified as | Copyright (c) 2021 IETF Trust and the persons identified as | |||
| authors of the code. All rights reserved. | authors of the code. All rights reserved. | |||
| Redistribution and use in source and binary forms, with or | Redistribution and use in source and binary forms, with or | |||
| without modification, is permitted pursuant to, and subject to | without modification, is permitted pursuant to, and subject to | |||
| the license terms contained in, the Simplified BSD License set | the license terms contained in, the Revised BSD License set | |||
| forth in Section 4.c of the IETF Trust's Legal Provisions | forth in Section 4.c of the IETF Trust's Legal Provisions | |||
| Relating to IETF Documents | Relating to IETF Documents | |||
| (https://trustee.ietf.org/license-info). | (https://trustee.ietf.org/license-info). | |||
| This version of this YANG module is part of RFC XXXX; see the | This version of this YANG module is part of RFC XXXX; see the | |||
| RFC itself for full legal notices."; | RFC itself for full legal notices."; | |||
| reference | reference | |||
| "RFC 5880: Bidirectional Forwarding Detection (BFD) | "RFC 5880: Bidirectional Forwarding Detection (BFD) | |||
| RFC XXXX: YANG Data Model for Bidirectional Forwarding | RFC XXXX: YANG Data Model for Bidirectional Forwarding | |||
| Detection (BFD)"; | Detection (BFD)"; | |||
| skipping to change at page 38, line 32 ¶ | skipping to change at page 38, line 32 ¶ | |||
| <mailto:mjethanandani@gmail.com>"; | <mailto:mjethanandani@gmail.com>"; | |||
| description | description | |||
| "This module contains the YANG definition for BFD IP single-hop | "This module contains the YANG definition for BFD IP single-hop | |||
| as per RFC 5881. | as per RFC 5881. | |||
| Copyright (c) 2021 IETF Trust and the persons identified as | Copyright (c) 2021 IETF Trust and the persons identified as | |||
| authors of the code. All rights reserved. | authors of the code. All rights reserved. | |||
| Redistribution and use in source and binary forms, with or | Redistribution and use in source and binary forms, with or | |||
| without modification, is permitted pursuant to, and subject to | without modification, is permitted pursuant to, and subject to | |||
| the license terms contained in, the Simplified BSD License set | the license terms contained in, the Revised BSD License set | |||
| forth in Section 4.c of the IETF Trust's Legal Provisions | forth in Section 4.c of the IETF Trust's Legal Provisions | |||
| Relating to IETF Documents | Relating to IETF Documents | |||
| (https://trustee.ietf.org/license-info). | (https://trustee.ietf.org/license-info). | |||
| This version of this YANG module is part of RFC XXXX; see the | This version of this YANG module is part of RFC XXXX; see the | |||
| RFC itself for full legal notices."; | RFC itself for full legal notices."; | |||
| reference | reference | |||
| "RFC 5881: Bidirectional Forwarding Detection (BFD) | "RFC 5881: Bidirectional Forwarding Detection (BFD) | |||
| for IPv4 and IPv6 (Single Hop) | for IPv4 and IPv6 (Single Hop) | |||
| RFC XXXX: YANG Data Model for Bidirectional Forwarding | RFC XXXX: YANG Data Model for Bidirectional Forwarding | |||
| skipping to change at page 42, line 10 ¶ | skipping to change at page 42, line 10 ¶ | |||
| <mailto:mjethanandani@gmail.com>"; | <mailto:mjethanandani@gmail.com>"; | |||
| description | description | |||
| "This module contains the YANG definition for BFD IP multihop | "This module contains the YANG definition for BFD IP multihop | |||
| as per RFC 5883. | as per RFC 5883. | |||
| Copyright (c) 2021 IETF Trust and the persons identified as | Copyright (c) 2021 IETF Trust and the persons identified as | |||
| authors of the code. All rights reserved. | authors of the code. All rights reserved. | |||
| Redistribution and use in source and binary forms, with or | Redistribution and use in source and binary forms, with or | |||
| without modification, is permitted pursuant to, and subject to | without modification, is permitted pursuant to, and subject to | |||
| the license terms contained in, the Simplified BSD License set | the license terms contained in, the Revised BSD License set | |||
| forth in Section 4.c of the IETF Trust's Legal Provisions | forth in Section 4.c of the IETF Trust's Legal Provisions | |||
| Relating to IETF Documents | Relating to IETF Documents | |||
| (https://trustee.ietf.org/license-info). | (https://trustee.ietf.org/license-info). | |||
| This version of this YANG module is part of RFC XXXX; see the | This version of this YANG module is part of RFC XXXX; see the | |||
| RFC itself for full legal notices."; | RFC itself for full legal notices."; | |||
| reference | reference | |||
| "RFC 5883: Bidirectional Forwarding Detection (BFD) for | "RFC 5883: Bidirectional Forwarding Detection (BFD) for | |||
| Multihop Paths | Multihop Paths | |||
| RFC XXXX: YANG Data Model for Bidirectional Forwarding | RFC XXXX: YANG Data Model for Bidirectional Forwarding | |||
| skipping to change at page 45, line 32 ¶ | skipping to change at page 45, line 32 ¶ | |||
| <mailto:mjethanandani@gmail.com>"; | <mailto:mjethanandani@gmail.com>"; | |||
| description | description | |||
| "This module contains the YANG definition for BFD-over-LAG | "This module contains the YANG definition for BFD-over-LAG | |||
| interfaces as per RFC 7130. | interfaces as per RFC 7130. | |||
| Copyright (c) 2021 IETF Trust and the persons identified as | Copyright (c) 2021 IETF Trust and the persons identified as | |||
| authors of the code. All rights reserved. | authors of the code. All rights reserved. | |||
| Redistribution and use in source and binary forms, with or | Redistribution and use in source and binary forms, with or | |||
| without modification, is permitted pursuant to, and subject to | without modification, is permitted pursuant to, and subject to | |||
| the license terms contained in, the Simplified BSD License set | the license terms contained in, the Revised BSD License set | |||
| forth in Section 4.c of the IETF Trust's Legal Provisions | forth in Section 4.c of the IETF Trust's Legal Provisions | |||
| Relating to IETF Documents | Relating to IETF Documents | |||
| (https://trustee.ietf.org/license-info). | (https://trustee.ietf.org/license-info). | |||
| This version of this YANG module is part of RFC XXXX; see the | This version of this YANG module is part of RFC XXXX; see the | |||
| RFC itself for full legal notices."; | RFC itself for full legal notices."; | |||
| reference | reference | |||
| "RFC 7130: Bidirectional Forwarding Detection (BFD) on | "RFC 7130: Bidirectional Forwarding Detection (BFD) on | |||
| Link Aggregation Group (LAG) Interfaces | Link Aggregation Group (LAG) Interfaces | |||
| RFC XXXX: YANG Data Model for Bidirectional Forwarding | RFC XXXX: YANG Data Model for Bidirectional Forwarding | |||
| skipping to change at page 49, line 41 ¶ | skipping to change at page 49, line 41 ¶ | |||
| <mailto:mjethanandani@gmail.com>"; | <mailto:mjethanandani@gmail.com>"; | |||
| description | description | |||
| "This module contains the YANG definition for BFD parameters for | "This module contains the YANG definition for BFD parameters for | |||
| MPLS LSPs as per RFC 5884. | MPLS LSPs as per RFC 5884. | |||
| Copyright (c) 2021 IETF Trust and the persons identified as | Copyright (c) 2021 IETF Trust and the persons identified as | |||
| authors of the code. All rights reserved. | authors of the code. All rights reserved. | |||
| Redistribution and use in source and binary forms, with or | Redistribution and use in source and binary forms, with or | |||
| without modification, is permitted pursuant to, and subject to | without modification, is permitted pursuant to, and subject to | |||
| the license terms contained in, the Simplified BSD License set | the license terms contained in, the Revised BSD License set | |||
| forth in Section 4.c of the IETF Trust's Legal Provisions | forth in Section 4.c of the IETF Trust's Legal Provisions | |||
| Relating to IETF Documents | Relating to IETF Documents | |||
| (https://trustee.ietf.org/license-info). | (https://trustee.ietf.org/license-info). | |||
| This version of this YANG module is part of RFC XXXX; see the | This version of this YANG module is part of RFC XXXX; see the | |||
| RFC itself for full legal notices."; | RFC itself for full legal notices."; | |||
| reference | reference | |||
| "RFC 5884: Bidirectional Forwarding Detection (BFD) | "RFC 5884: Bidirectional Forwarding Detection (BFD) | |||
| for MPLS Label Switched Paths (LSPs) | for MPLS Label Switched Paths (LSPs) | |||
| RFC XXXX: YANG Data Model for Bidirectional Forwarding | RFC XXXX: YANG Data Model for Bidirectional Forwarding | |||
| skipping to change at page 65, line 10 ¶ | skipping to change at page 65, line 10 ¶ | |||
| [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol | [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol | |||
| Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, | Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, | |||
| <https://www.rfc-editor.org/info/rfc8446>. | <https://www.rfc-editor.org/info/rfc8446>. | |||
| [RFC8960] Saad, T., Raza, K., Gandhi, R., Liu, X., and V. Beeram, "A | [RFC8960] Saad, T., Raza, K., Gandhi, R., Liu, X., and V. Beeram, "A | |||
| YANG Data Model for MPLS Base", RFC 8960, | YANG Data Model for MPLS Base", RFC 8960, | |||
| DOI 10.17487/RFC8960, December 2020, | DOI 10.17487/RFC8960, December 2020, | |||
| <https://www.rfc-editor.org/info/rfc8960>. | <https://www.rfc-editor.org/info/rfc8960>. | |||
| [RFC9127] Rahman, R., Zheng, L., Jethanandani, M., Pallagatti, S., | ||||
| and G. Mirsky, "YANG Data Model for Bidirectional | ||||
| Forwarding Detection (BFD)", RFC 9127, | ||||
| DOI 10.17487/RFC9127, October 2021, | ||||
| <https://www.rfc-editor.org/info/rfc9127>. | ||||
| 6.2. Informative References | 6.2. Informative References | |||
| [RFC3031] Rosen, E., Viswanathan, A., and R. Callon, "Multiprotocol | [RFC3031] Rosen, E., Viswanathan, A., and R. Callon, "Multiprotocol | |||
| Label Switching Architecture", RFC 3031, | Label Switching Architecture", RFC 3031, | |||
| DOI 10.17487/RFC3031, January 2001, | DOI 10.17487/RFC3031, January 2001, | |||
| <https://www.rfc-editor.org/info/rfc3031>. | <https://www.rfc-editor.org/info/rfc3031>. | |||
| [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., | [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., | |||
| and R. Wilton, "Network Management Datastore Architecture | and R. Wilton, "Network Management Datastore Architecture | |||
| (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, | (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, | |||
| skipping to change at page 67, line 11 ¶ | skipping to change at page 67, line 19 ¶ | |||
| <mailto:mjethanandani@gmail.com>"; | <mailto:mjethanandani@gmail.com>"; | |||
| description | description | |||
| "This module contains an example YANG augmentation for | "This module contains an example YANG augmentation for | |||
| configuration of the BFD Echo function. | configuration of the BFD Echo function. | |||
| Copyright (c) 2021 IETF Trust and the persons identified as | Copyright (c) 2021 IETF Trust and the persons identified as | |||
| authors of the code. All rights reserved. | authors of the code. All rights reserved. | |||
| Redistribution and use in source and binary forms, with or | Redistribution and use in source and binary forms, with or | |||
| without modification, is permitted pursuant to, and subject to | without modification, is permitted pursuant to, and subject to | |||
| the license terms contained in, the Simplified BSD License set | the license terms contained in, the Revised BSD License set | |||
| forth in Section 4.c of the IETF Trust's Legal Provisions | forth in Section 4.c of the IETF Trust's Legal Provisions | |||
| Relating to IETF Documents | Relating to IETF Documents | |||
| (https://trustee.ietf.org/license-info). | (https://trustee.ietf.org/license-info). | |||
| This version of this YANG module is part of RFC 9127; see the | This version of this YANG module is part of RFC 9127; see the | |||
| RFC itself for full legal notices."; | RFC itself for full legal notices."; | |||
| revision 2021-09-03 { | revision 2021-09-03 { | |||
| description | description | |||
| "Initial revision."; | "Initial revision."; | |||
| End of changes. 11 change blocks. | ||||
| 10 lines changed or deleted | 16 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||