About returning a controller to factory defaults

At times it may be necessary to restore an controller to a known good empty state, either to recommission it with the current release build, or before recommissioning it with an earlier build. To do this, you can install a clean dist (distribution) file.

Wiping a controller clean is typically unnecessary if you are upgrading an operational controller to a later software build. Using the Commissioning Wizard should be all that is necessary. However, if you are downgrading a controller to an earlier build, you should install a clean dist file first, to avoid compatibility problems. This applies especially to JACE controllers, as binaries for the (QNX) OS are included in dist files.

Installing a clean dist wipes the entire file system and installs an appropriate version of Niagara platform daemon, resetting the unit to a near factory state. If the controller came with an appliance installed, installing a clean dist also removes the appliance. Only the following settings are preserved:

  • TCP/IP settings
  • license files
  • brand.properties
  • most secure communication (TLS) configuration

    All other data is deleted from the file system, including station bog files, Px files, modules, etc. Note that the unit’s TLS private key information is also deleted. In addition, installing a clean dist deletes all configured platform users, restoring the factory-default platform credentials and port (3011).