License management

Install a license

The current system leverages an “offline” process, meaning that you need to activate a license and add it to the appliance. For this, a 3-step process is required, it is described in this section.

Get the license request file

The License Request File (LRF) is used on the Anapaya portal to generate a license. The LRF can be retrieved either via the Anapaya CONSOLE, or via the appliance CLI as described below.

CONSOLE

1. Click on Appliances in the left menu.
2. Select the appliance, for which you want a license request file.
3. Click on the Software button
4. Click on the Get License Request button.

CLI

appliance-cli get software/licenses/request > license_request.json

Associate the LRF with the subscription in the Anapaya portal

info

In case you purchased the license through a reseller, please contact them for assistance with this step.

To associate the LRF with the corresponding subscription in the Anapaya portal, follow the steps below:

note

This step requires that a subscription has been ordered beforehand in the Anapaya portal.

1. Connect to the Anapaya portal with a user granted with the Activate licenses permission.

2. Go to the Quotation/Ordering module and select the License Activation menu.

3. Select the relevant subscription from the list and click on the pencil to take an action.

   note

   If the license was already manually activated in the past (meaning the validity period of the license has already started), make sure to toggle “Show activated licenses” to see these licenses in the list.

4. Upload the LRF file by click the Upload LRF button and check the parameters

5. Submit the LRF by clicking Activate and generate license.

6. Retrieve the signed license and store it for the next steps, by clicking the Copy license button.

Upload the signed license

Use the Anapaya CONSOLE or the appliance CLI to upload the signed license to the appliance.

CONSOLE

1. Click on Appliances in the left menu.
2. Select the appliance, for which you want to add a license.
3. Click on the Software button
4. Click on the Add License button.

CLI

Replace <license> in the command below with the signed license you copied in the previous step and execute it on the appliance:

appliance-cli post software/licenses 'license: $license'

Check the license status

To check the status of the license on the appliance, either use the Anapaya CONSOLE or the appliance CLI as described below.

CONSOLE

1. Click on Appliances in the left menu.
2. Select the appliance, for which you want to check the license status.
3. Click on the Software button
4. The license status is shown in the Installed License field.