Generating a License for Martini Server Runtime

Obtaining a license for Martini Server Runtime is a crucial step in setting up your server environment. This process ensures that your server runtime is compliant with the licensing terms and can access the full range of features offered by Martini. Follow these steps to generate and download your license.

Steps to Generate a License

1. Access License Management

Log in to your account at my.lonti.com.
Navigate to the Martini page from the main menu.

2. Go to Server Runtime

In the License Management section, select Server Runtime.

3. Select Your Subscription

Choose the relevant subscription under which you wish to generate the license.

4. License Overview

Under the License Overview tab, you'll find a summary of your license entitlements. This includes:
The total number of vCPUs you are licensed for.
Your current usage of vCPUs.

5. Issue a New License

Use the Issue License link to create a new license for your Martini Server Runtime subscription.
Follow the prompts to specify the required details for your license.

6. Download the License

After issuing the license, use the Download License link to download the license file.
This license file will be required during the installation process of Martini Server Runtime.

Important Notes

License Compliance: Ensure that the license issued matches your operational needs and complies with the licensing terms.
vCPU Allocation: Be mindful of the number of vCPUs allocated in your license, as this should align with your server setup.
Backup License File: Store a backup of the license file in a secure location for future reference or in case of system recovery.

Installing a License for Martini Server Runtime

After installing and deploying Martini Server Runtime, the next crucial step is installing your license. Martini Server Runtime requires a valid license to function, and you will be prompted to provide your license key upon initial startup if it hasn't been installed yet.

Methods for Installing a License

There are two primary methods for installing a Martini Server Runtime license:

Via Martini Runtime Admin UI
Via CLI Tool

Via Martini Runtime Admin UI

Steps to Install via Admin UI

Access Martini Runtime Admin UI: Open your browser and navigate to http://<martini-host>:8080. Without a license installed, Martini will redirect you to the license installation page.
Automatic License Installation:
Choose "Automatic license installation" and click Continue.
You will be redirected to the TORO Marketplace's register product key page where you need to log in.
Select your organization and license type.
Click "Generate License" which will redirect you back to the Martini Runtime Admin login page.
Manual License Installation:
Choose "Manual license installation".
Note the product key shown on your machine.
Generate your license key following [these steps][license-generating].
Paste the generated license key in the provided text area.
Click Save to complete the installation.

Via CLI Tool

CLI Commands for License Management

Command	Description
`export-license`	Exports the current license to a file.
`import-license`	Imports a license from a specified file.
`install-license`	Installs a license using a provided key.
`license`	Displays the currently installed license.
`product-key`	Shows the product key.
`sync-license`	Synchronizes the installed license with the server.

Steps to Install via CLI

Generate License Key: Obtain your license then the product-key command to retrieve your product key.
1 2
> product-key XXXX-XXXX-XXXX-XXXX
Install the License: Use the install-license command with your license key as an argument.
1 2
> install-license --license "<your license key here>" License installed.

Note on CLI Tool Usage

The CLI tool is intended for managing licenses on local machines. It cannot connect to remote instances for license management. For remote instances, use the Martini Runtime Admin interface or operate the CLI tool directly on the server.

Updating a License for Martini Server Runtime

Updating your license for Martini Server Runtime is a straightforward process that can be completed either via the Martini Runtime Admin UI or the CLI tool. This guide will walk you through both methods.

Via Martini Runtime Admin UI

Steps to Update License via Admin UI

Access the Admin UI: Open your browser and navigate to http://<martini-host>:8080.
Navigate to License Settings: In the Configuration menu, select License. This will take you to the License page.
Update License: On the License page, you have two options:
- Sync License: Sync your license with the TORO Marketplace.
- Manual Update: Manually enter your new license key and click Save to install it.

Via CLI Tool

CLI Commands for License Update

Installing New License: Use the install-license command to update the license key:

> install-license --license "<your new license key>"
License installed.

Syncing License: To sync your license with the TORO Marketplace, use the sync-license command:
1
> sync-license

Warning: Excessive License Syncing

Be cautious of syncing your license too frequently. License sync is limited to once every 10 minutes. Exceeding this limit will result in an error.

> sync-license
Failed to sync license (Too many license sync request. Try again in 8 minute(s) and 52 second(s). (429))

Upgrading from Free to Commercial License

To upgrade your license from the free edition to a commercial one:

Purchase a New Subscription: Start by purchasing a new subscription.
Access Previous Subscription: Navigate to your previous subscription.
Initiate Upgrade: Click the options button on your previous license and select Upgrade to Commercial License.
Select New Subscription: Choose your newly purchased subscription and click Proceed.

Your previous product key will be under your new subscription. Update your license using the steps mentioned above.