// Niagara station tool
Remove nhtml and ntools from a .bog
Drop in a station database. Every component belonging to the nhtml or ntools modules is taken out, along with any link left pointing at one, so the station will open and run on a host that does not have those modules installed. You get the cleaned bog and a plain-text report of everything that was removed and everything that still refers to them.
What it does
- Reads a
.bog(zip, gzip or plain XML) or a.diststation backup. - Resolves every module prefix properly, so it finds the components whatever they are called in your file —
sbs:,sbsmi:,kvg:or anything else. - Removes those components and everything under them.
- Removes links that pointed at what was deleted, so you are not left with broken links.
- Re-binds any module prefix that a deleted component happened to declare first.
- Leaves your HTML, CSS, JavaScript and px graphics completely alone.
- Writes a report listing every removed component, the files and pages it pointed at, and anything still naming the modules.
What it deliberately does not do
It does not edit query strings. If a BQL or NEQL filter somewhere in the
station mentions ntools:SMSRecipient, that gets listed in the
report and left where it is — rewriting somebody's query is not the same
thing as deleting a component, and you should look at it yourself.
It does not touch graphics. Several ntools types are px widgets, which live
in .px files rather than in the station database. Those cannot be
fixed from the bog and will still need attention in Workbench. Feed it the
whole .dist backup instead of just the bog and the report will
tell you exactly which files to look at.
Why a station fails without these modules
A Niagara station stores each component's type as a module and type name. When the station is opened on a host where that module is not installed, Niagara cannot resolve the type. Depending on version and context you will see the component as unresolved or as a tombstone, get errors in the application director, or find that the station will not start at all. Removing the components is one way out of that. Installing the modules is the other.
Which modules
nhtml
Serves a responsive HTML5 navigation front end from a Niagara station. A single HTML5 service holds the nav structure and points at CSS/JS/nav files in the station file space.
16 types · versions 0.21–0.70
ntools
A grab bag of Niagara utilities: SMS and voice alarm recipients (Twilio-backed), alarm routing managers, history batch tools, a site checker, and a set of px widgets (gauges, maps, status icons).
27 types · versions 0.20–0.55