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).

Figure 9. License Station Ext properties

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.