Skip to content

Serial Port Forwarding

Terminal App: Terminal > Forward

Use the Serial Port Forwarding feature to make the console port of the managed device available on a local workstation via reverse SSH tunnel. In order to utilize this feature, a user must have the terminal privilege.

An SSH client with reverse tunnel capabilities is required to use this feature. Supported clients include PuTTY and the native Lantronix Terminal Application on the Control Center.

Prior to setting up serial port forwarding, initialize the Local Manager port with the appropriate device driver via the config init command. Refer to the appropriate device configuration guide for information.

About Connections

  • Only one TCP connection is allowed per forwarded port. Subsequent connections will fail until the first connection is exited.
  • The TCP connection can be terminated by disabling the forward setting in the Lantronix Terminal Application or by closing the SSH client.
  • Connections to forwarded ports are subject to the same idle timeouts as normal terminal sessions. The idle counter is reset if data is passed over the TCP connection.

Usage

To use the Terminal Application on the Control Center, connect to the web interface of the Control Center and navigate to the Inventory page. Select a Local Manager from the Inventory tree to bring up its Summary page. Launch the Terminal Application by clicking the chevron next to the SSH button and selecting the Open native terminal option on the SSH menu. Once the terminal loads, authenticate with the device and log in.

In the menu bar, click on Terminal and select Forward.

Lantronix Control Center - Terminal Forward

Mark the checkbox next to the port you wish to forward. By default, the application will forward to a random local port. To specify a port, delete random and enter the desired port.

Lantronix Control Center - Terminal Forward Settings

Click Apply to save your settings. If a random port was assigned, it will be displayed and highlighted in green.

Lantronix Control Center - Terminal Forward Settings

If you specified an invalid port (in use or conflicting), it will be highlighted in red.

Lantronix Control Center - Terminal Forward Settings

Click Close to return to your SSH session.

Navigate to the desired port and use the terminal forward command to start forwarding.

Lantronix Control Center - Terminal Forward

Once the message Console session forwarded displays, connect to the forwarded session on your local machine. Navigate to 127.0.0.1 (localhost) on the port specified earlier using your workstation application such as a browser or element manager.

Anything typed to the forwarded port will be displayed in the original terminal session.