LicenseStationExt (provisioningNiagara-LicenseStationExt)

This component provides the Niagara Network Job Builder and the Property Sheet that configures it. It is one of seven device extensions the system adds automatically to every station under the Supervisor’s NiagaraNetwork.

By default this component is enabled. The properties you configure on its Property Sheet update the values reported in the ProvisioningNwExt’s Licenses view. No special views exist for this extension. Adding this component to a job triggers a pop-up window for a potential brand change. To change the license brand, you enter the new brand ID.

When initiated by the Supervisor, this component gathers information about the licenses installed on each target host, accesses the online licensing server (in one message) to see if the licenses are up-to-date, and, if a host’s license is out-of-date, updates each license in the target station’s host, and in the Supervisor’s local license database. For brand updates, this component looks for a license matching the new Brand ID in the local license database and the online licensing server for each target platform Host ID in the job. If it finds a license, It deletes the existing license and copies the new license to the platform. It also copies license vendor certificates to the target platforms if needed.

Note: If the Supervisor is not configured for Internet connectivity, this component uses only its local license database to compare against licenses installed in the target host(s). If a host’s license is out-of-date, the step updates the license in the target host(s).

To access these properties, expand Config > Drivers > NiagaraNetwork > NiagaraStation, and double-click Licenses. NiagaraStation represents your station name.

Properties

Property	Value	Description
Enabled	true (default) or false	Activates (true) and deactivates (false) use of the object (network, device, point, component, table, schedule, descriptor, etc.). To prevent a provisioning job from running the Update Licenses step against this station, set this property to false.
Status	read-only	Reports the condition of the entity or process at last polling. {ok} indicates that the component is licensed and polling successfully. {down} indicates that the last check was unsuccessful, perhaps because of an incorrect property, or possibly loss of network connection. {disabled} indicates that the Enable property is set to false. {fault} indicates another problem. Refer to Fault Cause for more information.
Fault Cause	read-only	Indicates the reason why a system object (network, device, component, extension, etc.) is not working (in fault). This property is empty unless a fault exists.
Last Update	date and time	Reports the date and time that a provisioning job updated the license last. This property reports null if the license has not yet been updated this way.
License Status	Up-to-Date, Unknown, Expired	Indicates the state of the license: Up-to-Date reports that the license is the most recent available. Unknown indicates that provisioning has never updated the license in this station. License Summary provides a container slot to hold properties describing the license(s). The information held by this slot includes the unique Host ID for the platform, brand identifiers, and other vendor license information with timestamps to indicate when each license was originally generated, and its expiration date (if ever).
Certificates Summaries	text	Provides a container slot to hold properties that describe installed certificate(s), including when each certificate was originally generated, and its expiration date (if ever).

Poll action

Each licenses station provisioning extension provides its own Poll action, which when invoked immediately submits an update request to retrieve the latest license from the licensing server (or, if unavailable, from the Supervisor’s local license database). This action is equivalent to the Update command issued from the License Summary View of the ProvisioningNwExt’s Licenses slot.