Dear SCO Customer, Support Level Supplement (SLS) ptf7066c, the I2O Subsystem Patch and HBA for UnixWare 7.0.1, 7.1.0 and 7.1.1, addresses all of the issues listed below. SLS ptf7066a addressed these issues: 1. Some I2O-enabled cards do not function correctly with the existing I2O subsystem. 2. There is no LAN class support. 3. Numerous technical improvements have been made to the internal workings of the I2O subsystem which should result in better compatibility with new I2O devices. SLS ptf7066c additionally addresses this issue: 4. In some circumstances, it was possible for some caching RAID controllers to fail to fully flush their buffer quickly enough during system shutdown, resulting in the RAID array needing repair upon reboot. Software Notes and Recommendations ---------------------------------- SLS ptf7066c should only be installed on: UnixWare 7 Release 7.0.1, 7.1.0, 7.1.1 SLS ptf7066c was written to Version 1.5 of the I2O Architecture Specification. SLS ptf7066c obsoletes and replaces SLS ptf7067e and SLS ptf7429a. If these SLSs are already on the system when ptf7066c is installed, they will be locked into place and their removal will be prevented. If the obsoleted SLSs are not installed when ptf7066c is installed, their installation will be prevented and any attempt to install them will fail. Upgrade Paths ------------- If the system is a UnixWare 7.0.1 system and an upgrade to UnixWare 7.1.0 is applied, SLS ptf7066c must be reapplied. This should be done when the UnixWare 7.1.0 upgrade is complete, but BEFORE the system is rebooted. If the system is a UnixWare 7.1.0 system and an upgrade to UnixWare 7.1.1 is applied, SLS ptf7066c must be reapplied. This should be done when the UnixWare 7.1.1 upgrade is complete, but BEFORE the system is rebooted. When a new component is added, or an older one upgraded, the system may prompt to reapply the UnixWare 7.0.1 (or UnixWare 7.1.0 or UnixWare 7.1.1) update. In either case, you must also reapply SLS ptf7066c, after the update, but BEFORE the system is rebooted. (If you change any variables in the space.c file, check and correct them after each reapplication of ptf7066c). To reapply SLS ptf7066c execute the following commands: $ su Password: # pkgadd -d /ptfs/ptf7066c Installation Instructions ------------------------- 1. Become root and create a new directory by typing: $ su Password: # mkdir /ptfs # chmod 700 /ptfs # cd /ptfs 2. Download the ptf7066c.Z file to the newly created /ptfs directory on your machine. 3. Uncompress the file, and add the SLS package to your system using these commands: # uncompress /ptfs/ptf7066c.Z # pkgadd -d /ptfs/ptf7066c 4. Edit the file /etc/conf/pack.d/i2oOSM/space.c if required. (Read the Known Problems section below.) 5. Reboot the system after installing this SLS package. Removal Instructions -------------------- 1. SLS ptf7066c is NOT removable. Known Problems and Options -------------------------- 1. i2omsg The i2omsg driver is responsible for the initial communication with the I/O Processor on an I2O-enabled card. It has a number of timeouts which it uses to protect the system from hanging if an I/O Processor fails to respond during startup. The Unisys IntelliLAN card requires one of these values to be increased. In the file /etc/conf/pack.d/i2omsg, increase the value of BUFFER_GET_TIMEOUT to 6 seconds: unsigned long BUFFER_GET_TIMEOUT = 6 * 1000 * 1000; This version of the i2omsg message layer driver provides support for i2omsg.2.1 version interfaces. The i2omsg.2.1 version interface delivers the OSMMsgHaltRegister function to allow OSMs to register for processing to be completed during UnixWare shutdown. 2. i2otrans This is the transport layer driver (which sends and receives messages from the I/O Processor on the I2O card). This new version has the ability to hand off the processing of replies to a separate kernel thread, rather than processing them in the interrupt handler. On some systems, performance gain may be seen (actual gain depends on system activity patterns, loading, and so on) by enabling this feature. On an MP system, multiple threads (one per CPU that is online during startup) will be created. This feature may be disabled by changing the i2otrans/space.c variable i2otrans_use_threads to zero. (Its default is 1 to enable the option.) This version of the i2otrans transport driver will arrange for all IOPs under its control to receive an ExecSysQuiesce message followed by an ExecIOPClear message during UnixWare shutdown. 3. lanosm The lanosm is an OSM that supports LAN devices, both Ethernet and FDDI. It is automatically installed onto the system by SLS ptf7066c, but must be configured before it can be used. This is done as for any other network card using scoadmin (or netcfg). A known problem is that the network configuration tools don't set the TCP send and receive windows correctly with this driver. This has a severe impact on performance. After configuration is complete, type: ifconfig -a You should see an entry for the new interface similar to this: net1: flags=4043 mtu 1500 inet 150.126.30.202 netmask ffffff00 broadcast 150.126.30.255 inet/perf: recv size: 4096; send size: 8192; full-size frames:1 inet/options: rfc1323 ether 08:00:0b:e6:00:5f The recv size (4096) and send size (8192) should be increased to 24576. To do this, edit /etc/confnet.d/inet/interface directly. It should contain an entry for the newly added interface. The one corresponding to the example above is: net:1:150.126.30.202:/dev/net1: netmask 255.255.255.0 broadcast 150.126.30.255 perf 4096 8192 1:add_interface: Simply change the 4096 and 8192 fields to be 24576 and save the file. This will take effect after the next reboot. 4. Warning: in.i2odialogd Within this SLS package is an interface to allow access to the configuration dialog screens from a standard web browser. This uses a daemon that listens on an IP port. The daemon, as shipped, uses port 360 which has been assigned by IANA. From a browser (for example, Netscape, Internet Explorer or Mosaic) access this URL: http://:360/ You should be presented with an authorization box. In this release, you must use the user name "root" and give the root password for . Note: If you are doing all this on the same system you may use the name "localhost" as . To disable this feature, remove the i2odialog entries from /etc/inet/services and /etc/inet/inetd.conf. 5. i2oOSM The i2oOSM is both the I2O block storage and SCSI class OSM. It is responsible for controlling all SCSI and block storage devices connected to any I2O managed controllers, such as disk drives, tape drives, CD-ROMs, and Fibre Channel devices. Device mapping -------------- Block Storage class devices (mainly discs and RAID arrays) are presented to UnixWare as SCSI devices by i2oOSM. If the true SCSI ID of a device cannot be determined (or does not exist), i2oOSM will invent a "fake" one for the system to use. This will result in devices being reported in sdiconfig (and other utilities) with their "fake" address, which may not be the same as their real bus/id. All system utilities will use (and understand only) the "fake" address. Earlier versions of i2oOSM started the numbering of fake ids at ID31 and worked downwards. This causes problems with ISL. With this version of the i2oOSM, the default is to start at zero and work upwards. The old behavior can be reinstated by setting the space.c variable i2oOSManonBSmapUp to zero. It is recommended that systems that already have a working I2O-based disc subsystem should have this variable set to 0 in order to preserve their disc numbering. This should be done after the pkgadd of the SLS, but BEFORE the reboot. 6. DPT 5th Generation RAID Cards. The I2O specification is currently unclear on the exact meaning of some bits in a BsaBlockWrite message. This DPT family of cards currently uses a different interpretation of the cache bits than some other vendors. The Space.c file contains the variable i2oOSMBsaWrite2CacheDefault, which controls the setting of these bits. Setting the variable to non-zero significantly improves the performance of this family of cards, and appears to have no detrimental effect on other cards. It is shipped with the default set to 1. If you change its state, you must relink the kernel and reboot for it to take effect. Some versions of these DPT cards return an error from the initial Reserve commands that the i2oOSM sends down. These appear as a stream of errors from the discs running up the screen soon after the kernel starts. While annoying, these are harmless and hopefully will disappear with future firmware upgrades of these cards. If you have questions regarding this SLS, or the product on which it is installed, please contact your software supplier.