To perform additional R2 platform administration
After running the Install Niagara R2 wizard:
-
Open a platform connection to the JACE and click on Platform Administration.
The Platform Administration view appears (Figure 18).
-
As needed, click the following buttons to review or make changes:
-
— For a platform summary that you can copy to the Windows clipboard.
-
— For a platform daemon authentication dialog to change platform login (previously covered in this document). See Platform daemon authentication.
-
— For a dialog to change the HTTP port for the JACE’s platform daemon from port 3011 to some other port (optional). See HTTP Port.
-
— For a dialog to change the JACE’s current date, time, and time zone (previously covered in this document). See Set system date and time.
-
— For a dialog to enable/disable both FTP and Telnet access to the JACE, or change the default port number used by each one. See Change FTP / Telnet.
-
— Provides a dialog to change the log level of different processes that can appear in the platform daemon output
-
— Provides a window in which you can observe debug messages from platform daemon processes in real time. Also includes ability to pause or load.
-
— Make a complete backup of all configuration on the connected host platform, including all station files, plus other Niagara R2 configuration (typically unnecessary for any JACE just started up), saved in a distribution (.dist) file—essentially a “zip” file, stored on your Workbench PC. A popup dialog asks you for the backup file location (and filename) before the backup begins.
By default, the location for backups is the “backups” folder under your Workbench release directory.
When the backup begins, a popup progress dialog appears, which you close upon successful finish.
If necessary, you can restore a backup dist file using another available platform view. See Distribution File Installer.
-
Uninstall Niagara R2 — To completely remove the Niagara R2 installation on the JACE-603 or JACE-645, including all station files, all Niagara R2 core software, modules, and lexicons, and its Niagara R2 license. Choose this only if you intend to reconfigure the unit for NiagaraAX.
Before choosing this, be sure to backup the R2 station and its R2 license. For more details, see Uninstall Niagara R2.
-
— Provides a method to reboot the JACE platform, which restarts all software including the OS and JVM, then the platform daemon, then if so configured in the Application Director (Station Director), then the installed R2 station. If you click this, a confirmation dialog appears.
If you reboot, your platform connection is lost, and it is typically a minute or more until you can reconnect to this JACE.
Note that a reboot is necessary if you have manually stopped (“Halted” or “Killed”) the station in any QNX-based JACE from the Application Director, as the button will remain unavailable.
-
This step is optional, and the default port 3011 is typically used in many Niagara installations. However, for reasons of additional security or perhaps firewall issues, you may need to change the HTTP port used by the JACE’s platform daemon.
To change HTTP port
From the Platform Administrator view (Figure 18):
-
Click the button.
A dialog appears showing the current HTTP port number highlighted.
-
Type in the new HTTP port number, and click .
Your current platform connection is re-established using the new HTTP port, with the platform view refreshed. This new HTTP port is immediately effective (and required) for any platform connection.
Any new (non-default) HTTP port now appears after the IP address of the platform connection.
You must always specify that port number whenever reopening the JACE’s platform in Workbench. For example, the platform login
below is using Port 3012 (non-default).
The default disabling of FTP (file transfer protocol) and Telnet access to the JACE prevents unauthorized access by either method. Generally, it is recommended that you keep both disabled.
Do not enable FTP and Telnet unless requested by Systems Engineering to facilitate debugging. Enabling FTP or Telnet on a
JACE that is exposed to the public Internet introduces a big security risk.
To verify or change FTP / Telnet access
From the Platform Administrator view (Figure 18):
-
Click the button.
A dialog shows an enabled checkbox by FTP and Telnet, with TCP/IP port numbers used.
-
If not already disabled, click each enabled checkbox to clear.
-
Click . FTP and Telnet access to the JACE are now disabled.
Unlike in the older R2 JACE, you do not need to modify the host’s system.properties file to make changes to FTP or Telnet access. Configuration is always done solely from this platform view.Even with FTP disabled,
you can transfer files between Workbench and the JACE using the platform’s File Transfer Client view. See the Platform Guide section “File Transfer Client” for more details.
This Platform Administration view button launches a one-step wizard for “Niagara R2 Decommissioning”.
As shown in the dialog below, you should backup the R2 license file and R2 station on the JACE before proceeding. Once you
click , the wizard deletes the entire R2 folder, and these items are gone!
To backup the R2 license file, use the platform File Transfer Client. See Copy the installed R2 license file.
To backup the R2 station, you can use the R2 Station Copier in the R2 Platform Tool view. See R2 Station Copier. Or, use the “” button in the view to save the entire R2 folder on the JACE, including station and license, as a “dist” file.