Perle IOLAN DS1 User manual

IOLAN DS Family
DS1/TS2 User’s Guide
Version 1.7
Part #5500162-17
June 2006

Copyright Statement
This document must not be reproduced in any way whatsoever, either printed or electronically, without the consent of:
Perle Systems Limited,
60 Renfrew Drive
Markham, ON
Canada
L3R 0E1
Perle reserves the right to make changes without further notice, to any products to improve reliability, function, or
design.
Perle, the Perle logo, and IOLAN are trademarks of Perle Systems Limited.
Microsoft, Windows 98, Windows NT, Windows 2000, Windows Server 2003, Windows XP, and Internet Explorer are
trademarks of Microsoft Corporation.
Netscape is a trademark of Netscape Communications Corporation.
Mozilla Firefox is a trademark of the Mozilla Foundation.
Solaris is a registered trademark of Sun Microsystems, Inc. in the USA and other countries.
Perle Systems Limited, 2004-2006.
FCC Note The IOLAN Device Server has been found to comply with the limits for a Class A digital
device, pursuant to Part 15 of the FCC rules. These limits are designed to provide
reasonable protection against harmful interference when the equipment is operated in a
commercial environment. This equipment generates, uses, and can radiate radio frequency
energy and, if not installed and used in accordance with the instructions in this Guide, may
cause harmful interference to radio communications. Operation of this equipment in a
residential area is likely to cause harmful interference, in which case the user will be
required to correct the interference at his/her own expense.
EN 55022: 1998, Class A, Note
WARNING ThisisaClassAproduct.Inadomesticenvironmentthisproductmaycauseradiointerferenceinwhichcase
the user may be required to take adequate measures.
Caution: The IOLAN Device Server is approved for commercial use only.

IOLAN Device Server User’s Guide, Version 1.7 3
Preface ...............................................................................15
About This Book ........................................................................ 15
Intended Audience..................................................................... 15
Documentation........................................................................... 15
Typeface Conventions............................................................... 16
Online Help................................................................................. 16
Contacting Technical Support.................................................. 17
Making a Technical Support Query ...................................................... 17
Who To Contact................................................................................. 17
Have Your Product Information Ready .............................................. 17
Making a support query via the Perle web page................................ 17
Repair Procedure.................................................................................... 18
Feedback on this Manual....................................................................... 18
Chapter 1 Introduction......................................................19
About the IOLAN Device Server ............................................... 19
IOLAN Device Server Models.................................................... 19
Device Server Features............................................................. 20
Hardware................................................................................................. 20
Software .................................................................................................. 20
Security ................................................................................................... 21
Supported Products/Versions .................................................. 21
Web Browsers......................................................................................... 21
Table of Contents

Table of Contents
4 IOLAN Device Server User’s Guide, Version 1.7
Typical Applications Summary .................................................21
Managing the Device Server..................................................................21
Managing/Accessing devices attached to the Device Server.............21
Network Security.....................................................................................22
Chapter 2 Installation........................................................23
Introduction.................................................................................23
IOLAN Device Server Components...........................................23
What’s Included ......................................................................................23
What You Need to Supply......................................................................23
Available Accessories............................................................................23
Getting to Know Your Device Server........................................24
DS1...........................................................................................................24
TS2 ...........................................................................................................24
LED Guide................................................................................................25
Console Mode vs. Serial Mode..............................................................25
Powering Up the Device Server ................................................26
Setting Jumpers .........................................................................26
1-Port Device Server...............................................................................26
Device Server DB25 Male/Female..................................................... 26
Device Server RJ45............................................................................ 27
Device Server DB9............................................................................. 27
2-Port Device Server...............................................................................28
Setting an Initial IP Address......................................................29
Using DeviceManager.............................................................................29
Using a Direct Connection.....................................................................31
Using DHCP/BOOTP...............................................................................31
Using ARP-Ping ......................................................................................32
IPv6 Network ...........................................................................................32

5
Table of Contents
Pinouts........................................................................................ 33
DB25 Male ............................................................................................... 33
DB25 Female........................................................................................... 34
RJ45......................................................................................................... 35
DB9 Male ................................................................................................. 35
EIA-232 Cabling Diagrams ........................................................ 36
Terminal DB25 Connector ..................................................................... 36
DB25 Male ......................................................................................... 36
DB25 Female..................................................................................... 36
RJ45................................................................................................... 37
DB9 Male ........................................................................................... 37
Modem DB25 Connector........................................................................ 38
DB25 Male ......................................................................................... 38
RJ45................................................................................................... 38
DB9 Male ........................................................................................... 39
Chapter 3 Configuration Methods ...................................41
Introduction................................................................................ 41
DeviceManager........................................................................... 41
WebManager............................................................................... 42
Using the WebManager.......................................................................... 42
CLI............................................................................................... 42
Menu............................................................................................ 42
Accessing the Menu............................................................................... 42
Menu Conventions ................................................................................. 43
DHCP/BOOTP............................................................................. 43
SNMP........................................................................................... 43

Table of Contents
6 IOLAN Device Server User’s Guide, Version 1.7
Chapter 4 Configuring the Device Server .......................45
Introduction.................................................................................45
Configuring the Device Server..................................................45
General Device Server Configuration...................................................45
Device Server Services ..........................................................................45
TruePort...................................................................................................46
Hardware Configuration.........................................................................46
Ethernet Connection........................................................................... 46
Serial Connection............................................................................... 46
Other................................................................................................... 46
Modbus Configuration ...............................................................47
Overview..................................................................................................47
Configuring a Master Gateway........................................................... 47
Configuring a Slave Gateway............................................................. 47
Modbus Gateway Settings.....................................................................48
Modbus Master Gateway.................................................................... 48
Modbus Slave Gateway...................................................................... 48
Modbus Line Settings.............................................................................49
Modbus Master Settings..................................................................... 49
Modbus Slave Settings....................................................................... 49
Example Scenario...................................................................................50
Machine To Machine Connections............................................52
Users Connecting to Serial Devices.........................................52
Users Connecting to the LAN....................................................52
Connecting To the Device Server..........................................................53
Connecting Through the Device Server ...............................................53
Setting Up Lines .........................................................................53
DSLogin...................................................................................................53
Direct/Silent/Reverse Connections.......................................................54
Virtual Modems.......................................................................................54
BIDIR........................................................................................................54
UDP ..........................................................................................................55
Serial Tunnel Settings............................................................................56

7
Table of Contents
Setting Up Users........................................................................ 56
User Accounts........................................................................................ 56
User Levels ............................................................................................. 57
Sessions.................................................................................................. 57
Users From LAN to Device Server to Serial Device............................ 57
Easy Port Access Menu..................................................................... 57
Configuring Network Options................................................... 58
Hosts........................................................................................................ 58
Gateways................................................................................................. 58
Syslog...................................................................................................... 58
SNMP....................................................................................................... 58
Configuring Time ....................................................................... 58
Language support...................................................................... 58
Loading a Supplied Language .............................................................. 59
Translation Guidance............................................................................. 59
Software Upgrades and Language Files.............................................. 60
Downloading Terminal Definitions........................................... 60
Creating Terminal Definition Files........................................................ 60
TFTP Configuration ................................................................... 62
Resetting Configuration Parameters ....................................... 62
Lost Admin Password............................................................... 62
DHCP/BOOTP............................................................................. 62
DHCP/BOOTP Parameters..................................................................... 63
Creating Custom Applications ................................................. 63

Table of Contents
8 IOLAN Device Server User’s Guide, Version 1.7
Chapter 5 Using the DeviceManager...............................65
Introduction.................................................................................65
Starting a New Session..............................................................65
Managing a Device Server .....................................................................66
Populating the Device Server List ...................................................... 66
Assigning a Temporary IP Address to a New Device Server............. 67
Adding/Deleting Static Device Servers............................................... 67
Creating a New Device Server Configuration.......................................68
Opening an Existing Configuration File ...............................................68
Connecting to a Device Server..................................................68
Managing a Device Server.........................................................69
DeviceManager Work Flow ....................................................................69
Creating/Editing Configuration Files ....................................................69
Working With the Device Server Configuration.................................. 69
Working With a Local Configuration File ............................................ 69
Configuring the Server...............................................................70
Configuring the Main Server Window...................................................70
Server................................................................................................. 70
Services.............................................................................................. 70
Configuring Advanced Server Settings................................................71
Configuring TruePort Baud....................................................................72
Configuring the Hardware......................................................................72
Custom App.............................................................................................72

9
Table of Contents
Configuring Lines...................................................................... 73
Advanced Line Settings......................................................................... 75
Service Settings...................................................................................... 77
DSLogin ............................................................................................. 77
Raw Settings...................................................................................... 78
Telnet Settings................................................................................... 78
BIDIR Settings.................................................................................... 79
UDP Settings...................................................................................... 80
VModem Settings............................................................................... 81
Server Tunnel Settings....................................................................... 81
Client Tunnel Settings........................................................................ 82
Modbus Slave Settings ...................................................................... 82
Modbus Master Settings .................................................................... 83
Remote IP Slave Mappings................................................................ 84
Custom App Settings ......................................................................... 85
Packet Forwarding ................................................................................. 86
Configuring Modems.............................................................................. 88
Configuring Users...................................................................... 88
Configuring Line Access....................................................................... 90
Configuring Sessions ............................................................................ 90
Configuring the Default User................................................................. 91
Configuring the Network........................................................... 91
Configuring Hosts.................................................................................. 91
Configuring SNMP.................................................................................. 92
Configuring TFTP................................................................................... 93
Configuring Gateways ........................................................................... 93
Configuring Syslog ................................................................................ 94
Configuring Administration Tasks........................................... 95
Configuring Bootup Files ...................................................................... 95
Configuring the MOTD File.................................................................... 95
Statistics..................................................................................... 96

Table of Contents
10 IOLAN Device Server User’s Guide, Version 1.7
Tools............................................................................................96
Saving a Configuration To File..............................................................96
Getting a Configuration File...................................................................96
Configuring Multiple Device Servers....................................................96
Downloading Device Server Firmware..................................................97
Setting the Device Server’s Date and Time..........................................98
Rebooting the Device Server.................................................................98
Resetting the Device Server to Factory Defaults.................................98
Resetting a Line......................................................................................98
Custom Files ...........................................................................................99
Saving Crashes to a Dump File.......................................................... 99
Downloading Terminal Definitions...................................................... 99
Downloading a Language File............................................................ 99
Downloading a Custom App File........................................................ 99
Setting DeviceManager Options............................................................99
Chapter 6 Command Line Interface...............................101
Introduction...............................................................................101
CLI Conventions.......................................................................101
Command Syntax..................................................................................101
Command Shortcuts.............................................................................102
Command Options................................................................................102
Server Commands....................................................................103
Server Commands................................................................................103
Set Custom-App............................................................................... 103
Set Server......................................................................................... 103
Set Service....................................................................................... 105
Show Custom-App............................................................................ 105
Show Modbus................................................................................... 105
Show Server..................................................................................... 105
Hardware Commands...........................................................................106
Set Ethernet...................................................................................... 106
Show Hardware................................................................................ 106
Modbus Commands..............................................................................106
Set Modbus Gateway....................................................................... 106
Show Modbus................................................................................... 107

11
Table of Contents
TruePort Baud Commands.................................................................. 108
Set TruePort Remap-Baud............................................................... 108
Show TruePort................................................................................. 108
User Commands ...................................................................... 108
Logged Into the Device Server Commands....................................... 108
Admin............................................................................................... 108
Help.................................................................................................. 108
Kill Line............................................................................................. 108
Kill Session....................................................................................... 108
Logout.............................................................................................. 109
Menu................................................................................................ 109
Ping.................................................................................................. 109
Resume............................................................................................ 109
Screen.............................................................................................. 109
Set Termtype.................................................................................... 110
Set User........................................................................................... 110
Set User Session ............................................................................. 111
Show Line Users.............................................................................. 111
Syslog Console................................................................................ 111
Show Sessions................................................................................. 111
Show Termtype................................................................................ 111
Start.................................................................................................. 112
Telnet............................................................................................... 112
Version............................................................................................. 113
Configuring Users................................................................................ 113
Add User.......................................................................................... 113
Delete User...................................................................................... 113
Set Default User............................................................................... 114
Set User........................................................................................... 116
Set User Session ............................................................................. 118
Show Default User........................................................................... 118
Show User........................................................................................ 118
Line Commands....................................................................... 119
Line Commands.................................................................................... 119
Set Line............................................................................................ 119
Set Line Interface............................................................................. 122
Set Line Service............................................................................... 123
Set Modem....................................................................................... 125
Set Termtype.................................................................................... 125
Show Line ........................................................................................ 125

Table of Contents
12 IOLAN Device Server User’s Guide, Version 1.7
Line Service Commands......................................................................126
Set Custom-App............................................................................... 126
Set Telnet-Client............................................................................... 126
Set UDP............................................................................................ 127
Set Vmodem..................................................................................... 127
Set Modbus-Slave Line .................................................................... 128
Set Modbus-Master Line .................................................................. 129
Show Custom-App............................................................................ 129
Show Interface.................................................................................. 130
Show Modbus................................................................................... 130
Show Telnet-Client........................................................................... 130
Show UDP........................................................................................ 130
Show Vmodem................................................................................. 130
Modem Commands...............................................................................130
Add Modem...................................................................................... 130
Delete Modem.................................................................................. 130
Show Modems.................................................................................. 130
Packet Forwarding Commands...........................................................131
Set Packet-Forwarding Line............................................................. 131
Show Packet-Forwarding Line.......................................................... 133
Network Commands.................................................................133
SNMP Commands.................................................................................133
Add Community................................................................................ 133
Add Trap........................................................................................... 133
Delete Community............................................................................ 134
Delete Trap....................................................................................... 134
Set SNMP......................................................................................... 134
Show SNMP..................................................................................... 134
TFTP Commands ..................................................................................135
Set Server TFTP............................................................................... 135
Hosts Commands .................................................................................135
Add Host........................................................................................... 135
Delete Host....................................................................................... 135
Set Host............................................................................................ 135
Show Hosts ...................................................................................... 135
Gateway Commands.............................................................................136
Add Gateway.................................................................................... 136
Delete Gateway................................................................................ 136
Set Gateway..................................................................................... 137
Show Gateways................................................................................ 137
Logging Commands.............................................................................138
Set Syslog ........................................................................................ 138
Show Syslog..................................................................................... 138

13
Table of Contents
Time Commands...................................................................... 138
Set Time........................................................................................... 138
Show Time....................................................................................... 138
Time/Date Setting Commands............................................................. 139
Set Date........................................................................................... 139
Set Time........................................................................................... 139
Show Date........................................................................................ 139
Show Time....................................................................................... 139
Administration Commands..................................................... 139
Bootup Commands .............................................................................. 139
Reboot.............................................................................................. 139
Reset................................................................................................ 139
Reset Factory................................................................................... 139
Save................................................................................................. 139
Set Bootup ....................................................................................... 140
Show ARP........................................................................................ 140
Show Bootup.................................................................................... 140
TFTP File Transfer Commands ........................................................... 140
Netload............................................................................................. 140
Netsave............................................................................................ 141
MOTD Commands ................................................................................ 141
Set MOTD........................................................................................ 141
Show MOTD..................................................................................... 142
Statistic Commands ................................................................ 142
Configuration Statistics....................................................................... 142
Show Netstat.................................................................................... 142
Show Modbus Statistics................................................................... 142
Show Netstat Statistics .................................................................... 142
Show Routes.................................................................................... 142
Run-Time Statistics.............................................................................. 143
Delete Arp........................................................................................ 143
Show Arp.......................................................................................... 143
Show Serial...................................................................................... 143
Uptime.............................................................................................. 143

Table of Contents
14 IOLAN Device Server User’s Guide, Version 1.7
Appendix A Troubleshooting.........................................145
Introduction...............................................................................145
Hardware Problems..................................................................145
Communication Issues ............................................................145
DeviceManager Problems........................................................146
Host Problems ..........................................................................146
Login Problems ........................................................................146
Problems with Terminals.........................................................147
Unknown IP Address................................................................147
DHCP/BOOTP Problems ..........................................................148
Language Problems .................................................................148
Long Reboot Cycle...................................................................148
Appendix B Utilities ........................................................149
Introduction...............................................................................149
TruePort.....................................................................................149
Glossary...........................................................................151
Index.................................................................................153

IOLAN Device Server User’s Guide, Version 1.3 15
Preface
About This Book
This guide provides the information you need to:
zconfigure the Device Server
zincorporate the Device Server into your production environment
Intended Audience
This guide is for administrators who will be configuring the Device Server.
Some prerequisite knowledge is needed to understand the concepts and examples in this guide:
zIf you are using an external authentication application(s), working knowledge of the
authentication application(s).
zKnowledge of TFTP, the transfer protocol the Device Server uses.
Documentation
The following documentation is included on the Device Server installation CD:
zIOLAN DS1/SDS1 Device Server Quick Start Guide
zIOLAN Device Server User’s Guide
zTruePort User Guide
zTruePort Installation and Configuration Guide for Windows NT
zOnline Help in the DeviceManager (automatically installed with the DeviceManager application)
zLink to knowledge base

Typeface Conventions
16 IOLAN Device Server User’s Guide, Version 1.3
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:
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’s Guide online by selecting Help, Help Topics.
Typeface Example Usage
At the C: prompt, type:
add host
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.
Set the value to TRUE.The typeface used for TRUE is also used when referring to
an actual value or identifier that you should use or that is
used in a code example.
subscribe project subject
run yourcode.exec
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 project,
you enter your own value, such as stock_trader, and
for yourcode, enter the name of your program.
File, Save This typeface and comma indicates a path you should
follow through the menus. In this example, you select
Save from the File menu.
IOLAN DS Family User’s Guide This typeface indicates a book or document title.
See Chapter 1, Introduction on page
19 for more information. This indicates a cross-reference to another chapter or
section that you can click on to jump to that section.

17
Contacting Technical Support
Contacting Technical Support
Making a Technical Support Query
Who To Contact
If you bought your product from a registered Perle supplier, you must contact their Technical Support
department; they are qualified to deal with your problem.
Have Your Product Information Ready
When you make a technical support enquiry please have the following information ready:
Making a support query via the Perle web page
If you have an internet connection, please send details of your problem to Technical Support using
the email links provided on the Perle web site in the Support area.
Click here to access our website at the following URL:
http://www.perle.com
Note: Perle offers free technical support to Perle Authorised Distributors and Registered Perle
Resellers.
Item Write Details Here
Product Name
Problem Description
Your Name
Company Name and
Address
Country
Phone Number
Fax Number
Email Address

Contacting Technical Support
18 IOLAN Device Server User’s Guide, Version 1.3
Repair Procedure
Before sending a Device Server for repair, you must contact your Perle supplier. If, however, you
bought your product directly from Perle you can contact directly.
Customers who are in Europe, Africa or Middle East can submit repair details via a website form.
This form is on the Perle website, www.perle.com, in the Support area.
Click here to access our web site at the following URL:
http://www.perle.com/support_services/rma_form.asp
Feedback on this Manual
If you have any comments or suggestions for improving this manual please email Perle using the
following address;
Email: [email protected]
Please include the title, part number and date of the manual (you can find these on the title page at
the front of this manual).

IOLAN Device Server User’s Guide, Version 1.7 19
Introduction Chapter 1
1
About the IOLAN Device Server
The Device Server is an ethernet communications/terminal server that allows serial devices to be
connected directly to LANs. The Device Server can connect to a wide range of devices including:
zTerminals for multi-user UNIX systems
zData acquisition equipment (manufacturing, laboratory, scanners, etc.)
zRetail point-of-sale equipment (bar coding, registers, etc.)
zPCs using terminal emulation
zModems for remote access and Internet access
zISDN adapters for branch remote access and Internet access
zAll types of serial printers
The performance and flexibility of the Device Server allows you to use a wide range of high speed
devices in complex application environments. The Device Server will work in any server
environment running TCP/UDP/IP.
IOLAN Device Server Models
The IOLAN Device Server comes in several different models to meet your production environment
needs:
zDS—Offered as a 1-port unit, this model provides basic Device Server functionality. This model
can be ordered with RJ45, DB9 male, DB25 female, or DB25 male connection options.
zTS—The model does everything the DS model does plus has two RJ45 serial ports (supports
EIA-232 only). This model does not support the power out/power in pins.
zSDS—This model does everything the DS model does plus additional features such as external
authentication, SSH, SSL, port buffering, email alerts, RIP, DNS/WINS, plus much more. This
model has an EIA-232/422/485 switchable interface. Rack mount models have a dedicated
Console port and support gigabit Ethernet. The 1-port model can be ordered with RJ45, DB9
male, DB25 female, or DB25 male connection options. Some SDS models support Power Over
Ethernet or have an internal modem.
zSTS—This model does everything the DS model does plus additional features such as external
authentication, SSH, SSL, port buffering, email alerts, RIP, DNS/WINS, plus much more. This
model has an EIA-232 interface. Rack mount models have a dedicated Console port and support
gigabit Ethernet. Some models support dual input DC power.
zSCS—This model does everything the DS model does plus additional features such as external
authentication, SSH, SSL, port buffering, email alerts, RIP, DNS/WINS, plus much more. This
model has an EIA-232 interface. Rack mount models have a dedicated Console port. This model
comes equipped with PCI interface (supports the Perle PCI modem card), gigabit support, dual
Ethernet, and can have dual AC power.

Device Server Features
20 IOLAN Device Server User’s Guide, Version 1.7
Device Server Features
The Device Server is a communications server with 1 port 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.
Hardware The Device Server hardware features include:
zAuto sensing 10/100 RJ45 interface.
zUniversal, software-selectable EIA-232/422/485 interface.
zFull modem control using DTR, DSR, CTS, RTS and DCD.
zTx and Rx activity indicators.
zExternal AC power supply or power over serial.
zLEDs for diagnostic testing.
zSelf-test on power-up.
zReset switch.
Software The Device Server software features include:
zMultiple ways to configure the Device Server:
–Easy Config Wizard, an easy configuration wizard that allows you to complete basic Device
Server configuration
–DeviceManager, a fully functional Windows 98/NT/2000/ME/Server 2003/XP
configuration/management tool
–WebManager, a web browser option for configuring/managing the Device Server
–Menu, a window-oriented menu interface for configuration and user access
–CLI, a Command Line Interface option for configuration/management and user access
–SNMP, allowing remote configuration via SNMP as well as statistics gathering
–DHCP/BOOTP, a method of automatically updating the Device Server
zIPv6 support.
zSupport for TCP/IP and UDP protocols telnet.
zVirtual modem emulation.
z‘Fixed tty’ support for several operating systems (TruePort).
zDHCP/BOOTP for automated network-based setup.
zDynamic statistics displays and line status reporting for fast problem diagnosis.
zMulti session support on a single terminal.
zInteroperability with IP routing through gateway tables.