Universal Builds
Starting from ReadonlyREST 1.44.0, our Kibana plugins are released in a unified format.
What is a universal build?
A universal build is a single Kibana plugin deliverable that is compatible with a given Kibana version.
If not activated, a universal build will behave exactly like the old "Free" edition.
Some activation keys can be used to unlock PRO and Enterprise features. If a trial activation key is used, these features availability will be limited in time.
How to install a universal build?
The same way it worked before, just download it the same way you used to, from the Downloads page and install it as usual.
How to activate PRO/Enterprise features a universal build?
Check out our new customer portal. If your email is associated to a customer contract with a valid ongoing subscription, you will be able to obtain an activation key. Otherwise, you will be able to obtain a trial activation key.
There are a few ways to pass the activation key to Kibana. Regardless of which one you use, the result will be that Kibana will save the activation key to an encrypted Elasticsearch index, so other Kibana instances will pick up the new activation key.
Via Environmental variable
This method is useful for Docker deployments. Just set the ROR_ACTIVATION_KEY
environment variable to the activation key you obtained from the customer portal.
Via our plugin license API
Once Kibana is up and running, you can send a HTTP request to Kibana.
Via ROR_ACTIVATION_KEY.txt file
The universal build is a zip archive. You can add a small text file with your activation key to this archive before installing it, so it will be picked up automatically at the first boot.
The text file should be called
ROR_ACTIVATION_KEY.txt
It should contain your secret activation key string (no spaces, no new lines)
It should be added to the root directory of the plugin zip archive
Now install the plugin file, start Kibana, and the activation key should be loaded.
Interactive activation key management
This method is useful for manual deployments.
Start Kibana in the default "Free" edition mode
Login in Kibana as an
admin
orunrestricted
kibana accessToggle the ROR Menu on the top right
Click on the "Free" text tag
Enter the activation key you obtained from the customer portal in the license management UI
Change Activation key retrieval mode via kibana.yml
In the kibana.yml configuration file, you have the option to specify the mode for retrieving activation keys. Setting this parameter effectively means that all other activation key retrieval methods will be disregarded.
Default behaviour
If there is no kibana.yml
license config provided or activationKeyRetrievalMode: "all"
defined:
Then the order of activation key validation is:
Retrieve from index
ENV variable
File
Default Activation key (which means free license) If AK is found in any of the aforementioned locations, the verification process will be halted.
From environment variable retrieval option
you can add to kibana.yml
:
From a file retrieval option
you can add to kibana.yml
:
Last updated