Devices

This section explains how users can add/manage/remove the devices using ONES.

Devices

  • Navigate to Manage >> Devices

  • 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

The user needs to make sure, The devices have a unique name, otherwise, there will issue while plotting the full topology view(Topology Page).

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

  • This page gives the control to onboard the devices with two options

    1. Add Devices using the YAML

    2. Upload the CSV file containing the device list

The movement user chooses CSV upload, then the YAML Editor will be disabled

1. Add Devices using YAML

  • Click on Add Devices

  • Upload Device Inventory using YAML Editor

  • Navigate to Manage >> Devices >> Add Devices >> Use YAML

  • Use the below format to add devices to the application

To Identify the device type user needs to mention the platform

Device Type

  1. Cumulus: cumulus

  2. Arista: arista

  3. Cisco: cisco-nxos

  4. SONiC: sonic

  5. Server: server

For SONiC-based devices, the user can also leave the type field empty

 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 Save & Apply

  • ONES Application is now ready to manage the added devices

2. Add devices using CSV

  • Click on Add Devices

  • Upload Device Inventory using CSV File

  • Navigate to Inventory >> Devices >> Add Devices >> Use CSV

  • Use the below format to add devices to the application

  • Select CVS file to Upload >> Choose CSV file containing devices entry >>

  • Upload & Add

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

  • 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

  • Device ports: allow user to check all the interface detials per device

  • 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

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

This feature gives the control to upgrade the device to the new version

An HTTP image link is required to use the custom upgrade

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

Once the image is loaded, the ONES application will show the last image details and time stamp

  • 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

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

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

  • Techsupport: user can download the techsupport using thie feature

  • Connect: Using this feature we directly get the CLI access of the device

    • SSH Connect

    • Console Connect

  • Syslog

  • Remove: user can simply remove the device from inventory

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

PreviousManageNextFabric

Last updated