R2 Installation Manager

The third tab in the R2 Platform Tool view is the R2 Installation Manager.

Figure 22. R2 Installation Manager tab in R2 Platform Tool view

Use this tab for three different platform operations:

Editing of R2 “properties files” on the remote JACE platform, such as system.properties, driver.properties, and so on. See R2 Property Files.
Reviewing or installing the Niagara R2 license file in the remote JACE platform. See R2 License Management.
Installing R2 lexicon sets on the remote JACE platform. See R2 Lexicon Management.

R2 Property Files

Available R2 property files are listed near the top of the R2 Installation Manager tab, where each has a control to expand or collapse the contents of this text file on the remote JACE platform.

Figure 23. Example drivers.properties file edit in R2 Installation Manager tab

At the bottom of the view, below any expanded properties file, is a Save File button. This button becomes enabled whenever you click in the file and change any text.

Files are listed with names similar to the actual file name, for example “R2 Driver Properties” for driver.properties or “R2 Status Color Properties” for statusColor.properties.

The following is a collection of notes about R2 Property Files on a JACE-603 or JACE-645 platform:

The former station.properties file (only properties file in an R2 station’s folder) is no longer used, and does not appear in the list of R2 properties files.
Because of the different QNX OS used in a JACE-603 or JACE-645 platform, many of the previous R2 property files on an older (VxWorks) JACE-403 or JACE-545 controller are incompatible with an upgraded unit. For example, system.properties and drivers.properties are different.

Do not transfer such (saved) files over to a new unit, for example using the platform File Transfer Client. Instead, make any needed changes in the existing files, by editing and clicking the Save File button at the bottom of this platform view.
By default, several of the available R2 property files are initially blank. These include R2 BACnet Properties (bacnet.properties), R2 Gx Properties (gx.properties), and R2 Obix Properties (obix.properties).

If your JACE-403 or JACE-545 was using such property files, you should re-enter the needed values and click the Save File button for each, as needed.

Related, note the R2 Status Colors Properties (statusColors.properties) file uses standard defaults—if your JACE-403 or JACE-545 used non-defaults, you should edit as needed.
Typically, any change to R2 properties files require a JACE reboot before they become effective.

R2 License Management

Below the R2 property files on the R2 Installation Manager tab are two subtabs.

Figure 24. Example contents of R2 License Management subtab of R2 Installation Manager tab

The left subtab is for R2 License Management, used to review and/or install the R2 license file in the remote JACE platform. Above the license file contents is the R2 Host ID for the current JACE.

To install a new R2 license file

To install a new R2 license, do the following:

Click the Install License button at the bottom of the view. This produces a popup File Chooser dialog, in which you can navigate to an R2 license file.

As shown above, you can click (select) a license file to see its text contents, including unique hostId, as well as date of generation.
Click Open to install the selected R2 license file, or else Cancel to close the File Chooser dialog without installing the license file.

R2 License Management notes

For a JACE-603 or JACE-645 platform configured for Niagara R2:

For any new JACE-603 or JACE-645, it is recommended that you copy its installed R2 license file to your PC, using the File Transfer Client platform view. See Copy the installed R2 license file for a procedure.
Typically, any change to an R2 license file requires a JACE reboot before it becomes effective.
Note the R2 license file is different than the NiagaraAX license file, which is managed in another platform view, the License Manager view. That platform view offers more and different license management options, including updates from the online NiagaraAX “licensing server”. However, currently this is not available for Niagara R2 licenses.

R2 Lexicon Management

Below the R2 property files on the R2 Installation Manager tab are two subtabs.

Figure 25. Example contents of R2 Lexicon Management subtab of R2 Installation Manager tab

Click the right subtab for R2 Lexicon Management, used to install or delete R2 lexicon sets in the remote JACE. Listed are all currently installed lexicon sets, by their 2-character lexicon folder name.

To install R2 lexicon sets

To install R2 lexicon sets, do the following:

Click the Install button at the bottom of the view. This produces a popup Select Directories dialog, in which you can navigate to select one or more lexicon directories.

By default, the lexicon folder under your Niagara R2 installation folder is the selected root folder.
Click a single lexicon directory folder to select it, or to select multiple lexicons, press and hold Ctrl while clicking lexicon directories.
Click OK to install the selected lexicon set(s), or else Cancel to close the directory chooser dialog.

To delete R2 lexicon sets

To delete R2 lexicon sets, do the following:

In the R2 License Management tab, click a single lexicon to select it, or to select multiple lexicons, press and hold Ctrl while clicking lexicons.
Click Delete at the view bottom. The lexicons are deleted on the JACE, and also removed from the view.

R2 Lexicon Management notes

For a JACE-603 or JACE-645 platform configured for Niagara R2:

Typically, any install or change to an R2 lexicon requires a JACE reboot before it becomes effective.
If installing any lexicon set that already exists in the remote JACE, be aware this tool overwrites the existing lexicon set (without any confirmation dialog). Be sure your lexicon set in your Niagara R2 installation is the appropriate one for installation.