Cisco Catalyst 8000V Edge Software Installation And Configuration Guide

PDF

Monitor and Troubleshoot Device Plug and Play (PnP) Onboarding using WebUI

Updated: March 5, 2026

Want to summarize with AI?

Log in

Overview

This section provides information on monitoring and troubleshooting Device Plug and Play (PnP) Onboarding using WebUI.

A device can be automatically onboarded to Cisco vManage through either Zero Touch Provisioning (ZTP) or the Plug and Play (PnP) process. This section describes the procedure to monitor and troubleshoot device onboarding through the PnP method. This feature on WebUI enables you to monitor and troubleshoot the PnP onboarding process, and also see its real-time status. If this onboarding is stuck or fails, you can terminate the process and onboard your device manually.

  • Your device (a computer that can run a web browser) running the WebUI and the device you are onboarding must be connected through an L2 switch port (NIM) on the device.

  • The DHCP client-identifier on your device must be set to string “webui”.

  • Your device must support Cisco SD-WAN Day-0 device onboarding on WebUI.

Procedure

1.

Enter the controller mode in WebUI

Note
If the device does not have start-up configuration at the time of PnP onboarding, the WebUI is enabled by default on supported devices.
2.

On the Welcome to Cisco SDWAN Onboarding Wizard page, click Reset Default Password.

Note
The default password of your Day-0 device is weak. Therefore, for a secure log in, you must reset the password when you first log in to the device on WebUI. The WebUI configuration is automatically deleted after the device is onboarded successfully. In rare cases where the template configuration for your device on Cisco vManage has the WebUI configuration, it is not deleted even after a successful device onboarding.
3.

You are redirected to the Device hardware and software details page. Enter your password and click Submit.

The next page displays the onboarding progress and lists statuses of different components of the PnP Connect Portal and Cisco SD-WAN controllers. If the PnP IPv4 component fails, it indicates that the device PnP onboarding has failed.

To view and download logs for the onboarding process, click the information icon on the right hand side of the SDWAN Onboarding Progress bar.
4.

The next page displays the onboarding progress and lists statuses of different components of the PnP Connect Portal and Cisco SD-WAN controllers. If the PnP IPv4 component fails, it indicates that the device PnP onboarding has failed.
5.

If the automated PnP onboarding fails, click Terminate Automated Onboarding. This allows you to onboard your device manually.

The dialogue box appears. To continue with the termination, click Yes . It might take a few minutes for the termination to complete.
6.

On the Bootstrap Configuration page click Select File and choose the bootstrap file for your device. This file can be either a generic bootstrap file (common platform-specific file) or a full configuration bootstrap file that you can download from Cisco Catalyst SD-WAN Manager. This file must contain details such as the vBond number, UUID, WAN interface, root CA and configuration.
7.

Click Upload .
8.

After your file is successfully uploaded, click Submit.
9.

You can see the SDWAN Onboarding Progress page again with statuses of the Cisco SD-WAN controllers. To open the Controller Connection History table click the information icon on the right hand side of the SDWAN Control Connections bar. In this table you can see the state of your onboarded device. After the onboarding is complete, the state of your device changes to connect .