Installing your license
After installation and deployment, installing 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 so 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, please visit this section instead.
Via Martini Runtime Admin UI
Access Martini Runtime's Admin UI via your browser (this is usually
http://<martini-host>:8080). By default, you
will be taken to the login page but since a license is not present yet, you won't be able to login. Instead,
Martini will inform you that you need to install a 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 allows you to
manually enter a license key (which you will have to generate using the the TORO Marketplace).
To automatically generate and install your license key:
- Choose the "Automatic license installation" option.
- Click Continue. You will be redirected to TORO Marketplace's register product key page.
- Login to your account. You may create one if you don't have a TORO Marketplace account yet.
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" to run Martini on your desktop — free of charge, forever. Select "Use Available Subscriptions" instead to choose from your account's paid subscriptions.
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:
- Choose the "Manual license installation" option. This will show the product key installed on your machine. Take note of the provided product key.
- Follow the steps here in order to generate your license key.
- 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).
- Go back to the license form and in the text area, paste your license key.
- Click Save.
Via CLI tool
To maintain a license via the CLI tool, you can use the following commands:
|Exports the currently installed license to a file.
|Imports a license from a provided file.
|Installs a license.
|Prints the currently installed license.
|Prints the product key.
|Syncs the currently installed license on the 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.
> product-key XXXX-XXXX-XXXX-XXXX
install-licensecommand, passing the license key generated earlier as an argument.
> install-license --license "<your license key here>" License installed.
Once the license installed you will be able to login and use Martini.
Via Martini Desktop
Martini Desktop will check if you have a license installed or not on startup1. If no license is found, the license installation wizard will appear.
To install your license using the wizard, follow these steps:
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.
Click Finish to generate and install a license on your machine.
- If your account belongs to two or more organizations, you will be asked to select an organization. Choose the organization you want to use for your license.
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 also check the installed license details by selecting License > License Details in the Martini Desktop toolbar.