Leased Licenses (Eight-character keys)
A license key with eight characters signifies a Leased License. These types of licenses also require an activation token, which is a very long, unique, string of characters that must also be provided before a Gateway is licensed. Leased licenses are ideal for containerized environments (Docker, Kubernetes), as well as cloud-based deployments.
This type of license requires that the Gateway frequently check in with an activation service to periodically validate the license. Leased sessions have an expiration period of four hours; however, the Gateway will attempt to renew the lease every hour. A renewed lease will also reset the expiration period back to the default four hours. This creates a buffer, allowing a Gateway to remain activated in cases where the Gateway is unable to reach the activation service in a timely manner.
In order to reach the activation service, the Gateway must have internet access at all times.
Leased License Activation
Activating a Gateway with a leased license follows a similar flow to the standard license's online activation.
In addition, when selecting Maker Edition during installation, a leased license and activation token are required.
Adding Multiple Licenses to a Single Gateway
In order to better support our community of third-party module authors, we also allow for multiple license keys to be installed on a single Gateway. A third-party module author can issue a license key for their module directly to a customer, whereby, they can immediately do an install of the module. To learn more, check out the Third-Party Module Showcase to find and purchase modules that extend Ignition's functionality.
It is important to note that there may only be one license on it with a platform version per Gateway. The platform will look similar to the picture below. If you try and activate a second license with a platform onto a Gateway that already has a license with a platform, the new license will overwrite the previous license.
In the image below, two licenses have been applied to this Gateway, but only one is active.
Effective vs Applied Licenses
This page has two sections, which detail different information.
Applied Licenses shows all licenses that have been applied to the gateway. Entries here are typically purchased or given, and have a license key associated with them.
Effective Licenses provides a summary of modules active on the gateway. Modules are active if they're provided by an applied license. This area is the result of potentially multiple licenses across various activation mechanisms. For example, if license A provides module A, and license B provides module B, then Effective Licenses would show that both modules A and B are active on the gateway. The caveat here is that the modules will only appear if they're installed on the Gateway. In this same scenario with licenses A and B, if module B was not installed, then it will not appear under Effective Licenses.
In addition, the Effective Licenses area may have "synthetic" items that are translated to modules. For example, in the case of Edge gateways, their Applied Licenses will show plugins. These plugins will be translated to modules under the Effective License section.
It's important to know which version of a module you have installed and which version of the module you are licensed for. You could have a license for another version of a module so it's not going to work correctly until you have the correct version of the license. To verify the versions on your installed modules, go to the Modules page in the Status section of the Gateway Webpage or by clicking View Modules in the green banner.
Here you can see all the modules that are currently running with their version numbers and license status. The licenses are either in Trial, Activated, or Free mode. On this page, you can add or remove modules from your Ignition. If you are licensed for a module you are running, it will run in Activated mode. If you are not licensed for a module you are running, it will run in Trial mode until the Trial time is expired.
For more information on installing new modules, see the Installing or Upgrading a Module page.
Don't be alarmed by a 'License Incomplete' message on the green banner. Click on the View Modules link within the banner. It opens an informational message box showing modules that are installed. Some of the modules are in Trial Mode.
In cases where you may have a hardware or OS failure and you cannot unactivate a license, Ignition provides an Emergency Activation mode. In this mode, you can temporarily activate your license for 7 days giving you enough time to contact Inductive Automation Support.
How to Activate in Emergency Mode
Activating your license in emergency mode is exactly the same as activating with your normal license, you don't have to do anything different because Ignition handles it all for you. See License Activation above for details on how to activate. The Gateway will know to run in emergency activation mode and it will display a timer stating how many days, hours, and minutes you have remaining in the Emergency Activation Mode banner. Any time before it expires, you can contact Inductive Automation Support to get your license fixed.
Unactivating a License
For a given license key, a limited amount of simultaneous activations are allowed at a given time. If you want to activate Ignition on a different server, you must first unactivate it on the current server. You can unactivate the license on one Gateway, and then activate it on a different Gateway if needed. Unactivation occurs immediately over the Internet, and makes this license available for activation on another machine.
To unactivate the Gateway, do the following steps:
- From the Config section of Gateway, go to System > Licensing. The Licensing page is displayed and you can see the currently installed license key.
- Click on Unactivate License icon.
- A Licensing / Confirm Unactive window will appear asking you to confirm the unactivation. Click the Yes, Unactivate button. It may take a minute or so for the request to finish.
- The unactivation request will be sent to Inductive Automation's licensing servers, and the license will again be available for activation on another Gateway.
In the event your Gateway is unable to reach our licensing server, you will need to perform an offline unactivation.
To perform an offline unactivation, do the following steps:
- Go to your Gateway's Config section > System > Licensing. You will be able to see any licenses that are currently applied.
- Click the Unactivate button (trash can icon) under Applied Licenses.
- A confirmation window will appear, asking you to confirm the unactivation. Click the Yes, Unactivate button. It may take a minute or so for the request to finish.
- An unactivation request file, called
unactivation_message.txtwill be generated and downloaded.
- Take the
activation_message.txtfile to a machine with Internet access and go to https://links.inductiveautomation.com/activation.
- Click Choose File and select the
- You will see a visual confirmation that your
unactivation_message.txtfile has been successfully uploaded, and the license key can now be activated on a different Gateway.