VOLTHA 2.10 Release Notes

Highlights

VOLTHA-2.10 builds on the 2.9 release for VOLTHA. The release focused on including new features, improving scale and interacting with the Broadband Forum BBF. With VOLTHA 2.10 Fiber to the Building (FTTB) capabilities were introduced, scale was enhanced to 4096 subscribers per stack, rolling software upgrade capabilities were introduced and the ONU adapter was improved with extended message support and unknown ME handling. ONU delete and automatic re-discovery was implemented. Finally collaboration with BBF defined the yang models extension needed to support VOLTHA, that were started to get implemented in the BBF adapter for the VOLTHA northbound. Finally new tests were introduced for FTTB, memory leaks and the Telecom Italia (TIM) workflow.

VOLTHA 2.10 first and foremost introduced the support for FTTB use case with the 1 tcont 4 gem technology profile. VOLTHA now has capability to install ANCP, DPU management and subscriber rules flow rules. These rules are created in ONOS and translated in vlan swapping at the OLT (outer vlan swap). The rules get installed after the MAC address is learnt for the DPU device. These Rules configure the OMCI ONT within the DPU. Extensions have been made in ONOS and in the different adapters. Sadis has been extended with the subscriber and ANCP/Management traffic definitions and documentation. Extended work has been put in to increase scalability and in VOLTHA 2.10 a single stack can support up to 4096 subscribers, on one or two OLTs, while keeping the same 10 minute maximum provisioning time from when the OLT connects to VOLTHA. All the VOLTHA components have also been extended to ensure a smooth upgrade with no request downtime via the Kubernetes rolling upgrade functionality. The onu adapter now allows for ONU automatic re-discovery after deletion, unknown ME handling where we ignore unknown messages but still onboard the ONU. Extended message support has also been introduced allowing for faster ONU image installation and MIB initial download. Extended message support has been parameterized not to be enabled by default, it has also been tested only with BBSIM, according to according to ITU-T G.988 Amendment 3 (03/2020, further hardware test will be done and required fixes will be applied, any report from the community is appreciated.

The stack has been enhanced to provide a pathway for supporting COMBO PON OLTs with the introduction of a framework of dynamic detection of PON Transceiver Technology and then using that information to configure the MAC and PON modes.

Alignment with the Broadband Forum progressed and a first agreement has been reached on the yang models that correctly map VOLTHA, both on the OLT and ONU side and the subscriber service abstraction. The BBF models have been extended and the proposals are ready for submission for official approval. In the meantime a BBF adapter has been written, exposing a netconf server on the NB which leverages the mentioned models and in turns call the VOLTHA/ONOS apis.

Finally the release provided bug fixes across the stack, especially around Resource Cleanup and correct state assurance for devices and for the different containers. Also several panics and null pointer exceptions have been prevented, yielding a much more stable system.

On the testing front VOLTHA 2.10 includes tests for the FTTB functionality, both on BBSIM and on a physical DPU in the Berlin POD. Also, TIM Workflow tests have been introduced in BBSIM, to avoid regression for that workflow, which includes the PPPoE application. New tests have been introduced to check for memory leaks during device deletion and re-creation both for the ONU adapter and the OLT adapter. Other new tests for the unknown MEs, ONU delete and re-discovery, rolling upgrade and extended OMCI message support. More tests have been extended, such as TT with unit-tag subscriber provisioning, mac learning, also the Device management Interface tests are now being run on hardware as well.

Along with VOLTHA 2.10, the Device Management Brigade also released new major versions (up to 1.5.0) of the interface with COMBO PON support, NNI port speed runtime config, new events and states.

Features & Improvements

  • Fiber to the Building (FTTB) Support

    • Support for DPU management and ancp traffic rules single tagged with VLAN swap

    • Support for Subscriber traffic flows with outer VLAN swap

    • Sadis integration with documentation

    • Hardware integration with ADTRAN DPU

    • 1 tcont 4 Gem technology profile

  • Scale enhancements

    • 4096 subscribers on one OLT with 1 VOLTHA stack

    • 4096 subscribers on two OLTs with 1 VOLTHA stack

  • Rolling software upgrade capabilities

    • Kubernetes rolling upgrade of pods

    • Requests always served with no pod downtime

  • Initial Combo PON support

    • Framework for dynamic detection of PON Transceiver Technology

  • Extended Message Support in ONU Adapter

    • Reduced number of messages for ONU Software Upgrade and MIB template download

    • Higher speed of software image and MIB template download

  • Unknown MEs handling

    • Relaxed decoding of unknown MEs

    • Discarded unknown entities but proceed with ONU MIB download for that ONU.

  • ONU Delete and re-discovery

  • BBF Adapter Initial Implementation

    • Northbound NETCONF server

    • Southbound integration with VOLTHA protos, ONOS APIs

    • Augmentation and use of existing BBF models

    • Get OLT and ONU information via NETCONF and BBF models

  • Move to ONOS 2.5.8 with bug fixes

Bug Fixes

  • Resource cleanup in ONOS, ETCD and final state machines, especially in case of device delete/restart and adapter(s) restart

  • Avoid wrong state and missing notification for ONUs in several components and system states.

  • Avoid panic and runtime expectations in VOLTHA and ONOS Apis

Test

Voltha-2.10 tests are available on Jenkins.

  • FTTB tests

  • Optimized ATT test for time reduction

  • Memory leak tests with 200 iterations of device deletion

  • Unknown ME tests

  • Extended OMCI message support for MIB Upload

  • ONU Delete and Rediscovery

  • Mac Learning in TT Sanity

  • Mib Audit

  • Device Management Interface tests on ADTRAN hardware

  • MDS mismatch

  • Voltha services Rolling upgrade

  • TIM workflow tests

  • Unknown attribute tests

Design Discussions

  • OLT Disconnect and Reconnect

  • ONOS replacement controller (lightweight VOLTHA controller)

  • ONF/BBF integration and models extension

  • COMBO PON support

Documentation

  • Contributing to VOLTHA

  • Certification program

  • release procedure and versioning guidelines

  • jenkins node setup for testing

  • Rollback scenarios

As usual documentation is published on https://docs.voltha.org

Known Issues

  • FTTB Upstream flow stays in pending add on openolt based devices. [VOL-4742]

  • ATT Workflow fails EAPOL flow installation at scale [VOL-4745]

  • Olt app removes flows based on the latest Sadis entry, if sadis changes flows can’t be removed. [VOL-4746]

  • Flows stuck in pending-add when subscriber is provisioned after open-olt-adapter pod restart [VOL-4747]

  • Alpha ONUs on soak pod drop upstream ARP/ICMP packets [VOL-4748]

  • Rolling update test failures [VOL-4749]

Certification Program

Thanks to the Continuous Certification program at ONF we can also ensure that the following ONF member products are compatible with the VOLTHA 2.10 release:

  • Edgecore ASGVolt64 GPON OLT

  • Edgecore ASXVolt16 XGSGPON OLT

  • Radisys 3200G GPON OLT

  • Radisys 1600G GPON OLT

  • Radisys 1600X COMBO OLT

  • Adtran 6320X COMBO OLT

  • Zyxel SDA3016SS Combo OLT

  • Sercomm FG1000 GPON ONU

  • Sercomm Glasfaser GPON ONU

  • Edgecore 6712-32X Switch

  • Edgecore 7712-32X Switch

In particular the 2.10 release added the Zyxel SDA3016SS COMBO OLT.

Jira stories

A full list of stories and bugs completed can be found under the VOLTHA 2.10 release page in Jira.

Component Versions in VOLTHA 2.10 release

ONOS and Atomix:

ONOS Apps:

VOLTHA Components:

Helm Chart Versions:

This section refers to the macro charts to deploy the required infrastructure and a (or many) VOLTHA stacks: - Voltha-infra: 2.10.7 - Voltha-stack: 2.10.5

BAL Version:

Broadcom abstraction layer (BAL) version: 3.10.2.2.

Openolt Agent packages:

EdgeCore Get access credentials for https://edgecore.quickconnect.to from Edgecore. Then login and navigate to File_Station -> EdgecoreNAS, and then the folder /ASXvOLT16/OpenOLT_Agent/From_ONF_Distribution/voltha-2.10 or /ASGvOLT64/OpenOLT_Agent/From_ONF_Distribution/voltha-2.10 based on ASXvOLT16 or ASGvOLT64 platform, and pick the suitable OLT debian package based on BAL 3.10.2.2 applicable for you. Please make sure to use the ONL /ASXvOLT16/OpenOLT_Agent/From_ONF_Distribution/ONL-onl-4.14_ONL-OS8_2021-11-26.0058-0de1c30_AMD64_INSTALLED_INSTALLER for running BAL 3.10.2.2.

Radisys Please write to Cameron Lundberg to get the OLT debian package validated on 3200G, 1600x and 1600G platforms for VOLTHA-2.10 release

Zyxel Please write to Emanuel Villalobos to get the OLT debian package validated on the SDA3016SS for VOLTHA-2.10 release.