SSH Channel

Go To Product Page

SSH Channel turns IO Ninja into a versatile SSH client. Use terminal view and work with your server like any other SSH client, or use IO Ninja’s extensive data handling capabilities provided in log view.

Basic Setup

  1. In IO Ninja, click the “New Session” dropdown and select “SSH Channel”.

_images/ssh-channel-new-session.png
  1. Enter the address of the server you want to connect to and press “Connect”.

_images/ssh-channel-address.png
  1. Enter your credentials and press “OK”.

_images/ssh-channel-credentials.png
  1. If required, press the “Show Terminal” button to enter terminal mode.

_images/ssh-channel-show-terminal.png
  1. You may now use SSH Channel as you would any other SSH terminal.

_images/ssh-channel-terminal.png
  1. Adjust settings as needed via the “Settings” button (see “Settings” section below for details).

Settings

_images/ssh-channel-settings.png

Setting

Description

Default

Remote address

Remote address to connect to. Can be specified via IPv4 (127.0.0.1), IPv6 (::1), or a domain name (localhost). Remote address can be suffixed with the remote port after a colon, e.g. ioninja.com:443.

Remote port (default)

Remote port to connect to in cases when a port is not explicitly specified in Remote address.

80

Reconnect

Attempt to reconnect when connection is dropped by the remote node.

False

Reconnect timeout

The delay between reconnect attempts.

3000

Use local address

Bind socket to the specified local address.

False

Adapter

Local network adapter to bind to. Pick one from the list of installed network adapters (or bind to all installed IP4 or all IP6 adapters at once).

Auto

Local port

Local port to bind to. Setting this to 0 auto-selects an available port.

8080

Reuse address

Allow multiple sockets to share the same local address. Maps to the SO_REUSEADDR socket option. Please note, the support and details of implementation for this option are highly platform-specific.

False

TCP Nagle algorithm

Delay transmission to reduce the number of small TCP packets. Maps to the TCP_NODELAY socket option.

False

TCP reset

Drop TCP connections abruptly with a TCP RST packet. Maps to the SO_LINGER socket option.

False

TCP keep-alives

Detect connection loss with TCP keep-alive probes. Maps to the TCP_KEEPALIVE socket option.

False

User name

User name for SSH authentication.

User authentication

SSH authentication method (password or private key)

Password

Private key file

Private key file for SSH authentication.

Remember last password

Re-use the last entered password during subsequent connect attempts.

True

Process type

Type of requested SSH process. See available options.

shell

Process parameter

Parameter to pass to the remote process.

Pseudoterminal

Type of requested pseudoterminal (PTY). Read more about psuedoterminal types here.

xterm

Read block size (B)

The size of each individual read block submitted to the underlying transport.

4KB

RX buffer size (B)

The full size of the incoming data (RX) buffer. Affects read throughput.

16KB

TX buffer size (B)

The full size of the outbound data (TX) buffer. Affects write throughput.

16KB

Keep read block size

Don’t merge read blocks in RX buffer. Incoming data blocks coming in quick succession can be merged together so that IO Ninja writes them to log as a whole. When this option is set to True, blocks are written to the log without merging, i.e., exactly as they are received from the underlying transport.

False

Keep write block size

Don’t merge write blocks in TX buffer. Outbound data blocks sent in quick succession can be merged together before submission to the underlying transport. When this option is set to True, blocks are submitted to the transport without merging, i.e., exactly as they are sent by the Transmit or Script panes.

False

RX buffer full notifications

Toggle warnings in log about the incoming data (RX) buffer getting full.

False

Process Type Options

Option

Description

shell

Starts an interactive terminal session (e.g., ssh user@host).

exec

Runs a single command remotely (e.g., ssh user@host “ls”).

subsystem

Launches a predefined service like SFTP (e.g., sftp user@host).

Note

An example of an adapter dropdown on a typical Windows laptop is shown below:

_images/tcp-proxy-adapters.png