10000 Woodward Avenue
Woodridge, Illinois 60517
+1 773-869-1776
+1 (773) 869-1329
United States
Contact Us

Configuring Console Servers from the Command Line

Users with Linux or programming experience may be more comfortable configuring and operating the console server from the command line. Only Administrators (users in the admin group) have command line access.

Eaton console servers run an embedded Linux operating system. Below are the standard Linux (and BusyBox) commands and some Eaton commands that are in the default build tree. Use these commands to configure the console server, as well as monitor and manage attached serial console and host devices:

addgroup *Add a group or add a user to a group
adduser *Add a user
agettyalternative Linux getty
arpManipulate the system ARP cache
arpingSend ARP requests/replies
bashGNU Bourne-Again SHell
busyboxSwiss army knife of embedded Linux commands
cat *Concatenate FILE(s) and print them to stdout
chatUseful for interacting with a modem connected to stdin/stdout
chgrp *Change group ownership
chmod *Change file access permissions
chown *Change file owner and group
configEaton tool to manipulate and query the system configuration from the command line
cp *Copy files and directories
date *Print or set the system date and time
dd *Convert and copy a file
deluser *Delete user from the system
df *Report filesystem disk space usage
dhcpdDynamic Host Configuration Protocol server
discardNetwork utility that listens on the discard port
dmesg *Print or control the kernel ring buffer
echo *Print the specified ARGs to stdout
eraseTool for erasing MTD partitions
eraseallTool for erasing entire MTD partitions
false *Do nothing, unsuccessful
findSearch for files
flashwWrite data to individual flash devices
flatfsdDaemon to save RAM filesystems back to FLASH
ftpInternet file transfer program
gen-keysSSH key generation program
getopt *Parses command options
gettydGetty daemon
grep *Print lines matching a pattern
gunzip *Compress or expand files
gzip *Compress or expand files
hdASCII, decimal, hexadecimal, octal dump
hostname *Get or set hostname or DNS domain name
httpdListen for incoming HTTP requests
hwclockQuery and set hardware clock (RTC)
inetdNetwork super-server daemon
inetd-echoNetwork echo utility
initProcess control initialization
ipShow or manipulate routing, devices, policy routing and tunnels
ipmitoolLinux IPMI manager
iptablesAdministration tool for IPv4 packet filtering and NAT
ip6tablesAdministration tool for IPv6 packet filtering
iptables-restoreRestore IP Tables
iptables-saveSave IP Tables
kill *Send a signal to a process to end gracefully
ln *Make links between files
loginBegin session on the system
loopbackEaton loopback diagnostic command
loopback1Eaton loopback diagnostic command
loopback2Eaton loopback diagnostic command
loopback8Eaton loopback diagnostic command
loopback16Eaton loopback diagnostic command
loopback48Eaton loopback diagnostic command
ls *List directory contents
mailSend and receive mail
mkdir *Make directories
mkfs.jffs2Create an MS-DOS file system under Linux
mknod *Make block or character special files
more *File perusal filter for crt viewing
mount *Mount a file system
msmtpSMTP mail client
mv *Move (rename) files
ncTCP/IP Swiss army knife
netflashUpgrade firmware on ucLinux platforms using the blkmem interface
netstatPrint network connections, routing tables, interface statistics, etc.
ntpdNetwork Time Protocol (NTP) daemon
pgrepDisplay process(es) selected by regex pattern
pidofFind the process ID of a running program
pingSend ICMP ECHO_REQUEST packets to network hosts
ping6IPv6 ping
pkillSends a signal to process(es) selected by regex pattern
pmchatEaton command similar to the standard chat command (via portmanager)
pmshellEaton command similar to the standard tip or cu but all serial port access is directed via the portmanager.
pmusersEaton command to query portmanager for active user sessions
portmanagerEaton command that handles all serial port access
portmapDARPA port to RPC program number mapper
pppdPoint-to-Point protocol daemon
ps *Report a snapshot of the current processes
pwd *Print name of current/working directory
reboot *Soft reboot
rm *Remove files or directories
rmdir *Remove empty directories
routedShow or manipulate the IP routing table
routefIP Route tool to flush IPv4 routes
routelIP Route tool to list routes
rtacctApplet printing /proc/net/rt_acct
rtmonRTnetlink listener
scpSecure copy (remote file copy program)
sed *Text stream editor
setmacSets the MAC address
setserialSets and reports serial port configuration
showmacShows MAC address
sleep *Delay for a specified amount of time
smbmntHelper utility for mounting SMB file systems
smbmountMount an SMBFS file system
smbumountSMBFS umount for normal users
snmpdSNMP daemon
snmptrapSends an SNMP notification to a manager
sredirdRFC 2217-compliant serial port redirector
sshOpenSSH SSH client (remote login program)
ssh-keygenAuthentication key generation, management, and conversion
sshdOpenSSH SSH daemon
sslwrapProgram that allows plain services to be accessed via SSL
sttyChange and print terminal line settings
stunnelUniversal SSL tunnel
sync *Flush file system buffers
sysctlConfigure kernel parameters at runtime
syslogdSystem logging utility
tar *The tar archiving utility
tcShow traffic control settings
tcpdumpDump traffic on a network
telnetdTelnet protocol server
tftpClient to transfer a file from/to tftp server
tftpdTrivial File Transfer Protocol (tftp) server
tipSimple terminal emulator/cu program for connecting to modems and serial devices
topProvide a view of process activity in real time
touch *Change file timestamps
traceroutePrint the route packets take to network host
traceroute6Traceroute for IPv6
true *Returns an exit code of TRUE (0)
umount *Unmount file systems
uname *Print system information
usleep *Delay for a specified amount of time
vconfig *Create and remove virtual ethernet devices
vi *Busybox clone of the VI text editor
wShow who is logged on and what they are doing
zcat *Identical to gunzip -c

Commands marked with a * come from BusyBox. Others are generic Linux commands. For most commands, the -h or --help argument provides a brief runtime description.

Use the ls command to view all the commands available in the /bin directory in your console server.

Eaton Custom Command Line Utilities

Some Eaton custom command line utilities are included to simplify configuration and ensure the changes are stored in the console server's flash memory.

  • config allows manipulation and querying of the system configuration from the command line. A new configuration can be activated by running the relevant configurator, which performs the action necessary to make the configuration changes live.
  • portmanager provides a buffered interface to each serial port. It is supported by the pmchat and pmshell commands, which ensure all serial port access is directed via the portmanager.
  • pmpower is a configurable tool for manipulating remote power devices that are serially or network connected to the console server.
  • SDT Connector is a Java client applet that provides point-and-click SSH tunneled connections to the console server and managed devices.

For information about these commands, see the console server Owner's Manual.

Other CLI Commands

Some CLI commands are related to other open source tools embedded in the console server:

  • powerman provides power management for many preconfigured remote power controller (RPC) devices. For CLI details refer to
  • Network UPS Tools (NUT) provides reliable monitoring of UPS and PDU hardware and ensures safe shutdowns of connected systems (with a goal to monitor every kind of UPS and PDU). For CLI details refer to
  • Nagios is a popular enterprise-class management tool that provides central monitoring of the hosts and services in distributed networks. For CLI details refer to
  • The Linux kernel in the console server also supports GNU bash shell script, enabling the Administrator to embed custom scripts.

For information about these commands, see the console server Owner's Manual.

Connecting to the CLI

Administrators can log into the console server at the command line in two ways:

  1. Use SSH/Telnet to connect over the network.
    • Make sure there is a route connecting to the console server's Ethernet port. Then, direct the terminal emulator program to this IP address. We recommend using SSH as the security protocol when connecting to (and through) console servers, particularly when connecting over the Internet or other public network.
  2. Connect to the local console serial port (directly or via a modem).
    • If connecting directly, use a serial cable between the console server's Local/Modem port and the terminal device. Configure the serial connection of the "terminal" device/program you are using to 115200bps, 8 data bits, no parity, one stop bit and software (Xon-Xoff) flow control.
    • To set up a dial-in connection, first activate and configure a ppp connection. Authenticated remote dial-in access can also be configured on the NetworkDial In menu.

Once connected, press Return a couple of times to log into the console server. A request for a login user name and password will appear. After you enter that information, a hash # command line prompt appears.

The factory default login user name/password is root/default. This can be used for initial login; however, this default password should be changed and a new admin group user should be set up and used for future CLI access.

Setting Up a New Administrator User

Any Administrator can use the Serial & NetworkUsers & Groups menu to set up new users as members of the admin group.

configuring from the command line

Membership in the admin group provides the new user with full Administrator privileges, so they can access the console server using any of the services which have been enabled (in SystemServices). If only HTTPS has been enabled, the Administrator will only be able to access the console server using HTTPS. After login, however, they can reconfigure the console server settings (for example, to enable HTTP/Telnet for future access). They can also access any of the connected Hosts or serial port devices using any of the services that have been enabled for these connections. The Administrator can reconfigure the access services for any Host or serial port, so only trusted users should have Administrator access.

Need help with your purchase?
We're always available to help with questions, including product selection, sizing, installation and product customization. Call us at +1 773-869-1776 or email