Difference between revisions of "Sweetcomb/RPCop"
From fd.io
m (→RPC Operations) |
m (→RPC Operations) |
||
| Line 3: | Line 3: | ||
This page aims at describing which data should be read when a user uses a RPC method on sweetcomb control agent. | This page aims at describing which data should be read when a user uses a RPC method on sweetcomb control agent. | ||
| − | + | === Types of data === | |
| + | |||
* '''Configuration data/desired state''': "Configuration data is the set of writable data that is required to transform a system from its initial default state into its current state." [https://tools.ietf.org/html/rfc6241 RFC6241] | * '''Configuration data/desired state''': "Configuration data is the set of writable data that is required to transform a system from its initial default state into its current state." [https://tools.ietf.org/html/rfc6241 RFC6241] | ||
* '''Operational data''': "Operational state data is a set of data that has been obtained by the system at runtime and influences the system's behavior similar to configuration data. In contrast to configuration data, operational state is transient and modified by interactions with internal components or other systems via specialized protocols." [https://tools.ietf.org/html/rfc6244 RFC6244] | * '''Operational data''': "Operational state data is a set of data that has been obtained by the system at runtime and influences the system's behavior similar to configuration data. In contrast to configuration data, operational state is transient and modified by interactions with internal components or other systems via specialized protocols." [https://tools.ietf.org/html/rfc6244 RFC6244] | ||
| Line 25: | Line 26: | ||
Source: [https://tools.ietf.org/id/draft-ietf-netmod-revised-datastores-08.html#rfc.section.5.3 https://tools.ietf.org/id/draft-ietf-netmod-revised-datastores-08.html#rfc.section.5.3] | Source: [https://tools.ietf.org/id/draft-ietf-netmod-revised-datastores-08.html#rfc.section.5.3 https://tools.ietf.org/id/draft-ietf-netmod-revised-datastores-08.html#rfc.section.5.3] | ||
| + | |||
| + | === YANG tree architectures === | ||
Second, there are [https://www.ietf.org/proceedings/99/slides/slides-99-rtgwg-sessa-guidelines-for-yang-module-authors-on-using-nmda-00.pdf three types of organization] of YANG trees: | Second, there are [https://www.ietf.org/proceedings/99/slides/slides-99-rtgwg-sessa-guidelines-for-yang-module-authors-on-using-nmda-00.pdf three types of organization] of YANG trees: | ||
| Line 32: | Line 35: | ||
In order to know if your IETF support NMDA, please use [https://www.yangcatalog.org/yang-search/ YangCatalog]. | In order to know if your IETF support NMDA, please use [https://www.yangcatalog.org/yang-search/ YangCatalog]. | ||
| + | |||
| + | === RPC types === | ||
Third, as sweetcomb only supports NETCONF and gNMI, there are 5 RPCs supported: | Third, as sweetcomb only supports NETCONF and gNMI, there are 5 RPCs supported: | ||
| Line 39: | Line 44: | ||
* '''NETCONF get-config''' | * '''NETCONF get-config''' | ||
* '''NETCONF edit-config''' | * '''NETCONF edit-config''' | ||
| + | |||
| + | === Data stores === | ||
Fourth, there are many available datastores: | Fourth, there are many available datastores: | ||
Revision as of 13:17, 26 March 2019
Contents
RPC Operations
This page aims at describing which data should be read when a user uses a RPC method on sweetcomb control agent.
Types of data
- Configuration data/desired state: "Configuration data is the set of writable data that is required to transform a system from its initial default state into its current state." RFC6241
- Operational data: "Operational state data is a set of data that has been obtained by the system at runtime and influences the system's behavior similar to configuration data. In contrast to configuration data, operational state is transient and modified by interactions with internal components or other systems via specialized protocols." RFC6244
+-------------+ +-----------+
| <candidate> | | <startup> |
| (ct, rw) |<---+ +--->| (ct, rw) |
+-------------+ | | +-----------+
| | | |
| +-----------+ |
+-------->| <running> |<--------+
| (ct, rw) |
+-----------+
|
v
operational state <--- control plane
(cf, ro)
ct = config true; cf = config false
rw = read-write; ro = read-only
boxes denote datastores
Source: https://tools.ietf.org/id/draft-ietf-netmod-revised-datastores-08.html#rfc.section.5.3
YANG tree architectures
Second, there are three types of organization of YANG trees:
- Openconfig style: 'config' and 'state' containers
- IETF withtout NMDA: 'config' and 'state' top level trees
- IETF with NMDA:
In order to know if your IETF support NMDA, please use YangCatalog.
RPC types
Third, as sweetcomb only supports NETCONF and gNMI, there are 5 RPCs supported:
- gNMI get
- gNMI set
- NETCONF get
- NETCONF get-config
- NETCONF edit-config
Data stores
Fourth, there are many available datastores:
- startup : Automatically handled by sysrepo and netopeer
- candidate: Automatically handled by sysrepo and netopeer
- running: This is when changes are commited to running that VPP is configured
Openconfig style
