#### Driver release 4.010 #### stsdd 4.3.10.0 under AIX 4.3.2 #### stsdd 4.1.10.0 under AIX 4.1.5 1. The driver contains two installation images. If you will install the driver via SMIT instead of running script "Install", the fileset stsdd 4.3.x.x is for AIX 4.3 and stsdd 4.1.x.x is for AIX 4.1 and AIX 4.2. 2. If you current driver is version 3.003.1 or later, you can install the new driver directly without losing the current configurations. 3. For those who are using 3.005 or earlier version, the device names of st1400A, st1800A, and st1800A+ have been changed. If you have these devices configured, please remove them before installing the new driver and reconfigure them after installation of the driver !! RELEASE NOTES Digi EtherLite(R)/SCSI Terminal Server(TM) Module Driver for AIX ============================================= Software Driver P/N 40002064_B Source Code P/N 81000128_B Release Notes P/N 93000354_B December 21, 1999 ============================================= Release notes for EtherLite(R)/SCSI Terminal Server(TM) Module Driver Software Version (4.010.00) 1. Changed configuration termination routine to wait for ports to shut down and to redeem outstanding timer callbacks. Software Version (4.009.00) 1. Changed ELS unit offline message for AIX error log from "permanent PIO error detected by driver" to "adapter not present", which more closely reflects the severity of the problem. Software Version (4.008.00) 1. Changed cdetherd to handle users changing the system date and time. Software Version (4.007.00) 1. Added tests for null unit ptrs in stswsrv, stswput, stsrsrv, stsopen, and stsclose. 2. Changed timer routine to only wakeup openers waiting for units to become online. 3. Corrected problem in waiting for output to finish before changing termio(s) settings. 4. Changed default maximum packet size to 2046 bytes for Etherlite units. Software Version (4.006.00) 1. Corrected deadlock problem in timer callback routine. 2. Change driver to handle killed cdetherd better. 3. Corrected bug in closing already offline Etherlite port. 4. Corrected bug in changing configuration of offline Etherlite port. Software Version (4.004.00) 1. Corrected bugs in open and close routines, ioctl handling, cross-memory handling, and other miscellaneous issues. 2. Restored parallel-port performance (Failure 2237). 3. Added support for _POSIX_VDISABLE special character override. 4. Added ODM/SMIT support for RS-485 units. 5. Enhanced cdetherd daemon to output to syslog, and no longer litter /tmp with excess log files (Failure 2101). Now, cdetherd maintains the last three log files in /tmp, with file extensions .log, .old, and .older. The cdetherd daemon logs now display the ELS firmware version (Failure 3035.) 6. Added standard AIX system-level tracing using trace hook 0xAF0. At present, the standard trace only includes open, close and ioctl activity. The ststrc facility provides more detail, but the system level trace is integrated with other system activity. KNOWN PROBLEMS IN 4.004: 1. SCSI callbacks and timers are not MPSAFE and remain funneled. Software Version (4.003.00) 1. Fixed system crash due to a NULL line pointer in wput() (Failure ID 1652). 2. Fixed EtherLite crash on Error 64 due to receiving over-limit packet size (Failure ID 1669). 3. Fixed a bug in cdupdate, which can not download firmware for SC-1600/ST-1600 (Failure ID 1959). 4. Working arround for SCSI devices configuration problem on certain kind of machines such as 590 and 591 which do not use NCR's SCSI chip set (Failure ID 1716). Accessing SCSI_READ_BUFFER on those machines causes SC_HOST_IO_BUS_ERR. As a consequence of the working arround, cdupdate can not be used on those machines until the problem is cleared. Software Version (4.002.00) 1. Port the driver to AIX 4.3.2. Now the driver supports all releases of AIX 4.1 (up to 4.1.5), AIX 4.2 (4.2.0 and 4.2.1), and AIX 4.3 (4.3.0, 4.3.1, and 4.3.2). Software Version (4.001.00) 1. Added support of T43 features for ELS units through automated configuration method (CD Bug ID 345). Software Version (4.000.00) 1. Starting at this release, the driver package will include two installation images: InstImage41 (for AIX 4.1 and 4.2) and InstImage43 (for AIX 4.3). The "Install" script will automatically choose the right image to install based on the OS level of the host. After installation, the driver "stsdd" will show a version like 4.1.x.x in AIX 4.1 and 4.2 and 4.3.x.x in AIX 4.3. Its third and fourth fields of the version number will match with the second and third fields respectively of the driver package's release version. 2. Changed copyright, documentation and device names to meet Digi's requirement. 3. Changed stsopen routine to use a global timer blocking all open calls when unit is offline. This fixes system hang problem in MP machines. 4. Added "cdipserv" utility. Software Version (3.009.00) 1. IP and MAC address are verified when defining/configuring a EtherLite unit. If either the same IP address or same MAC address has been asigned to another network device, the EtherLite can not be defined/configured. This fixes Bug 328. 2. Fixed stack overflow problem in ctf_pend_ioack() which caused a C20 machine to crash. 3. Added mutex protection in open routine to prevent the NULL back pointer problem which caused a MP machine crashing. (Call number 2334). 4. Fixed the init respawning caused by ERR_BUSY in EtherLite. This problem happened when two hosts try to open the same port in an EtherLite. This will naturally fix the problem of "wtmp file filling disk due to els entries". (Call number 2322). Software Version (3.008.00) 1. The driver is ported to AIX 4.3. So it can support all levels of AIX 4. 2. Buffer size of FAS_SEND now can be changed dynamically based on the RTT of unit poll packets. This meets the output need of a slower network such as a WAN using Fram Relay protocol. 3. Fixed a bug during internal test. This bug crashes system by leaving a timer uncleared when remove a line over a slow network. 4. The timeout/delay function table is increased to 1024 entries to accommodate the situation that massive lines are located in units over a WAN. 5. Hardware address of a EtherLite device can be changed via SMIT without losing current configurations of unit and lines. Software Version (3.007.00) 1. Release 3.006.00 was accidently compiled in AIX 4.2.1 environment and would not work in AIX 4.1.x. 2. Now clocal is a default attribute for runmode and logmode of rs422.sts ports. Software Version (3.006.00) 1. This release fixed the XON/XOFF stick problem (CD Bug ID 215). 2. Fixed modem signal toggling problem on close when -HUPCL is set. This bug (CD Bug ID 299) caused tip to fail on exit. 3. Fixed failures of internal tests on multiple open-close and POSIX tcsetattr 11. 4. Fixed Bug 301, which prevented cfgststty to build a parallel port for el8+. 5. Added support of FAS_EXT_PARAM command and the baud extension can be set to as high as 460800 bps. 6. Added support for new devices ST-1400B, ST-1800B, and ST-1800B+. 7. Some SCSI device names are changed as following in the ODM: st1400A (scsiServer ST-1400A) to st1400x st1800A (scsiServer ST-1800A) to st1800x st1800A+ (scsiServer ST-1800A+) to st1800+ IF YOU HAVE THESE DEVICES CONFIGURED, PLEASE REMOVE THEM BEFORE INTALLING THE NEW DRIVER AND RECONFIGURE THEM AFTER THE DRIVER INSTALLATION !! 8. Etherlite device el8 (EtherLite 8 Port Server) is removed from the ODM. Software Version (3.005) 1. Fixed a bug when an Etherlite unit is offline and its ports are configured with login enabled, unconfiguring the ports or killing the getty processes would panic the system. 2. This release has been tested on AIX 4.2.1 and AIX 4.1.5. As noted in release notes for v3.004, to ensure the installed devices functions correctly, the following patch NEEDS to be installed in your system: For AIX 4.2.1: fix patch IX65073 For AIX 4.1.5: fix patch IX66797 If the patch is not included in your system installation media you can find it or suitable patch for your OS level in IBM's AIX Fix Distribution page at http://service.software.ibm.com/aix.us/fixes?lang=english Software Version (3.004) 1. Changed the printer device names to those exactly supported by the native ports. (CD Bug 233). This also eliminates the problem in listing some printer types when adding a printer queue via SMIT. 2. Fixed the "run out of packet" problem which happened in ioctl flurry test and hung the system. This also fixes the system panic problem when backup and printing in the same SCSI bus (CD Bug 256). 3. Internal tests discovered that the system sometimes hangs on closing a parallel port. This problem is fixed in this release by re-arranging the interrupt priority in the close routine. 4. The TTY/Printer interface of rs422.sts now is add to SMIT panel and the ODM, so it can be configured via SMIT. Devices with rs422.sts support are marked in its description field. 5. Installation script is changed to install the driver package only. Any device configuration needs to go through SMIT. (CD Bug 252) 6. The installation package now employes AIX 4 format. The related file systems will be automatically expanded during the installation if more space is required. 7. New device EL-2 and new model ST-1616B, ST-1000/ST-1616b, ST-1008S, ST-1002S and EL-16E1 are supported. NOTE: This release has been tested on AIX 4.2.1 and AIX 4.1.5. To ensure the installed devices functions correctly, the following patch NEEDS to be installed in your system: For AIX 4.2.1: fix patch IX65073 For AIX 4.1.5: fix patch IX66797 If the patch is not included in your system installation media you can find it or suitable patch for your OS level in IBM's AIX Fix Distribution page at http://service.software.ibm.com/aix.us/fixes?lang=english Software Version (3.003) 1. This patch can support 128 Etherlite units in one system. 2. Added Simple_lock to serialize access to the circular queue in a MP system. 3. Added support to new devices ST-1622, EL-160, and EL-162 4. Now driver can be removed via SMIT. (CD Bug 228). 5. Internal test discovered that the model_name's default values in the ODM database does not meet the requirement of the configuration methods. This problem is fixed by re-organizing the devices based on their model_name attributes and port numbers. Software Version (3.002) 1. Updated configuration entries for printers in the SMIT menu. Printers supported by the IBM internal ports are all supported by this release. (CD Bug 186, Call 1623) 2. DCD no longer required to use RTS/CTS flow control, matching the way the IBM internal serial port operates. Some printers which use RTS/CTS do not drive DTR. (CD Bug 200, Call 1704) 3. Fixed getty processes thrashing problem. This bug (CD ID 217) occurred when configured Etherlighgt unit(s) is offline and the tty port(s) is running in login-enabled mode. 4. Changed timer function sts_delay() to handle more timer events. 5. Fixed a problem of an ELS offline condition might cause the host system to panic. 6. New devices: ST-1032 and EL-32 are supported. (CD Bug 221) 7. SMIT configuration menu for devices were reorganized for easier installation and sorting processes were added for some lists in the smit menu. ST-1610 entry was deleted. ST-1800P, ST-1800A+, and ST-8008 were combined with ST-1008 family. ST-1600 and ST-1016 family were expanded to adapt relative devices. 8. Printers now can be configured to support printing 0 lines per page. (Call 1891) 9. Check and act on ERR_INITD condition, which occurs when 2008 unit is power-cycled. The correct action is to take open lines offline, which eventually results in processes to receive a hangup signal. (CD Bug 194, Call 1680) 10.When serial port is configured as a serial printer (e.g. "lp1"), packet buffer for that line is set to 3/4 of the maximum buffer size to improve performance, rather than 1/10 of baud rate figure we use for "normal" tty lines. 11.Fixed rmdev panic when 16 lines configured on smaller or non-existent unit. Software Version (3.001) 1. Port driver to AIX 4.2. Due to removal of tioc in STREAMS, changes were required for proprietary unit ioctls. 2. This driver is also made to be backwardly compatible with AIX 4.1.x. 3. Fixed bug ID 167 that caused system to crash when SCSI Server's target ID is set to 4. 3. Added support for EtherLite 8 port server. In this release, the parallel printer port on EL-8+ is not supported. Software Version (2.003) 1. Fixed a bug that caused system to crash at boot time when one of SCSI server units was previously configured and currently powered off. 2. Fixed a potential problem in driver's open & close delay function. 3. "dinc" utility program added to the distribution. Software Version (2.001) 1. This release is for adding Central Data's EtherLite products support. The EtherLite products currently supported are: EL-16 16 Port Server EM-16 16 Port Modem Server EM-8 8 Port Modem Server Software Version (2.002) 1. Fixed bug introduced in prior release in tracking maximum message space in message packets which could cause SCSI adpater errors. Setup.txt, setup.html and other html files are also added to the distribution. Software Version (1.004) 1. Removed the code that always set 'clocal' for printer devices. 2. In tylib.c, the printer device was still open when 'splp' was invoked, this would cause 'splp' to fail in changing printer attributes. It has been fixed by closing the printer device before invoking 'splp'. 3. In sts.c, at device close time, if output is locally stopped, we need to unconditionally resume the output so that we don't get stuck in waiting for output to drain. 4. The 'cddiag' program was improved that now it displays the internal termios data structure for each line. Software Version (1.003) 1. This release is for AIX 4.1.3 port. Due to the fact that several source modules of our scsiServer configuration programs use the "strtok" standard C function and on AIX 4.1.2 the "strok" function defined in standard C library was changed from reentrant to non-reentrant, it caused failure on configuration of printer devices. The fix is add a local reentrent function called "my_strtok" in cfgtools.c and replace "strtok" with "my_strtok" in all config source modules. 2. The SCSI bus id used to be determined by the fifth character of the device name of parent SCSI adapter, e.g. 'scsi0', 'scsi1', etc. This might cause problem on some system that has SCSI adapter device name such as 'vscsi0'. A quick solution has been adopted by using the last character of the device name as the bus id. This is not a good solution since there might be some systems that have these SCSI adapter devices configured in their system, 'scsi0', 'vscsi0', etc. Will look into a better solution when these issues arises in the future. 3. The close timer was also shortened from 10 minutes to 5 minutes. 4. The support for 'hplj-3si' and 'hplj-4' printer devices were also added. Software Version (1.002) 1. Fixed a bug in the previous driver version that a memory region was referenced after it was freed. No obvious problem has been observed. Software Version (1.001) 1. This release of the stsdd driver does not support SMP (Symmetric Multi-Processing). KNOWN PROBLEMS in 1.001: 1. Scanning the SCSI bus causes SCSI adapter error. This is a bug in IBM AIX 4.1.1 SCSI Subsystem. If the SCSI bus is scanned, reboot the system before using the SCSI Terminal Server. 2. Occasionally a TTY port may hang requiring system reboot. This is a AIX 4.1.1 problem. 3. Non-compliance with POSIX Standard 7.1.1.8. This is a AIX 4.1.1 problem. @(#)README.STS 1.5 10/14/99