Advanced Portmanager PM Shell Guide

The Portmanager program allows you to access any serial port on the console server using pmshell commands. It

  • Routes network connection to serial ports

  • Checks permissions

  • Monitors and logs all the data flowing to/from the ports

  • Allows you to run power commands if the serial port is associated with a PDU outlet.

Running pmshell

pmshell provides an environment that allows you to access and interact with serial ports via a number of command sequences. It lets you navigate between ports using the chooser command (~m). For example, you can use pmshell to connect to port 8 via the portmanager via the following command line sequence.

# pmshell -l port08

pmshell Commands

When running pmshell there are a number of command sequences that you can use that begin with the ~ key.

Note: Note: If you are connected to pmshell via SSH, you must add an additional ~ escape sequence.

options Name Result
~c   The Single Session feature can be enabled or disabled by editing the single_session field in a given port. When a user port level administration access is logged in via pmshell, the port configuration menu can be accessed via any port by pressing the escape character (~ by default) followed by c (~c).

~b

break

Generates a BREAK on the serial port
(if you're doing this over ssh, you'll need to type "~~b").

~h

portlog

Generates a history on the serial port. Displays the traffic logs for the port - must have port logging enabled.

~.

quit

Quits pmshell.

~p power Opens the power menu for the port. The port must be configured for a PDU
~u   Opens the list of user sessions, select by number to disconnect.
~m chooser Connects to the port menu - go back to the serial port selection menu.
~? pmhelp Displays help message.