Terminal Servers - LES4011 to 14
Terminal Server
User Guide
Version 3.3
5500182-33
November 2007
CUSTOMER
SUPPORT
INFORMATION
Secure Server User Guide
Order toll-free in the U.S 24 hours, 7 A.M. Monday to midnight Friday: 877-877-BBOX
FREE technical support, 24 hours a day, 7 days a week: Call 724-746-5500 or fax 724-746-0746
Mail order: Black Box Corporation, 1000 Park Drive, Lawrence, PA 15055-1018
Web site: www.blackbox.com * E-mail info@blackbox.com
Normas Oficiales Mexicanas (NOM) Electrical Safety Statement
INSTRUCCIONES DE SEGURIDAD
1. Todas las instrucciones de seguridad y operación deberán ser leídas antes de que el
aparato eléctrico sea operado.
2. Las instrucciones de seguridad y operación deberán ser guardadas para referencia futura.
3. Todas las advertencias en el aparato eléctrico y en sus instrucciones de operación deben
ser respetadas.
4. Todas las instrucciones de operación y uso deben ser seguidas.
5. El aparato eléctrico no deberá ser usado cerca del agua-por ejemplo, cerca de la tina de
baño, lavabo, sótano mojado o cerca de una alberca, etc.
6. El aparato eléctrico debe ser usado únicamente con carritos o pedestales que sean
recomendados por el fabricante.
7. El aparato eléctrico debe ser montado a la pared o al techo sólo como sea recomendado por
el fabricante.
8. Servicio-El usuario no debe intentar dar servicio al equipo eléctrico más allá a lo descrito en
las instrucciones de operación. Todo otro servicio deberá ser referido a personal de servicio
calificado.
9. El aparato eléctrico debe ser situado de tal manera que su posición no interfiera su uso. La
colocación del aparato eléctrico sobre una cama, sofá, alfombra o superficie similar puede
bloquea la ventilación, no se debe colocar en libreros o gabinetes que impidan el flujo de
aire por los orificios de ventilación.
10. El equipo eléctrico deber ser situado fuera del alcance de fuentes de calor como radiadores,
registros de calor, estufas u otros aparatos (incluyendo amplificadores) que producen calor.
11. El aparato eléctrico deberá ser connectado a una fuente de poder sólo del tipo descrito en el
instructivo de operación, o como se indique en el aparato.
12. Precaución debe ser tomada de tal manera que la tierra fisica y la polarización del equipo no
sea eliminada.
13. Los cables de la fuente de poder deben ser guiados de tal manera que no sean pisados ni
pellizcados por objetos colocados sobre o contra ellos, poniendo particular atención a los
contactos y receptáculos donde salen del aparato.
14. El equipo eléctrico debe ser limpiado únicamente de acuerdo a las recomendaciones del
fabricante.
15. En caso de existir, una antena externa deberá ser localizada lejos de las lineas de energia.
16. El cable de corriente deberá ser desconectado del cuando el equipo no sea usado por un
largo periodo de tiempo.
17. Cuidado debe ser tomado de tal manera que objectos liquidos no sean derramados sobre la
cubierta u orificios de ventilación.
18. Servicio por personal calificado deberá ser provisto cuando:
a. El cable de poder o el contacto ha sido dañado; u
b. Objectos han caído o líquido ha sido derramado dentro del aparato; o
c. El aparato ha sido expuesto a la lluvia; o
d. El aparato parece no operar normalmente o muestra un cambio en su desempeño; o
e. El aparato ha sido tirado o su cubierta ha sido dañada.
FCC Requirements for Telephone-Line Equipment
1. The Federal Communications Commission (FCC) has established rules which permit this
device to be directly connected to the telephone network with standardized jacks. This
equipment should not be used on party lines or coin lines.
2. If this device is malfunctioning, it may also be causing harm to the telephone network; this
device should be disconnected until the source of the problem can be determined and until
the repair has been made. If this is not done, the telephone company may temporarily
disconnect service.
3. If you have problems with your telephone equipment after installing this device, disconnect
this device from the line to see if it is causing the problem. If it is, contact your supplier or an
authorized agent.
4. The telephone company may make changes in its technical operations and procedures. If
any such changes affect the compatibility or use of this device, the telephone company is
required to give adequate notice of the changes.
5. If the telephone company requests information on what equipment is connected to their
lines, inform them of:
a. The telephone number that this unit is connected to.
b. The ringer equivalence number.
c. The USOC jack required: RJ-11C.
d. The FCC registration number.
Items (B) and (D) can be found on the unit’s FCC label. The ringer equivalence number
(REN) is used to determine how many devices can be connected to your telephone line. In
most areas, the sum of the RENs of all devices on any one line should not exceed five. If
too many devices are attached, they may not ring properly.
6. In the event of an equipment malfunction, all repairs should be performed by your supplier or
an authorized agent. It is the responsibility of users requiring service to report the need for
service to the supplier or to an authorized agent.
Certification Notice for Equipment Used in Canada
The Industry Canada label identifies certified equipment. This certification means that the
equipment meets certain telecommunications-network protective, operation, and safety
requirements. Industry Canada does not guarantee the equipment will operate to the user’s
satisfaction.
Before installing this equipment, users should ensure that it is permissible to be connected to the
facilities of the local telecommunications company. The equipment must also be installed using
an acceptable method of connection. In some cases, the company’s inside wiring associated
with a single-line individual service may be extended by means of a certified connector assembly
(extension cord). The customer should be aware that compliance with the above conditions may
not prevent degradation of service in some situations.
Repairs to certified equipment should be made by an authorized maintenance facility—in this
case, Black Box. Any repairs or alterations made by the user to this equipment, or equipment
malfunctions, may give the telecommunications company cause to request the user to
disconnect the equipment.
Users should ensure for their own protection that the electrical ground connections of the power
utility , telephone lines, and internal metallic water pipe system, if present, are connected together .
This precaution may be particularly important in rural areas.
CAUTION: Users should not attempt to make such connections themselves, but should contact
the appropriate electric inspection authority, or electrician, as appropriate.
The LOAD NUMBER (LN) assigned to each terminal device denotes the percentage of the total
load to be connected to a telephone loop which is used by the device, to prevent overloading.
The termination on a loop may consist of any combination of devices, subject only to the
requirement that the total of the load numbers of all the devices does not exceed 100.
FEDERAL COMMUNICATIONS COMMISSION AND INDUSTRY CANADA
RADIO FREQUENCY INTERFERENCE STATEMENTS
This equipment generates, uses, and can radiate radio-frequency energy, and if not installed and
used properly, that is, in strict accordance with the manufacturer’s instructions, may cause
interference to radio communication. It has been tested and found to comply with the limits for a
Class A computing device in accordance with the specifications in Subpart B of Part 15 of FCC
rules, which are designed to provide reasonable protection against such interference when the
equipment is operated in a commercial environment. Operation of this equipment in a residential
area is likely to cause interference, in which case the user at his own expense will be required to
take whatever measures may be necessary to correct the interference.
Changes or modifications not expressly approved by the party responsible for compliance could
void the user’s authority to operate the equipment.
This digital apparatus does not exceed the Class A limits for radio noise emission from digital
apparatus set out in the Radio Interference Regulation of Industry Canada.
Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites
applicables aux appareils numériques de la classe A prescrites dans le Règlement sur le
brouillage radioélectrique publié par le Industrie Canada.
Table of Content s
Preface ...............................................................................15
About This Book ........................................................................ 15
Intended Audience..................................................................... 15
Documentation........................................................................... 15
Typeface Conventions............................................................... 16
Online Help................................................................................. 16
Chapter 1 Introduction......................................................17
About the Terminal Server........................................................ 17
Terminal Server Models ............................................................ 17
Terminal Server Features.......................................................... 18
Hardware................................................................................................. 18
Software .................................................................................................. 19
Accessing the Terminal Server.......................................................... 19
General Features............................................................................... 19
Security ...................................................................................................19
Chapter 2 Hardware and Connectivity ............................20
Introduction................................................................................ 20
Terminal Server Components................................................... 20
What’s Included......................................................................................20
What You Need to Supply......................................................................20
Power Supply Specifications.................................................... 20
Desktop Models......................................................................................20
Terminal Server User Guide, Version 3.3 5
Table of Contents
Serial Only Models ............................................................................. 20
Getting to Know Your Terminal Server ....................................21
Overview..................................................................................................21
Terminal Server 1-Port ...........................................................................21
Console/Serial Switch ............................................................................22
Console Mode .................................................................................... 22
Serial Mode ........................................................................................ 22
Powering Up the Terminal Server.............................................23
Serial Only Models..................................................................................23
Chapter 3 Configuration Methods ...................................24
Introduction.................................................................................24
Configuration Methods Overview .............................................24
Configures an IP Address......................................................................24
Requires a Configured IP Address........................................................25
Easy Config Wizard....................................................................25
DeviceManager ...........................................................................26
Overview..................................................................................................26
Access Platforms....................................................................................26
Features...................................................................................................26
Connecting to a Terminal Server Using DeviceManager....................27
Using DeviceManager.............................................................................28
WebManager ...............................................................................28
Overview..................................................................................................28
Access Platforms...................................................................................28
Features...................................................................................................29
Connecting to a Terminal Server Using WebManager........................29
Using WebManager.................................................................................30
Command Line Interface............................................................30
Overview..................................................................................................30
Access Platforms....................................................................................30
Features...................................................................................................31
6 Terminal Server User Guide, Version 3.3
Table of Contents
Connecting to a Terminal Server Using the CLI.................................. 31
Through the Network.......................................................................... 31
Through the Serial Port...................................................................... 31
Using the CLI ..........................................................................................31
Menu............................................................................................ 32
Overview.................................................................................................. 32
Access Platforms ...................................................................................32
Features...................................................................................................32
Connecting to the Terminal Server Using the Menu........................... 32
Using the Menu.......................................................................................32
DHCP/BOOTP............................................................................. 33
Overview.................................................................................................. 33
Features...................................................................................................33
Connecting to the Terminal Server Using DHCP/BOOTP................... 33
Using DHCP/BOOTP...............................................................................33
DHCP/BOOTP Parameters..................................................................... 34
SNMP........................................................................................... 34
Overview.................................................................................................. 34
Access Platforms ................................................................................... 34
Unique Features ..................................................................................... 34
Connecting to an Terminal Server Using SNMP.................................. 35
Using the SNMP MIB.............................................................................. 35
Chapter 4 Getting Started.................................................36
Introduction................................................................................ 36
Easy Configuration Wizard ....................................................... 36
Setting Up the Network ............................................................. 37
Using DeviceManager............................................................................37
Using WebManager................................................................................ 38
Using a Direct Serial Connection to Specify an IP Address............... 38
Using a Direct Serial Connection to Enable BOOTP/DHCP.............. 39
Using ARP-Ping......................................................................................40
For an IPv6 Network...............................................................................40
7
Table of Contents
Setting Up the Serial Port(s)......................................................41
Setting Up Users.........................................................................42
Chapter 5 Using DeviceManager and WebManager.......44
Introduction.................................................................................44
Navigating DeviceManager/WebManager ................................45
DeviceManager........................................................................................45
WebManager............................................................................................46
Using DeviceManager to Connect to the Terminal Server .....46
Populating the Terminal Server List .....................................................46
Starting a New Session..........................................................................47
Assigning a Temporary IP Address to a New Terminal Server ..........48
Adding/Deleting Manual Terminal Servers...........................................48
Logging in to the Terminal Server.........................................................48
Using WebManager to Connect to the Terminal Server .........49
Logging into the Terminal Server..........................................................49
Configuration Files.....................................................................49
Creating a New Terminal Server Configuration in DeviceManager....49
Opening an Existing Configuration File ...............................................49
Importing an Existing Configuration File .............................................50
Managing the Terminal Server ..................................................50
Chapter 6 Network Settings .............................................51
Introduction.................................................................................51
IP Settings...................................................................................51
IP Settings ...............................................................................................51
Overview............................................................................................. 51
Field Descriptions............................................................................... 51
Advanced.................................................................................................52
Overview............................................................................................. 52
Field Descriptions............................................................................... 52
8 Terminal Server User Guide, Version 3.3
Table of Contents
Advanced.................................................................................... 52
Host Table............................................................................................... 52
Overview............................................................................................ 52
Functionality....................................................................................... 52
Field Descriptions............................................................................... 53
Adding/Editing a Host............................................................................53
Route List................................................................................................54
Overview............................................................................................ 54
Functionality....................................................................................... 54
Field Descriptions............................................................................... 54
Adding/Editing Routes...........................................................................54
Chapter 7 Configuring Serial Ports .................................56
Introduction................................................................................ 56
Serial Ports................................................................................. 56
Overview.................................................................................................. 56
Functionality........................................................................................... 56
Editing a Serial Port ........................................................................... 57
Resetting a Serial Port....................................................................... 58
Serial Port Profiles..................................................................... 59
Common Tabs.........................................................................................59
Overview............................................................................................ 59
Hardware Tab Field Descriptions....................................................... 59
Packet Forwarding Tab Field Descriptions ........................................ 61
Console Management Profile................................................................63
Overview............................................................................................ 63
Functionality....................................................................................... 63
General Tab Field Descriptions.......................................................... 64
Advanced Tab Field Descriptions...................................................... 64
COMredirect Profile................................................................................66
Overview............................................................................................ 66
Functionality....................................................................................... 66
General Tab Field Descriptions.......................................................... 67
Adding/Editing Additional COMredirect Hosts.................................... 68
Adding/Editing a Multihost Entry........................................................ 68
Advanced Tab Field Descriptions...................................................... 69
TCP Sockets Profile ...............................................................................70
Overview............................................................................................ 70
Functionality....................................................................................... 70
General Tab Field Descriptions.......................................................... 71
9
Table of Contents
Adding/Editing Additional Hosts ......................................................... 72
Adding/Editing a Multihost Entry......................................................... 73
Advanced Tab Field Descriptions....................................................... 73
UDP Sockets Profile ...............................................................................74
Overview............................................................................................. 74
Functionality ....................................................................................... 75
General Tab Field Descriptions.......................................................... 76
Terminal Profile.......................................................................................77
Overview............................................................................................. 77
Functionality ....................................................................................... 77
General Tab Field Descriptions.......................................................... 77
Advanced Tab Field Descriptions....................................................... 79
User Service Settings.............................................................................80
Login Settings..................................................................................... 80
Telnet Settings.................................................................................... 81
Serial Tunneling Profile..........................................................................82
Overview............................................................................................. 82
Functionality ....................................................................................... 82
General Tab Field Descriptions.......................................................... 83
Virtual Modem Profile.............................................................................84
Overview............................................................................................. 84
Functionality ....................................................................................... 84
General Tab Field Descriptions.......................................................... 85
Advanced Tab Field Descriptions....................................................... 86
Phone Number to Host Mapping........................................................ 87
VModem Phone Number Entry........................................................... 87
Modbus Gateway Profile........................................................................88
Overview............................................................................................. 88
Functionality ....................................................................................... 88
General Tab Field Descriptions.......................................................... 88
Advanced Field Descriptions.............................................................. 89
Modbus Slave IP Settings Field Descriptions..................................... 90
Adding/Editing Modbus Slave IP Settings.......................................... 91
Modbus Slave Advanced Settings Field Descriptions........................ 92
Advanced ....................................................................................93
Advanced Serial Settings Tab ...............................................................93
Overview............................................................................................. 93
Field Descriptions............................................................................... 93
Modems Tab............................................................................................94
Overview............................................................................................. 94
Adding/Editing a Modem .................................................................... 94
COMredirect Baud Rate Tab..................................................................95
10 Terminal Server User Guide, Version 3.3
Table of Contents
Overview............................................................................................ 95
Functionality....................................................................................... 95
Field Definitions.................................................................................. 95
Chapter 8 Configuring Users ...........................................96
Introduction................................................................................ 96
User Settings.............................................................................. 96
Overview.................................................................................................. 96
Functionality.......................................................................................... 96
Adding/Editing Users ................................................................ 97
General Tab.............................................................................................97
Overview............................................................................................ 97
Functionality....................................................................................... 97
Field Descriptions............................................................................... 97
Services Tab ........................................................................................... 98
Overview............................................................................................ 98
Functionality....................................................................................... 98
Field Descriptions............................................................................... 99
Advanced Tab.........................................................................................99
Overview............................................................................................ 99
Field Descriptions............................................................................. 100
Sessions Tab ........................................................................................ 101
Overview.......................................................................................... 101
Functionality..................................................................................... 101
Field Descriptions............................................................................. 102
Serial Port Access Tab.........................................................................103
Overview.......................................................................................... 103
Field Descriptions............................................................................. 103
Chapter 9 Configuring Security.....................................104
Introduction.............................................................................. 104
Services.................................................................................... 104
Overview................................................................................................104
Functionality......................................................................................... 104
Field Descriptions ................................................................................ 104
11
Table of Contents
Chapter 10 Configuring the System ..............................106
Introduction...............................................................................106
Alerts .........................................................................................106
Syslog....................................................................................................106
Overview........................................................................................... 106
Field Descriptions............................................................................. 106
Management..............................................................................107
SNMP......................................................................................................107
Overview........................................................................................... 107
Field Descriptions............................................................................. 107
Advanced...............................................................................................108
Overview........................................................................................... 108
Login Tab Field Descriptions............................................................ 108
Bootup Files Tab Field Descriptions................................................. 109
Message of the Day (MOTD) Tab Field Descriptions....................... 109
TFTP Tab Field Descriptions............................................................ 110
Chapter 11 System Administration................................111
Introduction...............................................................................111
Managing Configuration Files.................................................111
Saving Configuration Files ..................................................................111
Downloading Configuration Files........................................................111
Downloading Configuration Files to Multiple Terminal Servers ......112
Uploading Configuration Files.............................................................112
Downloading Terminal Server Firmware................................113
Setting the Terminal Server’s Date and Time ........................113
Rebooting the Terminal Server ...............................................113
Resetting the Terminal Server to Factory Defaults...............114
Language Support....................................................................114
Loading a Supplied Language.............................................................114
Translation Guidance...........................................................................115
Software Upgrades and Language Files.............................................115
12 Terminal Server User Guide, Version 3.3
Table of Contents
Downloading Terminal Definitions......................................... 116
Creating Terminal Definition Files......................................................116
Resetting Configuration Parameters ..................................... 117
Lost Admin Password............................................................. 118
Appendix A Virtual Modem AT Commands..................119
Virtual Modem Initialization Commands................................ 119
Appendix B Pinouts and Cabling Diagrams.................121
Serial Pinouts........................................................................... 121
DB25 Male ............................................................................................. 121
DB25 Female......................................................................................... 122
RJ45....................................................................................................... 123
DB9 Male (Serial Only).........................................................................124
EIA-232 Cabling Diagrams ...................................................... 125
Terminal DB25 Connector ...................................................................125
DB25 Male ....................................................................................... 125
DB25 Female................................................................................... 125
RJ45................................................................................................. 126
DB9 Male ......................................................................................... 126
Modem DB25 Connector......................................................................127
DB25 Male ....................................................................................... 127
RJ45................................................................................................. 127
DB9 Male ......................................................................................... 128
Appendix C Setting Jumpers.........................................129
Introduction.............................................................................. 129
1-Port Terminal Server.........................................................................129
Terminal Server DB25 Male/Female................................................ 129
Terminal Server RJ45...................................................................... 130
Terminal Server DB9........................................................................ 130
Appendix D COMredirect Utility.....................................131
Introduction.............................................................................. 131
COMredirect ............................................................................. 131
13
Table of Contents
Appendix E Troubleshooting .........................................132
Introduction...............................................................................132
Hardware Problems..................................................................132
Communication Issues ............................................................132
DeviceManager Problems........................................................133
Host Problems ..........................................................................133
Login Problems ........................................................................133
Problems with Terminals.........................................................134
Unknown IP Address................................................................134
DHCP/BOOTP Problems ..........................................................135
Language Problems .................................................................135
Long Reboot Cycle...................................................................135
Glossary...........................................................................136
Index.................................................................................138
14 Terminal Server User Guide, Version 3.3
Preface
About This Book
This guide provides the information you need to:
z configure the Terminal Server.
z incorporate the Terminal Server into your production environment.
Intended Audience
This guide is for administrators who will be configuring the Terminal Server.
Some prerequisite knowledge is needed to understand the concepts and examples in this guide:
z If you are using an external authentication application(s), working knowledge of the
authentication application(s).
z Knowledge of TFTP, the transfer protocol the Terminal Server uses.
Documentation
The following documentation is included on the Terminal Server installation CD:
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z BLACK BOX
z Online Help in the DeviceManager (automatically installed with the DeviceManager application)
®
1-Port Quick Start Guide
®
2-4-Port Desktop Quick Start Guide
®
Rack Mount Quick Start Guide
®
Terminal Server User Guide
®
Terminal Server Command Line Reference Guide
®
COMredirect Windows User Guide
®
COMredirect Linux User Guide
®
COMredirect Solaris User Guide
®
COMredirect Unixware User Guide
®
COMredirect SCO Openserver 5 User Guide
®
COMredirect SCO Openserver 6 User Guide
®
COMredirect HP-UX User Guide
Terminal Server User Guide, Version 3.3 15
Typeface Conventions
Typeface Conventions
Most text is presented in the typeface used in this paragraph. Other typefaces are used to help you
identify certain types of information. The other typefaces are:
Typeface Example Usage
At the C: prompt, type:
add host
Set the value to TRUE. The typeface used for TRUE is also used when referring to
subscribe project subject
run yourcode.exec
File, Save This typeface and comma indicates a path you should
BLACK BOX® User Guide
See About the Terminal Server on page
17 for more information.
Online Help
Online help is provided in the DeviceManager. You can click on the What’s This button ( or )
and then click on a field to get field-level help. Or, you can press the F1 key to get window-level
help. You can also get the User Guide online by selecting
This typeface is used for code examples and
system-generated output. It can represent a line you type
in, or a piece of your code, or an example of output.
an actual value or identifier that you should use or that is
used in a code example.
The italicized portion of these examples shows the
typeface used for variables that are placeholders for
values you specify. This is found in regular text and in
code examples as shown. Instead of entering
you enter your own value, such as
for
yourcode, enter the name of your program.
follow through the menus. In this example, you select
Save from the File menu.
This typeface indicates a book or document title.
This indicates a cross-reference to another chapter or
section that you can click on to jump to that section.
Help, Help Topics.
stock_trader, and
project,
16 Terminal Server User Guide, Version 3.3
Introduction Chapter 1
1
About the Terminal Server
The Terminal Server is an Ethernet communications/terminal server that allows serial devices to
connect directly to LANs. The Terminal Server can connect to a wide range of devices including:
z T erminals for multi-user UNIX systems
z Data acquisition equipment (manufacturing, laboratory, scanners, etc.)
z Retail point-of-sale equipment (bar coding, registers, etc.)
z PCs using terminal emulation or SLIP/PPP
z Modems for remote access and Internet access
z ISDN adapters for branch remote access and Internet access
z All types of serial printers
The performance and flexibility of the Terminal Server allows you to use a wide range of high speed
devices in complex application environments. The Terminal Server products will work in any server
environment running TCP/UDP/IP.
Terminal Server Models
The Terminal Server comes in several different models to meet your network needs:
z Terminal Server—Offered as a 1-port unit (DB25M, DB25F, RJ45, and DB9M interfaces
available), this model provides basic Terminal Server functionality and supports software
configurable serial interface protocols EIA-232/422/485.
z Secure Device Server—This model is available in both desktop and rack mount configurations.
Both models support software configurable serial interface protocols EIA-232/422/485. The
Secure Device Server model has the advanced secure BLACK BOX
the general Terminal Server functionality.
z Secure Terminal Server—This model comes in one desktop model and several rack mount
configurations. All models support EIA-232 only. The Secure Terminal Server model has the
advanced secure BLACK BOX
functionality.
z Secure Console Server—This model comes in several rack mount configurations. All models
support EIA-232 only and have an internal PCI card interface. The SCS model has the advanced
secure BLACK BOX
See Hardware on page 18 for information about the hardware specifications for your Terminal
Server model. See Software on page 19 for a list of the basic and advanced software features.
®
feature set in addition to the general Terminal functionality.
®
feature set in addition to
®
feature set in addition to the general Terminal Server
Terminal Server User Guide, Version 3.3 17
Terminal Server Features
Terminal Server Features
The Terminal Server is a communications server used for making serial network connections. It
attaches to your TCP/IP network and allows serial devices such as modems, terminals, or printers to
access the LAN. It also allows LAN devices to access devices or equipment attached to Terminal
Server serial ports.
This section highlights the hardware and software components you can expect to find in your
Terminal Server model.
Hardware
Hardware Features BLACK BOX® Models
Desktop Rack Mount
Serial Connectors
Serial Interface
Serial Power In Pin
Serial Power Out Pin
Auto Sensing
Ethernet Interface
Terminal Server
Secure Device Server 1
Secure Device Server 2/4
Secure Terminal Server 4
Secure Device Server
Secure Console Server
Secure Terminal Server
DB25F zz
DB25M zz
RJ45 zzzzzzz
DB9M zz
EIA-232 zzzzzzz
EIA-422 zzz z
EIA-485 zzz z
DB25F zz
DB25M zz
RJ45 zzzz
DB25F zz
DB25M zz
RJ45 zzzz
10/100 zzzz
10/100/1000 zzz
PCI Interface z
Power Supply
18 Terminal Server User Guide, Version 3.3
Power over Ethernet zz
External AC zzzz
Internal AC zzz
Dedicated Console Port zzz
Software
Terminal Server Features
This section describes the supported software features available.
Accessing the Terminal Server
All Terminal Server models can be accessed through any of the following methods:
z Easy Config Wizard, an easy configuration wizard that allows you to quickly setup the Terminal
Server in a Windows environment
z DeviceManager, a fully functional Windows Vista/XP/Server 2003/2000
configuration/management tool
z WebManager, a web browser (HTTP/HTTPS) option for configuring/managing the Terminal
Server
z Menu, a window-oriented menu interface for configuration and user access
z CLI, a Command Line Interface option for configuration/management and user access
z SNMP, allowing remote configuration via SNMP as well as statistics gathering
z DHCP/BOOTP, a method of automati cally updating the Terminal Server
General Features
Basic software features are available on all Terminal Server models.
z IPv6 support.
z Support for TCP/IP and UDP protocols including telnet and raw connections.
z Printer support via LPD and RCP.
z Vi rtual modem emulation.
z ‘Fixed tty’ support for several operating systems using the BLACK BOX
z DHCP/BOOTP for automated network-based setup.
z Dynamic statistics and line status information for fast problem diagnosis.
z Multisession support when accessing the Te rminal Server from either the serial port or the
network.
z Modbus master/slave/gateway support.
z Ability to disable services (for example, Telnet, COMredirect, Syslog, SNMP, Modbus, HTTP)
for additional security.
®
COMredirect utility.
Security
The Terminal Server security features can include (depending on your Terminal Server model):
z Supervisory and serial port password protection.
z Ability to set serial port access rights.
z Ability to assign users access level rights to control their access.
z Trusted host filtering (IP filtering), allowing only those hosts that have been configured in the
Terminal Server access to the Terminal Serve r.
z Idle port timers, which close a connection that has not been active for a specified period of time.
z Ability to individually disable network services that won’t be used by the Terminal Server.
Introduction 19
Hardware and
2
Connectivity Chapter 2
Introduction
This chapter describes how to physically set up your Terminal Server unit. It includes an overview of
the Terminal Server hardware components and how to power up the Terminal Server to make sure it
works correctly.
Terminal Server Components
What’s Included
The following components are included with your product:
z Terminal Server unit
z External power supply
z A CD-ROM containing documentation, firmware, configuration software, COMredirect, etc.
z Terminal Server models that have an RJ45 serial connector(s) come with an RJ45JDB9F
adapter
What You Need to Supp ly
Before you can begin, you need to have the following:
z A serial cable(s) to connect serial devices to your Terminal Server unit
z An Ethernet CAT5 10/100/1000BASE-T cable to connect the Terminal Server unit to the
network
Power Supply Specifications
Desktop Models
Serial Only Models
If you are providing a power supply for a desktop Terminal Server model, your power supply must
meet the following requirements:
z Output between 9-30V DC.
z DC barrel connector: The cable attached to the power supply should be about 20AWG, length 6
feet approx. The barrel dimensions of the cable-plug are OD=5.5, ID=2.1, and length= 9.5mm,
with a straight barrel, and positive polarity on the inside and negative polarity on the outside.
z Power can also be provided by:
z Serial Port 1, pin 1 on the Terminal Server model.
Terminal Server User Guide, Version 3.3 20
Getting to Know Your Terminal Server
Getting to Know Your Terminal Server
This section describes the hardware components found on your Terminal Server unit.
Overview
All Terminal Servers have the same basic hardware components to allow you to connect to serial
devices, connect to the network, monitor LAN and serial activity, and manage the unit. Below is a list
of these components:
z Serial Port(s)—Connector(s) that will be used to connect to a serial device.
z Activity—This LED flashes to indicate LAN activity.
z Link10/100—This LED indicates the Ethernet connection speed for desktop models:
– Green—10 Mbits
– Yellow—100 Mbits
–Off—no LAN connection
z Power/Ready—This LED can cycle through several colors (yellow, green, red) during a boot
process, but should complete with a green light. If the LED is green after power up but continues
to cycle on and off (flashes green), this indicates that the console switch is in the on position.
You can learn more about the Power/Ready LED in
z External Power Supply—This is an external AC power supply.
z Console/Serial Switch—This switch determines whether serial port 1 functions as a serial port
or a console port.
z Reset—The inset RESET button will reboot the Terminal Server if pushed in and released
quickly. It will reset the Terminal Server to factory defaults if pushed in and held for more than
three seconds.
z Serial Activity
z Tx—Flashes with transmit serial activity. There is a Tx LED for each serial port.
z Rx—Flashes with receive serial activity. There is an Rx LED for each serial port.
z Ethernet—The Ethernet connector.
Hardware Problems on page 132.
Terminal Server 1-Port
This section describes the components found on the Terminal Server 1-Port model.
External Power Supply
Power/Ready
Link/10/100
Activity (LAN)
Serial Activity
Console/Serial
Switch
Serial Port
Reset
Ethernet
Hardware and Connectivity 21
Getting to Know Your Terminal Server
The Terminal Server has one serial connection that is one of the following connectors: DB25 male,
DB25 female, RJ45, or DB9 male.
Console/Serial Switch
Located at the back of the desktop models is a switch that controls whether serial port 1 is in Console
or Serial mode.
Look at your model to verify the direction of the ON switch position. ON indicates that serial port 1
is in Console mode; otherwise serial port 1 is in Serial mode.
Console Mode
Console mode is used when you have a direct connection between a serial device (like a terminal or a
PC) and the Terminal Server, accessed by the Admin user to configure/manage the Terminal Server.
Console mode automatically sets serial port settings as:
z Serial Interface to EIA-232
z Speed to 9600
z Flow Control to No
z Bits to 8
z Stop Bits to 1
z Parity to None
Console mode also displays extra system messages.
Serial port 1 will ignore any Serial Port settings when in Console mode, so you need to turn Console
mode off to use serial port 1 in your network.
Note:
When the console switch is in the on position, the System/Ready LED will cycle on and off
(flashes green).
Serial Mode
Serial mode is used when the Terminal Server acts as a communications server, or anytime you are
not connecting directly to the Terminal Server to configure it. You can connect directly to the
Terminal Server in Serial mode, but the Terminal Server will not display all the
messages/information you will get in Console mode.
22 Terminal Server User Guide, Version 3.3
Powering Up the Terminal Server
Serial Only Models
To power up the Terminal Server, perform the following steps:
1. Plug the external power supply into the Terminal Server and then into the electrical outlet.
2. You will see the LEDs cycle for several seconds and then remain a solid green, indicating that it
is ready to configure/use.
Before you start to configure the Terminal Server, you should set the Terminal Server jumpers if you
want to terminate the line or use the power in pin feature (instead of an external power supply, if your
desktop Terminal Server model supports it).
In some circumstances, the setting of jumpers may be required:
z Terminal Server models where EIA-422/485 line termination is required.
See Appendix C, Setting Jumpers on page 129 to see how to set the jumpers for your Ter mi n al
Server desktop model.
Powering Up the Terminal Server
Hardware and Connectivity 23
3
Introduction
This chapter provides information about the different methods you can use to configure the Terminal
Server. Before you can configure the Terminal Server, you must assign an IP address to the Terminal
Server. See the
Terminal Server.
Once an IP address is assigned to the Terminal Server, you can use any of the configuration methods
to:
z Configure users.
z Configure Terminal Server system parameters.
z Configure serial port parameters.
z Configure network parameters.
z Configure time parameters.
z Reboot the Terminal Server.
z View statistics while connected to an Terminal Server.
Configuration Methods Chapter 3
Chapter 4, Getting Started on page 36 to find out how to assign an IP address to the
Configuration Methods Overview
Some of the Terminal Server configuration methods have the capability of configuring an IP address,
which is the first required configuration step for a new Terminal Server. Once the Terminal Server
has been assigned an IP address, any of the configuration methods can be used to configure the
Terminal Server.
Configures an IP Address
Following is a list of methods for setting the Terminal Server IP address and a short explanation of
when you would want to use that method:
z Easy Config Wizard—The Easy Config Wizard is available from the CD ROM included with
your Terminal Server. You can use the Easy Config Wizard to set the Terminal Server’s IP
address and configure serial ports. This configuration method would typically be used when:
z All ports are to have the same configuration.
z Only the most commonly used profiles are required.
z Straightforward application with no advanced functionality required. Easy Config is
installed on a Windows-based PC with local network access to the Terminal Server.
z DeviceManager—Use this method when you can connect the Terminal Server to the network
and access the Terminal Server from a Windows
application that can be used for Terminal Server configurati o n an d management. The
DeviceManager can be used to assign an IP address and perform the complete configuration and
management of the Terminal Server.
®
PC. The DeviceManager is a Windows-based
Terminal Server User Guide, Version 3.3 24
Easy Config Wizard
z Direct Connection—Use this method when you can connect to the Terminal Server from a
serial terminal or from a computer running terminal emulation software over a serial port. Using
this method, you will need to configure and/or manage the Terminal Server using either the
Menu or CLI.
z DHCP/BOOTP—Use this method when you have a BOOTP or DHCP server running and you
can connect the Terminal Server to your network. The Terminal Server will automatically obtain
an IP address from a local network DHCP/BOOTP server when this service is enabled (it is
disabled by default). You can also configure certain Terminal Server parameters that will be
passed from the DHCP/BOOTP server to the Terminal Server when it boots up. Other
configurators such as DeviceManager, CLI, or Menu can be used to set this option, and obtain
the initial IP address.
z ARP-Ping—Use this method when you can connect the Terminal Server to the network and
want to assign a temporary IP address to the Terminal Server by specifying an ARP entry from
your PC and then pinging it.
z IPv6 Network—When the Terminal Server is connected to an IPv6 network, its local link
address is determined using stateless auto configuration.
Once an IP address has been assigned to the Terminal Server, in most cases, you can continue to use
the same method if it is a configurator or you can switch to any other configuration method.
Requires a Configured IP Address
The following configuration methods require that an IP address already be assigned to the Terminal
Server.
z WebManager—WebManager is a fully functional, browser-based configuration method.
Easy Config Wizard
The Easy Config Wizard is a configuration wizard that will configure all the serial ports on your
Terminal Server to one of the following:
z Printing (not supported on Terminal Server 1-Port models)
z Raw TCP (also referred to as the TCP Sockets in DeviceManager/WebManager)
z Console Management
z Secure Console Management (not supported on Terminal Server 1-Port models)
z Terminal
z Virtual COM Port (COMredirect access)
You can launch the Easy Config Wizard from the installation CD-ROM.
Configuration Methods 25
DeviceManager
The Easy Config Wizard has been designed to walk you through the configuration process for any of
the available configuration options shown on the Welcome window.
DeviceManager
Overview
The DeviceManager is a Windows-based application that can be used to connect to an Terminal
Server to actively manage and configure it or can create new Terminal Server configurations offline.
See
Chapter 5, Using DeviceManager and WebManager on page 44 for information on
configuring/managing the Terminal Server with DeviceManager.
Access Platforms
The DeviceManager can be run from Windows Vista/XP/Server 2003/2000. DeviceManager can be
installed from the product CD-ROM or downloaded from the Black Box website. Unless the
Terminal Server has already been configured with a Gateway, DeviceManager can only access
Terminal Servers in the local subnet. Only the admin user can manage or configure the Terminal
Server via the DeviceManager.
Features
DeviceManager supports the following features:
z The ability to download the same configuration file to several Terminal Servers in one operation.
z The ability to save a configuration file locally in text format, in addition to the binary format.
z The ability to create a configuration file without being connected to an Terminal Server.
z The ability to open a session to a Terminal Server and download a (saved) configuration file to it.
z The ability to download custom files, such as new terminal definitions and a custom la nguage
files to an Terminal Server.
26 Terminal Server User Guide, Version 3.3
Connecting to a Terminal Server Using DeviceManager
Before you can use DeviceManager, you need to install it on your Windows operating system from
the Terminal Server CD-ROM or you can download it from the Black Box website. After the
DeviceManager application is installed, click
DeviceManager to start the application. When you launch the DeviceManager, it will scan the
network for Terminal Servers:
All discovered Terminal Server's will be displayed on the list along with their name and IP address.
When a new Terminal Server is discovered on the network, that has not yet been assigned an IP
address, it will be displayed with an IP Address of Not Configured. To configure the IP address,
click on the Terminal Server and then click the
Start, All Programs, Black Box, DeviceManager,
Assign IP button.
DeviceManager
Choose the method you want to use to assign an IP address to the Terminal Server:
z Type in the IP address that you want to assign to this Terminal Server
z Enable the Have the Terminal Server automatically get a temporary IP Address option. This
will turn on DHCP/BOOTP, so the Terminal Server will attempt to get its IP address from your
DHCP/BOOTP server. If you don’t have a DHCP/BOOTP server, DeviceManager will
temporarily assign an IP address in the range of
169.254.0.1 - 169.254.255.255 that will
be used only for the duration of the DeviceManager/Terminal Server communication.
After you configure the IP address, click the Assign IP button.
The refreshed list will now display the assigned IP address for the new Terminal Server. To connect
to the Terminal Server, click the Terminal Server entry and click
Admin password (the factory defau lt password is
superuser).
OK. You will be asked to supply the
If you have a successful connection, the DeviceManager will retrieve the configuration and then
display the Terminal Server’s System Information and you can begin config uring th e Terminal
Server.
Note:
The DeviceManager does not automatically update the Terminal Server’s configuration. You
must download the configuration changes to the Terminal Server and then reboot the
Terminal Server to make the configuration changes take effect
Configuration Methods 27
WebManager
Using DeviceManager
After you have successfully connected to the Terminal Server, you will see the following window:
Navigation
Tree
Menu Options/Icons
Configuration/Info
You navigate through the different configuration windows by selecting an option in the left-hand
navigation tree. If double-click on option that is next to a folder, more navigation are displayed when
you click on it:
The Network folder contains two configuration options, IP Address and Advanced. Notice that
when the
Settings
When you have completed all your configuration changes, click the Download Changes button to
download the configuration to the Terminal Server. You must reboot the Terminal Server to make
those configuration changes take effect.
and Advanced.
WebManager
Overview
The We b M anager is a web-browser based met hod of configuring/managing an Terminal Server. It
follows the same design as the DeviceManager, so it is easy to switch between the WebManager and
DeviceManager when configuring your Terminal Server. See
WebManager on page 44 for information on configuring/managing the Terminal Server with
DeviceManager.
Download Button
Navigation Tabs
IP Address option is selected, there are more navigation options in the form of the tabs, IP
Chapter 5, Using DeviceManager and
Access Platforms
You can access the Terminal Server through WebManager from any system that can run a web
browser. WebManager can be accessed by the admin user or any user who has Admin Level
privileges.
28 Terminal Server User Guide, Version 3.3
Features
WebManager supports the following features:
z The ability to open a session to a Terminal Server and download a (saved) configuration file to it.
z The ability to download/upload keys/certificates to/from an Terminal Server.
z The ability to download custom files, such as new terminal definitions and a custom la nguag e
files to an Terminal Server.
Connecting to a Terminal Server Using WebManager
Before you can connect to a Terminal Server using WebManager, the Terminal Server must already
be configured with a known IP address; see
address on your Terminal Server.
To connect to an Terminal Server through the We bManager:
1. Open your web browser and type in the IP addr ess of the Terminal Server that you want to
manage/configure and press
Enter; for example: http://123.123.123.123.
2. If you successfully connect to the Terminal Server, a login screen will appear.
Setting Up the Network on page 37 to configure an IP
WebManager
3. If you are accessing the Terminal Server in non-secure HTTP, just type in the Admin password
(the factory default password is
superuser)
Configuration Methods 29
Command Line Interface
Using WebManager
After you have successfully logged into WebManager, you will see the following:
Navigation
Tree
System
Information
You navigate through the different configuration windows by selecting an option in the left-hand
navigation tree. If click on option that is next to a folder, more navigation are displayed when you
click on it:
The Network folder contains two configuration options, IP Address and Advanced. Notice that
when the
Settings
Remember that in the WebManager, it is necessary to press the Apply button to save your changes.
IP Address option is selected, there are more navigation options in the form of the tabs, IP
and Advanced.
Command Line Interface
Overview
The Command Line Interface (CLI) is a command line option for Terminal Server
configuration/management. See the Command Line Interface Refere nce Guid e for a full breakdown
of all the CLI commands and their functionality.
Access Platforms
The CLI is accessed by any application that supports a Telnet session to the Terminal Server’s IP
address, such as Putty, SecureCRT, or from a command prompt. You can also access the CLI from a
dumb terminal or PC connected to a serial port.
Navigation Tabs
30 Terminal Server User Guide, Version 3.3
Features
The CLI supports the following unique features:
z You can access a Terminal Server from any application that supports Telnet.
z Ability to clear the ARP table (cache).
Connecting to a Terminal Server Using the CLI
There are two ways you can access the Terminal Server, through the network (Ethernet connection)
or through the serial connection. If you are accessing the Terminal Server through the network, the
Terminal Server must already have a known IP address configured; see
Connection to Specify an IP Address on page 38 getting started for information on configuring an IP
address.
Through the Network
To connect to the Terminal Server through the network to configure/manage it using the CLI, do the
following:
1. Start a Telnet session to the Terminal Server’s IP address; for example:
telnet 10.10.201.100
Command Line Interface
Using a Direct Serial
2. You will get a Login: prompt. You can login as the admin user or as a user with Admin Level
rights. If the login is successful, you will get a prompt that displays the Terminal Server model
and number of ports:
Login: admin
Password:
Terminal Server 1 Port#
You will see a prompt that di splays the Terminal Server model name and number of serial ports.
You are now ready to start configuring/managing your Terminal Server using the CLI.
Through the Serial Port
To connect to the Terminal Server through the serial port to configure/manage it using the CLI (or
Menu), see
After you have established a connection to the Terminal Server, you will get a Login: prompt. You
can login as the admin user or as a user with Admin Level rights. If the login is successful, you will
get a prompt that displays the Terminal Server model and numb er of ports:
Login: admin
Password:
Terminal Server 1 Port#
You will see a prompt that di splays the Terminal Server model name and number of serial ports. You
are now ready to start configuring/managing your Terminal Server using the CLI
Using a Direct Serial Connection to Specify an IP Address on page 38.
Using the CLI
After you have successfully logged in, you can start configuring/managing the Terminal Server by
typing in commands at the prompt. If you are not sure what commands are available, you can type a
(question mark) at any time during a command to see your options.
See the Command Line Interface Reference Guide for more information about the CLI.
?
Configuration Methods 31
Menu
Menu
Overview
The Menu is a graphical representation of the CLI. You can look up Menu parameter explanations in
the Command Line Interface Reference Guide. The only operations that the Menu does not support
are the downloading and uploading of files to/from an Terminal Server.
Access Platforms
The Menu is accessed by any application that supports a Telnet session to the Terminal Server’s IP
address, such as Putty, SecureCRT, or from a command prompt. You can also access the Menu from
a dumb terminal or PC connected to a serial port.
Features
The Menu supports the following unique feature:
z You can access a Terminal Server from any application that supports Telnet.
z You can access the Terminal Server using a terminal emulator and a serial connection.
Connecting to the Terminal Server Using the Menu
To connect the Terminal Server using the Menu, follow the directions for Connecting to a Terminal
Server Using the CLI on page 31.
Using the Menu
After you have successfully logged in, type screen at the prompt and press Enter. You will be asked
to enter a terminal type, and then you will see the following Menu:
To navigate through the Menu options, do the following:
1. Highlight a Menu option by using the keyboard up and down arrows to navigate the list.
2. When the Menu item you want to access is highlighted, press the Enter key to either get to the
next list of options or to get the configuration screen, depending on what you select.
3. When you are done configuring parameters in a screen, press the Enter key and then the Enter
key again to
4. If you want to discard your changes, press the Esc key to exit a screen, at which point you will
be prompted with
return to the screen so you can press
Accept and exit the form.
Changes will be lost, proceed? (y/n), type y to discard your changes or n to
Enter to submit your changes.
32 Terminal Server User Guide, Version 3.3
5. If there are a number of predefined options availa ble for a field, you can scroll through those
items by pressing the
up/down arrows to highlight the option you want, and then press
DHCP/BOOTP
Overview
Several Terminal Server parameters can be configured through a DHCP/BOOTP server during an
Terminal Server bootup. This is particularly useful for configuring multiple Terminal Servers.
Not all configuration parameters are supported in the DHCP/BOOTP configuration (see
DHCP/BOOTP Parameters on page 34 for supported configuration parameters), so you will need to
use another configuration method, such as DeviceManager, WebManager or CLI, to complete the
configuration.
Features
DHCP/BOOTP supports the following unique features:
z DHCP/BOOTP can supply the Terminal Server’s IP address.
z The DHCP/BOOTP server can configure certain server and user configuration parameters when
the Terminal Server is booted.
z The DHCP/BOOTP server can download a new version of firmware when a Terminal Server is
rebooted.
z The DHCP/BOOTP server can download a full configuration file when a Terminal Server is
rebooted.
DHCP/BOOTP
Space Bar or you can type l (lowercase L) to get a list of options, use the
Enter to select it.
Connecting to the Terminal Server Using DHCP/BOOTP
The Terminal Server will automatically request an IP address from the DCHP/BOOTP server when
the
Obtain IP address automatically using DHCP/ BOOT P parameter is enabled. To enable the
Obtain IP address automatically using DHCP/BOOTP parameter, follow the directions in Using a
Direct Serial Connection to Enable BOOTP/DHCP on page 39.
Using DHCP/BOOTP
To use DHCP/BOOTP, edit the bootp file with Terminal Server configuration parameters. You can
use DHCP/BOOTP to perform the following actions on a single or multiple Terminal Servers on
bootup:
z auto-configure with minimal information; for example, only an IP address
z auto-configure with basic setup information (IP address, subnet/prefix bits, etc.)
z download a new version of firmware
z download a full configuration file
DHCP/BOOTP is particularly useful for multiple installations: you can do all the Terminal Server’s
configuration in one DHCP/BOOTP file, rather than configure each Terminal Server manually.
Another advantage of DHCP/BOOTP is that you can connect a Terminal Server to the network, turn
on its power and let autoconfiguration take place. All the configuration is carried out for you during
the DHCP/BOOTP process.
Configuration Methods 33
SNMP
DHCP/BOOTP Parameters
The following parameters can be set in the DHCP/BOOTP bootp file:
z SW_FILE—The full path, pre-fixed by hostname/IP address (IPv4 or IPv6), and file name of the
firmware update.
z CONFIG_FILE—The full path, pre-fixed by hostname/IP address (IPv4 or IPv6), and file name
of the configuration file. Note: these parameters include clear text user passwords.
z GUI_ACCESS—Access to the Terminal Server from the HTTP WebManager. Values are on or
off.
z SECURITY—Restricts Terminal Server access to devices listed in the Terminal Server’s host
table. Values are
z TFTP_RETRY—The number of TFTP attempts before aborting. This is a numeric value, for
example, 5.
z TFTP_TMOUT—The time, in seconds, before retrying a TFTP download/upload. This is a
numeric value, for example, 3.
z CUSTOM_LANG—The full path, pre-fixed by a hostname/IP address (IPv4 or IPv6), and file
name of a translated language file. For example,
192.101.34.211 /accounting/bb_ds_german.txt.
z EXTRA_TERM1—(EXTRA_TERM2, EXTRA_TERM3) The full path, pre-fixed by a
hostname/IP address (IPv4 or IPv6), and file name of a termcap file for a specific terminal type.
yes or no.
SNMP
Overview
The Terminal Server supports configuration and management through SNMP. SNMP Management
tools (SNMP client/MIB browser software) can be used to set Terminal Server configuration
parameters and/or view Terminal Server statistics.
Before you can configure/manage the Terminal Server using SNMP, although you need to set the
Terminal Server IP address and configure a read-write user for SNMP version 3 or a community for
SNMP version 1 or 2. You can use DeviceManager, CLI, or the Menu to set the IP address and
user/community (don’t forget to reboot the Terminal Server before connecting with the SNMP
manager to make your changes take effect).
Access Platforms
You can access the Terminal Server SNMP MIB from any system that runs your SNMP client/MIB
browser software.
Unique Features
SNMP supports the following unique features:
z You can configure SNMP traps.
z Since not all versions of SNMP support secure communication, password parameters must be set
using another configuration method.
34 Terminal Server User Guide, Version 3.3
Connecting to an Terminal Server Using SNMP
Before you can connect to an Terminal Server through an SNMP Management tool or MIB browser,
you need to set the following components through another configuration metho d.
1. Configure a known IP address on the Terminal Server.
2. Configure a read-write user for SNMP version 3 or a community for SNMP version 1 or 2 on the
Terminal Server.
3. Reboot the Terminal Server to make sure the changes take effect.
To connect to an Terminal Server through an SNMP Management tool or MIB browser, do the
following:
1. Load the blackbox-ds.MIB file from the Terminal Server CD-ROM into your SNMP manager.
SNMP
Note:
You need to have the following MIBs instal led in yo ur SNMP manager (these are
usually part of the standard SNMP client/MIB browser):
z SNMPv2-SMI
z SNMPv2-TC
z IPV6-TC
2. Verify that the read-write user for SNMP version 3 or a community for SNMP version 1 or 2
match the configuration on the Terminal Server.
3. Type in the Terminal Server’s IP address and connect to the Terminal Server.
You are now ready to start configuring the Terminal Server using SNMP.
Using the SNMP MIB
After you have successfully connected to the Terminal Server through your SNMP Management tool
or MIB browser, expand the
parameter folders.The first variable in each folder is the
When you perform a
z 1—Indicates that the container folder is active with no changes.
z 2—Indicates that the container folder is active with change(s).
Once you have completed setting the variables in a folder, you will want to submit your changes to
the Terminal Server. To do this, set the
the
Status variable to 6.
z 4—Indicates that the changes in the container folder are to be submitted to the Terminal Server.
z 6—Indicates that the changes in the container folder are to be discarded.
If you want to save all the changes that have been submitted to the Terminal Server, you need to
expand the
make the configuration changes take effect,
Server.
adminInfo container folder and SET the adminFunction to 1 to write to FLASH. To
BLACKBOX-Terminal-Server-MIB folder to see the Terminal Server’s
Status variable, for example, serviceStatus.
GET on this variable, one of the following values will be returned:
Status variable to 4. If you want to discard the changes, set
SET the adminFunction to 3 to reboot the Terminal
Configuration Methods 35
4
Introduction
There are several different configuration methods available to configure the Terminal Server (see
Chapter 3, Configuration Methods on page 24 for more information). This chapter describes the
three main minimal configuration requirements for the Terminal Server through either Easy Config
Wizard (cannot configure users using this method), DeviceManager, or WebManager:
1. Setting up the network—This minimally consists of configuring an IP address or enabling
DHCP/BOOTP. Once the Terminal Server has an IP address, you can use any configuration
method.
2. Setting up the serial ports—You will want to select the serial port profile that matches the serial
port requirement/scenario for your serial device.
3. Setting up users—This is an optional step, which is only required when your implementation
requires users to access the Terminal Server.
Getting Started Chapter 4
Easy Configuration Wizard
The Easy Config Wizard quickly sets up the Terminal Server’s network configuration and all serial
ports to one of the following:
Terminal Server User Guide, Version 3.3 36
Setting Up the Network
z Printing—(Secure Terminal Server/Secure Device Server/Secure Console Server models only)
Allows hosts on the network to talk to a printer connected to the Terminal Server, using LPD.
z Raw TCP—Allows hosts on the network to communicate with a serial device that requires raw
data throughput (such as a printer or card reader) connected to the Terminal Server serial port.
z Console Management—Allows users on the network to connect to the console port of a server
that is connected to a serial port on the Terminal Server.
z Secure Console Management—(Secure Terminal Server/Secure Device Server/Secure Console
Server models only) Allows users on the network to securely connect to the console port of a
server that is connected to a serial port on the Terminal Server.
z Terminal—Allows a terminal device connected to a serial port on the Terminal Server, to
connect to a specified host on the Network.
z Virtual COM Port (Client-Initiated)—Allows a serial application running on a networked
system to communicate with a serial device attached to the Terminal Server as if it was directly
attached to the networked system. The networked system must be running the COMredirect
software. Use this option if the networked system will be initiating the network connection to
the Terminal Server.
z Virtual COM Port (Server-Initiated)—Allows a serial application running on a networked
system to communicate with a serial device attached to the Terminal Server as if it was directly
attached to the networked system. The networked system must be running the COMredirect
software. Use this option if the Terminal Server will be initiating the network connection to the
networked system
Setting Up the Network
The most important part of setting up the network is assigning an IP address to the Terminal Server,
whether this is a static IP address or enabling a DHCP/BOOTP-assigned IP address. You should also
assign a name to the Terminal Server, to make it easier to recognize. This section deals primarily with
setting the IP address.
Using DeviceManager
To use the DeviceManager, you must first install it on a Windows operating system. The
DeviceManager is able to automatically discover all Terminal Servers on your local network, even if
they have not yet been assigned an IP address. If routers on the network have been setup to propagate
multicasts, DeviceManager will also be able to discover Term inal Server's in other netwo rks. Th e
DeviceManager installation wizard can be found on the CD-ROM included in the Terminal Server
package.
1. Connect the Terminal Server to the network.
2. Power on the Terminal Server.
3. From the CD-ROM that was included in the Terminal Server packaging, select the
DeviceManager link.
4. Click on the link under Location and click Open to automatically start the DeviceManager
installation.
5. Install the DeviceManager by following the installation wizard. On the last window, check the
Yes, I want to launch DeviceManager now. box and click the Finish button.
6. When you launch the DeviceManager, it will automatically scan the local network and display
any Terminal Servers that it can find.
7. Any Terminal Server that does not have an IP address will be displ a yed as Not Configured, with
the
Model and MAC Address to identify the Terminal Server. Highlight the Terminal Server that
you want to assign an IP address to and click the
Assign IP button.
Getting Started 37
Setting Up the Network
8. Choose the method you want to use to assign an IP address to the Terminal Server:
9. You are now ready to configure the Terminal Server. Double-click the Terminal Server you just
10. Expand the Server Configuration folder and select Server. Verify the IP address configuration.
11. To make your edits take effect, you need to download the new configuration file and then reboot
12. Reboot the Terminal Server by selecting Tools, Reboot Server or click the Reboot Terminal
For more information on configuring the Terminal Server using DeviceManager, see Chapter 5,
Using DeviceManager and WebManager on page 44.
z Type in the IP address that you want to assign to this Terminal Server.
z Enable the Have the Terminal Server automatically get a temporary IP address option.
This will turn on DHCP/BOOTP, so the Terminal Server will attempt to get its IP address
from your DHCP/BOOTP server. If you don’t have a DHCP/BOOTP server,
DeviceManager will temporarily assign an IP address in the range of
169.254.255.255 that will be used only for the duration of the DeviceManager/Terminal
169.254.0.1 -
Server communication.
Click the Assign IP button.
configured the IP address for to open a configuration session. Type
default Admin user password) in the Login window and click
You should also enter a name in the
Server Name field to make the Terminal Server easily
superuser (the factory
OK.
identifiable.
the Terminal Server. Download the configuration file to the Terminal Server by selecting
Download Configuration to Unit or click the Download All Changes button.
Server
button.
Tools,
Using WebManager
To use the WebManager as your configurator, you must first assign an IP address to the Terminal
Server. You can use the Easy Config Wizard to assign an IP address to the Terminal Server or any of
the other methods described in this section. Once the IP address is assigned to the Terminal Server,
simply type the IP address into the
Using a Direct Serial Connection to Specify an IP Address
You can connect to the Terminal Server’s serial console port using a PC with a terminal em ulation
package, such as HyperTerminal or a terminal.
1. Connect the Terminal Server to your PC or dumb terminal. Make sure the DIP switch is in
Console mode (desktop models, this sets the Terminal Server serial port 1 to EIA-232). When
connecting a terminal or PC directly (without mod ems), the EIA-232 signals need to be crossed
over (‘null modem’ cable). For RJ45 models, the RJ45 to DB9F adaptor shipped with the unit
will provide this crossover.
2. Using a PC emulation application, such as HyperTerminal, or from a dumb terminal, set the Port
settings to 9600 Baud, 8 Data bits, No Parity, 1 Stop Bits, and No Hardware Flow control to
connect to the Terminal Server.
3. When prompted, type admin for the User and superuser for the Password. You should now see
the a prompt that displays the model type and port number; for example,
port#
4. You are now logged into the Terminal Server and can set the IP address by typing from the
command line using the Command Line Interface (CLI).
Type:
set server internet <ipv4address>
Address field of your web browser and press the Enter key.
Terminal Server 1
.
Where ipv4address is the IP Address being assigned to the Terminal Server.
38 Terminal Server User Guide, Version 3.3
Setting Up the Network
5. Type the following command:
save
6. If you are going to use another configuration me thod, such as WebManager or DeviceManager,
the Terminal Server will need to be re-booted first. On a desktop unit, change the DI P sw itch to
the OFF (Serial) position before re-booting the Terminal Server. Plug the Terminal Server back
in, automatically rebooting the Terminal Server in the process.
7. If you want to complete the configuration using a direct connection, see Command Line
Interface on page 30 and/or Menu on page 32. After you complete configuring the Terminal
Server, it will need to be re-booted for the configuration to take effect. On a desktop unit, change
the DIP switch to the OFF (Serial) position before re-booting the Terminal Server. Plug the
Terminal Server back in, automatically rebooting the Terminal Server in the process.
Using a Direct Serial Connection to Enable BOOTP/DHCP
If you are using BOOTP, you need to add an entry in the BOOTP server for the Terminal Server that
associates the MAC address (found on the back of the Terminal Server) and the IP address that you
want to assign to the Terminal Server. After you have made the MAC address/IP address association
for BOOTP, use the following directions for BOOTP or DHCP.
You can connect to the Terminal Server using a PC with a terminal emulation package, such as
HyperTerminal or a dumb terminal.
1. Connect the Terminal Server to your PC or dumb terminal. Make sure the DIP switch is in
Console mode (desktop models, this sets the Terminal Server serial port to EIA-232). When
connecting a terminal or PC directly (without modems), the EIA-23 2 signals need to be crossed
over (‘null modem’ cable). For RJ45 models, the RJ45 to DB9F adaptor shipped with the unit
will provide this crossover.
2. Using a PC emulation application, such as HyperTerminal, or from a dumb terminal, set the Port
settings to 9600 Baud, 8 Data bits, No Parity, 1 Stop Bits, and No Hardware Flow control to
connect to the Terminal Server.
3. When prompted, type admin for the User and superuser for the Password. You should now
see the a prompt that displays the model type and port number; for example,
1 port#
.
4. You are now logged into the Terminal Server and can set the IP address by typing from the
command line using the Command Line Interface (CLI). Type the following command:
set server internet dhcp/bootp on
Terminal Server
5. Type the following command:
save
6. The the following command:
reboot
7. When the Terminal Server reboots, it will automatically poll for an IP address from the
DHCP/BOOTP server. If you have a Terminal Server with dual Ethernet, each Ethernet
connection will automatically be assigned an IP address, you can access the Terminal Server
through either IP address.
8. To view the DHCP/BOOTP assigned IP address, type the following command:
show interface ethernet
If for some reason it cannot obtain an IP address from your DHCP/BOOTP server, you will have to
either reconnect to the Terminal Server on the console port and reboot it or push the Reset to Factory
button to access the Terminal Server.
Getting Started 39
Setting Up the Network
You are now ready to configure the Terminal Server. See Chapter 3, Configuration Methods on page
24 for information on the different Terminal Server configuration methods.
Using ARP-Ping
You can use the ARP-Ping (Address Resolution Protocol) method to temporarily assign an IP address
and connect to your Terminal Server to assign a permanent IP address. T o use ARP-Ping to
temporarily assign an IP address:
1. From a local UNIX/Linux host, type the following at the system comm and shell prompt:
arp -s a.b.c.d aa:bb:cc:dd:ee:ff
On a Windows® 98 or newer system, type the following at the command prompt:
arp -s a.b.c.d aa-bb-cc-dd-ee-ff
(where a.b.c.d is the IPv4 address you want to temporarily assign to the Terminal Server, and
aa:bb:cc:dd:ee:ff is the Ethernet (MAC) address of T erminal Server (found on the back of
the unit).
2. Whether you use UNIX or Windows®, you are now ready to ping to the Terminal Server. Here is
a UNIX example of the sequence to use:
arp -s 192.168.209.8 00:80:d4:00:33:4e
ping 192.168.209.8
From the ping command issued in step 2, the Terminal Server will pickup and use the IP address
entered into the ARP table in step 1. You are now ready to configure the Terminal Server. See
Chapter 3, Configuration Methods on page 24 for information on the different Terminal Server
configuration methods.
For an IPv6 Network
The Terminal Server has a factory default link local IPv6 address that takes the following format:
Terminal Server MAC Address: 00-80-D4-AB-CD-EF
Link Local Address: fe80::0280:D4ff:feAB:CDEF
The Terminal Server will also listen for IPv6 router advertisements to learn a global address. You do
not need to configure an IPv4 address for a Terminal Server residing in an IPv6 network.
You are now ready to configure the Terminal Server. See Chapter 3, Configuration Methods on page
24 for information on the different Terminal Server configuration methods.
40 Terminal Server User Guide, Version 3.3
Setting Up the Serial Port(s)
The DeviceManager and WebManager have the following serial port profiles that will simplify serial
port setup:
Setting Up the Serial Port(s)
z Console Management—The Console Management profile configures a serial port to provide
network access to a console or administrative port. This profile sets up a serial port to support a
TCP socket that listens for a Telnet connection from the network.
z COMredirect—The COMredirect profile configures a serial port to connect network servers or
workstations running the COMredirect software to a serial device as a virtual COM port. This
profile is ideal for connecting multiple serial ports to a network system or server.
z TCP Sockets—The TCP Sockets profile configures a serial port to allow a serial device to
communicate over a TCP network. The TCP connection can be configured to be initiated from
the network, a serial device connected to the serial port, or both. This is sometimes referred to as
a raw connection or a TCP raw connection.
z UDP Sockets—The UDP Sockets profile configures a serial port to allow communication
between the network and serial devices connected to the Terminal Server using the UDP
protocol.
z Terminal—The Terminal profile configures a serial port to allow network access from a terminal
connected to the Terminal Server’s serial port. This profile is used to access predefined hosts on
the network from the terminal.
z Serial Tunneling—The Serial Tunneling profile configures a serial port to establish a virtual link
over the network to a serial port on another Terminal Server. Both Terminal Server serial ports
must be configured for Serial Tunneling (typically one serial port is configured as a Tunnel
Server and the other serial port as a Tunnel Client).
z Virtual Modem—The Virtual Modem (Vmodem ) profile configures a serial port to simulate a
modem. When the serial device connected to the Terminal Server initiates a modem connection,
the Terminal Server starts up a TCP connection to another Terminal Server configured with a
Virtual Modem serial port or to a host running a TCP application.
Getting Started 41
Setting Up Users
z Modbus Gateway—The Modbus Gateway profile configures a serial port to act as a Modbus
Master Gateway or a Modbus Slave Gateway.
Each serial port profile contains all the parameters that are required to completely configure the serial
port scenario represented by the profile.
To select a serial port profile in the DeviceManager, connect through the DeviceManager to the
Terminal Server you are configuring and select
the serial port you want to configure and then click
Serial, Serial Ports in the navigation pane. Highlight
Edit.
When the default serial port profile Terminal displays, click the Change Profile button and select the
appropriate profile for the serial port. See
information on the serial port profiles and their configuration parameters.
Setting Up Users
When you have a user who is accessing a device connected to a serial port from the network or who
is accessing the network from a device connected to a serial port through the Terminal Server, you
can create a user account and configure the user’s access privileges. Notice that there is a Default
user; the Default user’s parameters are inherited by users accessing a serial port configured for the
T erminal profile with the Conenct to remote system option enabled.
To add a user account, click on the Users page in the navigation pane.
Chapter 7, Configuring Serial Ports on page 56 for more
42 Terminal Server User Guide, Version 3.3
Click the Add button to create a user account.
Setting Up Users
To quickly add a user, fill out the field in the General tab and click OK.
See Chapter 8, Configuring Users on page 96 for more information about the other user parameters
you can configure.
Getting Started 43
Using DeviceManager
5
Introduction
The DeviceManager and WebManager Terminal Server managers have been designed to be very
similar to use. DeviceManager is a Windows-based application and WebManager is a browser-based
application. Both options use the Terminal Server’s IP address to access the Terminal Server; the
DeviceManager can be used to assign an IP address to a new Terminal Server and the WebManager
requires that the Terminal Server already have an IP address before it can be used to configure an
Terminal Server.
When using WebManager, you are required to click the Apply button each time you make a change
to a configuration window/tab. In DeviceManager, you must download your configuration changes to
the Terminal Server either periodically or after you are done with the configuration changes. From
both managers you must reboot the Terminal Server in order for you configuration changes to take
effect.
and WebManager Chapter 5
Terminal Server User Guide, Version 3.3 44
Navigating DeviceManager/WebManager
Navigating DeviceManager/WebManager
The DeviceManager and WebManager have very similar navigat ion methods. The left-hand side of
the manager is the navigation tree and the center is the configuration area. The DeviceManager has
menu and quick access buttons, whereas the WebManager has system information and some
navigation options on the far right-hand side.
DeviceManager
The DeviceManager uses a folder/page navigation tree. You can expand the folders to see the
available configuration pages. When you access a configuration page, you can often navigate the tabs
in the configuration area to access all of the configuration options.
Menu/Quick Access Buttons
Navigation Tree
Configuration Area
Using DeviceManager and WebManager 45
Using DeviceManager to Connect to the Terminal Server
WebManager
The WebManager uses expandable/collapsible buttons with folders and pages for the navigation tree.
You can expand the butt ons to vi ew the folders and pages to see the available configuration options.
When you access a configuration page, you can often navigate the tabs in the configuration area to
access all of the configuration options.
Navigation
Tree
Configuration Area
System Info/
Navigation
Using DeviceManager to Connect to the Terminal
Server
DeviceManager can connect to existing Terminal Servers or assign an IP address to a new Terminal
Server. Whenever you connect to a Terminal Server through the DeviceManager, you connect as the
Admin user and must supply the password for the Admin user.
Populating the Terminal Server List
The first time you start the DeviceManager, the Manage Device Server window will be empty . To
add Terminal Servers to the
z Click the Search Local Network button. This searches the local network segment and
automatically displays any Terminal Servers it finds. Any Terminal Servers found by this method
will be displayed in
Servers that were displayed as
button again.
z Click the Static Server List button to add permanent Terminal Server entries. This also allows
you to add Terminal Servers that are not found on the local network segment with the
Local Network
and resides outside the local network, see
48.
For more information about managing a Terminal Server, see Configuration Files on page 49.
button. To connect to a Terminal Server that is not in the Terminal Server List
Terminal Server List, you can do either of the following:
Type column as Auto. Once you close the DeviceManager, any Terminal
Auto will not be there until you click the Search Local Network
Search
Adding/Deleting Manual Terminal Servers on page
46 Terminal Server User Guide, Version 3.3
Starting a New Session
To start a new session and connect to an Terminal Server using the DeviceManager:
1. Start the DeviceManager by selecting Start, All Programs, Black Box, DeviceManager,
DeviceManager.
2. When the DeviceManager starts, it searches the network for Terminal Servers.
If your Terminal Server is not in the local network and you do not have a multicast enabled
router in your network and therefore is not displayed in the selectable list, but can be pinged
from your PC, you can add it to the selectable list by clicking the
Using DeviceManager to Connect to the Terminal Server
Add button.
Type in the Terminal Server’s IP address and click Add Server. Select the manually added server
to connect to it.
Using DeviceManager and WebManager 47
Using DeviceManager to Connect to the Terminal Server
Assigning a Temporary IP Address to a New Terminal Server
You can temporarily assign an IP address to a Terminal Server that is connected to your local network
segment, for the purpose of connecting to it and downloading a configuration file (containing a
permanent IP address). To temporarily assign an IP address to a Te rminal Server, do the following:
1. Click the Refresh button. The Terminal Server will be displayed in the IP Address column as
Not Configured.
2. Select the new Terminal Server and click the Assign IP button.
3. Type a valid temporary IP address into the address field or, in version 3.2 or higher, enable the
Have the Terminal Server automatically get a temporary IP address. If you enable the
temporary IP address, the Terminal Server will enable DHCP/BOOTP on your Terminal Server
and attempt to get an IP address from the DHCP/BOOTP server (this will permanently enable
DHCP/BOOTP in your Terminal Server’s configuration, until you change it). If your network
does not have a DHCP/BOOTP server, the Terminal Server will temporarily assign an IP address
in the range of
duration of the Terminal Server connection).
4. Click the Assign IP button.
5. Double-click the Terminal Server in the Terminal Server List. If this is the first time you are
accessing the Terminal Server, type in the factory default Admin password,
click
OK. The DeviceManager will display a window indicating that it is trying to authenticate
and connect you on the Terminal Server.
6. If the authentication and connection are successful, the Server Info window is displayed. You are
now ready to configure the Terminal Server. If authentication was unsucce ssful, try to connect to
the Terminal Server again; you probably mistyped the password for the Admin user.
For more information about managing a Terminal Server, see Configuration Files on page 49.
169.254.0.1 - 169.254.255.255 (this IP address is only assigned for the
superuser, and
Adding/Deleting Manual Terminal Servers
To permanently add or delete a Terminal Server to/from the Terminal Server List, click the Add
button.
To permanently add a Terminal Server to the Terminal Server list, type in the IP address of the
Terminal Server and click the
Terminal Server list, select the Terminal Server’s IP address and click the Delete Server button.
Add Server button. To permanently delete a Terminal Server from the
Logging in to the Terminal Server
To log in to a Terminal Server, double-click on the Terminal Server in the Device Server List. You
will be prompted for the Admin Password (the default is
If the authentication and connection are successful, the Terminal Server’s Server Info window is
displayed.
If you cannot connect to a Terminal Server, you can highlight the Terminal Server and click the Ping
button to verify that the DeviceManager can communicate with the Terminal Server’s IP Address. If
the ping times out, then you might need to set up a Gateway in your Terminal Server or verify that
your network is communicating correctly.
superuser).
48 Terminal Server User Guide, Version 3.3
Using WebManager to Connect to the Terminal Server
Using WebManager to Connect to the Terminal
Server
WebManager can only connect to Terminal Servers that already have an assigned IP address. To
connect to the Terminal Server, type the IP address of the Terminal Server into the
such:
http://10.10.234.34.
You will see the login screen.
Address field as
Logging into the Terminal Server
Type in the Admin password in the Password field and click the Login button.
Configuration Files
Creating a New Terminal Server Configuration in DeviceManager
In DeviceManager, when you select File, New, the New Configuration window is displayed.
Select the Terminal Server model for which you want to create a new configuration file. Any
configuration file created in this manner can only be save locally. To download a created
configuration file, you must first connect to the Terminal Server, import the created configuration file
into DeviceManager (this is not available in WebManager), and then download the configuration file
to the Terminal Server and reboot it.
Opening an Existing Configuration File
If you select the File, Open, a browse window is opened so you can select the configuration file you
want to edit. Terminal Server configuration files saved in the DeviceManager can be in the Terminal
Server-native binary format (
Either configuration version can be imported into the DeviceManager. Terminal Server configuration
files saved from WebManager can also be opened into DeviceManager.
.dme) or as a text file (.txt), which can be edited with a text editor.
Using DeviceManager and WebManager 49
Managing the Terminal Server
Importing an Existing Configuration File
If you have a local, saved configuration file that you want to download to the Terminal Server, you
must first connect to the Terminal Server that you want to download the configuration file to. Once
you have successfully logged into the Terminal Server, in DeviceManager select
Configuration from a File
download the file in DeviceManager and in both managers you need to reboot the Terminal Server.
and in W ebManager select Administration, Restore/Backup. You need to
Managing the Terminal Server
Most of the management tasks, such as setting the time/date, downloading firmware, downloading
custom files, resetting serial ports, etc., are found under the
and under
Administration in WebManager.
Tools, Import
Tools menu option in the DeviceManager
50 Terminal Server User Guide, Version 3.3
6
Introduction
The Network section is used to configure the parameters that identify the
T erminal Server within the network and how the Terminal Server accesses
hosts on the network. The following configuration windows are available:
z IP Settings—This window sets up Terminal Server’s name, IP
address, and Ethernet information. See
more information.
z Advanced—This window configures hosts that the Terminal Server will be communicating with
and routes. See
IP Settings
IP Settings
Network Settings Chapter 6
IP Settings on page 51 for
Advanced on page 52 for more information on these options.
Overview
The parameters in IP settings are used to access the Terminal Server and are how the Terminal Server
accesses the network.
Field Descriptions
Configure the following parameters:
System Name The System Name is used for informational purposes by such tools as the
DeviceManager and is also used in conjunction with the Domain field to
construct a fully qualified domain name (FQDN).
Default: localhost
Domain This field is combined with the System Name to construct the fully qualified
domain name (FQDN). For example, if the domain is mycompany.com and
the
Server Name is set to accounting, the FQDN would be
accounting.mycompany.com.
Obtain IP Address
automatically using
DHCP/BOOTP
Use the following
IP Address
When enabled, the Terminal Server will request an IP address from the
DHCP/BOOTP server. By default, when this option is enabled, the Terminal
Server will also attempt to retrieve the DNS server, WINS server, and default
gateway from the DHCP/BOOTP server.
Default: Disabled
Assign a specific IP address to the Terminal Server.
Terminal Server User Guide, Version 3.3 51
Advanced
IP Address The Terminal Server’s unique IPv4 network IP address. If you are using the
Terminal Server in an IPv6 network, this field can be left blank.
Field Options: IPv4 address
Subnet Mask The network subnet mask. For example, 255.255.0.0.
Default Gateway Specify the gateway IP address that will provide general access beyond the
local network.
Field Options: IPv4 address
Advanced
Default Gateway
Obtain
Automatically
When DHCP/BOOTP is enabled, you can enable this option to have the
Terminal Server receive the Default Gateway IP address from the
DHCP/BOOTP server.
Default: Enabled
Overview
The Advanced tab configures the Ethernet interface hardware speed and duplex.
Field Descriptions
Configure the following parameter:
Ethernet1 Speed
and Duplex
Define the Ethernet connection speed.
Data Options:
z Auto—automatically detects the Ethernet interface speed and duplex
z 10 Mbps Half Duplex
z 10 Mbps Full Duplex
z 100 Mbps Half Duplex
z 100 Mbps Full Duplex
Default: Auto
Advanced
Host Table
Overview
The Host table contains the list of hosts that will be accessed by an IP address from the Terminal
Server. This table will contain a symbolic name for the host as well as its IP address. When a host
entry is required elsewhere in the configuration, the symbolic name will be used.
Functionality
You can configure up to 20 hosts using IPv4 or IPv6 internet addresses on desktop Terminal Server
models.
52 Terminal Server User Guide, Version 3.3
Field Descriptions
Configure the appropriate parameters:
Advanced
IP Filtering Data Options:
Add Button Adds a host to the host table.
Edit Button Changes a host that already exists in the host table.
Delete Button Deletes a host from the host table.
Adding/Editing a Host
z Allow all traffic—Allows any host to connect to the Terminal Server.
z Allow traffic only to/from hosts defined with IP addresses—A security
feature that when enabled, the Terminal Server will only accept data from
or send data to hosts configured in the Terminal Server’s
Host Table.
Default: Allow all traffic
Configure the appropriate parameters:
Host Name The name of the host. This is used only for the Terminal Server configuration.
IP Address The host’s IP address.
Text Characteristics: Up to 14 characters, no spaces.
Text Characteristics: IPv4 or IPv6 Address
53
Advanced
Route List
Overview
Entering routes in the routing list enables the identification of gateways to be used for accessing
specific hosts or external networks from the Terminal Server's local network.
Functionality
There are three types of routes:
z Default—A route that provides general access beyond your local network.
z Host—A route defined for accessing a specific host external to your local network.
z Network—A route defined for accessing a specific network external to your local network.
You can specify up to 20 ro utes on desktop Terminal Server models.
Field Descriptions
The following buttons are available:
Add Button Adds a route to the Route List.
Edit Button Changes an existi ng ro ute in the Route List.
Delete Button Deletes a route from the Route List.
Adding/Editing Routes
From the Route List tab, if you click the Add or Edit button, you will be able to add a new or edit an
existing route.
54 Terminal Server User Guide, Version 3.3
Configure the appropriate parameters:
Type Specify the type of route you want to configure.
Data Options:
z Host—A route defined for accessing a specific host external to your local
network.
z Network—A route defined for accessing a specific network external to
your local network.
z Default—A route which provides general access beyond your local
network.
Default: Default
Advanced
IP Address When the route Type is defined as Host, this field will contain the IP address
of the host. If the route
Type is defined as Network, the network portion of the
IP address must be specified and the Host port of the address will be set to 0.
Example: to access network 10.10.20, the address 10.10.20.0 would be
specified in this field.
Format: IPv4 or IPv6 Address
IPv4 Subnet Mask When the route is a Network route, you must specify the network’s subnet
mask.
IPv6 Subnet Bits If the IP address is IPv6, then you must specify the network’s subnet bits.
Range: 0-128
Host The host that is being used at the route gateway.
55
7
Introduction
The Serial section is used to configure the serial ports on your
Terminal Server. The following configuration windows are available:
z Serial Ports—This window sets up the type of connection that
the serial port is being used for. This is accomplished by selecting
a connection profile and then configuring the applicable
parameters for that profile. See
information.
z Advanced—This window configures those parameters that are
applicable to specific environments. You will find modem and
COMredirect configuration options, in addition to others, here. See
more information.
Serial Ports
Configuring Serial Port sChapter 7
Serial Ports on page 56 for more
Advanced on page 93 for
Overview
Each Terminal Serve r serial port can be connected to serial device. Each serial port can then be
configured according to a serial port profile that coincides with the serial device attached to that serial
port and how the serial device is accessed/used.
Functionality
When you select the Serial Ports navigation option, you will see a list with the number of serial ports
on your Terminal Server. As you configure the serial ports, the information for each serial port is
displayed.
To configure/change a serial port, click the Edit button.
Terminal Server User Guide, Version 3.3 56
Serial Ports
Editing a Serial Port
In the Serial Port Settings window, click on a serial port and then click the Edit button, the
following window is displayed:
57
Serial Ports
Click the Change Profile button to select a different serial port profile if you don’t want the
displayed profile:
As you select the different serial port profiles, a short description and a picture representing a typical
application of the profile is displayed. When you have selected the appropriate profile for the serial
port, click
OK and those serial port profile configuration options will be displayed.
Resetting a Serial Port
When you change a serial port’s configuration, you can download the configuration file to the
Terminal Server and then reset a specific serial port(s) to see how you change affects the serial port’s
behavior. To reset a serial port, select
Tools, Reset, Serial Port(s).
58 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Common Tabs
Overview
There are several functions that are common to more than one profile. These functions are:
z Hardware—Configure the physical serial line parameters. See Hardware Tab Field
Descriptions on page 59.
z Packet Forwarding—Configure data packet parameters. See Packet Forwarding Tab Field
Descriptions on page 61.
Hardware Tab Field Descriptions
The Hardware tab configures the serial port hardware connection information.
Serial Port Profiles
Configure the following parameters:
Serial Interface Specifies the type of serial line that is being used with the Terminal Server.
Data Options: EIA-232, EIA-422, or EIA-485.
Speed Specifies the baud rate of the serial line; keep in mind that speed is affected by
the length of the cable. You can also specify a custom baud rate. When you
enter a custom baud rate, the Terminal Server will calculate the closest baud
rate available to the hardware. The exact baud rate calculated can be viewed in
the
Serial Ports statistics.
Range: 50-230400, custom supports 50-1843200
Default: 9600
Data Bits Specifies the number of bits in a transmitted character.
Default: 8
Parity Specifies the type of parity being used for the data communication on the serial
port. If you want to force a parity type, you can specify Mark for 1or Space for
0.
Data Options: Even, Odd, Mark, Space, None
Default: None
59
Serial Port Profiles
Stop Bits Specifies the number of stop bits that follow a byte.
Data Options: 1,1.5, 2
Default: 1
Duplex Used with a EIA-485 serial interface, specify whether the serial port is Full
Duplex (communication both ways at the same time) or Half Duplex
(communication in one direction at a time).
Default: Full
TX Driver Control Used with a EIA-485 serial interface, if your application supports RTS
(Request To Send), select this option. Otherwise, select
Auto.
Default: Auto
Flow Control Defines whether the data flow is handled by the software (Soft), hard ware
(
Hard), Both, or None.
Data Options: Soft, Hard, Both, None
Default: None
Enable Inbound
Flow Control
Enable Outbound
Flow Control
Determines if input flow control is to be used.
Default: Enabled
Determines if output flow control is to be used.
Default: Enabled
Monitor DSR Specifies whether the EIA-232 signal DSR (Data Set Ready) should be
monitored. This is used with modems or any device that sends a DSR signal.
When it is monitored and the Terminal Server detects a DSR signal, the line
profile is started. If both
Monitor DCD and Monitor DSR are enabled, both
signals must be detected before the line profile is started.
Default: Disabled
Monitor DCD Specifies whether the EIA-232 signal DCD (Data Carrier Detect) should be
monitored. This is used with modems or any other device that sends a DCD
signal. When it is monitored and the T erminal Server detects a DCD signal, the
line profile is started. If both
Monitor DCD and Monitor DSR are enabled, both
signals must be detected before the line profile is started.
Default: Disabled
Enable Echo
Suppression
This parameter applies only to EIA-485 Half Duplex mode. All characters will
be echoed to the user and transmitted across the serial ports. Some EIA-485
applications require local echo to be enabled in order to monitor the loopback
data to determine that line contention has occurred. If your application cannot
handle loopback data, echo suppression should be enabled.
Default: Disabled
60 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Packet Forwarding Tab Field Descriptions
The Packet Forwarding tab can be used to control/define how and when data packets are sent from
the Terminal Server.
Configure the following parameters:
Minimize Latency This option ensures that any data received on the serial port will immediately
be forwarded to the LAN. Select this option for timing-sensitive applications.
Default: Enabled
Optimize Network
Throughput
This option provides optimal network usage while ensuring that the application
performance is not compromised. Select this option when you want to
minimize overall packet count, such as when the connection is over a WAN.
Default: Disabled
Prevent Message
Fragmentation
This option detects the message, packet, or data blocking characteristics of the
serial data and preserves it throughout the communication. Select this option
for message-based applications or serial devices that are sensitive to
inter-character delays within these messages.
Default: Disabled
Delay Between
Messages
The minimum time, in milliseconds, between messages that must pass before
the data is forwarded by the Terminal Server.
Range: 0-65535
Default: 250 ms
Custom Packet
Forwarding
This option allows you to define the packet forwarding rules based on the
packet definition or the frame definition.
Default: Disabled
61
Serial Port Profiles
Packet Definition When enabled, this group of parameters allows you to set a variety of packet
definition options. The first criteria that is met causes the packet to be
transmitted. For example, if you set a
Packet Size of 100 bytes, whichever criteria is met first is what will cause the
Force Transmit Timer of 1000 ms and a
packet to be transmitted.
Default: Enabled
Packet Size The number of bytes that must be received from the serial port before the
packet is transmitted to the network. A value of zero (0) ignores this parameter.
Range: 0-1024 bytes
Default: 0
Idle Time The amount of time, in milliseconds, that must elapse between characters
before the packet is transmitted to the network. A value of zero (0) ignores this
parameter.
Range: 0-65535 ms
Default: 0
Enable Trigger1
Character
When enabled, specifies the character that when received will define when the
packet is ready for transmission. The transmission of the packet is based on the
Trigger Forwarding Rule.
Range: Hex 0-FF
Default: 0
Enable Trigger2
Character
When enabled, creates a sequence of characters that must be received to
specify when the packet is ready for transmission (if the End Trigger1
character is not immediately followed by the End Trigger2 character, the
Terminal Server waits for another End Trigger1 character to start the End
Trigger1/End Trigger2 character sequence). The transmission of the packet is
based on the Trigger Forwarding Rule.
Range: Hex 0-FF
Default: 0
Frame Definition When enabled, this group of parameters allows you to control the frame that is
transmitted by defining the start and end of frame character(s). If the internal
buffer (1024 bytes) is full before the EOF character(s) are received, the packet
will be transmitted and the EOF character(s) search will continue.
Default: Disabled
SOF1 Character When enabled, the Start of Frame character defines the first character of the
frame, any character(s) received before the Start of Frame character is ignored.
Range: Hex 0-FF
Default: 0
SOF2 Character When enabled, creates a sequence of characters that must be received to create
Transmit SOF
Character(s)
62 Terminal Server User Guide, Version 3.3
the start of the frame (if the SOF1 character is not immediately followed by the
SOF2 character, the Terminal Server waits for another SOF1 character to start
the SOF1/SOF2 character sequence).
Range: Hex 0-FF
Default: 0
When enabled, the SOF1 or SOF1/SOF2 characters will be transmitted with
the frame. If not enabled, the SOF1 or SOF1/SOF2 characters will be stripped
from the transmission.
Default: Disabled
Serial Port Profiles
EOF1 Character Specifies the End of Frame character, which defines when the frame is ready to
be transmitted. The transmission of the frame is based on the Trigger
Forwarding Rule.
Range: Hex 0-FF
Default: 0
EOF2 Character When enabled, creates a sequence of characters that must be received to define
the end of the frame (if the EOF1 character is not immediately followed by the
EOF2 character, the Terminal Server waits for another EOF1 character to start
the EOF1/EOF2 character sequence), which defines when the frame is ready to
be transmitted.
Range: Hex 0-FF
Default: 0
Trigger
Forwarding Rule
Determines what is included in the Frame (based on the EOF1 or EOF1/EOF2)
or Packet (based on Trigger1 or Trigger1/Trigger2). Choose one of the
following options:
z Strip-Trigger—Strips out the EOF1, EOF1/EOF2, Trigger1, or
z Trigger—Includes the EOF1, EOF1/EOF2, Trigger1, or
z Trigger+1—Includes the EOF1, EOF1/EOF2, Trigger1, or
z Trigger+2—Includes the EOF1, EOF1/EOF2, Trigger1, or
Default: Trigger
Console Management Profile
Overview
The Console Management profile provides access through the network to a console or administrative
port of a server or router attached to the Terminal Server’s serial port. This profile configures the
Terminal Server’s serial port to set up a TCP socket that will listen for a Telnet connection from the
network.
Trigger1/Trigger2, depending on your settings.
Trigger1/Trigger2, depending on your settings.
Trigger1/Trigger2, depending on your settings, plus the first byte that
follows the trigger.
Trigger1/Trigger2, depending on your settings, plus the next two bytes
received after the trigger.
Functionality
Use the Console Management profile when you are configuring users who need to access a serial
console port from the network.
63
Serial Port Profiles
General Tab Field Descriptio ns
The Console Management General tab configures how the serial port will be accessed by the user
through the network.
Configure the following parameters:
Protocol Specify the connection method that users will use to communicate with a serial
device connected to the Terminal Server through the network.
Default: Telnet
Listen for
Connections on
TCP Port
Enable IP Aliasing Enables/disables the ability to access a serial device connected to the serial port
IP Address Users can access serial devices connected to the Terminal Server through the
The port number that the Terminal Server will listen on for incoming TCP
connections.
Default: 10001, depending on the serial port number
by an IP address (or host name that can be resolved to the Internet Address in a
DNS network) instead of the Terminal Server’s IP address and port number.
Default: Disabled
network by the specified Internet Address (or host name that can be resolved to
the Internet Address in a DNS network).
Data Options: IPv4 Address
Advanced Tab Field Descriptions
The Console Management Advanced tab configures serial port options that may be required by
certain applications.
Configure the following parameters:
64 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Authenticate User Enables/disables login/password authentication for users connecting from the
network.
Default: Disabled
Enable TCP Keep
Alive
Enables a per-connection TCP keepalive feature. This feature when enabled,
periodically checks if the TCP connection is still active. The period is
configurable on a global basis for the Terminal Server. If the connection is no
longer active, the Terminal Server will cleanly terminate the session at its end.
This parameter needs to be used in conjunction with
Status Interval
parameter found in the Serial, Advanced, Advanced Settings
Monitor Connection
tab. The interval determines how long the Terminal Server will wait during
inactivity before "testing" the connection. It should be noted that if a network
connection is accidentally dropped, it can take as long as the specified interval
before anyone can reconnect to the serial port.
Default: Disabled
Enable Message of
the Day (MOTD)
Enables/disables the display of the message of the day.
Default: Disabled
Multisessions The number of extra network connections available on a serial port (available
only on 2 port+ models), in addition to the single session that is always
available. Enabling multisessions will permit multiple users to monitor the
same console port. Each user monitoring the port can be assigned different
privileges to this port.
Data Range: 0-7 multisessions per serial port
Default: 0
Idle Timeout Use this timer to close a connection because of inactivity. When the Idle
Timeout expires, the Terminal Server will end the connection.
Default:
0 seconds so the port will never timeout
Range: 0-4294967 seconds (about 49 days)
Break Handling Specifies how a break is interpreted.
Data Range:
z None—The T erminal Server ignores the break key completely and it is not
passed through to the host.
z Local—The Terminal Server deals with the break locally. If the user is in
a session, the break key has the same effect as a hot key.
z Remote—When the break key is pressed, the Terminal Server translates
this into a telnet break signal which it sends to the host machine.
z Break Interrupt—On some systems such as SunOS, XENIX, and AIX, a
break received from the peripheral is not passed to the client properly. If
the client wishes to make the break act like an interrupt key (for example,
when the stty options
-ignbrk and brkintr are set).
Default: None
Dial In If the console port is remote and will be dialing in via modem or ISDN TA,
enable this parameter.
Default: Disabled
Dial Out If you want the modem to dial a number when the serial port is started, enable
this parameter.
Default: Disabled
65
Serial Port Profiles
Dial Timeout The number of seconds the Terminal Server will wait to establish a connection
Dial Retry The number of times the Terminal Server will attempt to re-establish a
Modem The name of the predefined modem that is used on this line.
Phone The phone number to use when Dial Out is enabled.
COMredirect Profile
Overview
COMredirect is COM Port redirector that is supplied with the Terminal Server. COMredirect can be
installed as a client on a Workstation or Server and supports a variety of operating systems. It, in
conjunction with the Terminal Server, COMredirect emulates a local serial port (COM port), to the
application, to provide connectivity to a remote serial device over the network. The COMredirect
profile operates in conjunction with the COMredirect software.
to a remote modem.
Range: 1-99
Default: 45 seconds
connection with a remote modem.
Range: 0-99
Default: 2
Functionality
COMredirect is a COM port redirector utility for the Terminal Server. It can be run in two modes
(these modes will be set on the client software when it is configured):
z COMredirect Full mode—This mode allows complete device control and operates as if the
device was directly connected to the Workstation/Server’s local serial port. It provides a
complete COM port interface between the attached serial device and the network. All serial
controls, baud rate control, etc., are sent to the Terminal Server and replicated on its associated
serial port.
z COMredirect Lite mode—This mode provides a simple raw data interface between the
application and the remote serial port. Although the port will still operate as a COM port, control
signals are ignored. In this mode, the serial communications parameters must be configured on
the Terminal Server.
See the COMredirect User Guide for more details about the COMredirect client softw a re.
66 Terminal Server User Guide, Version 3.3
Serial Port Profiles
General Tab Field Descriptio ns
The COMredirect General tab determines how the COMredirect connection is initiated and then sets
up the appropriate connection parameters.
Configure the following parameters:
Connect to remote
system
When enabled, the Terminal Server initiates communication to the
COMredirect client.
Default: Enabled
Host Name The configured host that the Terminal Server will connect to (must be running
COMredirect).
Default: None
TCP Port The TCP Port that the Terminal Server will use to communicate through to the
COMredirect client.
Default: 10001 for serial port 1, then increments by one for each serial port
Connect to
Multiple Hosts
When enabled, the Terminal Server will establish a connection to multiple
clients (Hosts). When using the multiple hosts feature, all COMredirect clients
must be running in Lite mode.
Default: Disabled
Define Additional
Hosts Button
Click this button to define the hosts that this serial port will connect to. This
button is also used to define the Primary/Backup host functionality.
See Adding/Editing Additional COMredirect Hosts on page 68 for more
information.
Listen for
Connection
When enabled, the Terminal Server will wait for connections to be initiated by
the COMredirect Client.
Default: Disabled
TCP Port The TCP Port that the Terminal Server will use to communicate through to the
COMredirect client.
Default: 10001 for serial port 1, then increments by one for each serial port
Allow Multiple
Hosts to Connect
When this option is enabled, multiple hosts can connect to a serial device that
is connected to this serial port. Note: These multiple clients (Hosts) need to be
running COMredirect in Lite mode.
Default: Disabled
67
Serial Port Profiles
Adding/Editing Additional COMredirect Hosts
You can define a list of hosts that the serial device will communicate to through COMredirect Lite or
a primary/backup host.
Configure the following parameters:
Define additional
hosts to connect to
When this option is enabled, you can define up to 49 hosts that the serial device
connected to this serial port will attempt communicate to. With this mode of
operation, the Terminal Server will connect to multiple hosts simultaneously.
Default: Enabled
Add Button Click the Add button to add a host to the list of hosts that will be receiving
communication from the serial device connected to the Terminal Server.
See Adding/Editing a Multihost Entry on page 68 for more information.
Edit Button Highl ight an existing host and click the Edit button to edit a host in the list of
hosts that will be receiving communication from the serial device connected to
the Terminal Server.
Delete Button Highlight an existing host and click the Edit button to edit a host in the list of
hosts that will be receiving communication from the serial device connected to
the Terminal Server.
Define a primary
host and backup...
When this option is enabled, you need to define a primary host that the serial
device connected to this serial port will communicate to and a backup host, in
the event that the Terminal Server looses communication to the primary host.
The Terminal Server will first establish a connection to the primary host.
Should the connection to the primary host be lost (or never established), the
T erminal Server will establish a connection the backup host. Once connected to
the backup, the Terminal Server will attempt to re-establish a connection to the
Primary host, once this is successfully done, it gracefully shuts down the
backup connection.
Default: Disabled
Primary Host Specify a preconfigured host that the serial device will communicate to through
the Terminal Server.
Default: None
TCP Port Specify the TCP port that the Terminal Server will use to communicate to the
Primary Host.
Default: 0
Backup Host Specify a preconfigured host that the serial device will communicate to through
the Terminal Server if the Terminal Server cannot communicate with the
Primary Host.
Default: None
TCP Port Specify the TCP port that the Terminal Server will use to communicate to the
Backup Host.
Default: 10000
Adding/Editing a Multihost Entry
When you click the Add or Edit button, the Host Entry window appears. The hosts in the multihost
list must already be defined. If you add a host that was defined with its fully qualified domain name
(FQDN), it must be resolvable by your configured DNS server.
Configure the following parameters:
68 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Host Name Specify the preconfigured host that will be in the multihost list.
Default: None
TCP Port Specify the TCP port that the Terminal Server will use to communicate to the
Primary Host.
Default: 10000 + serial port number - 1 (so serial port 2 defaults to 10001)
Advanced Tab Field Descriptions
The COMredirect Advanced tab determines how the COMredirect connection is initiated and then
sets up the appropriate connection parameters.
Configure the following parameters:
Signals high
when...
When a COMredirect line becomes active, this option has the following
impact:
z COMredirect Lite Mode—When enabled, the EIA-232 signals remain
high (active) before, during, and after the COMredirect session. When
disabled, the EIA-232 signals remain low (inactive).
z COMredirect Full Mode—During the session, the COMredirect client
will be control the state of these signal before and after the connection.
Default: Enabled
Enable Message of
the Day (MOTD)
Enables/disables the display of the message of the day.
Default: Disabled
Idle Timeout Use this timer to close a connection because of inactivity. When the Idle
Timeout expires, the Terminal Server will end the connection.
Default:
0 seconds so the port will never timeout
Range: 0-4294967 seconds (about 49 days)
Session Timeout Use this timer to forcibly close the session/connection when the Session
Timeout expires.
Default:
0 seconds so the port will never timeout
Range: 0-4294967 seconds (about 49 days)
69
Serial Port Profiles
Dial In If the device is remote and will be dialing in via modem or ISDN TA, enable
this parameter.
Default: Disabled
Dial Out If you want the modem to dial a number when the serial port is started, enable
this parameter.
Default: Disabled
Dial Timeout The number of seconds the Terminal Server will wait to establish a connection
to a remote modem.
Range: 1-99
Default: 45 seconds
Dial Retry The number of times the Terminal Server will attempt to re-establish a
connection with a remote modem.
Range: 0-99
Default: 2
Modem The name of the predefined modem that is used on this line.
Phone The phone number to use when Dial Out is enabled.
TCP Sockets Profile
Overview
The TCP Socket profile allows for a serial device to communicate over a TCP network. The TCP
connection can be initiated from a host on the network and/or a serial device. This is typically used
with an application on a Workstation or Server that communicates to a device using a specific TCP
socket. This is often referred to as a RAW connection.
Functionality
The TCP Sockets profile permits a raw connection to be established in either direction, meaning that
the connection can be initiated by either the Workstation/Server or the Terminal Server.
70 Terminal Server User Guide, Version 3.3
General Tab Field Descriptions
Serial Port Profiles
Configure the following parameters:
Listen for
Connection
When enabled, the Terminal Server listens for a connection to be established
by the Workstation/Server on the network.
Default: Enabled
TCP Port The TCP port that the Term inal Server will use to listen for incoming
connections.
Default: 10000 plus the serial port number, so serial port 2 would have a
default of 10002
Allow Multiple
Hosts to Connect
When this option is enabled, multiple hosts can connect to the serial device that
is connected to this serial port.
Default: Disabled
Connect To When enabled, the Terminal Server initiates communication to the
Workstation/Server.
Default: Disabled
Host Name The name (resolvable via DNS) or IP address of the configured host the
Terminal Server will connect to.
TCP Port The TCP Port that the Terminal Server will use to communicate to the client.
Default: 0
Connect to
Multiple Hosts
When enabled, allows a serial device connected to this serial port to
communicate to multiple hosts.
Default: Disabled
Define Additional
Hosts Button
Click this button to define the hosts that this serial port will connect to. This
button is also used to define the Primary/Backup host functionality.
71
Serial Port Profiles
Initiate Connection
Automatically
If the serial port hardware parameters have been setup to monitor DSR or
DCD, the host session will be started once the signals are detected. If no
hardware signals are being monitored, the Terminal Server will initiate the
session immediately after being powered up.
Default: Enabled
Initiate Connection
When any data is
received
Initiate Connection
When <hex value>
is received
Permit
Connections in
Both Directions
Initiates a connection to the specified host when any data is received on the
serial port.
Default: Disabled
Initiates a connection to the specified host only when the specified character is
received on the serial port.
Default: Disabled
When this option is enabled, the connection can be initiated by either the
Terminal Server or a host.
Default: Disabled
Adding/Editing Additional Hosts
You can define a list of hosts that the serial device will communicate to or a primary/backup host.
Configure the following parameters:
Define additional
hosts to connect to
When this option is enabled, you can define up to 49 hosts that the serial device
connected to this serial port will attempt communicate to. With this mode of
operation, the Terminal Server will connect to multiple hosts simultaneously.
Default: Enabled
Add Button Click the Add button to add a host to the list of hosts that will be receiving
communication from the serial device connected to the Terminal Server.
Edit Button Highl ight an existing host and click the Edit button to edit a host in the list of
hosts that will be receiving communication from the serial device connected to
the Terminal Server.
Delete Button Click the Delete button to delete a host to the list of hosts that will be receiving
communication from the serial device connected to the Terminal Server.
Define a primary
host and backup...
When this option is enabled, you need to define a primary host that the serial
device connected to this serial port will communicate to and a backup host, in
the event that the Terminal Server looses communication to the primary host.
The Terminal Server will first establish a connection to the primary host.
Should the connection to the primary host be lost (or never established), the
T erminal Server will establish a connection the backup host. Once connected to
the backup, the Terminal Server will attempt to re-establish a connection to the
Primary host, once this is successfully done, it gracefully shuts down the
backup connection.
Default: Disabled
Primary Host Specify a preconfigured host that the serial device will communicate to through
the Terminal Server.
Default: None
TCP Port Specify the TCP port that the Terminal Server will use to communicate to the
Primary Host.
Default: 0
72 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Backup Host Specify a preconfigured host that the serial device will communicate to through
the Terminal Server if the Terminal Server cannot communicate with the
Primary Host.
Default: None
TCP Port Specify the TCP port that the Terminal Server will use to communicate to the
Backup Host.
Default: 10000
Adding/Editing a Multihost Entry
When you click the Add or Edit button, the Host Entry window appears. The hosts in the multihost
list must already be defined (see
host that was defined with its fully qualified domain name (FQDN), it must be resolvable by your
configured DNS server.
Configure the following parameters:
Host Name Specify the preconfigured host that will be in the multihost list.
Default: None
TCP Port Specify the TCP port that the Terminal Server will use to communicate to the
Host.
Default: 0
Host Table on page 52 to learn how to create a host). If you add a
Advanced Tab Field Descriptions
Configure the following parameters:
Authenticate User Enables/disables login/password authentication for users connecting from the
network.
Default: Disabled
73
Serial Port Profiles
Enable TCP
Keepalive
Enables a per-connection TCP keepalive feature. This feature when enabled,
periodically checks if the TCP connection is still active. The period is
configurable on a global basis for the Terminal Server. If the connection is no
longer active, the Terminal Server will cleanly terminate the session at its end.
This parameter needs to be used in conjunction with
Status Interval
parameter found in the Serial, Advanced, Advanced Settings
Monitor Connection
tab. The interval determines how long the Terminal Server will wait during
inactivity before "testing" the connection. It should be noted that if a network
connection is accidentally dropped, it can take as long as the specified interval
before anyone can reconnect to the serial port.
Default: Disabled
Enable Message of
the Day (MOTD)
Enables/disables the display of the message of the day.
Default: Disabled
Idle Timeout Use this timer to close a connection because of inactivity. When the Idle
Timeout expires, the Terminal Server will end the connection.
Default:
0 seconds so the port will never timeout
Range: 0-4294967 seconds (about 49 days)
Session Timeout Use this timer to forcibly close the session/connection when the Session
Timeout expires.
Default:
0 seconds so the port will never timeout
Range: 0-4294967 seconds (about 49 days)
Dial In If the device is remote and will be dialing in via modem or ISDN TA, enable
Dial Out If you want the modem to dial a number when the serial port is started, enable
Dial Timeout The number of seconds the Terminal Server will wait to establish a connection
Dial Retry The number of times the Terminal Server will attempt to re-establish a
Modem The name of the predefined modem that is used on this line.
Phone The phone number to use when Dial Out is enabled.
UDP Sockets Profile
this parameter.
Default: Disabled
this parameter.
Default: Disabled
to a remote modem.
Range: 1-99
Default: 45 seconds
connection with a remote modem.
Range: 0-99
Default: 2
Overview
When you configure UDP, you are setting up a range of IP addresses and th e port numbers that you
will use to send UDP data to or receive UDP data from.
74 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Functionality
The UDP profile configures a serial port to broadcast UDP data to systems and/or receive UDP data
from systems.
An example UDP configuration is described based on the following window.
The UDP configuration window, taken from the DeviceManager, is configured to:
z UDP Entry 1
All hosts that have an IP address that falls within the range of 172.16.1.1 to 172.16.1.25
and listen to
Port 33001 will be sent the data from the serial device in UDP format. The serial
device will only receive UDP data from the hosts in that range with a source
Terminal Server will listen for data on the port value configured in the
on UDP port
z UDP Entry 2
parameter.
All UDP data received from hosts that have an IP address that falls within the range of
172.16.1.20 to 172.16.1.50 and Port 33010 will be sent to the serial device. The Terminal
Server will not send any data received on its serial port.
z UDP Entry 3
Port of 33001. The
Listen for connections
75
Serial Port Profiles
All hosts that have an IP Address that falls within the range of 172.16.1.75 to 172.16.1.80
and who listen to
will listen for messages on the port value configured in the
Port 33009 will receive UDP data from the serial device. The Terminal Server
Listen for connections on UDP port
parameter. No UDP data will be sent to the serial device.
z UDP Entry 4
This entry is disabled since Direction is set to Disabled.
General Tab Field Descriptions
Configure the following parameters:
Listen for
connections on
UDP port
The Terminal Server will listen for UDP packets on the specified port.
Default: 1000+<port-number> (for example, 10001 for serial port 1)
Direction The direction in which information is received or relayed:
z Disabled—UDP service not enabled.
z LAN to Serial—UDP Port can be set to Auto-learn or Port. The Terminal
Server will listen on port value configured in the
on UDP port
parameter for messages coming from the learned or
Listen for connections
configured port.
z Serial to LAN—UDP Port can be set to Port only. The Terminal Server
will forward data received on the serial port to the IP address range, UDP
port configured for this entry.
z Both—Messages are relayed in both directions. UDP Port can be set to
Auto-learn or Port. For messages coming from the LAN to the serial
device, Terminal Server will listen on port value configured in the
for connections on UDP port
parameter for messages coming from the
learned or configured port. For messages going from the serial device to
the LAN, the Terminal Server will forward the data to the IP address range
and UDP port configured for this entry. If
Auto-learn is enabled, the
Terminal Server must receive a UDP message before it can send one, since
the UDP port number is learned from the received message.
Listen
76 Terminal Server User Guide, Version 3.3
Start IP Ad dress The first host IP address in the range of IP addresses (fo r IP V4 or IPV6) that
End IP Address The last host IP address in the range of IP addresses (for IPV4, not required for
Autolearn The Terminal Server will only listen to the first port that it receives a UDP
Any Port The Terminal Server will receive messages from any port sending UDP
Port The port that the Terminal Server will use to relay messages to servers/hosts or
Terminal Profile
Serial Port Profiles
the Terminal Server will listen for messages from and/or send messages to.
IPV6) that the Terminal Server will listen for messages from and/or send
messages to.
packet from. Applicable when
packets. Applicable when
the port from which the Terminal Server will receive messages to be forwarded
to the serial port. This option works with any
Terminal Server will listen for UDP packets on the port configured by the
Listen for connections on UDP port parameter.
Default: 0 (zero)
Direction is set to LAN to Serial or Both.
Direction is set to LAN to Serial.
Direction except Disabled. The
Overview
The Terminal profile allows network access from a terminal connected to the Terminal Server’s serial
port. This profile is used to access pre-defined hosts on the network from the terminal.
Functionality
This profile can be setup in two ways:
1. The user can be required to log into the Terminal Server and then a connection to a host can be
established.
2. The user connecting to the serial port will be directly connected a host.
General Tab Field Descriptions
Configure the following parameters:
77
Serial Port Profiles
Terminal Type Specifies the type of terminal connected to the line.
Data Options:
z Dumb
z WYSE60
z VT100
z ANSI
z TVI925
z IBM3151TE
z VT320 (specifically supporting VT320-7)
z HP700 (specifically supporting HP700/44)
z Term1, Term2, Term3 (user-defined terminals)
Default: Dumb
Require Login When users access the Terminal Server through the serial port, they must be
authenticated using the local user database.
Default: Enabled
User Service
Settings Button
After a user has been successfully authenticated, the Terminal Server will
connect to the specified host using the specified protocol according to:
z the User Service parameter for locally configured users
z the Default User Service parameter for users who are externally
authenticated
See User Service Settings on page 80 for field descriptions of the various User
Service Settings.
Connect to Remote
System
When the serial port is started, the Terminal Server will initiate a connection to
the specified host using the specified protocol. With this option, user
authentication will not be performed by the Terminal Server.
Default: Disabled
Protocol Specify the protocol that will be used to connect to the specified host.
Default: Telnet
Settings Button Click th is button to define the settings for the protocol that will be used to
connect the user to the specified host.
Host Name The name (resolvable via DNS) or IP address of the configured host the
Terminal Server will connect to.
TCP Port The TCP Port that the Terminal Server will use to connect to the host.
Default: 23
Automatically If the serial port hardware parameters have been setup to monitor DSR or
DCD, the host session will be started once the signals are detected. If no
hardware signals are being monitored, the Terminal Server will initiate the
session immediately after being powered up.
Default: Enabled
When any data is
received
Initiates a connection to the specified host when any data is received on the
serial port.
Default: Disabled
78 Terminal Server User Guide, Version 3.3
Serial Port Profiles
When <hex value>
is received
Initiates a connection to the specified host only when the specified character is
received on the serial port.
Default: Disabled
Advanced Tab Field Descriptions
Configure the following parameters:
Enable Message of
the Day (MOTD)
Reset Terminal on
disconnect
Enables/disables the display of the message of the day.
Default: Disabled
When enabled, resets the terminal definition connected to the serial port when
a user logs out.
Default: Disabled
Allow Port Locking When enabled, the user can lock his terminal with a password using the
Hotkey Prefix (default Ctrl-a) ^a l (lowercase L). The Terminal Server
prompts the user for a password and a confirmation.
Default: Disabled
79
Serial Port Profiles
Hotkey Prefix The prefix that a user types to lock a serial port or redraw the Menu.
Data Range:
z ^a l—(Lowercase L) Locks the serial port until the user unlocks it. The
user is prompted for a password (any password, excluding spaces) and
locks the serial port. Next, the user must retype the password to unlock the
serial port.
z ^r—When you switch from a session back to the Menu, the screen may
not be redrawn correctly. If this happens, use this command to redraw it
properly. This is always
You can use the
Port Locking
Hotkey Prefix key to lock a serial port only when the Allow
parameter is enabled.
Ctrl R, regardless of the Hotkey Prefix.
Default: Hex 01 (Ctrl-a, ^a)
Idle Timeout Use this timer to close a connection because of inactivity. When the Idle
Timeout expires, the Terminal Server will end the connection.
Default:
0 seconds so the port will never timeout
Range: 0-4294967 seconds (about 49 days)
Session Timeout Use this timer to forcibly close the session/connection when the Session
Timeout expires.
Default:
0 seconds so the port will never timeout
Range: 0-4294967 seconds (about 49 days)
Dial Timeout The number of seconds the Terminal Server will wait to establish a connection
Dial Retry The number of times the Terminal Server will attempt to re-establish a
Dial In If the device is remote and will be dialing in via modem or ISDN TA, enable
Dial Out If you want the modem to dial a number when the serial port is started, enable
User Service Settings
Login Settings
These settings apply to users who are accessing the network from a terminal connected to an
Terminal Server serial port. The Telnet settings take effect when the connection method is defined in
the user’s profile.
to a remote modem.
Range: 1-99
Default: 45 seconds
connection with a remote modem.
Range: 0-99
Default: 2
this parameter.
Default: Disabled
this parameter.
Default: Disabled
80 Terminal Server User Guide, Version 3.3
Configure the following parameters:
Serial Port Profiles
Limit Connection
to User
Makes the serial port dedicated to the specified user. The user won’t need to
enter their login name - just their password.
Initial Mode Specifies the initial interface a user navigates when logging into the serial port.
Data Options: Menu, Command Line
Default: Command Line
Terminal Pages The number of video pages the terminal supports.
Range: 1-7
Default: 5 pages
Telnet Settin gs
The Telnet settings apply when the User Service is set to Telnet or the Terminal profile specifies a
Telnet connection to a host. When the Terminal Server initiates a Telnet connection to a host, it is
acting as a Telnet client.
Configure the following parameters:
Terminal Type Type of terminal attached to this serial port; for example, ANSI or WYSE60.
Enable Local Echo Toggles between local echo of entered characters and suppressing local echo.
Enable Line Mode When enabled, keyboard inpu t is not sent to the remote host un til Enter is
Local echo is used for normal processing, while suppressing the echo is
convenient for entering text that should not be displayed on the screen, such as
passwords. This parameter can be used only when
Enable Line Mode is
enabled.
Default: Disabled
pressed, otherwise input is sent every time a key is pressed.
Default: Disabled
81
Serial Port Profiles
Map CR to CRLF When enabled, maps carriage returns (CR) to carriage return line feed (CRLF).
Default: Disabled
Interrupt Defines the interrupt character. Typing the interrupt character interrupts the
current process. This value is in hexadecimal.
Default: 3 (ASCII value
^C)
Quit Defines the quit character. Typing the quit character closes and exits the
current telnet session. This value is in hexadecimal.
Default: 1c (ASCII value
FS)
EOF Defines the end-of-file character. When Enable Line Mode is enabled, entering
the EOF character as the first character on a line sends the character to the
remote host. This value is in hexadecimal.
Default: 4 (ASCII value
^D)
Erase Defines the erase character. When Line Mode is Off, typing the erase character
erases one character. This value is in hexadecimal.
Default: 8 (ASCII value
^H)
Echo Defines the echo character. When Line Mode is On, typing the echo character
echoes the text locally and sends only completed lines to the host. This value is
in hexadecimal.
Default: 5 (ASCII value
^E)
Escape Defines the escape character. Returns you to the command line mode. This
Serial Tunneling Profile
Overview
The Serial Tunneling profile allows two Terminal Servers to be connected back-to-back over the
network to establish a virtual link between two serial ports based on RFC 2217.
Functionality
The serial device that initiates the connection is the Tunnel Client and the destination is the Tunnel
Server
, although once the serial communication tunnel has been successfully established,
communication can go both ways.
value is in hexadecimal.
Default: 1d (ASCII value
GS)
A more detailed implementation of the Serial Tunneling profile is as follows:
82 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Serial
Server
Tunnel
Terminal
Server
Network
Terminal
Server
Serial
Client
Tunnel
The Server Tunnel will also support Telnet Com Port Control protocol as detailed in RFC 2217.
Serial
Network
Server
Tunnel
Terminal
Server
Running
2217 Application
The Terminal Server serial port signals will also follow the signals on the other serial port. If one
serial port receives DSR then it will raise DTR on the other serial port. If one serial port receives CTS
then it will raise RTS on the other serial port. The CD signal is ignored.
General Tab Field Descriptions
Configure the following parameters:
Act As Tunnel
Server
TCP Port The TCP port that the Terminal Server wi ll list e n for incoming connecti on on.
Enable TCP
Keepalive
The Terminal Server will listen for an incoming connection request on the
specified
Internet Address on the specified TCP Port.
Default: Enabled
Default: 10000+serial port number; so serial port 2 is 10002.
Enables a per-connection TCP keepalive feature. This feature when enabled,
periodically checks if the TCP connection is still active. The period is
configurable on a global basis for the Terminal Server. If the connection is no
longer active, the Terminal Server will cleanly terminate the session at its end.
This parameter needs to be used in conjunction with
Status Interval
parameter found in the Serial, Advanced, Advanced Settings
Monitor Connection
tab. The interval determines how long the Terminal Server will wait during
inactivity before "testing" the connection. It should be noted that if a network
connection is accidentally dropped, it can take as long as the specified interval
before anyone can reconnect to the serial port.
Default: Disabled
83
Serial Port Profiles
Act as Tunnel
Client
Host Name A preconfigured host name that is associated with the IP address of the Tunnel
TCP Port The TCP port that the Terminal Server will use to connect to the Tunnel
Virtual Modem Profile
Overview
Virtual Modem (Vmodem) is a feature of the Terminal Server that provides a modem interface to a
serial device. It will respond to AT commands and provide signals in the same way that a serially
attached modem would. This feature is typically used when you are replacing dial-up modems with
an Terminal Server in order to provide Ethernet network connectivity.
Functionality
The serial port will behave in exactly the same fashion as it would if it were connected to a modem.
Using AT commands, it can configure the modem and the issue a dial-out request (ATTD). The
Terminal Server will then translate the dial request into a TCP connection and data will be begin to
flow in both directions. The connection can be terminated by ’hanging’ up the phone li ne.
You can also manually start a connection by typing ATD<ip_address>,<port_number> and end
the connection by typing
address of the receiver. For example,
ATD12303402304310001, without any punctuation (although you do need to add zeros where there
are not three digits presents, so that the IP address is 12 digits long).
The Terminal Server will initiate the connection the Tunnel Server.
Default: Disabled
Server.
Server.
Default: 10000+serial port number; so serial port 5 is 10005.
+++ATH. The ip_address can be in IPv4 or IPv6 formats and is the IP
ATD123.34.23.43,10001 or you can use
84 Terminal Server User Guide, Version 3.3
General Tab Field Descriptions
Configure the following parameters:
Serial Port Profiles
Connect
Automatically At
Startup
When enabled, automatically establishes the virtual modem connection when
the serial port becomes active.
Default: Enabled
Host Name The preconfigured target host name.
TCP Port The port number the target host is listening on for messages.
Default: 0 (zero)
Connect Manually
Via AT Command
When enabled, the virtual modem requires an AT command before it
establishes a connection. Specify this option when your modem application
sends a phone number or other AT command to a modem . The serial device
can supply an IP address directly or it can provide a phone number that will be
translated into an IP address by the Terminal Server using the mapping table.
Default: Disabled
Phone Number to
Host Mapping
Button
When your modem application provides a phone number in an AT command
string, you can map that phone number to the destination host.
See Phone Number to Host Mapping on page 87 for information about the
window that appears when you click this button.
Send Connection
Status As
When enabled, the connection success/failure indication strings are sent to the
connected device, otherwise these indications are suppressed. This option also
determines the format of the connection status results that are generated by the
virtual modem.
Default: Enabled
Verbose String When enabled, the connection status is sent by text strings to the connected
Success String String that is sent to the serial device when a connection succeeds.
Failure String String that is sent to the serial device when a connection fails.
device.
Default: Disabled
Default: CONNECT <speed>, for example,
Default: NO CARRIER
CONNECT 9600
85
Serial Port Profiles
Numeric Codes When enabled, the connection status is sent to the connected device using the
following numeric codes:
z 0 OK
z 1 CONNECTED
z 2 RING
z 3 NO CARRIER
z 4 ERROR
z 6 ITERFACE DOWN
z 7 CONNECTION REFUSED
z 8 NO LISTNER
Default: Enabled
Advanced Tab Field Descriptions
Configure the following parameters:
Echo characters in
command mode
When enabled, echoes back characters that are typed in (equivalent to
ATE0/ATE1 commands).
Default: Disabled
DTR Signal Always OnSpecify this option to make the DTR signal always act as a DTR signal.
Default: Enabled
DTR Signal Acts as
DCD
Specify this option to make the DTR signal always act as a DCD signal.
Default: Disabled
DTR Signal Acts as RISpecify this option to make the DTR signal always act as a RI signal.
Default: Disabled
RTS Signal Always OnSpecify this option to make the RTS signal always act as a RTS signal.
Default: Enabled
86 Terminal Server User Guide, Version 3.3
Serial Port Profiles
RTS Signal Acts as
DCD
RTS Signal Acts as RISpecify this option to make the RTS signal always act as a RI signal.
Additional modem
initialization
Enable Message of
the Day (MOTD)
AT Command
Response Delay
Specify this option to make the RTS signal always act as a DCD signal.
Default: Disabled
Default: Disabled
You can specify additional virtual modem commands that will affect how
virtual modem starts. The following commands are supported: ATQn, ATVn,
ATEn, ATS0, AT&Z1, AT&Sn, AT&Rn, AT&Cn, AT&F, ATS2, ATS12, and
ATDS1.
See Appendix A, Virtual Modem AT Commands on page 119 for a more
detailed explanation of the support initialization commands.
When enabled, displays the Message of the Day (MOTD) when a successful
virtual modem connection is made.
Default: Disabled
The amount of time, in milliseconds, before an AT response is sent to the
requesting device.
Default: 250 ms
Phone Number to Host Mapping
If your modem application dials using a phone number, you can add an entry in the Phone Number to
Host Mapping window that can be accessed by all serial ports configured as Virtual Modem. You
need to enter the phone number sent by your modem application and the Terminal Server IP address
and TCP Port that will be receiving the ’call.’ The Terminal Server supports up to 4 entries.
The following buttons are available:
Add Button Click the Add button to displ ay a window that allows you to configure the
phone number or AT comma nd your modem application sends and the
Terminal Server’s IP address and TCP port number that is receiving the call.
Edit Button Click on a phone num ber entry and click the Edit button to change any values
configured for the phone number.
Delete Button Click on a phone number entry and click the Delete button to remove it from
the phone number list.
VModem Phone Number Entry
Create an entry in the Phone Number to Host Mapping window.
Configure the following parameters:
Phone Number Specify the phone number that your application uses to connect to the remote
location. Note: The Terminal Server does not validate the phone number, so it
must be entered in the exact way it is issued by the application. For example, if
you enter 555-1212 in this table and the application sends 5551212, the
Terminal Server will not match the two numbers.
Host IP Address Specify the IP address of the remote host that is receiving the virtual modem
connection.
TCP Port Specify the TCP port that the remote host is lisening on for the vmodem
connection.
Default: 0
87
Serial Port Profiles
Modbus Gateway Profile
Overview
Each serial port can be configured as either a Modbus Master gateway or a Modbus Slave gateway,
depending on your configuration and requirements.
Functionality
The Modbus Gateway profile configures a serial port to act as a Modbus Master Gateway or a
Modbus Slave Gateway.
General Tab Field Descriptio ns
88 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Configure the following parameters:
Mode Specify how the Modbus Gateway is defined on the serial port.
Data Options:
z Modbus Master—Typically, the Modbus Master is connected to the
Serial Port and is communicating to Modbus Slaves on the network.
z Modbus Slave—Typically, the Modbus Master is accessing the Terminal
Server through the network to communicated to Modbus Slaves connected
to the Terminal Server’s S e rial Ports.
Default: Modbus Master Gateway
Destination Slave
IP Mappings
Button
Click this button to launch the Destination Slave IP Settings window, where
you can configure the TCP/Ethernet Modbus Slaves that the Modbus Master on
the Serial Port will communicate with.
UID Range You can specify a range of UIDs (1-247), in addition to individual UIDs.
Field Format: Comma delimited; for example, 2-35, 50, 100-103
Advanced Slave
Click this button to configure global Modbus Slave settings.
Settings Button
Modbus/RTU Select this option when the Modbus/RTU protocol is being used for
communication between the Modbus Master and Slave.
Default: Enabled
Modbus/ASCII Select this opti on when Modbus/ASCII protocol is being used for
communication between the Modbus Master and Slave.
Default: Disabled
Append CR/LF When Modbus/ASCII is selected, adds a CR/LF to the end of the transmission;
most Modbus devices require this option.
Default: Enabled
Advanced Field Descriptions
Configure the following parameters:
Idle Timeout Use this timer to close a connection because of inactivity. When the Idle
Enable Modbus
Exceptions
Timeout
expires, the Terminal Server will end the connection.
Range: 0-4294967 seconds (about 49 days)
Default: 0 (zero), which does not timeout, so the connection is permanently
open.
Click this button to launch the Destination Slave IP Settings window, where
you can configure the TCP/Ethernet Modbus Slaves that the Modbus Master on
the Serial Port will communicate with.
89
Serial Port Profiles
Character Timeout Used in conjunction with the Modbus RTU protocol, specifies how long to
wait, in milliseconds, after a character to determine the end of frame.
Range: 10-10000
Default: 30 ms
Message Timeout Time to wait, in milliseconds, for a response message from a Modbus TCP or
serial slave (depending if the Modbus Gateway is a Master Gateway or Slave
Gateway, respectively) before sending a Modbus exception.
Range: 10-10000
Default: 1000 ms
Modbus Slave IP Settings Field Descriptions
This window is used to configure the Modbus Slaves.
The following buttons are available:
Add Button Adds an entry into the Modbus Destination Slave IP Settings table.
Edit Button Edits an entry in the Modbus Destination Slave IP Settings table.
Delete Button Deletes an entry from the Mod bus Destination Slave IP Settings table.
90 Terminal Server User Guide, Version 3.3
Serial Port Profiles
Adding/Editing Modbus Slave IP Settings
Configure the following parameters:
UID Start When Destination is set to Host and you have sequential Modbus Slave IP
addresses (for example, 10.10.10.1, 10.10.10.2, 10.10.10.3, etc.), you can
specify a UID range and the Terminal Server will automatically increment the
last digit of the configured IP address. Therefore, you can specify a UID range
of 1-100, and the Terminal Server will route Master Modbus messages to all
Modbus Slaves with IP addresses of 10.10.10.1 - 10.10.10.100.
Range: 1-247
Default: 0 (zero)
UID End When Destination is set to Host and you have sequential Modbus Slave IP
addresses (for example, 10.10.10.1, 10.10.10.2, 10.10.10.3, etc.), you can
specify a UID range and the Terminal Server will automatically increment the
last digit of the configured IP address. Therefore, you can specify a UID range
of 1-100, and the Terminal Server will route Master Modbus messages to all
Modbus Slaves with IP addresses of 10.10.10.1 - 10.10.10.100.
Range: 1-247
Default: 0 (zero)
Type Specify the configuration of the Modbus Slaves on the network.
Data Options:
z Host—The IP address is used for the first UID specified in the range. The
last octet in the IPv4 address is then incriminated for subsequent UID’s in
that range. The
z Gateway—The Modbus Master Gateway will use the same IP address
Host option is not applicable for IPv6 addresses.
when connecting to all the remote Modbus slaves in the specified UID
range.
Default: Host
Start IP Ad dress The IP address of the TCP/Ethernet Modbus Slave.
Field Format: IPv4 or IPv6 (IPv6 format not supported for
Destination Host)
End IP Address Displays the ending IP address of the TCP/Ethernet Modbus Slaves, based on
the Start IP address and the UID range.
91
Serial Port Profiles
Protocol Specify the protocol that is used between the Modbus Master and Modbus
Slave(s).
Data Options: TCP or UDP
Default: TCP
UDP/TCP Port The destination port of the remote Modbus TCP Slave that the Terminal Server
will connect to.
Range: 0-65535
Default: 502
Modbus Slave Advanced Settings Field Descriptions
Configure the following parameters:
TCP/UDP Port The network port number that the Slave Gateway will listen on for both TCP
and UDP messages.
Default: 502
Next Request Delay A delay, in milliseconds, to allow serial slave(s) to re-enable receivers before
issuing next Modbus Master request.
Range: 0-1000
Default: 50 ms
Enable Serial
Modbus Broadcasts
When enabled, a UID of 0 (zero) indicates that the message will be broadcast to
all Modbus Slaves.
Default: Disabled
Request Queuing When enabled, allows multiple, simultaneous messages to be queued and
processed in order of reception.
Default: Enabled
Embedded When this option is selected, the address of the slave Modbus device is
embedded in the message header.
Default: Enabled
92 Terminal Server User Guide, Version 3.3
Remapped Used for single device/port operation. Older Modbus devices may not include a
UID in their transmission header. When this option is selected, you can specify
the UID that will be inserted into the message header for the Modbus slave
device. This feature supersedes the Broadcast feature.
Default: Disabled
Remap UID Specify the UID that will be inserted into the message header for the Slave
Modbus serial device.
Range: 1-247
Default: 1
Advanced
Advanced Serial Settings Tab
Overview
Advanced serial port settings apply to all serial ports.
Advanced
Field Descriptions
Configure the following parameters:
Flush Data Before
Closing Serial Port
Deny Multiple
Network
Connections
When enabled, deletes any pending outbound data when a port is closed.
Default: Disabled
Allows only one network connection at a time per a serial port. Application
accessing a serial port device across a network with get a connection (socket)
refused until:
z All data from previous connections on that serial port has drained
z There are no other connections
z Up to a 1 second interconnection poll timer has expired
This also enables a per-connection TCP keepalive feature. After approximately
3 minutes of network connection idle time, the connection will send a
gratuitous ACK to the network peer, thus either ensuring the connection stays
active OR causing a dropped connection condition to be recognized by all peer
network connections.
Applications using this feature need to be aware that there can be some
considerable delay between a network disconnection and the port being
available for the next connection attempt, allowing any data sent on prior
connections to be transmitted out of the serial port. Application network retry
logic needs to accommodate this feature.
Default: Disabled
93
Advanced
Modems Tab
Monitor
Connection
Interval Status
Specify how often, in seconds, the Terminal Server will send a TCP Keepalive
to services that support TCP Keepalive. This only applies to line service types
that support the keepalive feature.
Default: The default interval is every 30 seconds.
Overview
You need to configure a modem if there is a modem connected to the Terminal Server.
When you click on the Modems tab, you will see the following:
If any modems have been configured, they will be displayed.
Adding/Editing a Modem
You can add new modems or edit existing modems through the following window:
Configure the following parameters:
Name The name of the modem.
Restrictions: Do not use spaces.
Initialization String The initialization string of the modem; see your modem’s documentation.
94 Terminal Server User Guide, Version 3.3
COMredirect Baud Rate Tab
Overview
The COMredirect utility acts as a COM port redirector that allows applications to talk to serial
devices across a network as though the serial devices were directly attached to the server.
Functionality
Since some older applications may not support the higher baud rates that the Terminal Server is
capable of achieving, the baud rate can be mapped to a different value on the Terminal Server.
Through COMredirect, you can map the baud rate of the host COM port to a higher baud rate for the
serial line that connects the serial device and the Terminal Server. See
more information about the COMredirect utility.
Field Definitions
Advanced
COMredirect on page 131 for
Configure the following parameter:
Actual Baud Rate The actual baud rate that runs between the Terminal Server and the connected
serial device. You can also specify a custom baud rate. Range: 50 - 230400.
95
8
Introduction
You can configure up to four users in the Terminal Server’s local user
database, in addition to the Admin user. A user can even represent a
device, like a barcode reader or a card swipe device, that you want to be
authenticated.
When users are connecting to the Terminal Server via serial ports, the
user database can be used to:
z Have the user authenticated prior to establishing a connection to a
network host.
z Establish a different connection type to the host specific to each user.
z Create a profile different from the Default user profile.
When users are connecting to the T erminal Server from a network connection, the user database can
be used to:
z Authenticate users prior to providing access to a serially attached console port (such as a Unix
server or router).
Configuring Users Chapter 8
User Settings
Overview
The Users window allows you to add, edit, and delete users from the Terminal Server. Note: you can
not delete the
Functionality
The Users window displays the users who have been configured. You can add users, edit existing
users, or delete users from this window. See
parameters available when adding or editing a user.
admin user.
Adding/Editing Users on page 97 for information on the
Terminal Server User Guide, Version 3.3 96
Adding/Editing Users
General Tab
Overview
The General tab configures the basic user information.
Adding/Editing Users
Functionality
You must , minimally, provide a User Name and Level for a user.
Field Descriptions
Configure the following parameters:
User Name The name of the user.
Password The password the user will need to enter to login to the Terminal Server.
Restrictions: Do not use spaces.
97
Adding/Editing Users
Confirm Password Enter the user’s password again to verify it is entered correctly.
Level The access that a user is allowed.
Data Options:
z Admin—The admin level user has total access to the Terminal Server.
You can create more than one admin user account but we recommend that
you only have one. They can monitor and configure the Terminal Server.
Users configured with this level can access the unit either via serial
Terminal Profile connection or via a network originated Telnet connection
to the Terminal Server.
z Normal—The Normal level user has limited access to the Terminal
Server. Limited CLI commands and Menu access are available with the
ability to configure the user’s own configuration settings. Users configured
with this level can access the unit either via serial Terminal Profile
connection or via a network originated Telnet connection to the Terminal
Server.
z Restricted—The Restricted level user can only access predefined sessions
or access the Easy Port Access menu. Users configured with this level will
be restricted to pre-defined sessions or limited CLI commands when
connecting through the serial port via the Terminal Profile. The CLI
commands are limited to those used for initiating a session. If connection
to the Terminal Server is done with Telnet from the network, the user will
be presented with the Easy Port Access menu.
z Menu—The menu level user will only be able to access predefined
session when connecting through a serial port with the Terminal profile or
will be limited to the Easy Port Access menu when connecting from the
network. The Easy Port Access allows the user to connect to the accessible
line without disconnecting their initial connection to the Terminal Server.
Does not have any access to CLI commands.
When the Admin user logs into the Terminal Server, the prompt ends with a
whereas all other users’ prompts ends with a
$ or £, depending on the character
set.
Default: Normal
#,
Note:
A technique for giving a serially attach user (dial-in or terminal attached), the same menus as
one that is network connected is to do the following:
1. Define the serial port with a Terminal Profile using telnet protocol with a direct
connection to Host IP address 127.0.0.0 (local loop back).
2. When the user connects to that serial port a Telnet session will be established to the
Terminal Server and the user will appear to have connected from the network.
Services Tab
Overview
The Services tab configures the connection parameters for a user. Any connection parameters
configured in this window will override the serial port connection parameters.
Functionality
When a Terminal profile is set for the serial port and Require Login has been selected, user’s
accessing the Terminal Server through the serial port will be authenticated. Once authentication is
successful, the Terminal Server will start a Telnet connection to the specified
Within the Terminal profile, there are a number of settings that apply to possible Services. Once it is
known which user is connected, and which service is to be used, then the settings from both the
T erminal profile and the user are used. User parameters take precedence over serial port parameters.
98 Terminal Server User Guide, Version 3.3
Host IP/TCP Port.
Field Descriptions
Adding/Editing Users
Configure the following parameters:
Service Used in conjunction with the Terminal Profile. After the user has successfully
Host IP When the User Service is Telnet, this is the target host name or IP address. If
TCP Port When the User Service is Telnet, this is the target port number. The default
Advanced Tab
Overview
The Advanced tab is used to configure those parameters that control the user session; this includes
session length, language, the hotkey used for switching between sessions.
been authenticated, the specified service is started.
Data Options: DSPrompt, Telnet, TCP Clear
Default: DSPrompt
no IP address or host name is specified, the
configuration will be used.
Default: 0.0.0.0.
value will change based on the type of
known port numbers are used as the default values.
Host IP value in the Default User
Service selected; the most common
99
Adding/Editing Users
Field Descriptions
Configure the following parameters:
Idle Timeout The amount of time, in seconds, before the Terminal Server closes a
connection due to inactivity. The default value is
Idle Timer will not expire (the connection is open permanently). The User Idle
Timeout will override all other Serial Port Idle Timeout parameters.
0 (zero), meaning that the
Range: 0-4294967
Default: 0
Session Timeout The amount of time, in seconds, before the Terminal Server forcibly closes a
user’s session (connection). The default value is
0 (zero), meaning that the
session timer will not expire (the session is open permanently, or until the user
logs out). The
Session Timeout parameters.
User Session Timeout will override all other Serial Port
Range: 0-4294967
Default: 0
Language You can specify whether a user will use English or Custom Language as the
language that appears in the Menu, CLI, or WebManager. The Terminal Server
supports one custom language that must be downloaded to the Terminal
Server.
Default: English
See Language Support on page 114 for more information about Custom
Languages.
100 Terminal Server User Guide, Version 3.3
Loading...