EtherLite32
The number of EtherLite32 terminal servers are installed to provide serial connections to ROCs, IOCs, network switches and other devices.
RHEL installation
su cd /usr/local/src cp /usr/downloads/realport1.9-36_81000137_X.tgz . tar xvfz realport1.9-36_81000137_X.tgz cd dgrp-1.9 ./configure make all make install make postinstall
- add following line to /etc/sudoers:
%onliners ALL=NOPASSWD:/usr/bin/dinc
- This package includes several support utilites:
ditty - an stty replacement. dinc - a cu/tip replacement.
- There is a package of configuration tools provided that are, by default, located in the /usr/bin/dgrp/config directory. There are scripts for using the command line to add and remove products, as well as the RealPort Manager. This is essentially a graphical front end for the scripts and a visual tool for monitoring individual serial ports. Run dgrp_gui to add terminal servers to the list of active devices: click 'Add' and fill in 'RealPort ID'. 'IP Address or Name' and 'Number of Ports' fields, for example type '0d', 'etherlite10', '32'. Click 'Commit', 'Run it' and 'Exit'. New line with shows up, status must be 'Ready' if terminal server is active.
- The software package includes two startup scripts in either the /etc/rc.d/init.d or /etc/init.d directories named "dgrp_daemon" and "dgrp_ditty". These scripts will be executed at startup automatically if the "chkconfig" tool is present on the system during the post installation phase of the driver install. Otherwise, these scripts must be manually added to the system startup.
- To load and initialize the driver by hand, execute "dgrp_daemon start". To stop the driver daemons and unload the driver, execute "dgrp_daemon stop" followed by "rmmod dgrp".
NOTE: if terminal server does not boot on power recycle, use command 'dgipserv' as described below.
NOTE: 'tsconnect' command is used to access devices, config file is $CLON_PARMS/tsconnect/tsconnect.conf.
Solaris era info
Software
RealPort software must be installed to communicate with EtherLite terminal servers. Do following as 'root' (tar file contains files downloaded from http://www.digi.com):
cd /usr/local/src cp ../downloads/EtherLite32.tar . tar xvf EtherLite32.tar rm EtherLite32.tar cd EtherLite32 pkgadd -d realport_2.8.3.pkg
Last command will initiate following dialog and output (empty lines removed):
The following packages are available:
1 realport Digi RealPort Driver
(sparc/i386) 2.8.3
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]:
Processing package instance <realport> from </usr/local/src/EtherLite32/realport_2.8.3.pkg>
Digi RealPort Driver(sparc/i386) 2.8.3
--------------------------------------------------------------------
Copyright (c) 1996-2005 Digi International Inc. All Rights Reserved.
This software contains proprietary and confidential information
of Digi International Inc. By accepting transfer of this copy,
Recipient agrees to retain this software in confidence, to prevent
disclosure to others, and to make no use of this software other
than that for which it was delivered. This is an unpublished
copyrighted work of Digi International Inc. Except as permitted
by federal law, 17 USC 117, copying is strictly prohibited.
--------------------------------------------------------------------
Using </> as the package base directory.
## Processing package information.
## Processing system information.
WARNING: setting mode of </dev/dpr> to default mode (755)
WARNING: setting mode of </dev/dty> to default mode (755)
WARNING: setting mode of </opt/realport> to default mode (755)
WARNING: setting mode of </opt/realport/amd64> to default mode (755)
WARNING: setting mode of </opt/realport/i386> to default mode (755)
WARNING: setting mode of </opt/realport/include> to default mode (755)
WARNING: setting mode of </opt/realport/sparc32> to default mode (755)
WARNING: setting mode of </opt/realport/sparc64> to default mode (755)
WARNING: setting mode of </opt/realport/utils> to default mode (755)
9 package pathnames are already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation of <realport> [y,n,?] y
Installing Digi RealPort Driver as <realport>
## Installing part 1 of 1.
/etc/rc2.d/S76realport <symbolic link>
/opt/realport/S76realport
/opt/realport/amd64/dgipserv
/opt/realport/amd64/digi_realport
/opt/realport/amd64/ditty
/opt/realport/amd64/dpa-rp
/opt/realport/amd64/ncx_debug
/opt/realport/amd64/ncx_devices_exist
/opt/realport/amd64/ncx_make_links
/opt/realport/amd64/ncx_mknod
/opt/realport/amd64/ncxd.Z
/opt/realport/dgipserv.1
/opt/realport/ditty
/opt/realport/dpa-rp
/opt/realport/drpadmin
/opt/realport/i386/dgipserv
/opt/realport/i386/digi_realport
/opt/realport/i386/ditty
/opt/realport/i386/dpa-rp
/opt/realport/i386/ncx_debug
/opt/realport/i386/ncx_devices_exist
/opt/realport/i386/ncx_make_links
/opt/realport/i386/ncx_mknod
/opt/realport/i386/ncxd.Z
/opt/realport/include/stdigi.h
/opt/realport/install_notes.txt
/opt/realport/ncxd
/opt/realport/release_notes.txt
/opt/realport/sparc32/dgipserv
/opt/realport/sparc32/digi_realport
/opt/realport/sparc32/ditty
/opt/realport/sparc32/dpa-rp
/opt/realport/sparc32/ncx_debug
/opt/realport/sparc32/ncx_devices_exist
/opt/realport/sparc32/ncx_make_links
/opt/realport/sparc32/ncx_mknod
/opt/realport/sparc32/ncxd.Z
/opt/realport/sparc64/dgipserv
/opt/realport/sparc64/digi_realport
/opt/realport/sparc64/ditty
/opt/realport/sparc64/dpa-rp
/opt/realport/sparc64/ncx_debug
/opt/realport/sparc64/ncx_devices_exist
/opt/realport/sparc64/ncx_make_links
/opt/realport/sparc64/ncx_mknod
/opt/realport/sparc64/ncxd.Z
/opt/realport/utils/dgipserv
/opt/realport/utils/ncx_debug
/opt/realport/utils/ncx_devices_exist
/opt/realport/utils/ncx_make_links
/opt/realport/utils/ncx_mknod
/opt/realport/utils/ncx_verify_conf
/usr/sbin/dgipserv <symbolic link>
/usr/sbin/ditty <symbolic link>
/usr/sbin/dpa-rp <symbolic link>
/usr/sbin/drpadmin <symbolic link>
/usr/share/man/man1/dgipserv.1
/usr/share/man/man1/ditty.1
/usr/share/man/man7/realport.7
[ verifying class <none> ]
## Executing postinstall script.
Using / as package base directory...
Unloading previous versions of drivers, if any.... Done
Loading new drivers...Nov 22 14:53:37 clon10 digi_realport: Digi RealPort Driver (Instance 0) Ver 2.8.3
Done
Run the drpadmin tool to add realport devices
Installation of <realport> was successful.
Copy several files to /opt/realport:
cp dflush /opt/realport cp dinc /opt/realport
NOTE: 'dinc' was copied from old CDsts driver, it seems digi does not have it any more, but we found it useful: 'tsconnect' will use it. IMPORTANT: make sure that 'dinc' is '-rwsr-xr-x', it can be set by 'chmod 4755 dinc'; otherwise 'Permission denied' message will be generated by tsconnect (something related to the uucp).
To configure EtherLite devices, run 'drpadmin' command and specify devices one by one, for example:
clon10:EtherLite32> /opt/realport/drpadmin Please select an option (a)dd (d)elete (s)how (r)eset (q)uit : a Enter the IP address or network name of the unit: 129.57.167.208 Enter the number of ports: 32 Enter the tty device ID (only 2 chars allowed) : 0 Would you like this RealPort session to be encrypted? NOTE: Not all RealPort products support encrypted RealPort sessions. Please check your RealPort product's firmware release notes or product literature before selecting "always". If in doubt, select "never". (always/never) : (never): The following device will be configured, 0 129.57.167.208 32 0 secure (never) Is this correct (y to add or x to abort) ? y Please select an option (a)dd (d)elete (s)how (r)eset (q)uit : q clon10:EtherLite32>
Results will be saved in /opt/realport/drp.conf file. After all devices configured this file will contains something like following:
clon10:realport> more drp.conf 0 129.57.167.208 32 0 771 never 1027 1 129.57.167.215 2 1 771 never 1027 2 129.57.167.209 32 2 771 never 1027 3 129.57.167.216 2 3 771 never 1027 4 129.57.167.217 2 4 771 never 1027 5 129.57.167.218 2 5 771 never 1027 6 129.57.167.219 2 6 771 never 1027 7 129.57.160.20 2 7 771 never 1027 8 129.57.167.210 32 8 771 never 1027 9 129.57.167.211 32 9 771 never 1027 10 129.57.160.50 2 a 771 never 1027 11 129.57.68.95 32 b 771 never 1027 12 129.57.167.212 32 c 771 never 1027 13 129.57.167.220 32 d 771 never 1027 14 129.57.167.228 32 e 771 never 1027 15 129.57.167.229 32 f 771 never 1027 16 129.57.167.204 32 10 771 never 1027 17 129.57.86.201 32 11 771 never 1027
If adding new device, repeat the procedure on clon00, clon10 and clon20.
Now copy our clon script into some directory included into PATH, for example:
cp tsconnect /usr/local/bin
Copy tsconnect.conf from previous location to /opt/realport.
Include command /opt/realport/dflush into sudoers file.
Now everything should be ready. Try to type something like
tsconnect croctest1
and see if communication established. To end session, type '~' and 'x'.
Booting EtherLite devices
EtherLite terminal server is using Bootp. Process controlled by /etc/bootptab file, example is here:
# @(#) $Header: /users/hpnp/odyssey/repository/examples/bootptab,v 1.2 1997/06/26 21:23:33 hpnp Exp $ # Example /etc/bootptab: database for bootp server (/etc/bootpd). # Blank lines and lines beginning with '#' are ignored. # # Legend: # # first field -- hostname # (may be full domain name) # # hd -- home directory # bf -- bootfile # cs -- cookie servers # ds -- domain name servers # gw -- gateways # ha -- hardware address # ht -- hardware type # im -- impress servers # ip -- host IP address # lg -- log servers # lp -- LPR servers # ns -- IEN-116 name servers # rl -- resource location protocol servers # sm -- subnet mask # tc -- template host (points to similar host entry) # to -- time offset (seconds) # ts -- time servers # # Be careful about including backslashes where they're needed. Weird (bad) # things can happen when a backslash is omitted where one is intended. # #peripheral1:\ # :hn:ht=ether:vm=rfc1048:\ # :ha=08000903212F:\ # :ip=190.40.101.22:\ # :sm=255.255.255.0:\ # :gw=190.40.101.1:\ # :lg=190.40.101.3:\ # :T144="hpnp/peripheral1.cfg": ########## Etherlite 32 RS232, Forward Carriage 1st Level, etherlite1 els0:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7008569:ip=129.57.167.208: ### bf=el32_realport.bin: ########## Etherlite 2 RS422 (EIA422), Forward Carriage 2nd Level, rs422a (reset1) els1:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e721288b:ip=129.57.167.215: ### bf=el2_realport.bin: ########## Etherlite 32 RS232, Space Frame 1st Level South, etherlite2 els2:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7213b9f:ip=129.57.167.209: ### bf=el32_realport.bin: ########## Etherlite 2 RS422 (EIA422), South Claim Shelf, rs422b (reset3) els3:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e72141bd:ip=129.57.167.216: ### bf=el2_realport.bin: ########## Etherlite 2 RS422 (EIA422), Space Frame 1st Level South, rs422c (reset5) els4:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e72141b9:ip=129.57.167.217: ### bf=el2_realport.bin: ########## Etherlite 2 RS422 (EIA422), Space Frame 1st Level North, rs422d (reset2) els5:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e72141ae:ip=129.57.167.218: ### bf=el2_realport.bin: ########## Etherlite 2 RS422 (EIA422), Space Frame 2nd Level North (behind dc11), rs422e (reset4) els6:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e72141c4:ip=129.57.167.219: ### bf=el2_realport.bin: ########## Etherlite 2 RS422 (EIA422), Hall B Gas Shed, rs422f (reset6) els7:sm=255.255.255.0:gw=129.57.160.1:ht=ether:ha=00a0e72141b1:ip=129.57.160.20: ### bf=el2_realport.bin: ########## Etherlite 32 RS232, Space Frame 1st Level North, etherlite3 els8:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7214019:ip=129.57.167.210: ### bf=el32_realport.bin: ########## Etherlite 32 RS232, South Claim Shellf, etherlite4 els9:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7214003:ip=129.57.167.211: ### bf=el32_realport.bin: ########## Etherlite 2 RS232, Hall B Gas Shed (2-port !), etherlite8 (clasgas) elsa:sm=255.255.255.0:gw=129.57.160.1:ht=ether:ha=00a0e7214e24:ip=129.57.160.50: ### bf=el2_realport.bin: ########## Etherlite 32 RS232, Counting Room, etherlite9 elsb:sm=255.255.255.0:gw=129.57.68.100:ht=ethernet:ha=00a0e72331b2:ip=129.57.68.95: ### bf=el32_realport.bin: ########## Etherlite 32 RS232, Forward Carriage 1st Level, etherlite5 elsc:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e721402e:ip=129.57.167.212: ### bf=el32_realport.bin: ########## Etherlite 32 RS232, Pie Tower, etherlite10 elsd:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e721401a:ip=129.57.167.220: ### bf=el32_realport.bin: ########## Etherlite 32 RS232, Forward Carriage, 2nd Level, etherlite11 else:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e723764c:ip=129.57.167.228: ### bf=el32_realport.bin: ########## Etherlite 32 RS232, ... , etherlite12 elsf:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7237a08:ip=129.57.167.229: ### bf=el32_realport.bin: ########## Etherlite 32 RS232, ... , etherlite13 elsg:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7237a8f:ip=129.57.167.204: ### bf=el32_realport.bin: #
Every terminal server has two lines in /etc/bootptab file. Normally on power recycle terminal server will obtain IP address and related information from /etc/bootptab file. Terminal server remember firmware, so only first line must be uncommented. If want to upgrade firmware, new firmware file must be placed in /tftpboot, backslash have to be placed at the end of the first line, and second line must be uncommented.
Wiring (old info, maybe uncorrect, see Wiring for recent info)
The terminal server cables are cat 5 cables with 4 twisted pairs of conductors. Each conductor is fed into an RJ45 connector, which is numbered from right to left, looking at the front of the plug with the tab down. Using Hall B's convention, this table describes which wire colors should be fed to which RJ45 conductors at either end of the connection. The wiring will be different at the terminal server and the device. This wiring scheme will allow a connection to be made directly to a Motorola computer with an RJ45 console connector. For devices with a DSUB connector, there are converters available at the lab, and they rely on this wiring configuration as well.
|Server Wire Color|RJ45 Pin|Device Wire Color|Signal (Server end)| |Brown | 1 | Orange | RTS | |Blue | 2 | Orange Stripe | DSR | |Brown Stripe | 3 | Blue | DCD | |Blue Stripe | 4 | Blue Stripe | !RxD | |Green | 5 | Green | !TxD | |Green Stripe | 6 | Green Stripe | SG | |Orange | 7 | Brown | DTR | |Orange Stripe | 8 | Brown Stripe | CTS |
Other information
- To assign IP address to device using 'bootp' (have to disable bootp server first by svcadm disable network/bootps/udp, do not forget to enable it afterwards):
dgipserv -store 00:a0:e7:00:85:69 129.57.167.208 dgipserv -store 00:a0:e7:23:31:b2 129.57.68.95 dgipserv -store 00:a0:e7:23:10:79 129.57.167.251
After running 'dgipserv' command recycle power on terminal server and watch messages, it should set everything and ask you to wait certain time before terminal server will become active.
- It is possible to 'rlogin' to terminal server, for example:
rlogin 129.57.167.208 EL-32 Terminal Server ? ? ver Product: EL-32 FW Ver: V6.6 Ethernet: 00:A0:E7:00:85:69 IP: 129.57.167.208 GW IP: 129.57.167.99 SN Mask: 255.255.255.0 Lease: 0xFFFFFFFF Boot Host: 129.57.167.5 Bootfile: el32.prm ICMP error (303) getting Bootfile: destination unreachable ?
rlogin 129.57.68.95 ? ver Product: EL-32 FW Ver: V7.9 Ethernet: 00:A0:E7:23:31:B2 IP: 129.57.68.95 GW IP: 129.57.68.100 SN Mask: 255.255.255.0 Lease: 0xFFFFFFFF Boot Host: 129.57.68.21 Bootfile: el32.prm TFTP error (2) getting Bootfile: Access violation ?
after boot from clon00
? ver
Product: EL-32
FW Ver: V7.9
Ethernet: 00:A0:E7:23:31:B2
IP: 129.57.68.95
GW IP: 129.57.68.100
SN Mask: 255.255.255.0
Lease: 0xFFFFFFFF
Boot Host: 129.57.68.1
Bootfile: el32.prm
ICMP error (303) getting Bootfile: destination unreachable
? sockets
remote local
remote ip port port state sRTT sMDEV max rtt
--------------- ----- ----- ------------ ------- ------- -------
129.57.167.3 01015 00513 ESTABLISHED 00000ms 00160ms 00112ms
0.0.0.0 00000 10001 LISTEN 00000ms 02880ms 00000ms
?
- boot messages on clon00/clon10 reboot:
...........
Copyright 1983-2003 Sun Microsystems, Inc. All rights reserved.
Digi EtherLite(R)/SCSI Terminal Server(TM) Module Driver R3.015
for 64-bit Solaris 7 and 8 (SPARC) configured.
Digi EL-32 (els0) at IP address 129.57.167.208
Digi EL-2.2 (els1) at IP address 129.57.167.215
Digi EL-32 (els2) at IP address 129.57.167.209
Digi EL-2.2 (els3) at IP address 129.57.167.216
Digi EL-2.2 (els4) at IP address 129.57.167.217
Digi EL-2.2 (els5) at IP address 129.57.167.218
Digi EL-2.2 (els6) at IP address 129.57.167.219
Digi EL-2.2 (els7) at IP address 129.57.160.20
Digi EL-32 (els8) at IP address 129.57.167.210
Digi EL-32 (els9) at IP address 129.57.167.211
Digi EL-2 (elsa) at IP address 129.57.160.50
Digi EL-32 (elsb) at IP address 129.57.68.95
Digi EL-32 (elsc) at IP address 129.57.167.212
VxVM sysboot INFO V-5-2-3244 Starting restore daemon...
VxVM sysboot INFO V-5-2-3445 starting in boot mode...
NOTICE: VxVM vxdmp V-5-0-34 added disk array DISKS, datype = Disk
NOTICE: VxVM vxdmp V-5-0-34 added disk array 508002000005e930, datype = SENA
...........