# Cumulus(NVUE API)

{% hint style="info" %}
Cumulus switch with version >4.4 to start streaming to ONES Controller via NVUE API
{% endhint %}

### Enable NVUED in Cumulus

```log
sudo systemctl enable nvued
sudo systemctl start nvued
```

### Enable NGINX in Cumulus

```log
sudo systemctl enable nginx
sudo systemctl start nginx
```

### Install NGINX #If not installed in Cumulus&#x20;

```log
sudo apt update
sudo apt install nginx
```

{% hint style="info" %}
NVUE is part of Cumulus NetQ; if it’s missing, you might need to reinstall or configure NetQ
{% endhint %}

#### Reinstall or Configure NetQ:

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

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

### Verification

```log
sudo systemctl status nuved
sudo systemctl status nginx
```

### Enable NVUE API in Cumulus

```log
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:

```log
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
```

{% hint style="info" %}
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
{% endhint %}
