Merge "Add Release notes for VBD project"
[docs.git] / docs / getting-started-guide / project-release-notes / topology-processing-framework.rst
1 ============
2 Topology Processing Framework
3 ============
4
5 Major Features
6 ==============
7
8 odl-topoprocessing-framewrok
9 ------------
10
11 * **Feature URL:** https://git.opendaylight.org/gerrit/gitweb?p=topoprocessing.git;a=blob;f=features/src/main/resources/features.xml;h=0f4b0c438e19f57682ae5586696c36f238bb6255;hb=refs/heads/stable/carbon
12 * **Feature Description:**  Topology processing core
13 * **Top Level:** No
14 * **User Facing:** No
15 * **Experimental:** Yes
16 * **CSIT Test:** https://jenkins.opendaylight.org/releng/view/topoprocessing/job/topoprocessing-csit-1node-topology-operations-all-carbon/
17
18 odl-topoprocessing-mlmt
19 ------------
20
21 * **Feature URL:** https://git.opendaylight.org/gerrit/gitweb?p=topoprocessing.git;a=blob;f=features/src/main/resources/features.xml;h=0f4b0c438e19f57682ae5586696c36f238bb6255;hb=refs/heads/stable/carbon
22 * **Feature Description:**  Multi-Layer and Multi-Technology (MLMT) module
23 * **Top Level:** Yes
24 * **User Facing:** No
25 * **Experimental:** Yes
26 * **CSIT Test:** https://jenkins.opendaylight.org/releng/view/topoprocessing/job/topoprocessing-csit-1node-topology-operations-all-carbon/
27
28 odl-topoprocessing-network-topology
29 ------------
30
31 * **Feature URL:** https://git.opendaylight.org/gerrit/gitweb?p=topoprocessing.git;a=blob;f=features/src/main/resources/features.xml;h=0f4b0c438e19f57682ae5586696c36f238bb6255;hb=refs/heads/stable/carbon
32 * **Feature Description:**  Support for network-topology model
33 * **Top Level:** Yes
34 * **User Facing:** No
35 * **Experimental:** Yes
36 * **CSIT Test:** https://jenkins.opendaylight.org/releng/view/topoprocessing/job/topoprocessing-csit-1node-topology-operations-all-carbon/
37
38 odl-topoprocessing-inventory
39 ------------
40
41 * **Feature URL:** https://git.opendaylight.org/gerrit/gitweb?p=topoprocessing.git;a=blob;f=features/src/main/resources/features.xml;h=0f4b0c438e19f57682ae5586696c36f238bb6255;hb=refs/heads/stable/carbon
42 * **Feature Description:**  Support for inventory model
43 * **Top Level:** Yes
44 * **User Facing:** No
45 * **Experimental:** Yes
46 * **CSIT Test:** https://jenkins.opendaylight.org/releng/view/topoprocessing/job/topoprocessing-csit-1node-topology-operations-all-carbon/
47
48 odl-topoprocessing-I2rs
49 ------------
50
51 * **Feature URL:** https://git.opendaylight.org/gerrit/gitweb?p=topoprocessing.git;a=blob;f=features/src/main/resources/features.xml;h=0f4b0c438e19f57682ae5586696c36f238bb6255;hb=refs/heads/stable/carbon
52 * **Feature Description:**  Support for i2rs model
53 * **Top Level:** Yes
54 * **User Facing:** No
55 * **Experimental:** Yes
56 * **CSIT Test:** https://jenkins.opendaylight.org/releng/view/topoprocessing/job/topoprocessing-csit-1node-topology-operations-all-carbon/
57
58 odl-topoprocessing-inventory-rendering
59 ------------
60
61 * **Feature URL:** https://git.opendaylight.org/gerrit/gitweb?p=topoprocessing.git;a=blob;f=features/src/main/resources/features.xml;h=0f4b0c438e19f57682ae5586696c36f238bb6255;hb=refs/heads/stable/carbon
62 * **Feature Description:**  Rendering demo
63 * **Top Level:** Yes
64 * **User Facing:** No
65 * **Experimental:** Yes
66 * **CSIT Test:** https://jenkins.opendaylight.org/releng/view/topoprocessing/job/topoprocessing-csit-1node-topology-operations-all-carbon/
67
68 Documentation
69 =============
70
71 * **Developer Guide(s):**
72
73   * `Docs on docs.opendaylight.org <http://docs.opendaylight.org/en/latest/developer-guide/topology-processing-framework-developer-guide.html>`_
74   * `Rst documentation <https://git.opendaylight.org/gerrit/gitweb?p=docs.git;a=blob;f=docs/developer-guide/topology-processing-framework-developer-guide.rst;h=9ee838bc79b80bb1b6a8230f8d5402495348e8e0;hb=refs/heads/stable/boron>`_
75   * `Wiki <https://wiki.opendaylight.org/view/Topology_Processing_Framework:Developer_Guide>`_
76
77 Security Considerations
78 =======================
79
80 * No external interfaces other then restconf
81 * No known security issues
82
83 Quality Assurance
84 =================
85
86 * `Link to Sonar Report <https://sonar.opendaylight.org/overview?id=31056>`_ (80.2%)
87 * `Link to CSIT Jobs <https://jenkins.opendaylight.org/releng/view/topoprocessing/job/topoprocessing-csit-1node-topology-operations-all-carbon/>`_
88
89 Migration
90 ---------
91
92 * Not supported
93
94 Compatiblity
95 ------------
96
97 * Compatible
98
99 Bugs Fixed
100 ----------
101
102 * `Link to fixed bugs <https://bugs.opendaylight.org/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=IN_PROGRESS&bug_status=WAITING_FOR_REVIEW&bug_status=RESOLVED&bug_status=VERIFIED&chfield=bug_status&chfieldfrom=2016-09-08&chfieldto=2017-04-24&component=General&product=topoprocessing&query_format=advanced&resolution=FIXED&resolution=INVALID&resolution=WONTFIX&resolution=DUPLICATE&resolution=WORKSFORME>`_
103
104 Known Issues
105 ------------
106
107 * Leafs which are children (direct or indirect) of list can't be used as target fields
108 * Aggregation of termination points in case of more mappings works only if all underlay topologies are from the same model and only if that model is Network Topology or I2RS
109 * Aggregation of termination points in combination with aggregation of nodes doesn't work with inventory model
110 * Aggregation of termination points in combination with aggregation of nodes in case of more mappings works only if aggregation of termination points is specified on each underlay topology and only if model of all underlay topologies is the same
111 * Filtration of termination points in case of more filters works only if all underlay topologies are from the same model
112 * Maximum of one correlation per correlation item (aggregation may not work correctly in case of more correlation with the same correlation item)
113 * Link aggregation works only if user specify also link computation
114
115
116 **MLMT limitations**
117
118 * The mlmt module provides YANG models as based on:
119   * network-topology YANG model version 2013-10-21
120   * TED YANG model version 2013-10-21
121 * The mlmt module works with underlay topologies based on:
122   * network-topology YANG model version 2013-10-21
123   * isis-topology YANG model version 2013-10-21
124 * The mlmt module does not support underlay topologies based on ospf-topology YANG model 2013-10-21.
125
126
127 End-of-life
128 ===========
129
130 * Network Topology model is not supported for overlay topologies
131
132 Release Mechanics
133 =================
134
135 * `Link to release plan <https://wiki.opendaylight.org/view/Topology_Processing_Framework:CARBON_Release_Plan>`_