The OpenOLT agent runs on white box Optical Line Terminals (OLTs) and provides a gRPC-based management and control interface to OLTs.
The OpenOLT agent is used by VOLTHA through the OpenOLT adapter.
OpenOLT agent uses Broadcom's BAL (Broadband Adaptation Layer) software for interfacing with the Maple/Qumran chipsets in OLTs such as the Edgecore/Accton ASXvOLT16 and with Aspen/Qumran chipsets in OLTs such as the Radisys/Phoenix RLT-3200G-W.
+---------------------------------+ | VOLTHA | | | | +------------------+ | | | OpenOLT adapter | | +-------+--------+---------+------+ | OpenOLT gRPC API | | +--------------------- ---------------+ | | | | +------------------+ | | | OpenOLT agent | | | +--------+---------+ | | | | | Vendor specific | (e.g. Broadcom | | API | BAL API | | | | | +------------------+ | | | Vendor SoC/FPGA | | | |(e.g Maple/Qumran)| | | +------------------+ | | | | White box OLT | +-------------------------------------+
A list of tested devices and optics can be found in the CORD hardware requirements guide, in the R-CORD access equipment and optics section.
Accton/Edgecore makes available pre-built debian packages of OpenOLT agent to their customers. Get access credentials for edgecore.quickconnect.to and then login and navigate to File_Station -> EdgecoreNAS, and then the folder /ASXvOLT16/OpenOLT_Agent/From_ONF_Distribution/ and pick the right version of .deb package required for your testing.
voltha-2.6/openolt_<OPENOLTDEVICE>-2.6.0-<GIT Commit ID>.deb is the latest version of package with support for BAL v3.4.9.6 .
The pre-built debian packages have been tested on Open Networking Linux (ONL) version 4.14. The ONL Installer required for voltha-2.6/openolt_<OPENOLTDEVICE>-2.6.0-<GIT Commit ID>.deb is also available at in the same path, i.e., voltha-2.6/.
Copy the debian package to the OLT. For example:
scp openolt.deb root@10.6.0.201:~/.
Install the openolt.deb package using dpkg:
dpkg -i openolt_<OPENOLTDEVICE>-2.6.0-<GIT Commit ID>.deb
The ONL version required for BAL v3.4.9.6 is ONL 4.14.151-OpenNetworkLinux. Radisys RLT-3200G-W requires BAL v3.4.9.9 and ONL version 4.19-OpenNetworkLinux. This will be built as part of build procedure described in Build OpenOLT section.
Rebooting the OLT (after the installation) will start dev_mgmt_daemon and openolt as system services:
reboot
The services can also be stopped/started manually:
service dev_mgmt_daemon stop
service openolt stop
service dev_mgmt_daemon start
service openolt start
Check the status of the services:
service dev_mgmt_daemon status
service openolt status
Running the dev_mgmt_daemon and/or openolt services in the foreground is useful for development and debugging. Make sure to first stop the services if they are running in background.
service dev_mgmt_daemon stop
service openolt stop
Open a terminal and run the Broadcom BAL software (dev_mgmt_daemon):
cd /broadcom ./dev_mgmt_daemon -d -pcie
Perform dev_mgmt_daemon and change NNI port speed:
cd /broadcom ./dev_mgmt_daemon -d -pcie -port_100g_speed 40000
cd /broadcom ./dev_mgmt_daemon -d -pcie -port_100g_speed 10000 topology_config_file ./topology_config_16_ports.ini
cd /broadcom ./dev_mgmt_daemon -d -pcie -port_25g_speed 20000
cd /broadcom ./dev_mgmt_daemon -d -pcie -port_25g_speed 10000
cd /broadcom ./dev_mgmt_daemon -d -pcie -port_25g_speed 1000
cd /opt/bcm68650/ ./svk_init.sh -clean ./svk_init.sh -qsfp_speed=10g -sfp_speed=10g cd /broadcom ./dev_mgmt_daemon -d -pcie
cd /opt/bcm68650/ ./svk_init.sh -clean ./svk_init.sh -qsfp_speed=10g -sfp_speed=10g cd /broadcom ./dev_mgmt_daemon -d -pcie
cd /opt/bcm68650/ ./svk_init.sh -clean ./svk_init.sh -qsfp_speed=40g -sfp_speed=10g cd /broadcom ./dev_mgmt_daemon -d -pcie
The dev_mgmt_daemon executable presents the CLI for Broadcom's BAL when run in the foreground which is useful for debugging.
While the first executable still runs (even in background), open another terminal and run openolt:
cd /broadcom ./openolt --interface <interface-name> (or) ./openolt --intf <interface-name>
NOTE:
At the VOLTHA CLI, preprovision and enable the OLT:
(voltha) preprovision_olt -t openolt -H YOUR_OLT_MGMT_IP:9191 (voltha) enable
To collect logs from openolt, dev_mgmt_daemon and syslog processes install td-agent(fluentd variant) directly on OLT device which will capture and transmits the logs to elasticsearch pod running in voltha cluster.
Prerequisite:
OLT should have ntp installed to ensure it has correct time(which is used by td-agent for generated events)
apt-get install ntp
Installation of td-agent deb package:
wget http://packages.treasuredata.com.s3.amazonaws.com/3/ubuntu/xenial/pool/contrib/t/td-agent/td-agent_3.8.0-0_amd64.deb
dpkg -i td-agent_3.8.0-0_amd64.deb
Post Installation:
We have created custom td-agent configuration file to handle format of involved log files using right input plugins and elasticsearch output plugin.
Copy the custom config file from here in the ~ directory of the olt. Then into the /etc folder in order for the agent to pick it up.
cp td-agent.conf /etc/td-agent.conf
service td-agent restart
Need to redirect syslog to default port of fluentd syslog plugin.
/etc/init.d/rsyslog restart
Note:
To enable TLS encryption features with td-agent look at this google doc
Refer BUILDING guide for details on how to build openolt agent.
The information here may be specific to specific OLT and ONU hardware such as Edgecore ASFVOLT16 OLT, Radisys RLT-3200G-W OLT and Broadcom based ONUs.
Auto-negotiation on the NNI (Network to Network Interface) uplink ports is not tested.
By default, the OpenOLT agent sets the speed of the NNI interfaces to 100G. To downgrade the network interface speed to 40G, add the following lines at the end of the /broadcom/qax.soc configuration file.
port ce128 sp=40000
A restart of the dev_mgmt_daemon and openolt services is required after making this change.
The firmware on the ONU is likely not setup to forward 802.1x EAPOL traffic on the Linux bridge. Drop down to the shell in the Broadcom ONU's console and configure the Linux bridge to forward 802.1x.
> sh # echo 8 > /sys/class/net/bronu513/bridge/group_fwd_mask
Version 1.7 of VOLTHA has a known issue where the ONU is only able to pass EAPOL packets from a specific LAN port (e.g. LAN port 1 on ALPHA ONUs)
LAN port packet counters:
bs /b/e port/index=lan{0,1,2,3,4,5,6}
WAN port packet counters:
bs /b/e port/index=wan0
To get access to the BCM.0> maple console, SSH into the OLT and then execute:
cd /broadcom ./example_user_appl
Following is an example of retrieving the interface description for PON intf_id 0
(TODO: document PON interface numbering for Edgecore OLT).
BCM.0> a/t clear=no object=pon_interface sub=itu_pon_stats pon_ni=0 [-- API Start: bcmolt_stat_get --] [-- API Message Data --] object: pon_interface- PON Network Interface. get stat subgroup: itu_pon_stats-ITU PON Statistics. loid: 0 response: OK key={pon_ni=0} data={ fec_codewords=0 bip_units=0 bip_errors=0 rx_gem=0 rx_gem_dropped=0 rx_gem_idle=0 rx_gem_corrected=0 rx_crc_error=0 rx_fragment_error=0 rx_packets_dropped=0 rx_dropped_too_short=0 rx_dropped_too_long=0 rx_key_error=0 rx_cpu_omci_packets_dropped=0 tx_ploams=157 rx_ploams_dropped=0 rx_allocations_valid=0 rx_allocations_invalid=0 rx_allocations_disabled=0 rx_ploams=39 rx_ploams_non_idle=39 rx_ploams_error=0 rx_cpu=0 rx_omci=0 rx_omci_packets_crc_error=0 tx_packets=0 tx_gem=0 tx_cpu=0 tx_omci=0 tx_dropped_illegal_length=0 tx_dropped_tpid_miss=0 tx_dropped_vid_miss=0 tx_dropped_total=0 rx_xgtc_headers=39 rx_xgtc_corrected=0 rx_xgtc_uncorrected=0 fec_codewords_uncorrected=0 rx_fragments_errors=0 } [-- API Complete: 0 (OK) --]
Following command retrieves NNI intf_id 0:
BCM.0> a/t clear=no object=nni_interface sub=stats id=0 [-- API Start: bcmolt_stat_get --] [-- API Message Data --] object: nni_interface- nni_interface. get stat subgroup: stats-NNI Interface Statistics. loid: 0 response: OK key={id=0} data={ rx_bytes=40023 rx_packets=283 rx_ucast_packets=0 rx_mcast_packets=283 rx_bcast_packets=0 rx_error_packets=0 rx_unknown_protos=0 tx_bytes=0 tx_packets=0 tx_ucast_packets=0 tx_mcast_packets=0 tx_bcast_packets=0 tx_error_packets=0 } [-- API Complete: 0 (OK) --]
Following command lists the flows installed on the OLT.
BCM.0> a/m max_msgs=100 filter_invert=no object=flow
dev_mgmt_daemon and openolt agent binary as services?Navigate to /opt/bcm68620 and execute the command /broadcom/dev_mgmt_attach to access the QAX diagnostic shell. If you are not able to access the shell, you need to recompile the BAL SDK with SW_UTIL_SHELL=y option set.
Ensure that additional_bw indicator in the Technology Profile and the bandwidthprofile configured in ONOS netcfg for the subscriber are following the below guideline.
additional_bw is configured as AdditionalBW_BestEffort, ensure cir + eir values in ONOS netcfg BW profile for the subscriber are greater than or equal to 16000 for XGSPON, and it is greater than equal to 32000 for GPON. Also ensure that eir is a non-zero value.additional_bw is configured as AdditionalBW_NA, ensure that both cir and eir are non-zero values, and cir + eir is greater than or equal to 16000 for XGSPON and 32000 for GPON.additional_bw is configured as AdditionalBW_None, ensure that eir is 0 and cir is non-zero and cir is greater than or equal to 16000 for XGSPON, and it is greater than equal to 32000 for GPON.For more details about BW profile parameters, please refer below links.
MEF Wiki - Bandwidth-Profiles-for-Ethernet-Services Technology Profile Implementation Note
cir + eir value is greater than equal to 32000 for XGSPON use case for ALPHA ONU.