blob: cae872c3fbfa6b84a38250ca1c8f35940ecc8293 [file] [log] [blame]
Andrea Campanella1865dcb2021-07-10 01:16:45 +02001VOLTHA 2.8 Release Notes
2========================
3
4Highlights
5----------
6
7VOLTHA-2.8 is the first Long Term Support (LTS) release for VOLTHA. Together with ONOS 2.5 (which is already LTS),
8the LTS designation means that testing and bug-fixes will be guaranteed for 18 months on the released version of the
9codebase. The release focused on storage with persistence at scale, platform hardening, tcont type selection, Multi-Uni
10support and introduced several PON level metrics. All these elements provide confidence to the operators to expand
11their production deployments.
12
13The Long Term Support process is as follows:
14
15- LTS releases 18 months apart.
16- Each LTS release will be supported for 18 months with bug fixes and testing
17- 6 month release cycles following LTS release
18- Two interim releases every 6 months between LTS versions.
19
20VOLTHA 2.8 first and foremost meets the scale requirements (1024 ONUS per stack, 10240 on 10 stack across the same
21infrastructure) of the operators with persistence enabled on ETCD 6.2.5 version, deployed with the BITNAMI helm
22charts. Such result was achieved thanks to the combination of several improvements across the whole stack.
23The Technology profile is now mostly templated, the openolt adapter makes heavier use of the read-through cache,
24the rw-core does not store the flows for each device. A ETCD connection pool has been introduced in voltha-lib-go
25to ensure that the system is not choking by using 1 connection per service. With all these improvements on NVMe
26disks all 3 workflows provision 1024 subscribers in around 2 minutes.
27
28During the VOLTHA 2.8 release ONOS was moved from the 2.2 release which is shortly approaching EOL (end of life) to
29ONOS 2.5, guaranteeing that for the extent of the 2.8 release also ONOS will be supported.
30
31To support more customers in the field multi-UNI capability has been introduced across the VOLTHA stack and ONOS apps.
32The system is now capable of delivering configuration and thus traffic to subscribers connected to all UNI ports
33of each ONU, up to 16 per ONU.
34
35Further subscriber configuration has been introduced with the support for the IETF model for bandwidth profiles
36and the capability to provision and choose all the 5 TCONT types. These elements allow operators a wider variety
37of subscriber configurations
38
39To comply with operator requirements the ONU software upgrade APIs have been changed to support retrieval of images
40present on the ONU and to separate the download, activate, commit, requests, allowing the operator more control over
41the actions performed over the ONU. Furthermore hardening of the functionality has been done, achieving a much faster
42ONU update time.
43
44Further insight into live deployed networks has been introduced thanks to more Performance Measurements that can be
45retrieved from the ONU and the OLT. In particular VOLTHA 2.8 implements ANi-G and ANi-G test messages with tx/rx
46power readout, ONUi-PON, GEMj and UNI Ethernet layer, FEC and GEM history and several other counters.
47
48Finally the release provided bug fixes across the stack, especially concerning device/port handling, such as,
49PON enable/disable, OLT and ONU reboot and ONU software upgrade. Performance related improvements were included
50in ONOS apps. VOLTHA 2.8 hardened several operations, one worth noting is the omci message retry on failure in
51openonu adapter
52
53On the testing front VOLTHA 2.8 expanded the suite for TT up to 20 tests, with failure and error scenarios,
54including several multi TCONT testing as per TT workflow. Testing has included also a full suite for the
55Performance Measurements functionality, especially ANI-G. Furthermore we included support for multi-uni in the robot
56suite and expanded the soak testing with DT workflow.
57
58Along with VOLTHA 2.8, the Device Management Brigade also released a new version
59(`1.0.0 <https://github.com/opencord/device-management-interface/releases/tag/v1.0.0>`_) of the interface,
60which has been implemented on BBSIM and has initial robot test cases. This DMI release introduces specific components
61values, BITS protocol, gRPC streams for events and metrics that can be use in place of kafka, more events and
62a heart beat check.
63
64Features & Improvements
65-----------------------
66
67- ETCD 6.2.5 with persistence enabled
68
69 - Templated technology profile
70 - Removal of flows and meters storage in the rw-core.
71 - Openolt adapter read-through cache
72 - ETCD connection pool in voltha-lib-go
73 - Optimization of several stored attributes, removing duplicate items
74 - Automatic compaction and defragmentation
75
76- Move to ONOS 2.5 LTS
77- Expanded ONU software upgrade capability
78
79 - Retrieval of image specifics via OMCI of the images from the device
80 - Separation of download/activate/commit APIs
81 - Time optimization
82- Multi Uni per ONU support across the whole stack, ONOS apps and BBSIM
83- IETF bandwidth profile definition support
84- 5 Tcont type configuration and selection
85- Collection of more performance measurements and counters
86
87 - ANi-G and ANi-G test message with te/rs power support
88 - ONUi-PON and ONUi-GEMj
89 - ONU-UNI Ethernet layer
90 - Eth-Port
91 - GEM Port History
92 - FEC History
93 - Transceiver data via DMI
94- OMCI channel message send/receive failure handling with retry in openonu adapter
95- Voltctl extensions
96
97 - Multi-stack support
98 - Groups list
99 - Retrieve of Performance Metrics
100- Distroless and non root docker images for production deployment security
101
102Development/Deployment process
103------------------------------
104
105- Deprecation of kind-voltha in favour of voltha-stack and voltha-infra helm charts.
106
107Test
108----
109
110Voltha-2.8 tests are available on `Jenkins <https://jenkins.opencord.org/>`_.
111
112- Full Performance Monitoring Attributes test suite
113- Multi Uni per ONU tests
114- OMCI requests failures chaos monkey
115- Expanded TT tests from 5 to 19
116
117 - Disable/Enable ONU
118 - Disable/Delete OLT
119 - Open-olt, Open-onu, Rw-core, Of-agent Restart
120 - Delete/Re-add (reprovisioning) Subscribers
121 - ONU and OLT Physical and Soft Reboot
122 - Various Multi-Tcont scenarios
123
124- Radisys 3200G GPON OLT DT and ATT tests
125- Expanded and automated soak testing with DT workflow.
126- OLT soft reboot for DT
127- Updated ONU Software Upgrade Tests based on new Voltctl commands
128
129Design Discussions
130------------------
131
132- PON-ID configuration
133- MPLS support
134- TIM workflow
135
136
137Documentation
138-------------
139
140- Updated documentation with new ONU software update and software update is published on https://docs.voltha.org
141
142Known Issues
143------------
Andrea Campanella090c6032021-08-05 12:34:41 +0200144.. raw:: html
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200145
Andrea Campanella090c6032021-08-05 12:34:41 +0200146 <s>
147
148- [FIXED] Same TCONT for two uni add/delete subscribers does not work. `[VOL-4215] <https://jira.opencord.org/browse/VOL-4215>`_
149
150.. raw:: html
151
152 </s>
153
Andrea Campanella58ea9a72022-01-05 12:10:26 +0100154- [FIXED] EAPOL flow meter mismatch at scale for ATT job. `[VOL-4235] <https://jira.opencord.org/browse/VOL-4235>`_
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200155
156
157Certification Program
158---------------------
159
160Thanks to the `Continuous Certification <https://opennetworking.org/continuous-certification-program>`_ program at
161ONF we can also ensure that the following ONF member products are compatible with the VOLTHA 2.8 release:
162
163- Edgecore ASGVolt64 GPON OLT
164- Edgecore ASXVolt16 XGSGPON OLT
165- Radisys 3200G GPON OLT
Andrea Campanella732fbb92021-11-23 11:08:49 -0800166- Radisys 1600G GPON OLT
167- Radisys 1600X GPON OLT
168- Adtran 6320 GPON OLT
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200169- Sercomm FG1000 GPON ONU
170- Sercomm Glasfaser GPON ONU
171- Edgecore 6712-32X Switch
172- Edgecore 7712-32X Switch
173
174In particular the 2.8 release added the Radisys 3200G GPON OLT.
175
176Jira stories
177------------
178A full list of stories and bugs completed can be found under the
179`VOLTHA 2.8 <https://jira.opencord.org/projects/VOL/versions/12100>`_ release page in Jira.
180
181Component Versions in VOLTHA 2.8 release
182----------------------------------------
183
184ONOS and Atomix:
185++++++++++++++++
186
Andrea Campanella8245ff52021-10-06 11:50:03 +0200187- `ONOS 2.5 LTS <https://github.com/opennetworkinglab/onos/releases/tag/2.5.2>`_: ``2.5.4``
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200188- `ATOMIX <https://github.com/atomix/atomix/releases/tag/atomix-3.1.9>`_: ``3.1.9``
189
190ONOS Apps:
191++++++++++
192
193- `aaa <https://gerrit.opencord.org/gitweb?p=aaa.git;a=summary>`_: ``2.4.0``
194- `dhcpl2relay <https://gerrit.opencord.org/gitweb?p=dhcpl2relay.git;a=summary>`_: ``2.4.0``
195- `igmpproxy <https://gerrit.opencord.org/gitweb?p=igmpproxy.git;a=summary>`_: ``2.3.0``
196- `kafka <https://gerrit.opencord.org/gitweb?p=kafka-onos.git;a=summary>`_: ``2.7.0``
197- `mcast <https://gerrit.opencord.org/gitweb?p=mcast.git;a=summary>`_: ``2.4.0``
198- `olt <https://gerrit.opencord.org/gitweb?p=olt.git;a=summary>`_: ``4.5.0``
199- `sadis <https://gerrit.opencord.org/gitweb?p=sadis.git;a=summary>`_: ``5.4.0``
Andrea Campanella764a3ce2021-07-19 21:55:02 +0200200- `bng <https://gerrit.opencord.org/gitweb?p=bng.git;a=summary>`_: ``2.1.0``
201- `pppoeagent <https://gerrit.opencord.org/plugins/gitiles/pppoeagent/>`_: ``1.1.0``
202- `olttopology <https://gerrit.opencord.org/plugins/gitiles/olttopology/>`_: ``1.1.0``
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200203
204VOLTHA Components:
205++++++++++++++++++
206
Andrea Campanella1fbf2032022-03-15 12:29:59 +0100207- `Helm Charts (voltha-helm-charts) <https://gerrit.opencord.org/gitweb?p=voltha-helm-charts.git;a=tree;h=refs/heads/voltha-2.8>`_ - ``2.8.23``
Andrea Campanella8245ff52021-10-06 11:50:03 +0200208- `bbsim <https://gerrit.opencord.org/gitweb?p=bbsim.git;a=tree>`_- ``1.8.1`` with `chart <https://gerrit.opencord.org/gitweb?p=helm-charts.git;a=tree;f=bbsim>`_ ``4.4.3``
Andrea Campanella4dea9cc2021-11-16 13:44:51 -0800209- `voltha-go <https://gerrit.opencord.org/gitweb?p=voltha-go.git;a=tree;h=refs/heads/voltha-2.8>`_ - ``2.9.6`` with chart ``2.9.10``
210- `ofagent-go <https://gerrit.opencord.org/gitweb?p=ofagent-go.git;a=tree;h=refs/heads/voltha-2.8>`_ - ``1.6.5`` with chart ``2.9.10``
Andrea Campanella764a3ce2021-07-19 21:55:02 +0200211- `voltctl <https://gerrit.opencord.org/gitweb?p=voltctl.git;a=tree>`_ - ``1.6.11``
Andrea Campanella732fbb92021-11-23 11:08:49 -0800212- `voltha-openolt-adapter <https://gerrit.opencord.org/gitweb?p=voltha-openolt-adapter.git;a=tree;h=refs/heads/voltha-2.8>`_ - ``3.5.11`` with chart ``2.9.11``
Andrea Campanella1fbf2032022-03-15 12:29:59 +0100213- `voltha-openonu-adapter-go <https://gerrit.opencord.org/gitweb?p=voltha-openonu-adapter-go.git;a=tree;h=refs/heads/voltha-2.8>`_ - ``1.3.27`` with chart ``2.8.17``
Andrea Campanella8245ff52021-10-06 11:50:03 +0200214- `voltha-onos <https://gerrit.opencord.org/gitweb?p=voltha-onos.git;a=tree;h=refs/heads/voltha-2.8>`_ - ``5.0.3`` with chart ``0.1.16``
Girish Gowdra71167842021-08-05 16:01:18 -0700215- `openolt agent <https://gerrit.opencord.org/gitweb?p=openolt.git;a=tree;h=refs/heads/voltha-2.8>`_ - ``3.4.9``
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200216- `voltha-protos <https://github.com/opencord/voltha-protos/releases/tag/v4.0.5>`_ - ``4.2.0``
Andrea Campanella4dea9cc2021-11-16 13:44:51 -0800217- `voltha-lib-go <https://github.com/opencord/voltha-lib-go/releases/tag/v4.0.3>`_ - ``5.0.7``
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200218- `Bbsim-sadis-server <https://github.com/opencord/bbsim-sadis-server/releases/tag/v0.1.3>`_ - ``0.3.0`` with chart ``0.2.0``
Andrea Campanella4dea9cc2021-11-16 13:44:51 -0800219- `voltha-system-tests <https://github.com/opencord/voltha-system-tests/releases/tag/2.8.0>`_ - ``2.8.17``
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200220
221
222Helm Chart Versions:
223++++++++++++++++++++
224This section refers to the macro charts to deploy the required infrastructure and a (or many) VOLTHA stacks:
Andrea Campanella1fbf2032022-03-15 12:29:59 +0100225- Voltha-infra: ``2.8.3``
226- Voltha-stack: ``2.8.18``
Andrea Campanella732fbb92021-11-23 11:08:49 -0800227
228BAL Version:
229++++++++++++
230Broadcom abstraction layer (BAL) version: ``3.4.9.9``.
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200231
Andrea Campanella764a3ce2021-07-19 21:55:02 +0200232Openolt Agent packages:
233+++++++++++++++++++++++
234**EdgeCore**
235Available from EdgeCore site:
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200236
237- Out of band management
238
239 - ONL version (both GPON and XGSPON) ONL-onl-4.14_ONL-OS8_2020-04-14.1946-72b95a7_AMD64_INSTALLED_INSTALLER available
240 at /ASXvOLT16/OpenOLT_Agent/From_ONF_Distribution
241 - for ASFVOLT16 available, from /ASFvOLT16/OpenOLT_Agent/From_ONF_Distribution/voltha-2.8/OUT-OF-BAND.:
242
Girish Gowdra71167842021-08-05 16:01:18 -0700243 - ``openolt_asfvolt16-3.4.9-e2a9597f3d690fe3a0ea0df244571dfc9e8c2833-100G-NNI.deb`` if 100G NNI port is used
244 - ``openolt_asfvolt16-3.4.9-e2a9597f3d690fe3a0ea0df244571dfc9e8c2833-40G-NNI.deb`` if 40G NNI port is used.
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200245
246 - for ASGVOLT64 available at /ASGvOLT64/OpenOLT_Agent/From_ONF_Distribution/voltha-2.8/OUT-OF-BAND:
247
Girish Gowdra71167842021-08-05 16:01:18 -0700248 - ``openolt_asgvolt64-3.4.9-e2a9597f3d690fe3a0ea0df244571dfc9e8c2833-100G-NNI.deb`` if 100G NNI port is used
249 - ``openolt_asgvolt64-3.4.9-e2a9597f3d690fe3a0ea0df244571dfc9e8c2833-40G-NNI.deb`` if 40G NNI port is used.
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200250
251- In band management
252
253 - use ONL image, comprising of Bal and openolt (available from edgecore site) for ASFVOLT16
Girish Gowdra71167842021-08-05 16:01:18 -0700254 ONL-onl-4.14_ONL-OS8_2021-08-05.0514-72b95a7_AMD64_INSTALLED_INSTALLER-40G-NNI,
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200255 available at /ASXvOLT16/OpenOLT_Agent/From_ONF_Distribution/voltha-2.8/IN-BAND.
256 Note that debian package available as part of the ONL support 40G NNI by default.
257
Andrea Campanella1865dcb2021-07-10 01:16:45 +0200258Get access credentials for https://edgecore.quickconnect.to and then login
259and navigate to File_Station -> EdgecoreNAS, and then the folder
260/ASXvOLT16/OpenOLT_Agent/From_ONF_Distribution/ and pick the version above
Andrea Campanella764a3ce2021-07-19 21:55:02 +0200261
262**Radisys**
Girish Gowdra71167842021-08-05 16:01:18 -0700263For 3200G 40G NNI .Deb Version: ``openolt_rlt-3200g-w-40g-3.5.1-dev-262b6293cdeda78317dda9d3a6cfab0e7ebfbf05.deb``
Andrea Campanella764a3ce2021-07-19 21:55:02 +0200264To get the debian package for Radisys 3200G OLT please write to `Cameron Lundberg <cameron.lundberg@radisys.com>`_
265