# Configurations

### ONES YAML Based Configuration&#x20;

Navigate to <mark style="color:blue;">**Configurations >> Configure >> YAML**</mark>&#x20;

* Allows you to configure new devices
* Supports valid YAML files
* You can download the sample YAML file, edit it, and upload it again with the desired configuration

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FnAYZw4A1munybsMtSULk%2Fimage.png?alt=media&#x26;token=b07cac94-755d-463f-90e8-3fce8c67a13f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FPR6Z9oSHdXmrVkKDVUK6%2FScreenshot%202025-02-21%20at%2010.13.17%E2%80%AFPM.png?alt=media&#x26;token=18f88bc0-4278-469f-8c8a-1f3f9ba61ff5" alt=""><figcaption></figcaption></figure>

###

### YAML Config Illustrator

While configuring the topology, users can utilize the "Visualize YAML" feature to preview the structure and layout.

Navigate to <mark style="color:blue;">**Configurations >> Configure Devices >> \<Upload Valid YAML> >> Visualize YAML**</mark>

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FXxc2kbQmZdD7SOGki94Y%2FScreenshot%202025-02-21%20at%2010.13.37%E2%80%AFPM.png?alt=media&#x26;token=3cda8cde-7b27-4c0a-924b-879de906e2b4" alt=""><figcaption></figcaption></figure>

**NOTE**: Follow the[ ONES Configuration ](https://aviznetworks.gitbook.io/ones-3.1.0/ones-web-gui-administration/inventory/configurations/yaml-based-configuration)to know more about configuration and all the possible use cases.

### ONES-UI Based Configuration

Navigate to <mark style="color:blue;">**Configurations >> Configure >> GUI**</mark>&#x20;

This option can be used in case user wants to bring a very basic topology with Vlan, SVI, BGP and few more configuration

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FedEVx3vdPGWJFpANQLfh%2Fimage.png?alt=media&#x26;token=ab01de17-ce94-4510-81ce-04fd358b61e5" alt=""><figcaption></figcaption></figure>

{% embed url="<https://drive.google.com/file/d/1CX5PeJDHTuSMNHX9fVyc4ZuSJ18gfRaS/view?usp=sharing>" %}

## Config Status (Available in YAML & UI Based configuration)

|               ​![](https://lh5.googleusercontent.com/03u_WNS1uEiQTHGZujyE_t4zloPXqxKXURPhHIAKJ5Skss9IvRCr0tBqFP_WCTCKjVwK0kJRciGz9UtNb18v6zdR9VUDyE04vwAZ8zHlBfegshocxbLHklSWll60uVEsI_CaX26zeDD87T9vsWhQ3GMSPiSeR_OGPpx60BtniXy9uc2m7JqBYdT1mA)​               | <p></p><ul><li>Device configuration is not yet started</li><li>In case of the user has not applied any feature like (VXLAN, MCLAG and so on..)</li></ul> |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------: |
| ​![](https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FoURPkf4CplNqoHjrplIx%2FScreenshot%202023-11-27%20at%208.31.27%E2%80%AFPM.png?alt=media\&token=ca5e47e7-fce3-4fa3-8a85-5d4ea6989168)​ |                                                            Device configuration is in progress                                                           |
| ​![](https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FmXppTZstrQAGecguROJ9%2FScreenshot%202023-11-27%20at%208.32.59%E2%80%AFPM.png?alt=media\&token=c741e4c9-eab4-48d1-a761-1135e338e1a9)​ |                            The device configuration has failed. Move the cursor to the failed option to see the Error message.                           |
| ​![](https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2F3QRveZz5yr2HyEjJ3pB8%2FScreenshot%202023-11-27%20at%208.33.12%E2%80%AFPM.png?alt=media\&token=d3f00e65-6c73-450c-ad5a-179b852562b5)​ |                                                      Device configuration is completed successfully                                                      |
|               ​![](https://lh3.googleusercontent.com/kl86ewhyLK01fQs51scCKhaINWeRIYzavkAX8UE78hprWHskv5HjT5gXaLTV9ol3c-Q2wxPsebJ6v6kxVBSAB6heEAKUjvNvZM_npKbrTzc7gA3GqjICytJ1vG_YBLoQ47SJde37lvKvlBHs_konU26yYJqU8NFk1lIU34fUSPnmXJaQjvfMGv_ONg)​               |                        is used to configure or modify a configuration when we need to add several other devices with the same file                       |
|     ![](https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FRnMajOL7jrR48e12abHN%2FScreenshot%202023-08-11%20at%2011.43.40%20AM.png?alt=media\&token=7f7fe9de-1409-427c-bb5d-c8b896ae7326)    |                  Backup & Restore Configs: using this user can take device config backup and can use later to restore the configuration                  |

## Admin Features: (Available in YAML & UI Based configuration)

|                                                                                                                                              Sub Options                                                                                                                                             |                                                Details                                                |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------: |
| <img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FgZEo157ss0ix9AsDOatR%2FScreenshot%202025-02-21%20at%209.48.59%E2%80%AFPM.png?alt=media&#x26;token=698c5c5b-4afb-4fc4-8b32-051fd4b9d10b" alt="" data-size="original"> |                               Allow user to connect via SSH and Console                               |
| <img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2F1NLMPhMIayuuDSI9ESWg%2FScreenshot%202025-02-21%20at%209.49.12%E2%80%AFPM.png?alt=media&#x26;token=b399ce6f-7ceb-4600-bd97-92399aba794f" alt="" data-size="original"> |                                 Allow user to collect the console logs                                |
| <img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FK2kCu96yd7GeSDW2IcHN%2FScreenshot%202025-02-21%20at%209.49.23%E2%80%AFPM.png?alt=media&#x26;token=ffff5645-01a6-41da-aa07-3832dca6c9ec" alt="" data-size="original"> |     Used to get the view of Config Intent and Applied Config and user can copy the complete config    |
| <img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FErIYVReJduIXnhmNkHiA%2FScreenshot%202025-02-21%20at%209.49.56%E2%80%AFPM.png?alt=media&#x26;token=9ec3f6f4-0d47-42e7-870b-40fff85dcd22" alt="" data-size="original"> |          Allow user to Manually modify and apply specific configurations directly from the UI         |
| <img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FvUSDmThJF9MkLjUQVKIX%2FScreenshot%202025-02-21%20at%209.50.05%E2%80%AFPM.png?alt=media&#x26;token=0db5732a-dd96-4795-b881-1991f68d7577" alt="" data-size="original"> | Allow users to Compare device configurations or track changes using backups from different timestamps |

### Connect

Configuration Page allows a user to connect to the device using console access or using SSH method too.

<mark style="color:blue;">**Navigate >> Configurations >> Devices >> Connect**</mark>

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FY1pvoam5IhTN6sd23syo%2FScreenshot%202024-04-22%20at%201.22.12%E2%80%AFPM.png?alt=media&#x26;token=bf6e4d90-778f-460b-8550-87ff02579549" alt=""><figcaption></figcaption></figure>

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FDBAoTWqKZPVt5jYgRRQR%2FScreenshot%202024-04-22%20at%201.23.00%E2%80%AFPM.png?alt=media&#x26;token=bf4b0618-9da9-49a0-be7b-67e3aefb7f33" alt=""><figcaption></figcaption></figure>

User can choose SSH or console option to access the device.

### Console Logs

Console Logs show the exact configuration loaded on the device and the overview of the config loaded as per YAML & Derived Host IP Range can be viewed from the "Derived\_Config:" section

<mark style="color:blue;">**Navigate >> Configurations >> Devices >> Console Logs**</mark>

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2Fzrzf7uJdX99eqLmjMeKU%2Fimage.png?alt=media&#x26;token=f89ff6d9-7881-416d-89a3-0ddd3dbfc9e7" alt=""><figcaption></figcaption></figure>

* Click on the Console Log of the device&#x20;

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2Fu418xSnoHGsWglu7eqOV%2FScreenshot%202024-04-22%20at%201.14.40%E2%80%AFPM.png?alt=media&#x26;token=07f905ab-bbdf-4e21-aba5-f0646a1b3695" alt=""><figcaption><p>It will open in new window</p></figcaption></figure>

### Config

This section describes the configuration feature of ONES using which you can check the applied and running configurations.&#x20;

<mark style="color:blue;">**Navigate >> Configurations >> Devices >>  Config**</mark>\\

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FeWFtGJVnCfcxzKAJTHf2%2Fimage.png?alt=media&#x26;token=d012930a-a97b-43df-99ae-d46894d5796f" alt=""><figcaption></figcaption></figure>

* **Click on Config**\\

  <figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FPBukvu8TL7E8o8DH0BgU%2Fimage.png?alt=media&#x26;token=da02828a-49e6-4333-ba5b-43854e68d5b2" alt=""><figcaption></figcaption></figure>

### NetOps

This section can be used to do manual config, instead of complete infra config, user can do individual changes per device

<mark style="color:blue;">**Navigate >> Configurations >> Devices >> NetOps**</mark>\\

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2Fcfb3fZr59aw0LuESxRfw%2Fimage.png?alt=media&#x26;token=9be86231-2dbb-4317-8441-b617677c9b6e" alt=""><figcaption></figcaption></figure>

### Compare Configuration

This section describes the compare configuration feature of ONES using which you can compare the applied and running configurations.&#x20;

<mark style="color:blue;">**Navigate >> Configurations >> Devices >> Compare Configs**</mark>\\

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2F5Tpxh9kxmsIXok6tjmTo%2Fimage.png?alt=media&#x26;token=86bf58a6-69bc-4962-ab78-76e5a80664a9" alt=""><figcaption></figcaption></figure>

* **Compare Config**

This page allows the user to compare applied configurations to the running configuration of a selected device.

The user should select only one device from the list and perform 'Compare Config' on this page, it may take several minutes to fetch the running configuration from the device

YAML Editor will appear with two windows comparing applied and running configurations as depicted in the below picture

The difference in configuration is highlighted with colour coding in the respective window of the configuration​​\\

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FmdiL647H0Ie27jFmXFPy%2Fimage.png?alt=media&#x26;token=891144cd-c731-4417-82ef-91107575b7fc" alt=""><figcaption></figcaption></figure>

### Backup & Configuration

This Section describe the use of Backup & Restore Configuration across all the managed devices

<mark style="color:blue;">**Navigate >> Configurations >> Devices >> Backup & Restore Configs**</mark>\\

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FkmPOE5ZSNDzn0wrywJt4%2Fimage.png?alt=media&#x26;token=8ff113ed-96aa-4344-b8bf-8e47e25d4532" alt=""><figcaption></figcaption></figure>

Using this feature, a user will be able to take multiple backups and will be able to restore the backup at any time.

#### Taking a Backup

* Select Backup & Restore Configs

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2F0Igu5tZVBKq0vQcXtpYE%2FScreenshot%202025-03-17%20at%2011.20.56%E2%80%AFAM.png?alt=media&#x26;token=f2dee5ee-4be8-4b73-8762-4914f3c5de77" alt=""><figcaption></figcaption></figure>

* Give a Tag Name to the device & Select the device, the device you want to take a backup config
* Submit the task

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FAUwoX2R73w60CaMuhea5%2FScreenshot%202025-03-17%20at%2011.21.45%E2%80%AFAM.png?alt=media&#x26;token=47a99038-27ea-4853-8616-62ad4ee28ba3" alt=""><figcaption></figcaption></figure>

* Once submitted the config will backup with the given name & can be used to restore the config at any time in future

#### Restoring a Backup

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FchlqBV0IqbobPDx1f6wE%2Fimage.png?alt=media&#x26;token=f82f1281-4b1c-45ad-b0b7-ffcc652d6bca" alt=""><figcaption></figcaption></figure>

* Select **Backup & Restore Configs**
* Select **Restore Config**

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FWzF8KOhATuEJeExjmFAZ%2FScreenshot%202025-03-17%20at%2011.22.56%E2%80%AFAM.png?alt=media&#x26;token=5fe19f33-29d9-4d92-9aa0-41c27cf39b98" alt=""><figcaption></figcaption></figure>

* Click on the **drop-down** button of the device on which the user wants to **restore the config**

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FshiWxxFC3P0uC8jwmwOt%2FScreenshot%202025-03-17%20at%2011.23.44%E2%80%AFAM.png?alt=media&#x26;token=e866b228-92fc-497d-a5ef-12b2e76b6ed5" alt=""><figcaption></figcaption></figure>

* Select the **backup** a user wants to restore from the **Backups Available** list
* Then **Submit** the backup & Click on Yes to confirm

<figure><img src="https://21707399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2kx3WmNibhYYGgtbf7Ky%2Fuploads%2FQTRhWqr6iTExEBBeJ98d%2FScreenshot%202023-08-11%20at%2012.15.45%20PM.png?alt=media&#x26;token=05a00598-86f1-4099-8773-ad3c5af7f911" alt=""><figcaption></figcaption></figure>
