IBM Netfinity 10/100 Fault Tolerant Adapter Ethernet Device Driver Installation README File This README file contains the latest information about installing the ethernet device drivers for the IBM Netfinity 10/100 Fault Tolerant Adapter. CONTENTS ________ 1.0 Known Problems 2.0 OS/2 3.0 Windows NT 3.1 IBM PCI Hot Plug Solution 3.2 DMI Support 4.0 NetWare 5.0 SCO 5.1 Installation Procedures 5.2 Driver Options 6.0 Wincenter/Winframe 7.0 Diagnostics 7.1 Restrictions 8.0 Trademarks and Notices 9.0 Revision Summary 1.0 Known Problems ____________________ o In Windows NT, the DMI service (PCNET) startup mode defaults to "automatic". This will result in a warning message and an entry in the NT Event Viewer if the Windows DMI service layer is not installed. This will not cause any operational problems as the PCNET service is not required for normal adapter operation. The PCNET service is used for Hot Swap operations. Hot Swap also requires that the Windows DMI service layer is installed. To prevent the warning messages, change the startup mode of the PCNET service from "automatic" to "manual". This can be done by selecting 'Control Panel', then 'Services', then selecting the PCNET service, pressing the 'Startup...' button and making the appropriate change. o In Windows NT, some Hot Swap configurations with 2 or more IBM Netfinity Fault Tolerant plug-in adapters will not work properly. This problem does not affect failover configurations which do not use Hot Swap. The problem occurs when an IBM Netfinity Fault Tolerant adapter (either built-in or a plug-in adapter) which is not part of the Hot Swap pair occupies a lower PCI position than either adapter of the failover pair. The PCI position is defined by the bus number and the slot number. All devices and slots on the lower numbered PCI bus have a lower position than all devices and slots on the higher numbered PCI bus. For current Netfinity servers which support hot swap, the order of the PCI position is given below. See your system documentation for locating the PCI slots. Models 5500 and 5500 M10 Model 7000 M10 ------------------------ -------------- PCI slot 4 (bus 1) <-- highest position --> PCI slot 5 (bus 10) PCI slot 3 (bus 1) PCI slot 4 (bus 10) PCI slot 2 (bus 1) PCI slot 3 (bus 10) PCI slot 1 (bus 1) PCI slot 2 (bus 10) built-in ethernet (bus 0) PCI slot 1 (bus 10) PCI slot 6 (bus 0) PCI slot 10 (bus 4) PCI slot 5 (bus 0) <-- lowest position PCI slot 9 (bus 4) PCI slot 8 (bus 4) PCI slot 7 (bus 4) PCI slot 6 (bus 4) PCI slot 12 (bus 0) lowest position -------> PCI slot 11 (bus 0) As an example in the model 5500, a Hot Swap pair consisting of 2 IBM Netfinity Fault Tolerant plug-in adapters located in PCI slots 1 and 2 would not work properly. This is because the built-in ethernet controller is not part of the pair and it occupies a lower position than either of the adapters in the Hot Swap pair. In the example, if the grouping where changed such that the Hot Swap pair consisted of the built-in ethernet controller and either of the IBM Netfinity Fault Tolerant plug-in adapters then the configuration would operate correctly. o If some cases, the ethernet controller does not establish good link with the hub or switch to which it is attached. This sometimes happens when all of the following conditions are true: - The ethernet controller is in auto negotiation mode (the default) - The hub or switch attached to the ethernet controller does NOT support auto negotiation - The length of cable between the ethernet controller and the hub or switch is between 35 and 42 meters In most cases, the ethernet controller can determine the line speed correctly even if the attached hub or switch does not support auto negotiation. If you are having problems use the device driver overrides to manually configure the ethernet controller mode to match the hub or switch mode. As with any adapter, if the hub or switch is configured for full duplex and does not support auto negotiation, then you must use the device driver manual overrides for proper operation. o In NetWare, proper operation of the failover function requires that adapters of the failover pair use the same interrupt. See the NetWare section below for additional details. o During driver installation for NetWare using the LDI file, the AUTOEXEC.NCF file will not be updated if driver load statements from a previous installation are present in the file. The AUTOEXEC.NCF file can be edited manually to make the necessary changes. o Under SCO, there is a bug during driver removal when using netconfig. Users have to manually remove the pnt directory under /etc/conf/pack.d. Otherwise, the next installation of pnt driver will not work. 2.0 OS/2 __________ The OS/2 device driver and associated files reside in the root directory. The OS/2 device driver can handle up to 4 ethernet controllers. These controllers can be configured as any combination of individual controllers and redundant pairs. Each adapter can only be part of 1 redundant pair. A redundant pair of network adapters can be defined such that a loss of good link status on the primary adapter will cause all ethernet traffic on this link to be automatically switched to the standby adapter. If the link for the primary adapter is restored, the sessions on the standby adapter will automatically switch back to the primary adapter. To enable failover operation, run the MPTS program and edit the AMD device driver parameters. Set the PermaNet Server feature to TRUE. Enter the parameters for the Primary and Standby slots. The slot number for the onboard adapter is E in the Netfinity 5500 server and 9 in the Netfinity 5000. To have a message written into IBMCOM\LANTRAN.LOG whenever a failover occurs, copy the file PCNETOS2.EXE onto the hard disk and edit the CONFIG.SYS file. Add the statement: RUN=c:\path\PCNETOS2.EXE to the beginning of the file, where c is the hard disk and path is the directory path that you copied the PCNETOS2.EXE file into. Once the machine is rebooted with the PCNETOS2.EXE statement active, PCNETOS2.EXE will be active and cannot be overwritten. To update the PCNETOS2.EXE file in the future, the user must first remove the above statement from the CONFIG.SYS file and reboot the machine. 3.0 Windows NT ________________ The Windows NT device driver and associated files reside in the A:\WINNT subdirectory. The driver under the NT subdirectory supports the failover function. A redundant pair of network adapters can be defined such that a loss of good link status on the primary adapter will cause all ethernet traffic on this link to be automatically switched to the secondary adapter. Two options are available for recovering from a failover condition. The option is determined by a check box in the adapter configuration panel. If the IBM Netfinity Hot Plug PCI for Windows NT 4.0 package is installed on the machine, an extra box will appear on the configuration panel called "Enable for DMI / Hot Swap Support". Users who do not have the IBM Netfinity Hot Plug PCI for Windows NT 4.0 package installed on their server will not see the "Enable for DMI / Hot Swap Support" box in the panel. NOTE: The order of installation is important. The IBM Netfinity Hot Plug PCI for Windows NT 4.0 package must be installed before the IBM Netfinity 10/100 Fault Tolerant Adapter driver is installed. If the adapter device driver is installed before the Hot Plug package, the adapter device driver will not see the Hot Plug code. This happens because the adapter device driver only checks the NT registry for the Hot Plug package during installation. If the Hot Plug package is added after the adapter device driver is installed, the adapter must be removed and re-added in order for it to detect the Hot Plug package. If "Enable for DMI / Hot Swap Support" is not checked or is not present at all, traffic will automatically switch back to the primary adapter when the primary link status is restored. In this mode, hot swap of the adapter is not possible. Users with the IBM Netfinity Hot Plug PCI for Windows NT 4.0 package installed should check the "Enable for DMI / Hot Swap Support" box. If the box marked "Enable for DMI / Hot Swap Support" is checked, traffic will remain on the secondary adapter until the user directs it to return to the primary adapter. This can be done after the hot swap replacement of the primary adapter or by using DMI services. The NT device driver can handle up to 4 ethernet controllers. Two of these controllers can be configured as a redundant pair. Please note the restrictions listed in the Known Problems section above. To enable failover operation, select Settings from the Start menu. Then select Control Panel, then Network, then Adapters. Highlight the IBM Netfinity AMD PCNet Ethernet Controller and press the Properties button. Check the Grouping box and designate the primary and secondary adapters. The onboard controller is located at bus 0, slot 14 in the Netfinity 5500 server. For the Netfinity 5000 the onboard controller is located at bus 0, slot 9. If a failover occurs, a message will be written to into the NT Event viewer and a DMI alert will be generated. 3.1 IBM PCI Hot Plug Solution ----------------------------- The WINNT subdirectory includes the device driver files that support the IBM PCI Hot Plug PCI for Windows NT 4.0 package. The IBM PCI Hot Plug PCI for Windows NT 4.0 package ensures high availability on PCI Hot Plug-compatible IBM servers. With IBM PCI Hot Plug, you can Hot Add to install and configure a new adapter while the system is running, Hot Swap to replace a faulty redundant adapter while the System is running, and monitor the status of Hot Plug PCI slots on your server with the IBM PCI Hot Plug Applet. Note that Hot Plug and Hot Swap are separate services in Windows NT. You cannot Hot Swap an adapter using the Hot Plug service. In order to use Hot Plug, it is necessary to install the Intel DMI SDK (see www.dmtf.org for more information) and the IBM PCI Hot Plug software (available at www.ibm.com/pc/support/netfinity). The DMI software must be installed before Hot Plug or Hot Swap will work. After a Hot Add of a NIC Card, the MAC addresses are returned as all zeros (000000000000). This does not affect the abilities of the adapter. The Hot Remove feature is NOT supported. It is highly recommended to perform any of the PCI Hot Plug features during low traffic. After a Hot Add of an adapter, the Windows NT applications (Network Applet and SCSI Applet) will ask the user for a Reboot. No reboot is necessary! 3.2 DMI Support ----------------- DMI is supported under Windows NT. The device driver component, PCNET.MIF, and the instrumentation code, PCNET.EXE are located in the A:\WINNT subdirectory. To install DMI support under Windows NT, install the Intel SDK. Then install a DMI browser of your choice. Information on these items is available at www.dmtf.org. The files from the A:\WINNT subdirectory will be copied onto your hard disk during installation. The PCNET.EXE instrumentation code will be started in the background each time the machine is rebooted. Open the DMI browser and follow the steps necessary to add the PCNET.MIF component. Once the AMD PCNet component is installed, you can select it and view any parameter with the browser. NOTE: If more than 1 AMD controller is located in the system, the browser will only show values for one of them. 4.0 NetWare _____________ The IntranetWare device driver and associated files reside in the A:\NOVELL subdirectory. The NetWare 3.X driver is found in the A:\NOVELL\VER3_X subdirectory. NOTE: The rest of the discussion in this section applies only to IntranetWare and later systems. The NetWare device driver can handle up to 4 ethernet controllers. These controllers can be configured as any combination of individual controllers and redundant pairs. Each adapter can only be part of 1 redundant pair. The NetWare driver complies with the ODI 3.31 specification and requires the following minimal level of NetWare load modules for proper operation: MSM.NLM version 3.80a ETHERTSM.NLM version 3.67a Updated versions of these modules are available on this diskette. The ethernet controller supports auto-negotiation on the ethernet link. To override auto-negotiation and manually specify the mode, load the driver with the appropriate parameter as follows: LOAD PCNTNW LINESPEED=x where x is either 10H, 10F, 100H, 100F, or AUTO. 10H = 10 Mbits/sec, half duplex 10F = 10 Mbits/sec, full duplex 100H = 100 Mbits/sec, half duplex 100F = 100 Mbits/sec, full duplex AUTO = auto negotiation The NetWare driver supports both hot plug and failover operation. See the note below for important configuration requirements. To enable failover operation from the console prompt, enter the following command: LOAD PCNTNW PRIMARY=d SECONDARY=e where d is the slot number of the primary adapter and e is the slot number of the secondary adapter. The slot number of the onboard adapter can vary depending on the configuration of the machine. To determine the onboard slot number, load the driver with no parameters. You will be prompted with a list of slot numbers to choose from. The onboard adapter will have a slot number greater than or equal to 10,000. Once the slot number is known, unload the driver and reload it using the failover parameters described above. A failover from the primary to the secondary will occur if a link failure condition is detected on the primary adapter. The failover status can be viewed in the custom counts fields of Monitor. If the link for the primary adapter is restored, the sessions on the secondary adapter will automatically switch back to the primary adapter. If a hot replace of the primary adapter occurred while traffic was being handled by the secondary adapter, an automatic failover back to the primary adapter will not occur once the primary link is restored. In this case use the following command to return the traffic to the primary controller: LOAD PCNTNW SCAN NOTE: The IBM Netfinity 5000 does not support hot plug operations on any slots, but does support the failover feature. For the failover feature to operate correctly the primary and secondary ethernet controllers must share the same interrupt. Interrupt assignments can be configured manually using the BIOS utilities which are available by pressing the F1 key during system booting. Hot added adapters should not require manual interrupt assignments. A hot added adapter will automatically be assigned the same interrupt as an identical adapter located in the machine at power up time. A hot added IBM 10/100 Fault Tolerant Adapter will adopt the same interrupt assignment as the on-board controller. Some .DSK drivers are not compatible with drivers written to the ODI 3.31 specification. In some cases, the failover feature will not operate correctly if the adapter associated with the .DSK driver shares the same interrupt as one of the ethernet controllers of the failover pair. It is recommended that the primary and secondary ethernet controllers do not share their interrupt with any other adapter or device, though this is not necessary in all cases. 5.0 SCO ______________ The SCOUNIX files reside in the A:\SCOUNIX.50 subdirectory. The file PNT.TAR contains the archive of all the files required to build the driver.o file. 5.1 Installation Procedures ----------------------------- For single processor systems: ----------------------------- 1. Ensure that the pnt driver can be installed from the CDROM using "netconfig". 2. Remove it, relink kernel and reboot. 3. Go to the directory /opt/K/SCO/pnt/5.0.4d/ID/pnt, remove and save the contents. Note: Depending on the OpenServer version, you may need to change the '5.0.4d' directory name in the above path. 4. Run the following steps. ndinstall -d pnt doscp a:\scounix.50\pnt.tar pnt.tar tar xvf pnt.tar >/dev/null 2>&1 rm pnt.tar ndinstall -a pnt 5. Relink and reboot. 6. Now install drivers for the AMD PCNet cards using netconfig menu options. For systems with multiple processors: -------------------------------------- Before installing the drivers, install an additional processor on the system (which already has SCO openserver 5.0.4d on it) by running CUSTOM menu options. Select SMP MultiProcessor installation and add the additional processor by entering the license number when prompted. Repeat the steps for each additional processor on the system. Relink kernel and reboot. Now follow the same steps mentioned above (for single processor systems) to install the pnt driver. Note: If there are warning messages when the driver tries to register its IRQs do the following: a. Run netconfig and remove the driver, link and reboot. b. For a pci device check the func#, dev# and bus# by "/etc/hw -vr pci" c. Now add the driver again by running netconfig. d. Ensure the above parameters match. The following values are correct for the onboard controller of the IBM Netfinity 5000: PNT_0_PCI_BUS 0 PNT_0_PCI_DEV 9 PNT_0_PCI_FUNC 0 Make sure they are not -1. The following values are correct for the onboard controller of the IBM Netfinity 5500: PNT_0_PCI_BUS 0 PNT_0_PCI_DEV 14 PNT_0_PCI_FUNC 0 Make sure they are not -1. 5.2 Driver Options ------------------- o Override auto-negotiation and automatic network port selection via keywords provided in space.c - To select a connecting medium, make only one variable from AUI, (internal) 10BaseT, or MII equal to '1'. If AUI, 10BaseT, and MII are all '0', then automatic port selection is activated. Only the MII port is supported on the IBM Netfinity 5500 and this port will be selected if automatic port selection is enabled. - To select 100 Mbits speed, set the variable SPEED100 to '1' in the space.c file. Set it to '0' to select 10 Mbits speed. - To select full duplex mode, set FULLDUP to '1' in the space.c file. Set FULLDUP to '0' for half duplex mode. o LED programming via keyword provided in space.h - The LED keyword is provided for knowledgeable users who want to override the default settings. If the user provides specific values for the LEDs in the driver's space.h file, then these values override the factory default values. The user specified values are then reflected by the adapter's LEDs. Go to the directory /etc/conf/pack.d/pnt/ in the system where the pnt driver config files are located. The space.h files contain the driver LED values. If the values are all 0xFFFFFFFF then the driver takes the default LED values from the EEPROM. The user can edit the space.h file to reflect the desired LED values. After the change is made, link the kernel by the command /etc/conf/cf.d/link_unix Reboot and when the system comes up the new LED value is reflected by the LEDs. 6.0 Wincenter/Winframe ________________________ The files required for Winframe 1.7a, Wincenter Connect 3.1, and Wincenter Pro 3.1 reside in the A:\WINCTR subdirectory. 7.0 Diagnostics _________________ The Diagnostic files reside in the A:\DIAG subdirectory. Please read the "Restrictions" section below before starting test. PCnet Diagnostic Utility Release 2.1 01/27/98 The elements of this diagnostic are: o Resources tests o Internal Loopback test o External Loopback test o Link test as Sender or Responder To execute the Test: o Copy both executables (AMDDIAG.EXE and ND_MAIN.EXE) to same sub-directory. o At DOS prompt, just type AMDDIAG. To generate a .LOG file for tests summary, then type AMDDIAG /log. o Follow the instruction on the screen to execute specific tests. o For tests summary, edit AMDDIAG.LOG at DOS prompt. o NOTE: the second log file generated by the test (ND_MAIN.LOG) is intended for debugging purpose and not recommended for end users. o Setup instructions to run Link Test - Two systems connected peer to peer. Run "Link Test as Responder" on one system. Wait for the "<==Responding" message to appear. Then run "Link Test as Sender" on the other system. Status of Pass / Fail will appear on the system running "Link Test as Sender". 7.1 Restrictions: ------------------ o The "Run ALL Tests" option will only execute the Resources tests, the Internal Loopback tests, and the External Loopback tests only. o When Link test is executed, the Link test as RESPONDER machine must be run first, wait for the "<== Responding" message, then run the Link Test as SENDER machine. o The Link test as RESPONDER machine can be terminated with a hit of any key on the keyboard. o A Loopback Plug is required to run the External Loopback Test. o External loopback test is not available for PCnet Fast and PCnet Fast+ adapters that are forced to a link speed of 10Mbs. This is when the adapter is connected to a 10Mb Hub or a loopback plug is not connected. 8.0 Trademarks and Notices ____________________________ The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM OS/2 Netfinity Microsoft and Windows NT are trademarks or registered trademarks of Microsoft Corporation. AMD, PCNet, and PermaNet are trademarks or registered trademarks of Advanced Micro Devices, Inc. NetWare and IntranetWare are registered trademarks of Novell Corporation. SCO is a registered trademark of Santa Cruz Operations. Intel is a registered trademark of Intel Corporation. Winframe is a registered trademark of Citrix Corporation. Wincenter Connect and Wincenter PRO are trademarks or registered trademarks of NCD, Inc. Other company, product, and service names may be trademarks or service marks of others. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. 9.0 Revision Summary _____________________ Changes made in this diskette, version 2.07: - OS/2 driver version 4.05 (root directory) 1. Added support for the PCnet Fast-III controller. 2. Added support for multiple switch configuration for PermaNet Server Link Fault Tolerance (LFT) feature. 3. The Netstat -n command will report the proper speed at which the controller is operating. 4. Fixed performance problem when sharing PCI interrupt. - NetWare driver version 4.16 (Novell directory) 1. This 32-bit ODI driver supports multiple switch configuration for PermaNet Server Link Fault Tolerance (LFT) feature. 2. Support for PCnet-FAST III device has been added to this driver. - SCO driver version 4.02 (SCOUNIX.50 directory) 1. Driver works with shared IRQs. 2. Driver works on multi-processor systems. 3. Modified the pnt-pci file to have more options for the pci ID. - Wincenter/Winframe driver version 4.04 (WINCTR directory) 1. This version of the driver has added support for the EXTPHY keyword. With the use of the EXTPHY keyword, one may set the speed and duplex mode of the controller. 2. This driver supports the PCnet Family controllers including the PCnet-Fast III controller. - Windows NT driver version 4.09 (WINNT directory) 1. Support for Unattended Windows NT installation added to the default OEMSETUP.INF file. 2. Added support for multiple switches for PermaNet Server Link Fault Tolerance (LFT) feature. 3. OEMSETUP.INF file has been modified to fix a bug, appearing during a fresh installation of Windows NT, which gave an error that the pcnet.exe file is missing. 4. RC file has been changed so that the driver reports the correct version information under Windows NT. - DMI Instrumentation changes 1. The DMI instrumentation has been enhanced to support event generation. This feature works with the PermaNet Server driver. When a failover occurs and the backup adapter takes over the functions of the failed adapter, a DMI indication is sent to the DMI Service Provider to notify the user that the Primary adapter has failed. Similarly, if the Primary Adapter comes back on line, network traffic is switched back to the Primary adapter and another DMI notfication is issued. 2. The DMI component instrumentation now detects the presence of the DMI service layer. So no messages (from the operating system) are displayed if the service layer is absent. 3. DMI instrumentation gets automatically installed when the driver is installed.