IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Part number: 5500054-19 Date: 29 April 2004 Navigating around this manual Using this on-line manual. See page 5. Fast Contents. See page 7. Contents. See page 8. The menu interface. See page 125. Index. See page 224.
Copyright statement This document must not be reproduced in any way whatsoever, either printed or electronically, without the consent of: Perle Systems Europe Limited, 3, Wintersells Road, Byfleet, Surrey KT14 7LF, UK Perle reserves the right to make changes without further notice, to any products to improve reliability, function or design. Specialix, the Specialix logo, IOLAN+, IOLAN+ Rack, IOLAN+ 102/104, JETSTREAM, JETSTREAM4000, JETSTREAM8500 and LANSTREAM2000 are trademarks of Perle Systems Limited.
FCC Note The products described in this manual have been found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions in this Guide, may cause harmful interference to radio communications.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide About this manual Purpose of this manual This manual tells you how to install, configure and use the Perle IOLAN+ communications servers. Who this manual is for This manual is aimed at users who want to connect serial devices directly to LANs and WANs. This manual requires a working knowledge of using personal computers and associated operating systems, as well as experience in installing host cards and peripherals.
Using this on-line manual The following is a brief guide to using this manual on-line.
Revision history Date Part number Description July 2001 5500054-10 Initial re-branded release of manual. October 2001 5500054-11 Minor update for Vmodem. April 2002 5500054-12 Update for 10/100 Ethernet support. June 2002 5500054-13 Updated RS422 pinout information. August 2002 5500054-14 Removed reset switch in manual content and changed reset procedures. September 2002 5500054-15 Minor changes to software and diagnostics sections from “T” release software.
Fast Contents ABOUT THIS MANUAL ...........................................................................................................4 REVISION HISTORY ..............................................................................................................6 FAST CONTENTS .................................................................................................................7 CONTENTS ........................................................................................................
Contents ABOUT THIS MANUAL ............................................................ 4 Purpose of this manual ..................................................................................4 Who this manual is for ...................................................................................4 Using this on-line manual ..............................................................................5 Document navigation ................................................................................
CHAPTER 1 INTRODUCTION 26 About the IOLAN+ ...........................................................................................27 IOLAN+ Features .............................................................................................29 Hardware ..................................................................................................29 Software ....................................................................................................30 Security ..............................
CHAPTER 2 INSTALLATION 36 Connecting to your Network .........................................................................37 10BASE-T (twisted pair) ...........................................................................37 10BASE2 (Thin Ethernet) .........................................................................37 AUI port.....................................................................................................37 10/100BASE-T ......................................................
CHAPTER 3 TERMINALS ON MUTLI-USER SYSTEMS 54 Introduction ......................................................................................................55 Terminal Port Configuration .........................................................................56 Host Table Setup .............................................................................................58 Making a Connection .....................................................................................59 Tips .................
CHAPTER 4 SETTING UP DIAL-IN MODEM PORTS 62 Introduction ......................................................................................................63 Dial-in Port ........................................................................................................64 The host ............................................................................................................66 The modem ..................................................................................................
CHAPTER 5 MODEM AUTHENTICATION AND LOGGING 70 Introduction ......................................................................................................71 User authentication/logging ..........................................................................72 The host ............................................................................................................75 Basic authentication..................................................................................
CHAPTER 6 DIALOUT MODEM PORTS SETUP 79 Introduction ......................................................................................................80 Configuration ...................................................................................................81 The host ............................................................................................................82 For dial-out connections on Unix ..............................................................
CHAPTER 7 VMODEM (VIRTUAL MODEM) 89 About Vmodem (Virtual modem) .................................................................90 Configuring ports to use Vmodem ..............................................................91 Configuring ports to use Vmodem in Normal Mode ..................................91 Making a Call using Vmodem in Normal Mode ............................................. 93 Disconnecting a Call in Vmodem Normal Mode ............................................
CHAPTER 8 PRINTING 98 Introduction ......................................................................................................99 Using ioland .....................................................................................................100 Configuration.............................................................................................101 The Host ...................................................................................................102 Using LPD ...................
CHAPTER 9 OTHER DEVICES SETUP 114 Introduction ......................................................................................................115 Reverse Telnet Port Configuration ..............................................................116 The Host ...................................................................................................117 Perle IOLAND Utility .......................................................................................118 Mandatory arguments ............
CHAPTER 10 THE MENU INTERFACE 125 Introduction to menu commands ................................................................126 Toggle fields ..............................................................................................126 Fast keys...................................................................................................127 Connections menu .........................................................................................128 Port setup menu ...........................
APPENDIX A COMMAND LINE INTERFACE 160 Introduction ......................................................................................................161 Using the CLI ...................................................................................................162 System administration ...................................................................................163 Basic configuration ........................................................................................
show ports ..................................................................................................... 171 show lines ...................................................................................................... 171 show statistics ............................................................................................... 171 su ..............................................................................................................171 telnet ....................................
APPENDIX B RS-422 IOLAN+ 173 Introduction ......................................................................................................174 Hardware Changes .........................................................................................174 Connectors and Indicators ........................................................................174 RS-422 Serial Port Connections ...............................................................175 Software changes ..................................
APPENDIX C 48V DC IOLAN+ RACK 178 Introduction ......................................................................................................179 Installing the IOLAN+ Rack 48V DC ............................................................180 Installation.................................................................................................180 Electrical Supply Details ...........................................................................180 Safety Earth ............................
APPENDIX D TROUBLESHOOTING 185 Introduction ......................................................................................................186 Terminals/PC Problems .................................................................................187 Printer Problems .............................................................................................189 Modem problems ............................................................................................
APPENDIX E CABLING 204 Introduction ......................................................................................................205 Serial port connectors on the IOLAN+ unit ................................................206 Serial port connector guide .......................................................................206 RS232 DB25 female DTE .........................................................................206 RS232 RJ45 DTE socket ..................................................
APPENDIX F CONTACTING PERLE 217 Making a technical support query ...............................................................218 Who to contact ..........................................................................................218 Information needed when making a query................................................219 Making a support query via the Perle web page .......................................220 Repair procedure ........................................................................
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 1 Introduction You need to read this chapter if you want to... You need to read this chapter if you want an overview of the IOLAN+ product. This chapter provides introductory information about the Perle IOLAN+, its associated components, software and configuration utilities.
About the IOLAN+ The IOLAN+ is a unique Ethernet TCP/IP communications / terminal server allowing serial devices to be connected directly to LANs and WANs.
This configuration diagram shows many of the features available on the IOLAN+ communications server: ET N 1 43 2 IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide About the IOLAN+ Chapter 1 Introduction Page 28
IOLAN+ Features IOLAN+ is a TCP/IP communications server with 2, 4, 8 or 16, RS-232 or RS-422 ports for making serial network connections. It attaches to your TCP/IP network and allows serial devices such as modems, terminals and printers to access the network. Hardware The IOLAN+ hardware features include: • 2, 4, 8 or 16 serial lines, fully configurable with port speeds up to 115.2 kbps. • RJ45 connectors on IOLAN+ and IOLAN+ 102/104 or DB25 connectors on IOLAN+.
Software The IOLAN+ software features include: • Support for TCP/IP and UDP protocols including telnet and rlogin. • Remote access support including PPP, SLIP and CSLIP. • Printer support via lpd, rcp, and Perle utilities. • Modem support via PPP and Perle utilities. • Perle utilities provide ‘fixed tty’ support for Unix systems. • A window oriented menu interface with pop-up menus and on screen help (command line also available). • ARP or BOOTP for network based setup.
Security The IOLAN+ security features include: • Supervisory and port password. • Port locking. • Authentication with PAP support. • Per user access level assignment. • Service logging. • Logging facility for audit and billing. • Modem auto reset.
Hardware Overview The following table and diagrams describe the units: Model Type No.
Hardware description for IOLAN+ Rack POWER 10 BASE T 100 BASE T ACTIVITY Main power switch Port activity indicator I O Serial ports Power input socket 10/100 BASE T socket IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Hardware description for IOLAN+ Rack Chapter 1 Introduction Page 33
Hardware description for IOLAN+ 102/104 Network indicator Port activity indicators Power indicator Serial ports Power input socket 10/100 BASE-T socket IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Hardware description for IOLAN+ 102/104 Chapter 1 Introduction Page 34
RS-232/RS-422 Functionally, the difference between RS-232 and RS-422 versions is the absence of support for hardware flow control lines (RTS and CTS) and modem control lines (DSR, DTR and DCD) in the RS-422 version. The performance and support for 115.2k baud are unaffected by the different serial ports. RS-422 uses differential signalling and is capable of handling longer distance due to superior noise immunity when installed with suitable cabling. Software description The IOLAN+ comes with the Perle CD.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 2 Installation You need to read this chapter if you want to... You need to read this chapter if you want information about installing your IOLAN+ product. This chapter provides information about installing the Perle IOLAN+ including connecting to your network, configuring communications as well as information on the menu system and general tips.
Connecting to your Network First connect IOLAN+ to a network then begin configuring the unit for your application. Additional information on configuring modems and printers follows.
Switching on IOLAN+ The IOLAN+ power supply accepts input voltages in the range 110 to 240V AC, allowing it to be used world-wide. The IOLAN+ 102/104 has an external power supply unit. After you connect your LAN interface, you can power up the unit. The green power indicator at the side (or front for rack and 102/104 units) should be lit. If the unit fails to power up with the green power indicator lit, disconnect the unit and contact your dealer for help.
Communicating via ARP IOLAN+ supports the ‘Address Resolution Protocol’ (ARP). It allows you to temporarily connect to your IOLAN+ to assign a permanent IP address. If you prefer to use a terminal or PC attached to IOLAN+, skip to the next section. To do this proceed as follows; 1. From a local Unix host, type the following: arp -s a.b.c.d aa:bb:cc:dd:ee:ff (where a.b.c.d is the IP address you want for IOLAN+, and aa:bb:cc:dd:ee:ff is the Ethernet address of IOLAN+, found on the bottom of the unit itself).
Communicating via a Terminal or PC You can connect to IOLAN+ using a terminal or PC (with a terminal emulation package such as Hyperterm). 1. Connect a terminal or your PC to port 1. The IOLAN+ serial ports are DTE type RS-232 ports. When connecting a terminal/ PC directly (without modems), the RS-232 signals need to be crossed over (‘null modem’ cable). See Appendix E Cabling for pinout information. 2. For a terminal/PC to communicate with a server, set it to the following: 9.
The Menu System You should now be at the Command Line Interface (CLI) of the IOLAN+ as designated by the local> prompt. If you would like to continue in CLI mode refer to Appendix A Command Line Interface, but we recommend the menu system. 1. Set the terminal emulation type and begin using the menus. The following are the terminal options: ansi, dumb, vt100, wyse50, wyse60, tvi925, ibm3151, vt320, falco50, hp700 2. The default setting is ‘dumb’.
The Connections Menu should now be displayed. This menu displays the current state of the four possible connections. There are no active connections. The firmware version of IOLAN+ is located on the lower left hand portion. The wording ‘REMOTE-ADMIN’ in the upper right signifies you are remotely telneted into IOLAN+ (and will read ‘Terminal: 1’ if you are using a terminal/PC into port 1.) The keys used to move about in the menus depend on the terminal emulation you are using.
Connections Menu Select connection '1’ on the Connections Menu and press the Enter key. The Commands pop-up menu is displayed. There are a number of options available from this menu. Before communication across the network can be established the IOLAN+ must be assigned a network IP address. This is accessed through the Administration Menu. Select the Admin mode field and press the Enter key. Note If you are telneted into IOLAN+, the telnet, rlogin and port options do not appear on the Commands pop-up menu.
Administration Menu The top level Administration Menu appears as follows: 1. Select the Password field and press the Enter key. Use the factory default password here: this is iolan (no caps). Note: This password level will time-out in four minutes if there is no activity. This is for security reasons and will take you back to Administration Menu (view level). The Administration Menu is redisplayed, it now has some extra fields (access, change, kill, reboot, trap).
2. Select the server entry and press the Enter key. This takes you into the Server Configuration Menu.
Server Configuration Menu There are a number of fields in the Server Configuration menu which are explained in Chapter 10 The menu interface. At this point proceed as follows; 1. Give the IOLAN+ an IP address and a name. 2. The important fields that you need to fill in are as follows: Name: In the example above the communications server name has been set to IOLAN. It is a good idea for the IOLAN+ name entered here to match the name entered in the host machine’s domain name server.
4. Select the Save & Exit field and press the Enter key. Other options are Quit & Exit, which does not save the changes before exiting this menu, Values, which will display the optional values for this field if available, and Cancel, which will take you back to this screen for more editing. 5. You have now set up the unit with a new IP address. This should be confirmed with the message: IP CHANGED—PLEASE REBOOT 6. Reboot the communications server to activate the new IP address using the reboot command.
Port Setup Menu and Beyond Your communications server is now ready to configure for terminals on multi-user systems or modems, printers and other devices. The next sections deal with each of these. If you’ve got a good feel for the menu system, you should proceed to the section appropriate for your application. If you’d like a full review of the menu system refer to section 9, The Menu Interface later in this guide. For more information about the Command Line mode, consult Appendix A Command Line Interface.
This menu is divided into the following sections: Menu option Description Hardware Defines port type and is used for setting up the hardware configuration of the modem, terminal, printer or PC session. This section is always used. User Defines various user parameters such as name and terminal type. Most fields are used in this section. Flow Control Defines the various flow control options used by IOLAN+. This section is always used. IP Addresses Deals with remote access via PPP/SLIP sessions.
Tips Copy Command IOLAN+ has a copy command that allows you to copy the setup of one port to another. You will need to get to the CLI (from the Connection menu) and use the following syntax. Note: To get back to the menu system once in the CLI, type set menu at the command line. local> su password> ADMIN:local> copy 1 2 3 4 5 ADMIN:local> set menu The commands above would copy the configuration of port number 1 to ports 2, 3, 4 and 5 (and return you to the menu system).
bf is the name of IOLAN+ firmware (optional) ip is the IP address you want to use Note This BOOTP implementation is a subset and not a full implementation of the RFC. Note The most common error is bad information in the /etc/bootptab file (recheck it). See Appendix D Troubleshooting for more information. You can now move back to The Menu System in this chapter.
Saving and downloading configurations It is possible to save the configuration of your IOLAN+. This is convenient for loading multiple communications servers with the same setup. It is also advisable as a backup method. If the boot file name has the extension “.cfg” (eg iolan.cfg), it will be loaded as a configuration file rather than a boot file. This allows the administrator to configure one IOLAN+, save its configuration and automatically configure subsequent units via bootp.
IOLAN+ will now automatically download this configuration on reboot. Remember that whenever you change a setting on the unit, it will be overwritten the next time the unit is rebooted unless the new configuration is saved. Domain Name Server (DNS) IOLAN+ can be configured to take advantage of your network’s Domain Name Server (DNS). This is done from the server in the Administration Menu by keying in the IP address of your DNS in the Name server field. Fill in the Domain name field as well.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 3 Terminals on mutli-user systems You need to read this chapter if you want to... You need to read this chapter if you want information on setting up a terminal for use with your IOLAN+ product. This chapter provides information on how to setup a terminal, and other tips such as the concept of ‘fixed ttys’, multiscreens, the copy command, TERM features, etc.
Introduction IOLAN+ is used extensively for connecting terminals, printers and modems on multi-user Unix systems, especially in retail applications. These Unix systems include SCO Unix, IBM AIX, HP-UX, Data General’s DG/UX, etc. This chapter deals with terminals and/or PCs using emulation packages (such as Hyperterm). In many applications, the users need to be ‘direct connected’ to a specific Unix host so that they see the login prompt automatically.
Terminal Port Configuration This is the setup for making a terminal connect to a designated Unix host login prompt automatically. The following fields are important: Menu option Description Access Set this field to Local. This tells the terminal server port to listen for data on the RS-232 side. Mode With this field set to telnet, the port will operate in telnet mode (or raw for rlogin). Most systems will use telnet.
Menu option Description Remote Port This corresponds to Telnet service on the remote host and must be set to the standard 23 (or 513 for rlogin). Monitor DSR You can set this field to Yes if you wire the terminal’s DTR signal pin 20 (DB25) to the IOLAN+'s DSR signal pin 3 on the RJ45 connector ( see Appendix E Cabling for DB25 pin assignments). When you turn the terminal off, it will reset the IOLAN+ port, which tells the Unix host to kill the user’s processes.
Host Table Setup In order for IOLAN+ to connect easily to machines on the network it must know the IP addresses of the other computers. IOLAN+ can have its own internal table of IP addresses set up in the host table. This is a ‘local’ naming system only. IOLAN+ can also use the name server utility of your Unix system (consult your Unix system manual and Tips on page 61). The Host Address Menu is accessed from the Administration Menu by selecting the host entry. The host table can contain up to 10 addresses.
Making a Connection If you are using initiated connections, you will not see the IOLAN+ menus. Instead, you see the login prompt of the host you assigned in the host field of the Port Setup Menu. However, if your connection field is set to None, the Connections Menu appears. You are now ready to make connections. From the Connections Menu press the Enter key on a *** FREE *** session to display the Commands menu. Select the Telnet field and press the Enter key.
name of the host is now displayed where *** FREE *** was). Press the Enter key to bring up the Connection pop-up menu, then select the Resume Connection option. Note If the ^] did not work, you might have a conflict with that character sequence and should check the Keys section of this port. When logging out of your session the connection is automatically closed.
Tips Connecting via ‘fixed ttys’ IOLAN+ has the ability to create a ‘fixed tty’ under Unix. This is helpful for older or secure Unix applications that require a fixed location for each terminal. Consult Chapter 9 Other devices setup. Multisessions on terminals/PCs IOLAN+ is capable of supporting multiple sessions. This allows the user to connect to all four *** FREE *** sessions with different hosts and move between them using the ^] hot key.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 4 Setting up dial-in modem ports You need to read this chapter if you want to... You need to read this chapter if you want information on creating dial-in connections with your IOLAN+ product. This chapter provides information on the configuration necessary to create dial-in connections. It includes the most simple connection such as a dial-in Unix connection, The setting up PPP ports which is how Windows ® systems dial-in (as well as Unix).
Introduction This chapter will review the configuration necessary to create dial-in connections. It will start with the most simple connection such as a dial-in Unix connection. The chapter then moves into setting up PPP ports which is how Windows ® systems dial-in (as well as Unix). This is very important if you are an Internet Service Provider (ISP) or a corporate site providing remote access or Internet/Intranet access.
Dial-in Port The following is the port configuration for a dial-in connection, including PPP. The following fields are important: Option Description Monitor DCD With this flag set to Yes, IOLAN+ will monitor Data Carrier Detect (DCD) - pin 8 - from the modem. As soon as your modem answers a call and establishes a carrier signal, the modem raises DCD. The terminal server will then establish a telnet/rlogin connection to a specified host.
Option Description Dst: This field contains the IP address the dial-in user will borrow for the PPP session. If you are using a straight forward dial-in connection for Unix, this is not required. Mask If using PPP, SLIP or CSLIP, this is the subnet mask that controls the range of IP addresses accessible from the port and must correspond with your network. (If used for terminals, this is not needed.) Secure This field is set to Yes to force the call-in user to use the Dst IP address.
The host Make sure you have setup a valid user account for authentication on the designated authentication host. See Chapter 5 Modem authentication and logging.
The modem You will need to configure the modem using a configuration string. To do this, go to the Remote Site Devices screen (via the Access section of the Administrative Menu). Select the UNUSED ENTRY that corresponds to the port with the modem attached (that is, third one down is port 3, etc.). You can set the type (for example, name) and the Modem Config to the required configuration string (for example, ate0s0=1&w). All other fields are default.
Client login When the caller connects, you may want to send out a welcome message of some sort. After the user gets this message, you want him/her to enter a login and password then connect to the Host for a shell account. Or, if it is a PPP user, they will simply start sending PPP packets at the login prompt (for example, Windows ® 95/98) and use PAP for authentication.
Tips Domain Name Server (DNS) IOLAN+ can be configured to take advantage of your network’s Domain Name Server (DNS). This is important for ISPs. From the Administration Menu select server and key in the IP address of your DNS in the Name server field. You could fill in the Domain name field as well. WINS Server If you have a local NT server running WINS and you want dial-in clients to take advantage of that, put the IP address of the NT server in the WINS server field of the Server Configuration screen.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 5 Modem authentication and logging You need to read this chapter if you want to... You need to read this chapter if you want information on modem authentication and logging for your IOLAN+ unit. This chapter contains information providing authentication support to validate users connecting to the serial port, and updating a host log file on connection states.
Introduction IOLAN+ provides authentication support to validate users connecting to the serial port, and can update a host log file on connection states. Authentication and logging is achieved by using a designated authentication host to validate users and keep connection information. This unique facility takes the burden away from the unit and more importantly allows the administrator to configure one host, rather than configuring multiple terminal servers.
User authentication/logging To improve access security, IOLAN+ has a mechanism for authenticating users before allowing them access. This is accomplished by prompting the user for a Login ID and a password. IOLAN+ will then attempt to login to a specified host using that ID and password. If successful, the user is authenticated and allowed access. Otherwise, the call is dropped. IOLAN+ will also log events such as logins, logouts, connections and disconnections, and power ups.
Option Description Auth Host The IP Address/Name of the host that IOLAN+ attempts to login to for authenticating users. Authentication Port The TCP service to be used for authenticating users. Normally this is set to 23 for Telnet. Login Prompt The string used by IOLAN+ to know when to send the login ID. Set this field to ogin:. Leave out the first letter as some systems use a ‘L’ and others use a ‘l’ as the first letter.
Option Description Log Port Connect/ Disconnect IOLAN+ will log when someone connects to and disconnects from a port on IOLAN+. Log User Service Start/ Stop IOLAN+ will log a PPP, SLIP or CSLIP service when started on the port.
The host Basic authentication IOLAN+ will need to login to the authentication host with the log user name defined on the Host Authentication And Logging screen. Therefore, you need to create an account to be used by IOLAN+ (avoid csh shell). Make sure the user can log in successfully. Also, make sure the user is not prompted for any input and ends up at a shell prompt. User services authentication This is used to provide services based upon the dial-in user’s name.
Login-Host = 208.24.183.1 Login-Service = Telnet # Everybody else gets PPP with a dynamic address DEFAULT Password Framed-Protocol = PPP Note When using advanced authentication, make sure the Success Indication String in the Host Authentication And Logging menu is set to userdefined.
Logging A log file can be updated on the authentication host to record when an IOLAN+ is powered up, rebooted, and users and ports are connected and disconnected. This information is of particular importance to administrators who need to record users logging in and out. In addition, when the logger is enabled IOLAN+ completes a time stamp every 5 minutes to record that an IOLAN+ is still active. This allows an administrator to gain an accurate record of events.
Tips Windows ® notes Authentication of Windows NT ® requires a telnet daemon. Check the Windows ® section of our the perle website for the latest Windows ® telnetd software. You will need to set up your users on Windows NT ® through this software. Logging on Windows NT ® also requires a utility called log_it.exe. If the Windows NT ® login user id is ‘logger’, enter it into IOLAN+ as Nlogger so that IOLAN+ will know to use the log_it.exe utility.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 6 Dialout modem ports setup You need to read this chapter if you want to... You need to read this chapter if you want information on setting up modem ports for your IOLAN+ product. This chapter provides on setting up modem ports for your IOLAN+ product. Dial-out ports can be just a simple Unix outbound cu call or IOLAN+ can act as a dial-out router to facilitate Internet PPP requests.
Introduction Dial-out ports can be just a simple Unix outbound cu call or IOLAN+ can act as a dial-out router to facilitate Internet PPP requests. As a dial-out router IOLAN+ automatically establishes a PPP/SLIP/CSLIP link to that site. Then drops the call after a preset period of inactivity. This dial-on-demand feature is automatic. IOLAN+ will place the call when local TCP/IP traffic needs to be routed to a configured remote site.
Configuration The Port Setup Menu should be set up as follows for both simple dial-in connections and PPP/SLIP connections. The following fields are important: Field Description Access Set the Access field to Dynamic (dial-in or out) or Remote (dialout only). Monitor DCD With this flag set to Yes, the terminal server will monitor the modem signal Data Carrier Detect (DCD) - pin 8. When the modem hangs up, pin DCD from the modem goes low and the terminal server port will reset.
The host For dial-out connections on Unix If you have not already loaded ioland onto your system, do so now (see Perle CD). For more information on ioland see Chapter 9 Other devices setup. In it’s simplest form, at the superuser prompt you would run the following command in Unix: ioland –h 10006 This will start the ioland process and allow you to specify a device-name in /dev that is linked to a pseudo tty.
Routing For dial-out routing, you must have the proper routing entry on all hosts in your local network that will communicate with the remote site.
Remote Access Systems This screen is used to define a remote system (up to 16 entries per IOLAN+), a phone number, login script, etc. There are a lot of similarities between this screen and the UUCP systems file under Unix.
Field Description Sitename The IP name or IP address of the remote site IOLAN+ will be calling. User name The user name required by the remote system for logging in. You may use the \u in your login script in lieu of the full name. Password The above user name’s password as required by the remote system. You may use the \p in your login script in lieu of the full password. Device type The name of the modem device as defined in the Remote Access Systems Screen.
Dial-out PAP Authentication If a dial-out script is not used but a username and password are defined, IOLAN+ will send a PAP packet after establishing a PPP link and use the username and password defined for the remote site.
Remote site devices This screen is used to define/setup the modem device. There are a lot of similarities between this screen and the UUCP devices file under Unix. It is possible to assign several ports the same device name, and the dialer daemon will automatically use the first available port. It is also possible to have these ports do ‘double-duty’ and serve as regular dial-in ports for dumb terminal access, SLIP or PPP in addition to the dial-out capability.
Field Description Dial Timeout Number of seconds to wait for the modem to establish link and respond. Dial Retries Number of times to attempt a connection to the remote site before giving up. Tips Hunt groups You can setup several modems and use the same name for each group under Remote Site Devices. IOLAN+ will use the first available modem defined in Remote Site Devices, which if busy will default to the next available.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 7 Vmodem (Virtual modem) You need to read this chapter if you want to... You need to read this chapter if you want an overview of the IOLAN+ products Virtual modem feature. This chapter provides information about the Vmodem feature of the IOLAN, which provides “modem like” communication between two IOLAN units on a network. This feature behaves like two modems connected across a telephone line.
About Vmodem (Virtual modem) Vmodem is a feature of the IOLAN, which provides “modem like” communication between two IOLAN units on a network. 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. Vmodem allows you to achieve this using a single IOLAN unit at each end of the network without having to use multiple modems.
Configuring ports to use Vmodem The Vmodem feature has two modes, Normal and Dial on DTR. • In normal mode, the Vmodem ports behave like a modem using basic AT commands to connect and disconnect. • In Dial on DTR mode, the unit will automatically connect to a pre-configured destination. Configuring ports to use Vmodem in Normal Mode Carry out the following on all the participating IOLAN units; 1. Login to your IOLAN unit using either serial link or telnet as required. 2.
13.Press the Escape key to go back to the CONNECTIONS MENU. 14.In the CONNECTIONS MENU; a. Select a FREE connection and press the Enter key. b. Select Commands > CLI. 15.Connect the devices required to the Vmodem port on the IOLAN using the appropriate cable. 16.Repeat this procedure for all ports you want to configure to use Vmodem.
Making a Call using Vmodem in Normal Mode Using Vmodem, telephone numbers are replaced by the IP address and TCP port of the Vmodem port you are calling. 1. To place a call using the device attached to a Vmodem port, the ATD sequence would be: ATD Where: IP address is the IP address of the IOLAN unit that you are calling. where each number is represented by three digits (padded using zeros where necessary) with no separating dots.
Configuring Vmodem to use Dial on DTR mode You use Dial on DTR mode because you want your device to dial a preconfigured number automatically when DTR is raised by the device. To configure your port, proceed as follows; 1. Login to your IOLAN unit using either serial link or telnet. 2. Within the CONNECTIONS MENU now displayed, select a FREE connection and press the Enter key. 3. Select Commands > Admin mode and press the Enter key. 4. Select ADMINISTRATION MENU > Password and press the Enter key. 5.
c. Press the Escape key to go back to the CONNECTIONS MENU. 18.In the CONNECTIONS MENU; a. Select a FREE connection and press the Enter key. b. Select Commands > CLI. 19.Connect the devices required to the Vmodem port on the IOLAN using the appropriate cable. 20.Repeat this procedure for all ports you want to configure to use Vmodem.
Setting/Modifying up Vmodem responses The default responses for failure/success of a connection, may be customized. To configure the Vmodem responses, proceed as follows; 1. Login to your IOLAN unit using either serial link or telnet as required. 2. Within the CONNECTIONS MENU now displayed press the Enter key and select;. Commands > Admin mode and press the Enter key. ADMINISTRATION MENU > Password and press the Enter key. 3. When prompted, enter the password and press the Enter key.
Vmodem AT Commands Ports configured for Vmodem operation interpret the following AT command codes. Code Description +++ATH Disconnect and hang-up a connection. ATQ0 Enable connection responses for the duration of the session. ATQ1 Suppress connection responses for the duration of the session. ATV0 Selects numeric results codes for the duration of the session. ATV1 Selects verbose results codes for the duration of the session. All other AT sequences are accepted, but ignored by the Vmodem port.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 8 Printing You need to read this chapter if you want to... You need to read this chapter if you want information on printing from your IOLAN+ product. This chapter provides information about the three methods of printing from your IOLAN+: ioland, LPD, or RCP. ioland is the recommended method, however this will depend on your application and operating system.
Introduction There are three methods of printing from your IOLAN+: ioland, LPD, or RCP. ioland is the recommended method, however this will depend on your application and operating system. Method Description ioland ioland provides a pseudo TTY interface to Unix print spoolers (not available for Windows ® ). This software and the binaries associated with it are available from the Perle CD provided with the unit or from the Perle website.
Using ioland We suggest you use the Perle ioland utility on the CD provided. The ioland utility can be used for Unix printing only. Ioland is a Unix tty port redirector. For non-UNIX applications use LPD, see Using LPD on page 103.
Configuration The following fields are important: Field Description Flow ctrl Set your IOLAN+ port flow control to Hardware. Then set your printer to use ‘DTR Pacing’ or ‘Hardware’ or ‘Ready/Busy’ flow control. Use the RS-232 printer cable pinout shown in Appendix E Cabling. Access Set this field to Remote. This sets the port of the terminal server to listen for connections coming from the network. There will be an INETD process running on the terminal server that does the listening.
The Host If you are already familiar with ioland, all you have to do for the above configuration is: ioland -T 10006 This will start ioland process and create a device in /dev. If you are not familiar with the ioland program, Chapter 9 Other devices setup. Hint Hunt groups are supported on IOLAN+ for printing. To use this, use the same number in the Port Setup local port field (for example, 1006).
Using LPD IOLAN+ can be setup for receiving print jobs via LPD and this is a very simple method. It works for both Windows ® and Unix systems.
Field Description Flow control Set your IOLAN+ port flow control to Hardware. Then set your printer to use ‘DTR Pacing’ or ‘Hardware’ or ‘Ready/ Busy’ flow control. Use the RS-232 printer cable pinout shown in the Cabling Guide (Appendix C), as this will save a print job if the printer is turned off or the cable becomes detached. Name The LPD client, as a reference to the printer, will use what you assign here. This is the printer queue name on IOLAN+. Access Set this field to Remote.
Accessing the Printer The client is the machine that contains the file to be printed and may be running one of a range of operating systems and applications. The client must support LPD, Unix systems normally include a version of LPD and there are a number of TCP/IP applications for DOS/ Windows ® that also support LPD. When printing via LPD the client refers to the printer by IP address (or the name associated with this address from the host table) and printer name or queue name.
LPD printing from DOS/Windows ® At present it is possible to print from Windows ® or DOS although this will normally be accomplished via a separate application program like PC/TCP or Netmanage Chameleon. The new versions of Windows ® type operating systems either have or intended to have TCP/IP built into the operating system. Windows NT ® has a built-in LPD utility, and there are shareware packages on the Internet for Windows ® 95/98 (check our website see Appendix F Contacting Perle).
LPD Printing from BSD Unix and Linux This section should give you some idea of how to set-up printing via LPD on a Unix host. However, this will not be universally true as different versions of Unix have different configuration requirements. You may also wish to consult your Operating System documentation before attempting to add LPD.
This would be sufficient to print a header page and perform form feeds. If a specialised filter program is required for something like a plotter then the script may look something like the following: #!/bin/sh /usr/local/filter ‘$@’ | lpr –PLaser1 LPD Printing from SYS V Unix Here is an example for setting up the System V spooling system (for example, Linux, Solaris, etc.) to print to IOLAN+ LPD daemon.
Using RCP RCP is used as an alternative option (where LPD and ioland are not available). It is a Unix only command set. A script is provided on the Perle CD for RCP. Configuration The following fields are important: Field Description Flow ctrl Set your IOLAN+ port flow control to Both. This will invoke both Hardware (RTS/CTS) and XON/XOFF flow control on IOLAN+. Then set your printer to use XON/XOFF.
Field Description Mode The port of the terminal server will operate in a raw TCP/IP mode. Local port The INETD process running on the terminal server for this port is listening for TCP/IP connections on TCP port 514 (this is the RCP service number). The Host On systems where LPD or a binary for ioland is not available, or is found to be unreliable due to limitations in the OS, RCP provides a useful, if limited, alternative method for printing.
Using RCP with Unix System V line printer spoolers. 1. Log in as root and create a print queue for the printer with /dev/null as the device port. For example, create an HP LaserJet printer queue via the command: /usr/lib/lpadmin -hpjet -v/dev/null -mHPLaserJet Do not accept or enable the printer at this stage. 2. Go into the directory containing the interface scripts for all printers. This is normally found in: /usr/spool/lp/admins/lp/interfaces (Rel 3 Unix). /etc/lp/interfaces (Rel 4 Unix).
RCP printing on a spooler system based on BSD Unix Currently, the RCP printing utility will not work if the of filter is used in conjunction with any other filter. 1. Log in as root and create a print queue for the printer with /dev/null as the device port. For example, create a printer queue by placing this record in /etc/printcap: rcp Printer to IOLAN port 8 IOLAN8|IOLAN rcp Printer:\ :lp=/dev/null:\ :sf:\ :sd=/usr/spool/LPD/IOLAN8:\ :lf=/usr/spool/LPD/IOLAN8/log:\ :if=/etc/perle/hpif: 2.
Setting up RCP printing on AIX See the Perle website for latest information Appendix F Contacting Perle. Tips Hunt groups: There is no hunt group method using RCP.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 9 Other devices setup You need to read this chapter if you want to... You need to read this chapter if you want information on setting up printers and data acquisition type equipment. This chapter provides information on setting up printers and data acquisition type equipment, including retail point-of-sale equipment.
Introduction IOLAN+ is a very versatile product and can handle a lot of creative applications. This section deals with setting up printers and data acquisition type equipment, including retail point-ofsale equipment. Many types of RS-232 equipment can be attached including: • Retail point-of-sale (POS) equipment • Maintenance ports on network equipment (for monitoring) • Making terminals with ‘fixed ttys’ • Manufacturing equipment IOLAN+ accomplishes this by using a reverse telnet connection.
Reverse Telnet Port Configuration This setup is used when you need to access a serial port from the network. For example you might want to collect data from a serial device such as a barcode scanner, POS terminal, etc. Or you can tie a login to a specific Unix tty device (using ioland). For Unix you use the Perle utility ioland. For Windows ® system consult the Perle website. The following fields are important: Fields Description Keys Set all your Keys to ^@. Access Set this field to Remote.
The Host If you are already familiar with ioland, all you have to do for the above configuration on Unix is: ioland -p 10006 This will start the ioland process in permanent mode and create a device in /dev. If you are not familiar with the ioland program, read the following section. If you are using Windows ® check the web page for the latest information on dial-out connectivity.
Perle IOLAND Utility IOLAN+ peripheral daemon provides a client process with a full-duplex and transparent interface to a server port of its choice, via a pseudo-tty device. This presents a tty-like interface to the application in much the same way as a serial port. The daemon is primarily intended as an interface between the client process and a printer, modem or some data acquisition device.
Mandatory arguments There are three mandatory arguments the daemon requires to mediate between the client and server port: Argument Description Server The host name of IOLAN+ that has the attached printer or terminal. Port The TCP port on which the IOLAN+ port is listening for connection requests. Link A mnemonic filename in /dev which shall be linked to the slave pseudo-tty selected by the daemon.
Optional arguments The other optional arguments modify the behaviour of the daemon in the way it controls connections, and processes data to and from the peripheral. They are defined as follows: Argument Description -T Enable Telnet protocol processing. This is useful to ensure that the last data block of a print job has reached IOLAN+ before closing the TCP connection.
Argument Description -o Used with the -p option. This option prevents the slave pseudo-tty from closing so as to prevent any flushing of data that may occur. With this option set, the daemon will not close the TCP connection so its use is not advised for modems, as line hang-ups may not be initiated. It is useful for slow printers that may lose data on pseudo-tty close. -f Specify a different configuration file. If the pathname is relative, the current working directory will be used.
Argument Description -s Used to transmit breaks to modems. If the daemon reads in the specified string from the client it will send a Telnet ‘Do Break’ command to IOLAN+. The maximum length of the string is 15 characters though, for the sake of efficiency, a minimal length should be used so long as the string is not accidentally duplicated by the real data. This option requires you to also use the -T option. -c Network connection timeout option.
Example daemon configuration file An example of a daemon configuration file is: -x3 -T IOLAN1 10011 IOLAN1.11 -x35 -T -a -h -s xxx -c60 IOLAN1 10013 IOLAN1.13 -x39 -p -T -h -a -k60 IOLAN2 10009 IOLAN2.9 Each line represents a daemon to be started with the arguments on that line. The first is a simple printer configuration, the second is a complex modem configuration while the third is a configuration more suited to a daemon with a terminal attached and a getty running as the client process.
Tips Unix Notes On Unix variants based on System V Release 3, clients that are interactive shell processes may not be able to handle the interrupt, quit and break keys properly. This is a deficiency in the pseudo-tty drivers and not the daemon. On some System V Release 4 variants, if the daemon writes to a non-existent client, the pseudo-tty may irretrievably hang up. In general, make sure there is always a client process running if there is the possibility of data being received for it.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Chapter 10 The menu interface You need to read this chapter if you want to... You need to read this chapter if you want an overview of the IOLAN+ menu interface. This chapter describes the menu system and the fields within them. All of the menus are covered and referenced in this section.
Introduction to menu commands This chapter describes the menu system and the fields within them.You move around the menus with the arrow keys or by using the first letter of the associated command. When you are in an editable menu, the arrow key is used to move around the various fields. Pressing the Enter key will usually bring up the following exit menu.
Fast keys A fast key allows the user to jump from one menu to another avoiding the normal path. Most of the commonly used options available from the Connections Menu can be accessed via fast keys.
Connections menu This is the top level menu, normally the first thing a user sees when they power up their terminal. The main focus of this screen is the list of connection states, showing which host each of the four sessions is connected to (or if it is FREE). Figure 31: Connections Menu - Commands pop-up menu. Pressing Enter at any of the four FREE fields presents the Commands pop-up menu.
Option Description Telnet This option allows you to make a connection to a specified host on the network using telnet. When this command is selected, another pop-up menu appears, giving you the host table list. In addition, there is a specify host/IP address option you can use for other IP addresses and host names. Rlogin This performs the same function as the Telnet open command, but uses the Rlogin protocol.
Port setup menu This menu allows the user to set up all of the parameters associated with a port. The administrator can alter the set-up of any port on the IOLAN+ while a user can only alter the set-up for their own port. This menu is divided into several separate sections, each of which can be accessed independently by the administrator. To simplify the sequence, these are described separately.
Hardware The hardware section defines port type and is used for setting up the hardware configuration of the modem, terminal, printer or PC session. This section is always used. The parameters are as follows: Option Description Speed This field sets the baud rate of the port and can be set to the following values: 50, 75, 110, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, 57600, 115200. The default setting is 9600.
User The User section defines various user parameters such as name and terminal type. Most fields are used in this section. A full description is given below: Option Description Name This field defines the user name of this port on IOLAN+. Any string of up to 14 characters can be entered. This name is displayed on the top left hand corner of the menu screens. It is also listed in the statistics screens so that the administrator can see who is using each port.
Flow control This section defines the various flow control options used by IOLAN+. This section is always used. The parameters are: Option Description Flow Ctrl This field defines which method of flow control to be used by this port, either XON/XOFF, HARDWARE, BOTH, none or WANG. To use HARDWARE flow control the correct cable must be used (see Appendix E Cabling. WANG is a special option designed for WANG terminal flow control applications. The default is to use XON/XOFF.
IP address This section of the menu deals with remote access and modem sessions only. The parameters are as follows: Option Description Src This is the source IP address of the port for PPP/SLIP connections. If blank, the IOLAN+ IP address is used. Dst This is the destination IP address of the PPP/SLIP connections. If blank, the remote host must supply the IP address. If filled in, you designate an assigned IP address to loan the remote host.
Options This section of the menu deals mainly with the telnet options and is the least used. Most of these options default to No. Option Description Keepalive This option specifies whether IOLAN+ should send keepalive messages to the host machines it is connected to. Default is No. Rlogin/Telnet This field specifies which of the two options should be listed first in the Commands menu. Default is telnet.
Keys This section defines the various accelerator keys that IOLAN+ responds to. This section is optionally used. The parameters are as follows: Option Description Hot This is the key used to escape from a host connection back to the IOLAN+ Connection Menu. For instance, if you are in a login shell on a host machine, pressing the hot-key takes you back to IOLAN+. The default is ^]. Intr This is a user-definable interrupt key.
Access This section controls the type of the connection made from this port. This is the most important section in defining a port. The parameters are as follows: Option Description Access This field defines the type of service that is operating on this port. Default is Local. Local This is the normal setting for terminals/PCs. Remote This setting indIOLAN+ should be listening on the ethernet for connections from a remote host.
Option Description Vmodem This setting causes the IOLAN port to behave as if it were a modem to the attached device. See the Chapter 7 Vmodem (Virtual modem) for details. Authentication This field defines how a user logs in. Default is none. None This sets authentication off. Local This forces the incoming user to enter the IOLAN+ login authentication password (same password for all ports).
Administration menu The Administration Menu allows the user access to the main configuration functions. All of the options can be accessed by a normal user (unless the secure field is set to Yes). None of the configuration details may be altered unless the user has entered the administrator’s password. The parameters are as follows: Option Description gateway Selecting this field allows the user to view the Gateway Menu used for routing.
Extra statistics screens Once the user has entered administration mode the display changes slightly to indicate this. This allows the user access to some extra features as follows: Option Description access Selecting this option takes the user into the remote access section of IOLAN+ bringing up a menu for designating remote sites, devices and authentication/logging parameters. change Selecting this field takes the user into the Password pop-up menu.
Access menu The Access section deals with remote access sites, devices and the authentication and logging parameters.
Remote access sites This first brings up a pop up menu with 16 possible UNUSED ENTRYs. These will represent the available dial-out sites for IOLAN+. Selecting any of these will bring up the following menu: The parameters are as follows: Parameter Description Sitename This is the IP name or IP address of the remote site IOLAN+ will be calling. User name This is the user name required by the remote system for logging in. You may use the \u in your login script in lieu of the full name.
Parameter Description Phone number This is the phone number of the remote system. The ‘\’ may be used as a delay. For example, a phone system that requires a 9 followed by a four-second delay before getting an outside line would require an entry like 9\4-2145551234. Login-script This is the chat script that will be used to login to the remote system. It takes the form of the usual Send/Expect chat script you may already be familiar with.
Remote site devices This first brings up a pop-up menu with 16 possible UNUSED ENTRYs each corresponding to a port. The parameters are as follows: Parameter Description Type This is the name of the modem assigned to a specific port. It is referenced from the Remote Access Systems Screen in the Device type field. Scr Addr This is the source IP address of the port for remote access/modem configuration. If blank, the IOLAN+ IP address is used.
Parameter Description Restart timer Amount of time in seconds before IOLAN+ retransmits PPP options. Max Retries Number of option retries before dropping the line. Dial timeout Number of seconds to wait for the modem to establish link and respond. Dial retries Number of times to attempt a connection to the remote site before giving up. Inactivity Number of minutes of inactivity before a PPP/ SLIP connection is broken.
Authentication/Logging This section outlines the authentication and logging parameters of IOLAN+. The parameters are as follows: Parameter Description Auth Host The IP name or address of the authentication host to validate incoming users. Authentication Port The TCP port number of the authentication host, usually 23 (telnet) or 513 (Rlogin). A proprietary network number may be chosen to provide a personal user validation scheme. Default is 23 (telnet).
Parameter Description Maximum Login Attempts The maximum number of login attempts a user is allowed before the line is reset. For modem users the control line DTR is toggled, the port is disabled for 3 seconds. Default is 3. Login Timeout This time defines the maximum time in seconds for the user to enter authentication information, once login time-out is exceeded the line is reset.Default is 0. Disconnect Probe An option to keep the per port authentication connection up during the clients’ session.
Change password options This option allows the administrator to change the admin, login or logger passwords. It is recommended to change the password from the default iolan. The following selections can be called from the Administration Menu, password option: Password option Description Admin Password The user is required to enter the new administrator’s password twice. Login Password The user is required to enter the IOLAN+ login password twice.
Gateway menu The Gateway Menu allows the IOLAN+ to make use of a gateway (I P router) on the network. This allows flexible internet working. The parameters are as follows: Parameter Description Destination This field specifies either the destination network or host address. Gateway This field defines the gateway (IP router) host address. The gateway host must be attached to the same network as IOLAN+.
Host Address menu IOLAN+ uses the information entered on the Host Address Menu to form an internal host table. The user can then use the host name in any of the IOLAN+ functions or menus. The parameters are as follows: Parameter Description Host name This field specifies local name you want to give a particular host on the network. IP Address This field defines the IP address of the host designated above. Kill command The kill command resets the port but keeps the previously defined configuration.
Lines menu This option allows the administrator to configure all of the parameters for any of the ports. The parameters accessible are exactly the same as those in the Port Setup Menu, but from these menus you can configure a set of parameters for all of the ports. Selecting this option brings up the Lines pop-up menu as shown below. Each of the options displayed in the pop-up menu brings up another menu. These are detailed in the following sections.
Access The Access section shows and allows changes to the name, access, authentication and mode fields. These fields are described in Port setup menu on page 130. Flow control The Flow Control section shows and allows changes to the flow control fields as described in Port setup menu on page 130. Hardware The Hardware section shows and allows changes to the hardware control fields as described in Port setup menu on page 130.
Network connections The Network Connections section shows and allows changes to some of the Access fields as described in Port setup menu on page 130. Options The Options section shows and allows changes to the Options fields as described in Port setup menu on page 130.
Terminal The Terminal section shows and allows changes to some of the User fields as described in Port setup menu on page 130. Port menu This section is covered under Port setup menu on page 130 of this chapter. Quit command This command simply quits out of the password level up to the view-only administration level (the ESC key works as well.) Reboot command This option initiates a reboot of the unit and should only be used for changing the IP address or netmask options.
Server configuration menu This menu allows the user to define all of the main IOLAN+ system parameters. The menu as displayed can be divided into four logical sections: identification fields, general admin, downloading and domain naming. Identification fields Field Description Name This field determines the name of IOLAN+ and is displayed in the bottom right hand corner of the menus. IP address This field holds the IP address of IOLAN+.
Field Description Language This field determines the language that IOLAN+m is using such as English, French, German, etc. Identification This field allows the administrator to enter an identification string into the unit and is displayed at the bottom of the IOLAN+ menus. Debug mode This field is for Technical Support use only. General administration Field Description Lock This field determines whether the Lock feature is available to all users.
Field Description Init file This field contains the file name of the IOLAN+ configuration image. If this field is present, the unit reads its configuration from this file whenever it is rebooted. Boot host required. MOTD file This field should be filled in with the pathname of a file on the boot host containing the message of the day text to be displayed on any selected ports. A filename or relative pathname entry assumes the top level directory is /tftpboot. Boot host required.
Statistics screens The statistics screens are used for troubleshooting only. This main screen shows the submenus that can be addressed. For more information on the statistics menu, see Appendix D Troubleshooting).
Trap function This is the SNMP trap setup which allows SNMP trap messages to be sent to up to four hosts. Trap messages are sent at system startup and detection of security violations. Field Description Trap Host This field is the IP address of the trap host. Community Name This is the community (password) of trap host.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Appendix A Command Line Interface You need to read this chapter if you want to... You need to read this chapter if you want an overview the IOLAN+ command Line Interface. This appendix describes the IOLAN+ Command Line Interface including information on using the CLI as well as listing the command syntax.
Introduction This chapter outlines the use of the command line interface as opposed to the menu system. The IOLAN+ supports the use of menus for a number of terminal types. It also supports a command line interface (CLI) for use on other terminal types and Telnet/Rlogin sessions. If possible the menu interface should be used as it is far simpler to use. However, the CLI does offer the same level of functionality.
Using the CLI The IOLAN+ command line consists of a prompt as shown below. local> The IOLAN+ accepts commands in both lower and upper case, and shortened versions of commands can be used as long as they only have an unambiguous meaning. For example 'tel' could be used in place of 'telnet'. The IOLAN+ offers an extensive help facility.
System administration To gain access to all of the configuration functions of the IOLAN+ a user must log in as the administrator. To do this type: local> su Password> The user must enter the administration password. The default password is iolan (lower case), but it is suggested that this be changed to prevent unauthorised access.
Basic configuration To setup your communications via the command use the following instructions: 1. Enter administrative mode, password level: local> su Password> 2. Enter set server. This will lead you to: ADMIN:local> set server Type ‘?’ at prompt to see list of valid options; to abort changes. Name : ronald Debug mode : 0 IP address : 204.17.209.18 Subnet mask : 255.255.255.0 and so on… 3. Enter reboot .
Command descriptions There are a large number of commands available for the IOLAN+, these are detailed below: arp Syntax: arp [flush] Description: This command by itself will show the IOLANs arp table (IP address, Ethernet address, flags). In the admin mode, using arp flush will clear all the entries in the arp table. This is used to clear arp entries when you want to change the Ethernet address of a device. clear Syntax: clear Description: This command clears the screen.
copy Syntax: copy [destination]… Description: This command copies one port setup to another allowing easy setup if the ports are the same configuration. Administrative level is required to change. Note that multiple destination ports can be specified separated by spaces. dial Syntax: dial Description: This command shows the status of the dial-out interface and would be used for monitoring dial-out connections.
help Syntax: help Description: This function provides syntax descriptions and partial descriptions of the available commands. host Syntax: host <[add name address][delete name]> Description: This function allows the administrator to add and remove names from the host table. The name can be anything up to 18 characters long, and the address field is the IP address of that host. There can be a maximum of 10 entries in the host table. Admin level required to change.
reboot Syntax: reboot Description: This function reboots the terminal server. Admin level is required. resume Syntax: resume Description: This allows user to resume an established connection if there are multiple sessions going. rlogin Syntax: rlogin [host] [port] Description: This function allows the user to make an rlogin connection to the specified host machine. If the port number is not specified then it defaults to 513.
set Syntax: set [value], etc. Description: The set command allows the administrator to configure any of the IOLAN+ parameters. It also allows the user to alter their own set-ups and change terminal type. Admin level is required on most functions. set admin Syntax: set admin Description: This function allows the user to become the administrator or admin level. The command su can also be used.
set port Syntax: set port Description: This function allows a user to set the parameters for their port, or the administrator to set the parameters for any port. The user will be prompted for each parameter in this section (e.g: speed, parity, etc.). set port [number] This allows the administrator to set all of the port parameters for the indicated port.The user will be prompted for each parameter in this section.
show Syntax: show Description: This function allows the user to see most of the IOLAN+ configuration parameters, but not change them. The set command is used to configure the ports. The show command works with gateway, hosts, netstat, server, sessions, slip, extra, users, version. show ports The show ports command requires the port number. Example: show port 1 would show all the port settings for port 1.
test Syntax: test [port port_number] [count ] Description: This function causes IOLAN+ to run a simple output test on the port. IOLAN+ outputs a continuous stream of data in a preset pattern. To stop the test press any key.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Appendix B RS-422 IOLAN+ You need to read this chapter if you want to... You need to read this appendix if you want information about the RS422 variant of the IOLAN+. This appendix describes the IOLAN+ RS422 variant. This chapter includes the following sections; • Introduction on page 174 • Hardware Changes on page 174 • Software changes on page 176 • LED Error Codes on page 177 • Known Limitations on page 177.
Introduction This release note for the IOLAN+ contains important product information which is to be read in conjunction with the rest of this manual. This Release Note details the functional differences between the standard RS-232 and this RS-422 unit. Hardware Changes Connectors and Indicators The unit has 4, 8 or 16 RS-422 serial ports (8 port version shown:) 1. Main power switch 2. Power input socket 3. Power indicator 4. Port activity indicators 5. AUI indicator 6. AUI connector 7.
RS-422 Serial Port Connections Pin Signal 1 Not used Direction Description 2 S/GND 3 RXA - In Receive Data A 4 TXA - Out Transmit Data A 5 TXB + Out Transmit Data B 6 RXB + In Receive Data B 7 Not used No connection 8 S/GND Signal ground No connection Signal ground Functionally, the difference between the RS-232 and the RS-422 versions is the absence of support for hardware flow control lines (RTS and CTS) and modem control lines (DSR and DCD).
Software changes The main differences between the RS-232 and the RS-422 implementation are: • Input signals (DSR/CTS/DCD) not monitored on RS-422. • No hardware flow control on RS-422 • User stats screen does not show control signal states on RS-422 • 'Monitor DCD' and 'Monitor DSR' options not available on RS-422. These features would be selected on Port setup screen.
LED Error Codes If a hardware fault should occur in the unit then it is possible (if the fault is not too serious) that the LEDs will indicate the type of fault. Below is a description of the codes, should any of these error codes be shown return the unit for repair with a short description of the problem.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Appendix C 48V DC IOLAN+ Rack You need to read this chapter if you want to... You need to read this appendix if you want information on the IOLAN+ Rack for 48V DC supply. This appendix describes the 48V DC version of IOLAN+ Rack which has been designed specifically to operate on a telecoms compatible 48V DC supply. Please read these instructions carefully before commencing installation.
Introduction This version of the IOLAN+ Rack has been designed specifically to operate on a telecoms compatible 48V DC supply. Please read these instructions carefully before commencing installation. The 48-60VDC supply range marked on the equipment is the nominal voltage associated with the battery circuit of a centralised DC supply system. Higher voltages are only to be associated with “float” voltages for the charging function.
Installing the IOLAN+ Rack 48V DC Installation The IOLAN+ Rack 48V DC is designed for professional installation in a restricted access area. The installation should comply with current local or national standards applicable to the territory where the IOLAN+ Rack is installed. Warning The IOLAN+ Rack 48V DC shall be installed in a closed rack system with a power distribution unit.
Safety Earth Warning This apparatus must be earthed. A safety earth point is provided on the rear on the unit. A suitable earth cable of at least 20awg should be attached using the M3 pozi head screw and shakeproof washer to the safety earth point on the rear of the unit. Fusing CAUTION: for continued protection against risk of fire, replace only with same type of and rating of fuse. The IOLAN+ Rack 48V is fitted with a 1 Amp time delay DC rated fuse (6.3 x 32 mm).
Electrical Safety Guidelines Warning Electrical current from power, telephone and communications cables may be hazardous. Connect and disconnect cables in the order detailed below when installing, moving or opening the covers of this product or attached devices. During periods of lightening activity, do not connect or disconnect any cables or perform installation, maintenance or configuration.
Connecting up your IOLAN+ Rack Making connections to your IOLAN+ Rack should be performed in the following sequence: 1. Switch off the power source. 2. Connect attached devices 3. Connect the supply end of the DC supply cable observing the correct polarity. 4. Connect the supply cable to the IOLAN+ Rack and tighten the securing collar. 5. Switch on the supply. 6. Switch on the IOLAN+ Rack.
Disconnecting your IOLAN+ Rack 1. Switch off the IOLAN+ Rack 2. Switch off the power source. 3. Loosen the securing collar and disconnect the supply cable to the IOLAN+ Rack. 4. Disconnect the supply end of the DC supply cable (if moving the unit). 5. Disconnect attached devices. Your IOLAN+ Rack is now ready to be moved.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Appendix D Troubleshooting You need to read this chapter if you want to... You need to read this appendix if you want to troubleshoot problems with your IOLAN+ product. This chapter provides information on troubleshooting your IOLAN+. If you require further assistance, please contact technical support. See Appendix F Contacting Perle.
Introduction If you encounter problems when installing or using your IOLAN+, try the suggestions given in this chapter. Hopefully, the problems can be solved quickly, otherwise contact your distributor or Perle support.
Terminals/PC Problems If your terminal or PC connection is not working properly, symptoms are usually no output at all, 'garbage' on the screen, loss of characters or ports locking. Here is the common solution checklist to these problems: Problem Action required Cable error Replace the cable with a known good one or test the cable ends. Check the wiring against Appendix C, Cabling Guide. This is the number one problem. It is helpful to have a null modem cable and a RS-232 mini-tester.
Problem Action required Electrical noise If your equipment (especially cables) is near any high voltage equipment it may be picking up electrical noise which is corrupting the data signals. Check the stats screen of IOLAN+ (check Line Stats for malformed characters). Ensure all cables are correctly screened and attempt to keep them away from high voltage equipment. Software application error If there are problems whenever a certain application is used then the fault may lie with the software.
Printer Problems You can check some of the same problem notes in the terminal section because most are applicable to printers. The main problem is with cabling. Problem Action required Testing the port If you experience printer problems, it’s a good idea to temporarily connect a terminal in place of the printer so you can ensure some of the basic functions are working correctly.
Problem Action required Spooler problems Test the printer without relying on your spooler by sending data direct to the port you created and named when you ran the ioland daemon. Do this by typing: cat data_file > /dev/laser1 If this command returns, then the Unix system believes it has sent the data and there is a good chance it has been printed successfully. This would indicate that your print spooler has not been configured properly. ioland daemon problems Check to see if the daemon is running.
Modem problems Check some of the same problem notes in the terminal section because most are applicable to modems. The main problem here is also cable problems and port setup. Problem Action required Testing the port The first thing to ascertain is that you can talk to the modem. Check this by telneting to the port and attempting to obtain a response from the modem.
IOLAN+ Still Does Not Communicate A situation may occur which causes the IOLAN+ to completely not function. Here are possible problems : Problem Action required Port locked Try killing the port as it may be locked due to some situation that is no longer obvious. Also, killing the port ensures that any changes in the configuration will be acted upon. Power cycling Power cycle the device connected (if this is possible) as it may be that it has locked, or the set-up within the device is in error.
Resetting Your IOLAN+ At times, a support problem may require you to reset or diagnose your IOLAN+. It is best to discuss this matter with your supplier or Perle technical support. You can perform a factory reset using either of the following methods Using "facreset" command 1. Power on the unit and type the following from a CLI session: Local> su Password> iolan ADMIN:Local> facreset Do you really want to do this (y/n) [n] ? y Performing factory reset ... Using Diagnostic menu reset 1.
Using the IOLAN+ Statistics screens The IOLAN+ maintains a large number of statistics and these are available on several statistics screens. The various screens and the meanings of the statistics are described in this section. These screens are used along with technical support in troubleshooting. Only the most significant entries will be reviewed in this section.
IP/ICMP/UDP This is a comprehensive screen of networking protocol stats for IP, ICMP and UDP. You can identify bad IP packets coming in from your network. TCP This is a comprehensive screen of TCP protocol stats. You can identify bad TCP packets coming in from your network. Users This is a good menu for showing port and control signal status. You can identify status on each ports control signals.
Framed Link Status This is a good menu for Internet Service Providers especially. It shows who is logged on, current port status, which hosts are connected, and how long the port has been in its current state and its idle time.
Netstat This is a good menu for determining TCP connection status and the port access status. Gateway This is an often used screen for determining routing problems. SLIP This is a comprehensive SLIP stat and streams buffer screen. Clear counters This function sets all of the displayed counters to zero.
Restore counters The counter totals are redisplayed. Port Status This is a good screen for viewing individual port activity. Line status This is a good screen for spotting baud rate and parity errors which if malformed is rapidly incrementing.
LPD Status This screen allows you to check the status of your LPD connections and print queues. PPP Status This shows the PPP negotiation progress status and established PPP connections. Using SNMP SNMP stands for Simple Network Management Protocol. A full description of SNMP is beyond the scope of this manual. However, if you’re familiar with SNMP, you can use this as a troubleshooting tool. As the name suggests SNMP is a protocol designed to allow control of a whole network.
Diagnostics Entering the Diagnostic Menu 1. Connect a serial terminal (configured for 9600,n,8,1) to port 1 of the server. 2. Power on the server and press " B" on the terminal five times in succession while the unit LEDs are flashing (the firmware decompression phase). Note If you have an older unit with a reset button, to display the Diagnostic Menu proceed as follows; a. Press and hold down the reset button. b. Power on your IOLAN+ server unit. The Diagnostic menu now appears. c.
Download It is possible that when trying to download a new version of firmware over the network that when the FLASH is being programmed it can become corrupt. In the unlikely event of FLASH corruption it is possible to download new firmware via the FLASH bootstrap code. Ethernet Interface You will be prompted to accept or change the following parameters: Server Ethernet address. Server IP address. Host IP address (from which the download file will come).
Reset This allows the user to reset a number or all of the settings stored in FLASH which constitute the server's configuration. The following settings may be reset: 1. Reset all settings to factory defaults. 2. Reset password. 3. Reset IP address. 4. Reset product name. 5. Reset Ethernet address. q Quit. Reset all settings This clears the entire permanent database in FLASH.
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Diagnostics Page 203
IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Appendix E Cabling You need to read this chapter if you want to... You need to read this appendix if you want cabling information for your IOLAN+ product. This appendix provides cabling and connector information about the Perle IOLAN+ including serial ports and cables for various applications.
Introduction The following guide describes pinouts and cables for the IOLAN+ (DB25), IOLAN+ Rack(RJ45) and IOLAN+ 102/104 (RJ45) units. Both versions equipped with RJ45 connectors are also available as RS-422 units. Any cable you use should be shielded to comply with FCC requirements. Be careful not to run data cables near fluorescent lights, electric motors or other sources of electrical noise.
Serial port connectors on the IOLAN+ unit Serial port connector guide Product Serial port connector type For details see... IOLAN+ DB25 female RS232 DB25 female DTE on page 206. IOLAN+ Rack RS232 RJ45 female RS232 RJ45 DTE socket on page 207. IOLAN+ Rack RS422 RJ45 female RS422 RJ45 DTE socket on page 208. IOLAN+ 102/104 RS232 RJ45 female RS232 RJ45 DTE socket on page 207. IOLAN+ 102/104 RS422 RJ45 female RS422 RJ45 DTE socket on page 208.
RS232 RJ45 DTE socket Pin 1 (looking into socket) Pin Signal Direction Description 1 DCD In Data Carrier Detect 2 RTS Out Request To Send 3 DSR In Data Set Ready 4 TXD Out Transmit Data 5 RXD In Receive Data 6 S/GND 7 CTS In Clear To Send 8 DTR Out Data Terminal Ready IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Serial port connectors on the IOLAN+ unit Page 207 Signal ground
RS422 RJ45 DTE socket Pin 1 (looking into socket) Pin Signal 1 Not used 2 S/GND 3 RXA - In Receive Data A 4 TXA - Out Transmit Data A 5 TXB + Out Transmit Data B 6 RXB + In Receive Data B 7 Not used No connection 8 S/GND Signal ground IOLAN+, IOLAN+ Rack & IOLAN+ 102/104 User guide Serial port connectors on the IOLAN+ unit Page 208 Direction Description No connection Signal ground
Standard modem cables IOLAN+ DB25 DTE to Modem DB25 DCE Typical uses This type of cable is used to connect to DCE devices such as Modems.
IOLAN+ Rack and IOLAN+ 102/104 RS232 RJ45 DTE to Modem DB25 DCE Typical uses This type of cable is used to connect to DCE devices such as Modems. Perle provides a RJ45-DB25 converter for IOLAN to Modem DB25 Male convertor accessory. It allows a standard CAT5 patch cable to be connected to the IOLAN and the DB25 Male connector to a DCE device such as a modem with the appropriate pin-outs. See Perle’s website www.Perle.com for ordering information.
Standard Terminal/PC cables IOLAN+ DB25 DTE to Terminal DB25 DTE Typical uses This type of cable is used to connect to DTE devices such as Terminals/PCs.
IOLAN+ DB25 DTE to PC DB9 DTE Typical uses This type of cable is used to connect to DTE devices such as Terminals/PCs.
IOLAN+ Rack and IOLAN+ 102/104 RJ45 DTE to Terminal DB25 DTE Typical uses This type of cable is used to connect to DTE devices such as Terminals/PCs. Perle provides a RJ45-DB25 convertor for IOLAN to PC DB25 Female convertor accessory. It allows a standard CAT5 patch cable to be connected to the IOLAN and a DTE (Terminal/PCs) to be attached to the DB25 Female connector with the appropriate pin-outs. See Perle’s website www.perle.
IOLAN+ Rack and IOLAN+ 102/104 RJ45 DTE to PC DB9 DTE Typical uses This type of cable is used to connect to DTE devices such as PCs. Perle provides a RJ45DB9 convertor for IOLAN to PC DB9 Female accessory. It allows a standard CAT5 patch cable to be connected to the IOLAN and a DTE device (PC) attached to the DB9 Female connector with the appropriate pin-outs. See Perle’s website www.Perle.com for ordering information.
Printer cables with hardware flow control IOLAN+ DB25 DTE to Printer DB25 DTE Typical uses This type of cable is used to connect to DTE devices such as PCs.
IOLAN+ Rack and IOLAN+ 102/104 RJ45 male to printer DB25 DTE Typical uses This type of cable is used to connect to DTE devices such as PCs.PCs. Perle provides a RJ45-DB25 convertor for IOLAN to Printer DB25 Male accessory. It allows a standard CAT5 patch cable to be connected to the IOLAN and a DTE device (Printer) attached to the DB25 Male connector with the appropriate pin-outs. See Perle’s website www.Perle.com for ordering information.
Appendix F Contacting Perle You need to read You need to read this appendix if you want to contact Perle for technical support or any other this appendix if you queries about this product. want to... This appendix includes the following sections; • Making a technical support query on page 218 • Repair procedure on page 221 • Feedback about this manual on page 222 • Contacting Perle technical support on page 223 Internet access Click here to access the our website at the following URL: http://www.
Making a technical support query This section contains the following information about making a query; • Who to contact on page 218 • Information needed when making a query on page 219 • Making a support query via the Perle web page on page 220 Who to contact If you bought your product from a registered Perle supplier, you must contact their Technical Support department; they are qualified to deal with your problem.
Information needed when making a query When you make a technical support enquiry please have the following information ready; Hint Print out this page and fill in the table provided with the basic information you need.
Making a support query via the Perle web page If you have an internet connection, please send details of your problem to Technical Support using the email links provided on the Perle web site in the ‘Support’ area. See also Contacting Perle technical support on page 223 for email links and other contact details for the Perle technical support centres. Click here to access our website at the following URL: http://www.perle.
Repair procedure Before sending a unit for repair, you must contact your Perle supplier. If, however, you bought your product directly from Perle you can contact directly. See Contacting Perle technical support on page 223 for contact information. Customers who are in Europe, Africa or Middle East can submit repair details via a website form shown in the next picture. 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.
Feedback about this manual If you have any comments or suggestions for improving this manual please email Perle using the following address; Email: ptac@perle.com Please include the title, part number and date of the manual (you can find these on the title page at the front of this manual).
Contacting Perle technical support Note Perle offers free technical support to Perle Authorised Distributors and Registered Perle Resellers. To access technical support please visit the Perle website at www.perle.com/support. If you are unable to find the information you require, please feel free to contact our technical support teams by email using the addresses shown in the next table. Region Address Email North America Perle Systems Ltd.
#A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Index Numerics disconnect 166 exit 166 facreset 166 gateway 166 help 167 host 167 kill 167 lock 167 logout 167 prov 167 reboot 168 resume 168 rlogin 168 save 168 set 169 show 171 su 171 telnet 171 test 172 communicating via pc 40 via terminal 40 connect command 165 connections making on multi-user systems 59 connections menu 128 connector pinouts 204 contacting Perle Systems 217 email 217 for technical support 218 internet 217 copy 166 copy command 166
#A B C D E F G H I J K L M N O P Q R S T U V W X Y Z dialout modem ports configuration 81 host 82 remote access systems 84 remote site devices 87 routing 83 setup 79 disconnect 166 disconnect command 166 introduction to 26 menu system 41 menus 125 RS422 variant 173 switching on 38 ioland 118 printing with 100 K kill command 167 E email 217 exit command 166 L lines menu 151 lock commands 167 logging authentication 77 logout command 167 LPD printing 103 F facreset 166 facreset command 166 factory default
#A B C D E F G H I J K L M N O P Q R S T U V W X Y Z configuration of 81 host 82 remote access systems 84 remote site devices 87 routing 83 setup 79 virtual 89, 91, 97 modem, authentication and logging 70 multi-user systems connecting 59 connecting to 55 host table 58 setting up 54 R RCP printing 109 reboot command 154, 168 repair procedure 221 product repair form 221 RMA form 221 reset button, on legacy units 193 procedure for 193 procedure for legacy units 193 resume command 168 reverse telnet 116 rlogin
#A B C D E F G H I J K L M N O P Q R S T U V W X Y Z V virtual modem 89 AT commands 97 configuring ports for 91 vmodem 89 AT commands 97 configuring ports for 91 responses 96 Page 227
#A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Page 228
#A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Page 229
#A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Page 230
