Digi RealPort Device Driver Version 2.7.8 Solaris 7, 8, 9 and 10 for SPARC and Intel Release Notes P/N 93000184_R Diskette P/N (3.5) 40001174_P 02/09/05 CONTENTS Section Description 1 Introduction 2 Supported Products 3 Enhancements 4 Bug Fixes 5 Known Limitations 6 RealPort Setup 7 Upgrade Notes 8 History 1. INTRODUCTION The Digi Solaris RealPort driver makes the serial ports on a Digi RealPort enabled product appear as though they are local tty devices directly attached to the computer. When the system boots, one ncxd daemon is spawned for each RealPort enabled unit. Each daemon makes a single TCP/IP connection to its associated RealPort enabled unit and sends all asynchronous serial data on this single connection. Digi RealPort enabled ports can be accessed any time they are configured for RealPort operations and are not otherwise in use. The RealPort service requires the TCP/IP driver to be installed and properly configured. 2. SUPPORTED PRODUCTS RealPort is supported on the following Digi products: Digi One EM Digi One IA Digi One IA RealPort Digi One RealPort Digi One SP Digi One TS Digi Flex Digi PortServer Digi PortServer II Digi PortServer II Rack Digi PortServer TS 2 Digi PortServer TS 4 Digi PortServer TS 8 Digi PortServer TS 16 Digi PortServer TS 16 Rack Digi EtherLite 2 Digi EtherLite 8 Digi EtherLite 16 Digi EtherLite 32 Digi EtherLite 80 Digi EtherLite 160 Digi EtherLite 162 3. ENHANCEMENTS None. 4. BUG FIXES Fixed problem with the driver not working under Solaris 10. 5. KNOWN LIMITATIONS This driver does not support Solaris x86 64bit. Encrypted RealPort The Solaris software requires a random number generator on the system. If you want to use the encrypted layer in the driver you must install a Random Number Generator. The following points should be noted: o Solaris 2.6 - Sparc and Intel platforms: Install "SUNWski" package, available at the "Solaris Easy Access CDs" in the "Sun Webserver" product. o Solaris 7 - Sparc and Intel platforms: Install "SUNWski" package, available at the "Solaris Easy Access CDs" in the "Sun Webserver" product. o Solaris 8 - Sparc platform: Install Patch "112438" available from Sun: http://sunsolve.sun.com/pub-cgi/show.pl?target=patchpage o Solaris 8 - Intel platform: Install Patch "112439" available from Sun: http://sunsolve.sun.com/pub-cgi/show.pl?target=patchpage o Solaris 9 - Sparc and Intel platforms: Support built-in. If a Digi RealPort enabled unit loses power it may be necessary to wait for up to 2 minutes before communication is re-established with the device. This wait can be lowered considerably by changing the default parameters of the /dev/tcp device by using the ndd command. Please visit this SUN TechNote (DOCUMENT ID: 01363) for more information: http://access1.sun.com/technotes/01363.html If a port is interrupted in the middle of data transfer it will not die until the data has completely drained. This behavior occurs because of a bug in the Solaris kernel. There is a kernel function called by the Solaris ldterm module that does not respond to a KILL signal when it should. 6. REALPORT SETUP The RealPort package can be installed by the following command: pkgadd -d 40001174_X.bin The RealPort devices can be setup using the drpadmin tool. To run the tool you must be root. Run the tool with the following command: drpadmin The drpadmin tool is simple to use. You can add a RealPort device, remove a RealPort device, or view the RealPort devices currently setup. The drpadmin tool will ask for an IP address, number of ports, and the tty device id. The IP address should be the IP address or domain name associated with the IP address that was assigned to the RealPort enabled unit when the unit itself was configured. The number of ports are simply the number of serial ports on the device. The tty device id is the id that will be incorporated into the tty device names. The tty devices will be created in the following directories: Directory for actual serial devices: /dev/dty Directory for print devices: /dev/dpr Directory for links to tty devices: /dev/term Directory for links to cu devices: /dev/cua The Digi RealPort software package can be removed by the following command. It is recommended that all devices related to the package are closed before removing a package. pkgrm realport See the install_notes.txt located in the /opt/realport directory for more details on RealPort tty device operation. 7. UPGRADE NOTES When upgrading from a driver version 2.x and later the information used to create RealPort devices can saved and restored with the following steps: 1) Copy the file "/opt/realport/drp.conf" to a location that will not get destroyed when the old driver is being removed. 2) Remove the old driver from the system. 3) Add the new driver to the system. 4) Copy the "drp.conf" file saved in step 1 to the "/opt/realport" directory. 5) Run the utility "/opt/realport/utils/ncx_verify_conf" to create the devices and startup the network daemons. 8. HISTORY Version 2.7.7 Bug Fixes Fixed flow control problem on a RealPort Server reboot. The CRTSCTS and CRTSXOFF stty flags were not being resent to the RealPort Server on disconnect/reconnect. Version 2.7.5 Enhancements Added support for Realport with encryption. Bug Fixes Fixed "Protocol decode error" problem that could cause the driver to disconnect from the RealPort server randomly. Version 2.7.1 Enhancements Added support for up to 1016 Device Server products, the limitation used to be 512 products. Added support for "digi mon" devices. Bug Fixes Fixed race condition when flushing the tty ports. Fixed ttymon race condition when using the "m" devices without forcing carrier. Fixed problem on package removal, devices with tty names with a 2 character prefix would not be deleted. Fixed problem when loading the driver, the manual autopush of the ldterm and ttcompat modules would occur before the load of the ncxa module. This would cause ldterm and ttcompat not to be pushed onto the ncxa driver stream until after the first reboot of the system. Fixed problem when not using drpadmin to configure the Realport devices, the "dty" and "dpr" directories were not being built. The ncx_mknod program now will create them if they do not exist. Fixed problem with the ioctl TIOCMGET returning 8 bytes instead of 4 bytes. Version 2.6.0 Enhancements Added official support for Solaris 9 (2.9) Bug Fixes Fixed bug "off by one" for setting baud rates with cfset[io]speed above 115200 was fixed. Fixed bug that would not permit baud rates to be set to 57600. If 57600 was attempted to be set, it would send a HANGUP to the port instead. Fixed bug during a transparent ioctl - TIOCMGET. This would cause incorrect modem signals returned to the user. Problem involved COPYOUT. Fixed bug in the ncxd daemon. If the rc script would be used by the user to stop- then start the daemons, the daemon would not be inherited by init correctly. Version 2.5.0 Enhancements The ditty tool has been enhanced. Support for setting custom baudrates has been added. Support for setting multiple devices on the same ditty command line has been added. RealPort is now supported by the EtherLite family. RealPort enabled firmware must be loaded on the EtherLite unit for RealPort to function properly. Added the ability to reset the RealPort network daemon with the drpadmin tool. Added a man page for this driver named realport. Bug Fixes A bug where a structure was not initialized properly was fixed. It is uncertain if this bug resulted in any problems. The drpadmin tool was modified to prevent simultaneous instances of this tool from modifying the drpadmin database at the same time. The behavior of our driver was modified to recover from hangup conditions. This was done in an effort to be consistent with the Solaris serial driver and allow terminal logins using Solaris's ttymon to recover properly after a hangup without using the soft carrier option. Version 2.4.3 - August 16, 2001 Enhancements: The internals of the driver have been rewritten. The driver was rewritten to make the driver more robust and efficient. This driver has all of the functionality of the previous driver. One exception is that this driver now supports extended baud rates. Extended baud rates are baud rates supported by Solaris that allow serial devices to exceed 38400 baud. Previously these higher baud rates could only be accessed using the "ditty fastbaud" option. The method for installing new realport devices has been modified. RealPort devices can now be added and deleted using a tool called drpadmin. The method for adding realport devices at package install time has been removed. The option of selecting where the realport devices are placed has been removed. The realport devices are placed in the following directories: /dev/dty <- tty and cu devices /dev/dpr <- transparent print devices /dev/cua <- links to cu devices /dev/term <- links to tty devices Bug Fixes: A bug that had the potential to cause data loss has been resolved. Version 1.8.0 - June 6, 2001 Enhancements: Added support for the PortServer III terminal server. Added support for the PortServer Lite terminal server. Added support for the EtherLite terminal server. Version 1.7.1 - January 25, 2001 Enhancements: Updated Release Notes to include support for Solaris 2.8. Bug Fixes: Fixed a system panic that resulted from an invalid putctl. Fixed a problem sending break through to console. Version 1.7.0 - October 19, 2000 Enhancements: Added support for Solaris 2.8 to Release Notes. Version 1.7.0 - January 10, 2000 Bug Fixes: A problem with the driver holding a lock while removing the service routines from the service queue has been resolved. The symptom of this error was a fairly random system crash that was seen on multi-processor systems. Enhancements: Changed format of release notes. Version 1.6.0 - November 23, 1998 Enhancements: Added support for Solaris 2.7. Added 64 bit support for SPARC 2.7 portion of driver. Version 1.5.0 - May 15, 1998 Bug Fixes: Fixed a failing connectivity issue, seen with more than 4 PortServers. Version 1.4.0 - December 23, 1997 Bug Fixes: Fixed a daemon reattach problem seen over frame relay connection. Fixed problem with EBI modules not functioning properly.