set dirp

Purpose

Configures Device-Initiated RealPort (DIRP) and displays current DIRP settings. A normal RealPort session/connection consists of a driver running on Windows, Unix, or Linux to connect to the Digi device to initiate RealPort sessions. This type of RealPort connection requires the driver to have the IP address of the Digi device, and that the Digi device has a static IP address. However, there are situation when such isn’t possible, typically because the Digi device is set up to use DHCP, in which case, the IP address can change. Or, the Digi device may be behind a firewall, and cannot be accessible from the Windows, Unix, or Linux driver’s side.

Device-Initiated RealPort changes which side of the connection creates the first connection for RealPort. Instead of the driver initiating the connection, the Digi device initiates the connection to the Windows, Unix, or Linux driver. Such a connection resolves both the DHCP and “behind the firewall” issues.

Note The driver running on the PC must support Device-Initiated RealPort. The only driver that does so is the Windows RealPort driver. Digi Linux and Unix drivers do not support Device-Initiated RealPort.

Required permissions

For Digi products with two or more users, permissions must be set to set permissions s-network=read to display settings, and set permissions s-network=rw to display and configure settings. See set permissions for details on setting user permissions for commands.

Syntax

Configure Device-Initiated RealPort connections

set dirp [range=1-20]
  [state={on|off}
  [host={hostname|ip address}]
  [port=tcp port number]
  [retry=connect retry value in seconds]
  [encrypt={on|off}]

Display current Device-Initiated RealPort connection settings

set dirp

Options

range=1-20

Allows you to specify up to 20 independent Device-Initiated RealPort connections for use by the Digi device.

state={on|off}

Enables or disables Device -Initiated RealPort.

host={hostname|ip address}

The hostname or IP address of the Windows system that is running a RealPort driver in which they want the device to connect to.

port=tcp port number

The tcp port number that should be connected to on the Windows system specified by the host option.

retry=connect retry value in seconds

How often the Digi device should attempt to create the connection to the Windows system.

encrypt={on|off}

Determines whether Encrypted RealPort should be used (on) or not used (off) when the connection is made to the Windows system that is running the RealPort driver.

Examples

#> set dirp range=1 state=on host=WindowsServer1.digi.com port=8771 retry=30 encrypt=off