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 New Features 5.2 Installation Procedures 6.0 Wincenter/Winframe 7.0 Diagnostics 7.1 Restrictions 8.0 Trademarks and Notices 1.0 Known Problems ____________________ 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 Some configurations of the failover function do not operate correctly with the NetWare driver. 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. Note that this parameter is case sensitive and must be entered in upper case. 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 Hot Swap services are installed on the machine, an extra box will appear on the configuration panel call "Enable for DMI / Hot Swap Support". Users who do not have Hot Swap services installed on their server will not see the "Enable for DMI / Hot Swap Support" box in the panel. If box marked "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 hot swap services 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. 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. 3.1 IBM PCI Hot Plug Solution ----------------------------- The WINNT subdirectory includes the device driver files that support the IBM PCI Hot Plug Solution. The IBM PCI Hot Plug solution for Windows NT 4.0 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. You cannot Hot Swap an adapter using the Hot Plug service. You can download the DMI agent and the IBM PCI Hot Plug software from www.ibm.com/pc/support/netfinity. The DMI agent must be installed before Hot Plug or Hot Swap will work. After a Hot Add of a NIC Card, the MAC addresses are being 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. DO NOT REBOOT! 3.2 DMI Support ----------------- DMI is currently 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 a third party service layer code. Then install a DMI browser of your choice. 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 These versions 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. 5.1 New Features ------------------ The file PNT.TAR contains the archive of all the files required to build the driver.o file. The features added from the previous version of the AMD SCO drivers and instructions on their usage are: Revision 4.01: 1. Modifications due to a warning from idistributed routine on some platforms. Changed the space.h file and altered the installation procedure. 2. Changed Space.c file to allow autonegotiation as the default mode. 3. Changed pnt-pci file to increase device number range to 24. Release 4.0: o 96bit IPG 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. 5.2 Installation Procedures ----------------------------- The current 4.01 release does come with its own installation scripts. To install, users should do the following steps: - Go to the directory /opt/K/SCO/pnt/5.0.4d/ID/pnt/. - Move/Copy all the files and directories into a safe directory. - Copy the pnt.tar file of the current release in this directory. - Untar it with the command: tar xvf pnt.tar This overwrites the older driver. - Link the kernel /etc/conf/cf.d/link_unix. - Reboot. - Now run netconfig and bind with TCP/IP to install the new 4.01 driver. - Link kernel when netconfig prompts. - Reboot, and the system comes with the new 4.01 driver. 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. 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. 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. Revision History 4/15/98 Original release 6/05/98 Update for 1.01 driver release 8/12/98 Update for 2.0 driver release 8/22/98 Update for 2.01 driver release 9/26/98 Update for 2.02 driver release