License

License management provides comprehensive control over software licensing including Smart Licensing, traditional license files, and feature tier activation for Cisco network devices. It enables automatic registration with Cisco Smart Software Manager, periodic license validation, and compliance reporting while supporting various transport methods including direct internet access, HTTP proxy, and call-home mechanisms. License management ensures proper feature entitlement, tracks usage consumption, and maintains compliance with software licensing agreements across the network infrastructure.

Diagram

Classes

configuration (iosxe.devices)

Name	Type	Constraint	Mandatory	Default Value
license	Class	[license]	No

license (iosxe.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
boot_level	Choice	network-essentials, network-advantage	No
boot_level_network_advantage_addon	Choice	dna-advantage, dna-essentials	No
boot_level_network_essentials_addon	Choice	dna-essentials	No
smart_transport_type	Choice	Off, automatic, callhome, cslu, smart	No
smart_url_cslu	String		No
accept_eula	Boolean	true, false	No
udi_pid	String		No
udi_sn	String		No

Examples

Boot Level and Feature Licensing

The below CLI configuration enables Network Advantage licensing on boot, leverages callhome functionality for Smart LIcensing, and enables HSECK9 licensing on the target device.

license boot level network-advantage
license smart transport callhome

The corresponding YAML data model for this configuration is as follows:

iosxe:
  devices:
    - name: Device1
      configuration:
        license:
          boot_level: network-advantage
          boot_level_network_advantage_addon: dna-advantage
          smart_transport_type: smart
    - name: Device2
      configuration:
        license:
          boot_level: network-essentials
          boot_level_network_essentials_addon: dna-essentials
          smart_transport_type: cslu
          smart_url_cslu: https://tools.cisco.com/its/service/oddce/services/DDCEService

Accept Right-To-Use License EULA

The below CLI configuration accepts the End User License Agreement (EULA) for Right-To-Use (RTU) licensing:

license accept end user agreement

The corresponding YAML data model for this configuration is as follows:

iosxe:
  devices:
    - name: Device-Hostname
      configuration:
        license:
          accept_eula: true

Note that the license accept end user agreement CLI configuration command will not appear in the output of the show running-config after configured. This attribute is only supported on certain platforms (e.g., ISR 4331) leveraging Right-To-Use (RTU) licensing.

Set Smart Licensing Transport Data

The below CLI configuration modifies the Smart Licensing transport type and target CSLU URL on the device:

license smart transport cslu
license smart url cslu https://tools.cisco.com/its/service/oddce/services/DDCEService

The corresponding YAML data model for this configuration is as follows:

iosxe:
  devices:
    - name: Device1
      configuration:
        license:
          smart_transport_type: cslu
          smart_url_cslu: https://tools.cisco.com/its/service/oddce/services/DDCEService

License management provides comprehensive control over software licensing including Smart Licensing, traditional license files, and feature tier activation for Cisco network devices. It enables automatic registration with Cisco Smart Software Manager, periodic license validation, and compliance reporting while supporting various transport methods including direct internet access, HTTP proxy, and call-home mechanisms. License management ensures proper feature entitlement, tracks usage consumption, and maintains compliance with software licensing agreements across the network infrastructure.

Diagram

Classes

configuration (iosxe.devices)

Name	Type	Constraint	Mandatory	Default Value
license	Class	[license]	No

license (iosxe.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
boot_level	Choice	network-essentials, network-advantage	No
boot_level_network_advantage_addon	Choice	dna-advantage, dna-essentials	No
boot_level_network_essentials_addon	Choice	dna-essentials	No
smart_transport_type	Choice	Off, automatic, callhome, cslu, smart	No
smart_url_cslu	String		No
accept_agreement	Boolean	true, false	No
accept_end	Boolean	true, false	No
accept_user	Boolean	true, false	No
udi_pid	String		No
udi_sn	String		No
feature_name	String		No
feature_port_bulk	Boolean	true, false	No
feature_port_onegig	Integer	min: 1, max: 2	No
feature_port_b_6xonegig	Integer	min: 1, max: 2	No
feature_port_tengig	Integer	min: 1, max: 2	No

Examples

iosxe:
  devices:
    - name: Device1
      configuration:
        license:
          boot_level: network-advantage
          boot_level_network_advantage_addon: dna-advantage
          smart_transport_type: smart
    - name: Device2
      configuration:
        license:
          boot_level: network-essentials
          boot_level_network_essentials_addon: dna-essentials
          smart_transport_type: cslu
          smart_url_cslu: https://tools.cisco.com/its/service/oddce/services/DDCEService
    - name: Device3
      configuration:
        license:
          boot_level: network-advantage
          smart_transport_type: callhome