Sun Microsystems 10GBE XFP manual Setting nxge Driver Parameters on a Solaris Platform

Page 54

processing. The Sun 10-Gigabit Ethernet Adapter utilizes Sun’s own innovative MAC Controller to map the 10-Gigabit XAUI interface onto the PCI Express form factor. It supports 10 Gb/sec bandwidth using eight transmit and eight receive lanes.

Setting nxge Driver Parameters on a Solaris Platform

You can set the nxge device driver parameters in two ways:

Using the ndd utility

Using the nxge.conf file

If you use the ndd utility, the parameters are valid only until you reboot the system. This method is good for testing parameter settings.

To set parameters so they remain in effect after you reboot the system, create a /platform/sun4u/kernel/drv/nxge.conf file and add parameter values to this file when you need to set a particular parameter for a device in the system.

Setting Parameters Using the ndd Utility

Use the ndd utility to configure parameters that are valid until you reboot the system.

The following sections describe how you can use the nxge driver and the ndd utility to modify (with the -setoption) or display (without the -setoption) the parameters for each nxge device.

Noninteractive and Interactive Modes

You can use the ndd utility in two modes:

Noninteractive

Interactive

In noninteractive mode, you invoke the utility to execute a specific command. Once the command is executed, you exit the utility. In interactive mode, you can use the utility to get or set more than one parameter value. Refer to the ndd(1M) man page for more information.

36 Sun Dual 10GbE XFP PCI Express Card User’s Guide • January 2009

Image 54
Contents Sun Dual 10GbE XFP PCI Express Card User’s Guide Please Recycle Contents Network Configuration Configuring the nxge Device Driver ParametersConfiguring the Jumbo Frames Feature Configuring Link AggregationConfiguring VLANs Specifications Diagnostic SoftwareIndex Tables Page Figures Sun Dual 10GbE XFP PCI Express Card User’s Guide January Declaration of Conformity EMCXii Sun Dual 10GbE XFP PCI Express Card User’s Guide January Preface How This Document Is OrganizedUsing Unix Commands Shell Prompts Typographic ConventionsRelated Documentation Documentation, Support, and TrainingThird-Party Web Sites Sun Welcomes Your Comments Page Product Overview ComponentsProduct Description Hardware and Software Requirements Features Sun Dual 10GbE XFP PCI Express Card User’s Guide January Installing and Setting Up the Driver To Download the Driver on a Solaris PlatformFor Sparc systems, change to the following directory Uncompress the gzipped tar fileUnpack the tar file For x86 systemsSelect the packages you want to install # /usr/sbin/pkgadd -dTo remove the driver packages run the pkgrm command Verify that the nxge driver is installed on the systemTo discover the driver packages run the pkginfo command To Remove the Driver from a Solaris PlatformDownloading and Installing the Driver on a Linux Platform Login to your system# ifconfig -a grep eth # modprobe nxge To Remove the Driver From a Linux Platform # ethtool -i eth4 driver nxge version# 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 Installing an Optical Transceiver Install the optical transceiversTo Install an Optical Transceiver Installing the Adapter Connect the Ethernet cables Verifying the Hardware InstallationTo Verify the Hardware Installation Ok show-netsOk cd /pci@7c0/pci@0/pci@8/network@0,1 Ok .propertiesRebooting the System Ok boot -rOk device-end Network Configuration Configuring the Network Host Files# ifconfig nxge0 plumb ip-addressup # grep nxge /etc/pathtoinst# cat /etc/hosts To Set Up a 10-Gigabit Ethernet Port on a Diskless Client Edit the hosts file in the diskless client’s root directoryExport/root/client-name Network Configuration # grep client-name /etc/bootparams Find the root directory of the client systemShut down and halt the client system Proceed with the Solaris Operating System installationOk boot /pci@7c0/pci@0/pci@8/network@0 # shutdown -i0 -g0 -y# dladm show-dev To Boot Over the Network on Solaris x86 and Linux Systems Refer the boot-device-order imageSystem should reboot after saving the boot configuration Press the F12 key to install the OS from the network Image pxe-mac-addrSun Dual 10GbE XFP PCI Express Card User’s Guide January Configuring the nxge Device Driver Parameters Nxge Hardware and Software OverviewSetting nxge Driver Parameters on a Solaris Platform Setting Parameters Using the ndd UtilityNoninteractive and Interactive Modes To Specify Parameter Values Using the ndd Utility To Specify Device Instances for the ndd UtilityTo modify a parameter value, use the -setoption Setting Parameters Using the nxge.conf File # ndd /dev/nxge1 name to get/set ?Man prtconf Locate the path names and the associated instance numbers To Set Driver Parameters Using an nxge.conf FileFollowing parameters can be set using 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 -r Tuning for Maximum Performance on a Solaris PlatformReboot the system Save the nxge.conf fileTo Improve Performance on an AMD CPU Based Sun Platform Set ipipsqueuefanout=1 set ipsqueuesoftring=1Set ddimsixalloclimit=1 Configuring the nxge Device Driver Parameters Setting Parameters on a Linux Platform To Set Parameters Using the ethtool UtilityConfiguring the nxge Device Driver Parameters Following are some common parameters that can be changed # ethtool -C eth4 rx-usecs # ethtool -c eth4 # ethtool -k eth4# /usr/local/bin/nxgeconfig eth4 get # /usr/local/bin/nxgeconfig eth4 get classoptipv4udpNet.ipv4.tcpsack = Tuning for Maximum Performance on a Linux Platform# /usr/local/bin/nxgeconfig eth4 set classoptipv4tcp 0xfe0 Net.core.netdevmaxbacklog =Set up the sysctl utility # sysctl -p /etc/sysctlnxge.confConfiguring the Jumbo Frames Feature Checking Jumbo Frames ConfigurationsJumbo Frames Overview To Show the Driver Statistics in a Solaris Environment # kstat nxge1 grep rdcpacketsEnabling Jumbo Frames in a Solaris Environment # kstat Nxge38001# ifconfig nxge mtu To Check Layer 2 ConfigurationBoot -r Set the maximum MTU for maximum performanceEnsure that the nxge software is installed To Check Layer 3 ConfigurationTo Enable Jumbo Frames in a Linux Environment Enabling Jumbo Frames in a Linux EnvironmentTo Show the Driver Statistics in a Linux Environment # ifconfig ethx mtu# ifconfig eth4 Set the MTU for maximum performanceConfiguring the Jumbo Frames Feature Sun Dual 10GbE XFP PCI Express Card User’s Guide January Configuring Link Aggregation Configuring Link Aggregation in a Solaris EnvironmentOverview of Link Aggregation To Configure Link Aggregation in a Solaris Environment # ifconfig aggr33 192.168.1.1/24 broadcast + up Use the dladm show-aggr-scommand to display statistics# ifconfig aggr33 plumb # dladm show-aggr -sLoad the bonding driver Configuring Link Aggregation in a Linux EnvironmentTo Configure Bonding for Multiple nxge Interfaces # dladm show-aggr -LConfigure bond0 interface Sun Dual 10GbE XFP PCI Express Card User’s Guide January Configuring VLANs Overview of VLANsVlan Configuring VLANs in a Solaris Environment To Configure Static VLANs 2Ethernet Tag Header Format# ifconfig -a Configuring VLANs in a Linux EnvironmentTo Configure VLANs in a Linux Environment Ensure that the nxge module is loaded# ifconfig eth2.5 xxx.xxx.xx.xxx up Configure the nxge Vlan eth2 in this example# /sbin/vconfig add eth2 Insert the Vlan moduleSpecifications ConnectorsPerformance Specifications Table A-1XFP Connector CharacteristicsPhysical Characteristics Power RequirementsSun Dual 10GbE XFP PCI Express Card User’s Guide January Diagnostic Software SunVTS Diagnostic SoftwareTo Update SunVTS to Recognize the Adapter Updating SunVTS to Recognize the AdapterUsing the SunVTS netlbtest To Use the netlbtestSun Dual 10GbE XFP PCI Express Card User’s Guide January Symbols IndexSun Dual 10GbE XFP PCI Express Card User’s Guide January