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
1 2 |
|
2. Go to Server Runtime
1 |
|
3. Select Your Subscription
1 |
|
4. License Overview
1 2 3 |
|
5. Issue a New License
1 2 |
|
6. Download the License
1 2 |
|
Important Notes
1 2 |
|
- 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 against your Martini Server Runtime license in Lonti Cloud Console.
- 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:1 2
> 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.
1 2 |
|
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.