About the 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.

NoteIf 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).

CautionBe 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 can restore the “factory default” platform login credentials—however, you will need to make a serial shell connection, reboot the JACE, and then be careful to press a key at the appropriate time during JACE boot up.

Figure 34 shows an example main JACE system shell menu.

Figure 34. JACE system shell menu (serial shell or Telnet access)

NPM6E System Shell
-------------------------------------------------------------------------
hostid: Qnx-NPM6E-0000-153C-7BE2
serial number: 441603
build version: 2.6.18
build date: built on 2012-05-10 15:00:34
system time: Fri May 25 16:20:52 DST 2012
niagara daemon port: 3011
en0:  inet 192.168.1.123 netmask 0xffffff00 broadcast
192.168.1.255
       inet6
fe80::201:f0ff:fe8d:7a06%en0 prefixlen 64 scopeid 0x2
en1:  <disabled>
-------------------------------------------------------------------------
  1.  Update System Time
  2.  Update Network Settings
  3.  Ping Host
  4.  Enable/Disable Ftp
  5.  Enable/Disable Telnet
  6.  Update Platform Account
  7.  Reboot

  L.  Logout
Enter choice:

To select a menu option, 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). When selected, you are prompted for each setting sequentially, starting with hostname (Figure 35).

NoteIf a JACE with an installed “WiFi option” (at the time of this document, applies only to a JACE-700 controller), note that TCP/IP settings for the WiFi card are not configurable from system shell. Instead, a platform connection to the JACE is needed for the TCP/IP Configuration view, or the equivalent TcpIpPlatformService plugin view in its station’s PlatformServices. For related details, refer to the NiagaraAX JACE WiFi option - Engineering Notes document.

Figure 35. 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 <NPM6E-357714> : NPM6E-EAST
Domain <> : myDomain.net
Primary DNS Server <> : 8.8.8.8
Secondary DNS Server <> : 8.8.4.4
Route <192.168.1.1> :
Primary IPv6 DNS Server <> :
Secondary IPv6 DNS Server <> :
IPv6 Route <> :

NET1 Ethernet interface
  IP address (clear to use DHCP) <> : 192.168.1.44
  Subnet mask <255.255.255.0> :
  Enable IPv6 addressing on this adapter? (Y/n)
:
  IPv6 address (clear to use stateless autoconfiguration)
<> :

Enable NET2 interface? (Y/n) : Y
  IP address (clear to use DHCP) <> : 172.15.16.66
  Subnet mask <255.255.255.0> :
  Enable IPv6 addressing on this adapter? (Y/n)
:
  IPv6 address (clear to use stateless autoconfiguration)
<> :

Confirm new configuration
Hostname        : NPM6E-EAST
Domain          : myDomain.net
Default Gateway : 192.168.1.1
Primary DNS     : 8.8.8.8
Secondary DNS   : 8.8.4.4
Default IPv6 Gateway :
Primary IPv6 DNS     :
Secondary IPv6 DNS   :

NET1 settings:
IP Address          : 192.168.1.44
Subnet Mask         : 255.255.255.0
IPv6 Addressing assigned via Autoconfiguration

NET2 settings:
IP Address          : 172.15.16.66
Subnet Mask         : 255.255.255.0
IPv6 Addressing assigned via Autoconfiguration

Save these settings? (Y/n) :

NoteAfter you save the network settings, they do not become active until you perform a reboot of the JACE controller. You can do this when you return to the main system shell menu, by selecting menu option 7 (see Figure 34).