Configuring the Telnet Listener

How to:

Reference:

The Telnet listener can be configured much like any other listener in iWay Service Manager. Once the listener is configured, it is then assembled and built into a channel. No other components are necessary for this channel. The channel must be active for the Telnet Management Connection to be used.

To prevent conflicts and accidental connections, iWay strongly suggests specifying a unique port number (instead of the standard default port number 23) during the configuration process.


Top of page

x
Procedure: How to Configure the Telnet Listener

To configure the Telnet listener:

  1. Ensure that iWay Service Manager is running.

    On Windows, you can start iWay Service Manager by clicking Start, selecting Programs, iWay 6.1 Service Manager, and then Start Service Manager for the configuration you are currently using.

    For more information on starting and stopping iWay Service Manager, see the iWay Service Manager User's Guide.

  2. Open a browser window and point to the following URL:
    http://host:port/ism

    where:

    host

    Is the host machine on which iWay Service Manager is installed.

    port

    Is the port on which iWay Service Manager is listening. The default port is 9999.

    On Windows, alternatively, you can click Start, select Programs, iWay 6.1 Service Manager, and then click Console.

    A login dialog box opens.

  3. Type a user name and password for the configuration you are using, and click OK.

    The iWay Service Manager Administration Console opens.

  4. Click Registry in the top pane, and then click Listeners in the left pane.

    The Listeners pane opens.

    The table that is provided lists all the previously configured listeners and a brief description for each.

  5. Click Add.

    The Select listener type pane opens.

  6. Select Telnetd from the Type drop-down list and click Next.

    The Configuration parameters for the Telnetd listener pane opens.

    Note: The parameters prefixed with a (*) in the listener configuration pane are required.

  7. Provide the appropriate values for the Telnetd listener parameters.

    For more information, see Telnet Listener Configuration Parameters.

  8. Click Next.

    You are returned to the Select listener type pane.

  9. Enter a name for the TCP listener and description (optional).
  10. Click Finish.

    You can now use this listener as part of your channel configuration where the business logic will be applied to the received messages.


Top of page

x
Reference: Telnet Listener Configuration Parameters

The following table lists and describes parameters for the Telnet listener.

Parameter

Description

Telnet

Port

Telnet port for receipt of Telnet requests.

Note: To prevent conflicts and accidental connections, iWay strongly suggests specifying a unique port number (instead of the standard default port number 23) during the configuration process.

Local bind address

Local bind address for multi-homed hosts. This parameter value is usually not specified.

Timeout

Period in seconds of inactivity after which the connection is timed out. The default value is 600 seconds.

Security

Allowable Clients

If supplied, only messages from this list of fully qualified host names and/or IP addresses are accepted. Accepts comma-separated list or use the FILE() function.

Authentication Realm

Name of a configured authentication realm to validate logins. For full access to management commands, the user must be granted administrative privileges (admin role). If an authentication realm is not supplied, the logins will be delegated to the user database of the web console.

Secure Connection

Use SSL to secure the channel. By default, this parameter is set to False.

SSL Context Provider

Named iWay Security provider for SSL Context.

SSL Client Authentication

If set to True, the authentication will be required from the client.


iWay Software