IOLAN DS Family DS1 User’s Guide Version 1.
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.
Table of Contents Preface ...............................................................................13 About This Book ........................................................................ 13 Intended Audience..................................................................... 13 Documentation........................................................................... 13 Typeface Conventions............................................................... 14 Online Help ..............................
Typical Applications Summary .................................................19 Managing the Device Server .................................................................. 19 Managing/Accessing devices attached to the Device Server............. 19 Network Security..................................................................................... 19 Chapter 2 Installation........................................................21 Introduction..............................................................
Chapter 3 Configuration Methods ...................................29 Introduction ................................................................................ 29 DeviceManager........................................................................... 29 WebManager............................................................................... 30 Using the WebManager.......................................................................... 30 CLI .........................................................
Setting Up Lines .........................................................................37 Direct/Silent/Reverse Connections ....................................................... 37 Virtual Modems ....................................................................................... 38 BIDIR ........................................................................................................ 38 UDP ......................................................................................................
Chapter 5 Using the DeviceManager ...............................47 Introduction ................................................................................ 47 Starting a New Session ............................................................. 47 Manage Device Server Tab .................................................................... 48 Populating the Device Server List ...................................................... 48 Assigning a Temporary IP Address to a New Device Server.............
Configuring the Network............................................................65 Configuring Hosts................................................................................... 65 Configuring SNMP .................................................................................. 66 Configuring TFTP....................................................................................67 Configuring Gateways............................................................................
Server Commands ..................................................................... 77 Server Commands.................................................................................. 77 Set Server .......................................................................................... 77 Set Service......................................................................................... 78 Show Server.......................................................................................
Line Commands..........................................................................90 Line Commands ...................................................................................... 90 Set Line .............................................................................................. 90 Set Line Interface ............................................................................... 93 Set Line Service .................................................................................
Time Commands ...................................................................... 104 Set Time........................................................................................... 104 Show Time ....................................................................................... 104 Time/Date Setting Commands............................................................. 105 Set Date ........................................................................................... 105 Show Date...........
Problems with Terminals .........................................................112 Unknown IP Address................................................................113 DHCP/BOOTP Problems ..........................................................113 Language Problems .................................................................114 Long Reboot Cycle...................................................................114 Appendix B Utilities ........................................................
Preface About This Book This guide provides the information you need to: z configure the Device Server z incorporate 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: z If you are using an external authentication application(s), working knowledge of the authentication application(s).
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. It can represent a line you type in, or a piece of your code, or an example of output. add host Set the value to TRUE.
Contacting Technical Support Contacting Technical Support Making a Technical Support Query Who To Contact Note: 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.
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. 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/rma_form.
1 Introduction Chapter 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: z Terminals for multi-user UNIX systems z Data acquisition equipment (manufacturing, laboratory, scanners, etc.) z Retail point-of-sale equipment (bar coding, registers, etc.
Supported Products/Versions Software The Device Server software features include: z Multiple ways to configure the Device Server: – 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 configu
Typical Applications Summary Typical Applications Summary Managing the Device Server The Device Server can be managed and configured by administrators through various methods, allowing them full configuration capabilities and easy access to management statistics and tools. Administrators can access the Device Server using the following methods: z Connection through ethernet using the DeviceManager, a Windows-based configuration application.
Typical Applications Summary 20 IOLAN Device Server User’s Guide, Version 1.
2 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.
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: 1. Plug the external power supply into the Device Server and then into the electrical outlet. 2. If the Device Server is working correctly, you should see: a. The Power/Ready LED starts out red. b.
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: z DeviceManager—Use this method when you can connect the Device Server to the network and access the Device Server from a Windows® PC.
Setting an Initial IP Address 9. Expand the Server Configuration folder and select Server. You can choose to enter a permanent IP address in the Internet Address field of the Server window. 10. Click the Apply button when you’re done with the Server window. To permanently assign the IP address, you need to download the new configuration file and then reboot the Device Server. 11. Download the configuration file to the Device Server by selecting Tools, Download Configuration to Unit. 12.
LED Guide Using ARP-Ping You can use the ARP-Ping (Address Resolution Protocol) method to temporarily assign an IP address and connect to your Device Server to assign a permanent IP address. To use ARP-Ping to temporarily assign an IP address: 1. From a local UNIX/Linux host, type the following: arp -s a.b.c.d aa:bb:cc:dd:ee:ff On a Windows® 98 or newer system, type the following: arp -s a.b.c.d aa-bb-cc-dd-ee-ff (where a.b.c.
Pinouts Pinouts Pin 1 Pin 13 Pin 14 Pin 25 The following table provides pinout information: Pinout EIA-232 EIA-422 EIA-485 Full Duplex EIA-485 Half Duplex 1 Shield Shield Shield Shield 2 (out) TxD 3 (in) RxD 4 (out) RTS 5 (in) CTS 6 (in) DSR 7 GND GND GND GND 8 (in) DCD 12 Power in Power in Power in Power in 13 CTS- 14 TxD+ TxD+ DATA+ 15 TxD- TxD- DATA- 18 RTS+ 19 RTS- 20 (out) DTR 26 21 RxD+ RxD+ 22 RxD- RxD- 25 CTS+ IOLAN Device Server User’s Gu
EIA-232 Cabling Diagrams EIA-232 Cabling Diagrams This section shows how to create EIA-232 cables that are compatible with the Device Server. Terminal DB25 Connector The following diagram shows how the null modem cable should be configured when connecting to a terminal DB25.
EIA-232 Cabling Diagrams PC DB9 Connector The following diagram shows how the null modem cable should be configured when connecting to a DB9 PC. IOLAN DS1 DB25 (DTE) PC DB9 (DTE) 2 (TxD) 2 (RxD) 3 (RxD) 3 (TxD) 4 (RTS) 8 (CTS) 5 (CTS) 7 (RTS) 6 (DSR) 4 (DTR) 7 (GND) 5 (GND) 20 (DTR) 6 (DSR) Modem DB9 Connector The following diagram shows how the cable should be configured when connecting to a DB9 Modem.
3 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. Through the DeviceManager, you can: z assign an IP address to new Device Servers. z perform firmware updates.
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.Type in the Admin password. Using the WebManager The Server Configuration window is displayed after you first logon. The running Device Server configuration is displayed in the WebManager.
DHCP/BOOTP Menu Conventions You select an option from the Menu by using the keyboard up and down arrows to navigate the list. When the menu item you want to access is highlighted, press the Enter key to either get to the next list of options or to get the configuration screen, depending on what you select. When you are done configuring parameters in a screen, press the Enter key and then the Enter key again to Accept and exit the form.
SNMP The first variable in each folder is the Status variable, for example, serviceStatus. When you perform a GET on this variable, one of the following values will be returned: z 1—Indicates that the container folder is active with no changes. z 2—Indicates that the container folder is active with change(s). Once you have completed setting the variables in a folder, you will want to submit your changes to the Device Server. To do this, set the Status variable to 4.
4 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.
Configuring the Device Server Device Server Services In order to be as flexible and accessible as the Device Server is, it can run several predefined daemon and client applications. The Device Server can run the following daemon applications: z TelnetD z SPCD (the Trueport daemon) z DeviceManagerD z HTTPD z SNMPD If you disable any of the daemons, it can affect how the Device Server can be used or accessed.
Machine To Machine Connections Serial Connection You also need to know the serial interface specifications as follows: z EIA-232 and its speed z EIA-422 and its speed z EIA-485 and – its speed – half duplex with/without echo suppression or full duplex – TX driver control is automatic or RTS Other The most important thing to keep in mind when configuring the hardware parameters is to make sure that they are consistent with the serial device you have connected to the port.
Users Connecting to Serial Devices Users Connecting to Serial Devices For a user to connect to the serial device connected to the Device Server from the LAN, the Line Service must be set to Rev Telnet. The user will either access the serial device directly or go through the Easy Port Access Menu, depending on the User Level setting. Users who are Level Admin or Normal will access the serial device directly; the user must connect to the Device Server’s IP address and port number (the DS Port parameter).
Setting Up Lines Connecting Through the Device Server When a user connects through the Device Server, that user is authenticated and is usually set up with a User Service that, once authentication is completed successfully, passes the user onto the specified host. Therefore, the Line Service is set to DSLogin and the User Service is set to whatever protocol the user will use to access the host; in this example, the User Service is set to Dir Telnet.
Setting Up Lines Virtual Modems Vmodem is a feature of the Device Server that provides “modem like” communication between two Device Servers on a network or between a Device Server and a host. This feature behaves like two modems connected across a telephone line. Typically, you use the Vmodem feature when you have multiple devices communicating with a central site.
Setting Up Users z UDP Entry 3 All hosts that have an IP Address that falls within the range of 172.16.1.75 to 172.16.1.80 and who listen to Port 33009 will receive UDP data from the serial device. No UDP data will be sent to the serial device. z UDP Entry 4 This entry is disabled since Direction is set to None.
Configuring Network Options Sessions Sessions are defined for users who are coming in through a serial device going to a host on the LAN. Users who have successfully logged into the Device Server (User Service set to DSprompt) can start up to four login sessions on LAN hosts. These users start sessions through the Menu option Sessions. Multiple sessions can be run simultaneously on the same host or on different hosts.
Configuring Time Syslog The system log is sent to the specified host. You can configure a primary and secondary host for the syslog information and specify the level for which you want syslog information sent. SNMP If you are using SNMP to manage/configure the Device Server, or to view statistics or traps, you must set up a User in SNMP version 3 or a Community in SNMP version 1,2 to allow your SNMP manager to connect to the Device Server; this can be done in the DeviceManager, WebManager, CLI, or Menu.
Language support 5. To set an individual user to the new language, go to the Users menu and, in the Language field select Customlang. In the CLI (only) you can set individual users or all users to the new language; see the set user * command. 6. The user will see the change of language when he/she logs out (Main Menu, Sessions Menu, Logout) and logs back into the Device Server.
Downloading Terminal Definitions Downloading Terminal Definitions All terminal types can be used on the Device Server. Some terminal types which are not already defined in the Device Server, however, are unable to use Full Screen mode (menus) and may not be able to page through sessions properly. When installed, the Device Server has several defined terminal types—Dumb, WYSE60, VT100, ANSI, TVI925, IBM3151, VT320, and HP700.
TFTP Configuration For example: term=AT386 | at386| 386AT |386at |at/386 console acsc=jYk?lZm@qDtCu4x3 bold=\E[1m civis= clear=\E[2J\E[H cnorm= cup=\E[%i%p1%02d;%p2%02dH rev=\E4A rmacs=\E[10m rmso=\E[m smacs=\E[12m smso=\E[7m page= circ=n Note: As you can see from the example, capabilities which are not defined in the terminfo file must still be included (albeit with no value). Each entry has an 80 character limit.
Resetting Configuration Parameters Resetting Configuration Parameters You can reset the Device Server to its factory settings through any of the following methods: z You can push in the recessed button at the back of the Device Server hardware z DeviceManager, select Tools, Reset to Factory Defaults z CLI, at the command line type, reset factory z WebManager, click the Factory Defaults button z Menu, select Network Configuration, Reset to Factory Defaults z SNMP, in the adminInfo folder, Set the
DHCP/BOOTP z CUSTOM_LANG—The full path, pre-fixed by a hostname/IP address (IPv4 or IPv6), and file name of a translated language file. For example, 192.101.34.211 /accounting/german.txt. z 46 EXTRA_TERM1—(EXTRA_TERM2, EXTRA_TERM3) The full path, pre-fixed by a hostname/IP address (IPv4 or IPv6), and file name of a termcap file for a specific terminal type. IOLAN Device Server User’s Guide, Version 1.
5 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 23. Starting a New Session When you start the DeviceManager application, the New Session window is displayed.
Starting a New Session Manage Device Server Tab You can connect to Device Servers or assign a temporary IP address to a 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. Populating the Device Server List The first time you start the DeviceManager, the Manage Device Server tab will be empty.
Starting a New Session Adding/Deleting Static Device Servers To permanently add or delete a Device Server to/from the Device Server List, select the Static Server List button. The following window is displayed: To permanently add a Device Server to the Device Server List, type in the IP address of the Device Server and click the Add Server button. To permanently delete a Device Server from the Device Server List, select the Device Server’s IP address and click the Delete Server button.
Connecting to a Device Server Connecting to a Device Server To connect to a Device Server, double-click on the Device Server in the Device Server List. You will be prompted for the Admin Password. If the authentication and connection are successful, the Device Server’s Server Info window is displayed. If you cannot connect to a Device Server, you can highlight the Device Server and click the Ping button to verify that that DeviceManager can communicate with the Device Server’s IP Address.
Configuring the Server Working With a Local Configuration File You can also connect to a Device Server and open a saved configuration file by selecting Tools, Get Configuration, Import from File. This configuration can then be edited or just downloaded right to the Device Server by selecting Tools, Download Configuration to Unit. The downloaded configuration does not take effect until you reboot the Device Server by selecting Tools, Reboot Server.
Configuring the Server Password Limit The number of attempts a user is allowed to enter a password for a port. If this limit is exceeded, the port is disabled for 5 minutes. A user with Admin level rights can restart the port, bypassing the timeout, by issuing a kill on the disabled port. The default value is 3. Bypass Password When set, authorised users who do not have a password set, with the exception of the Admin user, WILL NOT be prompted for a password at login with Local Authentication.
Configuring the Server Syslog Syslog client process in the Device Server. DHCP/BOOTP DHCP/BOOTP client process in the Device Server. Configuring Trueport Baud The Trueport Baud configuration window allows you to map the baud rate coming out of the serial host to another baud rate that will run between the Device Server and the serial device. See Appendix B, Utilities on page 115 for more information about Trueport.
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 Line parameters, click the Apply button, and then select Tools, Kill Line to test your changes. However, you still must select Tools, Download Configuration to Unit and Tools, Reboot Server to make your changes permanent and take effect.
Configuring Lines Monitor DCD Flow Control Bits Specifies whether the RS-232 signal DCD (Data Carrier Detect) should be monitored. This is used with modems or any other device that sends a DCD signal. When it is monitored and the Device Server detects a DCD signal, the line service is started. Default is Off. If both Monitor DCD and Monitor DSR are enabled, both signals must be detected before the line service is started.
Configuring Lines Break Specifies how a break is interpreted: z None—The Device Server ignores the break key completely and it is not passed through to the host. This is the default setting. z 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. z Remote—When the break key is pressed, the Device Server translates this into a telnet break signal which it sends to the host machine.
Configuring Lines Idle Timer Enter a time period, in seconds, for which the idle timer will run. Use this timer to close a connection because of inactivity. When the idle timer expires, the Device Server will end the connection. The maximum value is 4294967 seconds (about 49 days). The default value of 0 (zero) means the idle timer will not expire, so the connection is permanently open. Session Timer Enter a time, in seconds, for which the session timer will run.
Configuring Lines Telnet Settings When the Line Service is set to Direct or Silent Telnet, data is sent through the connection in a telnet session. This telnet session is initiated from the Device Server to the configured host. Configure the following parameters: Terminal Type Type of terminal attached to this line; for example, ANSI or WYSE60. Host Name The name of the target host. Port The port number the target host is listening on for incoming connections.
Configuring Lines BIDIR Settings When the Line Service is set to BIDIR, a bidirectional connection is created, with data flowing in both directions in its original format. This raw TCP/IP connection can be initiated from either the Device Server or the configured host. Configure the following parameters: Host Name The name of the target host. Port The port number the target host is listening on for incoming connections.
Configuring Lines Direction The direction in which information is received or relayed: z None—UDP service not enabled. z In—LAN to serial. z Out—Serial to LAN. z Both—Messages are relayed both directions. VModem Settings When the Line Service is set to VModem, the Device Server acts as a virtual modem. After a virtual 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 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 Admin user. Configure the following parameters: User Name The name of the user.
Configuring Users 62 Level The access that a user is allowed: z 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 or configure the Device Server through the CLI or Menu. z Normal—The Normal level user has limited access to the Device Server. Limited CLI commands and Menu access are available with the ability to configure the user’s own configuration settings.
Configuring Users Language You can specify whether a user will use English or Customlang as the 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, Customlang defaults to English. Service The type of service that the user will use. Host IP When the User Service is set to Telnet or TCP_clear, the target host IP address. If 255.255.255.
Configuring Users Configuring Sessions You can configure user Sessions to limit the access the user has to the network and the way the user connects to a host. Users who are Level Normal or Admin can define Free Sessions, in addition to using defined sessions. Users who are Level Restricted or Menu can only access predefined sessions. Configure the following parameters: Session You can create up to four predefined sessions for each user.
Configuring the Network Configuring the Network The network configuration parameters define the network that the Device Server will be operating within. Configuring Hosts One of the first things you will probably want to configure is the hosts that the Device Server or Users will be interacting with, since most configuration windows require that the hosts already be configured. You can configure up to 20 hosts. Configure the following parameters: Host Name The name of the host.
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 31. Configure the appropriate parameters: 66 Contact The name and contract information of the person who manages this SMNP node.
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 Tools, Options, which configure the TFTP settings for the 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 file to/from a host. Enter a value between 0 and 5. The default is 5.
Configuring the Network Subnet/Prefix Bits When the gateway is a Network gateway, you must specify the subnet/prefix bits for that network. If the IP address is IPv4, then the Subnet/Prefix Bits range is 0-32. If the IP address is IPv6, then the Subnet/Prefix Bits range is 0-128. Gateway List The list of defined gateways. 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.
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. Configuring Bootup Files When you specify a configuration and/or firmware file(s), the files will be downloaded via TFTP to the Device Server the next time it is rebooted.
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 2. 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. Password Enter the Admin user password for the Device Server.
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, in the format dd/mm/yyyy. Time The Device Server’s time. Rebooting the Device Server When you download any file (configuration, keys, certificates, firmware, etc.) to the Device Server, you must reboot the Device Server for it to take effect by selecting Tools, Reboot Server.
Tools Downloading a Language File You can download one custom language file that can be specified in the User configuration window. See Language support on page 41 for information on creating custom language files.
Tools 74 IOLAN Device Server User’s Guide, Version 1.
6 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: z Description—Provides a brief explanation of how the command is used. z User Level—Shows which user level(s) (Restricted, Normal, and/or Admin) can issue the command.
CLI Conventions Command Shortcuts When you type a command, you can specify the shortest unique version of that command or you can press the ESC 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 ESC key to complete the lines as you go along: set telnet-client map-to-crlf off where the key was pressed to complete the option as it was typed.
Server Commands Server Commands This section defines all the CLI commands associated with configuring the Device Server’s server parameters. Server Commands Set Server Description Sets server parameters.
Server Commands prompt-with-name Displays the Server Name field value instead of default product name. When enabled, the Server Name is displayed in the Device Server login prompt, CLI prompt, WebManager login screen, and the heading of the Menu. The default value is Off. single-telnet Sets all reverse connections (raw and telnet) to a one connection at a time mode.
Server Commands spcd SPC (Trueport) daemon process in the Device Server on port 688. syslog Syslog client process in the Device Server. dmgrd DeviceManager daemon process in the Device Server. If you disable this service, you will not be able to connect to the Device Server with the DeviceManager application. DeviceManagerD listens on port 33812 and sends on port 33813. Show Server Description Shows the parameters set for the server.
User Commands Trueport Baud Commands Set Trueport Remap-Baud Description Sets the Trueport baud remapping values. User Level Admin set trueport remap-baud Syntax 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|460800|921600|1843200|3686400 Options 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200|38400 The configured baud rate of the Trueport client.
User Commands Logout Description Logs the user out from the Device Server. User Level Restricted, Normal, Admin logout Syntax Ping Description User Level Syntax Options Pings the specified host/IP address. Normal, Admin ping [] [<#_of_packets>] The name (host name or DNS name) or IP address of the machine you are trying to ping (verify the connection with). Enter the number of data bytes to be sent. The maximum size is 2000 bytes.
User Commands Set User Description Sets the current user’s settings. User Level Normal, Admin set user . [hotkey-prefix <00-7f>] [language english|customlang] Syntax [password] Options hotkey-prefix The prefix that a user types to control the current session. The default value is hex 01, which corresponds to Ctrl-a (^a) (hex value 02 would be Ctrl-b (^b), etc.): z ^a number—To switch from one session to another, press ^a and then the required session number.
User Commands Show Line Users Description Shows the users who are on the line. User Level Admin show line users Syntax Syslog Console Description Starts/stops or displays the status of the syslog console. User Level Admin syslog console start|stop Syntax syslog console status Options start|stop Start or stop console logging. When console logging is enabled, syslog messages will be echoed to the current console. These messages are filtered based on the level set in the (remote) syslog options.
User Commands Telnet Description Starts a telnet session to the specified host/IP address. User Level Normal, Admin telnet [] Syntax [termtype ] [line-mode on|off] [map-cr-crlf on|off] [local-echo on|off] [echo <00-7f>] [eof <00-7f>] [erase <00-7f>] [intr <00-7f>] [quit <00-7f>] [escape <00-7f>] Options The name of the target host. The port number the target host is listening on for incoming connections.
User Commands Version Description Displays firmware version and build. User Level Normal, Admin version Syntax Configuring Users Add User Description User Level Syntax Option Adds a user. You can add and configure up to four users in the Device Server. Admin add user The name of the user, without spaces. When you finish the command and press Enter, you will be prompted to enter and re-enter a password for the user. Delete User Description User Level Syntax Option Deletes a user.
User Commands idle-timer The amount of time, in seconds, that the idle timer will run. Use this timer to close a connection because of inactivity. When the idle timer expires, because there has been no exchange of data within the specified time, the Device Server will close the connection. The default value is 0 (zero), meaning that the idle timer will not expire (the connection is open permanently). The maximum value is 4294967 seconds.
User Commands service The type of service that the user will use. sess-timer The amount of time, in seconds, that the session timer will run. Use this timer to forcibly close a user’s session (connection). When the session timer expires, the Device Server will end the connection. The default value is 0 (zero), meaning that the session timer will not expire (the session is open permanently, or until the user logs out). The maximum value is 4294967 seconds.
User Commands idle-timer The amount of time, in seconds, that the idle timer will run. Use this timer to close a connection because of inactivity. When the idle timer expires, because there has been no exchange of data within the specified time, the Device Server will close the connection. The default value is 0 (zero), meaning that the idle timer will not expire (the connection is open permanently). The maximum value is 4294967 seconds.
User Commands sess-timer The amount of time, in seconds, that the session timer will run. Use this timer to forcibly close a user’s session (connection). When the session timer expires, the Device Server will end the connection. The default value is 0 (zero), meaning that the session timer will not expire (the session is open permanently, or until the user logs out). The maximum value is 4294967 seconds.
Line Commands Line Commands Line Commands Set Line Description Configures line parameters. User Level Normal, Admin set line [data-bits 5|6|7|8] [dial none|in|out|both] Syntax [idle-timer <0-4294967>] [line-name ] [modem-name ] [pages 1|2|3|4|5|6|7] [parity none|even|odd|mark|space] [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 ...
Line Commands rev-sess-security Enables/disables login/password authentication, locally or externally, on reverse Telnet connections. The default is Off. sess-time Enter a time, in seconds, for which the session timer will run. Use this timer to forcibly close the session (connection). When the session timer expires the Device Server will end the connection. The default value is 0 seconds so the port will never timeout. The maximum value is 4294967 seconds (about 49 days).
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 Set Line Interface Description Configures line interface (hardware) parameters.
Line Commands Set Line Service Description Sets the service for the line. For services that need further configuration, see Line Service Commands on page 95 to find the Line Service that you want to configure.
Line Commands udp Sets the line to listen for and/or send UDP data. vmodem The Device Server port behaves as if it were a modem to the attached device. Set Termtype Description Sets the terminal type for the current terminal session. term1, term2, and term3 refer to the user-uploadable custom terminal definitions. If these are not present, the default is wyse60.
Line Commands local-echo Toggles between local echo of entered characters and suppressing local echo. Local echo is used for normal processing, while suppressing the echo is convenient for entering text that should not be displayed on the screen, such as passwords. This parameter can only be used when Line Mode is On. Default is Off. echo Defines the echo character. When Line Mode is On, typing the echo character echoes the text locally and sends only completed lines to the host.
Line Commands The last host IP address in the range of IP addresses (for IPV4, not required for IPV6) that the Device Server will listen for messages from and/or send messages to. Set Vmodem Description Configures the vmodem settings for the serial line.
Line Commands Show Vmodem Description Show the vmodem settings for the line. User Level Normal, Admin show vmodem Syntax Modem Commands Add Modem Description User Level Syntax Options Adds a modem. Admin add modem The name of the modem. Do not use spaces. The initialisation string of the modem; see your modem’s documentation. Delete Modem Description User Level Syntax Option Deletes a modem.
Network Commands 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 add community | Syntax none|readonly|readwrite Options A name that will be sent to the Device Server from an SNMP manager. This name will define the permissions of the manager.
Network Commands Delete Trap Description User Level Syntax Option Deletes an SNMP trap. Admin delete trap When you add an SNMP trap, it gets assigned to a number. To delete the SNMP trap, you need to specify the number of the trap that you want to delete. To see which trap is assigned to what number, type the show snmp command. Set SNMP Description Configures SNMP settings.
Network Commands Hosts Commands Add Host Description User Level Syntax Options Adds a host to the Device Server host table. Admin add host The name of the host. The host IP address. Delete Host Description User Level Syntax Option Deletes a host from the Device Server host table. Admin delete host You can see a list of hosts that can be deleted by typing delete host ?.
Network Commands Gateway Commands Add Gateway Description Adds a gateway. You can configure up to twenty gateways. User Level Admin add gateway default Syntax add gateway host add gateway network | [|] Options 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 set gateway default Syntax set gateway host set gateway network | [|] Options You can view the configured gateways that can be deleted by typing delete gateway ?.
Time Commands Logging Commands Set Syslog Description Configures the system log. User Level Admin set syslog Syntax [level emergency|alert|critical|error|warning|notice|info|debug] [primary-host ] [secondary-host ] Options level Choose the event level that triggers a syslog entry: z Emergency z Alert z Critical z Error z Warning z Notice z Info z Debug When you select a Level, all the levels that appear above it in the list also trigger a syslog entry.
Administration Commands Time/Date Setting Commands Set Date Description Sets the Device Server’s system clock. User Level Admin set date
- Syntax Show Date Description Shows the date, according to the Device Server system clock. User Level Normal, Admin show date Syntax Administration Commands Bootup Commands Reboot Description Reboots the Device Server. You will be prompted to save configuration to FLASH, if there have been unsaved configuration changes.
Administration Commands configuration file The path and file name (do not use a drive letter), relative to the default path of your TFTP server software, of the configuration software for the Device Server that will be loaded when the Device Server is rebooted. host The host name or IP address of the server that contains the configuration or firmware file. If you use a host name, it must exist in the Device Server’s host table or be resolved by DNS.
Administration Commands Netsave Description User Level Syntax Options Transfers a file from the Device Server to a remote host using the TFTP protocol. Admin netsave configuration|crash configuration Specifies that you are going to upload a configuration file from the Device Server to the specified host or IP address. crash Specifies that you are going to upload a crash file from the Device Server to the specified host or IP address.
Statistic Commands Statistic Commands Configuration Statistics Show Netstat Description User Level Syntax Options Shows currently used TCP/UDP sockets/ports. Admin show netstat [all] [listening] [tcp] [udp] [tcpv6] [updv6] all Displays all ports, including server (listening) ports; by default, listening ports are not displayed. listening Displays server (listening) ports; by default, listening ports are not displayed. tcp Displays TCP port statistics. udp Displays UDP port statistics.
Statistic Commands Show Serial Description Shows statistics on the serial port. User Level Admin show serial Syntax Uptime Description Displays the elapsed time (in days, hours, minutes, and seconds) since the last reboot/power cycle.
Statistic Commands 110 IOLAN Device Server User’s Guide, Version 1.
A Troubleshooting Appendix A Introduction This chapter provides information that can help resolve problems with the Device Server. Hardware Problems If the Device Server Power/Ready LED is red and stays red for over 10 seconds, you have a hardware problem that is going to require factory service. If you purchased the Device Server less than 30 days before this problem appears, contact your distributor; otherwise, see the Perle web site (www.Perle.com) for factory service information.
Host Problems Host Problems Cannot access a host on a local network, verify: z The network address is correct. z The subnet mask is set correctly and reflects the network configuration. z The broadcast address is set correctly and reflects the network configuration. Cannot access a host on a remote network: z Use the show route command to verify that there is a route to the remote host. If no gateway is specified, verify that a default gateway is specified.
Unknown IP Address When using the function keys on your keyboard, nothing happens or your sessions keep swapping. z Change your Hotkey Prefix character. The function keys on the keyboards of some terminals (like WYSE60) send character sequences which begin with ^a; unfortunately, ^a is also the default Hotkey Prefix, which you use to switch between sessions. A valid alternative would be ^b (hex=02). If you are the system administrator, you can change any user’s Hotkey Prefix character.
Language Problems Language Problems In a customised language, the text strings appear in the wrong place in the Menu, CLI, or WebManager. z Check the original ASCII text file you used to translate to your customised language. The sequence of the line much match exactly (be aware that comments don’t affect line sequence, but can affect the actual line that the strings appear on).
B 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: z Trueport mode—This mode allows complete device control and operates exactly like a directly connected serial port. It provides a complete COM port interface between the attached serial device and the network.
Trueport For more information, see the Trueport User Guide or the Trueport Installation and Configuration Guide for Windows NT on the CD-ROM. 116 IOLAN Device Server User’s Guide, Version 1.
Glossary This chapter provides definitions for Device Server terms. BOOTP (BOOTstrap Protocol) An Internet protocol that enables a diskless workstation to discover its own IP address, the IP address of a BOOTP server on the network, and a file to be loaded into memory to boot the machine. This enables the workstation to boot without requiring a hard or floppy disk drive. Community (SNMP) An SNMP community is the group that devices and management stations running SNMP belong to.
IOLAN Device Server User’s Guide, Version 1.
Index A D admin default password 23 level 39 lost password 45 ARP-Ping, setting an IP address 25 definitions 117 Device Servers, configuring multiple DeviceManager overview 29 setting an IP address 23 DHCP parameters 45 setting an IP address 24 direct connect setting an IP address 24 direct connections 37 B bidir general 38 parameters 59 binary configuration file 49 BOOTP parameters 45 setting an IP address 24 bootup files, configuring 69 browsers, supported 18 70 E easy port access menu 40 ethernet
Index L L language translating 42 upgrading firmware 42 LED guide 25 levels, user 39 line access parameters 63 line parameters 54 line termination, setting jumper M Menu conventions 31 using 30 menu level 39 MIB 31 mode console 33 serial 33 modem parameters 61 MOTD parameters 69 N normal level 39 O online help, using 14 P parameters bidir 59 BOOTP/DHCP 45 bootup files 69 gateways 67 hardware 53 hosts 65 line 54 line access 63 modems 61 MOTD 69 raw 57 server 51 sessions 64 SNMP 66 syslog 68 telnet 58 TF
U Index U UDP configuring 38 parameters 59 user levels 39 user parameters 61 user sessions 40 utility Trueport 115 V virtual modem 38 vmodem overview 38 parameters 60 W WebManager overview 30 using 30 IOLAN Device Server User’s Guide, Version 1.
Index W 122 IOLAN Device Server User’s Guide, Version 1.