Skip to content

Commit a32a6c7

Browse files
Graf ThomasGraf Thomas
Graf Thomas
authored and
Graf Thomas
committed
nit
1 parent 64f0e3d commit a32a6c7

2 files changed

+71
-71
lines changed

‎draft-ietf-netconf-distributed-notif-07.txt

+60-60
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,13 @@
55
NETCONF T. Zhou
66
Internet-Draft G. Zheng
77
Intended status: Standards Track Huawei
8-
Expires: 24 November 2023 E. Voit
8+
Expires: 29 November 2023 E. Voit
99
Cisco Systems
1010
T. Graf
1111
Swisscom
1212
P. Francois
1313
INSA-Lyon
14-
23 May 2023
14+
28 May 2023
1515

1616

1717
Subscription to Distributed Notifications
@@ -48,12 +48,12 @@ Status of This Memo
4848
time. It is inappropriate to use Internet-Drafts as reference
4949
material or to cite them other than as "work in progress."
5050

51-
This Internet-Draft will expire on 24 November 2023.
51+
This Internet-Draft will expire on 29 November 2023.
5252

5353

5454

5555

56-
Zhou, et al. Expires 24 November 2023 [Page 1]
56+
Zhou, et al. Expires 29 November 2023 [Page 1]
5757

5858
Internet-Draft Distributed Notifications May 2023
5959

@@ -82,12 +82,12 @@ Table of Contents
8282
6. Publication Composition . . . . . . . . . . . . . . . . . . . 6
8383
7. Subscription State Change Notifications . . . . . . . . . . . 7
8484
8. Publisher Configurations . . . . . . . . . . . . . . . . . . 7
85-
9. YANG Tree . . . . . . . . . . . . . . . . . . . . . . . . . . 8
85+
9. YANG Tree . . . . . . . . . . . . . . . . . . . . . . . . . . 7
8686
10. YANG Module . . . . . . . . . . . . . . . . . . . . . . . . . 8
8787
11. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 10
8888
12. Implementation Status . . . . . . . . . . . . . . . . . . . . 10
8989
12.1. Open Source Publisher . . . . . . . . . . . . . . . . . 10
90-
12.2. Open Source Reveiver Library . . . . . . . . . . . . . . 11
90+
12.2. Open Source Receiver Library . . . . . . . . . . . . . . 11
9191
12.3. Pmacct Data Collection . . . . . . . . . . . . . . . . . 11
9292
12.4. Huawei VRP . . . . . . . . . . . . . . . . . . . . . . . 11
9393
13. Operational Considerations . . . . . . . . . . . . . . . . . 11
@@ -109,7 +109,7 @@ Table of Contents
109109

110110

111111

112-
Zhou, et al. Expires 24 November 2023 [Page 2]
112+
Zhou, et al. Expires 29 November 2023 [Page 2]
113113

114114
Internet-Draft Distributed Notifications May 2023
115115

@@ -130,7 +130,7 @@ Internet-Draft Distributed Notifications May 2023
130130
target Receivers to further increase efficiency on the routing
131131
system.
132132

133-
This document complement the general subscription requirements
133+
This document complements the general subscription requirements
134134
defined in section 4.2.1 of [RFC7923] by the paragraph: A
135135
Subscription Service MAY support the ability to export from multiple
136136
software processes on a single routing system and expose the
@@ -165,7 +165,7 @@ Internet-Draft Distributed Notifications May 2023
165165

166166

167167

168-
Zhou, et al. Expires 24 November 2023 [Page 3]
168+
Zhou, et al. Expires 29 November 2023 [Page 3]
169169

170170
Internet-Draft Distributed Notifications May 2023
171171

@@ -214,14 +214,14 @@ Internet-Draft Distributed Notifications May 2023
214214
A collector usually includes two components,
215215

216216
* the Subscriber generates the subscription instructions to express
217-
what and how the Receiver want to receive the data;
217+
what and how the Receiver wants to receive the data;
218218

219219
* the Receiver is the target for the data publication.
220220

221221

222222

223223

224-
Zhou, et al. Expires 24 November 2023 [Page 4]
224+
Zhou, et al. Expires 29 November 2023 [Page 4]
225225

226226
Internet-Draft Distributed Notifications May 2023
227227

@@ -241,7 +241,7 @@ Internet-Draft Distributed Notifications May 2023
241241
Agents on route and processors on line cards.
242242

243243
Publisher Agents collects metrics according to the Component
244-
Subscription, add its metadata, encapsulates and pushes data to the
244+
Subscription, add its metadata, encapsulates, and pushes data to the
245245
Receiver where packets are reassembled and decapsulated.
246246

247247
+-----------------------------------------+
@@ -277,13 +277,13 @@ Internet-Draft Distributed Notifications May 2023
277277

278278

279279

280-
Zhou, et al. Expires 24 November 2023 [Page 5]
280+
Zhou, et al. Expires 29 November 2023 [Page 5]
281281

282282
Internet-Draft Distributed Notifications May 2023
283283

284284

285285
* Agents need to register at the Master at the beginning of their
286-
process life-cycle.
286+
process life cycle.
287287

288288
* Contracts are created between the Master and each Agent on the
289289
Component Capability, and the format for streaming data structure.
@@ -333,16 +333,15 @@ Internet-Draft Distributed Notifications May 2023
333333

334334

335335

336-
Zhou, et al. Expires 24 November 2023 [Page 6]
336+
Zhou, et al. Expires 29 November 2023 [Page 6]
337337

338338
Internet-Draft Distributed Notifications May 2023
339339

340340

341-
The Receiver is able to associate the YANG data records with
342-
Subscription ID [RFC8639] to the subscribed subscription and with
343-
Message Observation Domain ID
344-
[I-D.ietf-netconf-notification-messages] to one of the Publisher
345-
Agents software processes to enable message integrity.
341+
The Receiver can associate the YANG data records with Subscription ID
342+
[RFC8639] to the subscribed subscription and with Message Observation
343+
Domain ID [I-D.ietf-netconf-notification-messages] to one of the
344+
Publisher Agents software processes to enable message integrity.
346345

347346
For the dynamic subscription, the output of the "establish-
348347
subscription" RPC defined in [RFC8639] MUST include a list of Message
@@ -384,19 +383,17 @@ Internet-Draft Distributed Notifications May 2023
384383
The specific configuration on transports is described in the
385384
responsible documents.
386385

386+
9. YANG Tree
387387

388388

389389

390390

391391

392-
Zhou, et al. Expires 24 November 2023 [Page 7]
392+
Zhou, et al. Expires 29 November 2023 [Page 7]
393393

394394
Internet-Draft Distributed Notifications May 2023
395395

396396

397-
9. YANG Tree
398-
399-
400397
module: ietf-distributed-notif
401398

402399
augment /sn:subscriptions/sn:subscription:
@@ -442,17 +439,17 @@ Internet-Draft Distributed Notifications May 2023
442439

443440
Redistribution and use in source and binary forms, with or
444441
without modification, is permitted pursuant to, and subject to
442+
the license terms contained in, the Simplified BSD License set
443+
forth in Section 4.c of the IETF Trust's Legal Provisions
444+
Relating to IETF Documents
445445

446446

447447

448-
Zhou, et al. Expires 24 November 2023 [Page 8]
448+
Zhou, et al. Expires 29 November 2023 [Page 8]
449449

450450
Internet-Draft Distributed Notifications May 2023
451451

452452

453-
the license terms contained in, the Simplified BSD License set
454-
forth in Section 4.c of the IETF Trust's Legal Provisions
455-
Relating to IETF Documents
456453
(https://trustee.ietf.org/license-info).
457454

458455
This version of this YANG module is part of RFC XXXX; see the
@@ -498,17 +495,17 @@ Internet-Draft Distributed Notifications May 2023
498495

499496
augment "/sn:subscription-modified" {
500497
description
498+
"This augmentation allows MSO specific parameters to be
499+
exposed for a subscription.";
500+
501501

502502

503503

504-
Zhou, et al. Expires 24 November 2023 [Page 9]
504+
Zhou, et al. Expires 29 November 2023 [Page 9]
505505

506506
Internet-Draft Distributed Notifications May 2023
507507

508508

509-
"This augmentation allows MSO specific parameters to be
510-
exposed for a subscription.";
511-
512509
uses message-observation-domain-ids;
513510
}
514511

@@ -554,17 +551,18 @@ Internet-Draft Distributed Notifications May 2023
554551
UDP-based Transport for Configured Subscriptions
555552
[I-D.ietf-netconf-udp-notif] in an example implementation.
556553

554+
The open source code can be obtained here: [INSA-Lyon-Publisher].
557555

558556

559557

560-
Zhou, et al. Expires 24 November 2023 [Page 10]
558+
559+
560+
Zhou, et al. Expires 29 November 2023 [Page 10]
561561

562562
Internet-Draft Distributed Notifications May 2023
563563

564564

565-
The open source code can be obtained here: [INSA-Lyon-Publisher].
566-
567-
12.2. Open Source Reveiver Library
565+
12.2. Open Source Receiver Library
568566

569567
INSA Lyon implemented this document for a YANG Push receiver on
570568
UDP-based Transport for Configured Subscriptions
@@ -574,7 +572,7 @@ Internet-Draft Distributed Notifications May 2023
574572

575573
12.3. Pmacct Data Collection
576574

577-
The open source YANG push reveiver library has been integrated into
575+
The open source YANG push receiver library has been integrated into
578576
the Pmacct open source Network Telemetry data collection.
579577

580578
12.4. Huawei VRP
@@ -593,7 +591,7 @@ Internet-Draft Distributed Notifications May 2023
593591
router line card can contain multiple publisher processes.
594592

595593
The Observation Domain ID term, issue from IPFIX [RFC7011], has been
596-
kept, as opposed to created a new term such as Publisher ID, it is
594+
kept, as opposed to create a new term such as Publisher ID, it is
597595
expected that most network node with line cards will contain just one
598596
publisher per line card. In which case, the observation domain (ID)
599597
concepts in IPFIX and in this draft are similar.
@@ -608,21 +606,18 @@ Internet-Draft Distributed Notifications May 2023
608606
is HTTPS, and the mandatory-to-implement secure transport is TLS
609607
[RFC5246].
610608

609+
The NETCONF Access Control Model (NACM) [RFC6536] provides the means
610+
to restrict access particulary for NETCONF or RESTCONF users to a
611+
preconfigured subset of all available NETCONF or RESTCONF protocol
612+
operations and content.
611613

612614

613615

614-
615-
616-
Zhou, et al. Expires 24 November 2023 [Page 11]
616+
Zhou, et al. Expires 29 November 2023 [Page 11]
617617

618618
Internet-Draft Distributed Notifications May 2023
619619

620620

621-
The NETCONF Access Control Model (NACM) [RFC6536] provides the means
622-
to restrict access for particular NETCONF or RESTCONF users to a
623-
preconfigured subset of all available NETCONF or RESTCONF protocol
624-
operations and content.
625-
626621
The new data nodes introduced in this YANG module may be considered
627622
sensitive or vulnerable in some network environments. It is thus
628623
important to control read access (e.g., via get-config or
@@ -664,20 +659,21 @@ Internet-Draft Distributed Notifications May 2023
664659
DOI 10.17487/RFC2119, March 1997,
665660
<https://www.rfc-editor.org/info/rfc2119>.
666661

662+
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
663+
DOI 10.17487/RFC3688, January 2004,
664+
<https://www.rfc-editor.org/info/rfc3688>.
667665

668666

669667

670668

671669

672-
Zhou, et al. Expires 24 November 2023 [Page 12]
670+
671+
672+
Zhou, et al. Expires 29 November 2023 [Page 12]
673673

674674
Internet-Draft Distributed Notifications May 2023
675675

676676

677-
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
678-
DOI 10.17487/RFC3688, January 2004,
679-
<https://www.rfc-editor.org/info/rfc3688>.
680-
681677
[RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security
682678
(TLS) Protocol Version 1.2", RFC 5246,
683679
DOI 10.17487/RFC5246, August 2008,
@@ -725,7 +721,11 @@ Internet-Draft Distributed Notifications May 2023
725721

726722

727723

728-
Zhou, et al. Expires 24 November 2023 [Page 13]
724+
725+
726+
727+
728+
Zhou, et al. Expires 29 November 2023 [Page 13]
729729

730730
Internet-Draft Distributed Notifications May 2023
731731

@@ -781,7 +781,7 @@ Appendix A. Examples
781781

782782

783783

784-
Zhou, et al. Expires 24 November 2023 [Page 14]
784+
Zhou, et al. Expires 29 November 2023 [Page 14]
785785

786786
Internet-Draft Distributed Notifications May 2023
787787

@@ -837,7 +837,7 @@ A.1. Dynamic Subscription
837837

838838

839839

840-
Zhou, et al. Expires 24 November 2023 [Page 15]
840+
Zhou, et al. Expires 29 November 2023 [Page 15]
841841

842842
Internet-Draft Distributed Notifications May 2023
843843

@@ -893,7 +893,7 @@ Internet-Draft Distributed Notifications May 2023
893893

894894

895895

896-
Zhou, et al. Expires 24 November 2023 [Page 16]
896+
Zhou, et al. Expires 29 November 2023 [Page 16]
897897

898898
Internet-Draft Distributed Notifications May 2023
899899

@@ -949,7 +949,7 @@ Internet-Draft Distributed Notifications May 2023
949949

950950

951951

952-
Zhou, et al. Expires 24 November 2023 [Page 17]
952+
Zhou, et al. Expires 29 November 2023 [Page 17]
953953

954954
Internet-Draft Distributed Notifications May 2023
955955

@@ -1005,7 +1005,7 @@ A.2. Configured Subscription
10051005

10061006

10071007

1008-
Zhou, et al. Expires 24 November 2023 [Page 18]
1008+
Zhou, et al. Expires 29 November 2023 [Page 18]
10091009

10101010
Internet-Draft Distributed Notifications May 2023
10111011

@@ -1061,7 +1061,7 @@ Internet-Draft Distributed Notifications May 2023
10611061

10621062

10631063

1064-
Zhou, et al. Expires 24 November 2023 [Page 19]
1064+
Zhou, et al. Expires 29 November 2023 [Page 19]
10651065

10661066
Internet-Draft Distributed Notifications May 2023
10671067

@@ -1117,7 +1117,7 @@ Authors' Addresses
11171117

11181118

11191119

1120-
Zhou, et al. Expires 24 November 2023 [Page 20]
1120+
Zhou, et al. Expires 29 November 2023 [Page 20]
11211121

11221122
Internet-Draft Distributed Notifications May 2023
11231123

@@ -1173,4 +1173,4 @@ Internet-Draft Distributed Notifications May 2023
11731173

11741174

11751175

1176-
Zhou, et al. Expires 24 November 2023 [Page 21]
1176+
Zhou, et al. Expires 29 November 2023 [Page 21]

0 commit comments

Comments
 (0)