Cumulus(NVUE API)

Cumulus switch with version >4.4 to start streaming to ONES Controller via NVUE API

Enable NVUED in Cumulus

sudo systemctl enable nvued
sudo systemctl start nvued

Enable NGINX in Cumulus

sudo systemctl enable nginx
sudo systemctl start nginx

Install NGINX #If not installed in Cumulus

sudo apt update
sudo apt install nginx

NVUE is part of Cumulus NetQ; if it’s missing, you might need to reinstall or configure NetQ

Reinstall or Configure NetQ:

  1. Download the NetQ Agent Package from NVIDIA's support site

    sudo apt install -y <netq-agent-package>.deb
  2. Enable and start the nuved service as shown earlier.

Verification

sudo systemctl status nuved
sudo systemctl status nginx

Enable NVUE API in Cumulus

sudo ln -s /etc/nginx/sites-{available,enabled}/nvue.conf
sudo sed -i 's/listen localhost:8765 ssl;/listen \[::\]:8765 ipv6only=off ssl;/g' /etc/nginx/sites-available/nvue.conf
sudo systemctl restart nginx

Supported APIs:

curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/platform
curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/system
curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/interface
curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/platform/environment
curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/interface/swp7/qos
curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/interface/swp7/counters
curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/qos/mapping
curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/interface/swp1/qos/roce/counters
curl -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/interface/swp1/pluggable
curl  -u 'cumulus:YourPaSsWoRd1$' --insecure https://10.4.5.179:8765/nvue_v1/interface/swp7/link/stats

ONES IS not using NCLU. ONES Application only use NVUE API from OS version 4.4, less than that NCLU code is not enabled for ONES. [For ONES 1.1 testing 4.4 and 5.2 version]

Cumulus 5.x not fully support NCLU, only NVUE. Delay observed in the Time Series data stream for Cumulus 5.9, 5.10 and 5.11