Skip to main content
Cisco SD-WAN
Support
Product Documentation
Viptela Documentation

Plug and Play Support Guide for Cisco SD-WAN Products

    Here are some interesting things about...

    Introduction

    The purpose of this document is to go through capabilities that are created on the Cisco® Plug and Play (PnP) portal to support the on-boarding of SD-WAN (formerly Viptela) products. This document will help Cisco SD-WAN customers understand the different steps that are needed to either bring up or debug on-boarding of a Cisco vEdge device or a vBond controller.

    Cisco Smart Account and Virtual Account

    Introduction to Cisco Smart Account and Virtual Account

    After creating a Smart Account, customers can create Virtual Accounts that reflect their organizational departments, then associate licenses and devices with those departments.

    clipboard_e296bb0dec1d5bd5e58b0837129b8d88f.png

    How Smart and Virtual Accounts are used for on-boarding

    Smart Accounts and Virtual Accounts are essential in a successful on-boarding of a vEdge router to its corresponding network.
    While placing an order on Cisco Commerce Workspace, a customer can assign the same Smart Account and Virtual Account to the order. They can log in to Cisco vManage (version 18.x and above) to find the Smart and Virtual Accounts (AdministerSettingOrganization NameView).
    The devices manufactured as part of this order would flow into the Cisco Plug-and-Play (PnP) portal and would be associated to the vBond controller that was pushed by Cisco SD-WAN CloudOps. Once the association is successful, the data is pushed to zero-touch provisioning (ZTP).

    For on-premises deployment

    The customer or sales engineer who is helping with the customer’s deployment would need to enter the vBond profile information into the Plug-and-Play portal, so that the controller information can be passed to zProv. Steps  to set up a vBond controller and how to associate devices to it are demonstrated later in this document.

    Figure 1. PnP workflow

    clipboard_e5528dbd1f26119e70aaf1abb13149778.png

    Note: A Smart Account and a Virtual Account are non-mandatory fields during ordering. If the values are left blank, the customer would either be assigned system-generated Smart and Virtual Accounts or would be guided through a claiming experience to select the right Smart and Virtual Accounts under his organization. This claiming experience would occur after submitting an order.

    Cisco PnP terms

    Network ID

    The equivalent of the overlay ID in Viptela. Auto-generated when a profile is present in PnP. Can be edited only when no profiles exist in a Virtual Account. All devices for a given organization name in ZTP should be associated to one network ID.
       
    Organization name An attribute that vManage used to tie all the controllers together. The organization name is associated to a vBond controller in the PnP portal.
    vBond controller Represents the vBond IP or domain name. Only IPv4 is supported today.
    Base product ID (PID) Hardware product ID that is on the label.
    Ordered PID An ordered SKU that was selected in CCW. In some cases, the ordered PID and base PID can have the same value.
    Secure device ID (SUDI) A secure board ID that is used to validate anti-tampered devices.
    International Mobile station Equipment Identity (IMEI) or device IMEI IMEI information for an LTE-enabled vEdge controller. Both of the values would be the same for vEdge devices.

    On-boarding sequence flow using PnP

    For on-premises equipment

    1. Place an order in CCW
        ● Either the customer or the partner enters the end-customer’s email address (mandatory) or the customer’s Smart Account and Virtual Account     numbers (not mandatory).
        ● Serial number information with the Smart Account and Virtual Account is pushed to PnP.

    clipboard_efeb3011b52be72ee77c9ac1ac35d0cdf.png

    2. Customer on-premises controller
    ● Make note of the organization name used to bring up the setup and also the vBond controller IP address or domain name.
    ● You will be required to enter this information in PnP.

    3. Define the vBond controller in Plug and Play

    ● Add the vBond controller profile into PnP under the same Smart and Virtual Accounts used in Step 1 (for on premises).
    ● The steps to take to add a vBond controller profile are provided later in this document.
    ● Once the vBond Controller is added, manually associate the device to the controller.

    clipboard_e7bdecba6dfd457e11cdc49a8bbfd7651.png

    4. PnP data push to ZTP
    ● PnP will automatically send the data with the vBond controller information, the organization name, network ID, and associated serial numbers to ZTP.

    clipboard_ec9b3f5575ee0d2e973007f3400337f38.png

     

    5. Upload the provisioning file into vManage
    ● Download the serial number file, also known as the provisioning file on the PnP portal.
    ● Upload the file in vManage (version 18.x and above).
    ● Devices will then be available on vManage

    clipboard_e25a0688d26e7f3a36143ac169a324bd3.png

     

     

    Device management

    The Cisco PnP portal contains a list of devices that are associated to a given controller. For ease of issue
    resolution, the PnP portal provides capabilities for device management to support personnel and customers.

     

    Steps to add a replacement device to your Virtual Account


    1. Log in in to PnP with the Smart and Virtual Accounts that the user needs to add to the device. Click “Add
    Device”

    clipboard_e2ad98c0e4ce581493830151ab65df847.png

     

    2. Choose “Enter Device Info manually” and click “Next”

    clipboard_e54d866b858ac763e63d05bbfab460571.png

     

    3. Click on “Identify Device”

    clipboard_e3f9489e23763ef33e6acb6552b39f60b.png

     

    4. The “Identify Device” screen appears. Enter the device details and click “Save”, as shown in the following
    screenshot. Choose the base PID in the case where a vEdge device is an orderable PID or label on the
    hardware router called “Model Name”.

    clipboard_e7885b6e9b7915ecfb0d5339b14db4f06.png

     

     

    5. Click “Next”

    clipboard_e5c741f04d591431921e5f4831961f055.png

     

    6. Click “Submit”

    clipboard_ee9b2ca27931db052a0a0fef67a6cd8ad.png

     

    7. Click “Done”

    clipboard_e8997ec73eb2f8c112d1ba31fabf80261.png

     

    8. Devices will be provisioned automatically since the profile is already present. The status shows as
    “Provisioned” once the data is sent to ZTP.

    clipboard_e6f3583102b29d0c5fb6ed68a1a2f7cd5.png

    Associate controllers to a device


    1. Select the device under the “Devices” tab and Click “Edit Selected”

    clipboard_ed60611694da78dcbbc33f17c60189318.png

     

    2. Select the profile that the user wants to change and click “Apply”

    clipboard_e320ac5887f7cd2d615ce775b70d2bf3e.png

     

    3. The new and old profiles are shown under the “Controller” label

    clipboard_ee0bd344ababbf164f7facd6d38131384.png

     

    4. Click the “Submit” button. The device is now associated with a new profile (cloud-hosted in this case) as
    shown in the following screenshot.

    clipboard_e0b2b656861af06186a8df0d58fa484d8.png

     

    Un-configure a device (disassociate a device from the controller)

    1. Click on the device that you want to un-configure and click “Edit Selected”

    clipboard_e0ca496889b5a4248cd1e430a116db638.png

     

    2. Click “Controller Profile” and click “Apply”

    clipboard_eada55fe1d199f3988c18864798c3f60a.png

     

    3. The new and old profile will be shown

    clipboard_e7d17f10efd218565cd76eb0a6f6d6d9a.png

     

    4. Click the “Submit” button. The device will be shown with an “unconfigured” status on the “Devices” tab as there
    is no vBond controller associated with it

    clipboard_e2b685528d6f89f16620350fdd19c399c.png

     

    Moving devices from one Virtual Account to another Virtual Account

    1. Delete the device from one Virtual Account
    2. Add the device into another Virtual Account

    Delete the device from one Virtual Account

    1. On the Devices tab, select the devices that need to be deleted and click the “Delete Selected” button

    clipboard_e52b11f210998aa1f5375cc63e1e2aa3c.png

     

    2. The system prompts a message, illustrated in the following screenshot. Click “Delete Selected Devices”

    clipboard_e3fe7d35e4867ebeebbb2573da4afb8a6.png

    3. Devices will be deleted from the Virtual Account

    clipboard_e07c50b9ea90d88a3aefa0a82f43b84c3.png

    Add a device into another Virtual Account

    1. Choose another Virtual Account where you want to add a device

    clipboard_ea6fe7d349b0a5a2c8431c7bd1be078a6.png

    2. Make sure that there is a vBond profile in that account. If not, it needs to be created.

    clipboard_e6ad98bad754f0e74fc893ad026d806d6.png