iono Documentation - Licenses
The licenses section index page shows a list of all licenses within the system. Other license related options are located in the sub-menu on the license index page.
Adding
Adding a new license is done by clicking the Add link located within the sub-menu of the licenses section. This will show a page with input fields for data for the new license.
License Details
The license details determine the product license ID and the customer to which the license belongs and therefore are extremely important when creating a new license! There are numerous fields to be completed under this section:
- Product - The products that the license will be for
- Product License - The product license to use
- Invoice ID - If you would like to add the license to an existing invoice, enter the invoice ID here. Otherwise, leave the field blank to ignore it
- User - The user that the license is being created for
- Status - The status of the new license (Active, Suspended, Expired, Disabled)
- Custom Key String - If you would like to use a custom key string for the license you can do so by entering the key in the box. This is useful if you already have license keys set up and would like to override iono's own key generation with your own form of license key. When editing the license, if you wish to revert to using the iono generated key string, clear this field.
Restrictions
iono allows you to place restrictions on the new license. There are a number of ways to do this:
- Hostname(s) - The hostname(s) that the license can be used on. To use multiple hostnames you must separate them with a single comma (,)
- IP(s) - The IP addresses that the license can be used on. To use multiple IP addresses you must separate them with a single comma (,)
- Allowed Installs - The number of times the customer can install the product using this license. Leave the box blank if you would like to offer unlimited installs on this license.
- Expires - The date that the license will expire.
- The date should be in mm/dd/yyyy format
- To set the license so that it never expires, set the value as 1
- To inherit the expiry date of the parent product licenses, leave the box blank
Misc. Options
- Accessed - If ticked, the license is set to have been accessed by the customer. This is when the customer actually views the license details in the frontend and is useful to know if they have agreed to the license agreement or not (if you have set one).
- Notes - Enter any notes about this license in the text area. They cannot be read by the customer.
Editing
The edit license page shows the details currently stored in the database for the selected customer license. All the options are the same as when adding a license except there are two additional Misc. Options.
- Expiring Soon Notification Sent - If ticked, the Expiring Soon Notification e-mail has been sent to the customer to let them know that their license is expiring within the next 7 days. You can tick this box to prevent the e-mail being sent to this customer.
- Expired Notification Sent - If ticked the customer has been notified that their license has expired. As with the above option, ticking this before the notification is sent will prevent it from being sent.
You can disable notifications system wide from the settings.
Remote Log
When the license validation fails, for example if the hostname does not match, the event will be logged in the table at the bottom of the edit license screen. It includes the hostname and IP that the validation request was sent from and a message explaining the problem. This is useful for troubleshooting license problems.