Using Unix Commands | Oracle Audio Technologies SunDual 10GbE XFP

Using This Documentation

This guide provides instructions for installing both the hardware and software for the Sun Dual 10GbE XFP PCI Express card from Oracle. 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.

Using UNIX Commands

This document might not contain information about basic UNIX commands and procedures such as shutting down the system, booting the system, and configuring devices. Refer to the following for this information:

■Software documentation that you received with your system

■Solaris Operating System documentation, which is at: http://docs.sun.com

vii

Image 7

Oracle Audio Technologies SunDual 10GbE XFP manual Using This Documentation, Using Unix Commands

Contents

Sun Dual 10GbE XFP PCI Express Card Please Recycle Contents Configuring the nxge Device Driver Parameters Network Configuration Configuring Link Aggregation Configuring the Jumbo Frames FeatureConfiguring VLANs Diagnostic Software SpecificationsIndex Using Unix Commands Using This Documentation Shell Prompts Documentation, Support, and Training Related DocumentationDocumentation Feedback Sun Dual 10GbE XFP PCI Express Card User’s Guide May Components Product OverviewProduct Description 1shows the adapter Hardware and Software Requirements Features EMC Declaration of Conformity Date Sun Dual 10GbE XFP PCI Express Card User’s Guide May To Download the Driver on a Solaris Platform Installing and Setting Up the Driver For x86 systems Uncompress the gzipped tar fileUnpack the tar file For Sparc systems, change to the following directory To remove the driver packages run the pkgrm command Select the packages you want to installVerify that the nxge driver is installed on the system To discover the driver packages run the pkginfo command Login 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 Installing the Adapter Installing the Adapter To Install the Adapter Installing the Adapter Sun Dual 10GbE XFP PCI Express Card User’s Guide May Install the optical transceivers Installing an Optical Transceiver To Install an Optical Transceiver Installing the Adapter Ok show-nets Verifying the Hardware InstallationTo Verify the Hardware Installation Connect the Ethernet cables Ok .properties Ok cd /pci@7c0/pci@0/pci@8/network@0,1 Ok 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/bootparams # shutdown -i0 -g0 -y Proceed with the Solaris Operating System installationOk boot /pci@7c0/pci@0/pci@8/network@0 Shut down and halt the client system # dladm show-dev To Boot Over the Network on Solaris x86 and Linux Systems Refer the boot-device-order image Image pxe-mac-addr Press the F12 key to install the OS from the network Nxge Hardware and Software Overview Configuring the nxge Device Driver Parameters Setting 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 Set the parameters for the nxge devices To Set Driver Parameters Using an nxge.conf FileFollowing parameters can be set using Locate the path names and the associated instance numbers Sun Dual 10GbE XFP PCI Express Card User’s Guide May Configuring the nxge Device Driver Parameters Class-opt-ipv4-tcp = 100 class-opt-ipv4-udp = Save the nxge.conf file Tuning for Maximum Performance on a Solaris PlatformReboot the system # reboot -r Set 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 Platform Configuring 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 Net.core.netdevmaxbacklog = Tuning for Maximum Performance on a Linux Platform# /usr/local/bin/nxgeconfig eth4 set classoptipv4tcp 0xfe0 Net.ipv4.tcpsack = # sysctl -p /etc/sysctlnxge.conf Set up the sysctl utility Checking 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 Environment To Check Layer 2 ConfigurationSet the maximum MTU for maximum performance Enabling Jumbo Frames in a Linux Environment To Check Layer 3 ConfigurationTo Enable Jumbo Frames in a Linux Environment Ensure that the nxge software is installed To Show the Driver Statistics in a Linux Environment # ifconfig eth4 Sun Dual 10GbE XFP PCI Express Card User’s Guide May Overview of Link Aggregation Configuring Link Aggregation To Configure Link Aggregation in a Solaris Environment Configuring Link Aggregation in a Solaris Environment # dladm show-aggr -s Use the dladm show-aggr-scommand to display statistics# ifconfig aggr33 plumb # ifconfig aggr33 192.168.1.1/24 broadcast + up Load the bonding driver Configuring Link Aggregation in a Linux EnvironmentTo Configure Bonding for Multiple nxge Interfaces Configure bond0 interface Overview of VLANs Configuring VLANs 1shows an example network that uses VLANs Configuring VLANs in a Solaris Environment To Configure Static VLANs Ensure that the nxge module is loaded Configuring VLANs in a Linux EnvironmentTo Configure VLANs in a Linux Environment # ifconfig -a Insert the Vlan module Configure the nxge Vlan eth2 in this example# /sbin/vconfig add eth2 # ifconfig eth2.5 xxx.xxx.xx.xxx up Connectors Specifications Table A-1XFP Connector Characteristics Performance Specifications Power Requirements Physical Characteristics Sun Dual 10GbE XFP PCI Express Card User’s Guide May SunVTS Diagnostic Software Diagnostic Software Updating SunVTS to Recognize the Adapter To Update SunVTS to Recognize the Adapter To Use the netlbtest Using the SunVTS netlbtest Sun Dual 10GbE XFP PCI Express Card User’s Guide May Index Symbols Sun Dual 10GbE XFP PCI Express Card User’s Guide May