HP-UX Realport Driver P/N 40001847B Release Notes P/N 93000311B Release 1.1.1 08/03/99 $Revision: 1.22 $ CHANGE HISTORY ============== 1.0 Initial Release 1.0.3 Periodic Release Fixed problem where DTR dropped immediately after a modem connect, causing the modem to hang up. 1.0.4 Beta Release Added HP-UX 11.x support via a new set of binaries and redesigned package to dynamically select the appropriate binary at install time. This support is currently limited to 32-bit platforms. 1.1.1 Periodic Release Fixed problem with configuration of more than 10 portservers. Fixed problem where transparent printing stops after significant output to the terminal device. SUMMARY ======= The Digi HP-UX Realport driver makes the ports on a Digi Portserver appear as though they are local HP-UX tty devices directly attached to the computer. When the HP-UX system boots, one drpd daemon is spawned for each Portserver. Each daemon makes a single TCP/IP connection to its associated Portserver and sends all asynchronous serial data on this single connection. The daemon accesses the Realport driver through a special control device, /dev/drpN, where N is the Portserver number. This is a privileged, exclusive access device used only by the daemon. Portserver ports can be accessed any time they are configured for Realport operations and are not otherwise in use. There are 3 devices in /dev for each physical port: /dev/ttyXN - Login port /dev/prXN - Transparent Print port /dev/cuXN - Modem Callout port Where X is a user selected 1 or 2 character string for this Portserver, and N is the port number 01 through 64. The Login ports and Transparent Print ports normally block in the open unless carrier (DCD) is present, although the ditty command (see below) may be used to change this. The Modem Callout ports open with or without carrier, but still detect carrier loss on a transition from carrier to no carrier. A process attempting to open a Login or Transparent Print port blocks if the port is currently unavailable, or if carrier is not present. The open completes when the port is available and carrier is present. Conversely any open to a busy Modem Callout port fails immediately. The Login and Transparent Print ports may be open at the same time. Data sent to the Login port goes out the port without modification, while data sent to the transparent print port is bracketed with printer-on and printer-off sequences before output. The ditty command can set the on-off sequences and adjust the print speed. The Login port receives all input data; reads to the print device always fail. To configure a port for bi-directional modem traffic, the Login device should be configured in /etc/inittab, and the Modem Callout device should be configured in /usr/lib/uucp/Devices. In this case its normal for /etc/getty to be waiting for an incoming modem connection while /usr/bin/cu completes an outgoing modem connection. PORTSERVER SETUP ================ The Digi Portservers are full featured terminal and communication servers whose configuration is detailed in the Portserver Manual. We note here the minimum needed for Realport operation. First you must login as root on the Portserver. You can connect a 9600 baud 8N1 terminal to port 1, or (if you obtained an IP address through RARP or BOOTP) you can telnet to the box. The factory default root password is "dbps". Basic IP parameters must be set up before the Portserver will operate on the network. If you have not done this with RARP or BOOTP, you must do it from the command line. Substitute your own IP address, net mask and (optionally) gateway address into the following Portserver command: set config ip=192.168.0.1 submask=255.255.255.0 gateway=192.168.0.254 The Realport driver works best if you configure associated Portserver devices as printers. It works VERY POORLY if the devices are configured as terminals, for example. The following command sets up ports 1-16 as device type prn (printer). set port range=1-16 dev=prn If 8-pin RJ-45 plugs are used in the Portserver, the altpin option should be selected to make DCD available on one of the inner pins. The following command sets altpin on 16 ports. set flow range=1-16 altpin=on You can check the current configuration with: set config set flow range=1-16 set port range=1-16 DRIVER INSTALLATION =================== You should have received a tar file with this README file. You need to uncompress it, untar it, register it with HP-UX for installation, and then install it. Use the following as a guide. su # become root cp drp.tar.Z /tmp # copy the install file cd /tmp # any directory will do uncompress drp.tar.Z # uncompress the distribution tar xvf drp.tar # extract the install package swreg -l depot /tmp/drp.pkg # register the install package swinstall -s /tmp/drp.pkg # install the driver and relink # the kernel. In the install # GUI you must first click # "Mark For Install" and then # "Install" in the "Actions" menu. Upon successful completion swinstall will reboot your computer. DRPADMIN SCRIPT =============== After completing the driver install, you need to run the "drpadmin" script to create the device files, and start the daemons. Suppose you have 2 Portservers named venus and mars, each with 32 ports. You want to name the venus ports as /dev/ttyv01 -> /dev/ttyv32 and the mars ports as /dev/ttym01 -> /dev/ttym32. Proceed with: # /usr/sbin/drpadmin Please select an option (a)dd (d)elete (s)how (q)uit : a Enter the node name or IP address: venus Enter the number of ports: 32 Enter the tty device id (only 2 chars allowed) : v If the network connection between your HP-UX system and the Portserver includes a WAN link slower than 1 MBit, see the drpd.1m man page and enter the WAN speed here : The following Portserver will be configured, 0 venus 32 v Is this correct (y to add or x to abort) ? y Creating Digi Realport Devices.... Please wait.. Done Please select an option (a)dd (d)elete (s)how (q)uit : a Enter the node name or IP address: mars Enter the number of ports: 32 Enter the tty device id (only 2 chars allowed) : m If the network connection between your HP-UX system and the Portserver includes a WAN link slower than 1 MBit, see the drpd.1m man page and enter the WAN speed here : The following Portserver will be configured, 1 mars 32 m Is this correct (y to add or x to abort) ? y Creating Digi Realport Devices.... Please wait.. Done Please select an option (a)dd (d)elete (s)how (q)uit : s 0 venus 32 v 1 mars 32 m Please select an option (a)dd (d)elete (s)how (q)uit : q # The WAN speed is optional, is not needed when the HP-UX system connects to the Portserver over a high speed LAN. If you connect to the Portserver over a slower WAN link, for example at 56K baud, you should enter the numeric bit rate (eg 56000) here. Alternatively you can enter a 5-number speed specification as described in the drpd.1 Manual Page. As soon as you have completed this operation, you will find that all needed devices have been created in /dev, the drpd daemons have been started, and skeleton entries have been placed in /etc/inittab and /etc/ttytype for each new port. Your new ports are immediately available. No reboot is necessary. You may run the drpadmin script at any time to add additional Portservers, or delete existing ones. All such actions take effect immediately. When deleting ports, all traces are removed from /dev, /etc/inittab and /etc/ttytype; the daemon is killed; a hangup signal is sent to all associated ports. DITTY PROGRAM ============= You may use the ditty program to access the special features common to (nearly) all Digi drivers. The Realport driver differs from the documentation as follows: altpin The altpin option is set in the Portserver, and may not be changed from HP-UX. hupcl This option is ineffective, since carrier is always dropped by the Portserver when a port is closed. Its often useful to set flow control and modem control options with the ditty program during boot. To do this, enter the commands into the script: /etc/conf/digi/drp-boot.sh IXANY in /etc/gettydefs ======================= Several entries in the HP-UX /etc/gettydefs file set IXANY on by default. With this setting, any keystroke typed by the user while xon/xoff flow control is active restarts output. This happens even if the terminal requested flow control because it could not keep up with full speed system output. In this case terminal buffer overflows, dropping data and (usually) garbling screen output. To avoid these problems, the Digi install procedure edits the /etc/gettydefs file to disable IXANY. The original /etc/gettydefs file is saved in /etc/gettydefs.ixany. ON-LINE DOCUMENTATION ===================== These release notes (or possibly an updated version) are available in /etc/conf/digi/drp.README. Also see the following manual pages: ditty(1) Set/Display Digi tty options drpadmin(1m) Digi Realport Configuration Utility drpd(1m) Digi Realport Network Daemon drp(7) Digi Realport Driver See the Digi International web page for other documentation and software updates. The URL is: http://www.dgii.com