Sun Microsystems 10GBE XFP manual Preface, How This Document Is Organized

Page 13

Preface

This guide provides instructions for installing both the hardware and software for the Sun Dual 10GbE XFP PCI Express card. This manual also describes how to configure the nxge driver, which controls the card.

These instructions are designed for enterprise system administrators with experience installing network hardware and software.

Note – In this document the term x86 refers to 64-bit and 32-bit systems manufactured using processors compatible with the AMD64 or Intel Xeon/Pentium product families. For supported systems, see the Solaris Hardware Compatibility Guide.

How This Document Is Organized

Chapter 1 provides an overview of the Sun x8 Express Dual 10 Gigabit Ethernet Fiber XFP Low Profile Adapter.

Chapter 2 explains how to install the nxge device driver software in a Solaris SPARC, Solaris x86, or Linux environment.

Chapter 3 describes how to install the Sun x8 Express Dual 10 Gigabit Ethernet Fiber XFP Low Profile Adapter in your system and verify that it has been installed correctly.

Chapter 4 describes how to edit the network host files after the adapter has been installed on your system.

Chapter 5 explains how to set the nxge device driver parameters to customize each device in your system.

xiii

Image 13

Contents Sun Dual 10GbE XFP PCI Express Card User’s Guide Please Recycle Contents Configuring the nxge Device Driver Parameters Network ConfigurationConfiguring Link Aggregation Configuring the Jumbo Frames FeatureConfiguring VLANs Diagnostic Software SpecificationsIndex Tables Page Figures Sun Dual 10GbE XFP PCI Express Card User’s Guide January EMC Declaration of ConformityXii Sun Dual 10GbE XFP PCI Express Card User’s Guide January How This Document Is Organized PrefaceUsing Unix Commands Typographic Conventions Shell PromptsDocumentation, Support, and Training Related DocumentationThird-Party Web Sites Sun Welcomes Your Comments Page Components Product OverviewProduct Description Hardware and Software Requirements Features Sun Dual 10GbE XFP PCI Express Card User’s Guide January To Download the Driver on a Solaris Platform Installing and Setting Up the DriverUnpack the tar file Uncompress the gzipped tar fileFor Sparc systems, change to the following directory For x86 systems# /usr/sbin/pkgadd -d Select the packages you want to installTo discover the driver packages run the pkginfo command Verify that the nxge driver is installed on the systemTo remove the driver packages run the pkgrm command To Remove the Driver from a Solaris PlatformLogin to your system Downloading and Installing the Driver on a Linux Platform# ifconfig -a grep eth # modprobe nxge # ethtool -i eth4 driver nxge version To Remove the Driver From a Linux Platform# rpm -e nxge-1.0-1 Sun Dual 10GbE XFP PCI Express Card User’s Guide January Installing the Adapter Installing the AdapterTo Install the Adapter Installing the Adapter Sun Dual 10GbE XFP PCI Express Card User’s Guide January Install the optical transceivers Installing an Optical TransceiverTo Install an Optical Transceiver Installing the Adapter To Verify the Hardware Installation Verifying the Hardware InstallationConnect the Ethernet cables Ok show-netsOk .properties Ok cd /pci@7c0/pci@0/pci@8/network@0,1Ok boot -r Rebooting the SystemOk device-end Configuring the Network Host Files Network Configuration# grep nxge /etc/pathtoinst # ifconfig nxge0 plumb ip-addressup# cat /etc/hosts Edit the hosts file in the diskless client’s root directory To Set Up a 10-Gigabit Ethernet Port on a Diskless ClientExport/root/client-name Network Configuration Find the root directory of the client system # grep client-name /etc/bootparamsOk boot /pci@7c0/pci@0/pci@8/network@0 Proceed with the Solaris Operating System installationShut down and halt the client system # shutdown -i0 -g0 -y# dladm show-dev Refer the boot-device-order image To Boot Over the Network on Solaris x86 and Linux SystemsSystem should reboot after saving the boot configuration Image pxe-mac-addr Press the F12 key to install the OS from the networkSun Dual 10GbE XFP PCI Express Card User’s Guide January Nxge Hardware and Software Overview Configuring the nxge Device Driver ParametersSetting Parameters Using the ndd Utility Setting nxge Driver Parameters on a Solaris PlatformNoninteractive and Interactive Modes To Specify Device Instances for the ndd Utility To Specify Parameter Values Using the ndd UtilityTo modify a parameter value, use the -setoption # ndd /dev/nxge1 name to get/set ? Setting Parameters Using the nxge.conf FileMan prtconf Following parameters can be set using To Set Driver Parameters Using an nxge.conf FileLocate the path names and the associated instance numbers Set the parameters for the nxge devicesSun Dual 10GbE XFP PCI Express Card User’s Guide January Configuring the nxge Device Driver Parameters Class-opt-ipv4-tcp = 100 class-opt-ipv4-udp = Reboot the system Tuning for Maximum Performance on a Solaris Platform# reboot -r Save the nxge.conf fileSet ipipsqueuefanout=1 set ipsqueuesoftring=1 To Improve Performance on an AMD CPU Based Sun PlatformSet ddimsixalloclimit=1 Configuring the nxge Device Driver Parameters To Set Parameters Using the ethtool Utility Setting Parameters on a Linux PlatformConfiguring the nxge Device Driver Parameters Following are some common parameters that can be changed # ethtool -k eth4 # ethtool -C eth4 rx-usecs # ethtool -c eth4# /usr/local/bin/nxgeconfig eth4 get classoptipv4udp # /usr/local/bin/nxgeconfig eth4 get# /usr/local/bin/nxgeconfig eth4 set classoptipv4tcp 0xfe0 Tuning for Maximum Performance on a Linux PlatformNet.ipv4.tcpsack = Net.core.netdevmaxbacklog =# sysctl -p /etc/sysctlnxge.conf Set up the sysctl utilityChecking Jumbo Frames Configurations Configuring the Jumbo Frames FeatureJumbo Frames Overview # kstat nxge1 grep rdcpackets To Show the Driver Statistics in a Solaris Environment# kstat Nxge38001 Enabling Jumbo Frames in a Solaris EnvironmentBoot -r To Check Layer 2 Configuration# ifconfig nxge mtu Set the maximum MTU for maximum performanceTo Enable Jumbo Frames in a Linux Environment To Check Layer 3 ConfigurationEnsure that the nxge software is installed Enabling Jumbo Frames in a Linux Environment# ifconfig eth4 # ifconfig ethx mtuTo Show the Driver Statistics in a Linux Environment Set the MTU for maximum performanceConfiguring the Jumbo Frames Feature Sun Dual 10GbE XFP PCI Express Card User’s Guide January Configuring Link Aggregation in a Solaris Environment Configuring Link AggregationOverview of Link Aggregation To Configure Link Aggregation in a Solaris Environment # ifconfig aggr33 plumb Use the dladm show-aggr-scommand to display statistics# ifconfig aggr33 192.168.1.1/24 broadcast + up # dladm show-aggr -sTo Configure Bonding for Multiple nxge Interfaces Configuring Link Aggregation in a Linux EnvironmentLoad the bonding driver # dladm show-aggr -LConfigure bond0 interface Sun Dual 10GbE XFP PCI Express Card User’s Guide January Overview of VLANs Configuring VLANsVlan Configuring VLANs in a Solaris Environment 2Ethernet Tag Header Format To Configure Static VLANsTo Configure VLANs in a Linux Environment Configuring VLANs in a Linux Environment# ifconfig -a Ensure that the nxge module is loaded# /sbin/vconfig add eth2 Configure the nxge Vlan eth2 in this example# ifconfig eth2.5 xxx.xxx.xx.xxx up Insert the Vlan moduleConnectors SpecificationsTable A-1XFP Connector Characteristics Performance SpecificationsPower Requirements Physical CharacteristicsSun Dual 10GbE XFP PCI Express Card User’s Guide January SunVTS Diagnostic Software Diagnostic SoftwareUpdating SunVTS to Recognize the Adapter To Update SunVTS to Recognize the AdapterTo Use the netlbtest Using the SunVTS netlbtestSun Dual 10GbE XFP PCI Express Card User’s Guide January Index SymbolsSun Dual 10GbE XFP PCI Express Card User’s Guide January