ONES Integration with FTAS

ONES Integration with FTAS

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)

• Device licenses are needed for agent to stream data, Aviz support will provide licenses for device serials supplied by customer - Contact Aviz support team for subscription details

• Enter device details (Management IP, Username and Password and the license key) on device_info.csv

oper@ftasvm:~$ vi device_info.csv

10.4.4.75, admin, YourPaSsWoRd, c48b567d876534cef889003
10.4.4.76, admin, YourPaSsWoRd, ab45678fdc5543eda000946e
10.4.4.77, admin, YourPaSsWoRd, ccfffa8876543ed6654da6675 
...
...
...

• Save the File

• 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…………………. 
...
...
...

ONES Web GUI Administration

Web UI describes all the ONES features to monitor devices - https://aviznetworks.gitbook.io/ones-user-guide/ones-web-gui-administration