Page 1
IOLAN DS Family DS1/TS2 User’s Guide Version 1.7 Part #5500162-17 June 2006...
Page 2
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.
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 ..........
Page 4
Table of Contents 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 ................
Page 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 ...................
Page 6
Table of Contents 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....................
Page 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....................
Page 8
Table of Contents 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........
Page 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 ..............
Page 10
Table of Contents 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.........
Page 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 ....................
Page 12
Table of Contents 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 ................
Page 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....................
Page 14
Table of Contents 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...
Knowledge of TFTP, the transfer protocol the Device Server uses. Documentation The following documentation is included on the Device Server installation CD: IOLAN DS1/SDS1 Device Server Quick Start Guide IOLAN Device Server User’s Guide TruePort User Guide TruePort Installation and Configuration Guide for Windows NT...
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: This typeface is used for code examples and system-generated output.
Perle offers free technical support to Perle Authorised Distributors and Registered Perle Resellers. 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...
Contacting Technical Support 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.
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 Device Server Features The Device Server is a communications server w 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: Auto sensing 10/100 RJ45 interface.
Supported Products/Versions Security The Device Server security features include: Supervisory and port (line) password. Port locking. Per user access level assignment. Logging via Syslog. Idle port timers, which close a connection that has not been active for a specified period of time. Ability to individually disable daemons/services that won’t be used by the Device Server.
Typical Applications Summary Network Security The Device Server provides a comprehensive suite of security features to allow an organization to implement robust security planning to prevent unauthorized access. These include trusted host filtering and the ability to disable individual services. IOLAN Device Server User’s Guide, Version 1.7...
Installation Chapter 2 Introduction This chapter tells you what is packaged with your IOLAN Device Server, how to power up the Device Server to make sure it works correctly, and how to assign the Device Server an IP address through the LAN. IOLAN Device Server Components What’s Included When you open your IOLAN Device Server package, you should have the following components:...
Getting to Know Your Device Server Getting to Know Your Device Server This section describes the components found on the Device Server. Console/Serial Reset to Factory Mode Switch Defaults Power Supply Ethernet Interface Power LAN Connection LAN Activity Serial Activity Serial Connection This section describes the components found on the TS2 Device Server model.
Getting to Know Your Device Server LED Guide The Device Server LEDs display the following information: Power/Ready—(Green/Red/Yellow) Shows red at power up. If this LED remains red, indicates that there is a critical error (return to factory). Flashes green to indicate that the Device Server is booting.
Powering Up the Device Server Powering Up the Device Server Before you attach the Device Server to your network or try to configure it, we suggest that you power it up to verify that it works properly. To power up the Device Server, perform the following steps: Plug the external power supply into the Device Server and then into the electrical outlet.
Setting Jumpers Device Server RJ45 To change the settings, do the following: Unplug the Device Server from the electrical outlet and disconnect everything from the box. Open the case by unscrewing the two side screws, one on each side, and lifting off the top of the case.
Setting Jumpers 2-Port Device Server To change the settings, do the following: Unplug the Device Server from the electrical outlet and disconnect everything from the box. Open the case by unscrewing the two side screws, one on each side, and lifting off the top of the case.
Setting an Initial IP Address Setting an Initial IP Address This section describes the different methods you can use to set the Device Server IP address. Following is a list of methods for setting the Device Server IP address and a short explanation of when you would want to use that method: Easy Config Wizard—The Easy Config Wizard is automatically launched from the CD ROM included with your Device Server.
Page 30
Setting an Initial IP Address Any Device Server that does not have an IP address will be displayed as Not Configured , with to identify the Device Server. Highlight the Device Server that you Model MAC Address want to assign an IP address to and click the button.
Setting an Initial IP Address Using a Direct Connection You can connect to the Device Server using a PC with a terminal emulation package, such as HyperTerminal or a terminal. Connect the Device Server to your PC or dumb terminal. Make sure the dip switch is in Console mode (this sets the Device Server serial port to EIA-232).
Setting an Initial IP Address Type the following command: save The the following command: reboot When the Device Server reboots, it will automatically poll for an IP address from the DHCP/BOOTP server. If you have a Device Server with dual Ethernet, each Ethernet connection will automatically be assigned an IP address, you can access the Device Server through either IP address.
Pinouts Pinouts DB25 Male This section defines the pinouts for the DB25 male connection used on the 1-port Device Server. Pin 1 Pin 13 Pin 14 Pin 25 The following table provides pinout information: EIA-232 EIA-422 EIA-485 EIA-485 Pinout Full Duplex Half Duplex Shield Shield...
Pinouts DB25 Female This section defines the pinouts for the DB25 female connection used on the 1-port Device Server. Pin 13 Pin 1 Pin 25 Pin 14 The following table provides pinout information: EIA-232 EIA-422 EIA-485 EIA-485 Pinout Full Duplex Half Duplex Shield Shield...
Pinouts RJ45 This section defines the pinouts for the RJ45 connection used on the DS and TS Device Server. The TS Device Server does not support power in, so use the 8-pin mappings for this model. Pin 1 Pin 10 The following table provides pinout information: Pinout Pinout...
This section shows how to create EIA-232 cables that are compatible with the Device Server. Terminal DB25 Connector The following diagrams show how the null modem cable should be configured when connecting to a terminal DB25. DB25 Male IOLAN DS1 Terminal DB25 DB25 (DTE) (DTE) 2 (TxD)
EIA-232 Cabling Diagrams Modem DB25 Connector The following diagrams show how a standard straight through cable should be configured when connecting to a DB25 modem. DB25 Male IOLAN DS1 Modem DB25 DB25 (DTE) (DCE) 2 (TxD) 2 (RxD) 3 (RxD)
Configuration Methods Chapter 3 Introduction This chapter provides information about the different methods you can use to configure the Device Server. DeviceManager The DeviceManager is a fully functional Windows 98/NT/2000/ME/Server 2003/XP Device Server configuration/management tool. You must install the DeviceManager from the CD-ROM included with the Device Server.
WebManager WebManager The WebManager is a web-browser based method of configuring/managing a Device Server. To access a Device Server through the WebManager, open up your web browser and type in the IP address of the Device Server that you want to manage/configure. A login screen will appear.ype in the Admin password.
CD-ROM into your SNMP manager. Connect to the Device Server through your SNMP manager using its IP address to configure/manage the Device Server. Expand the PERLE-IOLAN-DS1-MIB folder to see the Device Server’s parameter folders. Below is an example of the configurable parameters under the ServicesInfo folder.
Page 44
SNMP Once you have completed setting the variables in a folder, you will want to submit your changes to the Device Server. To do this, set the variable to . If you want to discard the changes, set the Status variable to Status 4—Indicates that the changes in the container folder are to be submitted to the Device Server.
Configuring the Device Server Chapter 4 Introduction This chapter provides general information about configuring the Device Server for your production environment. Although this chapter is not specific to any configuration method, there should be enough information that you can apply the information to any of the configuration methods. When you are configuring the Device Server, remember that none of your configuration changes will be permanent until you submit/apply your changes, save to FLASH, and reboot the Device Server.
Configuring the Device Server TruePort The TruePort 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. 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 Device Server.
Modbus Configuration Modbus Configuration This sections provides a brief overview of the steps required to configure a Device Server for your Modbus environment. You can read the Modbus Gateway Settings on page 48 Modbus Line Settings on page 49 sections for more specific information about the Modbus settings. Overview Configuring a Master Gateway To configure a Master Gateway (Modbus Master resides on the serial side of the Device Server), do...
Modbus Configuration Modbus Gateway Settings The scenarios in this section are used to illustrate how the Modbus Gateway settings are incorporated into a Modbus device environment. Depending on how your Modbus Master or Slave devices are distributed, the Device Server can act as both a Slave and Master Gateway(s) on a multiport Device Server or as either a Slave or Master Gateway on a single port Device Server.
Modbus Configuration Modbus Line Settings Modbus Master Settings When you have Modbus Masters on the serial side of the Device Server, configure the Line as a Modbus Master. If you also have a Modbus serial Slave on the same serial network as the serial Modbus Master that communicates with that serial Master, do not define its UID in the Remote Slave IP Mappings settings, or the Modbus serial Slave may not function properly.
Modbus Configuration Example Scenario The following example describes the settings that you would configure to set up a Modbus environment on a multiport Device Server, where the Modbus Master resides on a serial port/line connected to the Device Server. This scenario assumes two things, that the (the Service ModbusD Modbus daemon) is enabled and that the default...
Page 51
Modbus Configuration The Device Server will send a request and expect a response from a Modbus Slave with an IP Address of 10.10.10.11 on Port 502 with UID 22 and from Modbus Slave with and IP Address of 10.10.10.12 on Port 502 with UID 23 (remember when is set to , the Device Range Mode...
Machine To Machine Connections Machine To Machine Connections If you are using the Device Server to connect two hosts, allowing data to flow freely between them, you just need to configure the Server and the Line User required). In the following example, the serial device is a security Card Reader that needs to transmit and receive information to/from a host on the network that maintains the Card Reader’s application every time an employee uses an access card to attempt to gain entry to the company.
Setting Up Lines Connecting To the Device Server When a user connects to the Device Server, that user is authenticated and is usually set up with predefined sessions or given the opportunity to configure a to access any host using Free Session any protocol (must have a Level...
Setting Up Lines Direct/Silent/Reverse Connections Direct connections bypass the Device Server, enabling the user to log straight into a specific host. A direct connection is recommended where a user logging in to the Device Server is not required. It is also recommended where multiple sessions are not a requirement.
Setting Up Lines When you configure , you are setting up a range of IP addresses and a port number that you will use to send UDP data to or receive UDP data from. For example: The UDP configuration window, taken from the DeviceManager, is configured to: UDP Entry 1 All hosts that have an IP address that falls within the range of 172.16.1.1...
Setting Up Users Serial Tunnel Settings The purpose of the serial Line Service Client/Server Tunnel is to allow two Device Servers that are connected back-to-back over Ethernet to virtually link two serial ports, based on RFC 2217. The serial device that initiates the connection is the and the recipient is the Client Tunnel Server Tunnel...
Setting Up Users User Levels There are four , and . Setting up users is only User Levels Admin Normal Restricted Menu necessary when the users are actually connecting to the Device Server. Oftentimes, the Device Server is used as a gateway to a network and the user never actually logs into the Device Server itself. Users who do log into the Device Server ( set to set to...
Device Server; this can be done in the DeviceManager, WebManager, CLI, or Menu. You must then load the perle-ds1.MIB (found on the CD-ROM packaged with the Device Server) file into your SNMP manager before you connect to the Device Server.
Language support Loading a Supplied Language This section describes how to download a language file using the CLI, since it is the least intuitive method. French and German language files are provided on the supplemental CD. To load one of the supplied languages into the Device Server, so the Menu, CLI and WebManager fields appear in another language, do the following: Open the supplemental CD and identify the language file, either Iolan_ds_French.txt...
Downloading Terminal Definitions Software Upgrades and Language Files If you receive a software upgrade for the Device Server, the language files supplied on the supplemental diskette/CD might also have been updated. We will endeavour to provide a list of those changes in another text file on the same supplemental CD.
Page 61
Downloading Terminal Definitions Rename and copy the file to the directory specified at step 4. using the command where is greater than or equal to 1; (for example, infocmp termfile > termn ). Make sure the file has global read and execute permission for its infocmp wy50 >...
TFTP Configuration TFTP Configuration TFTP can be configured for two unique transfer operations: Between the DeviceManager and a Device Server. This configuration is accessed by selecting Tools, Options from the DeviceManager’s tool bar. You can specify the number of times the DeviceManager’s TFTP server retries a file transfer to a Device Server, how long the TFTP process will wait (timeout) before retrying to transfer a file, and the UPD port that will be used for the file transfer between the DeviceManager and the Device Server.
(IPv4 or IPv6), and file name of a termcap file for a specific terminal type. Creating Custom Applications You can create custom applications for the Device Server by using the Perle SDK. See the SDK Programmer’s Guide (the SDK and guide are found on the Perle website at ) for information about the functions that are www.perle.com/downloads/index.shtml...
Page 64
Creating Custom Applications IOLAN Device Server User’s Guide, Version 1.7...
Using the DeviceManager Chapter 5 Introduction This chapter provides information about configuring/managing the Device Server using the DeviceManager. It is assumed that the DeviceManager has already been installed; if you still need to install the DeviceManager, see Using DeviceManager on page Starting a New Session When you start the DeviceManager application, the New Session window is displayed.
Starting a New Session Managing a Device Server You can connect to Device Servers or assign a temporary IP address to a new Device Server. Whenever you connect to a Device Server through the DeviceManager, you connect as the Admin user and must supply the password for the Admin user.
Starting a New Session Assigning a Temporary IP Address to a New Device Server If your network does not use DHCP/BOOTP, you can temporarily assign an IP address to a Device 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).
Connecting to a Device Server Creating a New Device Server Configuration If you selected the New Configuration radio button, the New Configuration window is displayed. Select the Device Server model for which you want to create a new configuration file. Opening an Existing Configuration File If you selected the radio button, a browse window is opened so you can select...
Managing a Device Server Managing a Device Server Once you are connected to a Device Server, you can edit its configuration, download a new configuration, save the configuration to file, perform administrative tasks, and view statistics about the Device Server and its network environment. DeviceManager Work Flow When you connect to a Device Server, the Device Server’s configuration is automatically uploaded to the Device Server.
Configuring the Server Configuring the Server The following sections describe how to configure the Device Server’s server parameters. Configuring the Main Server Window When you select from the navigation panel, the following Server Server Configuration Server window is displayed. Enter values in the Device Server parameters that you need for your production environment. Server Server Name You must supply a name for the Device Server.
Configuring the Server Syslog Syslog client process in the Device Server. DHCP/BOOTP DHCP/BOOTP client process in the Device Server. By default, this is disabled/off. If this is enabled, the server IP address parameter is disabled. Configuring Advanced Server Settings In the Server window, the following window is displayed when you click the Advanced button. Configure the appropriate parameters: OEM Login When set, and a custom language file is in use, the login prompt will use the...
100 Mbps Half Duplex 100 Mbps Full Duplex Custom App You can create a custom application that can run on the Device Server using the Perle SDK. Configure the following parameter: Program The name of the SDK program executable that has been already been...
Configuring Lines Configuring Lines When you configure the Device Server Line , you are specifying how the port will be used and accessed. You can always make changes to parameters, click the button, and then select Line Apply to test your changes. However, you still must select Tools Kill Line Tools...
Page 74
Configuring Lines Flow Control Defines whether the data flow is handled by the software ( ), hardware Soft , or Hard Both None Single Character When enabled, causes the Device Server to process every character as it comes Interrupt in, as opposed to buffering the characters before processing; this provides better latency at the expense of efficiency.
Configuring Lines Advanced Line Settings You can configure these advanced settings for a line. Configure the appropriate parameters: Pages line service, this is the number of video pages the terminal DSLogin supports. Valid values are 1-7. The default is pages. User line service, makes this a line that is dedicated to the specified DSLogin...
Page 76
Configuring Lines Break Specifies how a break is interpreted: None—The Device Server ignores the break key completely and it is not passed through to the host. This is the default setting. Local—The Device Server deals with the break locally. If the user is in a session, the break key has the same effect as a hot key.
Configuring Lines Hotkey Prefix The prefix that a user types to lock a line or redraw the Menu. The default value is , which corresponds to ) (hex value 02 would be hex 01 Ctrl-a Ctrl-b (^b), etc.): —(Lowercase L) Locks the line until the user unlocks it. The user is ^a l prompted for a password (any password, excluding spaces) and locks the line.
Configuring Lines Raw Settings When the is set to , data is sent through the connection in its Line Service Direct Silent Raw original format. This raw TCP/IP connection is initiated from the Device Server to the configured host. Configure the following parameters: Host Name The name of the target host.
Configuring Lines Interrupt Defines the interrupt character. Typing the interrupt character interrupts the current process. This value is in hexadecimal with a default value of (ASCII value Quit Defines the quit character. Typing the quit character closes and exits the current telnet session.
Configuring Lines UDP Settings When the is set to , the Device Server processes UDP packets according to the Line Service UDP settings. Configure the following parameters: Start IP Address The first host IP address in the range of IP addresses (for IPV4 or IPV6) that the Device Server will listen for messages from and/or send messages to.
Configuring Lines VModem Settings When the is set to , the Device Server acts as a virtual modem. After a virtual Line Service VModem modem connection is established, data will flow in both directions in its original format. Configure the following parameters: Host Name The target host name.
Configuring Lines Client Tunnel Settings The purpose of the serial is to allow two Device Servers that are Line Service Client/Server Tunnel connected back-to-back over Ethernet to virtually link two serial ports. The serial device that initiates the connection is the Client Tunnel and the recipient is the Server Tunnel...
Configuring Lines Modbus Master Settings This window configures the parameters for Modbus Masters on the serial side of the Device Server. You can also choose to transmit the Modbus Master data encrypted via SSL/TLS. See Modbus Configuration on page 47 for more information about how to configure the Device Server for a Modbus environment.
Configuring Lines Remote IP Slave Mappings This window allows you to configure all the Modbus Slaves, which reside on the Ethernet/TCP side of the Device Server, that will be receiving messages from the Modbus Master. See Modbus Configuration on page 47 for more information about how to configure the Device Server for a Modbus environment.
Configuring Lines Custom App Settings You can create a custom application that can run on a specific serial line in Device Server using the Perle SDK. Configure the following parameter: Program The name of the SDK program executable that has been already been...
Configuring Lines Packet Forwarding The Packet Forwarding feature allows you to control how the data coming from a serial device is packetized before forwarding the packet onto the LAN network. Configure the following parameters: Packet Definition This section allows you to set a variety of packet definition options. The first criteria that is met causes the packet to be transmitted.
Page 87
Configuring Lines Frame Definition This section 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.
Configuring Users Configuring Modems You need to configure a modem if there is a modem connected to the Device Server. Configure the following parameters: Modem Name The name of the modem. Do not use spaces. Modem The initialisation string of the modem; see your modem’s documentation. Initialisation String Configuring Users You can configure up to four users in the Device Server’s local user database, in addition to the...
Page 89
Configuring Users Level The access that a user is allowed: Admin—The admin level user has total access to the Device Server. You can create more than one admin user account but we recommend that you only have one. They can monitor and configure the Device Server. Normal—The Normal level user has limited access to the Device Server.
Configuring Users Language You can specify whether a user will use as the English Customlang language that appears in the Menu, CLI, or WebManager. The Device Server supports one custom language that must be downloaded to the Device Server; otherwise, defaults to English.
Configuring the Network Configuring the Default User When you add new users to the Device Server, they will initially inherit any parameters set in the (the parameters can be changed on a per user basis). Default User For information on the configuration parameters, see Configuring Users on page Default User...
Configuring the Network Configuring SNMP If you are using the Device Server SNMP MIB-based configuration/management option, you can use the DeviceManager to easily set up SNMP users, traps, and communities. The Device Server supports the SNMP traps for restart and SNMP community authentication error. For more information on SNMP, see SNMP on page Configure the appropriate parameters:...
Configuring the Network Configuring TFTP These parameters configure the TFTP settings for the Device Server’s connections to hosts (as opposed to the TFTP settings under , which configure the TFTP settings for the Tools Options DeviceManager’s connection to a Device Server). Configure the following parameters: Retry The number of times the Device Server will attempt to transfer (using TFTP) a...
Configuring the Network Configuring Syslog You can configure where the system log messages are going to be sent and specify the lowest level message that the Device Server will send syslog messages for. Configure the following options: Primary Host The first preconfigured host that the Device Server will attempt to send system log messages to;...
Configuring Administration Tasks Configuring Administration Tasks You can specify new configuration and firmware files that will go into effect the next time the Device Server is rebooted and a message of the day (MOTD) file, whose contents will be displayed when User’s log into the Device Server.
Statistics Statistics After you are connected to a Device Server, you can view statistics about the Device Server and its network environment. This can help you to troubleshoot problems or can provide valuable information about the Device Server’s environment. Tools Saving a Configuration To File When you connect to a Device Server, the Device Server’s configuration is automatically uploaded to the DeviceManager.
Tools Enter the following information for each Device Server that you want to configure with the same configuration file: IP Address Enter the IP address of the Device Server that you want to download the configuration to. Server Name The name of the Device Server. The Device Server name that you put in this field is passed into the configuration before it is downloaded to the Device Server and cannot be left blank.
Tools Setting the Device Server’s Date and Time To set the Device Server’s system clock, select Tools Set Unit Time/Date . The Set Date/Time window is displayed. Configure the following parameters: Date The Device Server’s date. The format of the Device Server’s date is dependent on the Windows operating system and regional settings.
Language support on page 58 for information on creating custom language files. Downloading a Custom App File You can download each custom application file, created with the Perle SDK, to the Device Server using this option. Setting DeviceManager Options When you select...
Page 100
Tools TFTP—Sets the TFTP options for communication between the DeviceManager and a Device Server. Configure the following parameters: Retry The number of times the DeviceManager will attempt to transfer (using TFTP) a file to/from a Device Server. Enter a value between 0 and 5. The default is 5. A value of 0 (zero) means that the Device Server will not attempt a retry should TFTP fail.
Command Line Interface Chapter 6 Introduction This chapter provides the command line interface (CLI) options available for the Device Server. The commands are grouped by function. CLI Conventions This section explains how to interpret the CLI syntax. Command Syntax Each command is broken down into several categories: Description—Provides a brief explanation of how the command is used.
CLI Conventions Command Shortcuts When you type a command, you can specify the shortest unique version of that command or you can press the key to complete the command. For example, the following command: set telnet-client map-to-crlf off can be typed as: set tel map off or, you can use the key to complete the lines as you go along:...
This section defines all the CLI commands associated with configuring the Device Server’s server parameters. Server Commands Set Custom-App Description You can create a custom application that can run on the Device Server using the Perle SDK. User Level Admin Syntax set custom-app server program-command-line <command>...
Page 104
Server Commands internet The Device Server’s unique IPv4 network IP address. If you are using the Device Server in an IPv6 network, this field can be left blank. oem-login When set, and a custom language file is in use, the login prompt will use the string defined in the language file as the login prompt instead of the default prompt, login: password-limit...
Server Commands Set Service Description Sets server service parameters. User Level Admin Syntax set service [dhcp/bootp on|off] [telnetd on|off] [httpd on|off] [snmpd on|off] [spcd on|off] [syslog on|off] [dmgrd on|off] [modbusd on|off] Options dhcp/bootp DHCP/BOOTP client process in the Device Server. By default, this is disabled/off. If this is enabled, the server IP address parameter is disabled.
Server Commands Hardware Commands Set Ethernet Description Sets the serial line speed and duplex. User Level Admin Syntax set ethernet speed-and-duplex auto|10-half|10-full|100-half|100-full Options auto|10-half|10-full|100-half|100-full Define the ethernet connection speed at one of the following: auto —automatically detects the ethernet interface speed and duplex 10 Mbps Half Duplex 10 Mbps Full Duplex 100 Mbps Half Duplex...
Server Commands exceptions When enabled, an exception message is generated and sent to the initiating Modbus device when any of the following conditions are encountered: there is an invalid UID, the UID is not configured in the Gateway, there is no free network connection, there is an invalid message, or the target device is not answering the connection attempt.
User Commands TruePort Baud Commands Set TruePort Remap-Baud Description Sets the TruePort baud remapping values. User Level Admin Syntax set trueport remap-baud 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200| 38400 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200| 38400|57600|115200|230400|28800 Options 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200|38400 The configured baud rate of the TruePort client. 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200|38400| 57600|115200|230400|28800 The actual baud rate that runs between the Device Server and the connected serial device.
User Commands Logout Description Logs the user out from the Device Server. User Level Restricted, Normal, Admin Syntax logout Menu Description Switches from the CLI mode to the Menu. User Level Restricted, Normal, Admin Syntax menu Ping Description Pings the specified host/IP address. User Level Normal, Admin Syntax ping <hostname/IP_address>...
User Commands Set Termtype Description Sets the type of terminal being used for the current session. User Level Normal, Admin Syntax set termtype wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2| term3 Option wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2|term3 Specifies the type of terminal connected to the line: Dumb WYSE60 VT100 ANSI TVI925 IBM3151TE VT320 (specifically supporting VT320-7)
User Commands Start Description Starts a predefined session. Only inactive sessions are displayed. User Level Restricted, Normal, Admin Syntax start 1|2|3|4 Options 1|2|3|4 The number of the session that you want to start. Telnet Description Starts a telnet session to the specified host/IP address. User Level Normal, Admin Syntax telnet <hostname/IP_address>...
User Commands quit Defines the quit character. Typing the quit character closes and exits the current telnet session. This value is in hexadecimal with a default value of (ASCII value escape Defines the escape character. Returns you to the command line mode. This value is in hexadecimal with a default value of (ASCII value Version...
User Commands Set Default User Description Configures the Default User. User Level Admin Syntax set default user [hotkey-prefix <00-7f>] [idle-timer <0-4294967>] [ip-host <ip_address>] [language english|customlang] [level admin|normal|restricted|menu] [line-access readin|readwrite on|off] [service dsprompt|telnet|tcp-clear] [sess-timer <0-4294967>] [port tcp-clear|telnet <tcp_port>] Options hotkey-prefix The prefix that a user types to control the current session. The default value is hex 01 which corresponds to ) (hex value 02 would be Ctrl-b (^b), etc.):...
Page 115
User Commands level The access that a user is allowed: Admin—The admin level user has total access to the Device Server. You can create more than one admin user account but we recommend that you only have one. They can monitor and configure the Device Server. Normal—The Normal level user has limited access to the Device Server.
User Commands Set User Description Sets user’s settings. Normal-level users can configure only their own settings. Admin-level users can configure any user’s settings, including their own (with the exception of their User Level, which must stay at Admin). User Level Normal, Admin Syntax set user .
Page 117
User Commands level The access that a user is allowed: Admin—The admin level user has total access to the Device Server. You can create more than one admin user account but we recommend that you only have one. They can monitor and configure the Device Server. Normal—The Normal level user has limited access to the Device Server.
User Commands Set User Session Description Configures a user’s session settings. See Set User Session on page 111 for the options descriptions. User Level Admin Syntax set user .|<username> session 1|2|3|4|* [auto on|off] [type off|telnet] set user .|<username> session 1|2|3|4|* telnet-options [host <config_host>] [port <TCP_port>] [termtype <terminal_name>] [line-mode on|off] [map-cr-crlf on|off] [local-echo on|off]...
Line Commands Line Commands Line Commands Set Line Description Configures line parameters. User Level Normal, Admin Syntax set line [data-bits 5|6|7|8] [dial none|in|out|both] [idle-timer <0-4294967>] [line-name <name>] [modem-name <config_modem>] [pages 1|2|3|4|5|6|7] [parity none|even|odd|mark|space] [phone-number <phone_number>] [rev-sess-security on|off] [sess-timer <0-4294967>] [stop-bits 1|2|1.5] [termtype wyse60|vt100|ansi|dumb|tvi925| ibm3151te|vt320|hp700|term1|term2|term3] Admin set line ...
Page 120
Line Commands rev-sess-security Enables/disables login/password authentication, locally or externally, on reverse Telnet connections. The default is sess-time Enter a time, in seconds, for which the will run. Use this timer to Session Timer forcibly close the session (connection). When the expires, the Device Session Timer Server will end the connection.
Page 121
Line Commands keepalive 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, either ensuring the connection stays active OR causing a dropped connection condition to be recognised by the reverse raw service.
Line Commands term-type Specifies the type of terminal connected to the line: Dumb WYSE60 VT100 ANSI TVI925 IBM3151TE VT320 (specifically supporting VT320-7) HP700 (specifically supporting HP700/44) Term1, Term2, Term3 (user defined terminals) Set Line Interface Description Configures line interface (hardware) parameters. User Level Admin Syntax set line interface eia-232 [monitor-dcd on|off]...
Line Commands tx-driver-control Used with a EIA-485 serial interface, if your application supports (Request To Send), select this option. Otherwise, select Auto . Default is Auto duplex Specify whether the line is (communication both ways at the same time) or Full Duplex (communication in one direction at a time).
Page 124
Line Commands silent Silent connections are the same as direct connections, except they are permanently established. The host login prompt is displayed on the screen. Logging out redisplays this prompt. Silent connections, unlike direct connections, however, make permanent use of pseudo tty resources and therefore consume host resources even when not in use. Creates a connection where no authentication takes place and data is passed unchanged.
Line Commands Set Modem Description Sets the modem initialization strings. User Level Admin Syntax set modem <modem_name> <init_string> Options <modem_name> Predefined modem name. <init_string> Specify the initialization string for the internal modem. This can be up to 60 characters long, but cannot include spaces. Set Termtype Description Sets the terminal type for the current terminal session.
Line Commands Line Service Commands Set Custom-App Description You can create a custom application that can run on a specific serial line in Device Server using the Perle SDK. User Level Admin Syntax set custom-app line .|<number>|* program-command-line <command> Options...
Line Commands intr Defines the interrupt character. Typing the interrupt character interrupts the current process. This value is in hexadecimal with a default value of (ASCII value quit Defines the quit character. Typing the quit character closes and exits the current telnet session.
Line Commands host The target host name. port The port number the target host is listening on for messages. style One of the following: Verbose—Return codes (strings) are sent to the connected device. Numeric—The following characters can be sent to the connected device: 1 Successfully Connected 2 Failed to Connect 4 Error...
Line Commands Set Modbus-Master Line Description Sets the Modbus master parameters for the line. SSL/TLS can be enabled and configured for this Line Service. User Level Admin Syntax set modbus-master line .|<number>|* [crlf on|off] [protocol rtu|ascii] [[entry <number> [port <port>] [protocol udp|tcp] [range-mode gateway|host] [slave-ip <IP_address>] [uid-range <start_uid>...
Line Commands Show Interface Description Shows the network interface information. User Level Admin Syntax show interface [brief|ethernet] Show Modbus Description Shows the Modbus settings for a line. User Level Admin Syntax show modbus master|slave <number> Show Telnet-Client Description Shows the telnet client settings for a line. User Level Admin Syntax show telnet-client...
Line Commands Packet Forwarding Commands Set Packet-Forwarding Line Description The Packet Forwarding feature allows you to control how the data coming from a serial device is packetized before forwarding the packet onto the LAN network. This command configures packet forwarding options for serial devices attached to the serial line.
Page 132
Line Commands eof1 Specifies the End of Frame charater, which defines when the frame is ready to be transmitted. The actual tranmission of the frame is based on the Trigger Forwarding Rule. Valid values are in hex 0-FF. The default is 0. eof2 When enabled, creates a sequence of charaters that must be recieved to define the end of the frame (if the EOF1 charater is not immediately followed by the EOF2 character,...
Network Commands Show Packet-Forwarding Line Description Shows the packet-forwarding settings for the line. User Level Admin Syntax show packet-forwarding line <number> Network Commands SNMP Commands The Device Server supports SNMP traps restart and SNMP community authentication error. Add Community Description Adds an SNMP community (version 1 and version 2). User Level Admin Syntax add community <community_name>...
Network Commands Delete Community Description Deletes an SNMP community (version 1 and version 2). User Level Admin Syntax delete community <config_community_number> Option <config_community_number> When you add an SNMP community, it gets assigned to a number. To delete the SNMP community, you need to specify the number of the community that you want to delete. To see which community is assigned to what number, type the command.
Network Commands TFTP Commands Set Server TFTP Description Configures the Device Server’s TFTP client settings. User Level Admin Syntax set server tftp [retry <integer>] [timeout <integer>] Options retry The number of times the Device Server will attempt to transfer (using TFTP) a file to/from a host.
Network Commands Gateway Commands Add Gateway Description Adds a gateway. You can configure up to twenty gateways. User Level Admin Syntax add gateway <config_host> default add gateway <config_host> host <dest_IP_addr> add gateway <config_host> network <dest_IPv4_addr>|<dest_IPv6_addr> [<subnet_bits_0-32>|<subnet_bits_0-128>] Options <config_host> You can specify up to twenty hosts to act as gateways in your network. Each gateway host must be defined in the Device Server host table.
Network Commands Set Gateway Description Configures the gateway. User Level Admin Syntax set gateway <config_gateway_host> default set gateway <config_gateway_host> host <destination_ip> set gateway <config_gateway_host> network <dest_IPv4_addr>|<dest_IPv6_address> <prefixbits_mask>| Options <config_gateway_host> You can view the configured gateways that can be deleted by typing delete gateway ? default|host|network Specify the type of gateway:...
Time Commands Logging Commands Set Syslog Description Configures the system log. User Level Admin Syntax set syslog [level emergency|alert|critical|error|warning|notice|info|debug] [primary-host <config_host>] [secondary-host <config_host>] Options level Choose the event level that triggers a syslog entry: Emergency Alert Critical Error Warning Notice Info Debug When you select a...
Administration Commands Time/Date Setting Commands Set Date Description Sets the Device Server’s system clock. User Level Admin Syntax set date <dd/mm/yyyy> Set Time Description Sets the Device Server’s system clock. User Level Admin Syntax set time <hh:mm[:ss]> Option <hh:mm[:ss]> Sets the Device Server’s system time, using military time format. Show Date Description Shows the date, according to the Device Server system clock.
Administration Commands Set Bootup Description Specifies remote the TFTP host and pathname for files to be loaded after a Device Server reboot. User Level Admin Syntax set bootup firmware host <hostname> [file <path_filename>] set bootup configuration host <hostname> [file <path_filename>] Options firmware file The path and file name (do not use a drive letter), relative to the default path of your...
Administration Commands customapp-file You can download multiple SDK program executables and ancillary files using this command by running the command multiple times to download multiple files. Use the CLI command as described in the SDK Programmer’s Guide to manage the files shell that you download.
Statistic Commands Show MOTD Description Show the Message of the Day (MOTD) settings. User Level Admin Syntax show motd Statistic Commands Configuration Statistics Show Netstat Description Shows currently used TCP/UDP sockets/ports. User Level Admin Syntax show netstat [all] [listening] [tcp] [udp] [tcpv6] [updv6] Options Displays all ports, including server (listening) ports;...
Statistic Commands Run-Time Statistics Delete Arp Description Delete entries from the Device Server's ARP cache. Takes effect immediately; not related to configuration. User Level Admin Syntax delete arp Show Arp Description Shows the current contents of the ARP cache. User Level Admin Syntax show arp Show Serial...
Page 144
Statistic Commands IOLAN Device Server User’s Guide, Version 1.7...
Power the Device Server on. If there is a problem with the Device Server firmware, you will need to reload the firmware, which can be found either on the CD-ROM that came with the Device Server or on the Perle website, www.perle.com/downloads/serial.shtml...
DeviceManager Problems DeviceManager Problems Error Message: 16 bit Windows Subsystem - C:\WINDOWS\SYSTEM32\AUTOEXEC.NT. The system file is not suitable for running MS-DOS and Microsoft Windows applications. Choose 'Close' to terminate the application. The error message can be misleading, because it is displayed even if the file is AUTOEXEC.NT actually missing.
Problems with Terminals Problems with Terminals The following section concerns problems with the appearance of data on your terminal screen. The Device Server logs me out after a few minutes: Check the value set for the user. The default setting for the for all users is Idle Timer Idle Timer...
DHCP/BOOTP Problems DHCP/BOOTP Problems Messages: host name too long filename too long. The Device Server can only accept host names of 14 characters or file names of 64 characters, so verify that you are not attempting to pass a string that is longer than those maximums. DHCP or BOOTP have been set up to configure my Device Server, but does not seem to have done anything.
Utilities Appendix B Introduction This chapter provides information on the TruePort utility. TruePort TruePort is a com port redirector utility for the Device Server. It can be run in two modes: TruePort Full mode—This mode allows complete device control and operates exactly like a directly connected serial port.
Page 150
TruePort For more information, see the TruePort User Guide or the TruePort Installation and Configuration Guide for Windows NT on the CD-ROM. IOLAN Device Server User’s Guide, Version 1.7...
Glossary This chapter provides definitions for Device Server terms. BOOTP (BOOTstrap An Internet protocol that enables a diskless workstation to discover its own IP address, the IP Protocol) address of a BOOTP server on the network, and a file to be loaded into memory to boot the machine.
Page 152
Glossary IOLAN Device Server User’s Guide, Version 1.7...
Index admin DB25 default password pinouts level female lost password male ARP-Ping, setting an IP address power in pin female connector male DB9 male pinouts definitions bidir Device Server models general Device Servers, configuring multiple parameters DeviceManager binary configuration file overview BOOTP setting an IP address...
Page 154
Index IPv6, setting an IP address parameters bidir BOOTP/DHCP bootup files gateways jumpers hardware line termination hosts power out line setting line access modems MOTD language server translating sessions upgrading firmware SNMP LED guide syslog levels, user telnet line access parameters TFTP line parameters line termination, setting jumper...
Page 155
Index SDK, custom application virtual modem serial configuration vmodem serial mode overview serial tunnel parameters server parameters services bidir WebManager vmodem overview session parameters using sessions setting an IP address ARP-Ping BOOTP/DHCP DeviceManager direct connect IPv6 silent connections SNMP parameters supported traps using syslog parameters...
Page 156
Index IOLAN Device Server User’s Guide, Version 1.7...