Administer the JACE platform

To perform platform administration

With your Workbench PC re-configured with its working IP address, and the JACE already commissioned using the Commissioning Wizard:

  1. Open a platform connection to the JACE. Use the platform credentials you specified when commissioning the JACE.

  2. In the JACE platform’s Nav Container View, double-click Platform Administration.

    The Platform Administration view appears (Figure 31).

  3. As needed, click the following buttons to review or make changes:

    • View Details — For a platform summary that you can copy to the Windows clipboard.

    • Update Authentication — For a platform daemon authentication dialog to change platform login (username and password, as previously included as step in the commissioning wizard).

      NoteIf using AX-3.8, see Platform credentials notes for AX-3.8.

    • Change HTTP Port — For a dialog to change the HTTP port for the JACE’s platform daemon from port 3011 to some other port. See HTTP Port.

    • Change SSL Settings — (Available only if the AX-3.7 or later JACE is licensed for SSL and has the necessary modules installed) For a dialog to specify platform SSL settings, including port to use, certificate to authenticate by, and secure protocol to use. Details are beyond the scope of this document. For an overview, see “Change SSL Settings” in the Platform Guide. For complete information, refer to the NiagaraAX SSL Connectivity Guide.

    • Change Date / Time — For a dialog to change the JACE’s current date, time, and time zone (as previously included as step in commissioning wizard).

    • FTP / Telnet — 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.

    • Change Output Settings — Provides a dialog to change the log level of different processes that can appear in the platform daemon output

    • View 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.

    • Set Module Filter — Provides a dialog to change the module content level of the JACE (as previously included as step in commissioning wizard).

    • Backup — Make a complete backup of all configuration on the connected host platform, including all station files, plus other Niagara configuration (typically unnecessary for any JACE just started up).

    • Commissioning — Another way to re-launch the Commissioning Wizard, as previously used in the initial commissioning of the JACE.

    • Reboot — 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), the installed 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”) the station in any QNX-based JACE from the Application Director (Station Director), as the Start button will remain unavailable.

Change HTTP Port

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 31):

  1. Click the Change HTTP Port button.

    A dialog appears showing the current HTTP port number highlighted.

  2. Type in the new HTTP port number.

  3. Click Ok.

    Your current platform connection is dropped, and the JACE platform appears ghosted in the Nav tree, showing the new HTTP port number (:n) in parenthesis by the platform icon.

  4. Double-click the ghosted JACE platform to get the platform login (Authentication) dialog, and enter the commissioned platform username and password. Click OK.

  5. From the platform’s container view, double-click Platform Administrator to return to its view.

NoteBefore closing the host (removing it from Nav tree), carefully note the new (non-default) port number you entered. You must always specify that port number whenever reopening the JACE’s platform.

Change FTP / Telnet

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.

CautionDo not enable FTP and Telnet unless requested by Tridium 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 31):

  1. Click the FTP / Telnet button.

    A dialog shows an enabled checkbox by FTP and Telnet, with TCP/IP port numbers used (Figure 32).

  2. If not already disabled, click each enabled checkbox to clear.

  3. Click Ok.

    FTP and Telnet access to the JACE are now disabled.

NoteEven 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.

Figure 32. JACE FTP and Telnet setup dialog


JACE FTP and Telnet setup dialog