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 15.   Station Proxy Properties
Image

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.

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

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.
Station Status read-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 Enabled read-only If true, the station you can restart the station without a reboot of its host platform (such as with Win32-based platforms).
Is Reboot Enabled read-only If true, the host’s platform daemon is capable of (and allows) rebooting of the host.
Is Auto Start read-only If true, the station restarts automatically after the host reboots.
Is Auto Restart read-only If 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 Messages read-only If false (unlikely), thread dumps, station saves, and graceful shutdown are not possible using the platform daemon.
Log Buffer Size read-only Configures the size (in bytes) of the buffer used by the platform daemon to hold the console output.
Log Buffer File Size read-only The maximum size of the console.txt file (in bytes) that the platform daemon saves console output to when the station stops.
Num Cpus read-only The number of CPUs on the host running the station.
Current Cpu Usage read-only The percentage of time the CPU(s) have been in use in the last second.
Overall Cpu Usage read-only The percentage of time the CPU(s) have been in use since the platform daemon started.
Total Physical Memory read-only The total KB of physical RAM on the station’s host.
Free Physical Memory read-only The KB of available physical RAM on the station’s host.
File System Attributes read-only Free space statistics for each file system on station’s host.

Actions

Figure 16.   Action menu for StationProxy extension
Image

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

Action Description
Poll Causes Supervisor to poll the host’s platform daemon for current data.
Dump Threads Supervisor requests that the station send a thread dump to its console output.
Save Station Supervisor 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 Station Supervisor requests that the station shuts down gracefully.
Start Station Supervisor requests the platform daemon to start the station. This action is applicable only if current station status is idle.
Kill Station Supervisor requests for the station to terminate immediately, without graceful shutdown.
Restart Station Depending 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 Host Depending 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.