Wavelink ConnectPro Reference Guide Version 4.4.
ii Copyright © 2012 by Wavelink Corporation All rights reserved. Wavelink Corporation 10808 South River Front Parkway, Suite 200 South Jordan, Utah 84095 Telephone: (801) 316-9000 Fax: (801) 316-9099 Email: customerservice@wavelink.com Website: http:\\www.wavelink.com Email: sales@wavelink.com No part of this publication may be reproduced or used in any form, or by any electrical or mechanical means, without permission in writing from Wavelink Corporation.
iii Table of Contents Chapter 1: Introduction 1 Functional Overview of ConnectPro 1 ConnectPro Features 2 Chapter 2: Installing the ConnectPro Server 3 Installation Requirements 3 Installing ConnectPro on Windows 3 Installing ConnectPro on Linux 4 Installing ConnectPro on AIX 5 Uninstalling ConnectPro 5 Chapter 3: Configuring the ConnectPro Server Configuring ConnectPro with the Configuration Wizard Configuring ConnectPro from the Text Window Configuration Keywords 7 8 10 11 Proxy Servi
iv Managing ConnectPro HTTP Settings 41 Deleting Stored Public Keys 43 Network Scenarios 44 ConnectPro as a Console Application 47 Wavelink Contact Information 50
Chapter 1: Introduction 1 Chapter 1: Introduction The purpose of this document is to provide an explanation of the installation, configuration, and use of ConnectPro. ConnectPro (known in earlier versions as TermProxy) is designed to extend the life of sessions between Terminal Emulation Clients and hosts. Under normal operating circumstances, a device might go idle, enter power-saving mode, or move out of RF range and prematurely terminate the session between the Client and the host.
Chapter 1: Introduction 2 ConnectPro Process ConnectPro Features The following list describes additional features that ConnectPro offers: • Web Interface. ConnectPro offers a web interface that allows you to configure ConnectPro, view log files, view data captures, delete Client-proxy or proxy-host sessions, and review the status of proxy services. Sessions with the ConnectPro web interface can be encrypted using SSL, TLS, or SSH. • Thousands of Concurrent Sessions.
Chapter 2: Installing the ConnectPro Server 3 Chapter 2: Installing the ConnectPro Server ConnectPro is available for Microsoft Windows 7, Windows 2003 or 2008 Server, Windows XP Professional, Linux, and AIX. All files required to install and operate ConnectPro can be obtained from the Wavelink Web site.
Chapter 2: Installing the ConnectPro Server 4 To install ConnectPro: 1 Obtain and save the ConnectPro installation program to the target host system. 2 Double-click the executable to launch it. The Wavelink TermProxy Setup Wizard appears. 3 Click Next. The License Agreement dialog box appears. 4 Click I Agree to accept the terms of the license agreement. The Choose Install Location dialog box appears.
Chapter 2: Installing the ConnectPro Server rpm -i [filename] ConnectPro is installed on the host system. The installer launches the ConnectPro TermProxy initial installation configuration wizard in a web browser. Follow the steps in Configuring ConnectPro with the Configuration Wizard on page 8 in order to configure the ConnectPro server. 3 To start ConnectPro, use the following command: /etc/init.d/termproxy start 4 To stop ConnectPro, use the following command: /etc/init.
Chapter 2: Installing the ConnectPro Server To uninstall ConnectPro from Linux: • Use the following command to uninstall the .rpm file: rpm -e --allmatches termproxy ConnectPro is removed from the host system. To uninstall ConnectPro from AIX: • Use the following command to uninstall the .rpm file: rpm -e --allmatches termproxy ConnectPro is removed from the host system.
Chapter 3: Configuring the ConnectPro Server 7 Chapter 3: Configuring the ConnectPro Server Configure the ConnectPro server after installation from the web interface. The web interface allows you to define the Client-proxy and host-proxy connections, modify the ConnectPro web server connection information, and modify the logging level. To access the web interface: 1 Open a web browser and type the address and port of the ConnectPro web server in the address bar. Example: http://192.168.1.
Chapter 3: Configuring the ConnectPro Server 8 This page provides options for configuring the ConnectPro server. You can change values in the text window or click Wizard to launch the Configuration Wizard, which provides additional help in configuring ConnectPro. • For a description of options available in the text window, see Configuring ConnectPro from the Text Window on page 10. • For information on using the Wizard, see Configuring ConnectPro with the Configuration Wizard on page 8.
Chapter 3: Configuring the ConnectPro Server 9 • Terminate the connection if the host sends data while no client is connected to TermProxy. This option disconnects the proxy-host connection if the Client is unavailable for information sent from the host. • Reconnect String. Sends a specific keypress to the host when the Client reconnects. For example, the Client can send a keypress that will navigate to a main menu when the Client reconnects. When you have configured the options, click Next.
Chapter 3: Configuring the ConnectPro Server 10 • HTTP Address. This is the address or range of addresses allowed to access the ConnectPro web interface. • HTTP Port. The port that the HTTP server listens on for requests to access the web interface. • HTTP User Name. A user name required to access the web interface. • HTTP/Administrative Password. A password required to access the web interface. • Use HTTPS (SSL) instead of HTTP (clear).
Chapter 3: Configuring the ConnectPro Server 11 When you use the text window to configure the ConnectPro server, each configuration is specified by keyword/value pairs separated by white space (either spaces or tabs). If a value (such as a passphrase) contains a space, the entire value should be enclosed in quotation marks (" "). The keywords and values are not case-sensitive, but each pair should begin on its own line. You may use # or // to indicate that the remainder of the line is a comment.
Chapter 3: Configuring the ConnectPro Server Parameter Description proxyservice [proxyservice name] Specify a name for the proxy service. The name is used in the ConnectPro user interface and log file. This is a required parameter. listen [ipaddr:port] Specify the interface and port number on which the proxy server should listen for Client connections. 12 Use 0.0.0.0 to specify that the proxy server should listen for a specific port number on all local interfaces. For example, the value 0.0.0.
Chapter 3: Configuring the ConnectPro Server 13 NOTE: You cannot define a connection to support both SSL and custom encryption. Host Service A host service entry defines the connections between the ConnectPro server and the host(s).
Chapter 3: Configuring the ConnectPro Server Parameter 14 Description If off is specified, the Client-host connection will be allowed and warning messages will be sent to the Client. timeout [min] Specify the amount of time before ConnectPro terminates the proxyhost session. Specify a value of 0 to allow sessions to remain open indefinitely. This time begins once the Client-proxy connection closes (after the Client timeout expires). This parameter is optional and will default to 15m.
Chapter 3: Configuring the ConnectPro Server Parameter Description template [regular expression] The stationid-template extracts the workstation ID from the initial outbound screen buffer of an IBM AS/400 Telnet server session and presents the ID in the active session list, alongside the Client IP address. The search pattern must be in the form of a regular expression containing a single tagged expression. 15 Example: Display [ .]+:\s+(.
Chapter 3: Configuring the ConnectPro Server Parameter 16 Description The following is a list of the log level settings. The numbers in parentheses can be used in place of the name. CRITICAL (1) — Catastrophic error logging only ERRORS (2) — Errors only WARNING (3) — Errors and warnings INFO (4) — Errors, warnings, informational DEBUG (5) — Trouble-shooting mode VERBOSE (6) — All logging information Capture ConnectPro can capture proxy communication information.
Chapter 3: Configuring the ConnectPro Server Parameter Description restart [time] Specify a comma-delimited list of times that ConnectPro will automatically restart. 17 Enter times using the following format: HH:MM[a|p]. If there is no 'a' or 'p' following the time (representing AM or PM), the time is assumed to be in a 24hour format. Specify a weekly time by preceding the time with the day of the week. Examples: 10:00P, 06:00A, MONDAY22:30 This is a required parameter.
Chapter 3: Configuring the ConnectPro Server Configuring Reconnect Strings To configure a reconnect string, place a % character before each hex code value. Each hex code character is represented by a two-digit number. 5250 Reconnect String Examples The following are examples reconnect strings for 5250 emulation.
Chapter 3: Configuring the ConnectPro Server • To send a reconnect command for the VT100 or VT220 F11 key: %1B[23~ This calls a new screen upon reconnect. The following list provides some common VT escape values. %00 Ctrl-A %01 Ctrl-B %02 Ctrl-C %03 Ctrl-D %04 Ctrl-D %05 Ctrl-E %06 Ctrl-F %07 Ctrl-G a.k.a. Bell %08 Ctrl-H a.k.a. Backspace %09 Ctrl-I a.k.a. Tab %0A Ctrl-J a.k.a. Line Feed or Newline %0B Ctrl-K %0C Ctrl-L a.k.a. Form Feed or Redraw Screen %0D Ctrl-M a.k.a.
Chapter 3: Configuring the ConnectPro Server 20 %14 Ctrl-T %15 Ctrl-U %16 Ctrl-V %17 Ctrl-W %18 Ctrl-X %19 Ctrl-Y %1A Ctrl-Z Sometimes used as EOF or suspend signal %1B Escape %25 Percent The actual % character %7F Delete Translating Table Statements This is the byte-mapping table definition. Any number of mapping tables can be defined, as long as each one has a unique table name. Usually a different table is used for inbound (to host) and outbound (from host) translation.
Chapter 3: Configuring the ConnectPro Server Table %00=? ==%20 1=%f1 21 Table1 //Replaces a NUL with a question mark //Replaces an equal sign with an ASCII blank //Replaces an ASCII 1 with an EBCDIC 1 Validating Configuration Entries Once you have entered the ConnectPro configurations, validate your entries to ensure accuracy. To validate configuration entries: • Click the Validate button at the bottom of the Stored Configuration page.
Chapter 3: Configuring the ConnectPro Server 22 Sample Configuration Description timeout 5 The Client-proxy connection will time out after five minutes of inactivity. ssl on Mobile devices must use SSL to access a host service using the TelnetOne proxy service. hostservice The host service name is TelnetHost. TelnetHost is referenced within the proxy service TelnetOne. connect 192.168.1.1:23 When a mobile device connects to the proxy service “TelnetOne” using the a host profile that contains 192.
Chapter 3: Configuring the ConnectPro Server 23 Sample Configuration Description proxyservice TelnetHosts The proxy service name is TelnetHosts. listen 20.30.40.50:4430 The proxy service listens for mobile devices at 20.30.40.50 and port 4430. server "Host AS400", "Host VT" The proxy service services two host services named "Host AS400" and "Host VT". hostservice "Host AS400" The first host service name is "Host AS400". connect 206.125.145.
Chapter 3: Configuring the ConnectPro Server 24 Sample Configuration Description log level INFO The log level entry instructs the proxy server to log information at the INFO level only. httpservice 201.120.140.10:4428 The http service entry instructs the proxy server to bind the HTTP server to the IP address 201.120.140.10 on port 4428. ssl on The ssl entry instructs the proxy server to use the SSL protocol. Timeout is not specifically defined in this sample configuration.
Chapter 4: Configuring the Client for ConnectPro Chapter 4: Configuring the Client for ConnectPro To configure a TE Client to use ConnectPro, modify both the Host tab and the TermProxy 1 tab in the Host Profiles dialog box of the Terminal Emulation configuration utility. If you are using SSL/TLS or SSH in your environment, these also must be configured in the TE Client. For information on launching the TE configuration utility, see the Terminal Emulation Client User Guide.
Chapter 4: Configuring the Client for ConnectPro 26 Configuration Option Description Name Enter the name of the Telnet host profile. Type Select the type of emulation. Address Enter the IP address of the Telnet host. Port Enter the port of the Telnet host. Only use TermProxy connections Enable this option if you want to use ConnectPro connections only. This prevents direct connections to the target host.
Chapter 4: Configuring the Client for ConnectPro 27 TermProxy 1 Tab Once you configure the Host tab for the Client, configure the TermProxy 1 tab. Configure up to three ConnectPro servers as failover servers. If the initial ConnectPro server cannot be reached, the client attempts to connect to subsequent ConnectPro servers before it attempts a direct connection with the host. Options to configure the TermProxy 2 tab become available after you configure the TermProxy 1 tab.
Chapter 4: Configuring the Client for ConnectPro Configuration Option Description Address Enter the IP address of the ConnectPro/TermProxy server. Port Enter the Port of the ConnectPro/TermProxy server. Terminate TermProxy Session Indicates when the ConnectPro/TermProxy server should terminate the connection to the host. 28 Possible Values: • Never. The proxy server never terminates the session established with the host. The Client is responsible for terminating the session. • On Network Error.
Chapter 4: Configuring the Client for ConnectPro Configuration Option Description Select Verification Certificates Once you enable the Verify Server Certificates option, the Select Verification Certificates button is active. Click this button to open the Certificate Manager dialog box. Then use the Certificate Manager to create, insert or remove certificates.
Chapter 5: Using ConnectPro 30 Chapter 5: Using ConnectPro The connection between the mobile device and ConnectPro is referred to as the Client-proxy connection and is handled by the proxy service. The connection between ConnectPro and the host is referred to as the proxy-host connection and is handled by the host service: Process Overview The ConnectPro server may reside on the same machine as the host.
Chapter 5: Using ConnectPro 4 31 View the status of your connection from the ConnectPro web interface to verify ConnectPro is being used for the session.
Chapter 5: Using ConnectPro 32 times that ConnectPro will automatically restart. Each time needs to follow the format HH:MM[a|p]. If there is no 'a' or 'p' following the time (representing AM or PM), the time is assumed to be in a 24-hour format. To restart only on a certain day of the week, precede the time with the day of the week. Examples: restart 10:00P restart MONDAY22:30 5 Click Save and Restart to apply the new settings.
Chapter 5: Using ConnectPro 33 Services Console 6 Right-click the service and select Start or Stop from the context menu. The ConnectPro service starts or stops. To start or stop the ConnectPro service from the command line: 1 Navigate to the directory where wltermproxyservice.exe is installed. 2 Type wltermproxyservice -a start to start the service, or wltermproxyservice -a stop to stop the service.
Chapter 5: Using ConnectPro 34 While ConnectPro is running, ConnectPro will not allow the log file to grow beyond 100 KB. Once the log file reaches 100 KB, ConnectPro creates a new log file called TermProxy.log.xxx, where xxx is a sequential number that begins at 001. The contents of these additional log files are written to TermProxy.log.bak when ConnectPro is started.
Chapter 5: Using ConnectPro 35 • In the ConnectPro stored configuration. When you modify the settings here, they are permanent. • In the Logging and Data Capture Settings page. When you modify the settings here, they are temporary and will reset to the stored configuration values after a restart. To modify the logging level in the ConnectPro configuration: 1 Access the ConnectPro web interface. 2 From the menu at the top of the page, click Configuration.
Chapter 5: Using ConnectPro 4 36 In the text box, type capture [status], where [status] and clear [status], where [status] is the preferred setting (on or off). Example: capture on clear off 5 Click Validate to validate your changes. 6 Click Save and Restart to save your changes and restart ConnectPro. To enable data capturing from the Logging and Data Capture Settings page: 1 Access the ConnectPro web interface. 2 From the menu at the top of the page, click Configuration.
Chapter 5: Using ConnectPro 37 The Logging and Data Capture Settings page appears. 3 In the left channel navigation, click View Capture File. The data capture file appears in a separate window. To refresh the data capture page, click Refresh at the top of the page. NOTE: If the Data capturing on option is not enabled, there will be no information written to the data capture file. Viewing ConnectPro Status and Sessions This section provides information on ConnectPro proxyservice sessions.
Chapter 5: Using ConnectPro Statistic Description Bytes Received Total number of bytes received by both Client and host. Bytes Sent Total number of bytes sent from both Client and host. 38 • Proxy-specific statistics. These statistics include specific information about the Proxy Service and the Host Service. Proxy-specific statistics display for each ConnectPro session running. Statistic Description Proxy Service Address Displays the proxy service IP address for the specific session.
Chapter 5: Using ConnectPro Statistic Description Host Connection timeouts Displays the number of times the host has timed out. Host Connection retries Displays the number of times the host has attempted to reconnect. Host Connection failures Displays the number of times the host has failed to reconnect. Host Bytes Received Displays the number of byes received by the host. Host Bytes Sent Displays the number of bytes sent by the host.
Chapter 5: Using ConnectPro 40 Viewing Session List The Session List page of the ConnectPro interface displays the following information about each active session: • Client IP address • Host name • Connect time • Last activity If a stationid-template is used with AS/400 connections, it also displays the workstation ID of the mobile device. To view session list: 1 Access the ConnectPro web interface. 2 From the menu at the top of the page, click Current Status. The Current Status page appears.
Chapter 5: Using ConnectPro 41 Press the Delete button, located to the right of each session listing, to disconnect the ConnectPro sessions. Managing ConnectPro HTTP Settings The ConnectPro HTTP Settings Page allows you to manage ConnectPro web server access.
Chapter 5: Using ConnectPro HTTP Settings 4 Enter the administrative password and click Validate. NOTE: The default administrative password is admin. 5 Enter a New HTTP Administrative password. 6 Enter the HTTP User Name. 7 Enter the HTTP Password. 8 Enter the HTTP services IP filter masks. Examples: • Individual:190.200.100.10 • Multiple:190.200.100.10 190.200.100.20 • Network:190.200.100.10/24b 9 Enable the Encrypt the HTTP settings file option.
Chapter 5: Using ConnectPro 43 10 Click Save Changes to apply the new settings. Deleting Stored Public Keys If you change a SSH host’s public keys, clear the SSH public keys that ConnectPro has saved. To clear SSH public keys: 1 Access the ConnectPro web interface. 2 From the TermProxy Main Menu page, click Configuration. The Logging and Data Capture Settings page appears. 3 In the secondary navigation, click SSH Settings. The SSH Settings page appears. 4 Click the Clear SSH Saved Keys button.
Network Scenarios 44 Network Scenarios The following section contains three different ConnectPro implementation scenarios. Each scenario contains a network diagram, configuration parameters, and a brief discussion about the scenario. Scenario 1: Multiple Clients to a Single Host In this model, clients connect to a single host through a proxy server. This example is based on VT emulation with no reconnect string.
Network Scenarios 45 Scenario 2: Multiple Clients to Multiple Hosts In this model, clients can connect to one of three different hosts through a single proxy server. This example is based on VT emulation with no reconnect string. Multiple Clients Connect to Multiple Hosts Configure the mandatory parameters of the termproxy.conf file as follows: proxyservice proxy1 listen 192.168.1.25:4430 server vt1, vt2, vt3 hostservice vt1 connect 192.168.1.50:23 hostservice vt2 connect 192.168.1.
Network Scenarios Scenario 3: Multiple Clients to Proxy Server/Host In this model, several clients connect to a system that hosts the Telnet service and the ConnectPro application. Multiple Clients Connect to a Proxy Server/Host Configure the proxy entry in the ConnectPro configuration file as follows: proxyservice proxy1 listen 10.50.0.250:4430 server as400 hostservice as400 connect 10.50.0.250:23 reconnect-string F3 codeset EBCDIC Configure the clients' host profile to direct session traffic to 10.50.
ConnectPro as a Console Application 47 ConnectPro as a Console Application ConnectPro can be run as a console application when it is installed on a Windows system. Use command line switches to configure options, or use commands while it is running to perform actions. Use the following switches before starting ConnectPro: Switch Function -c [configfile] Specifies the configuration file that ConnectPro uses, where [configfile] is the name of the configuration file. For example: [-c c:\proxy\proxy.cfg].
ConnectPro as a Console Application Switch 48 Function Indicates a reference file that contains this information such as http.cfg.For example: [-u @http.cfg] or [-u @c:\proxy\http.cfg] -v Displays the ConnectPro version information. Use the following commands while ConnectPro is running as a console application: Command Function h Calls up the help menu, which displays the ConnectPro options that are available for the user (the options in this table). r Restarts ConnectPro. x Exits ConnectPro.
ConnectPro as a Console Application 49 ConnectPro switch • To start ConnectPro, type termproxy.exe. ConnectPro runs with the desired options. Use the commands in the table above to restart, exit, change the log levels or data capture, or dump the current session states to the log file.
Wavelink Contact Information 50 Wavelink Contact Information If you have comments or questions regarding this product, please contact Wavelink Customer Service. E-mail Wavelink Customer Support at: CustomerService@wavelink.com For customers within North America and Canada, call the Wavelink Technical Support line at 801-316-9000 (option 2) or 888-699-9283. For international customers, call the international Wavelink Technical Support line at +800 9283 5465.
