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

License Management

Cisco vManage supports the Cisco Managed Subscription License Agreement (MSLA), which allows the use of smart licenses for devices that vManage manages.

For complete information about the MSLA and how to obtain it, contact your Cisco account representative.

Overview

Before you can use an MSLA with vManage, you must create a Cisco Smart Account and virtual accounts, obtain smart licenses, and associate licenses with virtual accounts. After you set up the MSLA, you can use the Cisco Smart Software Manager (CSSM) to manage your smart licenses. Your Cisco account representative can provide more information about the MSLA, CSSM, and related requirements.

After you set up the MSLA and the CSSM, you can use vManage to download licenses and assign licenses to devices. vManage reports license usage to the Cisco Billing Platform (SBP) automatically on a regular basis.

[For the requirement that license tags need to be defined in the CSSM, is there anything that a user needs to do on the vManage side or anything that should be add to this overview?]

Set up vManage for Smart Licenses

Before you can use vManage to assign smart licenses to devices, you must configure vManage with your Smart Account login credentials and enable license management. To do so, follow these steps:

  1. Select Administration ► Settings to display the Settings page.
  2. Take these actions to enter your Smart Account login credentials:
  1. Click Edit in the Smart Account Credentials row. This row displays near the bottom of the page.
  2. In the Username field, enter your Smart Account user name.
  3. In the Password field, enter your Smart Account password.
  1. Take these actions to enable license management:
  1. Click Edit in the License Management row. This row displays at the bottom of the page.
  2. Select the Enable radio button.

To disable license management, select the Disable radio button. Disabling this feature when licenses are assigned to devices removes the license assignments and deletes the licensing information from vManage. [what specific information?].

  1. Click the Save button.

License Manager Page

The License manager page provides information about smart licenses that are assigned in vManage, and lets you manage license assignments for devices.

To display the License Manager page, select Administration ► License Manager.

The following table describes the items on the License Manager page. On the Overview tab, the Select Devices button displays only if no licenses are assigned to devices. The other Overview Tab items that the table describes display only if at least one device has a license assigned.

Item Description
Overview Tab  
Select Devices button

Click to display the Device tab, from which you can assign licenses to devices.

This button displays only if no licenses are assigned to devices.

Refresh button Click to update the information on the overview tab with current data.
Device Assignment Distribution area

Includes a donut graph that indicates how many devices in your deployment have licenses assigned to them (the purple segment of the graph) and how many devices do not have licenses assigned to them (the green segment of the graph).

Hover your mouse pointer over a graph segment to see the number of devices in the corresponding category.

Top 5 Licenses area

Includes a donut graph that indicates up to the 5 most used license types (tags) in your deployment, and a list of these licenses.

Hover your mouse pointer over a graph segment to see the number of devices the corresponding license types is assigned to.

Top 5 Subscriptions area

Includes a donut graph that indicates up to the 5 most used subscription IDs in your deployment, and a list of these subscription IDs.

Hover your mouse pointer over a graph segment to see the number of devices the corresponding subscription ID is assigned to.

Licenses & Devices Overview

Includes a table that provides the following information for each license that is assigned to at least 1 device:

  • License—Name of the license, received with the license
  • Subscription—Subscription ID of the device
  • Bill To—Code that indicates the billing region for the license, received with the license
  • # of Devices—How many devices the license is assigned to
  • Last Assigned On—Date and time that the license was last assigned to a device
  • You can click any column heading in the table to toggle the information that the table displays between ascending and descending alphanumeric order by that column. By default, the table displays information in descending order of the number of devices to which each license is assigned.
Devices Tab  
Sync Licenses button Click to download your smart licenses from Cisco to vManage.
Rows Selected display Indicates how many rows you have selected in the Device table on this tab. You select a row by clicking its corresponding check box.
Assign Bill To/License button

Becomes available when you select in the Device table 1 or more devices to which no bill-to code/subscription ID and license are assigned.

Click to assign a bill-to code/subscription ID code and optionally a license to the selected devices.

For detailed information, see Assign License Components to Devices section.

Edit Bill To/License button

Becomes available when you select in the Device table 1 or more devices to which the same bill-to code/subscription ID are assigned.
`
Click to change the bill-to code/subscription ID or license that are assigned to the selected device or devices, or to add a license to devices that have only a bill-to code/subscription ID.

For detailed information, see Edit License Components for Devices.

Search field and Search Options drop-down menu

In the search field, enter one or more alphanumeric strings to display in the Device table only rows that contain or match these strings. The strings are not case sensitive.

Press the Enter key or the Spacebar after entering a string. To remove a string from this field, click the X that appears next to it.

From the Search Options drop-down menu, select whether the rows that display in the table contain or exactly match each of the search strings that you enter, and select which table column or columns the search strings apply to.

Refresh button License Manager - Device Tab - Refresh Button.JPG

Click to update the information in the Device table with current information.

Device table

Provides the following information for each device in your deployment:

  • Check box—Click to select the corresponding device to be the target of an Assign Bill To/License or Edit Bill To/License operation. You can click the check box in the title row of the table to quickly check all boxes in the table.
  • Hostname—Hostname of the device.
  • Chassis Number/ID—Chassis number and identifier of the device.
  • Device model—Model of the device.
  • System IP—IP address of the device.
  • License Status—One of the following:
  • Valid—A bill-to code/subscription ID and license are assigned to the device
  • Invalid—The license [or bill-to code/subscription ID?] that is assigned to this device is not valid (for example, it might be expired)
  • Subscription Needed—A bill-to code/subscription ID code and license have not been assigned to the device
  • License Needed—A subscription code has been assigned to the device but a license has not been assigned to it
  • [are there any other status strings that can appear?
  • Bill To—Bill-to code that is assigned to the device.
  • Subscription—Subscription ID that is assigned to the device.
  • License—Name of the license that is assigned to the device.
  • Last Updated— Date and time that the license was last assigned to the device
  • You can click any column heading in the table as needed to toggle the information in the table between ascending and descending alphanumeric order by that column.

Assign License Components to Devices

From the License Management page, you can assign a bill-to code and subscription ID in combination, and a license to devices.

The following guidelines apply to assigning these items:

  • You can assign the same bill-to code/subscription ID and license to one or more devices at the same time.
  • You can assign the same bill-to code/subscription ID to one or more devices at the same time, and then assign the same or different licenses to these devices later as described in Edit License Components for Devices.
  • A bill-to code and subscription ID are always assigned in combination.
  • A device cannot have a license without a bill-to code/subscription ID assigned to it.

To assign a bill-to code/subscription ID and license to one or more devices, follow these steps:

  1. Select Administration ► License Manager to display the License Manager page.
  2. Click the Device tab.
  3. (Optional) Click the Sync Licenses button to download to vManage current smart licenses from Cisco.
  4. In the Device table, check the check box for each device to which you want to assign the same bill-to code/subscription ID and optionally the same license.

You can use the Search Field and the Search Options drop-down menu to locate devices, as described in License Manager Page.

  1. Click the Assign Bill To/License button.

The Assign Bill To/License dialog box displays.

  1. In the Assign Bill To/License dialog box, take the following actions as needed.

In this dialog box, you can choose to assign a bill-to code/subscription ID and license at the same time, or you can choose to assign only a bill-to code/subscription ID and then assign licenses later.

You cannot assign only a license.

  1. Click the Bill To/Subscription field, and choose the desired bill-to code and subscription ID combination from the drop-down list.

Changing an entry in this field removes any entry that is in the License field

If you want to remove a bill-to code/subscription ID, select None from the drop-down list. Selecting None here automatically enters None in the License field.

  1. Click the License field, and choose the desired license from the drop-down list.

If you want to remove a license, select None from the drop-down list.

  1. Click the Save button.
  1. Click Close in the confirmation dialog box that displays.

Edit License Components for Devices

From the License Management page, you can edit (change) the bill-to code and subscription ID in combination, and license assignments for devices.

The following guidelines apply to editing these items:

  • You can edit items for a device only if the device has a bill-to code/subscription ID assigned. The device can also have a license assigned, but that assignment is not needed to be able to edit items. In this way, you can assign a license after a bill-to code/subscription ID has been assigned.
  • You can edit items for multiple devices that have different bill-to code/subscription ID assignments, license assignments, or both. When you save the edits, the vManage applies the new assignments to all devices that you selected.
  • A bill-to code and subscription ID are always edited in combination.
  • A device cannot have a license without a bill-to code/subscription ID assigned to it.

To edit a bill-to code/subscription ID and license assignment for one or more devices, follow these steps:

  1. Select Administration ► License Manager to display the License Manager page.
  2. Click the Device tab.
  3. (Optional) Click the Sync Licenses button to download to vManage current smart licenses from Cisco.
  4. In the Device table, check the check box for each device for which you want to edit the bill-to code/subscription ID assignment, license assignment, or both.

You can edit items for a device only if the device has a bill-to code/subscription ID or a bill-to code/subscription ID and license assigned to it.

You can use the Search Field and the Search Options drop-down menu to locate devices, as described in License Manager Page.

  1. Click the Edit Bill To/License button.
  1. If you see a dialog box that indicates how many devices you selected and what licenses they are assigned, click the Next button.

This dialog box appears if you select multiple devices that have different license assignments. [true?]

  1. In the Edit Bill To/License dialog box, take the following actions as needed.

In this dialog box, you can change a bill-to code/subscription ID and license at the same time, or you can change just one of these items.

  1. Click the Bill To/Subscription field, and choose the desired bill-to code and subscription ID combination from the drop-down list.

Changing an entry in this field removes any entry that is in the License field.

If you want to remove (unassign) a bill-to code/subscription ID, select None from the drop-down list in the Bill To/Subscription field. Selecting None here automatically enters None in the License field.

If you want to remove (unassign) a license, select None from the drop-down list in the license field.

  1. Click the License field, and choose the desired license from the drop-down list.

You cannot select a license if None is selected in the Bill To/Subscription field.
If you want to remove a license, select None from the drop-down list.

  1. Click the Save button.
  1. Click Close in the confirmation dialog box that displays.

Troubleshooting

Symptom: A status of “Invalid” appears in the License Status field on the Device tab of the License Management page.
Cause: After a valid license is assigned to a device, you click the Sync Licenses button to obtain current licenses from Cisco, and the license that is assigned to the device is no longer available from Cisco.
Solution: [what should a user do in this case?]

[Are there other troubleshooting items to include?]


Audit Log

The vManage audit log tracks every sync, assign, edit, and unassign operation that you perform on the License Management page. To access the audit log, select Monitor ► Audit Log.

 

 

  • Was this article helpful?