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, Unactivate and Update licenses from the Controller.
Before Activating a License
-
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 screenshot is identified with either a Controller or Agent label in the header so it's clear which machine you are working on.
Activate License
-
On your Agent, go to the Configure tab and select Licensing. You can see that no license is currently installed.
-
Activating a license on an Agent must be done from the Controller. Go to your Controller 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 the Activate License button and press Next. The EAM wizard will walk you through each step of the activation process.
-
The Activate License task has several scheduling options. For this example, select Execute Immediately and press Next.
-
Now, 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.
A Note About Trial Mode
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. Go to your Configure tab and select Modules. If any are still in trial mode, that means your license key either didn't include those modules or they are 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, navigate to Configure > Enterprise Administration > Agent Tasks. Click the 'Create new Gateway' link.
Select Update License and press Next. The 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 your Controller, navigate to Configure > Enterprise Administration > Agent Tasks. Click the 'Create new Gateway Task' link.
Select Unactivate License and press Next. Once again, the wizard will guide you through the unactivate license steps. Refer to steps 4 through 9.
