LES301A-KIT LES301AE-KIT LES302A-KIT LES302AE-KIT 1- and 2-Port 10/100 Device Servers, RS-232/422/485, DB9 M Linux Virtual COM User’s Manual BLACK BOX Customer Support Information Linux Virtual COM user manual ® Order toll-free in the U.S.: Call 877-877-BBOX (outside U.S. call 724-746-5500) FREE technical support 24 hours a day, 7 days a week: Call 724-746-5500 or fax 724-746-0746 Mailing address: Black Box Corporation, 1000 Park Drive, Lawrence, PA 15055-1018 Web site: www.blackbox.
Trademarks Used in this Manual Trademarks Used in this Manual Black Box and the Double Diamond logo are registered trademarks of BB Technologies, Inc. Ubuntu is a registered trademark of Canonical Ltd. Linux is a registered trademark of Linus Torvalds. SUSE is a registered trademark of Novell, Inc. Red Hat and Fedora are registered trademarks of Red Hat, Inc. Debian is a registered trademark of Software in the Public Interest, Inc.
Guides Contained in this Document IMPORTANT ANNOUNCEMENT: The information contained in this document is the property of Black Box Corporation and is supplied for the sole purpose of the operation and maintenance of products of Black Box Corporation.
Table of Contents Quick Start Guide............................................................................................................................... 5 1. Unpack and Install.........................................................................................................................................................5 2. Enter a License Key.................................................................................................................................................
Quick Start Guide Quick Start Guide The following instructions assume that you are using a computer running Linux® x86 and a TCP/IP-based device server that both meet system requirements. The example in these instructions creates two new TTY devices to access serial devices on two serial servers: • The first server (at 10.0.0.240) only supports raw TCP access. • The second server (at 10.0.0.250) supports the Telnet with RFC 2217 extensions and requires a user login.
Quick Start Guide B. The software does not support username/password authentication. Please do not enable –auth username option. C. The software only supports Telnet protocol and RFC 2217 extensions, so you need to enable it. In the WebUI, you will need to enable Virtual COM also. For mytty0, we will specify additional baud rate and flow control settings for the server to initialize with these settings each time. It is necessary to set the serial settings here for the server to run properly.
Quick Start Guide/ Installation Notes 7. Testing: If you want to make sure the setup was successful, we recommend using terminals such as text-based or CuteCom GUI. You can connect RS-232 Pin 2 and Pin 3 on a Black Box serial server to do a loopback test or connect the serial server to your PC’s RS-232. Installation Notes 1. System Requirements To install TTYredirector: • The target computer must be running a Linux® x86 distribution. Examples include Red Hat®, Fedora® Core, SUSE®, Debian®, and Ubuntu®.
Installation Notes/Using TTYredirector • If installed with the shell kit, run the shell script uninstaller: # /usr/local/bin/ttyredirectord-uninstall The ttyredirectord daemon is stopped and all TTYredirector tty devices immediately cease operation. If TTYredirector is later reinstalled, all previous settings are restored. 5. Daemon Commands The TTYredirector daemon script accepts conventional daemon script commands. NOTE: This information is provided as an FYI for administrators.
Using TTYredirector All settings for new device(s) are default values. If a device exists, there is no error. No other options can be used with this command. NOTE: The Linux kernel limits the number of Unix98 pty devices to a maximum of 2048, and most Linux distributions are configured for 256 by default. Since pty devices are used for various purposes, the number available to be used by TTYredirector will be lower, depending on what other software is running at the time.
Using TTYredirector E. Automatically restoring failed connections trconfig -tty dev -restore Y|N trconfig -y dev -r Y|N Y — If the network connection to the server fails, attempt to restore it and continue operation. For more information, see the Technical Notes. N — Do not restore a failed connection. (default) F. Permissions trconfig -tty dev -chown owner -chgrp group -chmod mode trconfig -y dev -chown owner -chgrp group -chmod mode Sets permissions for using the TTY devices.
Using TTYredirector 3. Initializing Remote Ports If you are using a device server that supports the Telnet protocol with RFC 2217 extensions, TTYredirector is able to improve your access to server devices in three ways: • Each time you open a TTYredirector device, the corresponding remote port on the server can be initialized to your settings for baud rate, data length, and the other options described below.
Using TTYredirector trconfig -tty dev -rts r trconfig -y dev -T r r — 0 or 1, the state to set when the TTY is opened C. Flow control trconfig -tty dev -inflow i trconfig -y dev -I i i — Input flow control: rts, dtr, xonxoff, none trconfig -tty dev -outflow o trconfig -y dev -O o o — Input flow control: cts, dsr, xonxoff, none 4. General Options The general options affect all TTYredirector TTY devices. NOTES: • When using general options, do not specify TTYredirector TTY devices.
Using TTYredirector trconfig -maxreconnect m trconfig -m m n — The number of milliseconds between reconnect attempts. A value of at least 1000 is recommended. Controls the maximum time between attempts by TTYredirector to reconnect to the server if -restore is enabled for a TTY. Default setting: 30000 (30 seconds). trconfig -delayclose c trconfig -C c c — The number of milliseconds to delay closing the connection to the server after the TTY device has been closed.
Using TTYredirector Either or both options can be used. lp — One or more strings (separated by vertical bar) specifying additional login prompt strings. pp — One or more strings (separated by vertical bar) specifying additional password prompt strings. The built-in login prompt strings are: login: |username: |Username:|login :|Login:|user:| The built-in password prompt strings are: password:|Password:|Enter PASSCODE| C.
Using TTYredirector A. Option Settings trquery -tty dev -opt1 -opt2 ... trquery -y dev -opt1 -opt2 ... opt1, opt2, ...
Using TTYredirector When the -restore option is set to Y: • When TTYredirector notices that the TCP connection is broken, it will immediately attempt to reconnect to the device server. • If that attempt fails, TTYredirector tries again at increasing intervals until the connection is restored or the application closes the TTY device. • The maximum interval between attempts is determined by the setting of the advanced option -maxreconnect.
Using TTYredirector/Troubleshooting 3 The command has been rejected by the TTYredirector daemon. An example is setting a user permission for a user that doesn't exist. 4 The command program is unable to communicate with the ttyredirectord daemon. Troubleshooting 1. Tracing TTY Activity The trtrace command displays the activity of TTYredirector TTY devices. Initiating tracing trtrace Displays trace data to stdout.
NOTES Page 18 724-746-5500 | blackbox.
NOTES Linux Virtual COM user manual 724-746-5500 | blackbox.
Black Box Tech Support: FREE! Live. 24/7. Tech support the way it should be. Great tech support is just 30 seconds away at 724-746-5500 or blackbox.com. About Black Box Black Box provides an extensive range of networking and infrastructure products. You’ll find everything from cabinets and racks and power and surge protection products to media converters and Ethernet switches all supported by free, live 24/7 Tech support available in 30 seconds or less. © Copyright 2011. Black Box Corporation.
