# Installation Pre-requisites

## Installation Overview

ONES Installation follows the below steps in the order sequence of;&#x20;

* License Readiness&#x20;
* 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

The installer allows a default capability on managing 8 devices without a license. Beyond this, the following license keys are required for proceeding with the Installation;&#x20;

* ONES Application License (As per device count)&#x20;

To obtain a license, contact <support@aviznetworks.com> providing the below details;

* License Type - Evaluation Trial or Full
* Devices Count - 32, 64, 128, 256, 512 or 1024
* ONES installation ID&#x20;
* Email ID: (For Account creation)

{% hint style="warning" %}
Users can get ONES installation ID on ONES-UI Login page after the installation&#x20;
{% endhint %}

## 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 Memory                      | Storage |
| ------- | ----------------------------------------- | ------- |
| 128     | x86/x64 based 4-core CPU with 16GB of RAM | 256GB   |
| 256     | x86/x64 based 4-core CPU with 32GB of RAM | 1TB     |

## System Software Requirements - ONES Application

| OS                   | Libraries                                                                         |
| -------------------- | --------------------------------------------------------------------------------- |
| Ubuntu 18.0 or later | <p>docker, docker-compose</p><p>python3, python3-pip</p><p>paramiko</p><p>scp</p> |

|            Task           |                Command                |        Validation       |
| :-----------------------: | :-----------------------------------: | :---------------------: |
|       Ubuntu Server       | Installer file (Version 18 or higher) |       hostnamectl​      |
| 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      |

<br>

## Customer Firewall Configuration (Ports to be opened)

| ONES Service               | Port Numbers |
| -------------------------- | ------------ |
| ONES Web GUI               | 443          |
| Switch Access over SSH     | 22           |
| ONES Monitoring            | 50052        |
| gNMI Gateway (Telemetry)   | 9339         |
| ONES Telemetry Database    | 5432         |
| ONES API service           | 8885         |
| ONES Orchestrator          | 8787         |
| ONES Orchestrator Database | 2345         |

NOTE: 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

## 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
