Knowledgebase

Issue:

How to configure Ioland with a Jetstream terminal server.

Solution:

Ioland can be used to provide local tty connections to the Xstream servers. Full Ioland functionality is not supported when used with an Xstream terminal server. No IOCTL can be passed to the Xstream line by the Ioland devices, so hardware configuration is fixed based on the Xstream line.

Ioland works on a TCP/IP sockets connection from the host server to the terminal server port.  The terminal server port is assigned a tcp/ip socket number and set to accept an incoming socket connection.

XStream Configuration

Set the line to a service of reverse raw with a JS Port number above 1024. 
Serial settings need to be set to match the serial device [speed, flow, bits, parity and stop].
All other parameters will not be used.

Here is an example line configuration for a 9600 terminal.
 Service = Reverse Raw
 JS Port = as configured in Ioland

        lqqqqqqqqqqqqqqqqqqqqqqqqqquline 1 tqqqqqqqqqqqqqqqqqqqqqqqqqqk
        x        service[rev raw]                                     x
        x                                                             x
        x          speed[9600  ]           terminal[      ]           x
        x           flow[none]                pages[4]                x
        x           bits[8]                    user[                ] x
        x         parity[none]             hostname[              ]   x
        x           stop[1]               host port[23   ]            x
        x                                  JS port[10001]             x
        x                                                             x
        x           dial[none ]          modem name none              x
        x   phone number[                                ]            x
        x                                                             x
        x     idle timer[          ]  session timer[          ]       x
        mqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqj

In this example Line 1 was configured for JS Port 10001. The other ports will be incremented consecutively ie Line 2 = 10002.
After making changes make sure to Kill the line to reset the changes (or Save and Exit then reboot).

Through the command line (the default line settings are speed=9600, flow=none, bits=8, parity=none, and stop=1):
example:
LS_2000# set line 1 service reverse raw 10001 flow soft
LS_2000# set line 1 service reverse raw 10002 flow soft
LS_2000# kill line 1
LS_2000# kill line 2
LS_2000# save
save config to flash ROM y/n y
saving to flash ROM. This may take several seconds. Please wait...
LS_2000#

Ioland Configuration

Ioland is an executable binary that can be started by running the binary with the command line switches, through a manually edited config file.

To manually create the configuration add entries to the /etc/ioland.cf configuration file.
First create a host entry for the terminal server in the /etc/hosts file or use the IP address.

Edit the /etc/ioland.cf file and add an entry for each ioland daemon connection:

example:
 -p -o js4000 10001 js1
 -p -o js4000 10002 js2

-p = the daemon maintains a continous TCP connection to the terminal server port.
-o = do not close slave device

When the Ioland binary is run without any parameters it will read the ioland.cf file and start the daemon processes. In the above example the local devices will be /dev/js1 and /dev/js2.

Telnet Mode

If you wish to use the -T (telnet mode) option of ioland then you must change the service used on the Xstream line to Reverse Telnet.

You can start ioland from the /etc/inittab file. Ensure you start ioland before any getty processes.
example
 i:2345:wait:/[path]/ioland_rh6.2

Or you can start ioland from the system initialization
example
 add an entry to the /etc/rc.d/rc.local file
  /[path]/ioland_rh6.2

For logins on dumb terminals, make an entry in the /etc/inittab file:
example
 js1:2345:respawn:/sbin/agetty -L 38400 js1 wy60
 js2:2345:respawn:/sbin/agetty -L 9600 js2 vt100

Fixed TTY configuration

This causes Ioland to use the same pseudotty each and every time. Note: not all configurations requires the use of a fixed psuedo tty.
Before starting the find the numbers of the ptyp master devices available.  The devices will be in the /dev directory and will have the format pty.
e.g.
 /dev/ptyp1 id=p1

The slave devices have a similar format:  tty
e.g.
 /dev/ttyp1 id=p1

For the fixed tty configuration in this example use the iolandft8_rh5 files from the latest distribution.
 #./iolandft8_rh5

Ensure the terminal server host name is in the Linux host table or use the IP address

Edit the Ioland configuration file /etc/ioland.cf :

-F [options]

example
 -F -p -o js4000 10003 ptyp3 ttyp3
 -F -p -o js4000 10004 ptyp4 ttyp4

Once the ioland command has been run, the /dev/ttyp3 and /dev/ttyp4 devices becomes available.