Configure the RealPort service

After you have configured RealPort mode on the IX20, you must enable and configure the RealPort service. When this step is complete, all of the serial ports on the IX20 are configured to use the RealPort service.

  1. Log into the IX20 WebUI as a user with full Admin access rights.

  2. On the menu, click System > Configuration > Device Configuration.
  3. Expand Services.
  4. Expand RealPort.
  5. Click Enable to enable the RealPort service.
  6. For RealPort Server Port, enter 1027. This is the default.
  7. For Minimum TLS version, select the minimum TLS version that the RealPort service will accept. The default is TLS version 1.0.
  8. Enable Encryption to enable encryption of data. This is enabled by default.
  9. (Optional) Configure the authentication method the RealPort server uses to authenticate clients.
    1. From the Authentication Method list box, select the Shared Secret - SHA256 option.
    2. For Shared Secret, enter the authentication password to ensure secure communication. Leave this field blank to disable authentication.
  10. Enable Exclusive Mode to ensure that any connection from an IP address is closed when opening a new connection from the same IP address. This disabled by default.
  11. Enable RealPort Keepalive to send RealPort keepalive packets. This is enabled by default.
  12. Enable TCP Port Keepalive to send TCP keepalive packets. This is disabled by default.
  13. Enable Device Initiated connections so users can remotely connect to serial devices as if they had a native COM/TTY port on their PC. This is disabled by default.
  14. Click Apply to save the configuration and apply the change.
  1. Select the device in Remote Manager and click Actions > Open Console, or log into the IX20 local command line as a user with full Admin access rights.

    Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.

  2. At the command line, type config to enter configuration mode:

    > config
(config)>

  3. RealPort is enabled by default. To disable:
    (config)> service realport enable false
(config)>
  4. Set the RealPort server port.
    (config)> service realport port value
(config)>

    where value is the port you want to use for the RealPort service. The default is 1027.

  5. Set the select the minimum TLS version that the RealPort service will accept:
    (config)> service realport minimum_tls_version value
(config)>

    where value is one of:

    • TLS-1_0. This is the default.

    • TLS-1_1

    • TLS-1_2

    • TLS-1_3

  6. Data encryption is enabled by default. To disable:
    (config)> service realport encryption false
(config)>
  7. (Optional) Configure authentication.
    (config)> service realport auth value
(config)>

    where value is one of:

    • none: Do not use authentication. This is the default.

    • shared_secret_sha256: You must also define the authentication password to ensure secure communication. Leave this field blank to disable authentication.
      (config)> service realport auth shared_secret_sha256 value
(config)

      where value is the authentication password.

  8. Exclusive mode is disabled by default. This mode ensures that any connection from an IP address is closed when opening a new connection from the same IP address. To enable:
    (config)> service realport exclusive true
(config)
  9. Use RealPort keepalive to send RealPort keepalive packets. This is enabled by default. To disable:
    (config)> service realport realport_keepalive false
(config)>
  10. TCP port keepalive to send TCP keepalive packets is disabled by default. To enable:
    (config)> service realport tcp_keepalive true
(config)>

  11. Device initiated connections allow users to remotely connect to serial devices as if they had a native COM/TTY port on their PC. This is disabled by default. To enable:

    (config)> service realport device_initiated_enable true
(config)>
  12. Save the configuration and apply the change.
    (config)> save
Configuration saved.
>
  13. Type exit to exit the Admin CLI.

    Depending on your device configuration, you may be presented with an Access selection menu. Type quit to disconnect from the device.