Dist file selection

When you select the Distribution File Installer, it “parses” through the dist files on your local PC, using the last source folder selected. See the figure below.
Figure 19.   Parsing dialog in Distribution File Installer
Image

By default, the first time you use the Installer, the “backup” folder under the Niagara software location (!\backups) is parsed. If that folder does not exist yet (no backups have been made), then the "cleanDist" folder (!\cleanDist) is parsed instead.

At the bottom of the view, the Image Cleaning and Image Backups buttons provide shortcuts to these two folder areas. If needed, you can also click the Choose Directory button for a Change Directory dialog, and point the Installer to that location.

When parsing completes, a table of the found dist files appears, with the appropriate dist files available for selection in the table, as shown below (using default software location).

Figure 20.   Available dist files in Distribution File Installer
Image

Dist files that are inappropriate, for example that are for a different target platform or have unmet dependencies, are dimmed—the Install button does not become active if you select such a file. For details on any dist file, double-click it for a popup, including a list of its dependencies, as shown below.

Figure 21.   Example details dialog for a dist file, showing dependencies.
Image

To be able to restore a backup dist file, your Workbench installation requires the same versions of software, including modules, to be available in its "software database." Therefore, it is recommended that you make and keep frequent backups as you upgrade a JACE.