Steps to troubleshoot serial ports on NodeGrid Serial Console

Steps to troubleshoot serial ports on NodeGrid Serial Console

1) Open ssh session and login as admin user

2) Verify serial statistics of specific port: show system/serial_statistics/<port number>

a) Example of port 7

[admin@nodegrid /]# show system/serial_statistics/7

7

port: 7

device name: cisco

speed: 115200

rx bytes: 33829054

tx bytes: 165883

rs-232 signals: RTS DTR

cts shift: 1563

dcd shift: 2520

frame error: 0

overrun: 0

parity error: 0

break: 260

buffer overrun: 0

 

b) ‘Rx bytes’ is not equal zero: target device sent chars to NodeGrid (unknown time)

 

3) Reset serial statistics of specific port and confirm:

a) cd systems/serial_statistics

b) reset_statistics <port number>

c) show <port number>

d) Example for port 7:

[admin@nodegrid /]# cd system/serial_statistics/

[admin@nodegrid serial_statistics]# reset_statistics 7

[admin@nodegrid serial_statistics]# show 7

7

port: 7

device name: cisco

speed: 115200

rx bytes: 0

tx bytes: 0

rs-232 signals: RTS DTR

cts shift: 0

dcd shift: 0

frame error: 0

overrun: 0

parity error: 0

break: 0

buffer overrun: 0

 

4) Disable specific managed device, and commit

a) set /settings/devices/<device_name>/access/ mode=disabled

b) commit

c) Example for device ‘cisco’ (that is in serial port number 7 as showed in serial-statistics)

[admin@nodegrid /]# set settings/devices/cisco/access/ mode=disabled

[+admin@nodegrid /]# commit

 

5) Open another session to NodeGrid and log-in as root

a) Launch ‘microcom’ at shell prompt that opens communication with the serial port:

microcom -s <speed> /dev/ttyS<port_number>

b) Try to communicate with device (to close microcom type Ctrl-X)

c) Example for port number 7 - speed 115200 (as showed in serial statistics)

root@nodegrid:~# microcom -s 115200 /dev/ttyS7

cisco login:

 

NOTE: If output shows garbage, stop microcosm (Ctrl-X) and try again with different speed.


6) Verify port serial statistics in admin session (step 2)

a)  show system/serial_statistics/<port number>

b) Example for port 7 - no problem (rx bytes not equal 0 and there is no error)

[admin@nodegrid /]# show /system/serial_statistics/7

7

port: 7

device name: cisco

speed: 115200

rx bytes: 282

tx bytes: 5

rs-232 signals: RTS CTS DTR DSR CD

cts shift: 3

dcd shift: 2

frame error: 0

overrun: 0

parity error: 0

break: 0

buffer overrun: 0

 

7) Enable specific managed device after, and commit

a) set /settings/devices/<device_name>/access/ mode=enabled

b) commit

c) Example for device ‘cisco’ (that is in serial port number 7 as showed in serial-statistics)

[admin@nodegrid /]# set settings/devices/cisco/access/ mode=enabled

[+admin@nodegrid /]# commit

 


 

Results:

1. If serial statistics shows CTS, DSR or CD signals, a device is connected and it is on.
If none of these signals are shown, there may be a device connected that does not implement all RS232 signals. This is common in some network switches.

2. If there is no output when executing microcom and the statistics shows 0 rx-bytes and no errors:
- the cable is wrong, or
- the target device is off, or
- there is no device connected.

3. Errors (including buffer overrun) indicates a mismatch in the serial port config (i.e. parity, data bits, stop bits).



    • Related Articles

    • How to Configure Nodegrid Serial Ports

      To configure the serial ports of your Nodegrid Serial Console, follow the guideline steps below.   WebUI Log in as admin to the Nodegrid Serial Console Web interface. Go to Managed Devices page. Select the serial ports you want to configure, or check ...
    • Nodegrid Serial Console: Pinouts, Cables and Connectors

      The tables below show the serial port pinout information of the NSC TxxR (Cisco Pinout) and NSC Txx (Legacy Pinout).  NSC TxxR - Cisco-like Pinout Pin Signal Name Input/Output 1 CTS IN 2 DCD IN 3 RxD IN 4 GND N/A 5 GND N/A 6 TxD OUT 7 DTR OUT 8 RTS ...
    • Power Control within Serial Session

      Nodegrid Serial Console features the Power Control integration which gives authorized users the ability to power on, power off and reset/reboot the serial devices, within the serial session, by using an escape character (default escape character is ...
    • How to Telnet and SSH to the Nodegrid Serial Ports

      Note: by default, Telnet access is turned off with your Nodegrid Serial Console. Authorized users can use Telnet or SSH to connect directly to the console of a managed device if all of the following are true: Telnet / SSH protocol is enabled under ...
    • How to build the set-up for Virtual Serial Ports communicating to an end device, via the Nodegrid OS

      Abstract: In the industry, some legacy applications impose to use serial ports (COM) to interface with the industrial automates. In this article, we will study a set-up in which a desktop emulates a virtual serial COM, and conveys the connection via ...