intellectual propertylaws. Exceptas expressly permittedin yourlicense agreementor allowedby law,you maynot use,copy, reproduce, translate,
broadcast, modify,license, transmit, distribute, exhibit,perform, publish, or displayany part, in anyform, or by anymeans. Reverse engineering,
disassembly, ordecompilation ofthis software,unless required bylaw forinteroperability, is prohibited.
The informationcontained hereinis subjectto changewithout noticeand isnot warrantedto beerror-free.If youfind anyerrors, pleasereport them to us
in writing.
If thisis softwareor related softwaredocumentation thatis delivered tothe U.S.Government oranyone licensingit onbehalf ofthe U.S.Government, the
following noticeis applicable:
U.S. GOVERNMENTEND USERS.Oracle programs,including anyoperating system,integrated software, anyprograms installedon thehardware,
and/or documentation,delivered toU.S. Governmentend usersare "commercial computer software" pursuantto theapplicable FederalAcquisition
Regulation andagency-specific supplementalregulations. Assuch, use,duplication, disclosure, modification,and adaptationof theprograms, including
any operatingsystem, integratedsoftware, anyprograms installed on the hardware,and/or documentation,shall besubject tolicense termsand license
restrictions applicableto theprograms. No other rights are granted to the U.S. Government.
This softwareor hardware is developed for general use ina varietyof informationmanagement applications.It is not developed orintended foruse inany
inherently dangerous applications,including applicationsthat maycreate arisk ofpersonal injury.If you use thissoftware or hardwarein dangerous
applications, thenyou shallbe responsibleto takeall appropriate fail-safe,backup, redundancy,and other measures to ensureits safeuse. Oracle
Corporation andits affiliatesdisclaim anyliability forany damagescaused byuse ofthis software orhardware in dangerous applications.
Oracle andJava areregistered trademarks of Oracle and/or its affiliates.Other namesmay betrademarks oftheir respectiveowners.
Intel andIntel Xeonare trademarksor registered trademarksof IntelCorporation. AllSPARC trademarksare usedunder license and are trademarksor
registered trademarks of SPARCInternational, Inc.AMD, Opteron, theAMD logo,and theAMD Opteron logoare trademarks or registered trademarksof
Advanced MicroDevices. UNIXis aregistered trademark of The Open Group.
This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle
Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and
services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party
content, products, or services.
restrictions d’utilisationet dedivulgation. Saufdisposition devotre contrat de licence ou de la loi, vous ne pouvez pas copier, reproduire, traduire,
diffuser,modifier, breveter, transmettre, distribuer, exposer,exécuter,publier ouafficher le logiciel, même partiellement, sous quelque forme et par
quelque procédéque cesoit. Parailleurs, ilest interdit deprocéder àtoute ingénierieinverse dulogiciel, dele désassemblerou dele décompiler, excepté à
des finsd’interopérabilité avecdes logicielstiers outel queprescrit par la loi.
Les informationsfournies dansce documentsont susceptiblesde modificationsans préavis.Par ailleurs,Oracle Corporationne garantitpas qu’elles
soient exemptesd’erreurs etvous invite,le caséchéant, àlui enfaire part par écrit.
U.S. GOVERNMENTEND USERS.Oracle programs,including anyoperating system,integrated software, anyprograms installedon thehardware,
and/or documentation,delivered toU.S. Governmentend usersare "commercial computer software" pursuantto theapplicable FederalAcquisition
Regulation andagency-specific supplementalregulations. Assuch, use,duplication, disclosure, modification,and adaptationof theprograms, including
any operatingsystem, integratedsoftware, anyprograms installed on the hardware,and/or documentation,shall besubject tolicense termsand license
restrictions applicableto theprograms. No other rights are granted to the U.S. Government.
Ce logicielou matériela étédéveloppé pourun usagegénéral dansle cadred’applications degestion desinformations. Celogiciel oumatériel n’estpas
conçu nin’est destinéà êtreutilisé dansdes applicationsà risque,notamment dansdes applicationspouvant causerdes dommagescorporels. Si vous
utilisez celogiciel oumatériel dansle cadred’applications dangereuses, ilest devotre responsabilité deprendre toutes les mesures de secours, de
sauvegarde, deredondance et autres mesures nécessairesà sonutilisation dansdes conditionsoptimales desécurité. OracleCorporation etses affiliés
déclinent touteresponsabilité quantaux dommagescausés parl’utilisation dece logicielou matérielpour cetype d’applications.
Oracle etJava sontdes marquesdéposées d’OracleCorporation et/oude sesaffiliés.Tout autre nommentionné peutcorrespondre à des marques
appartenant àd’autres propriétaires qu’Oracle.
Intel etIntel Xeonsont desmarques oudes marques déposéesd’Intel Corporation.Toutesles marques SPARC sont utilisées sous licence et sont des
marques oudes marques déposéesde SPARC International, Inc. AMD, Opteron,le logoAMD etle logoAMD Opteronsont des marques ou des marques
déposées d’AdvancedMicro Devices.UNIX estune marque déposéed’The OpenGroup.
Ce logicielou matérielet ladocumentation quil’accompagne peuventfournir desinformations oudes liensdonnant accèsà descontenus, desproduits et
des servicesémanant detiers. OracleCorporation etses affiliésdéclinent touteresponsabilité ou garantie expresse quant aux contenus, produits ou
services émanantde tiers.En aucuncas, OracleCorporation etses affiliésne sauraientêtre tenus pour responsables des pertes subies, des coûts
occasionnés oudes dommagescausés parl’accès àdes contenus,produits ouservices tiers,ou àleur utilisation.
Please
Recycle
Contents
Using This Documentationvii
Understanding the Installation Process1
Installation Overview (Oracle
Solaris 10)2
Installation Overview (Oracle
Solaris 11)3
Installation Overview (Linux)4
Installation Overview (Windows)5
Understanding the Adapter7
Shipping Kit Contents8
Product Description8
Configuration Options9
Front Panel Connectors and LEDs11
Physical Characteristics13
Performance Specifications14
Power and Environmental Requirements14
OS Patches and Updates15
Installing the Driver17
▼Verify the Driver Version (Oracle Solaris 10)18
▼Verify the Driver Version (Oracle Solaris 11)19
▼Remove the Driver (Oracle Solaris OS)19
iii
▼Download and Install the Driver (Linux)20
▼Remove the Driver (Linux)22
▼Download and Install the Driver (Windows)22
▼Remove the Driver (Windows)24
Installing the Adapter25
▼Install the Adapter26
▼Verify the Installation (Oracle SPARC)27
▼Verify the Installation (Oracle Solaris x86)30
▼Verify the Installation (Linux)31
▼Verify the Installation (Windows)31
Configuring the Network33
▼Create Driver Instance Files (Oracle Solaris 10)34
▼Configure the Network Host Files (Oracle Solaris 10)34
Boot Options35
▼Boot Over the Network (PXE)36
▼Boot Over a 10 GbE Network (Oracle Solaris x86 and Linux)36
▼Install Oracle Solaris 10 Over a Network (Oracle SPARC)38
Administering Driver Parameters and Jumbo Frames43
Driver Parameters (Oracle Solaris OS)44
▼Set Driver Parameters (Oracle Solaris OS)45
Driver Parameters (Linux)46
▼Set Driver Parameters (Linux)47
Configuring Jumbo Frames (Oracle Solaris OS)48
▼Change the MTU Permanently48
▼Change the MTU Temporarily (Oracle Solaris 10)48
▼Change the MTU Temporarily (Oracle Solaris 11)49
▼Configure Jumbo Frames (Linux)50
ivSun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Configuring Link Aggregation51
Link Aggregation Overview52
▼Configure Link Aggregations (Oracle Solaris 10)52
▼Display Information About Link Aggregations (Oracle Solaris 10)53
▼Delete Link Aggregations (Oracle Solaris 10)54
Configuring VLANs57
VLAN Overview58
VLAN Configuration61
VLAN Naming Format61
▼Configure Static VLANs (Oracle Solaris 10)62
▼Configure VLANs (Linux)63
▼Configure VLANs (Windows)64
Troubleshooting the Adapter67
▼Analyze Why the Device Link Is Missing68
▼Analyze a Port Hang69
▼Analyze Slow Network Performance69
Glossary71
Index77
Contentsv
viSun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Using This Documentation
This guide provides hardware and software installation instructions for the Sun Dual
Port 10GBase-T Adapter from Oracle. The instructions are meant for enterprise
system administrators who have experience installing network hardware and
software.
Important: The Sun Dual Port 10GBase-T Adapter was formerly named the Sun Dual
Port 10 GbE PCIe 2.0 Low Profile Adapter, Base-T. The former product name might
still appear in the product and document. The product name change does not
indicate any change in product features or functionality.
Note – In this document, the term “x86” refers to 64-bit and 32-bit systems
manufactured using processors compatible with the AMD64, Intel Xeon, or Intel
Pentium product families.
■ “Product Notes” on page vii
■ “Related Documentation” on page viii
■ “Feedback” on page viii
■ “Support and Accessibility” on page ix
Product Notes
For late-breaking information and known issues about this product, refer to the
product notes at:
xSun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Understanding the Installation
Process
These topics provide an overview of the installation process for the Sun Dual Port
10GBase-T Adapter:
■ “Installation Overview (Oracle Solaris 10)” on page 2
■ “Installation Overview (Oracle Solaris 11)” on page 3
■ “Installation Overview (Linux)” on page 4
■ “Installation Overview (Windows)” on page 5
Related Information
■ “Understanding the Adapter” on page 7
■ “Installing the Driver” on page 17
■ “Installing the Adapter” on page 25
■ “Configuring the Network” on page 33
■ “Administering Driver Parameters and Jumbo Frames” on page 43
■ “Configuring Link Aggregation” on page 51
■ “Configuring VLANs” on page 57
■ “Troubleshooting the Adapter” on page 67
1
Installation Overview (Oracle
Solaris 10)
Follow these steps to install the Adapter on an Oracle Solaris 10 platform.
Step DescriptionLinks
1.Understand the Adapter.“Understanding the Adapter” on page 7
2.Verify the driver installation.“Verify the Driver Version (Oracle Solaris 10)” on page 18
3.Install the Adapter.“Install the Adapter” on page 26
4.Verify the Adapter installation.“Verify the Installation (Oracle SPARC)” on page 27
“Verify the Installation (Oracle Solaris x86)” on page 30
5.Configure the network.“Create Driver Instance Files (Oracle Solaris 10)” on page 34
“Configure the Network Host Files (Oracle Solaris 10)” on
page 34
6.Configure the driver parameters.“Driver Parameters (Oracle Solaris OS)” on page 44
“Set Driver Parameters (Oracle Solaris OS)” on page 45
7.(Optional) Boot over the network.“Boot Over the Network (PXE)” on page 36
“Boot Over a 10 GbE Network (Oracle Solaris x86 and
Linux)” on page 36
8.(Optional) Install the OS over the network. “Install Oracle Solaris 10 Over a Network (Oracle SPARC)” on
page 38
9.(Optional) Configure jumbo frames.“Change the MTU Permanently” on page 48
10.(Optional) Configure link aggregation.“Link Aggregation Overview” on page 52
“Configure Link Aggregations (Oracle Solaris 10)” on page 52
“Display Information About Link Aggregations (Oracle
Solaris 10)” on page 53
“Delete Link Aggregations (Oracle Solaris 10)” on page 54
11.(Optional) Configure VLANs.“VLAN Overview” on page 58
“VLAN Configuration” on page 61
“Configure Static VLANs (Oracle Solaris 10)” on page 62
2Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Installation Overview (Oracle
Solaris 11)
The installation, configuration, and administration of software packages, driver
parameters, and network layers have changed in the Oracle Solaris 11 OS. The
instructions for these procedures are in Oracle Solaris 11 documentation, located
here:
http://docs.oracle.com/cd/E23824_01/index.html
Follow these steps to install the Adapter on an Oracle Solaris 11 platform.
Step DescriptionLinks
1.Understand the Adapter.“Understanding the Adapter” on page 7
2.Verify the driver installation.“Verify the Driver Version (Oracle Solaris 11)” on page 19
3.Install the Adapter.“Install the Adapter” on page 26
4.Verify the Adapter installation.Refer to Adding and Updating Oracle Solaris 11 SoftwarePackages.
5.Configure the network.Refer to Creating and Administering Boot Environments AfterInstallation.
6.Configure the driver parameters.“Administering Driver Parameters and Jumbo Frames” on
page 43
7.(Optional) Boot over the network.Refer to Creating and Administering Boot Environments AfterInstallation.
8.(Optional) Install the OS over the network. Refer to Adding and Updating Oracle Solaris 11 SoftwarePackages.
9.(Optional) Configure jumbo frames.“Configuring Jumbo Frames (Oracle Solaris OS)” on page 48
10.(Optional) Configure link aggregation.“Link Aggregation Overview” on page 52
Refer to Oracle Solaris Administration: Network Interfaces andNetwork Virtualization.
11.(Optional) Configure VLANs.“VLAN Overview” on page 58
“VLAN Configuration” on page 61
Refer to Oracle Solaris Administration: Network Interfaces andNetwork Virtualization.
Understanding the Installation Process3
Installation Overview (Linux)
Follow these steps to install the Adapter on a Linux platform.
Step DescriptionLinks
1.Understand the Adapter.“Understanding the Adapter” on page 7
2.Install the driver.“Download and Install the Driver (Linux)” on page 20
3.Install the Adapter.“Install the Adapter” on page 26
4.Verify the Adapter installation.“Verify the Installation (Linux)” on page 31
5.Boot over the network.“Boot Over a 10 GbE Network (Oracle Solaris x86 and Linux)” on
page 36
6.Configure the driver parameters.“Driver Parameters (Linux)” on page 46
8.(Optional) Configure VLANs.“VLAN Overview” on page 58
“VLAN Configuration” on page 61
“Configure VLANs (Linux)” on page 63
4Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Installation Overview (Windows)
Follow these steps to install the Adapter on a Windows platform.
Step DescriptionLinks
1.Understand the Adapter.“Understanding the Adapter” on page 7
2.Install the driver.“Download and Install the Driver (Windows)” on page 22
3.Install the Adapter.“Install the Adapter” on page 26
4.Verify the Adapter installation.“Verify the Installation (Windows)” on page 31
5.(Optional) Configure VLANs.“VLAN Overview” on page 58
“VLAN Configuration” on page 61
“Configure VLANs (Windows)” on page 64
Understanding the Installation Process5
6Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Understanding the Adapter
These topics provide an overview of the Sun Dual Port 10GBase-T Adapter.
DescriptionLinks
Understand the Adapter.“Shipping Kit Contents” on page 8
“Product Description” on page 8
“Front Panel Connectors and LEDs” on
page 11
“Physical Characteristics” on page 13
“Performance Specifications” on page 14
“Power and Environmental Requirements” on
page 14
Understand the hardware and software
requirements.
Understand the maintenance
requirements.
For lists of supported platforms, operating
systems, and applications, go here:
http://www.oracle.com/goto/sun-dual
-port-pcie-20-gigabit
“OS Patches and Updates” on page 15
Related Information
■ “Understanding the Adapter” on page 7
■ “Installing the Driver” on page 17
■ “Installing the Adapter” on page 25
■ “Configuring the Network” on page 33
■ “Administering Driver Parameters and Jumbo Frames” on page 43
■ “Configuring Link Aggregation” on page 51
■ “Configuring VLANs” on page 57
■ “Troubleshooting the Adapter” on page 67
7
Shipping Kit Contents
The carton in which the LPA was shipped should contain the following items:
■ Sun Dual Port 10GBase-T Adapter with a low profile bracket attached
■ Standard height bracket, screws and washer
■ Sun Network Interface Card Products Getting Started Guide
Related Information
■ “Product Description” on page 8
■ “Front Panel Connectors and LEDs” on page 11
■ “Physical Characteristics” on page 13
■ “Performance Specifications” on page 14
■ “Power and Environmental Requirements” on page 14
■ “OS Patches and Updates” on page 15
Product Description
The Sun Dual Port 10GBase-T Adapter is a 10 GbE NIC for PCIe systems. The
adapter offers a high density mutli-port design for Sun racks and blade servers. This
adapter addresses the multi-port network connectivity needs of data center
environments. The module is ideal for slot-constrained servers, providing a
simplified low-cost alternative to multiple 10 GbE server adapters for Oracle’s Sun
portfolio of SPARC and x86 servers.
8Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Related Information
■ “Shipping Kit Contents” on page 8
■ “Front Panel Connectors and LEDs” on page 11
■ “Physical Characteristics” on page 13
■ “Performance Specifications” on page 14
■ “Power and Environmental Requirements” on page 14
■ “OS Patches and Updates” on page 15
Configuration Options
You can use these networking cards in various server system configurations, such as:
■ Rackmounted or pedestal servers
■ Blade servers
■ Add-on NIC or LOM design
■ Switch add-on cards and network applications
Understanding the Adapter9
FIGURE:NIC Example Configuration Options
Figure Legend
1 PCIe 2.0 (5 Gbps)8 RX FIFO
2 NC-SI9 GbE MAC
3 SMBus10 SerDes
4 PCIe11 PHY
5 Mangement12 SerDes/SGMII
6 Queue management and DMA13 1000BASE-T
7 TX FIFO
Related Information
■ “Shipping Kit Contents” on page 8
■ “Configuration Options” on page 9
■ “Front Panel Connectors and LEDs” on page 11
■ “Physical Characteristics” on page 13
10Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
■ “Performance Specifications” on page 14
■ “Power and Environmental Requirements” on page 14
■ “OS Patches and Updates” on page 15
Front Panel Connectors and LEDs
On the front panel, there is one LED dedicated to signal the port speed, state, and
activity. The following figure and table explain the meaning of the LED.
Understanding the Adapter11
FIGURE:Front Face of the Adapter
Figure Legend
1Po rt 0
2Po rt 1
3OVERTEMP LED (unused)
4Speed LED
5LNK/ACT (link/activity)
12Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
LEDColorStateMeaning
SpeedNoneOffLink is down.
GreenSteady on1 GbE
YellowSteady on10 GbE
Link/activityNoneOffLink is down.
GreenSteady onLink is up.
GreenBlinkingActivity on the link.
OVERTEMPN/AN/ANot used.
Related Information
■ “Shipping Kit Contents” on page 8
■ “Product Description” on page 8
■ “Performance Specifications” on page 14
■ “Power and Environmental Requirements” on page 14
■ “OS Patches and Updates” on page 15
Physical Characteristics
DimensionMeasurement
Length13.54 cm (5.3 in.)
Height6.89 cm (2.71 in.)
Related Information
■ “Shipping Kit Contents” on page 8
■ “Product Description” on page 8
■ “Front Panel Connectors and LEDs” on page 11
■ “Performance Specifications” on page 14
■ “Power and Environmental Requirements” on page 14
■ “OS Patches and Updates” on page 15
Understanding the Adapter13
Performance Specifications
FeatureSpecification
Data rate supported per port10 Gbps, 1 Gbps, 100 Mbps
Bus typePCIe V2.0, 5.0 GTps
Bus widthx8 lane PCIe
Conforms to Ethernet standard802.3
Boot ROM4 Mb SPI Flash
EMIFCC Class A
Related Information
■ “Shipping Kit Contents” on page 8
■ “Product Description” on page 8
■ “Front Panel Connectors and LEDs” on page 11
■ “Power and Environmental Requirements” on page 14
■ “OS Patches and Updates” on page 15
Power and Environmental Requirements
SpecificationOperationStorage
Typical power
consumption
Main host power supply12V ± 15%
Temperature-5°Cto55°C (-5°C to 131°F),
Humidity10% to 90% noncondensing
14Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
25 W
noncondensing
relative humidity at 27°C
(80.6°F) maximum wet bulb
-40°Cto70°C (-40°F to 158°F),
noncondensing
93% noncondensing relative
humidity at 38°C (100.4°F)
maximum wet bulb
SpecificationOperationStorage
Altitude3,302 meters (10,833.3 feet) at
35°C(95°F) ambient
Vibration0.20 G in all axes (5-500 Hz sine)1.0 G in all axes (5-500 Hz
Shock5 G (11 ms half-sine)30 G (11 ms half-sine)
Airflow100 LFM at 55°C (131°F)
12,000 meters (39,370.1 feet)
sine)
Related Information
■ “Shipping Kit Contents” on page 8
■ “Product Description” on page 8
■ “Front Panel Connectors and LEDs” on page 11
■ “Physical Characteristics” on page 13
■ “Performance Specifications” on page 14
■ “OS Patches and Updates” on page 15
OS Patches and Updates
Before you patch the current OS due to version differences, you should update the
entire OS image, if possible, on the client system. For JumpStart environments,
ensure that you update the entire OS on the JumpStart server.
If you cannot update the entire OS image, download the latest patch that contains the
software driver.
http://support.oracle.com
Understanding the Adapter15
For additional information, check the product web page at:
■ “Power and Environmental Requirements” on page 14
16Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Installing the Driver
The SUNWixgbe software package comes bundled in the Oracle Solaris software.
These topics explain how to verify the ixgbe(7D) device driver on an Oracle x86 or
Oracle SPARC system that uses the Oracle Solaris OS. The topics also explain how to
download and install the ixgbe(7D) driver on Linux and Windows systems.
Note – The Oracle Solaris 10 8/10 OS and the Oracle Solaris 11 OS are the first
releases to support the Sun Dual Port 10GBase-T Adapter. You can upgrade to or
install either one of these releases, but the version of the driver must be the same on
both the client system and the server system.
DescriptionLinks
Verify or remove the driver
on an Oracle Solaris platform.
Download, install, or remove
the driver on a Linux
platform.
Download, install, or remove
the driver on a Windows
platform.
“Verify the Driver Version (Oracle Solaris 10)” on page 18
“Verify the Driver Version (Oracle Solaris 11)” on page 19
“Remove the Driver (Oracle Solaris OS)” on page 19
“Download and Install the Driver (Linux)” on page 20
“Remove the Driver (Linux)” on page 22
“Download and Install the Driver (Windows)” on page 22
“Remove the Driver (Windows)” on page 24
Related Information
■ “Understanding the Installation Process” on page 1
■ “Understanding the Adapter” on page 7
■ “Installing the Adapter” on page 25
■ “Configuring the Network” on page 33
■ “Administering Driver Parameters and Jumbo Frames” on page 43
■ “Configuring Link Aggregation” on page 51
■ “Configuring VLANs” on page 57
■ “Troubleshooting the Adapter” on page 67
17
▼ Verify the Driver Version (Oracle
Solaris 10)
Oracle Solaris 10 10/11 is the first release of the Oracle Solaris 10 OS to support the
Sun Dual Port 10GBase-T Adapter. Depending on your version of the Oracle Solaris
10 OS, you might or might not need to download the updated driver.
If the version number is not at least 1.1.9, you must install the latest driver, or you
can reinstall the OS. See “OS Patches and Updates” on page 15.
Note – If the ixgbe(7D) driver is not listed, the driver might not be loaded. You can
use the modload(1M) command to load the driver if needed.
2. Manually load the module.
# modload /kernel/drv/arch/ixgbe
where arch is amd64 for 64-bit Intel systems or sparcv9 for Oracle SPARC
systems.
Related Information
■ “Verify the Driver Version (Oracle Solaris 10)” on page 18
■ “Remove the Driver (Oracle Solaris OS)” on page 19
▼ Remove the Driver (Oracle Solaris OS)
It is not necessary to remove a driver when its associated device is removed from a
system. However, if you want to clean up your file systems or conserve space, you
can easily remove a driver.
Installing the Driver19
● Remove the driver.
# pkgrm SUNWixgbe*
See the pkgrm(1M) man page for more information.
Related Information
■ “Verify the Driver Version (Oracle Solaris 10)” on page 18
■ “Verify the Driver Version (Oracle Solaris 11)” on page 19
▼ Download and Install the Driver
(Linux)
If your system uses the Red Hat or SUSE Linux operating system, you must
download the ixgbe device driver to install it.
Network Adapter Driver for PCI-E 10 Gigabit Network Connections under Linux
6. Select Download.
The download begins. The file named ixgbe-x.x.xx.tar.gz is saved in the
~/Desktop directory of your system.
20Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Note – The primary driver link is a buildable source archive that works with Linux
2.6.x kernels only and requires that the currently running kernel match the SRC RPM
kernel files and headers in order to build the driver. See the bundled README file in
the unpacked archive from Intel for more information.
For this example, assume that the file is named ixgbe-1.2.3.4.tar.gz. The
actual file might have different version or subversion numbers.
7. Review and accept the software license agreement.
8. Copy the file containing the driver from ~/Desktop to /temp.
9. Uncompress and untar the file.
# tar -zxvf ixgbe-1.2.3.4.tar.gz
10. Go to the newly created src directory.
# cd /temp/ixgbe-1.2.3.4/src
11. Compile the driver source file.
# make
# make install
12. Load the ixgbe(7D) driver.
# modprobe ixgbe
13. Verify that the ixgbe(7D) driver has been successfully installed.
# lsmod | grep ixgbe
The output should be similar to the following:
ixgbe1180520
Installing the Driver21
14. Check the ixgbe driver version.
# modinfo ixgbe | grep ver
For example, the output might be similar to the following:
It is not necessary to remove a driver when its associated device is removed from a
system. However, if you want to clean up your file systems or conserve space, you
can easily remove a driver.
● Use the rmmod command.
# rmmod ixgbe
Related Information
■ “Download and Install the Driver (Linux)” on page 20
▼ Download and Install the Driver
(Windows)
If your system uses the Windows Server 2003 or 2008 operating system, perform the
following procedure to download and install the device driver.
1. Log in to your system.
22Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
4. Select one of the following as the operating system:
■ For a 64-bit driver:
■ Windows Server 2003 Standard x64 Edition
■ Windows Server 2008 Standard x64
■ For a 32-bit driver:
■ Windows Server 2003 Standard Edition
■ Windows Server 2008 Standard
5. Select the latest driver.
6. Click the Download button next to the appropriate file for your system.
7. Review and accept the software license agreement.
8. Click on the .exe files to install the driver.
9. Follow the instructions in the installation wizard.
10. If the Found New Hardware Wizard screen is displayed, click Cancel.
The autorun utility automatically runs after you have extracted the files.
Related Information
■ “Remove the Driver (Windows)” on page 24
Installing the Driver23
▼ Remove the Driver (Windows)
It is not necessary to remove a driver when its associated device is removed from a
system. However, if you want to clean up your file systems or conserve space, you
can easily remove a driver.
1. From the Control Panel, double-click Add/Remove Programs.
2. Select Intel PRO Network Connections Drivers.
3. Click Add/Remove.
4. When the confirmation dialog displays, click OK.
Related Information
■ “Download and Install the Driver (Windows)” on page 22
24Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Installing the Adapter
These topics describe how to install the Adapter.
DescriptionLinks
Understand the connectors.“Front Panel Connectors and LEDs” on page 11
Install the Adapter.“Install the Adapter” on page 26
Verify the Adapter installation.“Verify the Installation (Oracle SPARC)” on page 27
“Verify the Installation (Oracle Solaris x86)” on page 30
“Verify the Installation (Linux)” on page 31
“Verify the Installation (Windows)” on page 31
Related Information
■ “Understanding the Installation Process” on page 1
■ “Understanding the Adapter” on page 7
■ “Installing the Driver” on page 17
■ “Configuring the Network” on page 33
■ “Administering Driver Parameters and Jumbo Frames” on page 43
■ “Configuring Link Aggregation” on page 51
■ “Configuring VLANs” on page 57
■ “Troubleshooting the Adapter” on page 67
25
▼ Install the Adapter
The following instructions describe the basic tasks required to install the Adapter.
Refer to your system installation or service manual for specific PCIe installation
instructions.
1. Halt and power off your system.
2. Power off all of the peripherals connected to your system.
3. Open the system unit.
4. Attach an antistatic wrist strap to the chassis of the server.
5. Remove the slot cover from the chassis.
6. Holding the Adapter by the edges, align the card edge connector with the PCIe
slot.
7. Slide the Adapter face plate into the small slot at the end of the PCIe opening.
8. Applying even pressure at both corners of the Adapter, push the Adapter until
it is firmly seated in the slot.
26Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Caution – Do not use excessive force when installing the Adapter into the PCIe slot.
You might damage the Adapter’s PCIe connector. If the Adapter does not seat
properly when you apply even pressure, remove the Adapter, and carefully reinstall
it.
9. Detach the wrist strap and close the system unit.
10. Connect the cables to the ports.
11. Power on the system.
Related Information
■ “Verify the Installation (Oracle SPARC)” on page 27
■ “Verify the Installation (Oracle Solaris x86)” on page 30
■ “Verify the Installation (Linux)” on page 31
■ “Verify the Installation (Windows)” on page 31
▼ Verify the Installation (Oracle SPARC)
Note – Verification is not required if your system supports DR.
1. Power on the system.
2. When the banner appears, press the Stop-A key sequence to interrupt the boot
process and display the OpenBoot (ok) prompt.
3. List the network devices on your system.
ok show-nets
a) /niu@480/network@0
b) /pci@400/pci@2/pci@0/pci@c/network@0,3
c) /pci@400/pci@2/pci@0/pci@c/network@0,2
d) /pci@400/pci@2/pci@0/pci@c/network@0,1
e) /pci@400/pci@2/pci@0/pci@c/network@0
f) /pci@400/pci@2/pci@0/pci@a/network@0,1
g) /pci@400/pci@2/pci@0/pci@a/network@0
q) NO SELECTION
Enter Selection, q to quit: q
Installing the Adapter27
Note – Checking the .properties output for each device is the surest way to
identify the device.
4. Check the .properties output for each device.
The following examples assume that
/pci@400/pci@2/pci@0/pci@a/network@0,1 is a port on the Adapter.
a. Move to the device directory.
ok cd /pci@400/pci@2/pci@0/pci@a/network@0,1
28Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
30Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
▼ Verify the Installation (Linux)
● Verify the new network interface instances corresponding to the Adapter.
# ifconfig -a | grep eth
eth3Link encap:Ethernet HWaddr 00:1B:21:17:67:B0
eth4Link encap:Ethernet HWaddr 00:1B:21:17:67:9B
Related Information
■ “Install the Adapter” on page 26
▼ Verify the Installation (Windows)
1. Click Control Panel.
2. Click Network Connection.
If the driver is installed correctly, the Ethernet adapter interfaces labeled as
"Intel(R) I450 10-Gigabit Dual Port Network Connection” will be displayed at the
Network Connection screen.
3. In the Administration Tool, click Computer Management, Device Manager, and
Network Adapter.
4. Check the driver version.
The minimum Windows Server 2003 and 2008 driver version is 14.3.
Related Information
■ “Install the Adapter” on page 26
Installing the Adapter31
32Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Configuring the Network
These topics describe how to configure the network for the Sun Dual Port 10GBase-T
Adapter.
DescriptionLinks
Configure the network for an
Oracle Solaris system.
Boot over the network.“Boot Options” on page 35
Install the Oracle Solaris OS
over the network.
Related Information
■ “Understanding the Installation Process” on page 1
■ “Understanding the Adapter” on page 7
■ “Installing the Driver” on page 17
■ “Installing the Adapter” on page 25
■ “Administering Driver Parameters and Jumbo Frames” on page 43
■ “Configuring Link Aggregation” on page 51
■ “Configuring VLANs” on page 57
■ “Troubleshooting the Adapter” on page 67
“Create Driver Instance Files (Oracle Solaris 10)” on
page 34
“Configure the Network Host Files (Oracle Solaris 10)” on
page 34
“Boot Over the Network (PXE)” on page 36
“Boot Over a 10 GbE Network (Oracle Solaris x86 and
Linux)” on page 36
“Install Oracle Solaris 10 Over a Network (Oracle
SPARC)” on page 38
33
▼ Create Driver Instance Files (Oracle
Solaris 10)
Use this procedure to configure the network host files permanently. The new settings
will be restored at each reboot.
1. Create a file named /etc/hostname.ixgbe# for each ixgbe(7D) interface.
where # is the interface’s instance number. In the new files, only insert a text
hostname, then save and exit.
2. Edit the /etc/hosts file to include an IP address and host name for each
ixgbe(7D) interface (that is, for each /etc/hostname.ixgbe# file).
3. Boot the Oracle Solaris 10 OS.
Now the ixgbe(7D) interfaces will be plumbed up automatically when you boot.
Related Information
■ “Configure the Network Host Files (Oracle Solaris 10)” on page 34
■ “Boot Options” on page 35
■ “Boot Over the Network (PXE)” on page 36
■ “Boot Over a 10 GbE Network (Oracle Solaris x86 and Linux)” on page 36
■ “Install Oracle Solaris 10 Over a Network (Oracle SPARC)” on page 38
▼ Configure the Network Host Files
(Oracle Solaris 10)
Use this procedure to configure the network host files dynamically on the command
line. At reboot, the settings will revert.
1. Create a file named /etc/hostname.ixgbe# for each ixgbe(7D) interface.
where # is the ixgbe(7D) interface instance number you plan to use.
For example, to bring up ixgbe0 at boot, create a file called
/etc/hostname.ixgbe0, where 0 is the number of the ixgbe(7D) interface. If
the instance number were 1, the file name would be /etc/hostname.ixgbe1.
The /etc/hostname.ixgbe# file must contain the host name for the appropriate
ixgbe(7D) interface.
34Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
2. Get the ixgbe(7D) instances.
# dladm show-dev
The output should include lines similar to the following:
ixgbe0link: upspeed: 10000Mbps duplex: full
nge0link: upspeed: 1000Mbps duplex: full
nge1link: downspeed: 0Mbps duplex: unknown
ixgbe1link: upspeed: 10000Mbps duplex: full
ixgbe2link: upspeed: 10000Mbps duplex: full
3. Use the ifconfig(1M) command to set up the ixgbe(7D) interfaces.
Your ifconfig command might look similar to the following:
# ifconfig ixgbe0 plumb ip-address netmask 255.255.255.0 broadcast + up
Related Information
■ “Create Driver Instance Files (Oracle Solaris 10)” on page 34
■ “Boot Options” on page 35
■ “Boot Over the Network (PXE)” on page 36
■ “Boot Over a 10 GbE Network (Oracle Solaris x86 and Linux)” on page 36
■ “Install Oracle Solaris 10 Over a Network (Oracle SPARC)” on page 38
Boot Options
The Adapter supports several boot options:
■ UEFI with PXE with option ROM (Oracle x86/x64)
■ UEFI with iSCSI with option ROM (Oracle x86/x64 and Oracle SPARC))
■ OpenBoot PROM (bootp) with PF (Oracle SPARC systems supporting LDOMs)
The Oracle Solaris Advanced Installation Guide includes more information about boot
options and describes how to create a boot server.
Related Information
■ “Create Driver Instance Files (Oracle Solaris 10)” on page 34
■ “Configure the Network Host Files (Oracle Solaris 10)” on page 34
Configuring the Network35
■ “Boot Over the Network (PXE)” on page 36
■ “Boot Over a 10 GbE Network (Oracle Solaris x86 and Linux)” on page 36
■ “Install Oracle Solaris 10 Over a Network (Oracle SPARC)” on page 38
▼ Boot Over the Network (PXE)
PXE network boot is an environment to boot computers using a network interface
independently of available data storage devices (such as hard disks) or installed
operating systems. No boot media is required on the client system. With PXE, you
can install an x86-based client over the network by using DHCP.
● Boot over the network using PXE.
Refer to the booting with PXE instructions in the Oracle Solaris 10 Installation
Guide: Network-Based Installations for more information at:
http://docs.oracle.com/cd/E23823_01/index.html
Related Information
■ “Create Driver Instance Files (Oracle Solaris 10)” on page 34
■ “Configure the Network Host Files (Oracle Solaris 10)” on page 34
■ “Boot Options” on page 35
■ “Boot Over a 10 GbE Network (Oracle Solaris x86 and Linux)” on page 36
■ “Install Oracle Solaris 10 Over a Network (Oracle SPARC)” on page 38
▼ Boot Over a 10 GbE Network (Oracle
Solaris x86 and Linux)
1. Obtain the MAC address of the first Adapter port by checking the label of the
Adapter.
For the Adapter, the MAC address on the label is for the first port. The second
port’s MAC address is the MAC address from the label, plus 1.
2. Set up the PXE boot server with the MAC addresses.
3. Plug the Ethernet cable into the Adapter’s port.
36Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
4. Power on the system.
5. Press the F2 key or the Control-E keys to go to the BIOS menu.
6. Go to the Boot - Boot Device Priority screen and ensure that the boot order of
the network devices is higher than the hard drive.
7. Press the F10 key to save the boot configuration changes and exit BIOS.
The system should reboot after saving the boot configuration.
8. On Oracle platforms, press the F12 key to install the OS from the network.
If the cable is connected to the correct port, you should see the MAC address that
you assigned to your PXE server displayed by BIOS. If your platform does not
support the F12 key, you might need to boot from the BIOS.
Intel(R) Boot Agent GE v1.3.31
Copyright (C) 1997-2009, Intel Corporation
Initializing and establishing link...
**************************************************
*Please select boot device:*
**************************************************
* HDD:P1-SEAGATE ST95001NSSUN500G 111*
* PXE:Slot1.F0:IBA XE Slot 0700 v2193*
* PXE:Slot1.F1:IBA XE Slot 0701 v2193*
* PXE:Slot0.F0:IBA XE Slot 0D00 v2193*
* PXE:Slot0.F1:IBA XE Slot 0D01 v2193*
* PXE:IBA GE Slot 1F00 v1331*
* PXE:IBA GE Slot 1F01 v1331*
**
**
**
**************************************************
** and * to move selection*
*ENTER to select boot device*
*ESC to boot using defaults*
**************************************************
If you do not see the device listed, check that the Adapter is properly seated. If
necessary, reinstall the Adapter.
40Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
c. Type the following when you finish looking at the .properties values.
ok device-end
4. At the ok prompt, display the device paths.
You should see the full paths of all of the network devices, including two for the
Adapter similar to this example.
ok show-nets
a) /pci@7c0/pci@0/pci@9/network@0,1
b) /pci@7c0/pci@0/pci@9/network@0
c) /pci@7c0/pci@0/pci@2/network@0,1
d) /pci@7c0/pci@0/pci@2/network@0
e) /pci@780/pci@0/pci@8/network@0,1
f) /pci@780/pci@0/pci@8/network@0
g) /pci@780/pci@0/pci@1/network@0,1
h) /pci@780/pci@0/pci@1/network@0
q) NO SELECTION
Enter Selection, q to quit: q
5. At the ok prompt, boot the client system using the full device path of the
10 GbE device, for example:
ok boot /pci@7c0/pci@0/pci@9/network@0,1
The boot takes about several minutes to complete. Then, you should see a menu
for continuing to install the Oracle Solaris 10 OS.
6. Proceed with the Oracle Solaris 10 OS installation.
Refer to the Oracle Solaris Advanced Installation Guide for more information about
installing the Oracle Solaris 10 OS over the network.
7. Install the Adapter software on the client system.
The software installed in Step 5 is required to boot the client system over the
10 GbE interface. You now must install the software in order for the operating
system to use the client’s 10 GbE interfaces in normal operation.
Before installing the SUNWixgbe driver, ensure that the client system does not
already have the driver installed.
# pkginfo | grep SUNWixgbe*
■ If the software is installed, this command will return the package name you
typed in. In that case, skip to Step 8.
■ If the software is not installed, install the software from the download center at:
Configuring the Network41
http://support.oracle.com
8. Confirm that the network host files have been configured correctly during the
Oracle Solaris 10 installation.
Although the Oracle Solaris 10 software installation creates the client’s network
configuration files, you might need to edit these files to match your specific
networking environment. See “Configure the Network Host Files (Oracle Solaris
10)” on page 34 for more information about editing these files.
9. Display the configuration information for all datalinks or the specified datalink.
By default, the system is configured to have one datalink for each known network
device.
# dladm show-dev
e1000g0link: upspeed: 1000Mbpsduplex: full
e1000g1link: downspeed: 0Mbpsduplex: half
e1000g2link: downspeed: 0Mbpsduplex: half
e1000g3link: downspeed: 0Mbpsduplex: half
ixgbe0link: upspeed: 10000Mbpsduplex: full
ixgbe1link: upspeed: 10000Mbpsduplex: full
Related Information
■ “Create Driver Instance Files (Oracle Solaris 10)” on page 34
■ “Configure the Network Host Files (Oracle Solaris 10)” on page 34
■ “Boot Options” on page 35
■ “Boot Over the Network (PXE)” on page 36
■ “Boot Over a 10 GbE Network (Oracle Solaris x86 and Linux)” on page 36
42Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Administering Driver Parameters
and Jumbo Frames
The ixgbe(7D) device driver controls the Adapter’s interfaces. You can manually set
the ixgbe(7D) device driver parameters to customize each device in your system.
These topics describe how to administer driver parameters.
DescriptionLinks
Administrate driver parameters
in the Oracle Solaris OS.
Administrate driver parameters
in Linux.
Configure jumbo frames.“Configuring Jumbo Frames (Oracle Solaris OS)” on
Related Information
■ “Understanding the Installation Process” on page 1
■ “Understanding the Adapter” on page 7
■ “Installing the Driver” on page 17
■ “Installing the Adapter” on page 25
■ “Configuring the Network” on page 33
■ “Configuring Link Aggregation” on page 51
■ “Configuring VLANs” on page 57
■ “Troubleshooting the Adapter” on page 67
“Driver Parameters (Oracle Solaris OS)” on page 44
“Set Driver Parameters (Oracle Solaris OS)” on page 45
“Driver Parameters (Linux)” on page 46
“Set Driver Parameters (Linux)” on page 47
page 48
“Configure Jumbo Frames (Linux)” on page 50
43
Driver Parameters (Oracle Solaris OS)
You can configure these parameters on each ixgbe(7D) interface
TypeKeywordDescription
Jumbo framesdefault_mtu=uSize of the default MTU (payload without the Ethernet
■ The first part within the double quotes specifies the hardware node name in the
device tree.
■ The number not enclosed in quotes is the instance number (shown in bold for
emphasis).
■ The last part in double quotes is the driver name.
Note – To identify a PCIe device unambiguously in the ixgbe.conf file, use the
name, parent name, and unit address for the device. In the example, the name is
pci108e,7b15, the parent is /pci@0,0/pci8086,3c0a@3,2, and the unit address
is 0. Refer to the pci(4) man page for more information about the PCIe device
specification.
2. Set the parameters for the ixgbe(7D) devices in the
/kernel/drv/ixgbe.conf file.
For example, to set the flow_control parameter to 3 for ixgbe0:
Administering Driver Parameters and Jumbo Frames45
3. Save the ixgbe.conf file.
4. Reboot the system.
Related Information
■ “Driver Parameters (Oracle Solaris OS)” on page 44
■ “Configuring Jumbo Frames (Oracle Solaris OS)” on page 48
Driver Parameters (Linux)
The following table lists the tunable ixgbe(7D) driver parameters for Linux
operating systems and describes their function.
KeywordValid RangeDefault ValueDescription
FlowControl0to3
(0=none, 1=RX
only, 2=TX only,
3=RX and TX)
RxDescriptiors64 to 4096512This value is the number of receive descriptors
Read from the
EEPROM.
If EEPROM is not
detected, default
is 3.
This parameter controls the automatic
generation (TX) and response (RX) to Ethernet
PAUSE frames.
allocated by the driver. Increasing this value
allows the driver to buffer more incoming
packets. Each descriptor is 16 bytes. A receive
buffer is also allocated for each descriptor and
can be either 2048, 4056, 8192, or 16384 bytes,
depending on the MTU setting. When the MTU
size is 1500 or less, the receive buffer size is
2048 bytes. When the MTU is greater than 1500,
the receive buffer size will be either 4056, 8192,
or 16384 bytes. The maximum MTU size is
16114.
46Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
KeywordValid RangeDefault ValueDescription
RxIntDelay0 to 65535
(0=off)
TxDescriptors80 to 4096256This value is the number of transmit descriptors
XsumRX0 to 11A value of 1 indicates that the driver should
72This value delays the generation of receive
interrupts in units of 0.8192 microseconds.
Receive interrupt reduction can improve CPU
efficiency if properly tuned for specific network
traffic. Increasing this value adds extra latency
to frame reception and can end up decreasing
the throughput of TCP traffic. If the system is
reporting dropped receives, this value might be
set too high, causing the driver to run out of
available receive descriptors.
allocated by the driver. Increasing this value
allows the driver to queue more transmits. Each
descriptor is 16 bytes.
enable IP checksum offload for received packets
(both UDP and TCP) to the Ethernet adapter
hardware.
Related Information
■ “Set Driver Parameters (Linux)” on page 47
■ “Configure Jumbo Frames (Linux)” on page 50
▼ Set Driver Parameters (Linux)
● Use the ethtool utility or the configtool utility to set parameters on a Linux
platform.
Related Information
■ “Driver Parameters (Linux)” on page 46
■ “Configure Jumbo Frames (Linux)” on page 50
Administering Driver Parameters and Jumbo Frames47
Configuring Jumbo Frames (Oracle
Solaris OS)
Jumbo frames can support up to 15500 MTU. The default value is 1500 MTU. Use the
following steps to set the size permanently.
■ “Change the MTU Permanently” on page 48
■ “Change the MTU Temporarily (Oracle Solaris 10)” on page 48
■ “Change the MTU Temporarily (Oracle Solaris 11)” on page 49
▼ Change the MTU Permanently
1. Add the following line in the /kernel/drv/ixgbe.conf file:
default_mtu = desired-frame-size
The desired-frame-size value can range from 1500 to 15500.
2. Reboot the server.
Related Information
■ “Driver Parameters (Oracle Solaris OS)” on page 44
■ “Set Driver Parameters (Oracle Solaris OS)” on page 45
■ “Change the MTU Temporarily (Oracle Solaris 10)” on page 48
■ “Change the MTU Temporarily (Oracle Solaris 11)” on page 49
▼ Change the MTU Temporarily (Oracle Solaris 10)
● Use the ifconfig(1M) command to increase MTUs to allow transmission of
jumbo frames.
For example, where the device name is ixgbe0, the following command increases
MTUs to the maximum:
# ifconfig ixgbe0 plumb mtu 15500 up
The temporary setting lasts only until the next reboot of the server.
48Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Related Information
■ “Driver Parameters (Oracle Solaris OS)” on page 44
■ “Set Driver Parameters (Oracle Solaris OS)” on page 45
■ “Change the MTU Permanently” on page 48
■ “Change the MTU Temporarily (Oracle Solaris 11)” on page 49
▼ Change the MTU Temporarily (Oracle Solaris 11)
● Use the dladm(1M) command to increase MTUs to allow transmission of jumbo
frames.
For example, where the device name is ixgbe0, the following command increases
MTUs to the maximum:
# dladm -t mtu=15500 ixgbe0
The temporary setting lasts only until the next reboot of the server.
Related Information
■ “Driver Parameters (Oracle Solaris OS)” on page 44
■ “Set Driver Parameters (Oracle Solaris OS)” on page 45
■ “Change the MTU Permanently” on page 48
■ “Change the MTU Temporarily (Oracle Solaris 10)” on page 48
Administering Driver Parameters and Jumbo Frames49
▼ Configure Jumbo Frames (Linux)
Jumbo frames can support up to 15500 MTU. The default value is 1500 MTU.
● Use the ifconfig(1M) command to increase MTUs to allow transmission of
jumbo frames.
For example, where the IP address for eth7 is 192.1.1.200, the following
command increases MTUs to the maximum:
# ifconfig eth7 192.1.1.200 mtu 15500 up
Related Information
■ “Driver Parameters (Linux)” on page 46
■ “Set Driver Parameters (Linux)” on page 47
50Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Configuring Link Aggregation
These topics describe how to configure link aggregation in the Oracle Solaris 10 OS.
For instructions on how to configure link aggregations in the Oracle Solaris 11 OS,
refer to Oracle Solaris Administration: Network Interfaces and Network Virtualization in
the Oracle Solaris 11 documentation library.
DescriptionLinks
Understand link aggregation.“Link Aggregation Overview” on page 52
Manage link aggregations in the
Oracle Solaris OS.
Related Information
■ “Understanding the Installation Process” on page 1
■ “Understanding the Adapter” on page 7
■ “Installing the Driver” on page 17
■ “Installing the Adapter” on page 25
■ “Configuring the Network” on page 33
■ “Administering Driver Parameters and Jumbo Frames” on page 43
■ “Configuring VLANs” on page 57
■ “Troubleshooting the Adapter” on page 67
“Configure Link Aggregations (Oracle Solaris 10)” on
page 52
“Display Information About Link Aggregations (Oracle
Solaris 10)” on page 53
“Delete Link Aggregations (Oracle Solaris 10)” on page 54
51
Link Aggregation Overview
Link aggregation enables one or more network links to be aggregated together to
form a link aggregation group. This link aggregation group appears to MAC clients
as a regular link. Link aggregation, which is defined by IEEE 802.3ad, provides the
following benefits:
■ Increased bandwidth
■ Linearly incremental bandwidth
■ Load sharing
■ Automatic configuration
■ Rapid configuration and reconfiguration
■ Deterministic behavior
■ Low risk of duplication or misordering
■ Support of existing IEEE 802.3ad MAC clients
■ Single port failover
Related Information
■ “Configure Link Aggregations (Oracle Solaris 10)” on page 52
■ “Display Information About Link Aggregations (Oracle Solaris 10)” on page 53
■ “Delete Link Aggregations (Oracle Solaris 10)” on page 54
▼ Configure Link Aggregations (Oracle
Solaris 10)
The example in this procedure aggregates sample interfaces ixgbe0, ixgbe1,ixgbe2, and ixgbe3. Arbitrary key numbers (1 and 2) are used for each
aggregation.
Note – These commands change the contents of the /etc/aggregation.conf file.
52Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
■ Use the dladm show-aggr command to show link aggregation status.
■ Use the dladm show-aggr -s command to show link aggregation statistics.
■ Use the dladm show-aggr -L command to display LACP-specific information.
Related Information
■ “Link Aggregation Overview” on page 52
■ “Configure Link Aggregations (Oracle Solaris 10)” on page 52
■ “Delete Link Aggregations (Oracle Solaris 10)” on page 54
▼ Delete Link Aggregations (Oracle
Solaris 10)
1. Use the ifconfig(1M) command to unplumb each link aggregation you want
to delete.
For example:
# ifconfig aggr1 unplumb
# ifconfig aggr2 unplumb
54Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
2. Use the dladm(1M) command to delete each unwanted link aggregation.
For example:
# dladm delete-aggr 1
# dladm delete-aggr 2
Related Information
■ “Link Aggregation Overview” on page 52
■ “Configure Link Aggregations (Oracle Solaris 10)” on page 52
■ “Display Information About Link Aggregations (Oracle Solaris 10)” on page 53
Configuring Link Aggregation55
56Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Configuring VLANs
These topics describe how to configure VLANs in the Oracle Solaris 10 OS. For
instructions on how to configure VLANs in the Oracle Solaris 11 OS, refer to OracleSolaris Administration: Network Interfaces and Network Virtualization in the Oracle
Solaris 11 documentation library.
Note – If you change any of the VLAN configuration parameters, you must reboot
the system before the changes take effect. If you make changes and do not reboot,
you might experience configuration problems.
DescriptionLinks
Understand VLANs.“VLAN Overview” on page 58
“VLAN Configuration” on page 61
“VLAN Naming Format” on page 61
Configure VLANs.“Configure Static VLANs (Oracle Solaris 10)” on page 62
“Configure VLANs (Linux)” on page 63
“Configure VLANs (Windows)” on page 64
Related Information
■ “Understanding the Installation Process” on page 1
■ “Understanding the Adapter” on page 7
■ “Installing the Driver” on page 17
■ “Installing the Adapter” on page 25
■ “Configuring the Network” on page 33
■ “Administering Driver Parameters and Jumbo Frames” on page 43
■ “Configuring Link Aggregation” on page 51
■ “Troubleshooting the Adapter” on page 67
57
VLAN Overview
With multiple VLANs on a single port, a server with a single adapter can have a
logical presence on multiple IP subnets. By default, you can define 128 VLANs for
each VLAN-aware adapter on your server. However, you can increase this number
by changing the system parameters.
If your network does not require multiple VLANs, you can use the default
configuration, in which case no further configuration is necessary.
VLANs enable you to split your physical LAN into logical subparts, providing an
essential tool for increasing the efficiency and flexibility of your network.
VLANs are commonly used to separate groups of network users into manageable
broadcast domains, to create logical segmentation of workgroups, and to enforce
security policies among each logical segment. Each defined VLAN behaves as its own
separate network, with its traffic and broadcasts isolated from the others, increasing
the bandwidth efficiency within each logical group.
Although VLANs are commonly used to create individual broadcast domains or
separate IP subnets, it can be useful for a server to have a presence on more than one
VLAN simultaneously. Several Oracle Sun products support multiple VLANs on a
per-port or per-interface basis, allowing very flexible network configurations.
The following figure shows an example network that uses VLANs.
58Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
FIGURE:Example VLAN Configuration
Figure Leg end
1 VLAN 1
2 VLAN 2
3 VLAN 3
4 Accounting server (VLAN 3)
5 Main server with GbE-tagged adapter (all VLANs)
6 Shared media segment
7 PC 1: Software development (VLAN 2)
8 PC 2: Software development (VLAN 2)
9 PC 3: Engineering (VLAN 1)
10 PC 4: Accounting (VLAN 3)
11 PC 5: Software development and engineering with GbE-tagged adapter (VLAN 1 and VLAN 2)
Configuring VLANs59
The example network has the following features:
The physical LAN network consists of a switch, two servers, and five clients. The
LAN is logically organized into three different VLANs, each representing a different
IP subnet.
■ VLAN 1 is an IP subnet consisting of the Main Server, Client 3, and Client 5. This
VLAN represents an engineering group.
■ VLAN 2 includes the Main Server, Clients 1 and 2 by means of a shared media
segment, and Client 5. This VLAN is a software development group.
■ VLAN 3 includes the Main Server, the Accounting Server, and Client 4. This
VLAN is an accounting group.
The Main Server is a high-use server that must be accessed from all VLANs and IP
subnets. The server has a Sun Dual Port 10GBase-T Adapter installed. All three IP
subnets are accessed by means of the single physical Ethernet adapter interface. The
server is attached to one of the switch’s Gigabit Ethernet ports, which is configured
for VLANs 1, 2, and 3. Both the Ethernet adapter and the connected switch port have
tagging turned on. Because of the tagging VLAN capabilities of both devices, the
server is able to communicate on all three IP subnets in this network, but continues
to maintain broadcast separation between all of those subnets. The network contains
the following components:
■ The Accounting Server is available to only VLAN 3. The Accounting Server is
isolated from all traffic on VLANs 1 and 2. The switch port connected to the server
has tagging turned off.
■ Clients 1 and 2 are attached to a shared media hub that is then connected to the
switch. Clients 1 and 2 belong only to VLAN 2. Those clients are logically in the
same IP subnet as the Main Server and Client 5. The switch port connected to this
segment has tagging turned off.
■ Client 3 is a member of VLAN 1. This client can communicate only with the Main
Server and Client 5. Tagging is not enabled on Client 3’s switch port.
■ Client 4 is a member of VLAN 3. This client can communicate only with the
servers. Tagging is not enabled on Client 4’s switch port.
■ Client 5 is a member of both VLANs 1 and 2. This client has a Sun Dual Port
10GBase-T Adapter installed. Client 5 is connected to switch port 10. Both the
Ethernet adapter and the switch port are configured for VLANs 1 and 2, and both
have tagging enabled.
VLAN tagging must be enabled only on switch ports that:
■ Create trunk links to other VLAN-aware Ethernet switches.
■ Are connected to tag-capable end-stations, such as servers or workstations with
VLAN-aware Ethernet adapters.
60Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Related Information
■ “VLAN Configuration” on page 61
■ “VLAN Naming Format” on page 61
■ “Configure Static VLANs (Oracle Solaris 10)” on page 62
VLAN Configuration
You can create VLANs according to various criteria, but each VLAN must be
assigned a VLAN tag or VLAN ID (VID). The VID is a 12-bit identifier between 1 and
4094 that identifies a unique VLAN. For each network interface (ixgbe0, ixgbe1,ixgbe2, and so on), 4094 possible VLAN IDs can be selected for each port.
Tagging an Ethernet frame requires the addition of a tag header to the frame. The
header is inserted immediately following the destination MAC address and the
source MAC address. The tag header consists of two bytes of Ethernet Tag Protocol
identifier (TPID, 0x8100) and two bytes of TCP. The TCI consists of a user priority,
the CFI, and the VID.
By default, a single VLAN is configured for every port, which groups all ports into
the same broadcast domain, just as if there were no VLANs at all. This means that
VLAN tagging for the switch port is turned off.
Note – If you configure a VLAN virtual device for an Ethernet adapter, all traffic
sent or received by that Ethernet adapter must be in VLAN-tagged format.
Related Information
■ “VLAN Overview” on page 58
■ “VLAN Naming Format” on page 61
■ “Configure Static VLANs (Oracle Solaris 10)” on page 62
VLAN Naming Format
When configuring VLANs, use the following naming format, which includes both the
VID and the physical PPA:
Configuring VLANs61
VLAN logical PPA = 1000 * VID + Device-PPA
For example, if the virtual ID is 123 and the device PPA is 2, the VLAN interface
would be ixgbe123002. In another example, on a server with an adapter that has an
instance number of 2, belonging to two VLANs with VID 123 and VID 224, the
VLAN interfaces would be ixgbe123002 and ixgbe224002, respectively.
This format limits the maximum number of PPAs (instances) that can be configured
in the /etc/path_to_inst file to 1000.
Related Information
■ “VLAN Overview” on page 58
■ “VLAN Configuration” on page 61
■ “Configure Static VLANs (Oracle Solaris 10)” on page 62
▼ Configure Static VLANs (Oracle
Solaris 10)
1. Create one /etc/hostname.ixgbe# file for each VLAN that will be configured
for each Adapter on the server.
See “VLAN Naming Format” on page 61.
2. Use the ifconfig(1M) command to configure each VLAN virtual device.
Include the IP address in the command you type. For example, if the IP address is
192.2.2.84, type:
# ifconfig ixgbe123002 plumb 192.2.2.84 up
3. Use the ifconfig -a command to see details about the VLAN devices.
This example shows the output of ifconfig -a on a system having VLAN
devices ixgbe123002 and ixgbe224002:
ixgbe123002: flags=201000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4,CoS>\
mtu 1500 index 4
inet 192.2.2.82 netmask ffffff00 broadcast 192.2.2.255
ether 0:13:20:f5:f6:dc
ixgbe224002: flags=201000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4,CoS>\
62Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
mtu 1500 index 5
inet 0.0.0.0 netmask ffffff00
ether 0:13:20:f5:f6:dc
Note – In the preceding examples, the second NIC output for ixgbe224002 was
plumbed and enabled (that is, used the up option), but had no IP address. By default,
the netmask and broadcast addresses are set by the system, which uses IP class C to
make that setting 255.255.255.0. When the address is set, the ifconfig(1M)
command by default does not display the broadcast address if the explicit IP address
is not set.
Refer to the documentation that came with your switch for specific instructions for
setting VLAN tagging and ports.
Related Information
■ “VLAN Overview” on page 58
■ “VLAN Configuration” on page 61
■ “VLAN Naming Format” on page 61
▼ Configure VLANs (Linux)
1. Ensure that the ixgbe module is loaded.
# modprobe ixgbe
2. Plumb the Adapter’s interface.
# ifconfig eth6 xxx.xxx.xx.xxx up
where xxx.xxx.xx.xxx is the IP address of the interface.
3. Add the VID.
For example:
# vconfig add eth6 5
where eth6 is the interface and 5 is the VID.
Configuring VLANs63
Note – In Linux systems, you can use any single digit as the VID.
4. Configure the ixgbe VLAN (eth6 in this example).
# ifconfig eth6.5 xxx.xxx.xx.xxx up
where xxx.xxx.xx.xxx is the IP address of the interface.
Related Information
■ “VLAN Overview” on page 58
■ “VLAN Configuration” on page 61
▼ Configure VLANs (Windows)
1. Click Control Panel.
2. Click Network Connection.
3. Click the folder icon from the sub-manual bar.
4. Right-click the Sun Dual Port 10GBase-T Adapter port, then select Properties.
5. Click Configure.
6. Click VLAN, then click New.
7. Type VLAN with ID (for example, type VLAN10).
8. Click OK.
9. Open the Local Connections for VLAN window from the Network Connections
window (Control Panel->Network Internet->Network Connections).
10. Right-click the Properties button, and select the TCP/IPv4 port in the list.
11. Click the Properties button, and fill in the desired IP address.
12. Click Subnet Mask.
The value 255.255.255.0 is displayed.
64Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
13. Click OK.
14. Repeat Step 3 through Step 10 until all the network ports are VLAN configured.
Note – Ensure that the firewall is configured to allow VLAN traffic. Otherwise, the
VLAN might not operate properly.
Related Information
■ “VLAN Overview” on page 58
■ “VLAN Configuration” on page 61
Configuring VLANs65
66Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Troubleshooting the Adapter
These topics describe how to troubleshoot the installation and operation of the
Adapter on an Oracle SPARC or x86 system running the Oracle Solaris 10 or 11 OS.
These topics are not intended to be comprehensive. They cover basic installation
issues.
DescriptionLinks
Troubleshoot ifconfig(1M)
issues.
Troubleshoot outages.“Analyze a Port Hang” on page 69
Troubleshoot performance.“Analyze Slow Network Performance” on page 69
Related Information
■ “Understanding the Installation Process” on page 1
■ “Understanding the Adapter” on page 7
■ “Installing the Driver” on page 17
■ “Installing the Adapter” on page 25
■ “Troubleshooting the Adapter” on page 67
■ “Configuring Link Aggregation” on page 51
■ “Configuring VLANs” on page 57
“Analyze Why the Device Link Is Missing” on page 68
67
▼ Analyze Why the Device Link Is
Missing
If the ifconfig(1M) command cannot find a device, the following message is
displayed in the output:
...
cannot open ixgbe0; link doesn’t exist
...
1. Check the OS.
■ If the OS is Oracle Solaris 10 8/10, skip to Step 2.
■ If the OS is Oracle Solaris 11, use the dladm(1M) command to plumb the driver.
See the dladm(1M) man page for instructions.
2. Check that the Adapter is seated properly in its slot, that the cables are properly
attached, and that the LEDs are functioning.
3. Use the prtconf(1M) or scanpci(1M) command to ensure that the device is
installed.
4. If the device exists, check the /etc/driver_aliases file to ensure that the file
contains an ixgbe entry that corresponds to the name for the device.
5. If the entry exists, check the /etc/path_to_inst file to ensure that the file
contains an ixgbe entry.
Removing a device and reseating it in another slot does not always clean up the
device tree. If this is the case, you must remove the device tree and reboot the
system. See Oracle Solaris Administration: Network Interfaces and NetworkVirtualization for more information.
Related Information
■ “Analyze a Port Hang” on page 69
■ “Analyze Slow Network Performance” on page 69
68Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
▼ Analyze a Port Hang
1. If the interface encounters a soft hang, replumb the device.
■ For Oracle Solaris 10, use the ifconfig(1M) command.
■ For Oracle Solaris 11, use the dladm(1M) command.
2. If the interface encounters a hard hang, reboot the system.
If the interface encounters another hard hang, try to capture the trace information
by using the dtrace(1M) command, as in the following example.
3. If the system is panicked, retrieve the crash dump in /var/crash/hostname.
Note – If the interface encountered a hard hang or a panic, file a CR at Oracle
Support. Attach the last page of the dtrace(1M) output or the crash dump file to the
CR.
Related Information
■ “Analyze Why the Device Link Is Missing” on page 68
■ “Analyze Slow Network Performance” on page 69
▼ Analyze Slow Network Performance
The Adapter supports several driver parameters that affect the performance of the
ports. See “Driver Parameters (Oracle Solaris OS)” on page 44 for more information
about the default values.
1. Use the truss(1M) command against the process ID of the network application
to view the network performance.
# truss -p PID
2. Look for NIS, DNS, and network routing outages.
If you find any issues, fix them before proceeding.
Troubleshooting the Adapter69
3. Use the iostat(1M) command to view the I/O statistics to ensure that there are
no bottlenecks on the disk.
# iostat -xcn 5
If you discover a bottleneck, try setting logging to dump to the /tmp directory.
Then, retest to ensure that the new configuration improved performance.
4. Use the vmstat(1M) and the mpstat(1M) commands to check that none of the
following conditions exist:
■ CPU is pegged.
■ CPU is receiving too many interrupts.
■ Memory is low.
■ Page faults are occurring.
■ Contention for resources causes too many spins on mutex (smtx).
If the performance issue points to the driver, try to profile the call stack for
ixgbe(7D) by using the DTrace script. For more information about the DTrace
script, go to:
http://support.oracle.com
Related Information
■ “Analyze Why the Device Link Is Missing” on page 68
■ “Analyze a Port Hang” on page 69
70Sun Dual Port 10GBase-T Adapter User’s Guide • July 2012
Glossary
A
ACT(activity) Indicates that the port is up and running.
B
BIOS(basic input/output system) In this guide, the term BIOS refers to the BIOS
software on the client or server system.
C
CFI(canonical format indicator) A 1-bit field in the Ethernet header.
CR(change request)
D
DHCP(Dynamic Host Configuration Protocol) Part of the application layer in the
Internet protocol suite.
DMA(direct memory access)
71
DNS(domain name system) Translates human-readable domain names into
numerical identifiers.
DR(dynamic reconfiguration) Used to automatically reconfigure resources
within a domain or from one domain to another domain.