Chase Research IOLAN+, IOLAN+Rack User And Administration Manual

IOLAN+ and IOLAN+



Communications Servers

CHASE IOLAN +

COMMUNICATIONS SERVER

90-200V AC 50-60Hz 2amp fuse

POWER

AUI

IOBASE2

IOBASE-T

Tx

12345678

POWER AUI

Rx

10BASE2

POWER

CHASE IOLAN + Rack

COMMUNICATIONS SERVER

10BASE-T

User and 

Administration Guide

CONNECTING THE WORLD

IOLAN

+

- User and Administration Guide

Chase IOLAN+, IOLAN+ and Chase Research are trademarks of Chase Research PLC. All other trademarks, tradenames and product names mentioned in this manual are acknowledged.

Chase Research reserves the right to change product specifications without prior notice.

This document was produced by MicroArt, Dorney, England, UK.

1 IOLAN+ features and applications 2 2 Hardware description for IOLAN+ . 8 3 Hardware description for IOLAN+ 4 Packing list for IOLAN+ 10 5 Packing list for IOLAN+ 10 6 Connections Menu. 15 7 Commands pop-up menu. 16 8 Administration Menu (view level). 16 9 Administration Menu (password level). 17 10 Server Configuration menu. 18 11 Commands pop-up menu (server confign). 19 12 Port Setup Menu. 20 13 Port Setup Menu screen. 26 14 Host Address Menu Screen. 27 15 Open Connection Pop-up Menu. 28 16 Port Setup Menu for PPP connections. 31 17 Remote Site Devices Screen. 34 18 Host Authentication and Logging screen. 38 19 Example Log file. 43 20 Port Setup Menu screen. 45 21 Gateway Menu screen. 47 22 Remote Access Systems Screen menu. 48 23 Remote Site Devices Screen. 50 24 ioland printing - Port Setup Menu screen. 53 25 LPD printing - Port Setup Menu screen. 55 26 RCP printing - Port Setup Menu screen. 61 27 Telnet - Port Setup Menu screen. 68 28 Commands - Exit pop-up menu. 75 29 Commands pop-up menu. 77

8

iii

IOLAN

+

- User and Administration Guide

30 Port Setup Menu. 79 31 Administration Menu. 89 32 Administration Menu (password level). 90 33 Access menu for Remote System Access. 91 34 Remote Access Systems Screen. 91 35 Remote Site Devices Screen. 93 36 Host Authentication And Logging menu. 94 37 Administration - Gateway Menu. 97 38 Administration - Host Address Menu. 98 39 Administration - LInes pop-up menu. 99 40 Lines - Access Menu. 99 41 Lines - Flow Control Menu. 100 42 Lines - Hardware Menu. 100 43 Lines - Network Connection Menu. 100 44 Lines - Options Menu. 101 45 Lines - Terminal Menu. 101 46 Server Configuration menu. 102 47 Server Statistics pop-up menus. 105 48 SNMP Trap Configuration Menu. 105 49 Server Statistics pop-up Menu. 125 50 Server Statistics screen - users. 126 51 Server Statistics screen - framed link status. 126 52 Network Connection Status screen. 127 53 Gateway Tables screen. 127 54 Server Statistics screen - port activity. 128 55 Server Statistics screen - Line status. 128 56 IOLAN+ DB-25 connector. 132 57 DB25 IOLAN+ RS-232 Pinouts (DTE). 132 58 IOLAN+ 59 RJ45 IOLAN+ 60 IOLAN+ Standard Modem Cable. 134 61 IOLAN+ 62 IOLAN+ Standard Terminal/PC Cables. 135 63 IOLAN+ PC Cable. 135 64 IOLAN+ 65 IOLAN+ 66 IOLAN+ Cable - Hardware Flow Control. 136 67 IOLAN+

RJ-45 Connector. 133

RS-232 Pinouts (DTE). 133

Standard Modem Cable. 134

Standard Terminal/PC Cables. 135 PC Cable. 135

Cable - Hardware Flow Control. 136

iv

Introduction 1

Thank you for purchasing the Chase Research IOLAN+ or IOLAN+ Ethernet TCP/IP communications/terminal server allowing serial devices to be connected directly to LANs and WANS. The 4, 8 or 16 serial ports enable IOLAN+ to connect to a wide range of devices including:

•

• ISDN adapters for branch remote access

• Terminals for multi-user Unix systems

• PCs using terminal emulation or SLIP/PPP

• All types of serial printers

• Data acquisition equipment (manufacturing,

• Retail point-of-sale equipment (bar coding,

Communications Server. IOLAN+ is a unique

Modems for remote access and Internet access

and Internet access

laboratory, etc.)

registers, etc.)

Introduction

The performance and flexibility of IOLAN+ allows you to use a wide range of high speed devices in complex application environments. These operating systems include:

• Windows NT

• Citrix Winframe

• SCO Unix & Gemini

• IBM AIX

• Sunsoft Solaris

• Hewlett Packard HP-UX

• Data General DG/UX

All other variants of Unix (BSD, Linux, IRIX, etc.)

•

®

1

IOLAN

+

- User and Administration Guide

This configuration diagram shows many of the features available on the IOLAN+ communications server:

The

Internet

SCO Unix Server

AIX Server

Windows NT Server

Router

Local PC

IOLAN+

O C

9 0

-2 0

0 V A

C 5 0

-6 0 H z 2

a m p fu

s e

POWER

Terminal

CHASE IOLAN +

N

U M M

IOLAN+

x T

12345678

POWER AUI

x R

10BASE2

Rack

10BASE-T

IOLAN +

CHASE

ER

POW

COMMUNICATIONS SERVER

Local PC

Cash Register

Remote PC

Printer

Modem

R E V

R E

S S N

IO T A

IC

AUI

IO

B A

S E

2

IOBASE-T

Modem

ISDN TA

Terminal

Remote PC

Figure 1: IOLAN+ features and applications

2

Introduction

1.1About this Guide

This guide describes the features and applications of the IOLAN+ terminal/communications server from the level of novice user to more experienced system installer. It includes information about the IOLAN+ table top unit as well as the IOLAN+

rack mount unit (form factor is the only

difference between the two).

As an experienced user, you may save yourself some set-up time by following the instructions in the IOLAN+ Quick Start Guide included with your package. Consult other sections in this guide as required. Release notes are also available with this unit (enclosed, or available from our web sites).

Note:IOLAN+ supports Windows® systems including Windows NT

®

, Windows® 95/98 and Windows® 3.x. When compared to Unix, there are several key features not included with Windows

®

systems such as TFTP, dial-out socket connections, etc. However, we have provided a briefing on these in the applicable sections. In many cases, we will point you to our FTP sites for the latest tips and software for IOLAN+ and Windows

®

systems.

This guide is sectioned as follows:

Installing your IOLAN+

Terminals on Multi-user Systems

Setting up Dial-in Modem Ports

Modem Authentication & Logging

Dial-out Modem Ports Setup

Printing

- Using ioland

- Using LPD

- Using RCP

3

IOLAN

+

- User and Administration Guide

Other Devices Setup

The Menu Interface

Command Line Interface (CLI)

Troubleshooting & Maintenance

Cabling Guide

Technical Specification

Notation Conventions Used

1.2 On-line Documentation

The following notations are used to describe commands:

Description Meaning

<parameter description> [parameter description] |

Text in the following font:

set term ansi

indicates input to, or output from the IOLAN+.

Screens illustrated in this guide may differ from those actually viewed. However, information contained is valid for both Unix and Windows

This guide cannot cover all the information available to you about the latest Chase developments and new features. However, there are a series of on-line documents available to help you to use the IOLAN+. You can check the support sections of our web sites for the latest information:

•

www.chaser.co.uk or ftp.chaser.co.uk

•

www.chaser.com or ftp.chaser.com

®

systems, and Terminals.

mandatory parameter optional parameter option separator

4

Introduction

1.3 Getting Support

If you encounter problems during setup or general maintenance, you can contact your supplier for support. Your request may be routed to Chase Research support as well. Here is the standard support route for the quickest answers:

For United States, Canada & South America based customers

1. Have your serial number and problem overview ready then…

2. Check with your supplier or distributor then…

3. Email

For customers based in Europe (except Germany and East Europe), Asia and Africa,

1. Have your serial number and problem overview

2. Check with your supplier or distributor then…

3. Email

For customers based in Germany, East Europe and Russia:

1. Have your serial number and problem overview

support@chaser.com

fax 615 872 0771

ready then…

support@chaser.co.uk

fax +44 (0) 1256 324562

ready then…

and / or

,

1.4 IOLAN+

Features

2. Check with your supplier or distributor then…

3. Email

IOLAN+ is a TCP/IP communications server with 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.

support@chaser.de

fax +49 (0) 711 7287156

and / or

5

IOLAN

+

- User and Administration Guide

The IOLAN+ hardware features:

• 4, 8 or 16 serial lines, each fully configurable with port speeds of up to 115.2 kbps.

• RJ45 or DB25 RS-232 connectors.

• Full modem control using DTR, DSR, CTS, RTS and DCD.

• FLASH memory for downloading firmware releases.

• 10BASE2, 10BASE-T and AUI Ethernet auto sensing interfaces.

• Auto sensing internal power supply (110-250V AC, optional 48V DC).

• LEDs for diagnostic testing.

• Self-test on power-up.

• Rack mount or tabletop design.

The IOLAN+ software features include:

• Support for TCP/IP protocols including telnet and rlogin.

• Remote access support including PPP, SLIP and CSLIP.

Printer support via lpd, rcp, and Chase utilities.

•

• Modem support via PPP and Chase utilities.

• Chase utilities provide ‘fixed tty’ support for Unix systems.

• A window oriented menu interface with popup menus and on screen help (command line also available).

6

• ARP or BOOTP for network based setup.

• Five language menu support for English, French, German, Italian and Spanish.

• Dynamic statistics displays and line status reporting for fast problem diagnosis.

• Multiscreens on terminals.

• Full support of SNMP MIBs, allowing remote configuration via SNMP as well as statistics gathering.

• Interoperability with IP routing through gateway tables.

• Domain Name Server support.

®

• WINS support for Windows

• Port configuration copy and save functions.

The IOLAN+ security features include:

environments.

Introduction

Hardware Description

• 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.

IOLAN+ comes in an 8 or 16 port tabletop unit or a 4, 8 or 16 port rack mount unit (IOLAN+ diagrams describe the units:

). The following

7

IOLAN

+

- User and Administration Guide

Serial Ports

90-200V AC 50-60Hz 2amp fuse

AUIPOWER

IOBASE2 IOBASE-T

1 2 345 6 7 8 9 10

Figure 2: Hardware description for IOLAN+ .

1 Main power switch

2 Power input socket

3 Power indicator

4 Reset switch cover

5 AUI indicator

6 AUI connector

7 10BASE2 indicator

8 10BASE2 connector (universal)

9 10BASE-T indicator

10 10BASE-T connector

11 Port activity indicators (rack only)

POWER

CHASE IOLAN + Rack

COMMUNICATIONS SERVER

POWER AUI 10BASE2 10BASE-T

Tx

12345678

Rx

4397516Serial Ports 8 10 11 2

12345678 AUI IOBASE2 IOBASE-T 110-230V AC 50-60Hz

Figure 3: Hardware description for IOLAN+

8

Introduction

Software description

The IOLAN+ comes with the Chase CD. This CD contains the latest ‘released’ firmware and the redirector software for Unix systems called and generally not used. The setting up printers and dial-out modems on Unix.

The IOLAN+ uses TFTP for downloading new firmware.

tftpd

is included with Unix systems such as SCO, AIX and HP-UX but disabled by default. Consult your Unix manual on this subject. On Windows time (see our

Note: Beta copies of the ‘next’ firmware release are usually available on web sites (consult README files before downloading).

Regarding source code binaries of SCO, AIX, HP-UX, Solaris, etc.). The source code can be compiled on any Unix system (consult your Unix manual on this subject).

Note: The most recent versions of these binaries should be available on web sites.

ioland

. The firmware is a backup copy

ioland

software is used for

®

,

tftpd

is not provided at this

FTP

site for a shareware

, for printers/modems on Unix systems, the

ioland.c

is provided. There are also several

ready to run for various Unix systems (i.e.

tftpd

program).

9

IOLAN

+

- User and Administration Guide

1.5 Packing List

The following is a check list of the contents of your IOLAN+ package:

1 IOLAN+ communications server 2 Electrical Safety Booklet 3 Chase CD and Quick Start Guide 4 4 wall mount brackets for IOLAN+ or

2 rack mount brackets for IOLAN+ 5 Test RS-232 loopback connector 6 Test 10BASE-T loopback connector (green) 7 Power cable

1

90-200V AC 50-60Hz 2amp fuse

2

IOLAN +

CHASE

6

3

4

5

Figure 4: Packing list for IOLAN+

7

10

1

2

3

Figure 5: Packing list for IOLAN+

7

6

5

4

IOLAN+ Installation 2

Below is a step-by-step guide on how to configure IOLAN+. You can also reference the

First connect IOLAN+ to a network then begin configuring the unit for your application. Additional information on configuring modems and printers follows.

IOLAN+ Quick Start Guide

Installing your IOLAN+

.

2.1Connecting to your Network

10BASE-T (twisted pair)

10BASE2 (Thin Ethernet)

AUI port

2.2Switching on IOLAN+

You connect to the network via one of three Ethernet media: 10BASE-T (twisted pair), 10BASE2 (thin) or the AUI connector. The connectors on IOLAN+ are auto sensing.

Attach the RJ connector from a hub directly to IOLAN+ twisted pair port.

Attach a BNC T connector directly to IOLAN+. If your IOLAN+ is the termination point for the cable you need to add a terminator. Always ensure that each segment of the thin Ethernet cable is at least 0.5m in length. The maximum length for a thin Ethernet cable is 185 metres.

The AUI connector allows an external transceiver to be connected. This allows a number of different interfaces to connect including 10BASE5 (or thick) and fibre optic transceivers.

The IOLAN+ power supply accepts input voltages in the range 110 to 250V AC, allowing it to be used world-wide.

After you connect your LAN interface, you can power up the unit. The green power indicator at the side (or front for rack 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.

11

IOLAN

2.3

+

- User and Administration Guide

Communicating via ARP

The green indicators next to each Ethernet connector (or front for rack units) indicate which connector is active (default is 10BASE2). It remains lit and will blink when LAN traffic is active.

Note: To change your Ethernet media, you will need to reboot the unit to activate the connector.

You are now ready to begin communicating with your IOLAN+. You can connect to IOLAN+ different ways: via a terminal or PC on port 1, or using ARP or BOOTP. Using ARP is the preferred method for both Windows however a terminal or PC attached to port 1 is often used. BOOTP setup is for Unix users only and is included in the

Tips

section (2.6). Choose the appropriate method for your

application.

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.

®

and Unix,

12

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)

On a Windows NT different (using dashes instead of colons):

arp -s a.b.c.d aa-bb-cc-dd-ee-ff

Whether you use Unix or Windows® to run arp, you are now ready to telnet to IOLAN+.

®

system, the arp command is slightly

Installing your IOLAN+

Here is the sequence to use:

arp -s 205.17.209.8 00:80:D4:00:33:4e telnet 205.17.209.8 password> local>

At the password prompt, just hit since this is not set yet. The IP address still needs to be configured on the unit (ARP has only allowed you to connect to the unit so far).

Note: If there are any errors, recheck both the IP and Ethernet addresses you keyed in (this is the most common error here). See

(Appendix B)

You can now skip the next section and go straight to

2.5,

The Menu System.

Troubleshooting & Maintenance

for more information on problems.

section

2.4

Communicating via a Terminal or PC

You can connect to IOLAN+ using a terminal or PC (with a terminal emulation package such as Hyperterm).

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 the (Appendix C) for pinout information.

For a terminal/PC to communicate with a server, set it to the following: 9.6 kbps, eight data bits, one stop bit, software flow control, no parity.

After powering up IOLAN+, you are prompted to enter a ‘Local login:>‘. You can just hit any character and point (the character is required).

Cabling Guide

at this

13

IOLAN

+

- User and Administration Guide

2.5 The Menu System

The next prompt displayed is Line Interface (CLI) prompt.

Note:

If there are any problems, check the cable you are using (this is the most common error). Port 1 is configured to provide error messages should any problems occur.

Troubleshooting

information on problems.

You can now move to

You should now be at the Command Line Interface (CLI) of the IOLAN+ as designated by the would like to continue in CLI mode refer to we recommend the menu system.

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

The default setting is ‘dumb’. To set the menu interface to your emulation simply type Example:

&

Maintenance

local>

, which is the Command

(Appendix B) for more

The Menu System.

local>

prompt. If you

set term

with your option.

See

Appendix A

, but

14

local> set term ansi

To switch from the command line interface to the menu interface, at the

set menu

The

Connections Menu

This menu displays the current state of the four possible connections. There are no active connections.

local>

prompt enter:

should now be displayed.

Installing your IOLAN+

CONNECTIONS MENU REMOTE-ADMIN

Connection Host

1 *** FREE *** 2 *** FREE *** 3 *** FREE *** 4 *** FREE ***

________________________________________________________________________________

v4.01 a CDi IOLAN+

Figure 6: Connections Menu.

The firmware version of IOLAN+ is located on the lower left hand portion (in this example, version 4.1). 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.)

Connections Menu

The keys used to move about in the menus depend on the terminal emulation you are using. The arrow keys should all work. The TAB key is very important for moving between fields. Backspace and DEL should work, but depend on the emulation. ESC (the escape key) will move you back one menu.

Note: If there is a problem with your emulation, you can try a different emulation mode. See

Maintenance

(Appendix B) for more information.

Troubleshooting

&

An accelerator key can be used to jump to an option within a menu and is the first letter of the option.

Select connection '1’ on the the

key. The

Commands

Connections Menu

and press

pop-up menu is displayed.

There are a number of options available from this menu.

15

IOLAN

+

- User and Administration Guide

1 *** FREE ** === Commands ===

________________________________________________________________________________

This option allows you to configure parameters affecting

IOLAN+RACK v4.01 a CDi IOLAN+

the Server box, eg hosts table, other terminals.

Figure 7: Commands pop-up menu.

Before communication across the network can be established the IOLAN+ must be assigned a network IP address. This is accessed through the

Connection Host

Administration Menu

.

Administration Menu

16

Select the

Admin mode

Note: If you are telneted into IOLAN+, the

port

options do not appear on the

The top level

ADMINISTRATION MENU REMOTE-ADMIN

gateway Examine/modify gateway table. host Examine/modify host table. line Terminal configuration organised by line. password Specify password to allow modification of menu items. port Terminal configuration organised by port. quit Return to connections menu. server Examine/modify Server parameters. stats Examine Server statistics.

________________________________________________________________________________

Administration Menu

field and press the key.

telnet, rlogin

Commands

pop-up menu.

appears as follows:

and

Figure 8: Administration Menu (view level).

Installing your IOLAN+

Select the factory default password here: this is

Password

field and press the key. Use the

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

The some extra fields

** Administrator ** ADMINISTRATION MENU REMOTE-ADMIN

access Remote System Access (PPP). change Change login and/or admin password. gateway Examine/modify gateway table. host Examine/modify host table. kill Kill TCP connections on serial line. line Terminal configuration organised by line. port Terminal configuration organised by port. quit Return to connections menu. reboot Reboot Server. server Examine/modify Server parameters. stats Examine Server statistics. trap Examine/modify SNMP Trap parameters.

________________________________________________________________________________

Administration Menu

(view level).

is redisplayed, however it now has

(access, change, kill, reboot, trap

).

Figure 9: Administration Menu (password level).

Select the into the

server

entry and press the key. This takes you

Server Configuration Menu

.

Server Configuration Menu

There are a number of fields in the

menu

which are explained in Section 9, At this point, you just need to give the IOLAN+ an and a

name

.

Server Configuration

The Menu Interface

IP address

.

17

IOLAN

+

- User and Administration Guide

** Administrator ** SERVER CONFIGURATION REMOTE-ADMIN

Name [IOLAN ] Debug mode [0 ] IP address [204.17.209.8 ] Subnet mask [ ] Ethernet address [00:80:d4:00:9e:a1] Ethernet interface [AUTO ] Language [English ] Identification [ ] Lock [Disabled] Password limit [5 ] CR to initiate [Yes ] SNAP encoding [Disabled] Boot host [204.17.209.1 ] Boot diagnostics [Enabled ] Boot file [ ] Init file [ ] MOTD file [ ] Domain name [ ] Name server [ ] NS Port [53 ] WINS server [ ] ________________________________________________________________________________

Figure 10: Server Configuration menu.

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.

18

Note: For more information about domain name servers, consult your operating system manuals.

IP Address: This address must be set to a value that is

consistent with the network the IOLAN+ is on.

Having filled in the fields press the key. This brings the

Commands

Note:

pop-up menu as shown below.

The Ethernet address is factory set. This address is

uniquely assigned to the IOLAN+ and MUST NOT be changed

.

Installing your IOLAN+

Subnet mask [ ] Ethernet address [00:80:d4:00:9e: == Commands ===ernet interface [AUTO ]

Figure 11: Commands pop-up menu (server confign).

Port Setup Menu and Beyond

Select the options are before exiting this menu, optional values for this field if available, and

Save & Exit

Quit & Exit,

field and press the key. Other

which does not save the changes

Values,

which will display the

Cancel,

which

will take you back to this screen for more editing.

You have now set up the unit with a new IP address. This should be confirmed with the message:

IP CHANGED—PLEASE REBOOT

Reboot the communications server to activate the new IP address using the

reboot

command. The IP address and/or subnet mask are the only parameters that when changed necessitate rebooting.

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

Command Line Interface

(Appendix A)

.

19

IOLAN

+

- User and Administration Guide

All of the procedures are based around the This is accessed through the

Administration Menu

Port Setup Menu

(password

.

level). Remember, that if you are not in the password level, you can only view the information, not change it.

Here is the

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [9600 ] Flow ctrl [XON/XOFF] Hot [^]] Intr [^C] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^U] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [ ] Monitor DCD [No ] Dst [ ]

User Options Access Name [ ] Keepalive [No ] Access [Local ] Terminal type [ansi ] Rlogin/Telnet [Telnet] Authentication [None ] TERM [ ] Debug options [No ] Mode [Raw ] Video pages [0] Map CR to CR LF [No ] Connection [None ] CLI/Menu [Menu] Hex data [No ] Host [ ] Reset Term [No ] Secure [No ] Remote Port [0 ] MOTD [No ] Local Port [10006]

________________________________________________________________________________

Port Setup Menu

:

Figure 12: Port Setup Menu.

This menu allows the user to set up all the parameters associated with a port. The administrator can alter the set-up of any port on the communications server while a user can only alter the set-up for their own port.

20

This menu is divided into the following sections:

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.

2.6 Tips

Installing your IOLAN+

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. Options: Deals mainly with the telnet options. This

section is the least used.

Keys: Defines the various accelerator keys that

IOLAN+ responds to and can be used for convenience.

Access: Controls the type of the connection made from

this port. This is the most important section in defining a port.

If you’re ready to install terminals, printers and modems, proceed to the appropriate section. For a good review, go to Section 9,

The Menu System.

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

Note: To get back to the menu system once in the CLI, type

set menu

The command above would copy the configuration of port number 1 to ports 2, 3, 4 and 5 (and return you to the menu system).

Connection

at the command line.

iolan> su password> ADMIN:iolan> copy 1 2 3 4 5 ADMIN:iolan> set menu

menu) and use the following syntax.

21

IOLAN

+

- User and Administration Guide

Connecting via BOOTP (for Unix

systems only)

IOLAN+ supports BOOTP which allows the communications server to dynamically configure itself on startup. Upon startup IOLAN+ sends four BOOTP broadcast requests if it has no IP address. This broadcast request packet contains the Ethernet address of your unit.

The request is received by all hosts on the network and is checked against a file to find a match. This data base file will normally be

Where:

ht

is the type of network

ha

is the Ethernet address on back of IOLAN+

hd is the home directory for specifying IOLAN+ firmware (optional) 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.

/etc/bootptab

# bootptab description :ht=ethernet:ha=0080d400024e:\ :hd=\ :bf=\ :ip=204.17.209.8:

and will be of the following format:

Saving and Downloading Configurations

22

Note: The most common error is bad information in the

/etc/bootptab Maintenance

You can now move back to

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 “.cf” (eg will be loaded as a configuration file rather than a boot file.

file (recheck it). See (Appendix B) for more information.

Troubleshooting &

The Menu System

in this chapter.

iolan.cf

), it

Installing your IOLAN+

This allows the administrator to configure one IOLAN+, save its configuration and automatically configure subsequent units via bootp.

Should the configuration of your IOLAN+ ever be corrupted because of user error or damage, it is an advantage to have the configuration stored somewhere for easy re-installation.

This can be achieved by uploading the configuration of the unit to a host on the network. To do this, enter the

Communications Server Menu Menu.

Select the

Set this to the full pathname of the file in which you wish to store the configuration. Set you wish the file to reside within and save these entries.

Boot host: rockvegas (or ip address) Init file: /tftp/term_serv.cfg

Log onto the host machine in the normal manner and create the file you have specified in the IOLAN+ menu, this could be as shown below:

Init file

from the

entry of this menu.

Boot host

Administration

to the host machine

touch term_serv.cfg

Note: This file must exist before you can write to it.

The file requires the correct read/write permissions to be downloaded. Return to the and temporarily select the CLI interface (if you are not using it already). This can be accomplished by hitting selecting the prompt. Use the

su

and enter the password, now type:

save config

CLI

option in the pop up menu at the

CLI

Connections

as the administrator, by typing:

menu of the IOLAN+

and

iolan>

23

IOLAN

+

- User and Administration Guide

This uploads the communications server port configurations to the host in a format that can be downloaded at a later date.

Note: This does not save any of the settings configured in the

Communications Server Menu

language, name, subnet mask, etc.

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.

, including the IP address,

Domain Name Server (DNS)

IOLAN+ can be configured to take advantage of your network’s Domain Name Server (DNS). This is done from the

Administration Menu

DNS in the as well.

name server

by keying in the IP address of your

field. Fill in the

domain name

field

24

Terminals on Multi-user Systems 3

IOLAN+ is used extensively for connecting terminals, printers and modems on multi-user Unix systems, especially in retail. These Unix systems include SCO Unix, IBM AIX, HP-UX, Data General’s DG/UX, etc. This section deals with terminals and/or PCs using emulation packages (such as Hyperterm). For information on adding printers, modems or other devices, see the respective sections.

The

Installation

with access to the menu system. This is convenient for most users. But in many applications, the users need to be ‘direct connected’ to a specific Unix host so that they see the prompt automatically. This is helpful in securing your system, or in environments where the users need to be in one application only.

This section will show how to setup a terminal, and other tips such as the concept of ‘fixed ttys’, multiscreens, the copy command, TERM features, etc. Consult Appendix C,

Cabling Guide,

section covered how to attach a terminal

for information on wiring your terminal.

Terminals on Multi-user Systems

login

3.1Terminal Port Configuration

Remember to use the TAB key to bounce between fields, and if you get the

, use

This is the setup for making a terminal connect to a designated Unix host

Port Setup Menu

The

Commands

Cancel

to return to editing this menu.

exit menu by mistake by hitting

login

prompt automatically.

screen is shown on the next page.

25

IOLAN

+

- User and Administration Guide

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [9600 ] Flow ctrl [XON/XOFF] Hot [^]] Intr [^C] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^U] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [ ] Monitor DCD [No ] Dst [ ]

User Options Access Name [ ] Keepalive [No ] Access [Local ] Terminal type [ansi ] Rlogin/Telnet [Telnet] Authentication [None ] TERM [ ] Debug options [No ] Mode [Telnet] Video pages [0] Map CR to CR LF [No ] Connection [Initiated] CLI/Menu [Menu] Hex data [No ] Host [204.17.209.1 ] Reset Term [No ] Secure [No ] Remote Port [23 ] MOTD [No ] Local Port [10006]

________________________________________________________________________________

Figure 13: Port Setup Menu screen.

The following fields are important:

26

Access: Set this field to

Local

. This tells the terminal

server port to listen for data on the RS-232 side.

telnet

Mode: With this field set to

in telnet mode (or

, the port will operate

raw

for rlogin). Most systems

will use telnet.

Connection:

Set this field to

Initiated

and the port will establish a TCP/IP connection to a specified host only after receiving a <CR> on the RS-232 port. If you set this field to

none

, then the user of this port will see the

menu system when the terminal is powered on.

Host:

Use this field to define which host computer you want the port to automatically connect to when using

Initiated

address or if you setup the

connections. Use the host’s IP

Host Address Menu

,

you can use a name (see next section).

Remote Port: This corresponds to Telnet service on the remote

host and must be set to the standard 23 (or 513 for rlogin).

Terminals on Multi-user Systems

3.2 Host Table Setup

Monitor DSR: You can set this field to

Yes

if you wire the terminal’s DTR signal pin 20 to the IOLAN+ DSR signal pin 6 (

see Cabling Guide

). When you turn the terminal off, it will reset the IOLAN+ port, which tells the Unix host to kill the user’s processes.

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 section 2-6,

Host Address Menu

The

Menu

Tips

).

by selecting the

is accessed from

host

entry. The host table can contain

the Administration

up to 10 addresses. Each entry consists of a host name and its corresponding IP address.

** Administrator ** HOST ADDRESS MENU REMOTE-ADMIN

Entry Host name IP Address

1 [fred ] [204.17.209.70 ] 2 [astro ] [204.17.209.6 ] 3 [router ] [204.17.209.254 ] 4 [chase ] [204.17.209.1 ] and so on… ________________________________________________________________________________

Figure 14: Host Address Menu Screen.

You can fill in an entry (both the name and the IP Address) for your host machines and then save the values by pressing the

key.

27

IOLAN

+

- User and Administration Guide

3.3 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 However, if your

Connections Menu

host

connection

field of the field is set to

Port Setup Menu

None

, the

appears. You are now ready to make

.

connections.

From the

*** FREE ***

the

Connections Menu

session to display the

Telnet

field and press the key.

Name: IOLAN CONNECTIONS MENU Terminal: 7

Connection Host

1 *** FREE ** === Commands ===

________________________________________________________________________________

press the key on a

Commands

menu. Select

28

Figure 15: Open Connection Pop-up Menu.

This produces a pop-up menu allowing the choice of the host machines that are configured in the host table. To select a host, move the cursor down to the required name then press the

key. At this point the unit attempts to make a connection across the network to the indicated host using the telnet protocol.

If it succeeds, the host machine’s login prompt is displayed. There may be an error in the configuration if the connection cannot be established.

Terminals on Multi-user Systems

Note: At this point, check the host table again for correct entries, then check the network connection and host machine you’re connecting to.

While in session to the host machine, you can return to the communications server by using a hot key. This is userdefined, but defaults to ^]. Press this key and the

Connections Menu

select the host session you were on (notice that the name of the host is now displayed where

key to bring up the

select the

Note: If the ^] did not work, you might have a conflict with that character sequence and should check the of this port.

When logging out of your session the connection is automatically closed.

Resume Connection

is displayed. To resume your connection

*** FREE ***

Connection

option.

pop-up menu, then

was). Press the

Keys

section

3.4 Tips

Connecting via ‘fixed ttys’

Multisessions on terminals/PCs

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 section 8,

Other Devices Setup

IOLAN+ is capable of supporting multiple sessions. This allows the user to connect to all four with different hosts and move between them using the ^] hot key. You can also key through the screens by setting the session key (e.g. If set to ^A you would bounce through the screens with a ^A1, ^A2, ^A3, ^A4.). If you are using a terminal that supports video pages such as the Wyse 60, the screens will be refreshed if you set the the

Port Menu

terminal (for Wyse 60 = 3).

.

*** FREE ***

video pages

to the number of pages supported by your

sessions

field on

29

IOLAN

+

- User and Administration Guide

The TERM field

Gateway Tables

The

TERM

field can be used to pass the terminal type information to the host. The IOLAN+ but will be passed to the host. The override the information being sent to the host about the type of terminal. This allows you to customise information being passed to the host. For example, a user could encode the physical location into this field (i.e. tty16) and then extract that at the host end to determine which port the user has logged in on (i.e. port 16).

When the host and IOLAN+ are connected via a gateway router, a connection is not possible until the gateway table has been updated with the IP address of the local gateway machine. See section 9.7, the

Menu Interface

.

terminal type

Gateway Menu

field is local to the

TERM

field can

section of

The

30

Setting up Dial-in Modem Ports 4

Setting up Dial-in Modem Ports

This section 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 section 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.

IOLAN+ can make a very good dial-in solution for ISPs and corporate users alike by using its remote access facilities. This section goes hand-in-hand with the next section,

Modem Authentication and Logging

.

Note:In many of the modem examples, we are using PPP. You can use SLIP and CSLIP in those applications requiring these legacy modes.

4.1Dial-in Port Configuration

The following is the port configuration for a dial-in connection, including PPP.

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [57600 ] Flow ctrl [Hardware] Hot [^@] Intr [^@] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^@] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [255.255.255.0 ] Monitor DCD [Yes] Dst [204.17.209.101 ]

User Options Access Name [ ] Keepalive [No ] Access [Local ] Terminal type [ansi ] Rlogin/Telnet [Telnet] Authentication [Host ] TERM [ ] Debug options [No ] Mode [Raw ] Video pages [0] Map CR to CR LF [No ] Connection [Dedicated] CLI/Menu [CLI ] Hex data [No ] Host [204.17.209.1 ] Reset Term [No ] Secure [Yes ] Remote Port [513 ] MOTD [No ] Local Port [10006]

________________________________________________________________________________

Figure 16: Port Setup Menu for PPP connections.

31

IOLAN

+

- User and Administration Guide

The following fields are important:

Monitor DCD:

TERM: This field is the TERM environment variable.

Flow Ctrl: The modem and terminal server port should be

Dst: This field contains the IP address the dial-in user

Mask: If using PPP, SLIP or CSLIP, this is the subnet

With this flag set to 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. When the modem hangs up, DCD goes low and the terminal server port resets. This will also drop the connection to the host.

Whatever you type in here will be passed to the host as the TERM variable when a telnet connection is established and the user logs in.

configured to use Hardware (RTS/CTS) flow control. This will be especially important if you are using SLIP.

will borrow for the PPP session. If you are using a straight forward dial-in connection for Unix, this is not required.

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.)

Yes

, IOLAN+ will monitor

32

Secure: This field is set to

use the Dst IP address. (su is not available in this mode.)

Yes

to force the call-in user to

Setting up Dial-in Modem Ports

4.2 The Host

Access: Set this field to

the terminal server to listen for data on both the RS-232 side and the network side. If only used for dial-in, set to the RS-232 side.

Connection:

Host:

Remote port: This corresponds to the Login (i.e. rlogin)

Local port: The

Make sure you have setup a valid user account for authentication on the designated authentication host. See

Modem Authentication & Logging

With the connection set to automatically connect to a specified host when not doing PPP (DCD goes high on the modem).

When not doing PPP, this field defines which host computer you want the port to automatically connect to. Use the host’s IP address. You can also define the host in the terminal server’s Host Table and just use the name.

service on the remote host and must be 513 (or 23 for Telnet).

inetd

for this port is listening for TCP/IP connections on TCP port 10006.

Dynamic

process running on the terminal server

. This sets the port of

Local

and it will only listen on

Dedicated

(section 5).

, the port will

4.3 The Modem

You will need to configure the modem using a configuration string. To do this, go to the (via the the UNUSED ENTRY that corresponds to the port with the modem attached (i.e. third one down is port 3, etc.). You can set the type (i.e. name) and the required configuration string (e.g. ate0s0=1&w). All other fields are default.

Access

section of the

Remote Site Devices

Administrative Menu

Modem Config

screen

). Select

to the

33

IOLAN

+

- User and Administration Guide

** Administrator ** REMOTE SITE DEVICES SCREEN REMOTE-ADMIN

Type [port3 ]

IP Addresses Src Addr [ ] Dst Addr [ ]

Modem Config [ate0s0=1&w ] Dial Comm [ ] Hang Up [ ]

PPP Configuration Dialer Configuration Restart timer [1 ] Dial Timeout [40] Max Retries [5 ] Dial Retries [2 ]

Inactivity [0 ]

________________________________________________________________________________

Figure 17: Remote Site Devices Screen.

4.4 Client Login

34

You will now need to

Menu

on CLI) to activate the changes and configure the modem.

kill

this port (from the

Administration

The configuration string will be sent to the modem after each call, keeping the modem in sync with IOLAN+.

When the caller connects, you may want to send out a welcome message of some sort (see MOTD tip below). 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 (e.g. Windows

®

95/98) and use PAP for authentication. Optionally, the dial-in user can place a P, S or C (all caps) in front of the user name at the Login prompt (this starts the corresponding protocol after successful authentication).

Welcome to the Internet site login: Cflint password: Host authentication succeeded.

Setting up Dial-in Modem Ports

My IP Address is : 204.17.209.7 Your IP Address is : 204.17.209.210 The Subnet Mask is : 255.255.255.0

With this example, IOLAN+ is now in CSLIP mode, so put your PC into CSLIP mode as well. Your dialer script will have to parse out the My/Your addresses from the above message. ‘Your IP Address’ will be the address of the PC that is calling in, and ‘My IP Address’ can be the PC’s default gateway. The above procedure works for SLIP and PPP as well. However, PPP will not display the ‘My IP...’ message because the IP addresses are negotiated automatically in the IPCP layer.

4.5 Tips

Domain Name Server (DNS)

WINS Server

With the

Dedicated

user name, you will be authenticated and then connected to the host. This will leave you at a shell prompt on the Authentication host. A caller will never see IOLAN+. If

Connection

(i.e.

IOLAN+ can be configured to take advantage of your network’s Domain Name Server (DNS). This is important for ISPs. From the the IP address of your DNS in the could fill in the

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

Configuration

Note: The Windows by setting 'Use DHCP for WINS resolution'.

Connection

, if you do not specify a P, S or C in front of the

is set to

IOLAN>

).

screen.

field on the

None

Administration Menu

Domain name

WINS server

®

95/98 client obtains the WINS address

Port Setup Menu

, you will be left at the CLI prompt

select

server

Name server

field as well.

field of the

Server

set to

and key in

field. You

35

IOLAN

+

- User and Administration Guide

MOTD

Gateway notes

A Message of the Day (MOTD) can be displayed before login. This is setup from the using

MOTD

and

Boot host

If you have a router on your local network, make sure you enter this into the IOLAN+

Server Configuration

fields.

Gateway Menu

.

menu

36

Modem Authentication & Logging 5

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.

Modem Authentication & Logging

Authentication:

Logging: During the IOLAN+ start up, a telnet session is

Note:RADIUS is often associated, but not required, for dial-

in services. RADIUS offers three major functions: authentication, logging and user services. IOLAN+ can be configured to offer all of these features but without using RADIUS. This section explains how.

When the IOLAN+ port has authentication set to

host or both

name followed by a password when dialed in. The user ID and password are forwarded to the authentication host for validation. By setting the authentication hosts network port to 23 or 513, this allows the user ID to be checked against the standard Unix login system (see section 5.4 for Windows® systems). This feature also allows proprietary user validation code to be written on any TCP/IP platform by choosing another network port number.

established to the authentication host, with the pre-defined

password

and out are recorded in the defined Log File.

, the user is required to enter a user

Tips

Log Username

. Serial events like users logging in

and

Logger

The

Host Authentication And Logging

via the administrator from the access option in the

Administration Menu

.

menu may be accessed

37

IOLAN

+

- User and Administration Guide

5.1 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. This feature is enabled when you set the to

host

in the

Port Setup Menu.

The following is the host authentication setup (via the section of the

** Administrator ** HOST AUTHENTICATION AND LOGGING REMOTE-ADMIN

Auth Host [204.17.209.1 ] Authentication Port [23 ] Login Prompt [ogin: ] Password Prompt [ssword: ] Success Indication String [Last ] Failure Indication String [incorrect ]

Maximum Login Attempts [3 ] Login Timeout (seconds) [60] Disconnect Probe [No ]

Log Username [iolan ] Log File [iolan.log ]

Log Power Up/Down [Yes] Log User Login/Logout [Yes] Log Port Connect/Disconnect [Yes] Log User Service Start/Stop [Yes]

________________________________________________________________________________

Administration Menu

Authentication

):

field

Access

38

Figure 18: Host Authentication and Logging screen.

The following fields are important:

Auth Host: The IP Address/Name of the host that

IOLAN+ attempts to login to for authenticating users.

Modem Authentication & Logging

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.

Password Prompt: The string used by IOLAN+ to know

when to send the users password. Use ‘ssword’ as depicted above.

Success Indication String:

Failure Indication String:

Maximum Login Attempts:

Login Timeout:

Disconnect Probe: This option determines whether

The string used by IOLAN+ to determine if the login ID and Password were valid and the login process was successful. Normally you will see the string ‘Last’ after successfully logging in.

The string IOLAN+ will look for to determine that the Login ID or Password were invalid. You will normally see the word ‘invalid’ or ‘incorrect’ as part of the failure message from the host.

The number of login attempts IOLAN+ will allow the user to make before dropping the call.

This defines the amount of time in seconds IOLAN+ will wait for the user to provide a login ID and password before dropping the line.

authentication probe logins will be terminated on completion of authentication.

39

IOLAN

+

- User and Administration Guide

Log Username: The User ID IOLAN+ will use to log in to

Log File: The filename the log user will send its

the authentication host and log messages. This user needs to be at a shell prompt to ‘cat’ messages to the log file. The password for the log user is set up under the IOLAN+

Change

option and enter the log user’s password as defined on the host. You will have to enter this password twice. (See

messages to. Normally this will go to the log user’s home directory.

Administration Menu

option. Then choose the

-

Logger

5.4 Tips.

)

5.2 The Host

Basic authentication

Log Power Up/Down:

Log User Login/Logout:

Log Port Connect /Disconnect:

Log User Service Start/Stop:

IOLAN+ will need to login to the authentication host with the log user name defined on the

Logging

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.

screen. Therefore, you need to create an account to

IOLAN+ will log when it is powered up and rebooted.

IOLAN+ will log when a user logs in and out of a port on IOLAN+.

IOLAN+ will log when someone connects to and disconnects from a port on IOLAN+. IOLAN+ will log a PPP, SLIP or CSLIP service when started on the port.

Host Authentication And

40

Modem Authentication & Logging

User services authentication

This is used to provide services based upon the dial-in user’s name.

For example, user Mark always telnets to a specific IP address or user Alan needs to dial-in and establish a PPP connection using a static IP address. This is accomplished by using a PERL script which parses a RADIUS database. The PERL script ( FTP site.

RADIUS is the TCP/IP protocol used for authenticating remote dial-in users.

Otherwise, you can execute our PERL script during the user’s login. Under Unix, this script is started from the For Windows support FTP site for the latest information.

You then need to create a user database file. This is a sample file (for a full file description see the Chase support FTP site).

# Example of a PPP user with static address alan Password Framed-Protocol = PPP Framed-Address = 204.17.209.1

RADparse

NT®

see the relevant section of the Chase

) is on the Chase CD or our

etc/profile

.

# Example of a user with access to IOLAN+ CLI/Menu techmanPassword User-Service-Type = Shell-Use

# Example of a telnet user mark Password User-Service-Type = Login-User Login-Host = 208.24.183.1 Login-Service = Telnet

41

IOLAN

+

- User and Administration Guide

# Everybody else gets PPP with a dynamic address DEFAULT Password Framed-Protocol = PPP

Note: When using advanced authentication, make sure the

Success Indication String Logging

menu is set to

in the

Host Authentication And

userdefined

.

5.3 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.

See Figure 18 for the (via the

When the IOLAN+ is powered up a Telnet connection is established to the authentication host with the Logger user name. The IOLAN+ records users logging in and out of the log file start-up time and the connection stays open until the unit is reset. The IOLAN+ seconds. The logger may be restarted via the by adding two to the number of ports on your server (i.e. use six for an IOLAN+4, ten for an IOLAN+8, eighteen for an IOLAN+16). If the host authentication succeeds, but logger fails to log events, then the port connection is dropped.

Access

access.log

Host Authentication And Logging

section of the

. The logger only connects at IOLAN+

checks the log TCP connection every 60

Administration Menu

kill

command

menu

).

42

5.4 Tips

Modem Authentication & Logging

Tue Jan 17 12:03:22 GMT 1997: server earth logger started Tue Jan 17 12:03:22 GMT 1997: server earth is alive Tue Jan 17 12:08:22 GMT 1997: server earth is alive Tue Jan 17 12:09:28 GMT 1997: server earth user us1 logged into port 1 Tue Jan 17 12:12:22 GMT 1997: server earth user us1 logged out port 1 Tue Mar 21 12:27:09 GMT 1997: server earth user us1 logged into port 1 Tue Jan 17 12:13:20 GMT 1997: server earth is alive Tue Jan 17 12:28:33 GMT 1997: server earth user us1 logged out port 1

Figure 19: Example Log file.

Windows® notes

Unix notes

Authentication of Windows NT® requires a telnet daemon. Check the Windows Windows

®

telnetd software. You will need to set up your

users on Windows NT

Logging on Windows NT

log_it.exe

. If the Windows NT® login user id is ‘logger’, enter it into IOLAN+ as use the

log_it.exe

®

section of our FTP site for the latest

®

through this software.

®

also requires a utility called

Nlogger

so that IOLAN+ will know to

utility.

Also, on the Host Authentication And Logging menu, change the IOLAN+ instead of

For LINUX users, edit the file ‘Last’ in it. This will agree with the standard setup of the

Authentication And Logging

Success Indication String

Last.

)

/etc/motd

menu’s

to read,

Microsoft

and put the word

Host

Success Indication String

.

43

IOLAN

+

- User and Administration Guide

44

Dial-Out Modem Ports Setup 6

Dial-out Modem Ports Setup

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.

If not using dial-out routing, you will need a COMPORT redirector such as

ioland

. The Chase CD has the ioland utility if you are using Unix. Please load the appropriate binary onto your system. If you can not find the correct binary, please compile the

ioland.c

source code for your

system (see your Unix manual).

6.1Configuration

The

Port Setup Menu

should be set up as follows for both

simple dial-in connections and PPP/SLIP connections.

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [57600 ] Flow ctrl [Hardware] Hot [^@] Intr [^@] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^@] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [ ] Monitor DCD [Yes] Dst [206.189.134.7 ]

User Options Access Name [ ] Keepalive [No ] Access [Dynamic] Terminal type [ansi ] Rlogin/Telnet [Telnet] Authentication [None ] TERM [ ] Debug options [No ] Mode [Raw ] Video pages [0] Map CR to CR LF [No ] Connection [None ] CLI/Menu [CLI ] Hex data [No ] Host [ ] Reset Term [No ] Secure [No ] Remote Port [0 ] MOTD [No ] Local Port [10006]

________________________________________________________________________________

Figure 20: Port Setup Menu screen.

45

IOLAN

+

- User and Administration Guide

The following fields are important:

6.2 The Host

For dial-out connections on Unix

Access: Set the

Monitor DCD: With this flag set to

Flow Ctrl: The modem and terminal server port should be

Mode: Set this field to raw.

If you have not already loaded now (see Chase CD). For more information on

Connecting Other Devices

the superuser prompt you would run the following command in Unix:

ioland –h <server-name> 10006 <device-name>

Access

field to

Dynamic

or

Remote

(dial-out only).

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.

configured to use Hardware (RTS/CTS) flow control. This will be especially important if you are transferring binary files.

ioland

onto your system, do so

(section 8). In it’s simplest form, at

(dial-in or out)

ioland

see

46

This will start the ioland process and allow you to specify a device-name in pseudo tty works just like a regular tty with the following exception: you cannot set physical attributes such as baud rate, parity and flow control as these are handled by the terminal server. If you plan to use communication software on the Unix host such as Unix manual for additional help.

/dev

that is linked to a pseudo tty. This

cu

or

uucp

you should refer to your

Dial-out Modem Ports Setup

For dial-out connections on Windows

®

systems

6.3 Routing

Check our FTP sites for the latest information on dial-out connections (under the Windows

®

support directory).

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. In the case of a Unix system, you must make an entry similar to the following (please check your Unix manual for the proper syntax of the route command):

For a single host at the remote site:

route add <remote-ip-addr> <IOLAN-ip-addr> 2

For multiple hosts at the remote site:

route add net <remote-net-addr> <IOLAN-ip-addr> 2

IOLAN+ will dial into another piece of hardware, log into that hardware and start a PPP session. Then the local IOLAN+ will act as a router and forward all IP traffic destined outside its local network. In other words, IOLAN+ will 'auto-dial' the Internet and act as the router. In this example, the local network is: 206.131.227.0, the ISP’s network is: 206.189.134.0, the ISP’s equipment that you are dialing into is another IOLAN+ (206.189.134.7) and the local IOLAN+ is: 206.131.227.5. The IOLAN+ gateway entries look like this:

** Administrator ** GATEWAY MENU REMOTE-ADMIN

Entry Destination Gateway Netmask

1 [206.189.134.0 ] [206.189.134.7 ] [default ] 2 [default ] [206.189.134.7 ] [default ] 3 [ ] [ ] [ ] 4 [ ] [ ] [ ] ________________________________________________________________________________

Figure 21: Gateway Menu screen.

47

IOLAN

+

- User and Administration Guide

6.4 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.

** Administrator ** REMOTE ACCESS SYSTEMS SCREEN REMOTE-ADMIN

Sitename [206.189.134.2 ] User name [corp ] Password [whodunit ]

Device type [modem1 ] Service type [PPP ] Inactivity [5 ]

Phone number [ ] Login-script [ ]

________________________________________________________________________________

Figure 22: Remote Access Systems Screen menu.

The following fields are important:

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.

48

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

. You may have several ports setup with the same device type, and the dialer will use the first available

.

If a device for dialing out is not available, IOLAN+ will return an ICMP ‘host unreachable’ message (ICMP type 3 code 1).

Dial-out Modem Ports Setup

Service type: This specifies which protocol will be used when

the link is established to the remote site. Choices are PPP, SLIP and CSLIP.

Inactivity: The period (in minutes) of inactivity on the SLIP/

PPP link before the port drops the call automatically. Setting this field to 0 turns the timeout feature off.

Phone number:

Login-script: The chat script that will be used to login to the

The phone number of the remote system. Note that 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. The following characters are ignored ‘(‘, ‘)’, ‘-’, ‘.’ when included as part of the number.

remote system. It takes the form of the usual Send/Expect chat script you may already be familiar with. If no script is defined, this step is skipped (e.g. hardwired connections). There are a few special characters used by IOLAN+ as described below:

""

expect nothing (i.e. IOLAN+ starts the chat script)

\r

send a carriage return

\n

send new-line

\u

user name (sends the username from the

User name

\p

password (sends the password from the password field).

\1-\9

delay for number of seconds.

\s space (Substitute this instead of a

<space> value).

field).

49

IOLAN

+

- User and Administration Guide

\t phone# (sends the telephone number

field).

\d send the modem’s dial command \\ escapes to ‘\’. \b send a break.

6.5 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.

** Administrator ** REMOTE SITE DEVICES SCREEN REMOTE-ADMIN

Type [modem1 ]

IP Addresses Src Addr [206.131.227.5 ] Dst Addr [206.189.134.7 ]

Modem Config [at ] Dial Comm [atdt ] Hang Up [+++ath0 ]

PPP Configuration Dialer Configuration Restart timer [3 ] Dial Timeout [40] Max Retries [5 ] Dial Retries [2 ]

Inactivity [0 ]

________________________________________________________________________________

Figure 23: Remote Site Devices Screen.

50

The following fields are important:

Type: The name of the modem assigned to a specific

port. It is referenced from the

Systems Screen

Dst Address: The address of the remote system IOLAN+ is

calling into.

Config: The modem’s configuration string. There are a

few examples at the end of this document. Note: Leave this field blank for directly

connected devices.

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-out Modem Ports Setup

Remote Access

in the

Device type

field.

6.6 Tips

Hunt groups

Dial Retries: Number of times to attempt a connection to the

remote site before giving up.

You can setup several modems and use the same name for each group under the first available modem defined in which if busy will default to the next available.

Remote Site Devices

Remote Site Devices,

. IOLAN+ will use

51

IOLAN

+

- User and Administration Guide

52

Printing 7

Printing

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.

1.

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 Chase CD provided with the unit or from any of the Chase web sites.

7.1Using ioland

Configuration

2. LPD is the ‘line printer daemon’ protocol supported by most operating systems including Windows

®

and Unix (i.e. SCO, AIX, DG/UX, HP-UX, Solaris, etc.) Check our US FTP site (ftp.chaser.com) for an LPD spooler for Windows

®

95/98.

3. RCP is ‘remote copy printing’ and available on Unix systems. It requires a special interface script also found on the Chase CD.

We suggest you use the Chase provided. The only.

Ioland

ioland

utility can be used for Unix printing

is a Unix tty port redirector. For non-UNIX

ioland

utility on the CD

applications use LPD, see Section 7.2.

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [9600 ] Flow ctrl [Hardware] Hot [^]] Intr [^C] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^U] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [ ] Monitor DCD [No ] Dst [ ]

User Options Access Name [ ] Keepalive [No ] Access [Remote ] Terminal type [ansi ] Rlogin/Telnet [Telnet] Authentication [None ] TERM [ ] Debug options [No ] Mode [Telnet] Video pages [0] Map CR to CR LF [No ] Connection [None ] CLI/Menu [Menu] Hex data [No ] Host [ ] Reset Term [No ] Secure [No ] Remote Port [0 ] MOTD [No ] Local Port [10006]

Figure 25: Ioland printing - Port Setup Menu screen.

53

IOLAN

+

- User and Administration Guide

The following fields are important:

Flow ctrl: Set your IOLAN+ port flow control to

Then set your printer to use ‘DTR Pacing’ or ‘Hardware’ or ‘Ready/Busy’ flow control. Use the RS-232 cable pinout described below, as this will save a print job if the printer is turned off or the cable becomes detached. Refer to the

Cabling Guide

Access: Set this field to

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.

You can check on the status of this process by looking at the server’s CLI prompt).

Mode:

Local port: The INETD process running on the terminal

Set this field to terminal server in Telnet mode, which will ensure that EOF is properly negotiated before closing down the TCP/IP connection, otherwise the tail end of a print job could be lost.

server for this port is listening for TCP/IP connections on TCP port 10006.

(Appendix C).

Remote

Netstat

Statistics

Telnet

. This sets the port of the

screen of the terminal

menu (or

show net

. This puts the port of the

Hardware

from the

.

54

The Host

If you are already familiar with the above configuration is:

ioland -T <server name> 10006 <device name>

This will start you are not familiar with the

Other Devices Setup

ioland

process and create a device in /dev. If

.

ioland

, all you have to do for

ioland

program, read section 8,

Printing

Tips

7.2Using LPD

Configuration

Hunt groups: Hunt groups are supported on IOLAN+ for

printing. To use this, use the same number in the

Port Setup local port

field (i.e. 1006).

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.

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [9600 ] Flow ctrl [Hardware] Hot [^]] Intr [^C] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^U] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [ ] Monitor DCD [No ] Dst [ ]

User Options Access Name [LPD_printer ] Keepalive [No ] Access [Remote ] Terminal type [ ] Rlogin/Telnet [Telnet] Authentication [None ] TERM [ ] Debug options [No ] Mode [Raw ] Video pages [0] Map CR to CR LF [No ] Connection [None ] CLI/Menu [Menu] Hex data [No ] Host [ ] Reset Term [No ] Secure [No ] Remote Port [0 ] MOTD [No ] Local Port [515 ]

Figure 25: LPD printing - Port Setup Menu screen.

The following fields are important:

Flow control:

Set your IOLAN+ port flow control to Then set your printer to use ‘DTR Pacing’ or ‘Hardware’ or ‘Ready/Busy’ flow control. Use the RS-232 cable pinout described below, as this will save a print job if the printer is turned off or the cable becomes detached. In your cable, wire the printer’s pin 20 (DTR) to the IOLAN+ pin 5 (or CTS). Also, cross pins 2 and 3.

Hardware

55

.

IOLAN

+

- User and Administration Guide

Name: The LPD client, as a reference to the printer, will

use what you assign here. This is the printer queue name on IOLAN+.

Accessing the Printer

Access: Set this field to

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.

You can check on the status of this process by looking at the NETSTAT screen of the terminal server’s STATS menu (or

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 515 (this is the LPD service number).

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

n printing via LPD the client refers to the printer by IP

Whe address (or the name associated with this address from the host table) and printer name or queue name. This may take one of three forms:

Remote

. This sets the port of the

show net

®

that also support LPD.

).

56

1.

The name of the terminal server and no queue name or port number. This will cause the print job to be printed on the first available LPD port on the terminal server of this name. The the

Port Setup Menu

does not need to be set.

Name

field in

Printing

2.

The name of the terminal server followed by a port number. For example if the queue name is server_name9 (or server_name09) then serial port 9 will receive the print job. Please note that in this example, the

Name

field in the

3.

The printer name as set in the

Setup Menu

. More than one serial port may

Port Setup Menu

need not be set.

Name

field of the

Port

have the same name allowing the server to create a hunt group of printers. The first available port to match that queue name will receive the print job.

A special feature of LPD with terminal servers is the ability to do carriage-return and line feed mapping at the server. This is accomplished by having a + appended to the client queue name and is valid for all of the above methods of access. Alternatively, you may enable the CR to CR LF mapping option for the port.

Note: There is a maximum limit of 30 LPD connections per server, which may be distributed to all of the available LPD ports as required. If the maximum is exceeded then the request is rejected and the connection is closed.

LPD printing from DOS/Windows

At present it is possible to print from Windows

®

this will normally be accomplished via a separate application program like PC/TCP or Netmanage Chameleon. The new versions of Windows intended to have TCP/IP built into the operating system. Windows NT on the Internet for Windows

The documentation for each application or operating system should allow users to configure and use it with IOLAN+. The obvious advantage of using LPD to print is that the server can be used to connect a printer that will be shared between both DOS/Windows

®

or DOS although

®

type operating systems either have or

®

has a built-in LPD utility, and there are shareware packages

®

95/98 (check our FTP site).

®

and Unix machines.

57

IOLAN

+

- User and Administration Guide

Under Windows® the printer will be available from within other applications via the

The actual printer will be referenced by the Name of the terminal server serial port or, by the terminal server and port number in the same way that Unix uses the Name.

The server IP address should be included in the Host table before trying to setup the actual printer port.

File

option of the Windows® menu bar.

LPD Printing from BSD Unix

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.

The Unix host should have a printer database, for BSD type systems this will be the file an entry within this file for the server’s LPD port that looks something like the following:

Printing could then be accomplished using the following command:

A limitation of printing with LPD on the terminal server is that no formatting of text (apart from the + operation) can be carried out by the terminal server firmware. This is due to the lack of a spooler utility in the terminal server and the data being forwarded directly to the serial port.

/etc/printcap

#term_serv LPD Printer on serial port 16 Laser1|IOLAN LPD printer 16:\ :rp=LPD_printer:rm=term_serv:lp=:sf:\ :sd=/usr/spool/LPD/LPD_printer:\ :lf=/usr/spool/LPD/term_serv16/log:

lpr –PLaser1 <file>

and there should be

58

Printing

To overcome this the local host must perform all of the necessary changes and then send these to the terminal server. Defining a printer queue as in the previous examples can do this.

If filtering or formatting is required then a local linking print queue needs to be created. This would be something like the following:

# Lcl q to link to term_serv LPD Printer on port 16 link-Laser1| IOLAN LPD Printer 16:\ :lp=/dev/null:sf:sd=/usr/spool/LPD/Laser1:\ :lf=/usr/spool/LPD/LPD_printer/log:\ :of=/etc/IOLAN/link-Laser1:

The shell script output file link-Laser1 has the contents:

#!/bin/sh lpr –PLaser1

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:

LPD Printing from SYS V Unix

#!/bin/sh /usr/local/filter ‘$@’ | lpr –PLaser1

Here is an example for setting up the System V spooling system (i.e. SCO, Solaris, etc.) to print to IOLAN+ LPD daemon. This assumes that you will print to a port configured like the example above on an IOLAN+ called term_serv.

lpsystem -t bsd term_serv lpadmin -p Laser1 -s term_serv

If the terminal server is not defined in the may not get an error message from either the

lpadmin

commands, but the printer will not print.

/etc/hosts

lpsystem

file you

or

59

IOLAN

+

- User and Administration Guide

If the

lpsystem

command will return an error indicating that the system named in the -s parameter does not exist even though the system is listed in the

Note: Although it is possible to create a printer pool on the IOLAN+, UNIX lpd queues only print one job at a time. The host will wait for one job to complete before spooling the second so all jobs will go to the same queue and print from the same IOLAN+ port.

command is not performed, the

/etc/hosts

file.

lpadmin

LPD printing from AIX

LPD printing from HP/UX

Tips

7.3 Using RCP

Consult our FTP sites for the latest information.

Hunt groups: Hunt groups are supported on IOLAN+ for

printing. To use this, use the same queue name in the IOLAN+ Port Setup

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 Chase CD for RCP.

name

field.

60

Configuration

Printing

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [9600 ] Flow ctrl [Both ] Hot [^]] Intr [^C] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^U] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [ ] Monitor DCD [No ] Dst [ ]

User Options Access Name [LPD_printer ] Keepalive [No ] Access [Remote ] Terminal type [ ] Rlogin/Telnet [Telnet] Authentication [None ] TERM [ ] Debug options [No ] Mode [Raw ] Video pages [0] Map CR to CR LF [No ] Connection [None ] CLI/Menu [Menu] Hex data [No ] Host [ ] Reset Term [No ] Secure [No ] Remote Port [0 ] MOTD [No ] Local Port [10006]

Figure 26: RCP printing - Port Setup Menu screen.

The following fields are important:

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. Use the RS-232 cable pinout described in Appendix C,

Guide

, as this will stop a print job if the printer

Cabling

is turned off or the cable becomes detached.

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. You can check on the status of this process by looking at the NETSTAT screen of the terminal server’s

Statistics Menu

(or

show net

from CLI).

Mode: The

port of the terminal server will operate in a

raw TCP/IP mode.

.

61

IOLAN

+

- User and Administration Guide

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

Using RCP with Unix System V line printer spoolers.

On systems where LPD or a binary for available, or is found to be unreliable due to limitations in the OS, RCP provides a useful, if limited, alternative method for printing. The port/group of ports must be configured to listen to the RCP port, which is port 514. Users can then copy files to the server using the following command syntax:

rcp <file> <server>:tty [port #]

It is worth noting that the RCP will fail if the port (or all the ports in the hunt group) is in use when the RCP command is attempted. If you wish to use RCP as part of a System V print spooler script, it is essential that the script check the return status of the RCP command.

a. Log in as root and create a print queue for the

printer with 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.

b. Go into the directory containing the interface

scripts for all printers. This is normally found in:

/dev/null

as the device port. For

ioland

is not

62

/usr/spool/lp/admins/lp/interfaces Rel 3 Unix. /etc/lp/interfaces for Release 4 Unix. /usr/spool/lp/interfaces for XENIX.

c. Find the interface shell script for this printer

and copy it to a file with the suffix ‘.orig’. using the example:

cp hpjet hpjet.orig

d. Copy the Server RCP shell script from the TSSD

support disk to the interface script, e.g:

cp /etc/chase/src/chase.rcp hpjet

Having created the hpjet file set the permissions to allow execution of the script, e.g:

chmod a+x hpjet

e. Edit the interface script and insert the desired

server name and port number. For example, if the name is ‘iceland’ and the printer is attached to port 8 (numbering from 1 to 16). Then the line:

rcp $TMP <server name>:tty<port number>

Printing

becomes:

rcp $TMP iceland:tty8

Some Unix systems may require the full pathname of the ‘RCP’ command. For example:

/usr/ucb/rcp $TMP iceland:tty8

f. Activate the printer for use, e.g:

/usr/lib/accept hpjet enable hpjet

g. Set up the IOLAN+ port for RCP printing by

changing the section of the

Loca Port

field in the

Port Setup Menu

Access

to 514.

63

IOLAN

+

- User and Administration Guide

RCP printing on a spooler system based on BSD Unix.

a. Log in as root and create a print queue for the

b. Go into the directory containing the desired text

c. Link the generic filter program to a file with the

Currently, the RCP printing utility will not work if the is used in conjunction with any other filter.

printer with example, create a printer queue by placing this record in

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/chase/hpif:

filter program intended for the no filter required for this queue then create a dummy filter program which calls the command with no arguments.

suffix ‘.orig’. This generic filter program may be in use by other printer queues and so is left untouched. Using the example:

/dev/null

/etc/printcap

as the device port. For

:

if

field. If there is

cat

of

filter

64

ln -s <filter-name> /etc/chase/hpif.orig

d. Copy the Chase RCP shell script to the Chase

Other Devices Setup

8.1Reverse Telnet Port Configuration

IOLAN+ accomplishes this by using a connection. On Unix you utilise the supplied on the Chase CD. For Windows support section of the web sites for the latest support software for dial-out applications.

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 Chase utility

. For Windows® system consult the Chase FTP site.

reverse telnet

ioland

software

®

, consult the

67

IOLAN

+

- User and Administration Guide

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [9600 ] Flow ctrl [Hardware] Hot [^@] Intr [^@] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^@] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [ ] Monitor DCD [No ] Dst [ ]

User Options Access Name [ ] Keepalive [No ] Access [Remote ] Terminal type [ansi ] Rlogin/Telnet [Telnet] Authentication [None ] TERM [ ] Debug options [No ] Mode [Raw ] Video pages [0] Map CR to CR LF [No ] Connection [None ] CLI/Menu [Menu] Hex data [No ] Host [ ] Reset Term [No ] Secure [No ] Remote Port [0 ] MOTD [No ] Local Port [10006]

Figure 27: Telnet - Port Setup Menu screen.

The following fields are important:

Keys: Set all your Keys to ^@.

68

The Host

Remote

Access: Set this field to

. 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. You can check on the status of this process by looking at the Netstat screen of the terminal server’s Stats menu.

Mode: Set this field to

Raw

.

Local Port: The INETD process running on the terminal

server for this port is listening for TCP/IP connections on TCP port 10006 (for port 6).

If you are already familiar with

ioland

, all you have to do for

the above configuration on Unix is:

ioland -p <server name> 10006 <device name>

Other Devices Setup

8.2 Chase ioland Utility

This will start the create a device in /dev. If you are not familiar with the

ioland

program, read the following section.

If you are using Windows information on dial-out connectivity.

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. In the case of printers, it is recommended that the LPD protocol is first assessed as a suitable printing solution before the IOLAN+ daemon.

By default, the daemon will fork into two processes during the start of a data transfer. The parent process will transfer data from the client to the server while the child process will transfer data from the server to the client. The parent also handles all the control aspects of the client-server link. The child process is normally terminated when the client process closes the slave pseudo-tty unless the this case, the child is created at startup time and remains.

ioland

process in permanent mode and

®

check the web page for the latest

-p

option is used. In

If the daemon is started without any arguments it will try and open the configuration file instructions on which daemons to start, for which peripherals, plus any optional arguments.

Alternatively, a single daemon can be started from the shell with various arguments specified.

/etc/ioland.cf

which contains

69

IOLAN

+

- User and Administration Guide

There are three mandatory arguments the daemon requires to mediate between the client and server port:

Server: The host name of IOLAN+ that has the attached

Port: The TCP port on which the IOLAN+ port is

printer or terminal.

listening for connection requests.

Link: A mnemonic filename in

linked to the slave pseudo-tty selected by the daemon. This should be used as the interface device for client processes since the pseudo-tty may change during the daemon lifetime.

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:

-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. If the end of print jobs are still being lost despite using this option then it is advised to set the stty option ‘noflsh’ on the slave pseudo-tty if it is supported. This may require the

-m

or -a options. Alternatively, most line printer spoolers employ a delay before closing the printer port to ensure no pending output is accidentally flushed. It may be possible to increase this delay if the above solutions are not enough. Make sure the port is set to telnet mode in the

Port Setup Menu

-p

The daemon maintains a continuous TCP connection to the IOLAN+ port. This is useful for applications that require exclusive and uninterrupted access to a device. Note that no other daemon will be able to access such a port if any daemon is running to that port with this option.

.

/dev

which shall be

70

Other Devices Setup

-h

Hangs up the pseudo-tty if the TCP connection is lost. This mimics the situation in which a real serial port loses a signal such as DCD. In the same manner as the serial port, a SIGHUP signal will be sent to all processes that have the slave pseudo-tty as their controlling tty. See the

-n

Converts all carriage-returns read from the client process to carriage-return and line-feed. This is useful if using

ioland

for printing and the print job is off the right

margin (i.e. ‘stair stepping’).

-m

Push the STREAMS tty modules onto the slave pseudotty. This is useful for applications that expect to modify tty parameters as if a hardware device was attached. The modules pushed are the line discipline (normally called

ldterm

) and the hardware emulation (if supported). This option requires that the pseudo-tty architecture is based on the STREAMS I/O mechanism. The recommended Unix variants for using this option are those based on System V Release 3. Variants based on System V Release 4 should first try the Variants such as HP-UX, AIX, XENIX and SunOS do not require either option.

-a

option.

-w

option.

-a

Use the onto the slave pseudo-tty. This facility is supported on Unix System V Release 4 variants.

-u

Discard all data received from the peripheral. This is useful in cases where the peripheral is sending unwanted data to the host, which is not being read by the client and therefore may cause blockage problems on the pseudo-tty.

-w

Used with the -h and -p options. By default, on a hangup, the daemon will open a new pseudo-tty before it has reconnected to the IOLAN+ port. This option does the opposite and tries to re-establish the TCP connection first

autopush

facility to push STREAMS modules

.

71

IOLAN

+

- User and Administration Guide

-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

<file>

Specify a different configuration file. If the pathname is relative, the current working directory will be used.

-F This option causes each and every time ( option is:

ioland -F <other options> <iolan> <master device> <slave device>

e.g: ioland -F bronto ptyp3 ttyp3

This option checks if the TCP connection is still alive

-k<n>

every

n

seconds. If the test fails, the child daemon process dies and signals the parent daemon that the connection is lost.

-s<desired character transfer rate>

This option causes the iolan.

-x<n>

Set the daemon debug/diagnostic level to n. On startup, a log file called there). All daemons on the host will write their debug and diagnostic messages to this file with a timestamp, daemon process id and arguments attached to the actual diagnostic. The debug and diagnostics levels are:

0

Lets the world know we’re alive — but nothing else.

1

Reports startup options.

ioland

to use the same

fixed tty

ioland

to 'meter' characters sent to

/etc/ioland.lg

pseudotty

). The syntax for using this

is created (if not already

72

2

Reports connection and disconnection events.

Other Devices Setup

4

Reports numbers of characters being sent/received.

8

Displays data written to the client process.

16

Displays data written to IOLAN+.

32

Reports telnet negotiations.

64

Displays data read from IOLAN+.

128

Displays data read from the client process.

Adding the desired level numbers together can combine these levels. Care should be taken when a high debug level is set because the log file could grow too large.

-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<n>

Network connection timeout option. The daemon will try for

n

seconds to establish a TCP connection after which time it will abort and discard any pending data. The default is to try forever.

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 process. Normally, the debug level is set to a minimal level such as three.

getty

running as the client

73

IOLAN

+

- User and Administration Guide

8.3 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.

On some systems such as SunOS, XENIX and AIX a break received from the peripheral is not passed to the client properly. If the client wishes to make the break act like an interrupt key (i.e. when the stty options are set) then this can be achieved by setting the on the IOLAN+

On SunOS, if a terminal then the login prompt may be corrupted on the screen but this goes when the user name is typed in. The UUCP command Solaris 2.1 (Intel).

Some systems may not properly propagate the SIGHUP signal associated with the

Port Setup Menu

getty

is the client process running to a

uucico

may not work with ioland on

-h

option.

ignbrk

to ‘Brkintr’.

and

Break

brkintr

field

74

The Menu Interface 9

This section describes the menu system and the fields within them. Bounce around the menu system to get your bearings. All of the menus are covered and referenced in this section.

The Menu Interface

9.1Menu Commands

Command Descriptions

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 various fields. Pressing following exit menu.

---------------

Figure 28: Commands - Exit pop-up menu.

The following describes these options:

Save and Exit

Quit and Exit

All changes to the menu screen are saved and the user is returned to the next higher level screen.

The user is returned to the higher level screen and any changes are ignored (i.e. nothing is saved).

key is used to move around the

will usually bring up the

---------------

Values

Cancel

Certain data fields take only a fixed range of values (e.g. bps rates, number of stop bits, etc.). When this command is selected, it displays those values.

Cancels the returns to current menu for additional editing.

Command Options

window and

75

IOLAN

+

- User and Administration Guide

Pressing cancels the Command Options window (works the same as between the special fields and keys.

Cancel

). Other than mastering the difference

key and , there are several other

Toggle fields

Fast keys

9.2 Connections Menu

Some data fields have a set of acceptable values. An example of this is the bps rate setting. To alter the value displayed in these fields press the space bar. The option on the commands pop-up menu can also be used.

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 accessed via fast keys. These are listed in the following:

Telnet Make a Telnet connection

Rlogin Make an Rlogin connection

Port Enter the Port Setup Menu

Admin Enter the Administration menus

Logout Log out of the Server

Stats Enters the statistics screens

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).

Connections Menu

Values

can be

76

The Menu Interface

Connection Host

1 *** FREE ** === Commands ===

________________________________________________________________________________

This option allows you to configure parameters affecting

IOLAN+RACK v4.01 a CDi IOLAN+

the Server box, eg hosts table, other terminals.

Figure 29: Commands pop-up menu (for Connection Menu).

Pressing at any of the four

Commands Rlogin

and The

pop-up menu. If it was not free, the

fields would have been replaced by

Resume connection

*

** FREE ***

message would be replaced by the name or

FREE

fields presents the

Telnet

and

Close connection

signifying there is a session present.

IP address of the connected host.

The following describes the options that can appear in the above menu:

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 open command, but uses the While

Telnet

is the most commonly used protocol,

Rlogin

can also be used (especially over WAN

connections because

Rlogin

packets are smaller).

Telnet

protocol.

77

IOLAN

+

- User and Administration Guide

Resume Connection

Close Connection

Port

Admin mode

CLI

Lock

This option only appears if there is a current connection open. It allows you to carry on working on a host.

This option also appears only if the current connection is open and will close the session on a host machine. It is recommended to logout before closing the connection.

This allows users to change the characteristics of their serial port. See of this chapter.

This takes the user into the

Menu

(s) (also covered in this chapter).

Selecting this function changes the port back into command line or CLI mode. To get back to the menus use More information on CLI is in

Interface

This function allows the user to lock the port they are on for security purposes. When this function is selected the user is prompted for a password then asked to verify it again. Once locked a port can only be unlocked by the successful entry of the password.

set menu

(Appendix A).

Port Setup Menu

section

Administration

from the CLI prompt.

Command Line

78

Logout

Note: If a user accidentally locks their port the Administrator can use the

Administration Menu

This function logs the user completely out of the IOLAN+. From the

also logs the user out of the system.

kill

command on the

to free the port.

Connections Menu

pressing

The Menu Interface

9.3 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.

** Administrator ** PORT SETUP MENU REMOTE-ADMIN Hardware Flow ctrl Keys Speed [9600 ] Flow ctrl [Hardware] Hot [^]] Intr [^C] Parity [None] Input Flow [Enabled ] Quit [^@] Kill [^U] Bit [8] Output Flow [Enabled ] Del [^@] Sess [^@] Stop [1 ] Echo [^@] Break [Disabled] IP Addresses Monitor DSR [No ] Src [ ] Mask [ ] Monitor DCD [No ] Dst [ ]

User Options Access Name [LPD_printer ] Keepalive [No ] Access [Remote ] Terminal type [ ] Rlogin/Telnet [Telnet] Authentication [None ] TERM [ ] Debug options [No ] Mode [Raw ] Video pages [0] Map CR to CR LF [No ] Connection [None ] CLI/Menu [Menu] Hex data [No ] Host [ ] Reset Term [No ] Secure [No ] Remote Port [0 ] MOTD [No ] Local Port [515 ]

Figure 30: Port Setup Menu.

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:

Speed

This field sets the baud rate of the port and can be set to the following values: 50, 110, 150, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400, 57600, 115200. The default setting is 9600.

79

IOLAN

+

- User and Administration Guide

Parity

Bit

Stop

Break

Disabled

Local

Remote

Brkintr

This field sets the parity of the port to even, odd or none. The default parity is

This sets the number of data bits that are used by the port from 5-8. The default is

This defines how many stop bits the port uses to either 1, 1.5, 2. The default is

This field determines how the IOLAN+ reacts to the break key being pressed on the terminal. There are four possible settings:

The IOLAN+ ignores the break key completely and it is not passed through to the host. This is the default setting.

The IOLAN+ deals with the break locally. If the user is in a session the break key has the same effect as a hot key (i.e. it returns the user to the

When a break key is pressed the IOLAN+ translates this into a telnet break signal which it sends to the host machine.

This mode operates in the same manner as the remote setting except that instead of generating a break signal the IOLAN+ generates an interrupt signal and sends it to the host.

Connections Menu

None

8

.

1

.

.)

.

80

Monitor DSR

Monitor DCD

This field specifies whether the RS-232 signal DSR (data set ready) should be monitored. This is used with modems. Default is

This field specifies whether the RS-232 signal DCD (data carrier detect) should be monitored. This is used with modems. Default is

No

.

No

.

The Menu Interface

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:

Name

Terminal type

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. If this field is left blank then a user is prompted for their user name before being given access to the communications server menus. This field is also passed to the host when using telnet or rlogin. Default is blank.

This field defines the type of terminal that is attached to this port. The possible values are undef (undefined), ansi, dumb, vt100, vt320, wyse50, wyse60, tvi925, ibm3151, vt320, falco, hp700. Press the space bar to toggle through these values. If none of these are applicable then the CLI mode can be used. When an rlogin connection is made, the unit passes this terminal type to the host machine. Default is blank.

TERM

Video pages

This field can contain up to 8 characters. If this field is filled in, IOLAN+ sends this string as the terminal type, instead of the field above. This allows the user to pass through IOLAN+ an unsupported terminal type or addition identity information for security. Default is blank.

This field defines how many video pages the terminal in question has. If this value is set greater than zero IOLAN+ uses the video pages on the terminal to allow it to refresh screens between session switching. Not all terminals support video pages (mainly Wyse 60’s). Default is

0

.

81

IOLAN

+

- User and Administration Guide

Flow Control

CLI/Menu

Reset Term

This section defines the various flow control options used by IOLAN+. This section is always used. The parameters are:

Flow Ctrl

This field defines whether IOLAN+ is using the CLI or the menu interface. If the terminal is configured for menu interface but the terminal type is undefined or dumb, then the unit remains in the CLI. Default will be This field defines whether the terminal type should be reset when a user logs out. This is a very useful feature when the port is connected to a modem. When a user logs out of IOLAN+ it resets the terminal type to dumb, so the next person starts off in CLI mode and is able to set the terminal type correctly. Default is

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 C, WANG is a special option designed for WANG terminal flow control applications. The default is to use

XON/XOFF

Cabling Guide

.

Menu

No

.

).

82

IP address

Input Flow

Output Flow

This section of the menu deals with remote access and modem sessions only. The parameters are as follows:

Src

This field allows you to define if the input flow control is to be used. Default is

This field allows you to define if the output flow control is to be used. Default is

This is the source IP address of the port for PPP/ SLIP connections. If blank, the IOLAN+ IP address is used.

Enabled

.

The Menu Interface

Options

Dst

Mask

This section of the menu deals mainly with the telnet options and is the least used. Most of these options default to

Keepalive

Rlogin/Telnet

Debug options

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. If the

secure

field on the

can be overridden by the incoming host.

This is the subnet mask which controls the range of IP addresses accessible from the port (when using remote access).

This option specifies whether IOLAN+ should send keepalive messages to the host machines it is connected to. Default is

This field specifies which of the two options should be listed first in the Default is

This field defines whether the telnet options processing should be displayed and is used for troubleshooting. Default is

telnet

.

Port Menu

No

.

Commands

No

.

is No, this

No

.

menu.

Map CR to CR LF

Hex data

Secure

This field defines whether the IOLAN+ will add a line feed to every carriage return on data going out to the serial port. Default is

When this field is set to Yes, IOLAN+ displays all of the data it receives on this port in hex format as well as in ASCII. This is used for troubleshooting. Default is

Specifies the level of security to be applied to the port in question. There are four selectable values. Default is

No

.

No

.

83

IOLAN

+

- User and Administration Guide

Keys

No

Yes

LAN

WAN

MOTD

This section defines the various accelerator keys that IOLAN+ responds to. This section is optionally used. The parameters are as follows:

Access to the administration mode is enabled from this port. Port will accept IP addresses.

Access to administration mode is disabled for this port. Port will reject IP addresses.

Access to administration mode is disabled and dial-in access via PPP/SLIP is disabled. Local network access commands telnet, rlogin and connect are enabled.

Access to administration is disabled and local network access commands, telnet, rlogin and connect are disabled. Dial-in access via PPP/ SLIP is enabled.

This yes/no option specifies whether a message of the day is to be displayed to the user before logging on to the port. The actual text of the message is a file on the boot host (see

Configuration

Menu)

Server

84

Hot

Intr

Quit

This is the key used to escape from a host connection back to the IOLAN+

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

This is a user-definable interrupt key. When selected IOLAN+ generates a telnet ‘interrupt process’ signal to the remote host. The default is

^C

.

This field defines the character that generates a telnet BREAK across the network. Default is

Connection

^]

.

^@

.

The Menu Interface

Del

Kill

Sess

Echo

This field defines the character that generates a telnet erase character signal across the network. In addition, this key can be used to ‘reprogram’ the interpretation of the <left-arrow> key when operating in the menu mode. If the users terminal generates the same key sequence for <Left-Arrow> and <Backspace>, then setting this key to Ctrl-H (^H), causes the <Left-arrow> and <Backspace> keys to be treated as ‘delete the last character typed in’. Default is

This field defines the character that generates a telnet erase line signal across the network. Default is

This key allows users to switch directly from one session to another without going back through the server menus. This key should be followed immediately by the session number the user wishes to go to. For example, if this key is set to Ctrl-F and you want to switch to session 2, press

Ctrl-F2

If this key is given a value then any active telnet session on that port can toggle between local and remote character echoing done by IOLAN+ or by the remote host. Default is

^U

.

. The default value is ^@.

^@

.

Note: Each of the keys can be set as a single character, or as a control character. To set the key as a control character the symbol ‘^’ should be used followed by the relevant key. Alphabetic characters should be specified in upper case. To disable a particular key the user should enter

^@

in the field.

85

IOLAN

+

- User and Administration Guide

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:

Access

Local Remote

Dynamic

This field defines the type of service that is operating on this port. Default is

This is the normal setting for terminals/PCs.

This setting indicates IOLAN+ should be listening on the ethernet for connections from a remote host. The TCP port for the communications server to listen on, must be entered in the should be used for printers, dial-out modems and reverse telnet connections.

This setting should be used for dial-in/dialout modems. This setting is a combination of the local and remote settings. The communications server listens both on the serial port for incoming characters and on the network for incoming connections. When it gets either, it behaves as the appropriate type of connection until that session is terminated, whereupon it goes back to listening again.

Local Port

Local

.

field. This setting

86

SLIP PPP

Listen

None CSLIP

This will set the port into SLIP mode.

This setting puts the port into a dedicated PPP line.

This setting is similar to DTR/RTS will only be raised once a network connection is establish.

Sets port to disabled.

This setting puts the port into dedicated CSLIP status.

Remote

, however,

The Menu Interface

Authentication

None Local

Host

Both

This field defines how a user logs in. Default is none.

This sets authentication off.

This forces the incoming user to enter the IOLAN+ login authentication password (same password for all ports).

This is full authentication requiring a user ID and password that will be checked against a designated authentication host.

This provides two levels of security with

Local

Mode

Connection

This field defines whether the connection is or

telnet

connection. Setting the mode to to do the connection. This should be set to and LPD printing & modem connections, and be set to

This field defines whether the user has access to multiple connections or only a single connection, and the level of control the user has over these connections.

authentication first, then

. A

raw

connection is a straight TCP

Host

telnet

negotiations with a network

telnet

for reverse telnet connections.

raw

for RCP

.

raw

causes it

None

IOLAN+ does not try to initiate any connections. The user has full control and access to all 4 sessions. This is the default.

87

IOLAN

+

- User and Administration Guide

Preferred

Dedicated

Initiated

Host

IOLAN+ makes an immediate connection to the indicated host machine and port number. The

Host, Remote

filled in. Although the user is connected to a designated host, the user can hot key from this connection to the unit. This allows a user to configure the system so that they always log into one machine, but still have the option of connecting to others.

IOLAN+ makes an immediate connection to the indicated host and port number. The user is limited to only a single connection to the indicated host, and can not hot key back to the IOLAN+ menus. The and

Mode

This setting is similar to the connection, but requires the user to enter the return key before initiating a connection. It is widely used for terminal/PC connections.

This field defines the remote host to be connected to. Either a host name or an IP address may be used. If a name is entered it must be in the host table. Default is blank.

and

Mode

fields must be

^]

Host, Remote

fields must be set properly.

Dedicated

back

88

Remote Port

Local Port

This field defines the remote TCP port number for IOLAN+ to connect to. Use port number 23 for

telnet

and 513 for

This field defines the local TCP port for IOLAN+ to listen on. The port default to 10000 plus the number of the port.

rlogin

. Default is 0.

9.4

Administration Menu

The Menu Interface

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.

ADMINISTRATION MENU REMOTE-ADMIN

gateway Examine/modify gateway table. host Examine/modify host table. line Terminal configuration organised by line. password Specify password to allow modification of menu items. port Terminal configuration organised by port. quit Return to connections menu. server Examine/modify Server parameters. stats Examine Server statistics.

________________________________________________________________________________

Figure 31: Administration Menu.

The parameters are as follows:

gateway

Selecting this field allows the user to view the

Gateway Menu

host

Selecting this field allows the user to view the

Host Address Menu

line

Selecting this field takes the user to the up menu used for viewing port configurations.

password

Selecting this field allows the user to enter the administrator’s level where changes can be made. Default password is

port

Selecting this field allows the user to view the

Setup Menu

as previously described. The user is

prompted for the port number to be configured.

quit

Selecting this field takes the user back into the

Connections Menu

used for routing.

used for local naming.

iolan

.

Lines

pop-

Port

89

IOLAN

+

- User and Administration Guide

server

stats

Selecting this field allows the user to view the IOLAN+

Configuration Menu

.

Selecting this field allows the user to view the IOLAN+

Statistics

screens.

Once the user has entered administration mode the display changes slightly to indicate this.

** Administrator ** ADMINISTRATION MENU REMOTE-ADMIN

access Remote System Access (PPP). change Change login and/or admin password. gateway Examine/modify gateway table. host Examine/modify host table. kill Kill TCP connections on serial line. line Terminal configuration organised by line. port Terminal configuration organised by port. quit Return to connections menu. reboot Reboot Server. server Examine/modify Server parameters. stats Examine Server statistics. trap Examine/modify SNMP Trap parameters.

________________________________________________________________________________

Figure 32: Administration Menu (password level).

This allows the user access to some extra features as follows:

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.

90

change

kill

reboot

Selecting this field takes the user into the

Password

pop-up menu. The user has the option

of altering the admin, login or logger passwords.

Selecting this field allows the administrator to reset any serial port. The administrator is prompted to enter the port number and press .

Selecting this field allows the user to reboot IOLAN+.

The Menu Interface

9.5 Access Menu

Remote Access Sites

trap

Selecting this field will take the user into the SNMP trap function menu.

The

Access

section deals with remote access sites, devices and the authentication and logging parameters. The initial pop-up window is as follows:

* Administrator ** ADMINISTRATION MENU REMOTE-ADMIN

access Remote System Access (PPP). change Change login and/or admin passw ========= Access ==========

quit Return to connections menu. reboot Reboot Server. server Examine/modify Server parameters. stats Examine Server statistics. trap Examine/modify SNMP Trap parameters. ________________________________________________________________________________

Figure 33: Access menu for Remote System Access.

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:

** Administrator ** REMOTE ACCESS SYSTEMS SCREEN REMOTE-ADMIN

Sitename [ ] User name [ ] Password [ ]

Device type [ ] Service type [SLIP ] Inactivity [1 ]

Phone number [ ] Login-script [ ]

Figure 34: Remote Access Systems Screen.

91

IOLAN

+

- User and Administration Guide

The parameters are as follows:

Sitename

User name

Password

This is the IP name or IP address of the remote site IOLAN+ will be calling.

This is the user name required by the remote system for logging in. You may use the your login script in lieu of the full name.

This is the above user name’s password as required by the remote system. You may use the

\p

Device type

Service type

Inactivity

This is the name of the modem device as defined in the may have several ports setup with the same device type, and the dialer daemon will use the first available. If a device for dialing out is not available, IOLAN+ will return an ICMP ‘host unreachable’ message (ICMP type 3 code 1).

This specifies which protocol will be used when the link is established to the remote site. Choices are SLIP, CSLIP or PPP.

This is the period of inactivity on the SLIP/PPP link before the port will drop the call automatically. Setting this field to 0 turns the timeout feature off.

\u

in

in your login script in lieu of the full password.

Remote Site Devices

screen. You

92

Phone number

Login-script

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.

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. If no script is defined, this step is skipped (e.g. hardwired connections).

The Menu Interface

Remote Site Devices

Like the

Devices Screen

Remote Access Systems Screen

, the

also first comes up with UNUSED ENTRY

Remote Site

(each corresponding to a port, 1 through 8 or 1 through 16).

** Administrator ** REMOTE SITE DEVICES SCREEN REMOTE-ADMIN

Type [Netchasr]

IP Addresses Src Addr [ ] Dst Addr [204.17.209.212 ]

Modem Config [at ] Dial Comm [atdt ] Hang Up [+++ath0 ]

PPP Configuration Dialer Configuration Restart timer [1 ] Dial Timeout [25] Max Retries [5 ] Dial Retries [2 ]

Inactivity [0 ]

________________________________________________________________________________

Figure 35: Remote Site Devices Screen.

The parameters are as follows:

Type

This is the name of the modem assigned to a specific port. It is referenced from the

Access Systems Screen

in the

Device type

Remote

field.

Scr Addr

Dst Addr

This is the source IP address of the port for remote access/modem configuration. If blank, the IOLAN+ IP address is used.

This is the destination IP address of the port for remote access/modem configuration. If blank, the remote host must supply the IP address. If filled in, you designate an assigned IP address to loan the remote host. If the Port Menu is

No

, this can be overridden by the

secure

field on the

incoming host.

93

IOLAN

+

- User and Administration Guide

Authentication/ Logging

Config

This is the modem’s setup string. There are a few examples at the end of this document. Note: Leave this field blank for directly connected devices.

Dial Comm Hang Up Restart timer

This is the modem’s dial command.

This is the modem’s hang up command.

Amount of time in seconds before IOLAN+ retransmits PPP options.

Max Retries Dial timeout

Number of option retries before dropping the line.

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.

This section outlines the authentication and logging parameters of IOLAN+.

** Administrator ** HOST AUTHENTICATION AND LOGGING REMOTE-ADMIN

Auth Host [204.17.209.1 ] Authentication Port [23 ] Login Prompt [ogin: ] Password Prompt [ssword: ] Success Indication String [Last ] Failure Indication String [incorrect ]

Maximum Login Attempts [3 ] Login Timeout (seconds) [60] Disconnect Probe [No ]

Log Username [iolan ] Log File [iolan.log ]

Log Power Up/Down [Yes] Log User Login/Logout [Yes] Log Port Connect/Disconnect [Yes] Log User Service Start/Stop [Yes]

________________________________________________________________________________

94

Figure 36: Host Authentication And Logging menu.

Chase Research IOLAN+, IOLAN+Rack User And Administration Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

Introduction

1.3 Getting Support

Hardware Description

Software description

1.5 Packing List

2.5 The Menu System

2.6 Tips

Terminals on Multi-user Systems

3.2 Host Table Setup

3.4 Tips

Setting up Dial-in Modem Ports

4.4 Client Login

4.5 Tips

Modem Authentication & Logging

5.2 The Host

5.3 Logging

5.4 Tips

Dial-out Modem Ports Setup

6.2 The Host

6.3 Routing

6.6 Tips

Printing

7.3 Using RCP

Other Devices Setup

reverse telnet

The Menu Interface

Access