# Devices

## Devices

* Navigate to <mark style="color:blue;">**Manage >> Devices**</mark>

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2F5IEceFLeH4doaGc61PDS%2FScreenshot%202025-08-21%20at%209.46.11%E2%80%AFPM.png?alt=media&#x26;token=46c11f20-15fb-4944-a413-05ebf0aa2f67" alt=""><figcaption></figcaption></figure>

* Using this tab, user can:
  * Onboard the non-sonic(Agent-Less) device to the application using Add devices
  * Syslogs capture
  * Upgrade the device using Custom Upgrade
  * Upgrade the device using ZTP (Zero Touch Provisioning)
  * Reboot individual devices or multiple devices by selecting them in one click
  * Remove the devices
  * Tech-Support download
  * Device RMA
  * Complete Inventory can be downloaded in CSV format

{% hint style="info" %}
Downloaded inventory file is password protected: **Lab4SREMan1**
{% endhint %}

{% hint style="warning" %}
The user needs to make sure, The devices have a unique name, otherwise, there will issue while plotting the full topology view(Topology Page).
{% endhint %}

### Sonic Devices

* Agent-based devices auto-discover the ONES-App and get registered automatically on the ONES Inventory page

### Add Non-Sonic Devices

* To Onboard the Agent-Less devices user needs to add them manually
  * Navigate to Devices

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2FQBOQNP1kbyGz2oDWiJBw%2Fimage.png?alt=media&#x26;token=40acb65e-eccf-402f-b24c-629ac3fdf781" alt=""><figcaption></figcaption></figure>

* This page gives the control to onboard the devices with two options&#x20;
  1. <mark style="color:blue;">**Add Devices**</mark> using the <mark style="color:blue;">**YAML**</mark> &#x20;
  2. Upload the <mark style="color:blue;">**CSV file**</mark> containing the device list

{% hint style="warning" %}
The movement user chooses CSV upload, then the YAML Editor will be disabled
{% endhint %}

## 1. Add Devices using YAML

* Click on <mark style="color:blue;">**Add Devices**</mark>
* Upload Device Inventory using <mark style="color:blue;">**YAML Editor**</mark>
* Navigate to Manage <mark style="color:blue;">**>> Devices >> Add Devices >> Use YAML**</mark>
* Use the below format to add devices to the application

{% hint style="info" %}
To Identify the device type user needs to mention the platform
{% endhint %}

### Device Type&#x20;

1. Cumulus: cumulus
2. Arista: arista
3. Cisco: cisco-nxos
4. SONiC: sonic&#x20;
5. Server: server

{% hint style="info" %}
For SONiC-based devices, the user can also leave the type field empty
{% endhint %}

```yaml
 inventory:
     - ipAddress: "172.18.0.21"
       layer: "Core"
       region: "San Jose"
       azId: 1
       brickId: 1
       rackId: 1
       fabricId: "Default"
       user: "admin"
       password: "admin"
       type: "sonic"
       groupId: 1
     - ipAddress: "172.18.0.22"
       layer: "Core"
       region: "San Jose"
       azId: 1
       brickId: 1
       rackId: 1
       fabricId: "Default"
       user: "admin"
       password: "admin"
       type: "sonic"
       groupId: 1
     - ipAddress: "172.18.0.23"
       layer: "Core"
       region: "NYK"
       azId: 1
       brickId: 1
       rackId: 1
       fabricId: "Default"
       user: "admin"
       password: "admin"
       type: "sonic"
       groupId: 1
     - ipAddress: "172.18.0.24"
       layer: "Core"
       region: "NYK"
       azId: 1
       brickId: 1
       rackId: 1
       fabricId: "Default"
       user: "admin"
       password: "admin"
       type: "sonic"
       groupId: 1
     - ipAddress: "172.18.0.25"
       layer: "Server"
       region: "San Jose"
       azId: 1
       brickId: 1
       rackId: 1
       fabricId: "Default"
       user: "admin"
       password: "admin"
       type: "server"
       groupId: 1
     - ipAddress: "172.18.0.26"
       layer: "Server"
       region: "NYK"
       azId: 1
       brickId: 1
       rackId: 1
       fabricId: "Default"
       user: "admin"
       password: "admin"
       type: "server"
       groupId: 1
     - ipAddress: "172.18.0.27"
       layer: "Server"
       region: "San Jose"
       azId: 1
       brickId: 1
       rackId: 1
       fabricId: "Default"
       user: "admin"
       password: "admin"
       type: "server"
       groupId: 1
     - ipAddress: "172.18.0.28"
       layer: "Server"
       region: "NYK"
       azId: 1
       brickId: 1
       rackId: 1
       fabricId: "Default"
       user: "admin"
       password: "admin"
       type: "server"
       groupId: 1
```

* Make sure to use the correct indentation for the YAML files
* Click <mark style="color:blue;">**Save & Apply**</mark>
* ONES Application is now ready to manage the added devices

## 2. Add devices using CSV

* Click on <mark style="color:blue;">**Add Devices**</mark>
* Upload Device Inventory using <mark style="color:blue;">**CSV File**</mark>
* Navigate to <mark style="color:blue;">**Inventory >> Devices >> Add Devices >> Use CSV**</mark>
* Use the below format to add devices to the application

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2F8oGwOQpsc9CDvgO0Peia%2Fimage.png?alt=media&#x26;token=b4a7c9be-fe97-4174-9845-b40c11b60829" alt=""><figcaption></figcaption></figure>

* <mark style="color:blue;">**Select CVS file to Upload >> Choose CSV file containing devices entry >>**</mark>

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2FH4VaZtbt523L2aamHCyP%2Fimage.png?alt=media&#x26;token=33847660-2e62-41cb-ba25-7fd98ff2de8e" alt=""><figcaption></figcaption></figure>

* <mark style="color:blue;">**Upload & Add**</mark>

### Feature Set

* Role / Region: Shows the device roles and regions
* SKU / ASIC: Shows the device hardware SKU and ASIC vendor
* Port / Max Speed
  * Shows the number of ports per device and max port speed on the device&#x20;
* PSUs / Fans: Shows the total number of Power supplies and Fans present on a particular device
* NOS Image: Shows the details of the network operating system running on the device and when it was last updated
* ONIE Version: Shows which ONIE version is running on the device and when the last reboot time of the device
* Agent Version / Network OS: Shows the agent version running on the device and the current active OS version on the device
* Agent status / Last contact: Latest status of the Agent and when it was last communicated with that Agent.

### Sub-options per device

* Device info: Allow the user to check device specific details

  <figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2FyVqlMQwm6bg5vDm4RSmr%2Fimage.png?alt=media&#x26;token=55578e7c-b27e-42e7-8c9d-82a85b951e41" alt="" width="375"><figcaption></figcaption></figure>
* Device ports: allow user to check all the interface detials per device

  <figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2FFud3BT60lWI1lLQsr59q%2Fimage.png?alt=media&#x26;token=edcb4a3b-28ab-41b3-bcc4-a2a962644af3" alt=""><figcaption></figcaption></figure>
* Show Components: allow user to check the component status
* Mark for RMA: User can mark the device as RMA device to perform RMA of devices, while maring RMA, ONES take a backup of the configuration

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2FnCI2ggjKop3fnUkLTDlI%2FScreenshot%202025-08-16%20at%202.57.08%E2%80%AFAM.png?alt=media&#x26;token=83887918-0cc4-4473-afcd-c58107216f10" alt=""><figcaption></figcaption></figure>

* Custom Upgrade: allow user to add a customer image for the next boot

{% hint style="warning" %}
This feature gives the control to upgrade the device to the new version

An HTTP image link is required to use the custom upgrade
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfFwaAQLLZEHTtDm4WgebbcIAsip_sMpjk9l-cA2klQRkcXLv_BTFsB_21M80EMQwnpwJeOJEL6izdIHG5X4rd662xm76OLRnhmrGZtrQByPLAFlbB_bzMbqP2w9TYjBQf8pVga?key=uAIlOqmIVEgi3tN34Pe3qQ" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**HTTP image URL should be accessible**

**This image will be downloaded to the device  and configured as the next boot image and devices will be reloaded**

**Once the device comes up with the new image, the ONES application will install Telemetry and Fabric manager agent**

**when we upgrade any device that will be locked to do any further changes after a successful upgrade user can again use the same device for another task**<br>

**Once the image is loaded, the ONES application will show the last image details and time stamp**
{% endhint %}

* Upgrade Via ZTP: Using this feature, user will be able to trigger ZTP on the device, and then device contact to ZTP server and load&#x20;

{% hint style="warning" %}
when we upgrade any device that will be locked to do any further changes, after a successful upgrade user can again use the same device for another task
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfUB2RPyOe3H5MTTNWBnc1dh_lD-XNEBJYmdyGIOn_-Y8VwtvKlUc4DqCQbwLgu_0UMsKutJ0L47RVy0D1X89VcW8iNWKOhZSSzvS5PcoKh_FzcBQdTFVtS4tp8ALgUMq9kAgrm?key=uAIlOqmIVEgi3tN34Pe3qQ" alt=""><figcaption></figcaption></figure>

* Reboot: user can use this option to trigger a reboot

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXejOYhNQVAs06VNDoyHL9jmA5C46G8PudJbB8_54-y2D38De8r5e416l2698lvVQIJ1gy0rB0Hy3-oFCdqhdq1lTc5FkXJ0FMOhkilowzW37tqyZCtrHJq87BsbrCn78MXBs5eISw?key=uAIlOqmIVEgi3tN34Pe3qQ" alt=""><figcaption></figcaption></figure>

* Techsupport: user can download the techsupport using thie feature

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2FFXzrha7xT7P4ME6wpvkO%2FScreenshot%202025-08-16%20at%202.03.03%E2%80%AFAM.png?alt=media&#x26;token=55836d52-1d1d-4eaa-a1c5-1ac1096d3e8a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2F0EiPQtlbVAAncSZUexoR%2FScreenshot%202025-08-16%20at%201.36.58%E2%80%AFPM.png?alt=media&#x26;token=589866be-ec3e-46b4-8fac-3fcbae559299" alt=""><figcaption></figcaption></figure>

* Connect: Using this feature we directly get the CLI access of the device
  * SSH Connect&#x20;
  * Console Connect

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2FSUMmJvHdkItlB6xhk0YJ%2FScreenshot%202025-08-16%20at%202.05.57%E2%80%AFAM.png?alt=media&#x26;token=de5d65a9-868b-437e-b9d8-7d330c93024d" alt=""><figcaption></figcaption></figure>

* Syslog

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2FyuYUIdNoUSH78apKsBxo%2FScreenshot%202025-08-16%20at%202.06.36%E2%80%AFAM.png?alt=media&#x26;token=55da3981-31ed-49b3-b102-5a5b242b986a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2376813750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd2rizc8cOY7cJKDEOsa%2Fuploads%2Fl06Rl39lM2RERzo4FxIz%2FScreenshot%202025-08-16%20at%202.07.08%E2%80%AFAM.png?alt=media&#x26;token=873d1a17-9a58-4c27-b172-c8a1be910bd0" alt=""><figcaption></figcaption></figure>

* Remove: user can simply remove the device from inventory

{% hint style="warning" %}
If the devices are agent-based they will get added again after some time, \
if the user wants to remove the agent-based devices, then the user needs to uninstall the agent from the device
{% endhint %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdwM6pT_rE8JBVcp_y9UVrmDbhf8oAbKuaQ8ToPyi9xlyRobKgiN8_K2FDPredlkX6_ItUwETO8Fv4452mQEFC7hCd7prCjRRPA7M1OE57aQ1tyhUJ9oYq2xw1Mqxc4L37Eb8VCDg?key=uAIlOqmIVEgi3tN34Pe3qQ" alt=""><figcaption></figcaption></figure>