User`s manual

724-746-5500 | blackbox.com
724-746-5500 | blackbox.com
Page 7
Linux Virtual COM user manual
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
®
.
The target computer processor can be 32-bit x86 or 64-bit x86.
Linux must provide Unix98 pty devices, which are present by default for most Linux distributions. The TTYredirector installer
will inform you if they are not present.
To use TTYredirector with networked device servers:
Your network (including any firewalls) must permit TCP connections to device servers on the TCP port numbers that the server
uses for device access.
2. Files Created and Modified
When TTYredirector is installed, the following files are created or replaced:
/usr/local/bin/trconfig the configuration utility
/usr/local/bin/trquery the query utility (displays configuration)
/usr/local/bin/trtrace — the trace utilly
/usr/local/sbin/ttyredirectord — the daemon
/etc/ttyredirectord.conf — holds all configuration data
/etc/rc.d/init.d/ttyredirectord starts the daemon
The following file is created only if the shell installer is used:
/usr/local/sbin/ttyredirectord-uninstall removes TTYredirector
When TTYredirector is used:
trconfig commands cause the ttyredirectord to modify ttyredirector.conf
ttyredirectord creates symbolic links in /dev to Unix98 pty files
ttyredirectord emits messages to syslog
3. The License Key
Without a license key, TTYredirector runs for a trial period of 24 hours and supports only one TTY device.
A license key is entered using the trconfig command.
4. Removing the Software
TTYredirector software can be removed in two ways, depending on how it was installed:
If installed with the RPM kit, use RPM to erase the package:
# rpm -e ttyredirector