Skip to content

Home

Introduction

Development

IDEs

Services

API Explorer

Releases

Release notes

Martini Runtime

Martini Desktop

Martini Online

Feature requests

Bug reports

Installing your license

After installation and deployment, setting Martini's license is the next step. Martini won't work without a license; in fact, as soon as you get it up and running, it will ask you to provide your license key if you have not done it yet.

These are the three different ways to install a license:

License installation for TORO Cloud

The procedures described in this document are not applicable to organizations running on Martini Online. License installation is automatic for TORO Cloud subscribers. To learn how to subscribe to TORO Cloud, visit this section instead.

Via Martini Runtime Admin UI

Only for Martini Runtime Edition subscribers

The Martini Runtime Admin user interface is only available on the Martini Runtime Edition of Martini (non-headless). If you're using a different edition or the headless version of the Martini Runtime Edition, refer to other methods of license installation described in this document.

Access Martini Runtime's Admin UI via your browser. By default, you should be taken to the login page but since your license is not present yet, you won't be able to login. Instead, Martini will inform you that you need to install your license first. You will be redirected to a new page with two options: the first one is for automatically generating and installing a license, and the other one allows you to manually enter a license key (which you will have to generate using the the TORO Marketplace).

License not installed warning

To automatically generate and install your license key:

Installing a license key

  1. Choose the Automatic license installation option.
  2. Click Continue. You will be redirected to TORO Marketplace's register product key page.
  3. Login to your account. You may create one if you don't have a TORO Marketplace account yet.
  4. Choose your organization and license type.

    Must be a member of the organization

    Ensure you are a member of the organization you want to select because if you're not, the organization won't appear. To be a member of an organization, you must be invited; this can be done via the TORO Marketplace.

    There will be two options for the license type. Select Free license if you would like to use Martini on trial. Otherwise, select Use available subscriptions and choose from your account's paid subscriptions.

  5. Once done, click the Generate License button. Doing so will redirect you to the Martini Runtime Admin login page.

To manually generate and inject your license key:

Installing a license key

  1. Choose the Manual license installation option. This will show the product key installed on your machine. Take note of the provided product key.
  2. Follow the steps here in order to generate your license key.
  3. Copy your license key to the clipboard. You may obtain a copy of your generated license by checking your email (an email is sent when a license is generated).
  4. Go back to the license form and in the text area, paste your license key.
  5. Click Save.

Congratulations! Your license is now installed which means you can now login and use Martini.

Via CLI tool

To install a license via the CLI tool, we will be using the following commands:

Command Description
export-license Exports the currently installed license to a file.
import-license Imports a license from a provided file.
install-license Installs a license.
license Prints the currently installed license.
product-key Prints the product key.
sync-license Syncs the currently installed license on this machine.

CLI tool and license maintenance

The CLI tool only allows maintaining licenses on local machines. This means you can't use the CLI tool to connect to a remote instance to perform license maintenance. If you want to maintain a license on a remote machine, you must either use the Martini Runtime Admin interface, or use the CLI tool on the machine itself.

  1. Get a copy of your license key from the Marketplace using the steps described here. You'll be able to obtain a copy of your product key using the product-key command:

    1
    2
    > product-key
    XXXX-XXXX-XXXX-XXXX
    
  2. Start the CLI tool and enter the install-license command, passing the license key generated earlier.

    1
    2
    > install-license --license "<your license key here>"
    License installed.
    

Congratulations! Your license is now installed which means you can now login and use Martini.

Via Martini Desktop

When starting the instance, Martini will detect if you have a license installed or not. If no license is found, it will show the license installation wizard.

To install your license using the wizard you can follow these steps:

  1. Provide your account's username and password. If you don't have an account yet, click on the 'Get one' link which will open a browser and redirect you to https://my.torocloud.com/signup where you can sign up.

    Input TORO account credentials

  2. Click Next to fetch the available subscriptions for your account.

  3. Select the subscription to be used. You can manage your subscriptions by clicking the Manage subscriptions link, which will open a browser and redirect you to https://my.torocloud.com/organisation/application.

    Selecting a subscription

  4. Click Finish to install the license on your machine depending on the selected subscription.

Once the license installation has completed successfully, a dialog will appear with a successful installation message and will ask if you would like to start your Martini instance.

You can check the installed license details by going to the application menu and select License > License Details.