817-2975-11

8/3/2019 817-2975-11

1/10

Sun Microsystems, Inc.www.sun.com

Submit comments about this document at: http://www.sun.com/hwdocs/feedback

Sun Quad GigaSwift EthernetUTP Adapter Product Notes

Part No. 817-2975-11January 2004, Revision A

8/3/2019 817-2975-11

2/10

PleaseRecycle

Copyr ight 2003 Sun Microsystems, Inc., 4150 Netw ork Circle,Santa Clara, California 95054, U.S.A. All rights reserved .

Sun Microsystems, Inc.has intellectual property rights relating to technology that is described in this d ocument. In particular, and withoutlimitation, these intellectual property rights may include one or more of the U.S. patents listed at http:/ / ww w.sun.com/ p atents and one ormore add itional patents or pend ing patent app lications in the U.S. and in other countries.

This docum ent and the p roduct to which it pertains are distributed und er licenses restricting their use, copying,d istribution, anddecompilation.N o part ofth e product or ofthis document may be reproduced in any form by any means without prior written authorization ofSun and its licensors, if any.

Third-pa rty softwa re, includin g font technology, is copyrigh ted and licensed from Sun supp liers.

Parts of the prod uct may be der ived from Berkeley BSD systems, licensed from the University ofCa lifornia. UNIX is a registered tradem ark inthe U.S.a nd in other countries, exclusively licensed through X/ Open Comp any, Ltd.

Sun, Sun Microsystems,th e Sun logo,AnswerBook2, docs.sun.com, Sun Enterprise Volume Man ager,Op enBoot, SunVTS,Sun Enterprise, SunFire, and Solaris are trademarks, registered tradem arks, or service marks of Sun Microsystems, Inc.in the U.S. and other countries. All SPARCtradem arks are used und er license and are trad emarks or registered trademarks of SPARC International, Inc.in the U.S. and other countries.Prod ucts bearing SPARC tradem arks are based upon an architecture developed by Sun Microsystem s, Inc.

All SPARC trad ema rks are used u nd er license and are trad ema rks or registered trad ema rks of SPARC Intern ational, Inc. in the U.S. and in othercountr ies. Prod ucts bearing SPARC trad ema rks are based up on an architecture developed by Sun Microsystems, Inc.

The OPEN LOOK and Sun Grap hical User Interface was dev eloped by Sun Microsystems, Inc. for its users and licensees. Sun acknow ledgesthe pioneering efforts of Xerox in researching and d eveloping the concept of visual or graph ical user interfaces for the comp uter indu stry.Sunholds a non-exclusive license from Xerox to the Xerox Graph ical User Interface, wh ich license also covers Suns licensees wh o imp lement OPENLOOK GUIs and oth erw ise comp ly with Suns wr itten license agreem ents.

U.S. Government RightsCommercial use. Government u sers are subject to the Sun Microsystems, Inc.stand ard license agreement andapp licable provisions of the FAR and its supp lements.

DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON -INFRINGEMENT,

ARE DISCLAIMED, EXCEPT TO TH E EXTENT THAT SUCH DISCLAIMERS ARE H ELD TO BE LEGALLY INVALID.

Copyr ight 2003 Sun Microsystems, Inc., 4150 Netw ork Circle,Santa Clara, California 95054, Etats-Unis. Tous droits rservs.

Sun Microsystem s, Inc. a les droits de propr it intellectuels relatants la technologie qui est dcrit da ns ce docume nt. En par ticulier, et sans lalimitation, ces droits de prop rit intellectuels peuvent inclure un ou plus des brevets amricains numrs http:/ / ww w.sun.com/ p atents etun ou les brevets plus sup plm entaires ou les app lications de brevet en attente da ns les Etats-Unis et dan s les autres pays.

Ce produ it ou documen t est protg par un copyright et distribu avec des licences qui en restreignent lutilisation, la copie, la distribution, et ladcompilation.Au cune partie de ce produ it ou document ne peut tre reproduite sous aucune forme, par quelque moyen qu e ce soit,sanslautor isation pra lable et crite de Sun et d e ses bailleurs d e licence, sil y ena.

Le logiciel dten u par des tiers, et qui comp rend la technologie relative au x polices de caractres, est protg par un copyright et licenci par d es

fournisseurs d e Sun.Des parties de ce prod uit pou rront tre dr ives des systmes Berkeley BSD licencis par lUniversit de Californie. UNIX est une ma rquedp ose aux Etats-Unis et da ns dautres pays et licencie exclusivem ent par X/ Open Comp any, Ltd.

Sun, Sun M icrosystems, the Sun logo,An swerBook2,d ocs.sun.com, Sun Enterprise Volume Manager, OpenBoot, SunVTS, Sun Enterprise,SunFire, et Solaris sont des marques d e fabrique ou d es marques dp oses, ou ma rques de service, de Sun Microsystems,Inc. aux Etats-Unis et dansdautres pa ys. Toutes les marqu es SPARC sont utilises sous licence et sont des ma rques d e fabriqu e ou des marq ues dp oses de SPARCInternational, Inc.au x Etats-Unis et dans d autres pays. Les produits portant les marques SPARC sont bass sur un e architecture dveloppepar Sun Microsystems,Inc.

Toutes les marqu es SPARC sont utilises sous licence et sont des ma rques d e fabrique ou d es marqu es dposes d e SPARC Internation al, Inc.aux Etats-Unis et dans dautres pays. Les prod uits protan t les marqu es SPARC sont bass sur un e architecture dv elopp e par SunMicrosystems, Inc.Linterface dutilisation graph ique OPEN LOOK et Sun a t dvelop pe par Sun Microsystem s, Inc. pou r ses utilisateurs et licencis. Sunreconnat les efforts de pionn iers de Xerox pour la recherche et le dvelopp emen t du concep t des interfaces dutilisation visuelle ou grap hiquepou r lindu strie de linforma tique. Sun dtient u ne license non exclusive de Xerox sur linterface dutilisation graphiqu e Xerox, cette licencecouvra nt galemen t les licencies de Sun qui metten t en place linterface d utilisation graph ique OPEN LOOK et qui en outre se conform ent auxlicences crites de Sun .

LA DO CUMENTATION EST FOURNIE "EN LTAT" ET TOUTES AUTRES CON DITION S, DECLARATION S ET GARAN TIES EXPRESSESOU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PARLA LOI APPLICABLE, Y COMPRIS NOTAMMENTTOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A LAPTITUDE A UNE UTILISATION PARTICULIERE OU ALABSENCE DE CONTREFAON.

8/3/2019 817-2975-11

3/10

1

Sun Qu ad GigaSw ift Ethernet UTP

Ad apter Produ ct NotesThis prod uct note provides importan t information that w as not available at the timeth e Sun Quad GigaSwift Ethernet UTP Adapter Installation and Users Guide w aswritten.

Errors in the Sun Quad GigaSwift EthernetUTP Users Guide

The following errors in the Sun Quad GigaSwift Ethernet UTP Adapter Installation and

Users Guide were discovered after the product CD was produced.

H ardw are Requirements

Table 1-1 on p age 2 lists a nu mber platforms that are not cur rently supp orted. Thetable should read as follows:

TABLE 1 Hard ware and Software Requirements

Requirements Hardware or Software

H ard w are Su n En terp rise E220, E420, E450, N etr a 1150, N etr aT20, Sun Blad e 150, Sun Blad e 1000, Sun Blad e 2000, SunFire V210, Sun Fire V240, Sun Fire V440, Sun Fire V280,Sun Fire V480, Sun Fire V880

Softw are Solaris 7, 8, and 9 op erating environm ent

8/3/2019 817-2975-11

4/10

2 Sun Quad GigaSwift Ethernet UTP Adapter Product Notes January 2003

To Enable Jumbo Fram es

Pages 27 and 28 provide examples for enabling jumbo frames. The following

example at the top of page 28 is incorrect:

q To set jumbo frames f or a specific in stance o fce, add a line into ce.conf file for

that particular instance to be set to accept-jumbo:

The correct examp le for enabling jumbo frames for a specific instance using th ece.conf file is a s follows:

1. Obtain the hardw are p ath n ames for the ce devices in the device tree.

a. Check the /etc/driver_aliases file to identify the name associated with a

particular dev ice:

Note ce "pci100b,35" is used by the Sun Qu ad GigaSwift Ethernet device.

b. Locate the path names and the associated instance numbers are in the

/etc/path_to_inst file.

# grep ce /etc/path_to_inst

"/pci@1f,0/network@a" 0 "ce"

"/pci@1f,0/network@a" 0 "ce" accept-jumbo=1;

# grep ce /etc/driver_aliases

ce "pci108e,abba"

ce "pci100b,35"

# grep ce /etc/path_to_inst

"/pci@9,600000/pci@1/pci@0/network@0" 0 "ce"




8/3/2019 817-2975-11

5/10

Sun Quad GigaSwift Ethernet UTP Adapter Product Notes 3

2. Add the appropriate lines into the ce.conf file for the particular instances to be

set to accept-jumbo:

In this example, jum bo frames is enabled on interfaces 0 and 3.

3. Save the ce.conf file.

w To Set Driver Parameters Using a ce.conf File

On page 52 the pa rent is incorrect:

To identify a PCI device unam biguously in the ce.conf file, use the nam e, parentnam e, and th e un it-add ress for the d evice. Refer to the pci(4) man page for m oreinformation about the PCI device specification.

In the first line in the p revious example:

s parent = pci@9,600000

In the second line in the previous example:

s parent = pci@9,600000s unit-address = 1

In the third line in the previous example:

s parent = pci@9,600000

s unit-address = 2

In the fourth line in the previous example:

s parent = pci@9,600000s unit-address = 3

The correct parent in all four lines should be changed to the following:

s parent = /pci@9,600000/pci@1

On p age 53, in the second code example, the parent an d un it are incorrect:

# cd /platform/sun4u/kernel/drv

# vi ce.conf

name="pci100b,35" parent="/pci@9,600000/pci@1/pci@0"

unit-address="0" accept-jumbo=1;

name="pci100b,35" parent="/pci@9,600000/pci@1/pci@4"

unit-address="3" accept-jumbo=1;

8/3/2019 817-2975-11

6/10


In the following examp le, the adv-autoneg-cap an d adv-1000fdx-cappara meters are set for a single instance of the Sun Qua d GigaSwift Ethernet device.

The parent and unit address in the code example should be changed to thefollowing:

Usability Enhancem ents to the Driver

On p age 53, the second code example is wrong:

Then you had to get the link status:

It should contain th e following:

Chan ges in Supported Featuress Full hot plug and IO Dynam ic Reconfiguration of the Sun Quad GigaSwift

Ethernet adap ter is not supp orted p ending release of the following patches:

s Solaris 8 110900-09 and 112838-08 (not r eleased yet)s Solaris 9 113068-04 and 110824-05 (not r eleased yet)

The system m ust be p owered off before you install the adap ter.

name="pci100b,35" parent="pci@9,600000" unit-address="2"

adv-autoneg-cap=0 adv-100hdx-cap=0 adv-100fdx-cap=1 adv-1000fdx-cap=0 adv-

10hdx-cap=0 adv-10fdx-cap=0 adv-1000hdx-cap=0 adv-100T4-cap=0;

name="pci100b,35" parent="/pci@9,600000/pci@1" unit-address="0"adv-autoneg-cap=0 adv-100hdx-cap=0 adv-100fdx-cap=1 adv-1000fdx-cap=0 adv-

10hdx-cap=0 adv-10fdx-cap=0 adv-1000hdx-cap=0 adv-100T4-cap=0;

# ndd -get /dev/ce adv_autoneg_cap

1

# ndd -get /dev/ce link_status

1

8/3/2019 817-2975-11

7/10


Know n Issues With the QGE Ad ap terTable lists and d escribes the current problems w ith the QGE ad apter a nd offers workarounds where applicable.

TABLE 2 Problems and Work Around s

Problem Work Around

The bus speed detection may n ot occur in the correct sequence onpower up.

For Solaris 9, install Patch ID 113068-04


Dynam ic Reconfiguration DR of the Qu ad GigaSwift Ethernet onSun Fire V880/ Sun Fire 15000 servers may occasionally cause asystem panic. This problem occurs during the connect phase ofDR. In addition, sometimes the board may be identified asunknown. Both 33 MHz and 66 MHz slots are affected.

For Solaris 9, install Patch ID 113068-04.

For Solaris 8, install Patch ID 110842-11.

System panics when the adapter is configured with hot plug I/ O

space, memory sp ace, and the bus m aster is enabled even if all ofthe registers in the PCI configuration space are not initialized.

For Solaris 9, install Patches ID 110824-04

and 110900-09For Solaris 8, install Patch ID 112838-07.

The device tree isnt built correctly after a series hot plugcomman ds. The ethernet interfaces of the QGE card are n otdetected after hot plug/ DR.



reboot -r hangs wh en using old ce drivers. The CD containsthe m inimu m required d river/ patches for the QGE produ ct.

If your system does not have the latestpatches, install the pa tches before youph ysically installing the card . If installingan OS from the network, you must alsoadd the patch to the OS image on theInstall Server.

Sun Fire V880R systems experience fatal resets under heavy load.Some systems might experience FATAL RESET crash under

heavy stress on the PCI bus. The QGE card is a high bandwidthcard and might bring out this crash if running at high loads.

Contact your Sun Service Representative.

Sun Fire V480R systems experience FATAL RESET fromDAR/ DCS/ CDX. Some systems might experience FATALRESET crash u nd er heavy stress on the PCI bus. The QGE cardis a high bandwidth card and might bring out this crash ifrunning at h igh loads.

Contact your Sun Service Representative.

8/3/2019 817-2975-11

8/10


Note For all Patch IDs listed in TABLE 2, install the latest v ersion. Patches areupdated routinely. Each update has a higher number following the dash. For thePatch IDs listed here, the Patch ID num ber you wou ld install would be the listednum ber or one with a h igher nu mber following the d ash.

Installing the Adap ter to Avoid Cable

ProblemsNote While the RJ-45 connector specifications meet the PCI mechanicalspecifications, the cable release tab m ay be pinched du e to th e tightness of the slotsin some systems.

1. Align the adapter edge connector wi th the PCI slot and sli de i ts face plate into thesmall slot at the end of the PCI opening.

2. Apply even pressure at both corners o f the adapter and pus h the adapter until it i s

firmly seated in the slot.

3. Plug the cable into an RJ-45 conn ector.

4. Adjust the adapter to ensure that you can lo ck the cable i n the connector before

you fasten the screw into the top notch of the face plate.

Ju mbo Fram es Su pportAlthough Jumbo Frames is configurable in 10/ 100 mode, Jumbo Frames is only

sup ported in the Gigabit (1000Mbps) mod e. Configuring Jumbo Fram es allows theQGE interfaces to send/ receive packets of up to 9216 bytes. How ever, the a ctualtransfer size depend s on the sw itch capa bility.

Refer to the d ocumentation that came w ith your switchs for exact comm and s toconfigure Jum bo Frames sup port.

8/3/2019 817-2975-11

9/10


Jumbo Frames with Trunking 1.3

When using Jumbo Frames w ith Trun king 1.3, you mu st explicitly enable Jumbo

Frames on each link p articipating in the Trun k.

w To Configure Jumbo Frames Using ndd

1. Bring down and unplumb the interface before using ndd to set Jumbo Frame.

2. Set the instance number:

In this example, the instance num ber set is 0.

3. Set the i nstance to accept jumbo frames:

4. Plumb the interface up:

Where xx.xx.xx.xx = the IP ad dress of the interface.5. Repeat steps 1 throug 4 to set all the interfaces u sing jumbo frames.

w To Configure Jumbo Frames Using ce.conf

q Add the following line to the ce.conf file to set all the ce interfaces to use jumbo

frames:

% ndd -set /dev/ce instance 0

% ndd -set /dev/ce accept-jumbo 1

% ifconfig ce0 plumb xx.xx.xx.xx up

accept_jumbo=1;

8/3/2019 817-2975-11

10/10


817-2975-11

Documents