Installation Pre-requisites

Installation Overview

ONES Installation follows the below steps in the order sequence of:

• License Readiness

• Preparing and Installing ONES Application machine

• Installing ONES Agents on SONiC Switches for Orchestrator and Telemetry

• Enabling OpenConfig on non-SONiC Switches for Telemetry

License Readiness

After installation of ONES application user needs to contact AVIZ support to generate a trail license, trail license works for 8 devices and upto 30 days a customer can use.

• ONES Application License (As per device count)

Trail license support feature

• Telemetry Visibility (Monitor, inventory, analytics)

• Add/remove Non-SONiC devices via YAML or CSV

• Support (Zendesk)- Ability to open a ticket with inventory dump

• Syslog access, Console/SSH access for device

To obtain a license, contact [e-mail] providing the below details;

• License Duration - In Years (1-5)

• Devices Count - 8, 16, 32, 64, 128, 256, 512 or 1024

• ONES installation ID

• Email ID: (For Account creation)

Users can get the ONES installation ID on the ONES-UI Login page after the installation

System Hardware Requirements – ONES Application

In the current release, ONES can support managing up to 1024 devices. For ONES Application Installation, the system hardware requirements vary based on the number of devices to manage;

Devices	Processor and Cores	RAM	Storage
8	x86/x64 based, 16-core CPU	32GB	160GB or more
16	x86/x64 based, 16-core CPU	64GB	320GB or more
32	x86/x64 based, 32-core CPU	128GB	640GB or more
64	x86/x64 based, 32-core CPU	256GB	1.2TB or more
128	x86/x64 based, 32-core CPU	256GB	3 TB or more
256	x86/x64 based, 32-core CPU	512GB	6 TB or more
512	x86/x64 based, 64-core CPU	1TB	12 TB or more
1024	x86/x64 based, 64-core CPU	1TB or more	20 TB or more

System Software Requirements - ONES Application

OS	Libraries
Ubuntu 18.0 or later	docker, docker-compose python3, python3-pip paramiko scp

Task	Command	Validation
Ubuntu Server	Installer file (Version 18 or higher)	lsb_release -a
Update to latest packages	sudo apt-get update	NA​
Install Docker	sudo apt-get install docker.io	​docker ps​
Install Docker-compose	sudo apt-get install docker-compose	docker-compose version​
Install Python3	sudo apt-get install python3	python3 –-version
Install Python3-pip	sudo apt-get install python3-pip	pip3 –-version
Install Paramiko	sudo apt-get install python3-paramiko	​pip show paramiko
Install SCP-Client	sudo pip3 install scp	pip show scp

ONES Application package will take care of this prerequisite at the time of installation, Package verify the availability of the dependencies first then execute the application scripts

Note* Script do not take care about the update to latest version of ubuntu

Customer Firewall Configuration (Ports to be opened)

Ports to be open from Agent(Source) to ONES controller(Destination)

These ports has to be enable on ONES Controller

ONES Service	Port Numbers
ONES Collector	50053

Ports to be open from ONES controller(source) to Agent(Destination)

These ports has to be enable on Device(Switch)

ONES Service	Port Numbers
Switch Access over SSH	22
ONES Monitoring	50052

Ports to be open on ONES Server for ONES Services

ONES Service	Port Numbers
gNMI Gateway (Telemetry)	9339
ONES Telemetry Database	5432
ONES Orchestrator	8787
ONES Orchestrator Database	2345
pty-server	8885
API-Server	8080
stream-processer	8093
ksqldb-server	8088
kafka-connect	8083
schema-registry	8081
broker	29092, 9101, 9092
Zookeeper	2181
ONES Collector	50053

Ports to be open for HTTPS Access

HTTPS port has to be enable if a firewall is present in between User-machine and ONES-Controller

ONES Service	Port Numbers
ONES Web GUI	443

These port numbers should be available to use and all ports must be allowed in the firewall if the Database server and devices are in the different DMZ zone

sudo iptables -L // This command can be used to verify the used ports

Network Switch (Managed Node) Configuration Requirement

• SSH is enabled

• Network Reachability from ONES Application

• OpenConfig feature is enabled (for non-SONiC Switches)

Browser Requirements for ONES Web User Interface access

• Google Chrome version 107 or later

• Mozilla Firefox version 106 or later

ONES Multisite

• Ubuntu 18.0 or later can be used for Multisite app

• ONES Multisite has to be installed on separate server

• ONES Multisite use TCP port 443

• Reachability between ONES sites and Multisite instance.