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 ® BLAC K BOX Customer Order toll-free in the U.S.: Call 877-877-BBOX (outside U.S. call 724-746-5500) Support 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 Information Web site: www.blackbox.com • E-mail: [email protected] Linux Virtual COM user manual 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. Any other trademarks mentioned in this manual are acknowleged to be the property of the trademark owners. We‘re here to help! If you have any questions about your application or our products, contact Black Box Tech Support at 724-746-5500 or go to blackbox.com and click on “Talk to Black Box.” You’ll be live with one of our technical experts in less than 30 seconds. Page 2 724-746-5500 | blackbox.com Linux Virtual COM user manual 724-746-5500 | blackbox.com 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. No part of this publication is to be used for any other purposes, and it is not to be reproduced, copied, disclosed, transmitted, stored in a retrieval system, or translated into any human or computer language, in any form, by any means, in whole or in part, without the prior express written consent of Black Box Corporation. Guides Contained in This Document: TTYredirector User Guide (includes Quick Start Guide, Installation Notes, Using TTYredirector, and Troubleshooting) Version 4.0.4 for Linux x86 (Jan. 2011) Quick Start Guide How to install and use TTYredirector for most common applications. (Jan. 2011 [Revision]) Installation Notes Additional details related to installing TTYredirector software. Using TTYredirector A complete guide to all TTYredirector commands. Troubleshooting Using trace data to diagnose problems encountered by applications. © 2011 Tactical Software LLC. All Rights Reserved. Serial Device Server Linux Virtual COM Quick Start Guide V1.0 Copyright © 2011 Black Box Corporation 724-746-5500 | blackbox.com Linux Virtual COM user manual 724-746-5500 | blackbox.com Page 3 Table of Contents Quick Start Guide .............................................................................................................................. 5 1. Unpack and Install ........................................................................................................................................................5 2. Enter a License Key.......................................................................................................................................................5 3. Add the New TTY Devices ...........................................................................................................................................5 4. Configure the First TTY Device .....................................................................................................................................5 5. Check the Configuration of the New TTY Devices .......................................................................................................6 6. Begin Using the New TTY Devices ...............................................................................................................................6 7. Testing. .........................................................................................................................................................................7 Installation Notes ...............................................................................................................................7 1. System Requirements ...................................................................................................................................................7 2. Files Created and Modified .........................................................................................................................................7 3. The License Key. ...........................................................................................................................................................7 4. Removing the Software................................................................................................................................................7 5. Daemon Commands ....................................................................................................................................................8 Using TTYredirector ..........................................................................................................................8 1. The Command Line Utilities .........................................................................................................................................8 2. Managing TTY Devices ................................................................................................................................................8 3. Initializing Remote Ports .............................................................................................................................................11 4. General Options .........................................................................................................................................................12 5. Displaying the Settings ...............................................................................................................................................14 6. Technical Notes ..........................................................................................................................................................15 Troubleshooting ...............................................................................................................................17 1. Tracing TTY Activity.. ..................................................................................................................................................17 2. Messages in Syslog. ...................................................................................................................................................17 Page 4 724-746-5500 | blackbox.com Linux Virtual COM user manual 724-746-5500 | blackbox.com 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. TTYredirector software is available from selected manufacturers of serial servers. 1. Unpack and Install: A. If the TTYredirector software is in a .zip file, unzip it to obtain the .bin file. B. Run the distribution file: $ sh ttyredirector_404.bin C. Change to the directory that was created: $ cd ttyredirector_oem-4.0.4 D. su to root. E. Install using the RPM kit if your system supports RPM packaging # rpm -i ttyredirector_oem-4.0.4-1.i386.rpm Install using the shell kit for other systems # sh ttyredirector_oem-4.0.4-install.bin F. If you are running Debian (Ubuntu) or another Linux distribution that does not have the /etc/rc.d/init.d direc- tory, you must use the following commands (as root) to start and stop the TTYredirector daemon: # /usr/local/sbin/ttyredirectord --start and # /usr/local/sbin/ttyredirectord --stop 2. Enter a License Key: Enter the license key with the trconfig command: $ trconfig -licensekey xxxx-xxxx-xxxx-xxxx-xxxx license key AIAA-MAQQ-ACBQ-MIZX-TFJA 3. Add the New TTY Devices: A. Use the trconfig command to create two new TTY devices: $ trconfig -addtty mytty0,mytty1 B. Default settings are in effect for these new TTY devices. They can not be used until they are configured. 4. Configure the First TTY device: A. For mytty0 use the IP address and TCP port number for the first device server: $ trconfig -tty mytty0 -server 10.0.50.100 -port 4660 724-746-5500 | blackbox.com Linux Virtual COM user manual 724-746-5500 | blackbox.com Page 5 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. Sample command: $ trconfig -tty mytty0 -protocol telnet -speed 38400 -inflow rts -outflow cts NOTE: The default command demonstrates how to enable Telnet extension and change baud rate to 38400 and enables hard- ware flow control (RTS/CTS). Table