SOFTWARE INSTALLATION

JACE NiagaraAX Install & Startup Guide

Information and specifications published here are current as of the date of publication of this document. Tridium, Inc. reserves the right to change
or modify specifications without prior notice. The latest product specifications can be found by contacting our corporate headquarters, Richmond,
Virginia. Products or features contained herein may be covered by one or more U.S. or foreign patents. © 2007 Tridium, Inc.
This document covers the initial NiagaraAX software installation and configuration for a QNX-based
controller, e.g. JACE-2, JACE-6, (JACE-2/6) or JACE-403, JACE-545 (JACE-4/5 with NiagaraAX). It
assumes that you are an engineer, technician, or service person who is performing control system instal-
lation. All information in this document is also online in Niagara Workbench help, providing that the
docJaceStartup module was installed.
Note: For physical mounting and wiring details for any JACE controller, please refer to its specific hardware
installation document. For example, see the JACE-6 Mounting and Wiring Instructions.
This document does not cover station configuration or NiagaraAX components. For more information on
these topics, please refer to NiagaraAX online help and the User Guide.
The following main sections are in this document:
• “Overview” on page 1-1
• “Preparation” on page 1-2
• “Connect to the JACE” on page 1-3
• “Run the Commissioning Wizard” on page 1-4
• “Serial port/power monitoring (station) config” on page 1-15
• “Optional platform administration” on page 1-18
• “Modem configuration” on page 1-20
• “Recovery tips” on page 1-21
• “Document Change Log” on page 1-25

Overview
As shipped from the factory, a JACE-4/5 series controller with OS-AX contains only the bare minimum
of software to run the Niagara platform daemon (niagarad). The controller does not contain a Java VM,
Niagara runtime environment or software modules, lexicons, license, certificate, stations, and so on. A
JACE-2/6 series controller does include a core Niagara software load and a Tridium certificate, but not all
items needed.
Using NiagaraAX Workbench, you must connect to the JACE and install the Niagara core software,
selected modules, license(s), and do other platform configuration. Some important related tasks include
setting the JACE’s:
• IP network address, and related IP networking parameters
• Platform daemon credentials (for platform login)
• Time and date (or simply sync with your PC’s time)
This document provides step-by-step instructions for these and other tasks. As described ahead, the
most straightforward way is to use the Commissioning Wizard.
Note: Most steps in the Commissioning Wizard are also available as separate platform views. For example, there
is a Distribution File Installer, Software Manager, License Manager and many others. For more details, see
the “Niagara platform” section in the Platform Guide.

Factory-shipped state
• IP address
• HTTP port for platform access
• Platform daemon credentials

NiagaraAX-3.x
1
JACE NiagaraAX Install & Startup Guide December 5, 2007
Provide power and connectivity Preparation
December 5, 2007

IP address
When shipped, a new JACE controller is pre-configured with an IP address in the range:
• JACE-2/6 series: 192.168.1.12n (primary “LAN1” port, the “LAN2” port is disabled)
• JACE-4/5 series: 192.168.1.14n
where the last numeral (n) in the IP address matches the last numeral in the JACE’s serial number.
In all cases, the default subnet mask is: 255.255.255.0
You change these IP network settings during your startup commissioning of the JACE.
HTTP port for platform access
When shipped, the JACE’s platform daemon is configured to listen on HTTP port 3011. Often, this is left
at default. However, if a different port is needed for a platform connection (perhaps for firewall reasons),
you can change this during the commissioning of the JACE. For more platform connection details, see
“About a platform connection” in the Platform Guide.
Platform daemon credentials
Any JACE controller is shipped with these platform daemon (administrator) credentials:
Username: tridium Password: niagara
Initially, you use these default credentials to open (login) a platform connection to the JACE. Like the
factory-assigned IP address, default credentials are intended to be temporary. During your startup
commissioning, you should change these credentials to be something unique, and guard them closely.

Preparation
Two areas of preparation are required before proceeding:
• Provide power and connectivity
• Niagara and PC Requirements

Provide power and connectivity

Invariably, you perform the initial Niagara software installation and startup of a JACE (as described in
this document) in your office, before physically mounting it in place at a job site. Please refer to the
“Wiring Details” section of the appropriate JACE-xxx Mounting and Wiring Instructions document for
details on making (temporary) power wiring and Ethernet wiring connections.
The remainder of this document assumes that you have the JACE nearby, and are able to power it on and
off as needed. After you complete the commissioning process described in this document, you can mount
and wire the JACE controller at the job site, making permanent mounting and wiring connections.

Niagara and PC Requirements

These instructions assume that you have a PC running a licensed copy of NiagaraAX Workbench,
installed with the “installation tool” option. That option copies distribution files needed for commis-
sioning various models of JACE controllers. This PC is referred to as “your PC.”
Note: Use the same NiagaraAX Workbench build on your PC that you want to run in the JACE. Your PC must
meet minimum hardware/operating system requirements for a Workbench workstation. This includes a
working Ethernet adapter with TCP/IP support (browser capable). An Ethernet TCP/IP connection to the
JACE is required to install Niagara software and establish other parameters.
For this initial Ethernet connection, you can use either:
• A “crossover” cable connected directly between your PC and the JACE, or
• A normal LAN connection, meaning that both your PC and the JACE are physically connected to
the same Ethernet hub or switch.

To prepare for new JACE commissioning

To prepare for new JACE commissioning, do the following steps:
Step 1 If not already installed, install the NiagaraAX software on your PC, including its permanent license.
Step 2 Typically, the license file for the JACE already resides on the licensing server, where (if you have Internet
connectivity) it is automatically retrieved during the licensing step of the Commissioning Wizard.
Note: If you were emailed a license archive (.lar file) or .license file for the JACE, and you wish to use it instead of
the online license server (for some reason, for example your Workbench PC will not have Internet connec-
tivity when you are commissioning the JACE), make the file available to Workbench first, as follows:

NiagaraAX-3.x
2
JACE NiagaraAX Install & Startup Guide
Connect to the JACE Open a platform connection
December 5, 2007

• If using AX-3.3 or later Workbench, copy the file to your !licenses/inbox folder, then restart
Workbench. For more details, refer to the section “Local license inbox” in the Platform Guide.
• If using an earlier Workbench revision, and you were sent a license file, it is recommended that you
create a subfolder different than your existing licenses subfolder, and copy the JACE license file
there. For example, create a subfolder “JACElicenses”, under your working NiagaraAX directo-
ry, and copy the file there. In this case, the complete file path to the JACE license file might be
D:\niagara\Niagara-3.2.29\JACElicenses\Qnx-J403-0000-0802-3B42.license.
Note that if you received a license archive (.lar file), this is a “zipped” file that contains the JACE’s
“.license” file. Use WinZip or a similar utility to unzip the license archive first.
Step 3 Attach one end of a standard category-5 Ethernet unshielded twisted pair (UTP) patch cable to the RJ-45
Ethernet connector on the JACE.
Step 4 Attach the other end of the patch cable to a network port or directly to an Ethernet hub.
Step 5 Power up the JACE.
Step 6 Record you PC’s current IP settings, then re-assign your PC’s IP address for its Ethernet LAN adapter (if
necessary, refer to Windows online Help for information about configuring TCP/IP settings).
Note: As an alternative to re-assigning your PC’s IP address, you can use a serial shell mode connection to the
JACE to re-assign its factory IP address settings. After making this change and rebooting the JACE, you can
continue commissioning using Workbench. This requires proper serial cabling and a special power-up
mode for the JACE. For more details, see “System shell” on page 1-22.
For this initial connection to a factory-shipped JACE, configure your PC to use an IP address in the same
subnet as the JACE, as well as a matching subnet mask.
Set the IP address in the range: 192.168.1.1 to 192.168.1.254
with a subnet mask of: 255.255.255.0
Note: Do not assign your PC the identical IP address as the JACE’s factory-assigned IP address.
Step 7 From your PC, start Workbench. The Nav tree should be visible in the side bar area (left pane).
If not, from the menu bar, select Window > Side Bars > Nav.

Connect to the JACE

Once the JACE has powered up, connect to it with Workbench using “Open Platform.” A platform
connection to any JACE is required for most host-level operations. This includes installing NiagaraAX
core software and modules, establishing network and TCP/IP settings, and performing various other
tasks.
After you open a platform connection, you can run the Commissioning Wizard.
• Open a platform connection
• Run the Commissioning Wizard

Open a platform connection

To open a platform connection to a JACE
To open a platform connection from Workbench to the JACE, do the following:
Step 1 From the menu bar, select File > Open > Open Platform.
The Open Platform dialog box appears.
Step 2 Complete the fields in the Open Platform dialog box as follows:
• Host — Leave at default IP, and type in the default IP address of the new JACE.
• Port — Leave at default 3011.
• Credentials (see “Platform daemon credentials” on page 1-2), which include:
• Username — Type in default username: tridium
• Password — Type in default password: niagara
Step 3 Click the OK button to accept all settings.
The Platform opens in the tree, and its Nav Container View displays in the view pane (Figure 1-1).

NiagaraAX-3.x
3
JACE NiagaraAX Install & Startup Guide
About the Commissioning Wizard Run the Commissioning Wizard
December 5, 2007

Figure 1-1 Connected JACE platform

Note: After you commission a JACE and it reboots, in future platform sessions you will need to login using any
new (changed) parameters, such as IP address, Port, Credentials. If you changed your PC’s IP address in
order to connect to the JACE’s factory-assigned IP address, you will first need to reconfigure your PC to the
appropriate TCP/IP settings (to communicate to the now-commissioned JACE).

Run the Commissioning Wizard

The following sections describe using the Commissioning Wizard for a new JACE:
• About the Commissioning Wizard
• Start the Commissioning Wizard
• Set module content filter level
• Install/upgrade core software
• Station installation
• Select modules
• TCP/IP configuration
• Platform daemon authentication
• Install lexicons
• Install license
• Review and finish wizard

About the Commissioning Wizard

As shown in Figure 1-2, the Commissioning Wizard is a right-click option on any connected platform in
the Nav tree. You can also launch the wizard from the Platform Adminstration view.

Figure 1-2 Commissioning Wizard as right-click platform option

Typically, you use this wizard when installing a new JACE, as it provides a “checklist” method to perform
essential (and often “one time”) platform tasks. Using the wizard is also recommended whenever you
upgrade the core software in a JACE, at some future time. See “Upgrading a JACE” in the Platform Guide.
Note: The same tasks executed as steps in the wizard can also be performed in separately available platform
views. However, the wizard provides an orderly and reliable method for commissioning.

NiagaraAX-3.x
4
JACE NiagaraAX Install & Startup Guide
Run the Commissioning Wizard Start the Commissioning Wizard
December 5, 2007

Important Commissioning Wizard notes

• The first part of the wizard is to select the installation steps needed and then install the core software
(distribution file)—core software must be installed for a new JACE. After this portion completes, the
wizard steps you through remaining steps in a second sequence.
• Throughout the wizard’s dialogs, use the buttons Back and Next, as needed, to retrace (or skip)
steps. Also, the Cancel button stops any unfinished operations, and exits the wizard after your con-
firmation.
• Before committing to the final sequence of steps, the wizard provides a summary for you to review.

Start the Commissioning Wizard

To start the Commissioning Wizard
From Workbench with the JACE platform open, to start the Commissioning Wizard do the following:
Step 1 In the Nav tree, right-click on Platform and select Commissioning Wizard.
The dialog box Commissioning for “<IP address>” appears (Figure 1-3).
By default, all steps are preselected except local time synchronization and lexicon installation (for
language support). Steps are executed in the order listed in the wizard.
Step 2 As needed, click to include or omit steps. For a new JACE, you typically accept all default selections, plus
add (check) “Sync with my local system date and time.”
Commissioning steps include:
• Change module content filter level — Recommended.
• Install/upgrade core software from a distribution file — Preselected for any new JACE.
• Sync with my local system date and time — Recommended.
• Install a station from the local computer — Recommended.
• Install/upgrade software modules — (always preselected, whenever wizard is run).
• Configure TCP/IP network settings — Recommended.
• Configure platform daemon authentication method — Recommended.
• Install lexicons to support additional languages — Recommended for non-English language sup-
port.
• Request or install software licenses — Recommended.
Step 3 Click the Next button to continue. With wizard selection defaults, this is Set module content filter level.

Figure 1-3 Commissioning Wizard (default selections shown)

Set module content filter level

Module content filter level affects how much storage space is used when installing Niagara modules.
Usually, the default (preselected) level is appropriate for the opened JACE platform.

To specify the module content filter level

At the Module Content Filter Level step (Figure 1-4) in the Commissioning Wizard, do the following:
Step 1 Click the desired level of content in Niagara modules to be installed in this JACE.
Module content level is one of the following:
• DOC+UI+RUNTIME — Typically not appropriate for any QNX-based JACE.
• UI+RUNTIME — Appropriate if the JACE is to run the Web Service.
• RUNTIME — Typically best for any QNX-based platform not running the Web Service.

NiagaraAX-3.x
5
JACE NiagaraAX Install & Startup Guide
Install/upgrade core software Run the Commissioning Wizard
December 5, 2007

Step 2 Click the Next button for the next step, which for a new JACE is always Install/upgrade core software.

Figure 1-4 Module Content Filter Level

Install/upgrade core software

At the install/upgrade core software step, a popup dialog briefly appears as the dependencies of the
platform are compared against the distribution (dist) files available in your Workbench PC’s “software
database.” The wizard determines what dist file(s) need to be installed, and then informs you in a dialog
(Figure 1-5).
Note: For related details, see the section “About your software database” in the Platform Guide.

To install the distribution file

To install the selected distribution file, do the following:
Step 1 Click Next to install the distribution file.
The distribution file install process begins, with the necessary substeps shown in the dialog. Each substep
has a status that changes from “Not Running” to “Started” to “Success” as it completes. The entire process
can take several minutes until it completes (Figure 1-6).
Step 2 After the distribution file is installed, click the Next button to go to the next commissioning step. Using
wizard defaults, this is Station installation.

Figure 1-5 Distribution File Installation (beginning)

Figure 1-6 Distribution File Installation (completed)

Note: When doing future Niagara upgrades to this JACE, it is recommended that you relaunch the Commis-
sioning Wizard. See “Upgrading a JACE” in the Platform Guide for details.

NiagaraAX-3.x
6
JACE NiagaraAX Install & Startup Guide
Run the Commissioning Wizard Station installation
December 5, 2007

Station installation
If you have a specific station database ready to install in the JACE, you can specify it at this step in the
wizard. Or, simply accept the default “(Don’t transfer a station)” and click Next. (You can create a station
later using the New Station Wizard, and install it using the platform’s Station Copier.)

To specify a station database to install

At the Station Installation step (Figure 1-7) in the Commissioning Wizard, do the following:
Step 1 Click the Station drop-down control and click the name of a station database on your PC.
Listed are station subfolders under your PC’s local Niagara stations folder.
Step 2 If you select a station, the following additional selections are available (Figure 1-8):
• New Name — Either leave at same station name as local copy, or type in a new station name.
• START AFTER INSTALL — If enabled, the station starts after the commissioning completes.
• AUTO-START — If enabled, the station starts every time the JACE is rebooted.
Step 3 Click the Next button to continue.
A dialog asks which station files to copy (Figure 1-9), where you can select one of the following:
• Copy files from selected directories — Allows you to specify which subfolders under that local sta-
tion that are copied. It produces a “tree” selection dialog (Figure 1-10) upon Next button.
• If you choose this, click folder controls to expand and contract as needed.
• Selected folders appear with an “X” and unselected folders show an empty folder box.
• Copy every file in the station directory and its subdirectory — The default, most typically used.
• Copy only the “config.bog” station database file — Copies only the station configuration (compo-
nents), and not any supporting folders/files like px files, html files, and so forth.
Step 4 Click the Next button for the next step, Select modules.

Figure 1-7 Station Installation dialog (default)

Figure 1-8 Station Installation dialog (station selected)

Figure 1-9 Station Installation dialog (copy options)

Figure 1-10 Station Installation dialog (select subfolders)

NiagaraAX-3.x
7
JACE NiagaraAX Install & Startup Guide
Select modules Run the Commissioning Wizard
December 5, 2007

Select modules
During commissioning, you can change modules that are preselected for installation. Often, you do not
make any changes, as the wizard preselects all necessary “core” modules, plus any additional modules
needed by the station you previously selected (see “Station installation” on page 1-7).
However, if you did not previously select a station to install, you may wish to select modules to support a
station you have in mind. Or, you may know that the JACE will need a module in the future (say for a
driver), and you wish to install it now.
Note: In general, do not select modules if you are not sure they are needed. You can manage modules anytime
later, using the Software Manager. Also, if you install a station later, the Station Copier will automatically
prompt for confirmation to install any additional modules deemed necessary.

To select modules
At the Module Installation step (Figure 1-11) in the Commissioning Wizard, do the following:
Step 1 Review the list of available modules (This list is long and requires you to use the scroll bar).
Each selected module has an “X” in its selection box.
Note the following:
• Modules preselected from “core” need or station database reasons each have a red text descriptor,
which may read as:
• Install required platform module
• Install module required by station “<stationName>”
By default, these modules are at the top of the list. You cannot deselect these modules.
• You can select additional modules to install by clicking selection boxes. The description for each is
in blue text, and displays as either:
• Not Installed (if not selected)
• Install Tridium <buildNumber> (if selected)
• To resort the list alphabetically, click the Module header in the table. To return to the default sort
order, click the table’s (blank) description header.
• To reset the selection of modules to the original collection, click the Reset button.
Figure 1-12 shows the dialog after modules have been selected and the list resorted alphabetically.
Step 2 Click the Next button to go to the next step. Typically, this is TCP/IP configuration.

Figure 1-11 Module installation dialog (default)

NiagaraAX-3.x
8
JACE NiagaraAX Install & Startup Guide
Run the Commissioning Wizard TCP/IP configuration
December 5, 2007

Figure 1-12 Module installation dialog (after resort, selecting modules)

TCP/IP configuration
To configure TCP/IP settings
At the TCP/IP Configuration step (Figure 1-13) in the Commissioning Wizard, do the following:
Step 1 Review the “Interface 1” TCP/IP settings, which include the temporary factory-shipped IP address.
Step 2 Assign the JACE a unique IP address for the network you are installing it on. No other device on the
network should use the same IP address. Include the appropriate subnet mask used by the LAN.
Alternatively, if the network supports DHCP, you can enable it (click DHCP Enabled). In this case, the IP
Address and Subnet Mask fields become read only.
Note: In general (for stability), static IP addressing is recommended over DHCP.
Do not enable DHCP unless you are certain that the network has DHCP servers!
Otherwise, the JACE may become unreachable over the network.
Step 3 Review, and if needed adjust other TCP/IP settings, which (in usual order of importance) include:
• Gateway — The IP address for the device that forwards packets to other networks or subnets.
• DNS Domain Name — Type name of network domain, or if not applicable, leave blank.
• Hostname — Default is “localhost,” or enter another name you want to use for this host.
• Hosts File — Click control to expand edit field. Format is a standard TCP/IP hosts file, where each
line associates a particular IP address with a known host name. Each entry should be on an individual
line. The IP address should be placed in the first column, followed by the corresponding host name.
The IP address and the host name should be separated by at least one space.
Step 1 To add a line, click at the end of the last line and press Enter.
Step 2 Type in the required data on the new line.
To return to see all TCP/IP settings, click the control to contract the edit field when done.
Step 3 Click the Next button to go to the next step.
Note: If commissioning a JACE-2/6 with two Ethernet ports, please note that an “Interface 2” is available,
for configuring the LAN2 (secondary) Ethernet port. By default, this port is disabled, that is without a
“default” address. Intended usage is for isolating a “driver’s” Ethernet traffic from the primary (LAN1)
interface. DHCP is not supported on LAN2—if enabled, you specify another (network) static IP address
and the appropriate subnet mask.
Note: If enabling both LAN ports, note that the LAN1 IP address and LAN2 IP address must be on different
subnets, otherwise the ports will not function correctly. For example, using a typical “Class C” subnet mask
of 255.255.255.0, setting Interface 1=192.168.1.99 and Interface 2=192.168.1.188 is an invalid configu-
ration, as both addresses are on the same subnet.

NiagaraAX-3.x
9
JACE NiagaraAX Install & Startup Guide
Platform daemon authentication Run the Commissioning Wizard
December 5, 2007

Figure 1-13 TCP/IP Configuration dialog

Platform daemon authentication

At the platform daemon authentication step (Figure 1-14) in the wizard, you specify platform login
credentials (user name and password) for this JACE. See “Platform daemon credentials” on page 1-2.

To specify the platform daemon authentication

Caution It is strongly recommended that you change default platform credentials (user name=tridium,
password=niagara). Consider the platform daemon as the highest-level access to the JACE.
Furthermore, make careful note of your entries. If you lose or forget these credentials, you will be unable to
complete the commissioning and startup of this JACE. In this case, you must contact Systems Engineering
for a procedure to regain platform access.

To specify the platform daemon authentication, do the following:

Note: User name and password entries are case sensitive.
Step 1 In the User Name field, type in the desired user name for platform login.
User Name can be a maximum of 8 alphanumeric characters (a - z, A - Z, 0 - 9), where the first character
must be alphabetic, and following characters either alphanumeric or underscore ( _ ).
Note: Starting in AX-3.2, the maximum limit for any QNX-based JACE increased from 8 to 14 alphanumeric
characters.
Step 2 In the Password fields, type in the desired password (it must match in both password fields).
Entry characters display only in asterisks (*).
Password can be any desired length and mix of characters (“strong” passwords are supported).
Step 3 Click the Next button for the next step. Unless installing lexicons, this is typically Install license.

Figure 1-14 Platform Daemon Authentication dialog

NiagaraAX-3.x
10
JACE NiagaraAX Install & Startup Guide
Run the Commissioning Wizard Install lexicons
December 5, 2007

Install lexicons
To install lexicons
At the Lexicon Installation step (Figure 1-15) in the Commissioning Wizard, you can install one or more
lexicon files in a new JACE. Lexicons provide support for non-English languages in the JACE.
Note: In order to select lexicons, you must have installed them as part of the NiagaraAX Workbench installation
on your PC. You will see only those lexicons you selected at that time. Typically, after installing those
lexicons on your PC, you customize (edit) them using the Lexicon Editor in Workbench. Afterwards, you
install them in JACEs, so that each JACE has the proper changes.
Lexicons are identified by java locale codes, such as “fr” (French) or “de” (German).
To install lexicons, do the following:
Step 1 Click a language code to select (highlight) it.
If multiple lexicons are also needed, hold down the Ctrl key while you click.
Step 2 When needed lexicons are selected, click the Next button to the next step. Typically, this is Install
license.

Figure 1-15 Lexicon Installation dialog

Install license
To automatically install or update licenses
At the License step (Figure 1-16) in the Commissioning Wizard, you install one or more license files in a
new JACE. You typically select the option to get and install licenses from the licensing server.
Note: At least one license file specific to any JACE is stored on the licensing server. Providing you have Internet
connectivity, this is the recommended method to install or update a license. See “About the Licensing
Server” on page 1-13 for more details.
A minimum of one license file is always needed. Typically, other license files are not needed unless you are
using third-party module(s). In this case, you can also install those license files during this same commis-
sioning step, either automatically, or by selecting to install from files.

Figure 1-16 License dialog (select method)

Step 1 Select “Get and Install the licenses for the host from the license server.”
Step 2 Workbench silently searches the licensing server, locates the license(s), and the wizard advances to the
next step. See “Review and finish wizard” on page 1-13.
Note: If the “license server” option shown above does not appear, Workbench has not detected Internet connec-
tivity, and so cannot contact the licensing server. In this case, you can either:
• If you are using AX-3.3 or later Workbench, and you already have a license for this JACE in your “lo-
cal license database,” select the last option shown in Figure 1-16, that is to install from your “work-
bench license database.” Workbench locates the license, and the wizard advances to the next step.
See “Review and finish wizard” on page 1-13. Please note this option will be missing if your local li-

NiagaraAX-3.x
11
JACE NiagaraAX Install & Startup Guide
Install license Run the Commissioning Wizard
December 5, 2007

cense database does not include a license for this JACE, or if you are using an older (pre-AX-3.3) re-
vision of Workbench. For related information, refer to the section “About the local license database”
in the Platform Guide.
• If you have the JACE license file(s), use the next procedure “To install or update licenses from files”.
If necessary, you can also install license(s) later, either from your local license database or from li-
cense files.

To install or update licenses from files

Step 1 At the License step, select “Install one or more licenses from files”.
Step 2 Click the Next button.
The “Choose license files to install” step appears (Figure 1-17).
Step 3 Click the Add button.
A “Select File” dialog appears (Figure 1-18). By default, the contents of your licenses subfolder is listed
(showing your Workbench license). If you previously pointed Workbench to another location, license
files in that location are listed instead.
• If you see the license you need, click it to highlight it. If other licenses are also needed, you can select
multiples by holding down the Ctrl key while you click.
• If a license is not listed, navigate to its location using the left-pane folder tree controls, and click the
license to highlight it.
Note: The licensing tool prevents selection of a wrong license (different hostid) to install in the JACE.
Step 4 Click the OK button.
The “Choose license files to install” dialog appears (Figure 1-19) with the selected license(s).
Step 5 If necessary, click the Add button again (step 3) to add additional license files.
Step 6 When all needed licenses are listed in the “Choose license files” dialog, click the Next button to go to the
last (review) dialog in the Commissioning Wizard.

Figure 1-17 License dialog (choose files)

Figure 1-18 Select Files dialog from Add in Licensing

NiagaraAX-3.x
12
JACE NiagaraAX Install & Startup Guide
Run the Commissioning Wizard Review and finish wizard
December 5, 2007

Figure 1-19 License dialog with file selected

About the Licensing Server

For license files validated against the Tridium certificate, installation can be automated from Workbench.
All such purchased licenses (including JACE, AxSupervisor, or Workstation-only) are stored and
available to Workbench through the licensing server.
Providing that your PC currently has Internet connectivity while running a platform connection to any
Niagara host, Workbench provides an install option (get and install the licenses for the host from the
license server). When selected, Workbench silently searches the Tridium web portal for a license with a
matching Host ID of the target platform. When found, it selects the license(s) and advances to the next
wizard step. For more details, refer to the section “About the licensing server” in the Platform Guide.

Review and finish wizard

To review and finish the Commissioning Wizard
After the final selected step in the Commissioning Wizard, a “Review of changes” dialog appears, as
shown in Figure 1-20. It lists a summary of all remaining actions to be performed by the wizard.
Before proceeding:
Step 1 Read through the summary of changes, using the scroll bar to see those steps near the end.
• If no change is needed, click the Finish button to initiate the rest of the Commissioning Wizard.
• If any change is needed, click the Back button until the step dialog appears, then make the change.
Then, click the Next button until this review dialog appears again.
Step 2 While the wizard is working, progress updates are posted in a “Completing Commissioning” dialog.
When completed, the wizard reboots the JACE, and a “Close” button is available (Figure 1-21).
Step 3 Click the Close button to exit the wizard.
When the JACE reboots, your platform connection to it drops. Notice that in the Nav tree, the platform
instance for that JACE is now dimmed.
Step 4 Right-click and close that platform instance (Figure 1-22), as it is now invalid due to changed IP address.
Note: Going forward, you must access the JACE by its new (assigned) IP address. Note that your Workbench keeps
a history of TCP/IP changes made. See “IP changes history” on page 1-21. Also, remember to login using its
new assigned platform credentials, see “Platform daemon authentication” on page 1-10.
Note: If you changed your PC’s IP address in order to commission the JACE, you usually need to reconfigure your
PC’s TCP/IP settings back to appropriate settings (now) to communicate with it. Otherwise, you will be
unable to connect to it for other commissioning.

NiagaraAX-3.x
13
JACE NiagaraAX Install & Startup Guide
Review and finish wizard Run the Commissioning Wizard
December 5, 2007

Figure 1-20 Review Commissioning Wizard dialog

Figure 1-21 Commissioning Wizard complete dialog

Figure 1-22 Closing now-invalid platform instance

NiagaraAX-3.x
14
JACE NiagaraAX Install & Startup Guide
Serial port/power monitoring (station) config About Platform Services
December 5, 2007

Serial port/power monitoring (station) config

Some JACE models require configuration of serial ports, as one or more ports may be “dual-duty” (either
RS-232 or RS-485). Also, if the JACE has an onboard modem, one serial port must be dedicated for its
usage. In addition, “power monitoring” options may require adjustment from default settings. These
parameters define the JACE’s backup-battery monitoring and AC power-fail shutdown routines.
Using Workbench, you configure both items in a running station on the JACE, by accessing services under
the station’s PlatformServices container.
Note: If familiar with Niagara r2, note that JACE port and power monitoring setup was formerly done at the host
level using properties files. In NiagaraAX, this configuration was moved to the station.
The following sections explain further:
• About Platform Services
• JACE serial port configuration
• JACE power monitoring configuration
• PlatformServices properties

About Platform Services

Under its Services container, every NiagaraAX station has a PlatformServices container (Figure 1-23).

Figure 1-23 JACE station’s PlatformServices

PlatformServices is different from all other components in a station in the following ways:
• It acts as the station interface to specifics about the host platform (whether JACE or a PC).
• It is built dynamically at station runtime—you do not see PlatformServices in an offline station.
• Any changes you make to PlatformServices or its child services are not stored in the station database.
Instead, changes are stored in other files on the host platform, such as its platform.bog file.
Note: Do not attempt to edit platform.bog directly; always use PlatformServices’ views!
Included under PlatformServices are a TcpIpService and LicenseService, providing station
(Fox) access to dialogs used in platform views, for instance the TCP/IP Configuration dialog as shown in
Figure 1-13 on page 10. These services support installations where all configuration must be possible
using only a browser connection (and not Workbench connected to the JACE’s platform daemon).
PlatformServices items of interest for JACE commissioning
For any QNX-based JACE, its serial port and power monitoring configuration is accessed in the following
child service components of the station’s PlatformServices:
• SerialPortService — Holds properties for configuration and status of the JACE’s serial ports.
• PowerMonitoringService — Holds properties for configuration and status of the JACE’s bat-
tery monitoring and AC power-fail shutdown.
To perform either JACE serial port configuration or JACE power monitoring configuration, you require
a station running in the JACE to access these services. Also, you may wish to review the parent container’s
PlatformServices properties and optionally adjust, if needed.

JACE serial port configuration

To configure serial port usage of the JACE
With a station in the JACE running, and that station opened in Workbench, do the following:
Step 1 In the Nav tree, click to expand the station’s Services, then PlatformServices container to reveal
all contained services.

NiagaraAX-3.x
15
JACE NiagaraAX Install & Startup Guide
JACE power monitoring configuration Serial port/power monitoring (station) config
December 5, 2007

Step 2 Double-click SerialPortService.

Its property sheet displays in the view pane, as shown in Figure 1-24 on page 16.
Step 3 By the Port Config property, click the drop-down control to select from a list of available choices. This list
will vary depending on the particular JACE model being commissioned.
For example, if a JACE-403 the following choices are available:
• Com1_232_Com2_485 — Default configuration for a JACE-403.
• Com1_232_Com2_modem — Valid choice if JACE-403 is equipped with onboard dialup modem.
• Com1_485_Com2_modem — Valid choice if JACE-403 is equipped with onboard dialup modem.
Note: For any JACE equipped with an onboard dialup modem, select one of the “_modem” options.
Step 4 Click Save to write the configuration to host platform.

Figure 1-24 Property sheet of SerialPortService in JACE station

JACE power monitoring configuration

To configure power monitoring for the JACE
With a station in the JACE running, and that station opened in Workbench, do the following:
Step 1 In the Nav tree, click to expand the station’s Services, PlatformServices, containers to reveal all
contained services.
Step 2 Double-click PowerMonitorService.
Its property sheet displays in the view pane, as shown in Figure 1-25 on page 17.
Step 3 As needed, change configuration properties stored in the JACE platform, which include:
• Shutdown Delay
Defines the period that the JACE waits between detecting loss of AC power and performing a grace-
ful shutdown (backs up database and powers board off). Depending on JACE model, using either a
sealed lead-acid (Sla) battery or nickel metal hydride (NiMH) battery, this varies.
• For JACE-4/5 models (Sla), the default period is 1 minute, range is 0 to 15 minutes.
• For JACE-2/6 models (NiMH), the default (and maximum) value is 30 seconds, range is 0 to 30
seconds.
Generally, for “Sla battery” models, the default value is recommended, as longer periods means more
time running on battery power. Otherwise, in some scenarios with multiple lengthy power failures
(in succession) the battery may become completely discharged.
• Battery Alarm Support
A container for properties that define how “battery alarms” are handled in the station, including
alarm class to use and other “alarm source info” type parameters.
• Power Alarm Support
A container for properties that define how “primary power alarms” are handled in the station, in-
cluding alarm class to use and other “alarm source info” type parameters.
Note: Three properties are read-only status types, including these two boolean ones:
• Primary Power Present — True if AC power is currently supplied to JACE.
• Battery Good — True if last JACE backup battery test was good.
Also, a “Time of Last Test” property provides a timestamp (in AbsTime format) of the last battery
test performed by the JACE.
Step 4 Click Save to write the configuration to host platform.

NiagaraAX-3.x
16
JACE NiagaraAX Install & Startup Guide
Serial port/power monitoring (station) config PlatformServices properties
December 5, 2007

Figure 1-25 Property sheet of PowerMonitorService in JACE

PlatformServices properties
To review PlatformServices properties for the JACE
With a station in the JACE running, and that station opened in Workbench, do the following:
Step 1 In the Nav tree, double-click Services and then PlatformServices.
Its property sheet displays in the view pane, as shown in Figure 1-26 on page 18.
Many are read-only status types, similar to what is available in the Platform Adminstration view. Other
configuration properties are available. A group of 3 config properties allow adjustment of the time, date,
and time zone settings for the host JACE (alternately accessible using a platform connection to the JACE).
Access to these properties is useful if the installation requires all setup access using a browser only.
Step 2 As needed, review other platform service configuration properties, which include the following:
Note: It is strongly recommended that you leave the following properties at default values, unless otherwise
directed by Tridium Systems Engineering.
• Locale — Determines locale-specific behavior such as date and time formatting, and also which
lexicons are used. A string entered must use the form: language [“_” country [“_” variant]]
For example U.S. English is “en_US” and traditional Spanish would be “es_ES_Traditional”.
For details, see Sun documentation at http://java.sun.com/j2se/1.4.2/docs/api/java/util/Locale.ht-
ml.
• Engine Watchdog Policy — Defines response taken by the platform daemon if it detects a sta-
tion engine watchdog timeout. With the watchdog, the station periodically reports to the platform
daemon its updated engine cycle count. The watchdog purpose is to detect and deal with a “hung”
or “stalled” station, and is automatically enabled when the station starts.
Watchdog policy selections include:
• Log Only — Generates stack dump and logs an error message in the system log.
• Terminate — (Default) Kills the VM process. If “restart on failure” is enabled for the station
(typical), the station is restarted.
• Reboot — Automatically reboots the host JACE platform. If “auto-start” is enabled for the sta-
tion, the station is restarted after the system reboots.
• Engine Watchdog Timeout — Default is 1 minute, and range is from 0 ms to infinity.
If the station’s engine cycle count stops changing and/or the station does not report a cycle count to
the platform daemon within this defined period, the platform daemon causes the VM to generate a
stack dump for diagnostic purposes, then takes the action defined by the Engine Watchdog Policy.
• Engine Station Auto-Save — Either Enable (default) or Disable.
Allows for “auto save” of running station to “config_backup_<YYMMDD>_<HHMM>.bog” file at the
frequency defined in next property. Auto-saved backup files are kept under that station’s folder.
• Station Auto-Save Frequency — Default is every 24 hours for any embedded JACE, range
is from 1 to many hours.
• Station Auto-Save Versions to Keep — Default is 0 (starting in builds 3.0.101 and 3.1.15;
previously it was 3). Oldest of kept backups is replaced upon next manual save or auto-save backup,
once the specified limit is reached. Significant flash space is saved by keeping this 0 or perhaps 1.
• RAM Disk Size — In MB, where default is 16 for a JACE-4/5 series, 8 for a JACE-2 series, or 32
for a JACE-6 series. Specifies size of RAM disk used to store history and alarm files.
For further details on these and other PlatformServices properties, refer to the “PlatformServiceCon-
tainer parameters” section in the Platform Guide.

NiagaraAX-3.x
17
JACE NiagaraAX Install & Startup Guide
About JACE platform administration Optional platform administration
December 5, 2007

Step 3 Click Save to write any configuration change to host platform.

Figure 1-26 PlatformServices property sheet in JACE

Optional platform administration

The Commissioning Wizard performs most, but sometimes not all, needed configuration for a new JACE
platform. There are several items you should review (and possibly change) in a follow-up platform
connection to each JACE, using the Platform Adminstration view.
• About JACE platform administration
• Administer the JACE platform

About JACE platform administration

As shown in Figure 1-27, the Platform Administration view is one of several views for any platform, listed
under the platform in the Nav tree and in the platform’s Nav Container View.

Figure 1-27 Platform Administration is one of several platform views

Included in this view (Figure 1-28) are commands and related dialogs in which you can:
• Set the date and time in the JACE.
Typically, this is needed only if you did not choose to “sync” with your local system date and time
when running the Commissioning Wizard.
• Change the HTTP port used by the JACE for the Niagara platform daemon (platform server).
The default port is 3011.
• Enable or disable either or both FTP and Telnet access to the JACE.
By default, both FTP and Telnet are disabled, and use TCP ports 21 and 23, respectively.

NiagaraAX-3.x
18
JACE NiagaraAX Install & Startup Guide
Optional platform administration Administer the JACE platform
December 5, 2007

Note: FTP and Telnet can pose security risks; you may wish to keep them disabled them for this
reason.
• View a simple text summary of the JACE’s current software configuration, including its model num-
ber, OS level, JVM version, installed modules, lexicons, licenses, certificates, and so on.
• Use debug-level tools to change logging levels and view platform daemon output.
• Perform other platform tasks available using the Commissioning Wizard, such changing platform
authentication (platform’s username and password), and so on.

Figure 1-28 Platform Administrator view for JACE

For more details, see the Platform Administration section in the Platform Guide.

Administer the JACE platform

To perform platform administration
With your Workbench PC re-configured with its working IP address, and the JACE already commis-
sioned using the Commissioning Wizard:
Step 1 Open a platform connection to the JACE.
Use the procedure “Open a platform connection” on page 1-3, except use the JACE IP address and
platform credentials (username and password) that you configured when running the wizard.
Step 2 In the JACE platform’s Nav Container View, double-click Platform Administration.
The Platform Administration view appears (Figure 1-28).
Step 3 As needed, click the following buttons to review or make changes:
• View Details — For platform summary that you can copy to the Windows clipboard.
• Update Authentication — For platform daemon authentication dialog to change platform lo-
gin (username and password, as previously included as step in commissioning wizard).
• Change HTTP Port — For dialog to change the HTTP port for the JACE’s platform daemon from
port 3011 to some other port. See “Change HTTP Port” on page 1-20.
• Change Date / Time — For dialog to change the JACE’s current date, time, and time zone (as
previously included as step in commissioning wizard).
• FTP / Telnet — For 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” on page 1-20.
• Change Log Settings — Provides dialog to change the log level of different processes that can
appear in the platform daemon output
• View Daemon Output — Provides window in which you can observe debug messages from plat-
form daemon processes in real time. Also includes ability to pause or load.
• Set Module Filter — Provides dialog to change the module content level of the JACE (as pre-
viously included as step in commissioning wizard).
• Backup — Make a complete backup of all configuration on the connected host platform, including
all station files as well as 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 (Sta-
tion Director), the installed station. If you click this, a confirmation dialog appears.

NiagaraAX-3.x
19
JACE NiagaraAX Install & Startup Guide
Administer the JACE platform Modem configuration
December 5, 2007

If you reboot, your platform connection is lost, and it is typically a minute or more until you can re-
connect 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 but-
ton 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 1-28):
Step 1 Click the Change HTTP Port button.
A dialog appears showing the current HTTP port number highlighted.
Step 2 Type in the new HTTP port number.
Step 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.
Step 4 Double-click the ghosted JACE platform to get the platform login (Authentication) dialog, and enter the
commissioned platform username and password. Click OK.
Step 5 From the platform’s container view, double-click Platform Administrator to return to its view.
Note: Before 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.

Caution Do 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 1-28):
Step 1 Click the FTP / Telnet button.
A dialog shows an enabled checkbox by FTP and Telnet, with TCP/IP port numbers used (Figure 1-29).
Step 2 If not already disabled, click each enabled checkbox to clear.
Step 3 Click Ok.
FTP and Telnet access to the JACE are now disabled.
Note: Even with FTP disabled, you can transfer files between Workbench and the JACE using the platform’s File
Transfer Client view.

Figure 1-29 JACE FTP and Telnet setup dialog

Modem configuration
If equipped with a dialup modem, you use the JACE platform’s Dialup Configuration view to
configure its settings. Complete details are beyond the scope of this document. See the Dialup Configu-
ration section in the Platform Guide.

NiagaraAX-3.x
20
JACE NiagaraAX Install & Startup Guide
Recovery tips IP changes history
December 5, 2007

Recovery tips
During JACE commissioning, it is possible to run into problems. For instance, you may mis-type an IP
address when entering it, and as a result be unable to regain access. In this scenario, there are a couple of
things you should know about:
• IP changes history (a Workbench feature)
• System shell (a feature of any QNX-based JACE)

IP changes history
Your Workbench PC records “before and after” TCP/IP settings made from Niagara platform connec-
tions in an ipchanges.bog file. If necessary, you can review changes from Workbench using the
following procedure.

To review TCP/IP changes made from your Workbench PC

From your PC with Workbench started, do the following:
Step 1 In the Nav tree, expand “My Host” and then “My File System.”
Step 2 Expand “Sys Home” and then “users.”
Step 3 Expand your user folder, then expand “ipchanges.bog.”
Child folders are “date-named” using the following convention:
d<yyyymmddhhmmss> for example, “d20041220171000” for 2004 Dec 20 5:10pm
Step 4 Expand any folder of interest. Underneath each folder are two objects:
• priorValue — TCP/IP settings that existed before this change.
• newValue — TCP/IP settings that existed after this change.
Step 5 Double-click a priorValue or newValue to see settings in the “Tcp Ip Host Editor” (see Figure 1-30).
Note: If you have a platform connection open (to any host), you can also review the history of IP changes made
from your Workbench from its TCP/IP Configuration view. Click the “Audit” button.
This shows your ipChanges.bog folder and all child change entries. Expand a change folder to see a
decoded “modTime” value, for example, “19-Dec-2004 09:50 PM” (vs "d20041219215002").
Double-click a “priorValue” or “newValue” in the view to see the settings in the “Tcp Ip Host Editor.”

Figure 1-30 Accessing ipchanges.bog in Workbench

NiagaraAX-3.x
21
JACE NiagaraAX Install & Startup Guide
System shell Recovery tips
December 5, 2007

System shell
Any QNX-based JACE (JACE-2/6 or JACE-4/5 series) has a “system shell,” providing low-level access to
a few basic platform settings. Using a special JACE power-up mode, you can access this system shell using
a serial connection to the JACE’s onboard RS-232 port. Typical usage is for troubleshooting. However, in
the case of IP address mis-configuration, you can use the system shell in order to regain access to the unit.
Note: Also, depending on your preference, as an alternative to reconfiguring your PC’s IP address in Windows (to
initially connect to a new JACE), you may wish to use the serial system shell to set the JACE’s IP address. If
done as the first step, afterwards you could connect normally (Ethernet/IP) and perform all other Niagara
software installation/platform configuration using Workbench and the Commissioning Wizard. This
method would save you from having to re-configure your PC’s IP address settings in Windows: first to
connect to the JACE as shipped from the factory, and then back again to its original settings.
The following sections provide more details:
• About JACE serial shell mode
• Items needed for serial system shell
• Using serial system shell
• About JACE system shell menu
About JACE serial shell mode
A JACE circuit board has a small 4-pin “Mode connector,” commonly called the mode jumper. To put the
JACE in serial shell mode, you put a 2-pin jumper on certain connector pins, and cycle power to the unit.
Upon system boot, this makes the system shell available at the JACE’s primary RS-232 (COM1) port, at
a pre-defined serial rate (for newer models, this is 115200, 8, N, 1).
Using a serial terminal program such as Windows HyperTerminal, you can then login using platform
credentials and access the system shell menu. After changing platform IP address parameters, a reboot
command from the menu is necessary, and you remove (or reposition) the mode jumper. The JACE
reboots using the changed IP address parameters, and its COM1 port operates as normally configured.
Mode connector Figure 1-31 shows a detail of the Mode connector header (with jumper applied) and
board location for two JACE models: JACE-403 (left) and JACE-545 (right). A JACE-2/6 has a cutout in
the top shield with a label beside the mode connector, showing both “normal” and “serial shell” positions.
For the exact location of the Mode header connector for any JACE model, verify against its specific
mounting and wiring instructions document.

Figure 1-31 JACE-4 and -5 series connector header, showing serial shell jumper position

Note: If using COM1 for any other application, be sure to remove the 2-pin jumper when rebooting from the serial
system shell.
Items needed for serial system shell
Apart from physical access to the JACE, you need the following items:
• A working RS-232 port on your PC.
Usually this is a DB-9 connector with a specific Windows ComN assignment (say Com1 or Com2).
• Terminal emulation software, such as Microsoft HyperTerminal (standard Windows app).
• A serial cable to connect between your PC’s serial ComN port to the JACE’s RS-232 port, plus any
necessary adapter (RJ-45 to DB-9 for example, as JACE-4/5 series RS-232 ports are RJ-45 types).
For JACE-4/5 series, the following parts, listed by Tridium part number, apply:
• 10148 — Adapter, RJ-45 to DB-9, null modem type
• 10181 — Silver satin RJ-45 patch cable, 10 ft. (connects adapter to JACE-4/5 RS-232 port)
Patch cables are also available in lengths 4 ft. (10180) and 25 ft. (10182)
Note: A JACE-2/6’s RS-232 port uses a DB-9 connector. Use a standard DB-9 to DB-9 “null modem”
cable.
• A 2-pin jumper for the JACE’s “Mode” connector.

NiagaraAX-3.x
22
JACE NiagaraAX Install & Startup Guide
Recovery tips System shell
December 5, 2007

Using serial system shell

The following procedure provides steps to use serial system shell.

Caution During serial shell mode, normal COM1 port usage is overridden! Note that some models, such as a JACE-
403, have configurable serial ports, whereby the RS-485 port may be configured as COM1. In this case, that
RS-485 port will not function during serial system shell mode.

To connect to the JACE serial system shell

To connect to the JACE’s system shell using a serial connection, do the following:
Step 1 Connect the necessary serial cable and adapter between the JACE’s RS-232 port and the RS-232 COM
port you are using on your PC. See “Items needed for serial system shell” on page 1-22.
Step 2 On your PC, start HyperTerminal. From the Windows Start menu, this is typically Programs >
Accessories > Communications > HyperTerminal.
Step 3 In the “Connection Description” dialog, type a name for this session.
For example: Jace serial shell
Click OK.
Step 4 In the “Connect to” dialog, use the “Connect using” drop-down list to select the COM port you
are using on your PC, for example COM1.
Click OK.
Step 5 In the Comn Properties dialog, choose the following settings:
• Bits per second: for a JACE-2/6, select 115200. For a JACE-4/5, select 57600.
• Data bits: 8
• Parity: None
• Stop bits: 1
• Flow control: Hardware
Click OK. The HyperTerminal session is now set up.
Step 6 On the JACE circuit board, locate the 4-pin Mode connector and put a 2-pin jumper on the appropriate
pins. See “Mode connector” on page 1-22 for more details.
Step 7 With your HyperTerminal session active, remove power from the JACE, let it cycle down, then reapply
power.
After some number of seconds, text should appear in the HyperTerminal window similar to:
Press any key to stop auto-boot...
Step 8 Do not press any key, wait for the login prompt.
Note: If you did press a key to stop auto-boot, select option 1 (Boot from on-board nand flash).
Step 9 At the login prompt, enter the platform user name, and at the password prompt, the platform password.
See “Platform daemon credentials” on page 1-2 for factory-default values.
The system shell menu appears. See “About JACE system shell menu” on page 1-23.
Step 10 When finished making platform changes from the serial system shell, do the following:
• Remove the 2-pin jumper from the JACE’s 4-pin Mode connector, or place back in “normal” posi-
tion.
• From the system shell menu, select the Reboot option.
Type “y” at the “Are you sure you want to reboot [y/n]” prompt, and press Enter.
Shutdown-related text appears in the HyperTerminal window, and then the connection is dropped.
Step 11 Press the Disconnect button on the HyperTerminal tool bar.
Step 12 Exit from the HyperTerminal application, selecting to Save if you wish to reuse this setup again.
About JACE system shell menu
The system shell of a JACE provides simple, menu-driven, text-prompt access to basic Niagara platform
settings, including IP network settings, platform credentials, system time, and enabling/disabling FTP
and Telnet. Also, you can use it to perform a TCP/IP “ping” from the JACE to another host.
Changes issued in the system shell become immediately effective, except for IP address settings (Update
Network Settings). You must reboot the JACE in order for any changed network settings to become
effective.

NiagaraAX-3.x
23
JACE NiagaraAX Install & Startup Guide
System shell Recovery tips
December 5, 2007

Note: If Telnet is enabled in a JACE, you can also access the JACE’s system shell using a Telnet session. Platform
login is still required (just as with a JACE powered up in serial shell mode).

Caution Be careful when changing items from the system shell, in particular platform account (login credentials)
and network settings. If you change platform login credentials and then lose or forget them, you will need
to contact Systems Engineering for a special recovery routine.

Figure 1-32 shows the main JACE system shell menu.

Figure 1-32 JACE system shell menu (serial shell or Telnet access)
J403 System Shell
--------------------------------------------------------------------
hostid: Qnx-J403-0000-0802-3B42
serial number: -1
build version: 1.18
build date: Tue Feb 1 15:15:03 2005
system time: Mon Feb 21 12:20:49 STD 2005
lan1: inet 192.168.1.98 netmask 0xffffff00 broadcast 192.168.1.255
-------------------------------------------------------------------------
1. Update System Time
2. Update Network Settings
3. Ping Host
4. Enable Ftp
5. Enable Telnet
6. Update Platform Account
7. Reboot

L. Logout

Enter choice:

To select a menu option, you type the associated number (1 to 7) or “L” for logout, then press Enter. For
example, you may choose Update Network Settings to recover IP access, or to set the IP settings of a new
JACE.
Update Network Settings Use this menu option to access most of the same IP networking options as
available in the Commissioning Wizard step (“TCP/IP configuration” on page 1-9). When selected, you
are prompted for each setting sequentially, starting with hostname and ending with subnet mask
(Figure 1-33).

Figure 1-33 Update Network Settings example in JACE system shell

JACE Network Configuration Utility

Enter new value, '.' to clear the field or '<cr>' to keep existing value

Hostname <MyJACE403> : J403a

Domain <Workgroup> :
Primary DNS Server <> :
Secondary DNS Server <> :
Route <192.168.1.1> :
IP address (clear to use DHCP) <192.168.1.148> : 192.168.1.98
Subnet mask <255.255.255.0> :

New network configuration

Hostname : J403a
Domain : Workgroup
Default Gateway : 192.168.1.1
Primary DNS :
Secondary DNS :
IP Address : 192.168.1.148
Subnet Mask : 255.255.255.0

Save the new settings? (Y/n) :

NiagaraAX-3.x
24
JACE NiagaraAX Install & Startup Guide
Document Change Log System shell
December 5, 2007

Document Change Log

Updates (changes/additions) to this JACE NiagaraAX Install and Startup Guide document are listed
below.
• Updated: December 5, 2007
Applied “new look” formatting to print (PDF) version of this document, reducing total page count
yet adding “sidehead” white space to most pages (useful for note taking on printed pages). Included
coverage of JACE-6 among different JACE types, where the term “JACE-2/6” is often used. Revised
licensing discussions to cover related changes in Workbench starting in AX-3.3, including the “local
license database” and “license archive” files (affected sections “Niagara and PC Requirements” on
page 1-2 and “Install license” on page 1-11). For more details on AX-3.3 and later Workbench license
tools, refer to the “License Tools and Files” appendix in the Platform Guide.
• Revised: November 14, 2006
Reversed order of this log to put newest changes at top. Revised licensing discussions to describe typ-
ical use of the licensing server, versus emailed license files (sections “Niagara and PC Requirements”
on page 1-2, “Install license” on page 1-11, “About the Licensing Server” on page 1-13). Updated
many screen captures to reflect more current software.
• Revised: October 25, 2005
Added description for configuration property Locale in the section “PlatformServices properties”
on page 1-17 and updated related Figure 1-26.
• Revised: September 29, 2005
Noted different “factory default” IP address for JACE-2 (different than JACE-4/5 series). Added
more references and notes about the JACE-2 in the sections about “TCP/IP configuration” and “Sys-
tem shell”.
• Revised: July 6, 2005
Various minor edits, including recommendation to create a special subfolder in which to store any
received JACE license files (instead of copying them into your licenses subfolder). Copyright in-
formation moved to front of document.
• Published: June 24, 2005
Updated descriptions and screen captures in several areas of the document, including “Start the
Commissioning Wizard” on page 1-5, “Install/upgrade core software” on page 1-6, “JACE power
monitoring configuration” on page 1-16, and “Administer the JACE platform” on page 1-19. Various
other minor edits also made.
• Draft: June 15, 2005
Globally, the name of Module Manager changed to Software Manager. An upcoming document re-
vision will describe new/changed functionality in this step of the Commissioning Wizard.
• Draft: May 25, 2005
(Initial change log) Same as previous revision.

NiagaraAX-3.x
25
JACE NiagaraAX Install & Startup Guide