Niagara Supervisor

The Supervisor is where a portfolio of buildings becomes one system. Software Pile builds Niagara Supervisor applications that aggregate JACE stations into something operators actually use: portfolio dashboards, cross-site reporting, centralized alarming, and clean integration into enterprise systems.

Supervisor Work We Deliver

  • Station aggregation – NiagaraNetwork architecture, point sharing strategy, and history imports that scale past the first dozen sites
  • Portfolio dashboards – HTML5 views by role: the energy manager, the operator on call, and the executive see different truths from the same data
  • Centralized alarming – routing, escalation, and consoles that separate what needs action now from what needs a work order
  • Enterprise integration – Supervisor as the bridge: histories to databases, alarms to CMMS/ticketing, KPIs to BI platforms, via REST, SQL, or MQTT
  • Provisioning and template discipline – so the fiftieth site onboards like the fifth

Performance at Portfolio Scale

Supervisors degrade quietly: history imports pile up, queries slow, dashboards lag. We design retention, import cadence, and query patterns for the size you will be in three years – and we run station health audits on Supervisors that have already grown past their original design.

Scoping

Tell us your site count, JACE models, and Niagara versions – plus what the Supervisor should feed (reports, dashboards, external systems). Mixed-version fleets are normal; we plan around them.

What Is a Niagara Supervisor?

A Supervisor is the server-level Niagara station that sits above the field controllers. Where a JACE runs the equipment in one building or one part of one, the Supervisor aggregates across them: consolidated graphics, estate-wide alarm handling, long-term history storage, reporting, and a single point of access for users.

It runs on server hardware or a virtual machine rather than on embedded controller hardware, which is what allows it to hold far more history and serve far more concurrent users than a JACE can.

Do You Need a Supervisor?

A single small building with one controller and a handful of users often does not. The case becomes clear when any of the following is true:

  • You have more than one controller and want one place to see everything.
  • You need history retained longer than controller storage allows — most energy and compliance reporting requires this.
  • More users need access than a JACE can comfortably serve.
  • You want alarms routed, escalated and acknowledged consistently across sites rather than per controller.
  • You need estate-level reporting that compares buildings.
  • You are integrating with business systems, analytics or a third-party platform and want one integration point rather than one per controller.

How Should a Supervisor Be Sized?

Sizing is driven by history volume and concurrency far more than by point count alone. The questions that matter: how many points are collecting history and at what interval, how long that history must be retained, how many users will be connected simultaneously, how many graphics they will have open, and what else is querying the station for reports or analytics.

Under-sized Supervisors do not usually fail outright — they get slow, histories fall behind, and reports time out, which is harder to diagnose than a clean failure. Size against the retention policy you actually intend to keep, not the one in the original specification.

Supervisor Architecture Decisions Worth Making Early

  • What lives where. Control logic belongs in the controllers so the building keeps running if the Supervisor is unavailable. Aggregation, reporting and long-term history belong in the Supervisor.
  • History strategy. What is collected locally, what is archived up, at what interval, and for how long. This is the single biggest driver of storage and of report quality later.
  • Backup and recovery. A Supervisor holds years of history that cannot be regenerated. Confirm the backup actually restores rather than assuming it does.
  • Redundancy. Whether the estate can tolerate the Supervisor being down for a day, and what that implies for hosting.
  • Access and network position. Where it sits relative to the business network, and who reaches it how — a question that is also a security question.

Supervisor Performance Problems

The usual causes are history collection configured more aggressively than anyone needs, expensive BQL queries running on refreshing views, graphics subscribing to far more than they display, and retention policies that were never enforced so the database has grown without limit. All are fixable, and all are cheaper to design correctly than to remediate on a live system.

Related services: graphics, dashboards and reporting · BAS integration services.

How Stations Connect: Ports, Trust and Device Extensions

A NiagaraNetwork connection is not one port. Fox, the station to station protocol, defaults to 1911 in the clear and 4911 for TLS. The platform connection used for backups, software installation and station transfer is separate again, on 3011 and 5011, and it authenticates against platform credentials rather than station users. Web access sits on 80 and 443. Firewall rules written for the web port alone produce a station an engineer can browse to and the Supervisor cannot add. The diagnostic is that a browser login succeeds while the NiagaraNetwork device stays down reporting a connection failure rather than an authentication failure.

Where TLS is in use, the Supervisor validates each subordinate station's certificate against its trust store before the Fox session opens. A station with a self signed certificate that was never imported shows as down with a handshake or certificate error, which is a different repair from a wrong password even though both leave the device in the same state on screen. Certificates issued to a host name also fail validation when the NiagaraNetwork address is an IP that is not in the subject alternative name, so the address you type into the device is part of the certificate design. One internal CA whose root sits in every Supervisor and Workbench trust store scales across a fleet; per station certificates approved by hand do not, and retrofitting TLS onto a live estate means revisiting every station's certificate, address and trust store entry while the network is running.

Each subordinate station appears under the NiagaraNetwork as a station device, and what actually crosses the link is decided by which device extensions are enabled beneath it and what is configured under each one.

  • Points. Proxy points resolve values over Fox only while something subscribes them. A graphic nobody has open costs nothing; the same graphic left up on a wallboard subscribes continuously, all day.
  • Histories. Import descriptors pull records the subordinate has already written to its own history table, each on its own execution schedule. Collection interval is a controller setting and import cadence is a Supervisor setting, and the two are independent of one another.
  • Alarms. Routing is by alarm class. Records queue at the source when the link is down and deliver on reconnect, within the queue limits set on the alarm class.
  • Schedules. Master schedules export downward on their own cycle. An edit made locally at the controller is overwritten at the next export, which is the intended behavior and the most common surprise on a site where operators are used to editing at the panel.
  • Users. User synchronization pushes accounts and roles from the Supervisor down, so credentials are administered in one place. Stations still keep local accounts, which is what gets you in when the Supervisor cannot be reached.

Version and License Constraints That Decide the Order of Work

A Supervisor connects down to stations at its own Niagara version or older, never up to newer ones. That makes the Supervisor the first host in any upgrade program and fixes the order of everything that follows. Workbench obeys the same direction: it has to be at or above the version of the platform and station it opens, so the engineering workstation moves before the field does.

The AX to N4 boundary is the harder version question, because it is a migration rather than an upgrade. Station databases do not move across it by restore; they are converted with the migration tooling, which rewrites the station and leaves behind any module that has no N4 build. Third party drivers are where this bites, since the conversion can only carry forward what the vendor has actually released for N4.

Licensing constrains the same work from a different direction. A license is issued against the host ID the installed platform reports and against a brand, so it cannot be generated before the host exists and does not follow the station to different hardware without being reissued. The license also carries a software maintenance expiration date, which does not stop a running station but does govern which builds the host will accept: modules released after that date will not run under that license, so an upgrade plan needs the maintenance status checked before the version is chosen. Drivers are licensed as features, so a Supervisor that has to speak BACnet or Modbus directly, rather than only through its subordinate stations, needs those features on its own license.

Histories: Import Cadence, Capacity and What an Outage Costs

Imported histories are copies, not views. They land on the Supervisor under the source station's name and are appended to by descriptors that poll; nothing streams. That is why a history can look healthy on the controller and be days stale on the Supervisor with no error anywhere in between.

The number that governs load is descriptors multiplied by records per execution, not point count. The useful diagnostic for an import that is falling behind is the gap between the newest imported record and now, compared across stations: a gap that stays constant is a cadence choice, a gap that grows a little every day is an import losing to the collection rate, and a gap that has stopped advancing altogether is almost always the link or the credentials rather than throughput.

Capacity is the quieter problem. Every history has a record capacity and a policy for what happens when it fills, and an imported history inherits both from whatever template created it. Templates written for a controller's local buffer are sized in a few thousand records, which is correct on the controller and wrong on the Supervisor, where the same setting discards the oldest data as new records arrive with no alarm and no visible gap in the chart. Give the Supervisor copy an explicit capacity that covers the full period the estate is required to hold, rather than letting it inherit a controller sized buffer, and enforce that number as a deliberate limit so the database is neither silently truncated nor left to grow without a ceiling.

Backfill after an outage comes out of the controller's local buffer, which means the outage you can survive without data loss equals the controller's local capacity for that history at its collection interval. Five thousand records at a fifteen minute interval is about fifty two days of cover; the same five thousand records at a one minute interval is about three and a half days. Changing an interval to get better resolution silently shortens the outage you can absorb, and that is the trade to make consciously rather than discover after a WAN failure.

Telling One Kind of Slowness From Another

Slow describes at least four unrelated conditions on a Supervisor, and the remedy for one does nothing for the others. The station's own instrumentation separates them: engine cycle time and queue depth show whether the execution loop is the bottleneck, the application director output shows module and database errors, and the host's disk and memory counters show whether the trouble is below the station entirely.

Work from the symptom, because each one points at a different layer.

  • Everything is slow, including local logic and alarm delivery. Check engine cycle time against the configured cycle. When execution is overrunning its cycle, the station is oversubscribed at the engine, and query tuning changes nothing.
  • One view is slow while the rest are fine. The answer is in what that view resolves. A binding written against a folder or a broad ord subscribes everything beneath it, so the subscribed count for a single page can be an order of magnitude above the number of values on screen. Compare the subscription count on the slow view against a fast one before touching the host.
  • Reports or exports time out while the interface stays responsive. The cost is in the query. A wide time range against a history table scans it every run, and a view that refreshes re runs the query each refresh; the same report against periodic rollups does not.
  • Histories are behind and nothing else is. This is cadence, link latency or a stopped descriptor, not host capacity. Confirm the records exist on the source station first, because a controller that stopped collecting looks identical from the Supervisor.
  • The station pauses at intervals instead of being uniformly slow. Look below the station. A history volume close to full, host backups running against the same disk, and virtual machine snapshots all produce periodic stalls that no station level tuning will remove.

What the Supervisor Is Not

It is a station, which means it can run control logic exactly as a controller can. That is a trap rather than a feature. Logic written on the Supervisor stops when the host stops, and more often when the link between the Supervisor and a site drops while both ends are perfectly healthy, which is the failure that leaves a building running on nothing.

It is not a network design, either. Proxy points, graphics and imports all cross whatever WAN sits between the server and the field, and latency there rarely announces itself as an error. It shows up as views that populate a value at a time and reports that take minutes longer than they did in the lab. It is also not an analytics product: Niagara's analytics capability is separate licensed software, and a Supervisor gives you the data it would run on rather than the rules themselves.

There are cases where the smaller answer is the right one. Where no one needs a single place to see everything and there is no cross building comparison to make, the controllers' own web interfaces reached over a VPN cover the day to day work. For a single building with no cross site comparison in scope, archiving histories out to a database or a metering service is a way to hold long term data, though what that buys is storage alone, without the estate level views, alarm routing and single point of access a Supervisor exists to provide.

Frequently Asked Questions

What has to exist before a Supervisor can be installed?

A host, a license issued for that host, and disk sized for the history you intend to keep. A Windows server, physical or virtual and dedicated to the station rather than shared with unrelated applications, is the common case; supported Linux hosts exist and the list is version specific, so it is worth confirming against the release being deployed. The license is generated against the host ID that the installed platform reports and against a brand, which means it cannot be issued before the host exists and does not move to different hardware without being reissued. Java is not a separate prerequisite: Niagara 4 ships and uses its own runtime, and installing a system JDK on the server changes nothing about what the station runs.

Is a Supervisor different software from what runs on a JACE?

It is the same station software with a different license. The license is what unlocks the capacities and the features a controller license does not carry, including provisioning, which is the mechanism one station uses to push software, licenses and configuration jobs to many others. Everything an engineer already knows about stations, components, ords and Workbench applies without change.

Can the Supervisor run an older Niagara version than the controllers?

No. A controller upgraded ahead of the Supervisor drops off the NiagaraNetwork and stays off, so point values, alarms and history imports for that site stop until the Supervisor is brought up to at least that version. Recovery is either completing the Supervisor upgrade or restoring the controller from its pre upgrade backup, which is the reason to take that backup before the first controller is touched rather than after.

What happens while the Supervisor is offline?

The aggregate layer is what goes away: portfolio graphics, cross site reporting, and any downstream feed the Supervisor drives, such as database exports, ticket creation in a CMMS, or a BI refresh. Anyone whose account exists only on the Supervisor has no access for the duration, which is why local station accounts on the controllers still matter. Scheduled exports and reports that were due during the outage are missed rather than deferred, so any window that spans it has to be run again by hand.

What does connecting the Supervisor to a database or BI tool involve?

Three decisions: transport, schema and direction. For SQL, the relational database driver connects to the target database and writes histories into tables it creates and maintains, which means the database owner has to accept a schema they did not design and the table growth that comes with it. For pull style integration, obix and the station's HTTP interfaces let an external system query points and histories without a Niagara client, while MQTT publishes values outward to a broker on a topic map you define. Direction decides who notices a break: a push the Supervisor performs fails on the Supervisor side, a pull the external system performs fails on theirs, and those are usually two different teams.

Can the Supervisor back up the controllers as well as itself?

Yes. Using platform connections to each subordinate station, a Supervisor can run backup jobs across the fleet on a schedule and hold the resulting files centrally, and the same provisioning mechanism distributes software, licenses and configuration to many stations in one pass. It needs platform credentials for every host, not just station credentials, and on most estates those are separate accounts that have to be collected before the first job runs. What a backup captures is the station database and its configuration, so a restore target has to be running a matching Niagara version and hold a valid license for its own host ID before the database goes back on. Replacing failed controller hardware is therefore a platform job first and a restore second.

What do we have to decide, as opposed to just supply?

Two things that are expensive to change later. The first is a naming convention for stations, points and histories, because those names become the identifiers used by graphics, reports and any external system, and renaming after the fact breaks every binding built on them. The second is who receives each alarm escalation and after how long. Alarm classes route only to the recipients and time steps you define, and everyone receiving everything is the default that teaches people to ignore the console.

Recorded Demonstrations

Recorded examples of Supervisor wiresheets and dashboards generated by the bot.