2018-05-21 21:35:13 +02:00
|
|
|
[[managing-licenses]]
|
2020-02-06 18:16:32 +01:00
|
|
|
== License Management
|
2018-05-21 21:35:13 +02:00
|
|
|
|
2020-07-09 22:19:52 +02:00
|
|
|
When you install the default distribution of {kib}, you receive free features
|
|
|
|
with no expiration date. For the full list of features, refer to
|
|
|
|
{subscriptions}.
|
2018-05-21 21:35:13 +02:00
|
|
|
|
2020-07-09 22:19:52 +02:00
|
|
|
If you want to try out the full set of features, you can activate a free 30-day
|
|
|
|
trial. To view the status of your license, start a trial, or install a new
|
2020-10-22 16:06:51 +02:00
|
|
|
license, open the main menu, then click *Stack Management > License Management*.
|
2018-05-21 21:35:13 +02:00
|
|
|
|
2020-01-09 18:28:08 +01:00
|
|
|
NOTE: You can start a trial only if your cluster has not already activated a
|
|
|
|
trial license for the current major product version. For example, if you have
|
2020-02-06 18:16:32 +01:00
|
|
|
already activated a trial for 6.0, you cannot start a new trial until
|
2020-07-09 22:19:52 +02:00
|
|
|
7.0. You can, however, request an extended trial at {extendtrial}.
|
2018-06-27 20:12:58 +02:00
|
|
|
|
2020-06-12 16:39:36 +02:00
|
|
|
When you activate a new license level, new features appear in *Stack Management*.
|
2018-06-27 20:12:58 +02:00
|
|
|
|
2019-05-10 20:05:19 +02:00
|
|
|
[role="screenshot"]
|
|
|
|
image::images/management-license.png[]
|
2018-05-21 21:35:13 +02:00
|
|
|
|
2020-07-09 22:19:52 +02:00
|
|
|
At the end of the trial period, some features operate in a
|
|
|
|
<<license-expiration,degraded mode>>. You can revert to Basic, extend the trial,
|
|
|
|
or purchase a subscription.
|
2018-05-21 21:35:13 +02:00
|
|
|
|
2020-02-06 18:16:32 +01:00
|
|
|
TIP: If {security-features} are enabled, unless you have a trial license,
|
|
|
|
you must configure Transport Layer Security (TLS) in {es}.
|
2020-01-17 20:41:55 +01:00
|
|
|
See {ref}/encrypting-communications.html[Encrypting communications].
|
2020-01-09 18:28:08 +01:00
|
|
|
{kib} and the {ref}/start-basic.html[start basic API] provide a list of all of
|
|
|
|
the features that will no longer be supported if you revert to a basic license.
|
2018-09-27 19:09:14 +02:00
|
|
|
|
2020-09-14 15:30:47 +02:00
|
|
|
[float]
|
|
|
|
=== Required permissions
|
|
|
|
|
|
|
|
The `manage` cluster privilege is required to access *License Management*.
|
|
|
|
|
2020-10-22 16:06:51 +02:00
|
|
|
To add the privilege, open the main menu, then click *Stack Management > Roles*.
|
2020-09-14 15:30:47 +02:00
|
|
|
|
2020-01-09 18:28:08 +01:00
|
|
|
[discrete]
|
|
|
|
[[update-license]]
|
|
|
|
=== Update your license
|
|
|
|
|
|
|
|
You can update your license at runtime without shutting down your {es} nodes.
|
|
|
|
License updates take effect immediately. The license is provided as a _JSON_
|
|
|
|
file that you install in {kib} or by using the
|
|
|
|
{ref}/update-license.html[update license API].
|
|
|
|
|
|
|
|
TIP: If you are using a basic or trial license, {security-features} are disabled
|
|
|
|
by default. In all other licenses, {security-features} are enabled by default;
|
2020-02-06 18:16:32 +01:00
|
|
|
you must secure the {stack} or disable the {security-features}.
|
2020-01-09 18:28:08 +01:00
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[license-expiration]]
|
|
|
|
=== License expiration
|
|
|
|
|
|
|
|
Your license is time based and expires at a future date. If you're using
|
|
|
|
{monitor-features} and your license will expire within 30 days, a license
|
|
|
|
expiration warning is displayed prominently. Warnings are also displayed on
|
|
|
|
startup and written to the {es} log starting 30 days from the expiration date.
|
|
|
|
These error messages tell you when the license expires and what features will be
|
|
|
|
disabled if you do not update the license.
|
|
|
|
|
|
|
|
IMPORTANT: You should update your license as soon as possible. You are
|
|
|
|
essentially flying blind when running with an expired license. Access to the
|
|
|
|
cluster health and stats APIs is critical for monitoring and managing an {es}
|
|
|
|
cluster.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-beats]]
|
|
|
|
==== Beats
|
|
|
|
|
|
|
|
* Beats will continue to poll centrally-managed configuration.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-elasticsearch]]
|
|
|
|
==== {es}
|
|
|
|
|
|
|
|
// Upgrade API is disabled
|
|
|
|
* The deprecation API is disabled.
|
|
|
|
* SQL support is disabled.
|
|
|
|
* Aggregations provided by the analytics plugin are no longer usable.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-watcher]]
|
|
|
|
==== {stack} {alert-features}
|
|
|
|
|
|
|
|
* The PUT and GET watch APIs are disabled. The DELETE watch API continues to work.
|
|
|
|
* Watches execute and write to the history.
|
|
|
|
* The actions of the watches do not execute.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-graph]]
|
|
|
|
==== {stack} {graph-features}
|
|
|
|
|
|
|
|
* Graph explore APIs are disabled.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-ml]]
|
|
|
|
==== {stack} {ml-features}
|
|
|
|
|
|
|
|
* APIs to create {anomaly-jobs}, open jobs, send data to jobs, create {dfeeds},
|
|
|
|
and start {dfeeds} are disabled.
|
|
|
|
* All started {dfeeds} are stopped.
|
|
|
|
* All open {anomaly-jobs} are closed.
|
2020-02-06 18:16:32 +01:00
|
|
|
* APIs to create and start {dfanalytics-jobs} are disabled.
|
2020-01-09 18:28:08 +01:00
|
|
|
* Existing {anomaly-job} and {dfanalytics-job} results continue to be available
|
|
|
|
by using {kib} or APIs.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-monitoring]]
|
|
|
|
==== {stack} {monitor-features}
|
|
|
|
|
|
|
|
* The agent stops collecting cluster and indices metrics.
|
|
|
|
* The agent stops automatically cleaning indices older than
|
|
|
|
`xpack.monitoring.history.duration`.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-security]]
|
|
|
|
==== {stack} {security-features}
|
|
|
|
|
|
|
|
* Cluster health, cluster stats, and indices stats operations are blocked.
|
|
|
|
* All data operations (read and write) continue to work.
|
|
|
|
|
|
|
|
Once the license expires, calls to the cluster health, cluster stats, and index
|
|
|
|
stats APIs fail with a `security_exception` and return a 403 HTTP status code.
|
|
|
|
|
|
|
|
[source,sh]
|
|
|
|
-----------------------------------------------------
|
|
|
|
{
|
|
|
|
"error": {
|
|
|
|
"root_cause": [
|
|
|
|
{
|
|
|
|
"type": "security_exception",
|
|
|
|
"reason": "current license is non-compliant for [security]",
|
|
|
|
"license.expired.feature": "security"
|
|
|
|
}
|
|
|
|
],
|
|
|
|
"type": "security_exception",
|
|
|
|
"reason": "current license is non-compliant for [security]",
|
|
|
|
"license.expired.feature": "security"
|
|
|
|
},
|
|
|
|
"status": 403
|
|
|
|
}
|
|
|
|
-----------------------------------------------------
|
|
|
|
|
|
|
|
This message enables automatic monitoring systems to easily detect the license
|
|
|
|
failure without immediately impacting other users.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-logstash]]
|
|
|
|
==== {ls} pipeline management
|
|
|
|
|
|
|
|
* Cannot create new pipelines or edit or delete existing pipelines from the UI.
|
|
|
|
* Cannot list or view existing pipelines from the UI.
|
|
|
|
* Cannot run Logstash instances which are registered to listen to existing pipelines.
|
|
|
|
//TBD: * Logstash will continue to poll centrally-managed pipelines
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-kibana]]
|
|
|
|
==== {kib}
|
|
|
|
|
|
|
|
* Users can still log into {kib}.
|
|
|
|
* {kib} works for data exploration and visualization, but some features
|
|
|
|
are disabled.
|
|
|
|
* The license management UI is available to easily upgrade your license. See
|
|
|
|
<<update-license>> and <<managing-licenses>>.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-reporting]]
|
|
|
|
==== {kib} {report-features}
|
|
|
|
|
|
|
|
* Reporting is no longer available in {kib}.
|
|
|
|
* Report generation URLs stop working.
|
|
|
|
* Existing reports are no longer accessible.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-rollups]]
|
|
|
|
==== {rollups-cap}
|
|
|
|
|
|
|
|
* {rollup-jobs-cap} cannot be created or started.
|
|
|
|
* Existing {rollup-jobs} can be stopped and deleted.
|
|
|
|
* The get rollup caps and rollup search APIs continue to function.
|
|
|
|
|
|
|
|
[discrete]
|
|
|
|
[[expiration-transforms]]
|
|
|
|
==== {transforms-cap}
|
|
|
|
|
|
|
|
* {transforms-cap} cannot be created, previewed, started, or updated.
|
|
|
|
* Existing {transforms} can be stopped and deleted.
|
|
|
|
* Existing {transform} results continue to be available.
|