Smart License Management

These commands enable smart licensing support for IOx platforms and lets customers to register the device and manage licenses via CSSM.

Smart License management commands

~$ ioxclient license smart
NAME:
   ioxclient license smart - Execute Smart Licensing commands

USAGE:
   ioxclient license smart command [command options] [arguments...]

COMMANDS:
   register, r          Register device for Smart Licensing
   deregister, d        Deregister device from Smart Licensing
   renew, rn            Manually renew Smart Licensing
   help, h              Shows a list of commands or help for one command

OPTIONS:
   --help, -h                   show help
   --generate-bash-completion

Smart License Register command

Register this device with Cisco using an ID token. Using the id token the customer got from the CSSM the agent will register this product with Cisco and receive back an identity certificate. Use the below command to register the device.

~$ioxclient license smart register idtoken
NAME:
   idtoken - Use Registration Token to register device

USAGE:
   command idtoken <token> [force]

Smart License Deregister command

Unregister the device from Cisco. All Smart Licensing entitlements and certificates on the platform will be removed.

~$ ioxclient license smart deregister
Currently active profile :  mycaf
Command Name:  license-smart-deregister

Smart License Renew commands

Initiate a manual update of the license registration information with Cisco.

~$ ioxclient license smart renew
NAME:
   ioxclient license smart renew - Manually renew Smart Licensing

USAGE:
   ioxclient license smart renew command [command options] [arguments...]

COMMANDS:
   ID, id       Renew registration with Smart Licensing
   auth, a      Renew authorization of Smart Licenses in use
   help, h      Shows a list of commands or help for one command

OPTIONS:
   --help, -h                   show help
   --generate-bash-completion

Smart License show commands

~$ ioxclient show license
NAME:
   ioxclient show license - Show Smart Licensing state information

USAGE:
   ioxclient show license command [command options] [arguments...]

COMMANDS:
   status, st           Show overall Smart Licensing status
   summary, sum         Show Smart Licensing status summary
   UDI, udi             Show the Device UDI
   usage, u             Show Smart Licensing license usage
   all, a               Show all Smart Licensing information
   tech-support, ts     Show Smart Licensing tech support information
   config, conf         Show Smart Licensing configuration
   help, h              Shows a list of commands or help for one command

OPTIONS:
   --help, -h                   show help
   --generate-bash-completion

Smart License Debug level commands

Turn on debug logging in the agent using the below command.

~$ioxclient debug smart_lic
NAME:
   ioxclient debug smart_lic - Set smart licensing debug level

USAGE:
   ioxclient debug smart_lic command [command options] [arguments...]

COMMANDS:
   error, err   Enable error level logging. value can be set to on or off
   debug, dbg   Enable debug level logging. value can be set to on or off
   trace, tr    Enable trace level logging. value can be set to on or off
   all, all     Enable all logging. value can be set to on or off
   help, h      Shows a list of commands or help for one command

OPTIONS:
   --help, -h                   show help
   --generate-bash-completion

Smart License Call Home setup command

This command specifies the destination URL to which Call Home messages (including licensing requests) are sent.

~$ ioxclient call-home destination-address http
NAME:
   http - Set destination address. Cisco Smart Software Manager is the default destination

USAGE:
   command http <URL>