Manage licenses from the CLI
This topic describes how to use Splunk CLI commands to monitor and manage your licenses. It covers some of the main uses and options of the CLI licensing commands. The definitive reference to any CLI command is the command's online help.
For general information on the Splunk CLI, see "About the CLI".
For information on managing licenses through Splunk's REST API, refer to "Licenses" in the REST API Reference Manual.
CLI license commands and objects
You can use the CLI to add, edit, list, and remove licenses and license-related objects. The available commands are:
Command | Object(s) | Description |
---|---|---|
add | licenses, licenser-pools | Add a license or a pool of licenses to a license stack. This command is only available if you have an Enterprise license. |
edit | licenser-localslave, licenser-pools | Edit the attributes of a license slave or a pool of licenses. This command is only available if you have an Enterprise license. |
list | licenser-groups, licenser-localslave, licenser-messages, licenser-pools, licenser-slaves, licenser-stacks, licenses | Depending on the object specified, lists either the attributes of that object or members of that object. |
remove | licenser-pools, licenses | Remove licenses or license pools from a license stack. |
License-related objects are:
Object | Description |
---|---|
licenser-groups | The set of available license groups. |
licenser-localslave | A local license slave's configuration. |
licenser-messages | Any alerts or warnings about the state of your licenses. |
licenser-pools | The set of license pools. |
licenser-slaves | All the slaves that have contacted the license master. |
licenser-stacks | A stack of licenses. |
licenses | The set of licenses for this Splunk instance. |
The following are examples of common license-related tasks that you can perform with the CLI.
Manage licenses
To add a new license to the license stack, specify the path to the license file:
splunk add licenses $SPLUNK_HOME/etc/licenses/enterprise/enterprise.lic
To list all the licenses in a license stack:
splunk list licenses
The splunk list
command also displays the properties of each license, including the features it enables (features
), the license group and stack it belongs to (group_id, stack_id
), the indexing quote it allows (quota
), and the license key that is unique for each license (license_hash
).
If a license expires, you can remove it from the license stack. To remove a license from the license stack, specify the license's hash:
splunk remove licenses BM+S8VetLnQEb1F+5Gwx9rR4M4Y91AkIE=781882C56833F36D
Manage license pools
You can create a license pool from licenses in a license stack (if you have an Enterprise license). A license stack can be divided into multiple license pools. Multiple license slaves can share the quota of the pool.
To see all the license pools in all the license stacks:
splunk list licenser-pools
To add a license pool to the stack, you need to: name the pool, specify the stack that you want to add it to, and specify the indexing volume allocated to that pool:
splunk add licenser-pools pool01 -quota 10mb -slaves guid1,guid2 -stack_id enterprise
You can also specify a description for the pool and the slaves that are members of the pool (these are optional).
You can edit the license pool's description, indexing quota, and slaves. For example, assuming you created pool01 in the previous example:
splunk edit licenser-pools pool01 -description "Test" -quota 15mb -slaves guid3,guid4 -append_slaves true
This adds a description for the pool, "Test", changes the quota from 10mb to 15mb, and adds slaves guid3 and guid4 to the pool. The slaves with guid1 and guid2, which you added in the previous example, continue to have access to the pool.
To remove a license pool from a stack:
splunk remove licenser-pools pool01
Manage license slaves
A license slave accesses license quota from one or more license pools. The license master controls the access .
To list all the license slaves that have contacted the license master:
splunk list licenser-slaves
To list all the properties of the local license slave:
splunk list licenser-localslave
To add a license slave, edit the attributes of that local license slave node (specify the uri of the license master or 'self'):
splunk edit licenser-localslave -master_uri 'https://master:port'
Monitor license status
You can use the splunk list
command to view messages (alerts or warnings) about the state of your licenses.
splunk list licenser-messages
Swap the license master | About license violations |
This documentation applies to the following versions of Splunk® Enterprise: 7.0.0, 7.0.1, 7.0.2, 7.0.3, 7.0.4, 7.0.5, 7.0.6, 7.0.7, 7.0.8, 7.0.9, 7.0.10, 7.0.11, 7.0.13
Feedback submitted, thanks!