EtherLite32: Difference between revisions

From CLONWiki
Jump to navigation Jump to search
← Older edit
Boiarino (talk | contribs)
jpeople, Administrators
4,150 edits
No edit summary
Boiarino (talk | contribs)
jpeople, Administrators
4,150 edits
No edit summary
 
(39 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The number of EtherLite32 terminal servers are installed to provide serial connections to ROCs, IOCs, network switches and other devices.
The number of EtherLite32 terminal servers are installed to provide serial connections to ROCs, IOCs, network switches and other devices.


RealPort software must be installed to communicate with EtherLite terminal servers. Do following as 'root' (tar file contains files downlloaded from http://www.digi.com):
 
'''NOTE:''' if ''softioc_console'' in use, tsconnect command will not work, use following command to communicate to Etherlite ports:
 
'softioc_console -p' shows list of device names
'softioc_console <device_name>' connects to the device
 
To exit connection, do '^]' to jump to telnet prompt and type 'quit' to exit.
 
While in session, ^T will toggle auto restart ON/OFF. Normally it is ON. If OFF, then ^X will kill connection and do not restart it, then tsconnect method can be used.
 
 
 
 
== 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
 
'''NOTE''': to fix compiling error on RHEL7, add following to the file ''driver/build/include/dgrp_net_ops.h'':
 
#define TTY_CLOSING (7)
 
* add following line to ''/etc/sudoers'':
 
%onliners ALL=NOPASSWD:/usr/bin/dinc,NOPASSWD:/usr/bin/ditty,NOPASSWD:/sbin/fuser
 
* Run ''/usr/bin/dgrp/config/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.
 
* Run ''/etc/init.d/dgrp_daemon status'' to see daemons running. To make it run on startup use ''chkconfig''.
 
 
 
'''NOTES FROM DIGI''':
 
* 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.
 
* 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' and 'dflush' scripts from $CODA are used to access devices, config file is $CLON_PARMS/tsconnect/tsconnect.conf, command is 'tsconnect <dev>'.
 
== 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
  cd /usr/local/src
  cp ../downloads/EtherLite32.tar .
  cp ../downloads/EtherLite32.tar .
Line 116: Line 175:


Copy several files to ''/opt/realport'':
Copy several files to ''/opt/realport'':
  cp dpflush /opt/realport
  cp dflush /opt/realport
  cp dinc /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.


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


drpadmin
Include command ''/opt/realport/dflush'' into ''sudoers'' file.
...
copy tsconnect.conf to /opt/realport


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


== old info ==
EtherLite terminal server is using [[Bootp]]. Process controlled by ''/etc/bootptab'' file, example is here:


---+ ETHERLITE Terminal Servers
# @(#) $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:
#


---++ Hardware
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.
|  *Name*  |  *Ethernet Address*  |  *IP Name*  |  *Location*  |  *Ports*  |  *Protocol* |
|  els0  |  00a0e7008569  |  etherlite1  |  FC1  |  0-31  |  RS232  |
|  els1  |  00a0e721288b  |  rs422a  |  FC2  |  32-33  |  RS422  |
|  els2  |  00a0e7213b9f  |  etherlite2  |  SF1S  |  34-65  |  RS232  |
|  els3  |  00a0e72141bd  |  rs422b  |  SCS  |  66-67  |  RS422  |
|  els4  |  00a0e72141b9  |  rs422c  |  SF1S  |  68-69  |  RS422  |
|  els5  |  00a0e72141ae  |  rs422d  |    SF1N  |  70-71  |  RS422  |
|  els6  |  00a0e72141c4  |  rs422e  |    SF2N  |  72-73  |  RS422  |
|  els7  |  00a0e72141b1  |  rs422f  |    GS  |  74-75  |  RS422  |
|  els8  |  00a0e7214019  |  etherlite3  |  SF1N  |  76-107  |  RS232  |
|  els9  |  00a0e7214003  |  etherlite4  |  SCS  |  108-139  |  RS232  |
|  elsa  |  00a0e7214e24  |  etherlite8  |  GS  |  ????  |  RS232  |
|  elsb  |  00a0e72331b2  |  etherlite9  |  CR  |  ????  |  RS232  |
|  elsc  |  00a0e721402e  |  etherlite5  |  FC1  |  ????  |  RS232  |




---+++ Key  Meaning
'''Wiring''' (old info, maybe uncorrect, see [[Wiring]] for recent info)
  $ FC:  Forward Carriage
  $ FC1:  Forward Carriage, 1st level up from ground
  $ FC2:  Forward Carriage, 2nd level up from ground
  $ SF:  Space Frame
  $ SF0:  Space Frame, ground level
  $ SF1S:  Space Frame, 1st level up from ground, South
  $ SF1N:  Space Frame, 1st level up from ground, North
  $ SF2:  Space Frame, 2nd level up from ground
  $ SF2N:  Space Frame, 2nd level up from ground, North
  $ SF2S:  Space Frame, 2nd level up from ground, South
  $ SCS:  South Clam Shell structure
  $ NCS:  North Clam Shell structure
  $ GS:  Gas Shed


---++ Wiring
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.
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 (at Server end)*|
|Server Wire Color|RJ45 Pin|Device Wire Color|Signal (Server end)|
|Brown   |1| Orange |RTS|
|Brown           | 1     | Orange         |       RTS         |
|Blue   |2| Orange Stripe |DSR|
|Blue             | 2     | Orange Stripe   |       DSR         |
|Brown Stripe   |3| Blue |DCD|
|Brown Stripe     | 3     | Blue           |       DCD         |
|Blue Stripe   |4| Blue Stripe |!RxD|
|Blue Stripe     | 4     | Blue Stripe     |     !RxD         |
|Green   |5| Green |!TxD|
|Green           | 5     | Green           |     !TxD         |
|Green Stripe   |6| Green Stripe|SG|
|Green Stripe     | 6     | Green Stripe   |       SG         |
|Orange   |7| Brown |DTR|
|Orange           | 7     | Brown           |       DTR         |
|Orange Stripe    |8| Brown Stripe |CTS|
|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
?


---++ Configuration
rlogin 129.57.68.95
/etc/bootptab on *CLON10*:
? ver
<pre>
Product: EL-32  
# Etherlite 32 RS232, Forward Carriage 1st Level, etherlite1
FW Ver:   V7.9
els0:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7008569:ip=129.57.167.208:
Ethernet: 00:A0:E7:23:31:B2
# Etherlite 2 RS422, Forward Carriage 2nd Level, rs422a
IP:       129.57.68.95
els1:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e721288b:ip=129.57.167.215:
GW IP:     129.57.68.100
# Etherlite 32 RS232, Space Frame 1st Level South, etherlite2
SN Mask:   255.255.255.0
els2:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7213b9f:ip=129.57.167.209:
Lease:     0xFFFFFFFF
els3:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e72141bd:ip=129.57.167.216:
Boot Host: 129.57.68.21
els4:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e72141b9:ip=129.57.167.217:
Bootfile: el32.prm
els5:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e72141ae:ip=129.57.167.218:
TFTP error (2) getting Bootfile: Access violation
els6:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e72141c4:ip=129.57.167.219:
?
# Gas Shed 422 server, rs422f
els7:sm=255.255.255.0:gw=129.57.160.1:ht=ether:ha=00a0e72141b1:ip=129.57.160.20:
# 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:
# Etherlite 32 RS232, South Clam Shell etherlite4
els9:sm=255.255.255.0:gw=129.57.167.99:ht=ether:ha=00a0e7214003:ip=129.57.167.211:
# Gas Shed 232 2-port server, etherlite8
elsa:sm=255.255.255.0:gw=129.57.160.1:ht=ether:ha=00a0e7214e24:ip=129.57.160.50:
# Etherlite 32 RS232, Counting Room
#elsb:sm=255.255.255.0:gw=129.57.68.100:ht=ether:ha=00a0e721401a:ip=129.57.68.95:
elsb:sm=255.255.255.0:gw=129.57.68.100:ht=ether:ha=00a0e72331b2:ip=129.57.68.95:
# 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:
</pre>


---++ Changing configuration
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
?


if terminal server have to be replaced, do following:


  * set new MAC address in configuration file /etc/bootptab
* boot messages on clon00/clon10 reboot:
  * kill -HUP for 'bootpd'
...........
  * kill -HUP for '/usr/sbin/rpc.bootparamd'
Copyright 1983-2003 Sun Microsystems, Inc.  All rights reserved.
  * start manualy /usr/sbin/rpc.bootparamd
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
...........

Latest revision as of 09:26, 19 April 2019

The number of EtherLite32 terminal servers are installed to provide serial connections to ROCs, IOCs, network switches and other devices.


NOTE: if softioc_console in use, tsconnect command will not work, use following command to communicate to Etherlite ports: 

'softioc_console -p' shows list of device names
'softioc_console <device_name>' connects to the device

To exit connection, do '^]' to jump to telnet prompt and type 'quit' to exit.

While in session, ^T will toggle auto restart ON/OFF. Normally it is ON. If OFF, then ^X will kill connection and do not restart it, then tsconnect method can be used.



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

NOTE: to fix compiling error on RHEL7, add following to the file driver/build/include/dgrp_net_ops.h: 

#define TTY_CLOSING (7)
  • add following line to /etc/sudoers:
%onliners ALL=NOPASSWD:/usr/bin/dinc,NOPASSWD:/usr/bin/ditty,NOPASSWD:/sbin/fuser
  • Run /usr/bin/dgrp/config/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.
  • Run /etc/init.d/dgrp_daemon status to see daemons running. To make it run on startup use chkconfig.


NOTES FROM DIGI:

  • 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.
  • 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' and 'dflush' scripts from $CODA are used to access devices, config file is $CLON_PARMS/tsconnect/tsconnect.conf, command is 'tsconnect <dev>'.

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
...........
Retrieved from "https://clonwiki0.jlab.org/wiki/index.php?title=EtherLite32&oldid=7450"