Open Networking Enterprise Suite (ONES) is a Network Orchestration, Visibility, and Assurance solution for multi-vendor and multi-NOS operated Network Infrastructure. ONES provides a one-stop solution from delivering deep visibility into your datacenter networks to extending 24x7 support functions for SONiC. It also hosts a powerful analytics engine that assists users to identify network issues and troubleshoot their networks, in case of common network anomalies and disruptions.
Why need ONES visibility into Test qualification?
ONES visibility into Test qualification helps customers to detect issues such as memory leaks, system/process CPU hogs early in the pipeline a.k.a pre-deployment stage, so that customers can confidently deploy qualified SONiC images across the fabric.
How to use ONES?
ONES is well integrated with FTAS VM and there will be ONES web user interface (UI) up and running for customers to add devices to monitor it. ONES uses agent and collector architecture where the agents will continuously stream data to controllers and the controllers normalize the data and store it in database for analytics.
Note: A startup script installs the ONES application and sometimes it takes 10+ minutes (depend on host server performance) to ONES UI gets installed on the first time FTAS VM boots. You can check ONES UI containers status as follows.
oper@ftasvm:~$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
9dd3cb3d6c71 netservices:v1 "/usr/bin/supervisord" 26 minutes ago Up 26 minutes net_services
906e8a13ce84 avizdock/ones-collector:v1.0.0 "java -jar /app/coll…" 28 minutes ago Up 28 minutes 8093/tcp ones-collector
1be9932c47f5 avizdock/ones-fm:v1.0.0 "java -jar /app/ses-…" 28 minutes ago Up 28 minutes 0.0.0.0:8787->8080/tcp, :::8787->8080/tcp ones-fm
64b719566fab avizdock/docker:latest "docker-entrypoint.s…" 28 minutes ago Up 28 minutes docker
2519860d8d2f avizdock/ones-gateway:latest "./gnmi-gateway -Tar…" 28 minutes ago Up 28 minutes 0.0.0.0:9339->9339/tcp, :::9339->9339/tcp ones-gateway
26696d950db7 avizdock/postgres:14 "docker-entrypoint.s…" 28 minutes ago Up 28 minutes 0.0.0.0:2345->5432/tcp, :::2345->5432/tcp ones-fm-db
a9f61ee7e790 avizdock/timescaledb:latest "/docker-entrypoint.…" 28 minutes ago Up 28 minutes 8008/tcp, 0.0.0.0:5432->5432/tcp, :::5432->5432/tcp, 8081/tcp ones-collector-db
89f057a06ffb avizdock/ones-ui:v1.0.0 "docker-entrypoint.s…" 28 minutes ago Up 28 minutes 0.0.0.0:3002->3002/tcp, :::3002->3002/tcp, 0.0.0.0:8885->8885/tcp, :::8885->8885/tcp ones-ui
ONES agent installation
Overview
ONES requires user to install the telemetry agent on SONiC NOS to allow Network Visibility
ONES Telemetry Agent for Telemetry Data Streaming (Network Visibility)
NOTE: for non-SONiC switches,
OpenConfig feature on its NOS needs to be enabled for Network Visibility (Telemetry Data Streaming)
The ones telemetry agent binary files can be found at ~/ones.
oper@ftasvm:~$ cd ~/ones
$ls -lrnt
-rw-rw-r-- 1 1000 1000 505 Nov 18 16:54 topo.yaml
-rw-rw-r-- 1 1000 1000 5363 Nov 18 16:54 s3_uninstaller.py
-rw-rw-r-- 1 1000 1000 90 Nov 18 16:54 requirements.txt
-rw-rw-r-- 1 1000 1000 636 Nov 18 16:54 README.md
-rw-rw-r-- 1 1000 1000 7125 Nov 18 16:54 ones_agent_uninstaller.py
-rw-rw-r-- 1 1000 1000 338 Nov 18 16:54 ones-agent.service
-rw-rw-r-- 1 1000 1000 3045 Nov 18 16:54 ones_agent_installer.py
-rw-rw-r-- 1 1000 1000 16742 Nov 18 16:54 ones_agent_helper.py
-rw-rw-r-- 1 1000 1000 92 Nov 18 16:54 device_info.csv
-rw------- 1 1000 1000 659662848 Nov 18 16:54 ones-agent.tar
Installation (Agent Install on multiple switches at the same time)
Enter device details (Management IP, Username and Password and the license key) on device_info.csv
Verify and Clean up old versions of Agents running
oper@ftasvm:~$ python3 ones_agent_uninstaller.py
###########Connecting to Switch############
###########Connecting to Switch############
###########Connecting to Switch############
###########Connecting to Switch############
Connection to switch 10.4.4.75 successful…………
Looking for previous installation………………………
Removing Agents currently installed………………….
Connection to switch 10.4.4.76 successful…………
Looking for previous installation………………………..
ones-agent is not in the device 10.4.4.76 for uninstallation….
...
...
...
Execute the installation script can be used for installing telemetry agent on one or more devices in the data center.
oper@ftasvm:~$ python3 ones_agent_installer.py
###########Connecting to Switch############
###########Connecting to Switch############
###########Connecting to Switch############
###########Connecting to Switch############
Connection to switch 10.4.4.75 successful…………
Installing agent on 10.4.4.75………………………..
Installation of agent on 10.4.4.75 successful………………….
Connection to switch 10.4.4.76 successful…………
Installing agent on 10.4.4.76………………………..
Installation of agent on 10.4.4.76 successful………………….
...
...
...