Dear SCO Customer, Support Level Supplement (SLS) ptf7604e, the Hot Plug NIC Supplement for UnixWare 7.1.1, adds support for hot plugging of NICs in the system, and delivers fixes for non-Hot Plug issues. In addition to this SLS, the PCI Hot Plug feature also requires the necessary hardware support for PCI Hot Plug and a platform-specific Hot Plug controller driver. Once you have installed SLS ptf7604e, follow the instructions included below for adding, suspending, resuming and removing hot-pluggable NICs. Additionally, make sure to read the "Important Notes" section included below for additional information. All of the problems below are addressed in SLS ptf7604e. SLS ptf7604b addressed these issues: 1. NIC cards could not be installed on non-GUI bases. 2. SLS ptf7604a did not allow configuration of a d140 NIC Driver. 3. The order of nameserver entries changed after adding a network interface using netcfg. 4. A SCOadmin client in charm mode cannot add IPs to /etc/hosts. SLS ptf7604c addressed this issue: 5. After a CPU upgrade, a panic occurs during boot-up. If the boot HBA is changed on an installed system to a compatible HBA with a different BRDID, then the confmgr fails to locate the boot HBA in the resmgr, and boot fails. SLS ptf7604d addressed this issue: 6. There are problems invoking "scoadmin client". SLS ptf7604e additionally addresses this issue: 7. PPCARD devices cannot be autodetected properly. Adding NICs =========== a. Insert the NIC into an empty PCI slot that is not powered on and connect the cables. b. Lock the interlock (if it has one). c. Run SCOadmin and, from the Hardware folder, select the Hot Plug Manager. d. You should see a board icon in the slot where you put the NIC. Select this slot and, from the Operations menu, select Power On. e. After a pause, you should see a link under the board icon to a line that says: "Unbound Network device; Ethernet controller". Select this line and, from the Operations menu, select Add Driver. f. You are then prompted to select a driver appropriate for your hardware from a list of driver(s) compatible with the newly added adapter. g. For some drivers, you will be prompted with the "Network Driver Configuration" screen. See the driver documentation for any modifications specific to the driver configuration. h. After a pause during which the device initializes, you are prompted to add a protocol or to configure the device as a backup for another device in the system. i. If the new device is configured for backup, you will be prompted to select an existing networking interface that is to be backed up. If the new device is configured for TCP/IP, you will be prompted for the IP configuration for this interface. After entering this information and pressing OK, you will see a dialogue confirming the successful addition of your new NIC. j. After pressing OK, you should see the main display of the Hot Plug Manager updated to show the new device as: Bound Network device; Ethernet controller --> Driver Name: xxx where xxx is the system name of the driver you selected. Issue the following commands to verify that the NIC is operational: ifconfig -a ndstat ping Suspending a Configured NIC =========================== a. To suspend I/O on a configured NIC, start the Hot Plug Manager from SCOadmin. b. Select the device you want to suspend and select the Suspend Driver option from the Operations menu. After a short pause, the display changes to show that the selected device is now unbound; you will see an entry in the Suspended Driver Instances box similar to: Driver Name: xxx Suspended ID: yyy where xxx is the name of the suspended driver and yyy is the suspended ID. c. Issue the following commands to verify the driver is suspended: ndstat ping Resuming a Suspended Driver Instance ==================================== You can resume a suspended driver instance either by selecting an unbound device in the Hot Plug Manager and choosing the Resume Driver option from the Operations menu, or by selecting the suspended instance from the Suspended Driver Instances box and choosing the Resume Driver option from the Operations menu. In the former case, you will be given a list of appropriate suspended driver instances for that device to resume. In the latter case, you will be given a list of appropriate devices to resume the suspended driver instance on. Appropriateness is determined by calling the drivers verify routine. This routine will usually check the board ID of the device to see if the driver can support the device. The resume operation is supported for functionally identical adapters only. It is recommended that the resume operation be performed as soon as possible after a suspend operation. Therefore, it is important to have a functionally identical replacement adapter available before performing the suspend operation. Removing a Device ================= You can only remove a device using the Hot Plug Manager by suspending it first. Once the driver is suspended, select the suspended instance in the Suspended Driver Instances box and then choose the Delete Driver option from the Operations menu. It is recommended that you unmount all mount points that are serviced by the device(s) being removed before the suspend-remove sequence. Important Notes =============== a. While doing a cross-resume (suspend I/O on 2 ports and resume the suspended I/O from port A on port B and vice versa), the resume operation will succeed but the GUI will show it as "Unbound Network Device". In this scenario, the device has successfully resumed the I/O, but the GUI is displaying the incorrect information. b. The GUI will quit while doing an add operation if there are no "addable" drivers available on the system. The user will have to pkgadd the driver before proceeding. c. The GUI will quit while doing an add operation, if the "cancel" operation is selected in the "Network Driver Configuration" window. This is the window that allows the user to specify "Advanced Options". Choosing "cancel" in subsequent window(s) will allow the user to back out of the add operation. It is recommended that the user restart the GUI if the add operation is canceled at any stage. d. If _all_ the drivers (of the same type) are suspended, deleting one will result in not being able to resume the others, and the message "There were no compatible devices found" will display. Contents -------- /etc/conf/bin/idcheck /etc/conf/bin/idinstall /etc/conf/pack.d/confmgr/Driver_atup.o /etc/conf/pack.d/confmgr/Driver_mp.o /etc/conf/pack.d/hpci/Driver_atup.o /etc/conf/pack.d/hpci/Driver_mp.o /etc/conf/pack.d/mod/Driver_atup.o /etc/conf/pack.d/mod/Driver_mp.o /etc/init.d/inetinit /usr/lib/libhpsl.a /usr/lib/libhpsl.so /usr/lib/ncfglib.tlib /usr/lib/netcfg/bin/ncfgBE /usr/lib/netcfg/bin/ncfgUI /usr/lib/netcfg/bin/ndcfg /usr/lib/netcfg/init/tcp /usr/lib/scoadmin/ncm/hosts.tlib /usr/lib/scoadmin/hotplug/PCIBE /usr/lib/scoadmin/hotplug/hotplugGUI /usr/sbin/netcfg /sbin/aconf1_sinit Software Notes and Recommendations ---------------------------------- SLS ptf7604e should only be installed on: UnixWare 7 Release 7.1.1 Installation Instructions ------------------------- 1. Download the ptf7604e.Z file to the /tmp directory on your machine. 2. As root, uncompress the file and add the SLS package to your system using these commands: $ su Password: # uncompress /tmp/ptf7604e.Z # pkgadd -d /tmp/ptf7604e # rm /tmp/ptf7604e Alternatively, this SLS package may be installed in quiet mode, that is, without displaying the release notes and asking for installation confirmation. To do this, use these commands: $ su Password: # uncompress /tmp/ptf7604e.Z # pkgadd -qd /tmp/ptf7604e all # rm /tmp/ptf7604e 3. Reboot the system after installing this SLS package. The release notes displayed prior to installation can be found in: /var/sadm/pkg/ptf7604/install/ptf7604.txt Removal Instructions -------------------- 1. As root, remove the SLS package using these commands: $ su Password: # pkgrm ptf7604 2. Reboot the system after removing this SLS package. If you have questions regarding this SLS, or the product on which it is installed, please contact your software supplier.