Agent Task - Licensing
Three of the many tasks that the Enterprise Administration Module (EAM) allows you to perform are License Activations, License Updates, and License Unactivations. This section demonstrates how to activate, update, and unactivate a license from the Controller.
- This section assumes you already have your Controller and Agent created.
- Make sure you know your License Key serial number.
- Refer to Agent Tasks for some more useful tips with this section.
For clarity, each Gateway webpage is identified with either a Controller or Agent label in the header (top left) so it's clear which machine you are working on.
Activate License
On your Agent, go to the Gateway webpage and select Configure > Licensing. You can see that no license is currently installed.
Activating a license on an Agent must be done from the Controller. On your Controller, go to the Gateway webpage and select Configure > Enterprise Administration > Agent Tasks. Click on the 'Create new Gateway Task' link.
Activating a License key is one of several tasks you can perform under Gateway Tasks. Click Activate License, and press Next. The EAM wizard will walk you through each step of the license activation process.
The Activate License task has several scheduling options. For this example, select Execute Immediately, and press Next.
Select the Agent you want to activate the license on, and press Next. In this example, Agent133 was selected.
Enter your license key. You can enter it one of two ways: type it in the License Key field if you know it, or press Auto Assign the License and the license key will auto populate. Press Next.
The Activate License page will refresh so you can validate your licensing information. Press Finish.
The screen will refresh to the Gateway Tasks window. A message will be displayed stating that the license was activated successfully.
Now, go to the Agent to validate that the Agent license was activated. You may see an Access Denied message. This is because the page was automatically updated. Don't panic! Click on the 'Return to home page' link to refresh the Ignition Home page on your Agent.
Click on Configure > Licensing and verify your License Key on the Agent. This page shows all the modules on your license as well as the versions they are licensed for.
If you are running Ignition in Trial Mode on your Agent, there is a chance that the trial timer expired, and the license activation will fail. If this happens, reset the trial timer and resume the activation for the Agent. You can check the status of the installed modules by going to Configure > Modules. Modules you are licensed for will not expire, only the modules that are being used in Trial Mode.
It's a good idea to check to see if all your modules are activated. You can check the status of your modules by going to the Gateway webpage and selecting either Configure > Modules, or Status > Modules. If any modules are still in trial mode, that means your license key didn't include those modules, or there is a newer version than your license allows.
Update a License
In the event you need to reload or update a license on your Agent, go to the Controller, and navigate to Configure > Enterprise Administration > Agent Tasks. Click the 'Create new Gateway' link.
Select Update License, and press Next. The EAM Wizard will guide you through the license update steps. Refer to steps 4 through 10.
Unactivate a License
If you need to unactivate a license, go to the Controller, and navigate to Configure > Enterprise Administration > Agent Tasks. Click the 'Create new Gateway Task' link.
Select Unactivate License, and press Next. Once again, the EAM Wizard will guide you through the unactivate license steps. Refer to steps 4 through 9.
