StationProxy (provisioningNiagara-StationProxy)

This component provides platform administration functions like those available when you open a direct platform connection in Workbench, using the Station Director and Platform Administration views. It also provides a number of actions for station control functions.

This component’s default view is the Provisioning Station Director. The StationProxy component provides other special views, including the default view (Provisioning Station Director) as well as a Station Job List.

Figure 1. Station Proxy Properties


To access these properties, expand Config > Drivers > NiagaraNetwork > NiagaraStation, and right -click the StationProxy > Views > AX Property Sheet. NiagaraStation represents your station name.

By default, this component is enabled to allow polling from the ProvisioningNwExt for values of the extension’s properties.

PropertyValueDescription
Enabledtrue (default) or false
Activates (true) and deactivates (false) use of the object (network, device, point, component, table, schedule, descriptor, etc.).

To prevent polling by the ProvisioningNwExt, set this property to false. To use the special views on the Station Proxy extension, namely the Provisioning Station Director and Station Job List, Enabled must be true.

Statusread-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 Causeread-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.
Station Statusread-only
Reflects one of the following values:
  • Idle — Station is not currently running, and can be started without a reboot.

  • Starting — Station process is running, but has not completed its startup sequence.

  • Running — Station is running.

  • Stopping — Station is in process of shutting down, but its process is still alive.

  • Halted — Station is not currently running, and the host must be rebooted before it can start.

  • UnknownStationProxy status is disabled or fault. As a result, station status is unknown. Status is also unknown if the station is unreachable, or if a poll has not happened yet.

Poll Frequency Corresponds to the Poll Scheduler in the ProvisioningNwExt, as part of its monitor ping mechanism (a ping of the platform daemon in the host running each station).
Is Restart Enabledread-onlyIf true, the station you can restart the station without a reboot of its host platform (such as with Win32-based platforms).
Is Reboot Enabledread-only If true, the host’s platform daemon is capable of (and allows) rebooting of the host.
Is Auto Startread-onlyIf true, the station restarts automatically after the host reboots.
Is Auto Restartread-onlyIf a station terminates with a failure exit code and this property is true, the host restarts (or reboots) if Is Restart Enabled =false).
Is Accepting Messagesread-onlyIf false (unlikely), thread dumps, station saves, and graceful shutdown are not possible using the platform daemon.
Log Buffer Sizeread-onlyConfigures the size (in bytes) of the buffer used by the platform daemon to hold the console output.
Log Buffer File Sizeread-onlyThe maximum size of the console.txt file (in bytes) that the platform daemon saves console output to when the station stops.
Num Cpusread-onlyThe number of CPUs on the host running the station.
Current Cpu Usageread-onlyThe percentage of time the CPU(s) have been in use in the last second.
Overall Cpu Usageread-onlyThe percentage of time the CPU(s) have been in use since the platform daemon started.
Total Physical Memoryread-onlyThe total KB of physical RAM on the station’s host.
Free Physical Memoryread-onlyThe KB of available physical RAM on the station’s host.
File System Attributesread-onlyFree space statistics for each file system on station’s host.

Actions

Figure 2. Action menu for StationProxy extension


Many of these actions are also available in the Provisioning Station Director view, as well as in views using a direct platform connection. When invoked, each action performs as follows

ActionDescription
PollCauses Supervisor to poll the host’s platform daemon for current data.
Dump ThreadsSupervisor requests that the station send a thread dump to its console output.
Save StationSupervisor requests that the station save its current state to its own (local) config.bog file. requests that the station save its current state to its own (local) config.bog file.
Stop StationSupervisor requests that the station shuts down gracefully.
Start StationSupervisor requests the platform daemon to start the station. This action is applicable only if current station status is idle.
Kill StationSupervisor requests for the station to terminate immediately, without graceful shutdown.
Restart StationDepending on Is Restart Enabled value, causes one of the following:
  • If Is Restart Enabled is false the station’s host is rebooted.

  • If Is Restart Enabled is true the station is stopped gracefully, then restarted again.

Reboot HostDepending on Is Reboot Enabled value, causes one of the following:
  • If Is Reboot Enabled is false nothing happens.

  • If Is Reboot Enabled is true, the Supervisor requests for the platform daemon to shut down gracefully, then reboot the host.