Distech Controls EC-BOS-9 User Manual

August 14, 2023 37
Chapter 4 System shell
Topics covered in this chapter
♦ About the EC-BOS-9 system shell menu
♦ Connecting to the controller system shell
♦ Updating network settings using EC-BOS-9 system shell
♦ Updating system time using the system shell (EC-BOS-9)
All controllers have a system shell that provides low-level access to a few basic platform settings. Using a spe-
cial power-up mode and a serial connection via an appropriate type USB cable connected to the controller, you
can access this system shell from your PC. System shell is also available via SSH (Secure Shell) provided that
SSH is enabled in the controller.
Typical usage is for initial controller setup, troubleshooting, or to create or restore a backup. Also, in the case of
IP address mis-configuration, you can use the serial system shell to regain access to the unit.
Depending on your preference, you may wish to use the serial shell to set the controller IP address as an alter-
native to reconfiguring your PC’s IP address in Windows (to initially connect to a new controller). If done as the
first step, afterwards you could connect normally (Ethernet/IP) and perform all the other EC-Net software instal-
lation and platform configuration using EC-Net 4 Pro 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 controller
as shipped from the factory, and then back again to its original settings.
The following topics provide more details.
About the EC-BOS-9 system shell menu
The system shell of the controller provides simple, menu-driven, text-prompt access to basic EC-Net platform
settings, including IP network settings, platform credentials, system time, and enabling/disabling SFTP/SSH
and Telnet, as well as creating or restoring system backups. Also, you can use it to perform a TCP/IP ping from
the controller to another host.
Changes issued in the system shell become immediately effective, except for IP address settings (Update Net-
work Settings). You must reboot the controller for any changed network settings to become effective.
If SSH is enabled in the controller, you can also access the controller’s system shell using a remote terminal
session using SSH. Platform login is still required (just as with the controller powered up in serial shell mode).
CAUTION: Be careful when changing items from the system shell, in particular platform account (login creden-
tials, system passphrase) and network settings. If you change platform login credentials and then lose or forget
them, you may need to restore the factory default settings and possibly lose any non-backed up data.
Following, is an example of the system shell menu when connected to a EC-BOS-9.
Figure 3 System shell menu (serial shell or Telnet access)
---------------------------------------------------
1 Update System Time
2 Update Network Settings
3 Ping Host
4 System Diagnostic Options
5 Change Current User Password
6 Change System Passphrase
7 Create SD Backup
8 Restore SD Backup
9 Reboot
L Logout

Distech Controls EC-BOS-9 Specifications

General

Brand	Distech Controls
Model	EC-BOS-9
Category	Controller
Language	English