IBM xSeries 200 Imbedded 10/100 Ethernet Adapter Device Driver Installation README File This README file contains the latest information about installing Windows NT4 ethernet device drivers for IBM xSeries servers whose imbedded ethernet controllers are compatible with the Intel family of 10/100 ethernet adapters. CONTENTS ________ 1.0 Known Problems 2.0 Change History 3.0 Installation and Configuration 3.1 Windows NT 3.1.1 NT Setup for Adapter Teaming 3.1.2 Unattended Installation (Push) 3.2 Advanced Features 3.2.1 Adapter Fault Tolerance (AFT) 3.2.2 Adaptive Load Balancing (ALB) 3.2.3 Fast EtherChannel* (FEC) 3.2.4 Virtual LAN (VLAN) 3.2.5 Wake on LAN (WOL) 3.2.5.1 Troubleshooting Wake on LAN 3.2.6 Boot Agent 3.2.6.1 Parameters 3.2.6.2 Troubleshooting Boot Agent 4.0 Web Sites and Support Phone Number 5.0 Trademarks and Notices 6.0 Disclaimer 1.0 Known Problems ____________________ o None 2.0 Change History _____________________ Changes made in this diskette, version 3.8.2: - Support for native Intel adapters added. Changes made in version 3.7.2c: - Windows NT driver (root directory) 1. Fixed compatibility problem with gigabit fiber adapter. 3.0 Installation and Configuration ____________________________________ 3.1 Windows NT ---------------- Location of driver: \E100BNT.SYS (NDIS 4.0) \OEMSETUP.INF To install the driver do the following steps: 1) Double-click the Network icon in the Control Panel. 2) Select the Adapter tab. 3) Click Add. You'll see a list of adapters. 4) Don't select an adapter from this list. Instead, insert this diskette into the appropriate drive and click Have Disk. 5) Enter the appropriate drive for your disk media (A:, B:, etc.) and click OK. Select the IBM(R) PCI 10/100 Ethernet Adapter. Then follow the prompts to complete installation. When the adapter is added you'll see a new adapter listed in the Network adapters list. 6) Configure any desired adapter functions. 6) Click Close to finish and configure any protocols as prompted. 7) Restart Windows NT when prompted. 3.1.1 NT Setup for Adapter Teaming ---------------------------------- NOTE: Windows NT 4.0 Service Pack 5 or later is required for implementing Adapter Teaming properly in Windows NT. Install Service Pack prior to configuring Adapter Teaming. Teaming requires 2 or more compatible ethernet controllers. These controllers can include imbedded controllers or IBM Server Adapters. If connecting to a hub, each adapter in a team must be connected to a port which is in the same collision domain. If connected to a switch, each adapter in a team must be connected to a port which is in the same network. To enable teaming functions, do the following steps: 1) Double-click on the Network Icon in the Control Panel. 2) Select the Adapters tab and double-click the appropriate Intel- based adapter listing found in the Network Adapters list box. This will launch the PROSet utility. 3) Click on the Adapter Teaming tab and click the Add Adapter to a Team button. 4) At the Teaming Wizard dialog, select the type of team you want to create and click Next. 5) Add a check in the checkbox for each adapter you want as a part of the team and click Next. 6) Click Finish to apply your changes. 7) Click OK to close PROSet. You should notice a new listing in the Network control panel, which is the team you have created. 8) Click Close to close the Network control panel. Other configuration screens may appear. Configure as desired. 9) When prompted, restart Windows NT. 3.1.2 Unattended Installation Push ---------------------------------- The main objective of the Push Installation is to get the client properly connected to the Windows NT server before the installation begins using the NDIS2 driver, and to keep the same client connected using the NDIS4 driver after the Windows NT Workstation is installed without any end user action. The main steps of the process are: 1. Create a Network Installation Startup disk from the Windows NT Server and modify it for your adapter. 2. Create a shared directory for the Windows NT Workstation Installation files on the Windows NT Server. 3. Modify the UNATTEND.TXT installation script to automate the procedure and add the proper adapter installation and configuration information. 4. Integrate the adapter driver files into the Windows NT installation source files. 5. Perform the Unattended Setup booting with the prepared setup disk from the client system. The Procedure: 1) Prepare a Windows NT 4.0 server: a) Create a folder on the server's hard disk for the installation files (e.g., "NT40.INS"). Make this folder shared (e.g., with shared name "NT40.INS"). b) Create a user (e.g., "USERID" with a password "password") and grant read and view rights for the NT40.INS folder. 2) Use a CD-ROM drive at the Windows NT server and copy the i386 folder with Windows NT 4.0 installation files to the shared folder NT40.INS on this server (e.g., using the NT Explorer). 3) Create / Modify the installation answer file UNATTEND.TXT as required by your specific system and desired Windows NT configurations. A sample UNATTEND.TXT file with comments is included in the \UNATTEND directory of this diskette. The best place to put this file is in the root of your install disk, but the real requirement is just to specify the full path to this file in the AUTOEXEC.BAT for the WINNT command (see 6b) and 6m) below). 4) Create the \E100B directory: NT40.INS\i386\$OEM$\Net\E100B. 5) Copy driver installation files: Xcopy the contents of this diskette to the proper place under Adapter Device Driver folder (NT40.INS\i386\$OEM$\Net\E100B folder on the Windows NT server). This enables the installation program to find the same file structure as on the Drivers disk. Be sure to use the /s /e switches on xcopy. 6) On the Windows NT server, prepare the Microsoft Client Installation disk using the Windows NT Network Client Administrator: a) Prepare a system diskette (e.g., DOS 6.22: format a: /s). Do not use the Windows NT system disk. b) Copy the UNATTEND.TXT file that you modified to the client installation diskette as specified in 3) above (preferably to the root (a:\)). c) Use the Windows NT Administrative Tools (Common), start Network Client Administrator and choose "Make Network Installation Startup Disk". d) Set "Existing Path" to use the previously installed software for MS Client or, if it is the first time, create the shared directory on the server's hard drive, using the Windows NT 4.0 Server CD-ROM as a source (e.g., by copying from \client on the CD-ROM to c:\client). e) Choose "Network Client v3.0 for MS-DOS and Windows". f) Choose any of the Network Adapters from the list (e.g., NE2000 compatible). g) Set Computer name, User name, Domain and Network protocol when prompted. h) Select OK and wait while files are copied to the disk. i) Copy the proper ndis2 dos driver (E100B.DOS) to this disk in the \NET directory. E100B.DOS can be found in the \UNATTEND directory on this diskette. j) Modify A:\NET\SYSTEM.INI : netcard = E100B.DOS k) Modify A:\NET\PROTOCOL.INI : drivername = E100B$ l) Add a line: CACHEFLUSH = 1 just after the "drivername = E100B$" line. m) Verify or modify A:\AUTOEXEC.BAT to have the following commands: NET USE W: \\PST\NT40.INS W:\i386\WINNT /s:W:\i386 /u:a:\unattend.txt Note that W is an example for the logical drive mapped to the share on the Windows NT server. n) Remove the invocation of setup.exe from A:\AUTOEXEC.BAT. 7) Boot up your DOS client with the disk prepared above installed. After connecting to the network: a) Input "USERID" as a User name when prompted. b) Input "password" as a password when prompted. OR c) Modify the NET START line in the AUTOEXEC.BAT to: NET LOGON USERID PASSWORD /YES Sample Templates: 1) PROTOCOL.INI [network.setup] version=0x3110 netcard=ms$ne2clone,1,MS$NE2CLONE,1 transport=ms$ndishlp,MS$NDISHLP transport=ms$netbeui,MS$NETBEUI lana0=ms$ne2clone,1,ms$netbeui lana1=ms$ne2clone,1,ms$ndishlp [ms$ne2clone] drivername = E100B$ CACHEFLUSH = 1 ; CACHEFLUSH line is required ONLY IF NDIS2 does not shut down ; properly ;INTERRUPT=3 ;IOBASE=0x300 ;SlotNumber=1 [protman] drivername=PROTMAN$ PRIORITY=MS$NDISHLP [MS$NDISHLP] drivername=ndishlp$ BINDINGS=ms$ne2clone [ms$netbeui] drivername=netbeui$ SESSIONS=10 NCBS=12 BINDINGS=ms$ne2clone LANABASE=0 2. SYSTEM.INI [network] filesharing=no printsharing=no autologon=yes computername=COMPUTERNAME lanroot=A:\NET username=Administrator workgroup=DOMAIN reconnect=no directhost=no dospophotkey=N lmlogon=0 logondomain=DOMAIN preferredredir=full autostart=full maxconnections=8 [network drivers] netcard=E100B.DOS transport=ndishlp.sys,*netbeui devdir=A:\NET LoadRMDrivers=yes [Password Lists] *Shares=a:\net\Share000.PWL USERID=A:\NET\USERID.PWL 3. AUTOEXEC.BAT path=a:\net a:\net\net start rem a:\net\net logon userid password /yes net use W: \\133\nt40.ins W: cd i386 winnt /s:W:\i386 /u:a:\unattend.txt REFERENCES: 1. Microsoft Windows NT Resource Kit - Microsoft Press 19NT 2. Microsoft TechNet CD-ROM, April 1997 3. Microsoft support web page at http://support.microsoft.com/support Article ID : Q155197, Q156795 3.2 Advanced Features --------------------- 3.2.1 Adapter Fault Tolerance (AFT) ----------------------------------- Adapter Fault Tolerance creates a team of 2 - 8 controllers to provide automatic redundancy for your ethernet connection. If the primary controller adapter fails, a secondary takes over enabling you to maintain uninterrupted network performance. AFT is implemented with a primary controller and one or more backup, or secondary, controllers. These ethernet controllers can be the imbedded controller(s) in your server or IBM Server Adapters. During normal operation, the backup will have transmit disabled. If the link to the primary adapter fails, the link to the next backup adapter automatically takes over. 3.2.2 Adaptive Load Balancing (ALB) ----------------------------------- Adaptive Load Balancing creates a team of 2 - 8 controllers to increase transmission throughput. With ALB, as you add adapters to your server, you can group them in teams to provide up to a 800 Mbps transmit rate and a 100 Mbps receive rate, with a maximum of eight controllers. The ALB software continuously analyzes transmit loading on each adapter and balances the transmission across the adapters as needed. Adapter teams configured for ALB also provide the benefits of AFT described in the preceeding paragraph. Receive rates remain at 100 Mbps. To use ALB, you must have two to eight compatible network controllers installed in your server and all linked to the same network switch/segment. ALB works with any 100BASE-TX switch. 3.2.3 Fast EtherChannel* (FEC) ------------------------------ Fast EtherChannel* creates a team of 2, 4, 6 or 8 controllers to increase transmission and reception throughput. FEC is a performance technology developed by Cisco to increase your server's throughput. Unlike ALB, FEC can be configured to increase both transmission and reception channels between your server and switch. FEC works only with FEC-enabled Cisco switches such as the Catalyst 5000 series. With FEC, as you add adapters to your server, you can group them in teams, with a maximum of eight compatible controllers. The FEC software continuously analyzes loading on each controller and balances network traffic across the controllers as needed. Adapter teams configured for FEC also provide the benefits of AFT. To use FEC, you must have 2, 4, 6, or 8 compatible network controllers installed in your server and all linked to the same FEC-enabled Cisco switch. (Note that the switch must support more than 4 controllers in FEC in order for more than 4 controllers to work in FEC . Consult your switch documentation.) 3.2.4 Virtual LAN (VLAN) ------------------------ Virtual LAN is a logical grouping of network devices put together as a LAN regardless of their physical grouping or collision domains. VLANs let a user see and access only specified network segments. This increases network performance and improves network security. VLANs offer the ability to group users and stations together into logical work-groups. This can simplify network administration when connecting clients to servers that are geographically dispersed across the building, campus, or enterprise network. Typically, VLANs consist of co-workers within the same department but in different locations, groups of users running the same network protocol, or a cross-functional team working on a joint project. Joining workers with VLANs forms logical working groups. Normally, VLANs are configured at the switch and any computer can be a member of one VLAN per installed network adapter. The controller in your IBM server supersedes this by communicating directly with a switch, allowing multiple VLANs on a single adapter (up to 64 VLANs). To set up VLAN membership, your adapter must be attached to a switch with VLAN capability. 3.2.5 Wake on LAN (WOL) ----------------------- NOTE: The information in this section applies only to servers which implement the WOL function. Consult your server documentation. The Wake on LAN (WOL) feature of the server allows it to be powered-on remotely by a network management program. In some operating systems, it can also wake the computer from suspend mode. This is accomplished by sending a special type of data packet containing the adapter's specific Ethernet address. When the computer is powered off, the ethernet controller continues to operate by using standby power. As long as AC power is available to the power supply, the controller will draw standby power when the machine is powered off, allowing it to "listen" to the network for a wake up packet. 3.2.5.1 Troubleshooting Wake on LAN ----------------------------------- NOTE: The reception of a wake up packet will set the adapter to a special state. This condition must be reset before the adapter will accept another wake up packet and power-on the computer. The drivers for this adapter are written to reset this condition when they load. Once you have sent the computer a wake up packet and powered-on the computer, you must let a driver load or it will no longer accept any wake up packets. The only other way of resetting this condition is removing AC power from the computer for a short duration (~10 - 15 seconds). If the computer still will not power-on when a wake up packet is sent, check the computer's BIOS for power settings. If you are connected to a hub or switch, the link LED on the back of the adapter should be on, even though computer power is off. If the link LED it is not on, try powering the computer on. If the LED now lights, then the controller is not receiving power in standby mode. If this is the case, the computer may need to be serviced. If the link LED does not come on when the computer is powered-on, you have not established link with your hub or switch. Check your cabling or substitute it with a cable that has been verified to work correctly. Make sure your hub or switch is either 10baseT or 100baseTX and is powered-on and fully functional. If everything listed above is correct and the computer will still not respond to a wake up packet, your computer may need to be serviced. 3.2.6 Boot Agent ---------------- The Boot Agent is a utility program that is stored in a portion of system BIOS, allowing the ethernet controller to remotely boot the system from the network. The default method is PXE, a remote boot procedure defined by the "Wired for Management" specifications and used by powerful network management programs. Computers do not need to be Wake on LAN enabled to use this feature. When the computer is first powered-on, the Boot Agent will execute and display a message similar to the following, with the current version number: Initializing Boot Agent Version X.X Press Ctrl+S to enter the Setup Program.. By default, this message will display for 2 seconds, then attempt to boot from a local drive. If the attempt to boot from a local drive fails, the agent will attempt to boot remotely. To change the configuration of the Boot Agent, press the "Ctrl" key and "S" key simultaneously during the time that this message is displayed. This will bring up the Boot Agent configuration screen. NOTE: Depending on the current setup options, the "Press Ctrl+S" message may not appear. In this case the user can still press the "Ctrl" and "S" keys to enter the Setup Program. 3.2.6.1 Parameters ------------------ There are 5 configurable parameters. Follow the on-screen instructions to select, change and save the different parameters. The different parameters are explained below, with the default parameter listed first. Network Boot Protocol Selection is PXE. Select PXE for use with Wired for Management compliant network management programs. Boot Order Selections are local first then network, local only, network only, and network first then local. If Local is selected, the Boot Agent will attempt to boot according to the boot sequence option (defined in the system BIOS setup) first, then attempt to boot from the network if local boot fails. If Network is selected, the Boot Agent will attempt to boot from the network first, regardless of the boot sequence option defined in system BIOS. Show Setup Prompt Selections are Disable and Enable. If enabled, the message "Initializing Boot Agent Version 2.2 - Press Ctrl+S to enter the Setup Program.." will be displayed during boot up. If Disable is selected, only the message "Initializing Boot Agent Version 2.2" will appear. However, you will still be able to enter Ctrl+S to enter the setup program at that time. Setup Menu Wait Time Selections are 2, 3, 5 and 8. The number represents the amount of time in seconds the "Initializing Boot Agent Version 2.2 - Press Ctrl+S to enter the Setup Program.." message is displayed every time the system is booted. Legacy OS Wakeup Support The selections are enable and disable. In servers supporting Wake-on-LAN, this function will pre-enable the Wake-on-LAN function of the adapter. Set this selection to enable if you are having difficulty with remote wake up in computers that are compliant to the PCI 2.2 specification and are running an OS that is not ACPI (Advanced Control and Power Interface) aware. 3.2.6.2 Troubleshooting Boot Agent ---------------------------------- If you do not see a message similar to " Initializing Boot Agent Version X.X" during the computer start-up, check the following: In the system BIOS setup menu, select "Devices and I/O Ports". Then check that the parameter for the onboard ethernet option is enabled. 4.0 WEB Sites and Support Phone Number ________________________________________ IBM Support Web Site: http://www.pc.ibm.com/support IBM Marketing Netfinity Web Site: http://www.pc.ibm.com/netfinity If you have any questions about this update, or problems applying the update go to the following Help Center World Telephone Numbers URL: http://www.pc.ibm.com/qtechinfo/YAST-3P2QLY.html. 5.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 xServer Microsoft, Windows NT, and Windows 2000 are trademarks or registered trademarks of Microsoft Corporation. Cisco and FastEtherchannel are trademarks or registered trademarks of Cisco Systems, Inc. Intel is a registered trademark of Intel Corporation. Other company, product, and service names may be trademarks or service marks of others. 6.0 Disclaimer _______________ 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.