GIGABIT ETHERNET SUPPORT FOR OS/2 Version 1.3 Aug 3, 2004 OS/2 Device Driver Development IBM Solution Technologies Austin, TX (c) Copyright International Business Machines Corporation, 2001, 2004. All rights Reserved. Contents 1. Overview 2. Installation 3. Driver parameters 4. Restrictions 5. Forcing link parameters 6. Performance tuning for TCP/IP 7. Copyright and Trademark Information 1. OVERVIEW IBM OS/2 support for the Intel PRO/1000 Family of Adapters, both Copper and Fiber media includes the following hardware controllers: Intel 82540EM controller based Copper Gigabit Ethernet Adapters Intel 82540EP controller based Copper Gigabit Ethernet Adapters Intel 82541EI controller based Copper Gigabit Ethernet Adapters Intel 82541GI controller based Copper Gigabit Ethernet Adapters Intel 82544EI controller based Copper Gigabit Ethernet Adapters Intel 82544GC controller based Copper Gigabit Ethernet Adapters Intel 82543GC controller based Copper Gigabit Ethernet Adapters Intel 82543GC controller based Fiber Gigabit Ethernet Adapters This software update provides the latest device driver for OS/2 Warp 4 and OS/2 Warp Server for e-business. The self-extracting package contains following files : README.TXT - This File IBMGU.OS2 - OS/2 Device Driver IBMGU.NIF - Network Information File IBMGU.SYM - Debug Symbol File 2. INSTALLATION Extract the IBMGU.EXE package contents to a directory (existing or new) or to a diskette. The method used to install the IBMGU driver depends on the version of OS/2 installed on your system, i.e., Warp Server for e-business or OS/2 Warp 4. To install the IBMGU driver on Warp Server for e-business, use the following procedure: 1) From your boot partition, open an OS/2 Command prompt window. 2) Change to the \IBMLAN\INSTALL subdirectory. >cd \ibmlan\install 3) Run the install program LANINST.EXE. >laninst.exe 4) Select 'OK' on the 'IBM Welcome ...' panel. The 'Easy or Tailored Installation/Configuration' panel is displayed. 5) Select 'Tailored'. The 'Installation Task' panel is displayed. 6) Select the 'Install or configure this workstation' option. The 'Installation Location' panel is displayed. 7) Select 'OK'. The 'Server Type' panel is displayed. 8) Select 'OK'. A 'Later MPTS Version Installed' message panel is displayed. 9) Select 'OK'. The 'Network Adapters' panel is displayed. An 'Unknown' adapter may show in the list. 10) Select 'OK'. The 'Adapter and Protocol Configuration' panel is displayed. 11) Select 'Other adapters...'. The 'Copy Additional Network Adapter Drivers' panel is displayed. 12) Insert the diskette containing the drivers for the IBMGU adapter into drive A:, or specify the path where the driver has been extracted and Select 'OK'. The device drivers will be installed. The 'Adapter and Protocol Configuration' panel is redisplayed. 13) Select 'IBM Gigabit Ethernet Adapter (OS/2)' from the Network Adapters list. Then Select 'Add'. 14) Add the desired protocols to the IBMGU adapter. 15) Select 'OK' on the 'Adapter and Protocol Configuration' panel. The 'Remote IPL Requirement' panel may be displayed. If it is, select 'Yes' to continue. The 'Installation and Configuration' panel is redisplayed. 16) Select 'Configure a Component'. Then select 'OK'. The 'Configure' panel is displayed. 17) Configure 'LAN Services Adapter' (the defaults are usually okay). 18) Configure 'First Failure Support Technology/2' (the defaults are usually okay). 19) Select 'OK' on the 'Configure' panel. The 'Installation and Configuration' panel is redisplayed. 20) Select 'Apply the changes'. Then select 'OK'. 21) Select 'OK' for the 'LAN Software is Running' message. The program CD will be needed to complete this step. Insert the CD when prompted. The 'File Backup' panel is displayed. 22) Select 'OK'. 23) Wait for the 'Installation/Configuration Complete' panel. Select 'OK'. 23) Shutdown and reboot the system. For OS/2 Warp 4 clients, there are two install possibilities: 1) when the 'File and Print Client' is installed and 2) when the 'File and Print Client' is not installed. Use the following procedure when the 'File and Print client' is installed: 1) From your boot partition, open an OS/2 Command prompt window. 2) Change to the \IBMLAN\INSTALL subdirectory. >cd \ibmlan\install 3) Run the install program LANINST.EXE. >laninst.exe 4) Select 'OK' on the 'IBM Welcome ...' panel. The 'Easy or Tailored Installation/Configuration' panel is displayed. 5) Select 'Tailored'. The 'Installation Task' panel is displayed. 6) Select the 'Configure this workstation' option. The 'Hard Disk' panel is displayed. 7) Select 'OK'. A 'Later MPTS Version Installed' message panel is displayed. 8) Select 'OK'. The 'Network Adapters' panel is displayed. An 'Unknown' adapter may show in the list. 9) Select 'OK'. The 'Adapter and Protocol Configuration' panel is displayed. 10) Select 'Other adapters...'. The 'Copy Additional Network Adapter Drivers' panel is displayed. 11) Insert the diskette containing the drivers for the IBMGU adapter into drive A:, or specify the path where the driver has been extracted and Select 'OK'. The device drivers will be installed. The 'Adapter and Protocol Configuration' panel is redisplayed. 12) Select 'IBM Gigabit Ethernet Adapter (OS/2)' from the Network Adapters list. Then Select 'Add'. 13) Add the desired protocols to the IBMGU adapter. 14) Select 'OK' on the 'Adapter and Protocol Configuration' panel. The 'Installation and Configuration' panel is redisplayed. 15) Select 'Configure a Component'. Then select 'OK'. The 'Configure' panel is displayed. 16) Configure 'LAN Services Adapter' (the defaults are usually okay). 17) Configure 'First Failure Support Technology/2' (the defaults are usually okay). 18) Select 'OK' on the 'Configure' panel. The 'Installation and Configuration' panel is redisplayed. 19) Select 'Apply the changes'. Then select 'OK'. 20) Select 'OK' for the 'LAN Software is Running' message. The program CD will be needed to complete this step. Insert the CD when prompted. The 'File Backup' panel is displayed. 21) Select 'OK'. 22) Wait for the 'Installation/Configuration Complete' panel. Select 'OK'. 23) Shutdown and reboot the system. For OS/2 Warp 4 clients that do not have the 'File and Print client' installed, use the following procedure: 1) Open an OS/2 command prompt (windowed or full screen) 2) Type 'MPTS', and hit Enter. 3) Select 'Install', and enter the path where the drivers have been extracted 4) Select 'OK', system will install the drivers and give a notification that network driver was successfully installed Configuration Steps: 1) From MPTS select 'Configure' 2) Find the "IBM Gigabit Ethernet Adapter (OS/2)" driver in the Network Adapter list and select 'Add' 3) Select the TCP/IP protocol, and select 'Add' 4) Select the NETBIOS protocol, and select 'Add' 5) Select OK 6) Select 'Exit' MPTS. 7) Shutdown and reboot the system. NOTE : See section 4.2 for NetBIOS limitations 3. DRIVER PARAMETERS The IBMGU driver will support TCP/IP, TCPBEUI, and NETBEUI only. See section 4.2 for NetBIOS limitations. The number of Transmit and Receive Buffers and the size of these buffers can be modified. The default number of Transmit and Receive Buffers is 64. Gigabit Ethernet supports buffer sizes up to 16384 bytes long. 8192 is the default value. The MTU size range is 1500 to 16100 bytes. For MTU size changes use the TCP/IP setup program. If more than one Gigabit Ethernet Adapter is used then 'Slot/Device Identifier' must be specified for each card. Initially leave these fields empty and write down the detected slot values which are displayed during the boot process. Use these values detected to fill in 'Slot/Device Identifier' field for each card and then reboot the computer. The EEPROM MAC address of network card can be overridden by specifying the different address in 'Locally Administered Address' field. There are no command line switches. 4. RESTRICTIONS a) Wiring for Copper Gigabit Adapters Wiring Gigabit must use at least CAT-5E or a known CAT-5 wiring scheme where all 8 wires are used and attached to the connectors. Failure to use this wiring scheme will result in speeds below 1 Gb, as the adapter will not negotiate 1Gb without CAT-5E wiring. Failure to use CAT-5E may also result in lost connections or buffer overruns. b) NetBIOS limitations NetBIOS must use DIX 2.0 mode - the protocol type ETHERAND_TYPE should be set to "D". 1) From MPTS select 'Configure' 2) In 'Current Configuration' find the "IBM OS/2 NETBIOS" and press 'Edit' 3) Set 'Type of Ethernet driver support' = "D" 4) Select OK 5) Select 'Exit' MPTS. c) Enforced Speed/Duplex Settings If the link partner uses enforced speed/duplex settings, only half duplex mode will be supported for 10/100 Mbps networks in auto-negotiation mode. This is a limitation of Ethernet specification. To use the full duplex mode the user should manually force speed and duplex settings. See section 5. for more details. 5. FORCING LINK PARAMETERS By default the IBMGU driver operates in auto-negotiation mode, where all link parameters are automatically negotiated with the link partner. Sometimes hardware incompatibility or limitations imposed by Ethernet specification may require the ability to manually enforce the link parameters. There are four parameters which can be changed in MPTS: a) SPEED - Link speed Allows to specify link speed in Mbits/sec. Possible values are 10, 100 and 1000 Mbits/sec. For default auto-negotiated speed leave the field empty or specify 0. If speed is enforced, then duplex mode must be forced too. Although Ethernet specification for 1000 Mbit/sec speed always requires the auto-negotiation mode, the manually enforced parameters work fine and sometimes might be helpful to workaround hardware compatibility issues. For 1000 Mbit/sec only full duplex mode is supported. b) DUPLEX - Duplex settings Allows to specify the link duplex mode. Possible values are 1 for half duplex and 2 for duplex. For default auto-negotiated duplex mode leave the field empty or specify 0. If duplex mode is enforced, the speed must be forced too. For 1000 Mbit/sec speed only full duplex mode is supported. c) CROSSOVER - Cable crossover The network card is able to automatically detect whether you are using standard straight wire cables or special cross-link cables for direct back-to-back connection. It has been observed that in some situations the cable type was incorrectly identified and that prevented the establishment of the link. To avoid the wrong identification, the user can enforce cable type. The possible values are 1 for MDI (standard straight wire cable) and 2 for MDI-X (cross-link cable). For default auto-detection, leave the field empty or specify 0. As a general rule when connecting to hubs/switches use standard MDI cables and for direct connection between two machines use cross-link cables. If two machines are directly connected with a cross-link cable, the CROSSOVER value should be the same at both ends. If a straight thru cable is used for direct connection between two machines, then one end should use MDI and other end use MDI-X. Only CAT-5E or better cables should be used. d) MASTER - Master/Slave resolution All Ethernet connections are between two nodes. One of them serves as a master and other as a slave. Normally these roles are assigned during the auto-negotiation process. But in some rare conditions the hardware incompatibility may cause the link to work unreliably if master/slave settings are not set to specific values. The possible values are 1 for master and 2 for slave. For default auto detection leave the field empty or specify 0. As a general rule a hub/switch serves as the master and individual workstations serve as the slaves. For direct computer-to-computer connections you should select which one will be the master and which one will be the slave. For forced 1000 Mbit/sec mode you must specify master/slave for both link partners. 6. PERFORMANCE TUNING FOR TCP/IP Gigabit Ethernet networks have a huge potential for high speed data transfer, but to achieve maximum throughput some additional parameter setup might be required. Here are some recommendations: a) Gigabit Ethernet is very I/O intensive, and requires systems in the network to have enough CPU power. If the CPU utilization during data transfer is consistently around 100%, a more powerful CPU may be required. b) Larger frame sizes usually improve network throughput. Larger frames can improve transfer speed for very large continuous data streams. For small data packets, the transport overhead may be too large and could decrease the transfer speed. Frame sizes of 8192 bytes would be a good initial evaluation value. c) The number of transmit and receive buffers can impact transfer speed. For network connections with long segments, an increase in the number of buffers should increase the overall transfer speed. For short network segments, smaller number of buffers can improve the transfer speed. A good initial evaluation value for the number of transmit and receive buffers is 32. d) Larger MTU values will increase data throughput. An MTU of 4096 bytes would be a good initial evaluation value. e) Specific applications may have an impact on the overall network performance. In some cases, the network driver settings that are optimal for one application may not be optimal for another. If possible try different programs (e.g. FTP clients) to determine the most effective settings and tune the networking parameters for application that will benefit most from the increased data transfer speed. 7. COPYRIGHT AND TRADEMARK INFORMATION The following terms are trademarks of International Business Machines Corporation in the United States and/or other countries: IBM OS/2 Other company, product, and service names may be trademarks or service marks of others. THE INFORMATION PROVIDED IN THIS README IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED 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. (C) Copyright IBM Corporation, 2001, 2004. All rights reserved. U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.