[Home]

Stallion EasyServer II


The EasyServer II is the more up-to-date version of the EPS terminal server from Stallion. It comes in 8 and 16 port versions.

Notes: Main bootp server in the examples below is 192.168.1.1
  Assigned IP address for the port server is 192.168.1.92


Terms Used

The following terminology is used within the Communications Server documentation, online help and online tutorial.
Host
Is a computer system attached to the network.
Node
Is any intelligent device directly connected to the Ethernet such as a host, an Ethernet printer, or a communications server and has their own Ethernet address. Devices connected to the communications server serial ports are not nodes.
Service
Is anything you can connect to, either locally or across the network.
Session
Is a logical connection to a service such as a terminal connected to a host through the communications server.

Setup

  • Connect up port 1 to a spare serial port set to 9600 baud.
  • Hit return a few times to get the EasyServer Console text.

    1. Allocate an IP address to the EasyServer II

      • Set a bootp address:
        See guide to bootp for more information on making sure tftp and bootp are running.

        Add an entry to /etc/bootptab for the Terminal Server e.g.

         easys:\
        	:ht=ether:\
        	:ha=00.60.1F.00.17.67:\
        	:sm=255.255.255.0:\
        	:hn:\
        	:ip=192.168.1.92:
        
        Add an entry to /etc/hosts for the address e.g.
          192.168.1.92  easys
          

        Hit return a couple of times to allow the Console to check bootp again you should see the address and the Server Ready prompt.

        If that fails you can enter an IP address manually. However, the automatic configuration option to load a configuration file cannot be used.
      • Login as anyone, to go into privileged mode use:

        set privileged (Password is system)

        Test the network connection with the command:

        test internet 192.168.1.1

        You should see:

        Local 1> set  privileged
        Privilege password: 
        Local 1>> test  internet 192.168.1.1
        
        PING 192.168.1.1: 72 data bytes ...
        80 bytes from 192.168.1.1: icmp_seq=1. time=20. ms
        80 bytes from 192.168.1.1: icmp_seq=2. time=20. ms
        80 bytes from 192.168.1.1: icmp_seq=20. time=20. ms
        ....
        
        20 packets transmitted, 20 packets received, 0% packet loss.
        round-trip (ms)  min/avg/max = 20/20/20
        
        Local 1>> 
        

    2. Set the basic configuration.

      • You can administer the configuration from any web browser. Once the IP address has been assigned point a browser at http://{IP ADDRESS OF Easy Server}.

        All the help and manuals etc. are available via the browser as html pages.

        Remember, OSR 5.0.x comes automatically with Mosaic, OSR 5.0.4 also includes netscape You can use ANY PC on the network that has a browser
        If you need on remotly and can't get a PPP connection working there is always lynx.

        Admin name for the Setup and Diags options are root with a password of system

      • Telnet to 192.168.1.92 and administer over the network.

      • Use the serial connection to port 0 setup earlier.

      Note: While you normally setup all the options via the above methods it is a good idea to save all the settings so if the unit is replaced or the settings get scrambled - this uses the tftp utility (make sure you enable it in inetd.conf)

      Setup the Configuration file /tftpboot/ESII-8.CFG and include the settings for the ports using the examples below as a guide. For full details see later on in this guide.

      Add to this file all the settings required, these will be reloaded automatically when the Terminal Server Starts Up.

      Add in a hosts entry to save remembering names.

      SET INTERNET HOST  xanth ADDRESS 192.168.1.1
      

      Really Basic setup:

      Example 1: A terminal on port 3 set to 38400

      DEFINE PORT 3 Autobaud DISABLED
      DEFINE PORT 3 TERMINAL ansi
      DEFINE PORT 3 SPEED 38400
      DEFINE PORT 3 STOP BITS 1 
      DEFINE PORT 3 DEFAULT PROTOCOL TELNET
      DEFINE PORT 3 DEDICATED xanth
      
      Example 2: A serial printer on port 3 set at 1200 baud
      (Note for the Listener port numbers use 2000 + port number e.g. for port 3 use 2003, port 16 use 2016 )

      DEFINE PORT 3 SPEED 1200
      DEFINE PORT 3 ACCESS Remote
      DEFINE PORT 3 TELNET SERVER NEWLINE FROM TERMINAL <LF>
      DEFINE PORT 3 TELNET SERVER NEWLINE TO HOST <CRLF>
      DEFINE TELNET LISTENER 2003 CONNECTIONS ENABLED PORTS 3 ENABLED RAW MODE ENABLED
      DEFINE TELNET LISTENER 2003 IDENTIFICATION "Label Printer"
      
      See setting up a printer below for details on configuring Unix for a printer.

      Example 3: Specify tty

      This option predefines a port and associates it with one of the /dev/ptty entries in /dev.

      DEFINE PORT 3 SPEED 38400
      DEFINE PORT 3 ACCESS Remote
      DEFINE TELNET LISTENER 2003 CONNECTIONS ENABLED PORTS 3 ENABLED RAW MODE ENABLED
      
      Note: If setting up more than 4 devices this was make sure you spawn multiple svr_tty sessions via S88Easy to spread the load.

      See setting up the svr_tty daemon below for details on configuring svr_tty.

      Example 4: Standby Server

      DEFINE PORT 3 Autobaud DISABLED
      DEFINE PORT 3 TERMINAL ansi
      DEFINE PORT 3 SPEED 38400
      DEFINE PORT 3 STOP BITS 1 
      DEFINE PORT 3 DEFAULT PROTOCOL TELNET
      DEFINE PORT 3 PREFERRED xanth
      
      Now the user is asked to login to the server, (any old name will do) and at the Local> prompt open will connect to the preferred host while open machine will connect to the other machine.

      It should be possible to have the config file setup on two different machines in /tftpboot each set to connect to themselves. If tftp is disabled in inetd.conf then the default will be 1st machine. A simple script to change inetd.conf can be used to 'switch' servers.

      Example 5: Live System with ALL ports enabled as Wyse terminals.

      #
      # ESII-16 Configuration changes - extracted from server "ESII_00601F0005F2"
      #
      SET INTERNET HOST barker ADDRESS 192.168.2.7
      DEFINE SERVER NAME "easys"
      DEFINE SERVER STARTUPFILE ESII-16.CFG HOST 192.168.2.7
      #
      DEFINE PORT ALL Autobaud DISABLED
      DEFINE PORT ALL STOP BITS 1 
      DEFINE PORT ALL TERMINAL wy60
      DEFINE PORT ALL DEFAULT PROTOCOL TELNET
      DEFINE PORT ALL DEDICATED 192.168.2.7 
      DEFINE PORT ALL SPEED 19200
      
      Example 6:

      This will be added as we find new options, the above has just scratched the surface of these units.


    Saving The Settings

    Once you have all the setting correct, you can tell the Easy Server to output all the settings to a file on the host.

    Remote Host Redirection:
    Output is redirected to a remote host via TFTP (Trival File Transfer Protocol) and is usually placed in the /tftpboot directory. Before this can be done the file must already exist and must be writable by everyone.

    The LIST CHANGES and SHOW CHANGES commands displays all information that has been changed from the default settings. LIST displays permanent database changes, SHOW displays operational database changes.

    Syntax for displaying permanent database changes is:
             Local 1>> LIST CHANGES
         
    Syntax for redirecting permanent database changes is:
             Local 1>> LIST CHANGES > file_name HOST host_name
        
    You can also see changes for specific tables such as Account, Dialer, Internet, Server, Service, SNMP, System, Telnet Listener, and Port.
    Syntax for displaying specific permanent table information is:
             Local 1>> LIST CHANGES ACCOUNT
       
    The next example takes the output from SHOW SERVER and redirects it to the file "server" on the remote host "kong"
     
             Local 1>> SHOW SERVER > server HOST kong
    
    Local Port Redirection:
    You can attach a printer to a local port on the communications server and redirect information out to the printer if that the port is available and port access is set to either REMOTE or DYNAMIC.
             Local 1>> SHOW PORT ALL > PORT 6
    

    CREATE A DEFAULT CONFIG FILE

    If you determine your communications server's IP address from the network instead of locally, the communications server will attempt to find and down load the default config file /tftpboot/XXXX.CFG from its boot host. The "XXXX" represents the model number of your communications server. For example it may be ESII-8.CFG, LS-16.CFG, ESII-16.CFG, etc.


    PRINTERS - UNIX

    You can attach a printer to the communications server and make it available to users on the network in both the UNIX and VMS/LAT Environment.

    1. Telnet Listener Setup

      A telnet listener is a program that allows remote hosts to access devices such as printers and or modems on the communications server through a dedicated TCP (software) port.

      You must assign a telnet listener port number to the communications server serial port in which the printer is attached. Telnet listener port numbers range from 2001 to 2032.

      The port you are configuring must not be in use and you must be working on a port other than the one you are configuring.

      • Enter the following privileged commands for printers connected directly to the communications server or connected to a terminal that is connected to the communications server.
         CHANGE TELNET LISTENER tcp_port PORTS port_number ENABLED
         CHANGE TELNET LISTENER tcp_port IDENTIFICATION "id_string"
         CHANGE TELNET LISTENER tcp_port CONNECTIONS ENABLED
         CHANGE PORT port_number ACCESS REMOTE
         CHANGE PORT port_number TELNET SERVER NEWLINE FROM TERMINAL <LF>
         CHANGE PORT port_number TELNET SERVER NEWLINE TO HOST <CRLF>
        
      • Enter the following privileged command for a printer connected to a terminal that is connected to the communications server:
                 CHANGE PORT port_number TRANSPARENT PRINT ENABLED
        
    2. Unix LP Spooler Package setup

         /usr/local/lib/svr_print
         /usr/spool/lp/model/ESII  (also attached to end of guide)
      

      Add the printer as normal:

      The following commands show you how to setup a unique queue name for using the remote printer with the LP Spooler Package.

      When defining a printer, you give it a printer name, a printer interface file name (etc. standard, hp, citizen, ...) located in /usr/spool/lp/model and any additional parameters for your printer environment.

      • In the following commands replace PRINTERNAME with the name of LP Spooler queue (any unique name). Replace INTERFACE with the name of LP Spooler interface script (if unknown or not sure use standard.)
          # /usr/lib/lpadmin -p PRINTERNAME -h -v/dev/null -m INTERFACE
          # /usr/lib/accept PRINTERNAME
          # enable PRINTERNAME
          # cd /usr/spool/lp/admins/lp/interfaces
          # mv PRINTERNAME PRINTERNAME.if
        
      • Now copy the supplied EasyServer model file :
        # cd /usr/spool/lp/admins/lp/interfaces
        # cp /usr/spool/lp/model/ESII PRINTERNAME
        
      • Edit the interface file /usr/spool/lp/admins/lp/PRINTERNAME to specify the communications server's IP address (ipaddr) and the Telnet Listener's TCP port (tcpport).
      • To print a file on the remote printer type the following command.
                 $ lp -d PRINTERNAME filename
        

    Listing of: /usr/spool/lp/model/ESII

    ############################################################################
    #
    # svr_interface
    #
    #
    ############################################################################
    ipaddr=192.168.1.92
    tcpport=2003
    
    svr_print="/usr/local/lib/svr_print -n ${ipaddr} ${tcpport}"
    
    printer=`basename $0`
    interface=/usr/spool/lp/admins/lp/interfaces/${printer}.if
    
    request=$1
    user=$2
    title=$3
    copies=$4
    options=$5
    shift 5
    
    $interface "$request" "$user" "$title" "$copies" "$options" $* | $svr_print
    
    

    Using a 'fixed' tty number

    To setup a fixed connection between a port on a communications server and a /dev/ttypx device node, a TELNET LISTENER must be configured to listen on the port and the port is configured to have ACCESS mode of REMOTE. Please use HELP command to see exact command syntax and a explanation for the two commands shown below.

      CHANGE PORT port_number ACCESS REMOTE
      CHANGE TELNET LISTENER listener_port CONNECTION ENABLED RAW ENABLE
      CHANGE TELNET LISTENER listener_port PORT port_number ENABLE
    
    where the listener_port is recommended to be 2000 + port_number.

    Make sure the file /usr/local/bin/srv_tty is on the machine (included in the print files from the robot or on the BDS Utility CD).

    Create the file /usr/local/lib/svr.data and add in the devices you wish to map e.g.

    ptyp7 192.168.1.92 2003
    ptyp8 192.168.1.92 2004
    
    This shows /dev/ttyp7 is associated with port 3 (2003) on the terminal server 192.168.1.92, and ttyp8 on port 4.

    If this is going to be a terminal, create an entry in /etc/inittab (and /etc/conf/init.d/sio) for the speed etc.

    /etc/inittab

    Tom1:23:respawn:/etc/getty ttyp7 o
    
    Now create an script in /etc/rc2.d such as S88Easy, make sure it runs AFTER tcp/ip has initalised to launch copies of svr_tty.

    #!/bin/sh
    # 
    # Script to start Easy Server tty daemon
    
    /usr/local/bin/srv_tty /usr/local/lib/svr.data
    
    

    Testing and Diagnostics

    Network Test
    Tests the network connectivity between the communications server and specified host. PING and TEST INTERNET commands do the same thing.
    local> PING hostname
    local> TEST INTERNET hostname
    Serial Port Test
    Tests communications server serial ports output:
    Local> TEST PORT COUNT count WIDTH width
    Monitor Command
    The MONITOR command continuously displays current characteristics every three seconds. Refer to the documentation for MONITOR commands.
    Local>> MONITOR SERVER STATUS
    Reset Counters
    • Reset error and statistic counters:
      Local>> ZERO COUNTERS ALL
    • Reset internet related counters:
      Local>> ZERO INTERNET
    • Reset port related counters
      LOCAL> ZERO PORT port_list

    Diagnostic Output

    EasyServer II - monitor server counters
    
    ESII-16 Communications Server V5.1.1   Uptime:        2 days 21:31:03
    
    Ethernet:    00-60-1f-00-05-f2         Internet:          192.168.2.8
    Name:                    easys         Number:                      0
    
    Time Since Zeroed:                                    2 days 21:31:03
    Port Input Bytes:        61353         Port Output Bytes:    19877125
    Overrun Errors:              0         Framing/Parity Errors:       0
    
    Frames Received:        115806         Frames Transmitted:     175528
    Receive Errors:              0         Transmit Errors:             0
      CRC Errors:                0           16+ Collision Errors:      0
      Oversize Errors:           0           Output Queue Full:         0
      Short Frame Errors:        0         Transmit Collisions:         8
    Net Buffer Unavailable:      0         User Buffer Unavailable:     0
    
    EasyServer II - monitor port all counters
    
                 Receiver               Transmitter            Error Counters
    Port  Characters  Stop/Start  Characters  Stop/Start  Overrun  Parity  Framing
    ----  ----------  ----------  ----------  ----------  -------  ------  -------
      1         7121           0     1787961           0        0       0        0
      2            0           0           0           0        0       0        0
      3         7964           0     2722617           0        0       0        0
      4           81           0       21161           0        0       0        0
      5         8345           0     2894338           7        0       0        0
      6         8787           0     2180027           9        0       0        0
      7         3400           0     1710154           5        0       0        0
      8         1002           0      203668           0        0       0        0
      9          963           0      328845           0        0       0        0
     10         3862           0     1142799           0        0       0        0
     11         1925           0      470462           0        0       0        0
     12           27           0        7929           0        0       0        0
     13        12856           0     5296478           0        0       0        0
     14         5028           0     1114607           0        0       0        0
     15            0           0           0           0        0       0        0
     16            0           0           0           0        0       0        0
    
    Sum:       61361                19881046     Zeroed:           2 days 21:31:33
    
    EasyServer II - monitor telnet listener all status
    
    Listener  Status      Queued  Port  Host
    
        23    Listening    N/A
      2016    Listening    N/A
    
    EasyServer II - monitor internet counters
    
    TCP segments:                                                2 days 21:32:37
      Transmitted:              175611     Bytes Transmitted:            7135728
        Data:                    59283       Bytes Data:                  110752
        Data Retransmitted:          1       Bytes Data Retransmitted:         4
      Received:                 115117     Bytes Received:              24488953
        Data:                   115117       Bytes Data:                24488953
        Errors:                      0
    
    IP packets:                            Internet Connections:
      Packets Transmmitted:     175740       Requested:                      113
      Packets Received:         115952       Accepted:                        20
      Fragments Received:            0       Established:                    133
      Fragments Dropped:             0       Closed:                         114
      Error in Header:               0       Dropped:                          0
    
    ICMP Messages:                         UDP Datagrams:
      Transmitted:                   0       Transmitted:                      2
      Received:                      0       Received:                       835
      Dropped:                       0       Dropped:                        833
      Destination Unreachable:       0       Error in Header:                  0
    

    Comments and suggestions always welcome -
    tom@tkrh.demon.co.uk