EtherLite32: Difference between revisions

From CLONWiki
Jump to navigation Jump to search
Boiarino (talk | contribs)
No edit summary
Boiarino (talk | contribs)
No edit summary
Line 18: Line 18:
  dinc                  - a cu/tip 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.
* 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.
* 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.

Revision as of 08:27, 24 August 2016

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


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