Sun Microsystems Network Card 806 2989 10 User Manual

Sun GigaSwift Ethernet  
Adapter Installation and  
Users Guide  
Sun Microsystems, Inc.  
901 San Antonio Road  
Palo Alto, CA 94303-4900 U.S.A.  
650-960-1300  
Part No. 806-2989-10  
February 2001, Revision A  
Send comments about this document to: [email protected]  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Regulatory Compliance Statements  
Your Sun product is marked to indicate its compliance class:  
Federal Communications Commission (FCC) — USA  
Industry Canada Equipment Standard for Digital Equipment (ICES-003) — Canada  
Voluntary Control Council for Interference (VCCI) — Japan  
Bureau of Standards Metrology and Inspection (BSMI) — Taiwan  
Please read the appropriate section that corresponds to the marking on your Sun product before attempting to install the  
product.  
FCC Class A Notice  
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:  
1. This device may not cause harmful interference.  
2. This device must accept any interference received, including interference that may cause undesired operation.  
Note: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of  
the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment  
is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy, and if it is  
not installed and used in accordance with the instruction manual, it may cause harmful interference to radio communications.  
Operation of this equipment in a residential area is likely to cause harmful interference, in which case the user will be required  
to correct the interference at his own expense.  
Shielded Cables: Connections between the workstation and peripherals must be made using shielded cables to comply with  
FCC radio frequency emission limits. Networking connections can be made using unshielded twisted-pair (UTP) cables.  
Modifications: Any modifications made to this device that are not approved by Sun Microsystems, Inc. may void the  
authority granted to the user by the FCC to operate this equipment.  
FCC Class B Notice  
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:  
1. This device may not cause harmful interference.  
2. This device must accept any interference received, including interference that may cause undesired operation.  
Note: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of  
the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential  
installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in  
accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee  
that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or  
television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the  
interference by one or more of the following measures:  
Reorient or relocate the receiving antenna.  
Increase the separation between the equipment and receiver.  
Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.  
Consult the dealer or an experienced radio/ television technician for help.  
Shielded Cables: Connections between the workstation and peripherals must be made using shielded cables in order to  
maintain compliance with FCC radio frequency emission limits. Networking connections can be made using unshielded  
twisted pair (UTP) cables.  
Modifications: Any modifications made to this device that are not approved by Sun Microsystems, Inc. may void the  
authority granted to the user by the FCC to operate this equipment.  
iii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
ICES-003 Class A Notice - Avis NMB-003, Classe A  
This Class A digital apparatus complies with Canadian ICES-003.  
Cet appareil numérique de la classe A est conforme à la norme NMB-003 du Canada.  
ICES-003 Class B Notice - Avis NMB-003, Classe B  
This Class B digital apparatus complies with Canadian ICES-003.  
Cet appareil numérique de la classe B est conforme à la norme NMB-003 du Canada.  
iv  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
BSMI Class A Notice  
The following statement is applicable to products shipped to Taiwan and marked as Class A on the product compliance  
label.  
v
Download from Www.Somanuals.com. All Manuals Search And Download.  
vi  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Declaration of Conformity  
Compliance Model Number:  
Product Name:  
GCC PCI  
Sun GigaSwift Ethernet UTP Adapter (X1150A)  
EMC  
European Union  
This equipment complies with the following requirements of the EMC Directive 89/ 336/ EEC:  
EN55022:1998 / CISPR22:1997  
EN550024:1998 EN61000-4-2  
EN61000-4-3  
Class A  
4 kV (Direct), 8 kV (Air)  
3 V/ m  
EN61000-4-4  
1.0 kV Power Lines, 0.5 kV Signal Lines  
EN61000-4-5  
1 kV Line-Line, 2 kV Line-Gnd Power Lines  
EN61000-4-6  
3 V  
EN61000-4-8  
3 A/ m  
Pass  
Pass  
Pass  
EN61000-4-11  
EN61000-3-2:1995  
EN61000-3-3:1995  
Safety  
This equipment complies with the following requirements of the Low Voltage Directive 73/ 23/ EEC:  
EC Type Examination Certificates:  
EN60950:1992, 2nd Edition, Amendments 1,2,3,4,11  
Supplementary Information  
This product was tested and complies with all the requirements for the CE Mark.  
Dennis P. Symanski  
DATE  
Peter Arkless  
DATE  
Manager, Compliance Engineering  
Quality Manager  
Sun Microsystems, Inc.  
901 San Antonio Road, MPK15-102  
Palo Alto, CA 94303-4900, USA  
Sun Microsystems Scotland, Limited  
Springfield, Linlithgow  
West Lothian, EH49 7LR  
Scotland, United Kingdom  
Tel: 650-786-3255  
Fax: 650-786-3723  
Tel: 0506-670000  
Fax: 0506 760011  
vii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
viii  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Contents  
1. Product Overview  
1
Hardware Overview  
1
Sun GigaSwift Ethernet UTP Adapter  
Hardware and Software Requirements  
Product Features  
Key Protocols and Interfaces  
2
3
3
3
Diagnostic Support  
4
2. Installing the Adapter  
5
Installing the Driver Software  
5
Installing the Adapter Without Dynamic Reconfiguration  
8
To Install the Adapter  
8
To Verify the Installation  
9
Setting the local-mac-addressProperty 12  
Rebooting the System 13  
Installing the Adapter With Dynamic Reconfiguration 14  
To Install an Adapter in a Dynamic Reconfiguration System 14  
3. Network Configuration 17  
Configuring the Network Host Files 17  
ix  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Setting Up a Diskless Client System on a GigaSwift Ethernet Network 19  
To Set Up a Diskless Client on a GigaSwift Ethernet Network 20  
Installing the Solaris Operating Environment Over a GigaSwift Ethernet  
Network 21  
To Install the Solaris Environment Over a GigaSwift Ethernet Network 21  
4. Configuring Driver Parameters 25  
GigaSwift Ethernet Device Driver Parameters 25  
Driver Parameter Values and Definitions 26  
Operational Mode Parameters 27  
Flow Control Parameters 28  
Gigabit Forced Mode Parameter 29  
Interpacket Gap Parameters 29  
Interrupt Parameters 31  
Random Early Drop Parameters 31  
PCI Bus Interface Parameters 32  
Setting ceDriver Parameters 33  
Setting Parameters Using the nddUtility 33  
To Specify Device Instances for the nddUtility 34  
Setting Parameters Using the ce.confFile 37  
To Set Driver Parameters Using a ce.confFile 38  
GigaSwift Ethernet Driver Operating Statistics 39  
Reporting the Link Partner Capabilities 40  
5. Configuring VLANs 45  
An Overview of VLANs 45  
Configuring VLANs 47  
To Configure Static VLANs 48  
A. Specifications 51  
x
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Connectors 51  
Performance Specifications 52  
Physical Characteristics 52  
Power Requirements 52  
B. Diagnostic Software and Troubleshooting Issues 53  
SunVTS Diagnostic Software 53  
Using the OpenBoot PROM FCode Self-Test 54  
Running the Ethernet FCode Self-Test Diagnostic 54  
Troubleshooting Issues 56  
Known Incompatibilities with Pre-IEEE 802.3z Network Switches 56  
To Set Autonegotiation to offfor a SunSwitch or an Alteon ACE 110  
Switch 56  
To Set Autonegotiation to offfor Other Noncompliant Network  
Equipment 57  
Index 59  
Contents  
xi  
Download from Www.Somanuals.com. All Manuals Search And Download.  
xii  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Figures  
FIGURE 1-1  
FIGURE 2-1  
FIGURE 5-1  
FIGURE 5-2  
FIGURE A-1  
Sun GigaSwift Ethernet UTP Adapter  
2
Cat-5 Twisted-Pair Cable  
9
Example of Servers Supporting Multiple VLANs with Tagging Adapters 46  
Ethernet Tag Header Format 48  
Sun GigaSwift Ethernet UTP Adapter Connector 51  
xiii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
xiv  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Tables  
TABLE 2-1  
TABLE 4-1  
TABLE 4-2  
TABLE 4-3  
TABLE 4-4  
TABLE 4-5  
TABLE 4-6  
TABLE 4-7  
TABLE 4-8  
TABLE 4-9  
TABLE 4-10  
TABLE 4-11  
TABLE 4-12  
TABLE A-1  
TABLE A-2  
TABLE A-3  
TABLE A-4  
Files and Directories on the CD-ROM  
6
ceDriver Parameter, Status, and Descriptions 26  
Operational Mode Parameters 27  
Read-Write Flow Control Keyword Descriptions 28  
Forced Mode Parameter 29  
Parameters Defining enable_ipg0and ipg0 30  
Read-Write Interpacket Gap Parameter Values and Descriptions 30  
RX Blanking Register for Alias Read 31  
RX Random Early Detecting 8-Bit Vectors 31  
PCI Bus Interface Parameters 32  
Read-Only ceDevice Capabilities 39  
Read-Only Link Partner Capabilities 40  
Transmit and Receive Parameters 41  
Cat-5 Connector Link Characteristics 51  
Performance Specifications 52  
Physical Characteristics 52  
Power Requirements 52  
xv  
Download from Www.Somanuals.com. All Manuals Search And Download.  
xvi  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Preface  
The Sun GigaSwift Ethernet Adapter Installation and Users Guide provides installation  
instructions for both the Sun GigaSwift Ethernet UTP adapter and the Sun GigaSwift  
Ethernet MMF adapter. This manual also describes how to configure the driver  
software.  
These instructions are designed for enterprise system administrators with experience  
installing network hardware and software.  
How This Book Is Organized  
Chapter 1, provides a description of the adapter, including hardware and software.  
Chapter 2, describes how to install the adapter in your system and how to verify that  
it has been installed correctly.  
Chapter 3, describes how to edit the network host files after the adapter has been  
installed on your system.  
Chapter 4, describes how to configure the driver parameters used by the Sun  
GigaSwift Ethernet adapter.  
Chapter 5, explains VLANs in detail and provides configuration instructions and  
examples.  
Appendix A, lists the specifications for the Sun GigaSwift Ethernet adapter.  
Appendix B, provides an overview of the SunVTS diagnostic application and  
instructions for testing the adapter using the onboard FCode selftest. There is also a  
section outlining some common troubleshooting issues.  
xvii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Using UNIX Commands  
This document may not contain information on basic UNIX commands and  
procedures such as shutting down the system, booting the system, and configuring  
devices.  
®
See one or more of the following for this information:  
Solaris Handbook for Sun Peripherals  
AnswerBook2™ online documentation for the Solaris™ operating environment  
Other software documentation that you received with your system  
Typographic Conventions  
Typeface  
Meaning  
Examples  
AaBbCc123  
The names of commands, files,  
and directories; on-screen  
computer output  
Edit your.loginfile.  
Use ls-ato list all files.  
% You have mail.  
What you type, when  
contrasted with on-screen  
computer output  
% su  
Password:  
AaBbCc123  
AaBbCc123  
Book titles, new words or terms, Read Chapter 6 in the Users Guide.  
words to be emphasized  
These are called class options.  
You must be superuser to do this.  
Command-line variable; replace To delete a file, type rmfilename.  
with a real name or value  
xviii Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Shell Prompts  
Shell  
Prompt  
C shell  
machine_name%  
C shell superuser  
machine_name#  
Bourne shell and Korn shell  
Bourne shell and Korn shell superuser  
$
#
Related Documentation  
Application  
Title  
PCI Adapter Installation  
Storage Device Installation  
Your system installation or service manual  
Your storage device installation or service manual  
Dynamic Reconfiguration  
Installation  
Sun Enterprise 6x00, 5x00, 4x00, and 3x00 Systems  
Dynamic Reconfiguration Users Guide  
Diagnostic Software  
SunVTS Users Guide  
SunVTS Test Reference Manual  
OpenBoot™ Commands  
OpenBoot 3.x Command Reference Manual  
Accessing Sun Documentation Online  
SM  
The docs.sun.com web site enables you to access a select group of Sun technical  
documentation on the Web. You can browse the docs.sun.comarchive or search  
for a specific book title or subject at:  
Preface  
xix  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Ordering Sun Documentation  
Fatbrain.com, an Internet professional bookstore, stocks select product  
documentation from Sun Microsystems, Inc.  
For a list of documents and how to order them, visit the Sun Documentation Center  
on Fatbrain.com at:  
Sun Welcomes Your Comments  
Sun is interested in improving its documentation and welcomes your comments and  
suggestions. You can email your comments to Sun at:  
Please include the part number (806-2989-10) of your document in the subject line of  
your email.  
xx Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER  
1
Product Overview  
This chapter provides a description of the Sun GigaSwift Ethernet adapter hardware  
and software.  
Hardware Overview  
The adapter relieves congestion experienced at the backbone and server levels by  
todays networks, while providing a future upgrade path for high-end workstations  
that require more bandwidth than fast Ethernet can provide.  
1
Download from Www.Somanuals.com. All Manuals Search And Download.  
Sun GigaSwift Ethernet UTP Adapter  
The Sun GigaSwift Ethernet UTP adapter is a single-port gigabit Ethernet copper-  
based PCI Bus card. It can be configured to operate in 10, 100, or 1000 Mbps Ethernet  
networks.  
FIGURE 1-1 Sun GigaSwift Ethernet UTP Adapter  
2
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Hardware and Software Requirements  
Before using the Sun GigaSwift Ethernet adapter, make sure your system meets the  
following hardware and software requirements:  
Hardware and Software  
Requirements  
Hardware  
Sun Ultra™ 5, 10, 60, 80  
Sun Enterprise™ 220R, 250, 420R, 450, 3000/ 3500, 4000/ 4500,  
5000/ 5500, 6000/ 6500, 10000  
Sun Blade™ 1000  
OpenBoot PROM  
Revision 3.x, 4.x  
Operating environment Solaris 2.6, 7, 8 releases  
Product Features  
You can install or replace the Sun GigaSwift Ethernet adapter. You can also diagnose  
a failure using the built-in diagnostic tools.  
Key Protocols and Interfaces  
The Sun GigaSwift Ethernet adapter is interoperable with existing Ethernet  
equipment assuming standard Ethernet minimum and maximum frame size (64 to  
1518 bytes), frame format, and compliance with the following standards and  
protocols:  
SNMP (limited MIB)  
Full- and half-duplex gigabit Ethernet interface  
Low CPU utilization—Frees up server system resource and bandwidth  
Dynamic reconfiguration (DR) and redundancy/ failover support  
Full flow control support  
Duplex SC fiber connector (850 nm, SX)  
33/ 66-MHz, 32- or 64-bit bus master  
Universal dual voltage signaling (3.3V and 5V)  
PCI Local Bus Rev 2.2-compliant (6.8-inch x 4.2-inch short card)  
IPv4 and IPv6 support  
Load balancing for RX packets among multiple CPUs  
IEEE 802.1Q VLAN  
Chapter 1  
Product Overview  
3
Download from Www.Somanuals.com. All Manuals Search And Download.  
IEEE 802.1P/ 802.1D Priority Tagging/ Quality Of Service  
RAS support  
Energy Star® support  
Diagnostic Support  
User-executable self-test using OpenBoot™ PROM  
SunVTS diagnostic tool  
4
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER  
2
Installing the Adapter  
This chapter describes how to install the adapter in your system and how to verify  
that it has been installed correctly. This chapter is divided into the following  
sections:  
“Installing the Driver Software” on page 5  
“Installing the Adapter Without Dynamic Reconfiguration” on page 8  
To Verify the Installation” on page 9  
“Setting the local-mac-addressProperty” on page 12  
“Rebooting the System” on page 13  
“Installing the Adapter With Dynamic Reconfiguration” on page 14  
Note – If you have a Sun Enterprise system that supports dynamic reconfiguration  
(DR), refer to the Sun Enterprise Dynamic Reconfiguration Users Guide and your  
systems documentation for further information about dynamic reconfiguration.  
Installing the Driver Software  
The Sun GigaSwift Ethernet Driver 1.0 CD contains the driver software required to  
operate the adapter. Future revisions of the Solaris operating environment might  
contain Sun GigaSwift Ethernet driver software. Refer to the documentation that  
shipped with the Solaris Supplement CD-ROM for a listing of the available network  
drivers.  
1. Become superuser.  
5
Download from Www.Somanuals.com. All Manuals Search And Download.  
2. Insert the Sun GigaSwift Ethernet Driver 1.0 CD into a CD-ROM drive that is  
connected to your system.  
If your system is running Sun Enterprise Volume Manager™, it should  
automatically mount the CD-ROM to the / cdrom/cdrom0directory.  
If your system is not running Volume Manager, mount the CD-ROM as follows:  
# mkdir /cdrom  
# mkdir /cdrom/cdrom0  
# mount -F hsfs -o ro /dev/dsk/c0t6d0s2 /cdrom/cdrom0  
You will see the following files and directories in the  
/cdrom/GigaSwiftEthernetdirectory or the  
/cdrom/cdrom0directory, depending on how you mounted the CD-ROM.  
TABLE 2-1  
Files and Directories on the CD-ROM  
File or Directory  
Copyright  
FR_Copyright  
Docs/  
Contents  
U.S. copyright file  
French copyright file  
Contains PDF copy of the user manual  
GigaSwiftEthernet/  
Solaris_OS-VER/  
Packages/  
Contains the Sun GigaSwift Ethernet software packages  
applicable to your version (OS-VER) of the Solaris software  
• SUNWcea—32-bit adb macros  
• SUNWceax—64-bit adb macros  
• SUNWced—32-bit adapter driver  
• SUNWcedx—64-bit adapter driver  
• SUNWcedu—adapter driver headers  
• SUNWcem—man pages (optional)  
The optional VLAN packages for Solaris 8 only  
• SUNWvld—VLAN utility routines  
• SUNWvldx—VLAN utility routines (64-bit)  
• SUNWvldu—VLAN utility headers  
Note – If you intend to use VLAN, you must install VLAN packages when you  
install the GigaSwift Ethernet software packages.  
6
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3. Install the software packages by typing the following at the command line,  
replacing the OS_VER with your version (2.6, 7, or 8) of the Solaris Operating  
Environment:  
#/usr/sbin/pkgadd -d /cdrom/cdrom0/GigaSwiftEthernet/Solaris_OS_VER/Packages/  
For example, if your system is running the Solaris 8 Operating Environment, you  
would type the following:  
#/usr/sbin/pkgadd -d /cdrom/cdrom0/GigaSwiftEthernet/Solaris_8/Packages/  
A menu similar to the following displays:  
The following packages are available:  
1 SUNWcea  
2 SUNWceax  
3 SUNWced  
4 SUNWcedu  
5 SUNWcedx  
6 SUNWcem  
7 SUNWvld  
8 SUNWvldu  
9 SUNWvldx  
Sun GigaSwift Ethernet Adapter Driver 32 bit adb Macros  
(sparc) 1.0,REV=2000.12.11  
Sun GigaSwift Ethernet Adapter Driver 64 bit adb Macros  
(sparc) 1.0,REV=2000.12.11  
Sun GigaSwift Ethernet Adapter (32-bit Driver)  
(sparc) 1.0,REV=2000.12.11  
Sun GigaSwift Ethernet Adapter Driver Headers  
(sparc) 1.0,REV=2000.12.11  
Sun GigaSwift Ethernet Adapter (64-bit Driver)  
(sparc) 1.0,REV=2000.12.11  
Sun GigaSwift Ethernet Adapter Driver Man Pages  
(sparc) 1.0,REV=2000.12.11  
Sun Ethernet Vlan Utility Routines  
(sparc) 1.0,REV=2000.09.28  
Sun Ethernet Vlan Utility Headers  
(sparc) 1.0,REV=2000.09.28  
Sun Ethernet Vlan Utility Routines (64-bit)  
(sparc) 1.0,REV=2000.09.28  
Select package(s) you wish to process (or ’all’ to process  
all packages). (default: all) [?,??,q]:  
4. Press Return or type allto accept the default and install all packages.  
OR  
5. If you prefer not to install the optional packages, type the number of all but the  
optional packages  
See TABLE 2-1 to identify the optional packages.  
Chapter 2  
Installing the Adapter  
7
Download from Www.Somanuals.com. All Manuals Search And Download.  
Installing the Adapter Without Dynamic  
Reconfiguration  
To Install the Adapter  
Note – The following instructions describe the basic tasks required to install the  
adapter. Refer to your system installation or service manual for detailed PCI adapter  
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 the adhesive copper strip of the antistatic wrist strap to the metal casing of  
the power supply. Wrap the other end twice around your wrist, with the adhesive  
side against your skin.  
5. Holding the PCI adapter by the edges, unpack it and place it on an antistatic  
surface.  
6. Using a No. 1 Phillips screwdriver, remove the PCI filler panel from the slot in  
which you want to insert the PCI adapter.  
Save the filler panel screw for Step 9.  
7. Holding the PCI adapter by the edges, align the adapter edge connector with the  
PCI slot. Slide the adapter face plate into the small slot at the end of the PCI  
opening.  
8
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
8. Applying even pressure at both corners of the adapter, push the PCI adapter until  
it is firmly seated in the slot.  
Caution – Do not use excessive force when installing the adapter into the PCI slot.  
You may damage the adapters PCI connector. If the adapter does not seat properly  
when you apply even pressure, remove the adapter and carefully reinstall it again.  
9. Secure the adapter to the PCI slot using the screw you removed in Step 6.  
10. Detach the wrist strap and close the system unit.  
11. Connect the cables.  
For the Sun GigaSwift Ethernet UTP PCI Bus card, connect a Cat-5 twisted-pair  
cable.  
FIGURE 2-1 Cat-5 Twisted-Pair Cable  
To Verify the Installation  
After you have installed the Sun GigaSwift Ethernet adapter, but before you boot  
your system, perform the following tasks to verify the installation. Refer to the  
Solaris Handbook for Sun Peripherals manual or your Solaris documentation for the  
detailed instructions.  
Chapter 2  
Installing the Adapter  
9
Download from Www.Somanuals.com. All Manuals Search And Download.  
Note – Verification is not required if your system supports dynamic reconfiguration  
(DR).  
1. Power on the system, and when the banner appears, press the Stop-A key  
sequence to interrupt the boot process and display the OpenBoot (ok) prompt. If a  
keyboard is not attached then send the appropriate Break sequence on the serial  
port.  
If the card is properly installed and the cables are properly connected to a  
compatible network, you will see the following message:  
xcvr addr:0x00 - link up 1000 Mbps half duplex  
xcvr addr:0x00 - link up 1000 Mbps full duplex  
2. List the network devices on your system.  
ok show-nets  
Use the show-netscommand to list the system devices. You should see the full  
path name of the networkdevices, similar to the Ultra 30 system example below. In  
this example, the network@4device is the Sun GigaSwift Ethernet adapter and the  
network@1,1is the onboard Ethernet device.  
ok show-nets  
a) /pci@1f,2000/pci@1/network@0  
b) /pci@1f,4000/network@1,1  
q) NO SELECTION  
Enter Selection, q to quit: q  
Note – If you do not see the device listed, check that the adapter is properly seated  
and, if necessary, reinstall the adapter.  
3. View the device that you installed.  
Using the previous example, type:  
ok cd /pci@1f,2000/pci@1/network@4  
10  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
4. View the .propertiesfile for a list of device properties.  
It might be difficult to tell if the devices on your network are GigaSwift Ethernet  
devices or other network interface cards. The .propertiescommand displays the  
specific information about the installed adapter.  
To make sure that the device you just installed is connected to the network, type:  
ok .properties  
assigned-addresses  
82810010 00000000 00200000 00000000 00200000  
82810030 00000000 00400000 00000000 00100000  
local-mac-address  
phy-type  
08 00 20 e5 bf cf  
mif  
max-frame-size  
address-bits  
compatible  
board-model  
model  
00 00 40 00  
00 00 00 30  
70 63 69 31 30 38 65 2c 61 62 62 61 00 70 63 69  
501-5902  
SUNW,pci-ce  
device_type  
reg  
network  
00810000 00000000 00000000 00000000 00000000  
02810010 00000000 00000000 00000000 00200000  
02810030 00000000 00000000 00000000 00100000  
name  
version  
network  
1.10  
fcode-rom-offset  
66mhz-capable  
fast-back-to-back  
devsel-speed  
class-code  
interrupts  
max-latency  
min-grant  
00000000  
00000002  
00020000  
00000001  
00000040  
00000040  
00000001  
0000abba  
0000108e  
revision-id  
device-id  
vendor-id  
Note – If you are going to set the local-mac-addressproperty, note the  
local-mac-addressof your device at this time. See “Setting the local-mac-  
addressProperty” on page 12 for more information.  
Chapter 2  
Installing the Adapter  
11  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Setting the local-mac-addressProperty  
Note – Setting the local-mac-addressproperty is only required if you will be  
booting from the network.  
The network interface of the Sun GigaSwift Ethernet adapter has been assigned a  
unique media access control (MAC) address that represents the 48-bit Ethernet  
address for that interface. The OpenBoot firmware reports this MAC address via the  
local-mac-addressproperty in the device nodes corresponding to the network  
interface.  
A system is not obligated to use this assigned MAC address if it has a system-wide  
MAC address. In such cases, the system-wide MAC address applies to all network  
interfaces on the system.  
The device driver, or any other adapter utility, can use the network devices MAC  
address (local-mac-address) while configuring it. In the Solaris operating  
environment, you can use the MAC address when booting over the network.  
The mac-addressproperty of the network device specifies the network address  
(system-wide or local-mac-address) used for booting the system. To start using  
the MAC address assigned to the network interface of the Sun GigaSwift Ethernet  
adapter, set the NVRAM configuration variable local-mac-address?to true.  
ok setenv local-mac-address? true  
To Set the GigaSwift Ethernet Device Primary Boot Device  
Use this procedure only if you want the GigaSwift Ethernet device to be your  
primary boot device.  
1. List the network devices on your system.  
ok show-nets  
a) /pci@1f,2000/pci@1/network@4  
b) /pci@1f,4000/network@1,1  
q) NO SELECTION  
Enter Selection, q to quit: q  
12  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
2. View the device that you installed.  
Using the previous example, type:  
ok cd /pci@1f,2000/pci@1/network@4  
3. Set the Sun GigaSwift Ethernet device to be your default boot device, type:  
# setenv boot-device=/pci@1f,2000/pci@1/network@4  
Rebooting the System  
After verifying the adapter installation, use the boot -rcommand to perform a  
reconfiguration boot on your system.  
ok boot -r  
Chapter 2  
Installing the Adapter  
13  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Installing the Adapter With Dynamic  
Reconfiguration  
If you have a Sun Enterprise system that supports dynamic reconfiguration (DR),  
you do not have to reboot your system after installing the adapter.  
The process of adding and configuring an adapter with DR involves (1) connecting  
the attachment point and (2) configuring its occupant. In most cases, the  
cfgadm(1M) command can perform both steps at once.  
To Install an Adapter in a Dynamic  
Reconfiguration System  
1. Verify that the selected board slot is ready for the adapter.  
# cfgadm  
The states and conditions should be:  
Receptacle state—Empty  
Occupant state—Unconfigured  
Condition—Unknown  
Or:  
Receptacle state—Disconnected  
Occupant state—Unconfigured  
Condition—Unknown  
14  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
2. If the status of the slot is not “empty” or “disconnected”, type:  
# cfgadm -c disconnect sysctrl#:slot#  
where the sysctrl# = 0for the Enterprise 10000 and slot#= the slot available for the  
adapter. For example, if you were installing the adapter into slot #3 on an Enterprise  
10000, you would type the following:  
# cfgadm -c disconnect sysctrl0:3  
3. Physically insert the adapter into the slot and look for an acknowledgement on  
the console, such as, “name board inserted into slot3.”  
After the adapter is inserted, the states and conditions should become:  
Receptacle state—Disconnected  
Occupant state—Unconfigured  
Condition—Unknown  
Any other states or conditions should be considered an error.  
4. Connect any peripheral cables and interface modules to the adapter.  
5. Connect the cables to the card and to an Ethernet network.  
6. Configure the adapter with the following command:  
# cfgadm -v -c configure sysctrl#:slot#  
This command should both connect and configure the receptacle. Verify with the  
cfgadmcommand.  
The states and conditions for a connected and configured attachment point should  
be:  
Receptacle state—Connected  
Occupant state—Configured  
Condition—OK  
Chapter 2  
Installing the Adapter  
15  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Now the system is also aware of the usable devices which reside on the adapter and  
all devices may be mounted or configured to be used.  
If the command fails to connect and configure the adapter and slot (the status should  
be shown as “configured” and “ok”), do the connection and configuration as  
separate steps:  
a. Connect the adapter and slot:  
# cfgadm -v -c connect sysctrl#:slot#  
The states and conditions for a connected attachment point should be:  
Receptacle state—Connected  
Occupant state—Unconfigured  
Condition—OK  
Now the system is aware of the adapter, but not the usable devices which reside  
on the adapter. Temperature is monitored and power and cooling affect the  
attachment point condition.  
b. Configure the adapter and slot:  
# cfgadm -v -c configure sysctrl#:slot#  
The states and conditions for a configured attachment point should be:  
Receptacle state—Connected  
Occupant state—Configured  
Condition—OK  
Now the system is also aware of the usable devices which reside on the adapter and  
all devices may be mounted or configured to be used.  
7. Reconfigure the devices on the adapter  
# drvconfig; devlinks; disks; ports; tapes;  
The console should now display a list of devices and their addresses.  
16  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER  
3
Network Configuration  
This chapter describes how to edit the network host files after the adapter has been  
installed on your system. The chapter contains the following sections:  
“Configuring the Network Host Files” on page 17  
“Setting Up a Diskless Client System on a GigaSwift Ethernet Network” on  
page 19  
“Installing the Solaris Operating Environment Over a GigaSwift Ethernet  
Network” on page 21  
Configuring the Network Host Files  
After installing the driver software, you must create a hostname.cenumber file for  
the adapters Ethernet interface. You must also create both an IP address and a host  
name for its Ethernet interface in the /etc/hostsfile.  
1. At the command line, use the grepcommand to search the /etc/path_to_inst  
file for ceinterfaces.  
# grep ce /etc/path_to_inst  
"/pci@1f,4000/pci@1/network@4" 0 "ce"  
In the example above, the device instance is from a Sun GigaSwift Ethernet adapter  
installed in slot 1. For clarity, the instance number is in bold italics.  
2. Use the ifconfigcommand to setup the adapters ceinterface.  
17  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Use the ifconfigcommand to assign an IP address to the network interface. Type  
the following at the command line, replacing ip_address with the adapters IP  
address:  
# ifconfig ce0 plumb ip_address up  
Refer to the ifconfig(1M) man page and the Solaris documentation for more  
information.  
If you want a set-up that will remain the same after you reboot, create an  
/etc/hostname.cenumber file, where number corresponds to the instance  
number of the ceinterface you plan to use.  
To use the adapters ceinterface in the Step 1 example, create an  
/etc/hostname.ce0file, where 0is the number of the ceinterface. If the  
instance number were 1, the filename would be  
/etc/hostname.ce1.  
Do not create an /etc/hostname.cenumber file for a Sun GigaSwift Ethernet  
adapter interface you plan to leave unused.  
The /etc/hostname.cenumber file must contain the hostname for the  
appropriate ceinterface.  
The host name should have an IP address and should be listed in the  
/etc/hostsfile.  
The host name should be different from any other host name of any other  
interface, for example: /etc/hostname.ce0and /etc/hostname.ce1cannot  
share the same host name.  
The following example shows the /etc/hostname.cenumber file required for a  
system called zardozthat has a Sun GigaSwift Ethernet adapter (zardoz-11).  
# cat /etc/hostname.hme0  
zardoz  
# cat /etc/hostname.ce0  
zardoz-11  
18  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3. Create an appropriate entry in the /etc/hostsfile for each active ceinterface.  
For example:  
# cat /etc/hosts  
#
# Internet host table  
#
127.0.0.1  
localhost  
129.144.10.57 zardoz  
loghost  
129.144.11.83 zardoz-11  
Setting Up a Diskless Client System on a  
GigaSwift Ethernet Network  
Note – Setting up a diskless client over GigaSwift Ethernet adapter in VLAN  
configuration is not supported. For setting up a diskless client, the switch port to  
which the GigaSwift Ethernet adapter is connected must be in normal LAN mode.  
Before you can boot and operate a diskless client system across a gigabit Ethernet  
network, you must first install the GigaSwift Ethernet software packages into the  
root directory of the diskless client. You can find the GigaSwift Ethernet software  
packages on the Sun GigaSwift Ethernet Driver 1.0 CD. Refer to the Solaris Advanced  
Installation Guide and the System Administration Guide for more information about  
installing and administering diskless client systems.  
Note – The Solaris 8 operating environment does not support diskless clients.  
Solaris 8 Update 1/ 01 does support diskless clients. Refer to the Solaris Advanced  
Installation Guide and the System Administration Guide for more information about  
installing and administering diskless client systems.  
Chapter 3  
Network Configuration  
19  
Download from Www.Somanuals.com. All Manuals Search And Download.  
To Set Up a Diskless Client on a GigaSwift  
Ethernet Network  
1. Locate the root directory of the diskless client on the host server.  
The root directory of diskless client system is commonly installed in the host  
servers /export/root/client_name directory, where client_name is the diskless  
client’s host name. In this procedure, the root directory will be:  
# ls /export/root  
systest157-38/ systest162-38/ systest180-38/  
systest160-38/ systest177-38/ systest182-38/  
2. Insert the Sun GigaSwift Ethernet Driver 1.0 CD into the servers CD-ROM drive.  
The CD should automatically mount to the /cdrom/cdrom0directory. If the CD did  
not get mounted to this directory, refer to “Installing the Driver Software” on page 5  
for mounting instructions.  
3. Use the pkgadd -Rcommand to install the three GigaSwift Ethernet software  
packages to the diskless clients root directory on the server.  
You will need to install the SUNWced, SUNWcedm, and SUNWcedusoftware packages  
to the clients root directory.  
# cd /cdrom/cdrom0/GigaSwiftEthernet/Packages  
# pkgadd -R /export/root/client_name -d . SUNWced SUNWcem SUNWcedu  
# cd /  
4. Eject the Sun GigaSwift Ethernet Driver 1.0 CD from the CD-ROM drive.  
5. Create a hostname.cenumber file in the diskless clients root directory.  
You will need to create an /export/root/client_name/etc/hostname.cenumber  
file for the GigaSwift Ethernet interface. See “Configuring the Network Host Files”  
on page 17 for instructions.  
6. Edit the hostsin the diskless clients root directory.  
You will need to edit the /export/root/client_name/etc/hostsfile to include the  
IP address of the GigaSwift Ethernet interface. See “Configuring the Network Host  
Files” on page 17 for instructions.  
20  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Installing the Solaris Operating  
Environment Over a GigaSwift Ethernet  
Network  
The Solaris Advanced Installation Guide describes the full procedure for installing the  
Solaris operating environment over the network. The procedure below assumes that  
you have created an install server, which contains the image of the Solaris CD, and  
that you have set up the client system to be installed over the network.  
Before you can install the Solaris operating environment on a client system with a  
GigaSwift Ethernet adapter, you must first add the GigaSwift Ethernet software  
packages to the install server. These software packages are on Sun GigaSwift Ethernet  
Driver 1.0 CD.  
Note – You cannot install Solaris over VLAN configurations. The switch port to  
which GigaSwift Ethernet Adapter is connected, must be in normal LAN mode.  
To Install the Solaris Environment Over a  
GigaSwift Ethernet Network  
1. Prepare the install server and client system to install the Solaris operating  
environment over the network.  
The Solaris Advanced Installation Guide describes how to create the install server and  
set up the client systems.  
Note – If you want to install the client system over a network that is not part of the  
same subnet, you must also create a boot server. The Solaris Advanced Installation  
Guide describes how to create a boot server.  
Chapter 3  
Network Configuration  
21  
Download from Www.Somanuals.com. All Manuals Search And Download.  
2. Find the root directory of the client system.  
The client systems root directory can be found in the install servers  
/etc/bootparamsfile. Use the grepcommand to search this file for the root  
directory.  
# grep client_name /etc/bootparams  
client_name root=server_name:/netinstall/Solaris_2.7/Tools/Boot  
install=server_name:/netinstall boottype=:in rootopts=:rsize=32768  
In the example above, the root directory for the Solaris 7 client is /netinstall. In  
Step 4, you would replace root_directory with /netinstall.  
Note – If the root directory is not found in the /etc/bootparamsfile, refer to the  
Solaris Advanced Installation Guide for configuration instructions.  
3. Insert the Sun GigaSwift Ethernet Driver 1.0 CD into the install servers CD-ROM  
drive.  
The CD should automatically mount to the /cdrom/cdrom0directory. If the CD did  
not get mounted to this directory, refer to “Installing the Driver Software” on page 5  
for mounting instructions.  
4. On the install server, install the GigaSwift Ethernet software to the clients root  
directory, as determined in Step 2.  
Replace root_directory with the location of the clients root directory.  
# cd /cdrom/cdrom0/GigaSwiftEthernet/Packages  
# ls SUNWce*  
SUNWcea SUNWceax SUNWced SUNWcedu SUNWcem  
# pkgadd -R root_directory/Solaris_2.7/Tools/Boot -d . SUNWced SUNWcem SUNWcedu  
# cd /  
Note – The directory paths for these files might change in future Solaris releases. If  
the commands above do not work correctly, refer to the documentation that shipped  
with your version of the Solaris operating environment.  
5. Eject the Sun GigaSwift Ethernet Driver 1.0 CD from the CD-ROM drive.  
Note – Perform the following steps on the client system.  
22  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
6. Shut down and halt the client system.  
Use the shutdowncommand to display the OpenBoot (ok) prompt.  
# shutdown -i0 -g0 -y  
. . .  
(shutdowncommand messages omitted)  
. . .  
ok  
7. At the okprompt, use the show-netscommand to find the device path of the  
GigaSwift Ethernet device.  
The show-netscommand lists the system devices. You should see the full path  
name of the network device, similar to the example below. In this example, the  
network@4device is the Sun GigaSwift Ethernet adapter.  
ok show-nets  
a) /pci@1f,2000/pci@1/network@4  
b) /pci@1f,4000/network@1,1  
q) NO SELECTION  
Enter Selection, q to quit: q  
8. At the okprompt, boot the client system using the full device path of the Gigabit  
Ethernet device.  
For example:  
ok boot /pci@1f,2000/pci@1/network@4  
9. Proceed with the Solaris operating environment installation.  
Refer to the Solaris Advanced Installation Guide for more information about installing  
the Solaris operating environment over the network.  
Chapter 3  
Network Configuration  
23  
Download from Www.Somanuals.com. All Manuals Search And Download.  
10. After installing the Solaris operating environment, install the Sun GigaSwift  
Ethernet software on the client system.  
The software installed in Step 4 was required to boot the client system over the  
GigaSwift Ethernet interface. You now need to install the software in order for the  
operating system to use the clients GigaSwift Ethernet interfaces in normal  
operation.  
Before installing the Sun GigaSwift Ethernet software, make sure that the client  
system does not already have the software installed. Use the pkginfocommand to  
see if the Sun GigaSwift Ethernet software packages are installed on the client  
system.  
# pkginfo | grep SUNWce  
system SUNWced Sun Gigabit Ethernet Adapter Driver  
system SUNWcem Sun Gigabit Ethernet Adapter Driver Man Pages  
system SUNWcedu Sun Gigabit Ethernet Adapter Driver Headers  
If the software is installed (as shown in the example above), skip to Step 11.  
If the software is not installed, install the software from Solaris Supplement CD.  
Refer to “Installing the Driver Software” on page 5 for instructions on installing  
the required software packages.  
11. Confirm that the network host files have been configured correctly during the  
Solaris installation.  
Although the Solaris software installation creates the clients network configuration  
files, you may need to edit these files to match your specific networking  
environment. See “Configuring the Network Host Files” on page 17 for more  
information about editing these files.  
24  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER  
4
Configuring Driver Parameters  
This chapter describes how to configure the driver parameters used by the Sun  
GigaSwift Ethernet adapter. This chapter contains the following sections:  
“GigaSwift Ethernet Device Driver Parameters” on page 25  
“Setting ceDriver Parameters” on page 33  
“GigaSwift Ethernet Driver Operating Statistics” on page 39  
GigaSwift Ethernet Device Driver  
Parameters  
The cedevice driver controls the GigaSwift Ethernet devices. The cedriver is  
attached to the UNIX pciname property pci108e,abbafor the Sun GigaSwift  
Ethernet adapter (108eis the vendor ID and abbais the PCI device ID).  
You can manually configure the cedevice driver parameters to customize each Sun  
GigaSwift Ethernet adapter device in your system. This section provides an  
overview of the capabilities of the GigaSwift Ethernet device used in the adapter,  
lists the available cedevice driver parameters, and describes how to configure these  
parameters.  
The Sun GigaSwift Ethernet UTP PCI adapter is capable of all the operating speeds  
and modes listed in “Setting the Autonegotiation Mode” on page 36. The ce device  
performs autonegotiation with the remote end of the link (link partner) to select a  
common mode of operation. The ce device also supports a forced mode of operation.  
25  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Driver Parameter Values and Definitions  
TABLE 4-1 describes the parameters and settings for the cedevice driver.  
TABLE 4-1 ceDriver Parameter, Status, and Descriptions  
Parameter  
Status  
Description  
instance  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Read and write  
Device instance  
adv_autoneg_cap  
adv_1000fdx_cap  
adv_1000hdx_cap  
adv_100T4_cap  
adv_100fdx_cap  
adv_100hdx_cap  
adv_10fdx_cap  
adv_10hdx_cap  
adv_asmpause_cap  
adv_pause_cap  
link_master  
use_int_xcvr  
enable_ipg0  
ipg0  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Operational mode parameter  
Flow control parameter  
Flow control parameter  
1Gb forced mode parameter  
Enable additional delay before transmitting a packet  
Additional delay before transmitting a packet  
Interpacket Gap parameter  
ipg1  
ipg2  
Interpacket Gap parameter  
rx_intr_pkts  
rx_intr_time  
red_dv4to6k  
red_dv6to8k  
red_dv8to10k  
red_dv10to12k  
tx_dma_weight  
rx_dma_weight  
infinit_burst  
disable_64bit  
Receive interrupt blanking values  
Receive interrupt blanking values  
Random early detection and packet drop vectors  
Random early detection and packet drop vectors  
Random early detection and packet drop vectors  
Random early detection and packet drop vectors  
PCI Interface parameter  
PCI Interface parameter  
PCI Interface parameter  
PCI Interface parameter  
26  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Operational Mode Parameters  
The following parameters determine the transmit and receive speed and duplex.  
TABLE 4-2 describes the operational mode parameters and their default values.  
TABLE 4-2  
Parameter  
Operational Mode Parameters  
Description  
adv_autoneg_cap  
adv_1000fdx_cap  
adv_1000hdx_cap  
adv_100fdx_cap  
adv_100hdx_cap  
adv_10fdx_cap  
adv_10hdx_cap  
Local interface capability advertised by the hardware  
0 = Forced mode  
1 = Autonegotiation (default)  
Local interface capability advertised by the hardware  
0 = Not 1000 Mbit/ sec full-duplex capable  
1 = 1000 Mbit/ sec full-duplex capable (default)  
Local interface capability advertised by the hardware  
0 = Not 1000 Mbit/ sec half-duplex capable  
1 = 1000 Mbit/ sec half-duplex capable (default)  
Local interface capability advertised by the hardware  
0 = Not 100 Mbit/ sec full-duplex capable  
1 = 100 Mbit/ sec full-duplex capable (default)  
Local interface capability advertised by the hardware  
0 = Not 100 Mbit/ sec half-duplex capable  
1 = 100 Mbit/ sec half-duplex capable (default)  
Local interface capability advertised by the hardware  
0 = Not 10 Mbit/ sec full-duplex capable  
1 = 10 Mbit/ sec full-duplex capable (default)  
Local interface capability advertised by the hardware  
0 = Not 10 Mbit/ sec half-duplex capable  
1 = 10 Mbit/ sec half-duplex capable (default)  
Note – If a parameters initial setting is 0, it cannot be changed. If you try to change  
it, it will revert back to 0.  
If all these parameters are set to 1, autonegotiation will use the highest speed  
possible. If all these parameters are set to 0, you will receive the following error  
message:  
NOTICE: Last setting will leave ce1 with no link capabilities.  
WARNING: ce1: Restoring previous setting.  
Chapter 4  
Configuring Driver Parameters  
27  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Flow Control Parameters  
The cedevice is capable of sourcing (transmitting) and terminating (receiving)  
pause frames conforming to the IEEE 802.3x Frame Based Link Level Flow Control  
Protocol. In response to received flow control frames, the cedevice can slow down  
its transmit rate. On the other hand, the cedevice is capable of sourcing flow control  
frames, requesting the link partner to slow down, provided that the link partner  
supports this feature. By default, the driver advertises both transmit and receive  
pause capability during autonegotiation.  
TABLE 4-3 provides flow control keywords and describes their function.  
TABLE 4-3  
Keyword  
Read-Write Flow Control Keyword Descriptions  
Description  
adv_asmpause_cap  
The adapter supports asymmetric pause, which means it  
can pause only in one direction.  
0=Off (default)  
1=On  
adv_pause_cap  
This parameter has two meanings depending on the  
value of adv_asmpause_cap. (Default=0)  
If adv_asmpause_cap= 1 while adv_pause_cap= 1  
pauses are received.  
If adv_asmpause_cap= 1 while adv_pause_cap= 0  
pauses are transmitted.  
If adv_asmpause_cap= 0 while adv_pause_cap= 1  
pauses are sent and received.  
If adv_asmpause_cap= 0 then adv_pause_cap  
determines whether Pause capability is on or off.  
28  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Gigabit Forced Mode Parameter  
In 10/ 100 mode it was possible to disable auto-negotiation and force the link to the  
speed you required. With Gigabit copper interfaces this feature is also available but  
may require you to decide whether your side of the connection is a master or a slave.  
The link_masterparameter will facilitate that. Usually switches will be enabled as  
master therefore this parameter can remain unchanged, since slave operation is the  
default. If this is not the case Then link_mastercan be used to enable ceas a  
master.  
TABLE 4-4  
Parameter  
Forced Mode Parameter  
Description  
link_master  
When set to 1 this enables master operation, assuming the link  
partner is a slave.  
When set to 0 this enables slave operation, assuming the link  
partner is a slave. (default)  
Interpacket Gap Parameters  
The cedevice supports a programmable mode called enable_ipg0.  
When a driver receives a packet with enable_ipg0set (the default), it adds an  
additional time delay before transmitting the packet. This delay, set by the ipg0  
parameter, is in addition to the delay set by the ipg1and ipg2parameters. The  
additional ipg0delay helps to reduce collisions.  
If enable_ipg0is disabled, the value of ipg0is ignored and no additional delay is  
set. Only the delays set by ipg1and ipg2will be used. Disable enable_ipg0if  
other systems keep sending a large number of back-to-back packets. Systems that  
have enable_ipg0set might not have enough time on the network.  
You can add the additional delay by setting the ipg0parameter from 0 to 255, which  
is the media byte time delay.  
Chapter 4  
Configuring Driver Parameters  
29  
Download from Www.Somanuals.com. All Manuals Search And Download.  
TABLE 4-5 defines the enable_ipg0and ipg0parameters.  
TABLE 4-5  
Parameters Defining enable_ipg0and ipg0  
Parameter  
Values  
Description  
enable_ipg0  
0
1
enable_ipg0reset  
enable_ipg0set (Default=8)  
ipg0  
0 to 255  
The additional time delay (or gap) before  
transmitting a packet (after receiving the  
packet) (Default=8)  
The cedevice supports the programmable Interpacket Gap (IPG) parameters ipg1  
and ipg2. The total IPG is the sum of ipg1and ipg2. The total IPG is 0.096  
microseconds for the link speed of 1000 Mbps.  
TABLE 4-6 lists the default values and allowable values for the IPG parameters.  
TABLE 4-6  
Parameter  
Read-Write Interpacket Gap Parameter Values and Descriptions  
Values  
Description  
(Byte-time)  
ipg1  
ipg2  
0 to 255  
0 to 255  
Interpacket gap 1 (Default = 8)  
Interpacket gap 2 (Default = 4)  
By default, the driver sets ipg1to 8-byte time and ipg2to 4-byte time, which are  
the standard values. (Byte time is the time it takes to transmit one byte on the link,  
with a link speed of 1000 Mbps.)  
If your network has systems that use longer IPG (the sum of ipg1and ipg2), and if  
those machines seem to be slow in accessing the network, increase the values of  
ipg1and ipg2to match the longer IPGs of other machines.  
30  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Interrupt Parameters  
TABLE 4-7 describes the receive interrupt blanking values.  
TABLE 4-7  
RX Blanking Register for Alias Read  
Field Name  
Values  
Description  
rx_intr_pkts  
0 to 511  
Interrupt after this number of packets have arrived since  
the last packet was serviced. A value of zero indicates no  
packet blanking. (Default=3)  
rx_intr_time  
0 to 524287  
Interrupt after 4.5 US ticks have elapsed since the last  
packet was serviced. A value of zero indicates no time  
blanking. (Default=1250)  
Random Early Drop Parameters  
TABLE 4-8 describes the RX random early detection 8-bit vectors, which allows you to  
enable random early drop (RED) thresholds. When received packets reach the RED  
range packets are dropped according to the preset probability. The probability  
should increase when the fifo level increases. Control packets are never dropped and  
are not counted in the statistics.  
TABLE 4-8  
RX Random Early Detecting 8-Bit Vectors  
Field Name  
Values  
Description  
red_dv4to6k  
0 to 255  
Random early detection and packet drop vectors for  
when fifo threshold is greater than 4096 bytes and less  
than 6,144 bytes. Probability of drop can be  
programmed on a 12.5 percent granularity. For  
example, if bit 0 is set the first packet out of every eight  
will be dropped in this region. (Default=0)  
Chapter 4  
Configuring Driver Parameters  
31  
Download from Www.Somanuals.com. All Manuals Search And Download.  
TABLE 4-8  
RX Random Early Detecting 8-Bit Vectors  
Field Name  
Values  
Description  
red_dv6to8k  
0 to 255  
Random early detection and packet drop vectors for  
when fifo threshold is greater than 6,144 bytes and less  
than 8,192 bytes. Probability of drop can be  
programmed on a 12.5 percent granularity. For  
example, if bit 8 is set the first packet out of every eight  
will be dropped in this region. (Default=0)  
red_dv8to10k  
red_dv10to12k  
0 to 255  
Random early detection and packet drop vectors for  
when fifo threshold is greater than 8,192 bytes and less  
than 10,240 bytes. Probability of drop can be  
programmed on a 12.5 percent granularity. For  
example, if bit 16 is set the first packet out of every  
eight will be dropped in this region. (Default=0)  
0 to 255  
Random early detection and packet drop vectors for  
when fifo threshold is greater than 10,240 bytes and less  
than 12,288 bytes. Probability of drop can be  
programmed on a 12.5 percent granularity. For  
example, if bit 24 is set the first packet out of every  
eight will be dropped in this region. (Default=0)  
PCI Bus Interface Parameters  
These parameters allow you to modify PCI interface features to gain better PCI  
interperformance for a given application.  
TABLE 4-9  
Parameter  
PCI Bus Interface Parameters  
Description  
tx_dma_weight  
Determine the multiplication factor for granting credit to the TX  
side during a weighted round robin arbitration. Values are 0 to 3.  
(Default=0) Zero means no extra weighting. The other values  
are power of 2 extra weighting, on that traffic. For example  
of tx_dma_weight = 0 and rx_dma_weight = 3 then as long  
as RX traffic is continuously arriving its priority will be 8  
times greater than TX to access the PCI  
32  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
TABLE 4-9  
Parameter  
PCI Bus Interface Parameters  
Description  
rx_dma_weight  
infinite_burst  
Determine the multiplication factor for granting credit to the RX  
side during a weighted round robin arbitration. Values are 0 to 3.  
(Default=0)  
allows the infinite burst capability to be utilized. When this is in  
effect and the system supports infinite burst. The adapter will not  
free the bus until complete packets are transferred across the bus.  
Values are 0 or 1. (Default=0)  
disable_64bit  
Switches off 64 bit capability of the adapter. In some cases, it is  
useful to switch off this feature.  
Values are 0 or 1. (Default=0, which enables 64 bit capability)  
Setting ceDriver Parameters  
You can set the cedevice driver parameters in two ways:  
Using the nddutility  
Using the ce.conffile  
If you use the nddutility, 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  
/kernel/drv/ce.conffile 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 nddUtility  
Use the nddutility to configure parameters that are valid until you reboot the  
system. The nddutility supports any networking driver, which implements the Data  
Link Provider Interface (DLPI).  
The following sections describe how you can use the cedriver and the nddutility to  
modify (with the -setoption) or display (without the -setoption) the parameters  
for each cedevice.  
Chapter 4  
Configuring Driver Parameters  
33  
Download from Www.Somanuals.com. All Manuals Search And Download.  
To Specify Device Instances for the nddUtility  
Before you use the nddutility to get or set a parameter for a cedevice, you must  
specify the device instance for the utility.  
1. Check the /etc/path_to_instfile to identify the instance associated with a  
particular device.  
# grep ce /etc/path_to_inst  
"/pci@1f,2000/pci@1/network@0" 2 "ce"  
"/pci@1f,2000/pci@2/network@0" 1 "ce"  
"/pci@1f,2000/pci@4/network@0" 0 "ce"  
In the example above, the three GigaSwift Ethernet instances are from the installed  
adapters. The instance numbers are in bold italics for clarity.  
2. Use the instance number to select the device.  
# ndd -set /dev/ce instance instance#  
The device remains selected until you change the selection.  
Noninteractive and Interactive Modes  
You can use the nddutility 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.)  
Using the nddUtility in Noninteractive Mode  
This section describes how to modify and display parameter values.  
34  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
To modify a parameter value, use the -setoption.  
If you invoke the nddutility with the -setoption, the utility passes value, which  
must be specified, down to the named /dev/cedriver instance, and assigns it to the  
parameter:  
# ndd -set /dev/ce parameter value  
When you change any adv parameter, a message similar to the following appears:  
xcvr addr:0x00 - link up 1000 Mbps half duplex  
To display the value of a parameter, specify the parameter name and omit the  
value.  
When you omit the -setoption, a query operation is assumed and the utility  
queries the named driver instance, retrieves the value associated with the specified  
parameter, and prints it:  
# ndd /dev/ce parameter  
Using the nddUtility in Interactive Mode  
To modify a parameter value in interactive mode, specify ndd /dev/ce, as shown  
below.  
The nddutility then prompts you for the name of the parameter:  
# ndd /dev/ce  
name to get/set? (Enter the parameter name or ? to view all  
parameters)  
After typing the parameter name, the nddutility prompts you for the parameter  
value (see TABLE 4-1 through TABLE 4-11).  
Chapter 4  
Configuring Driver Parameters  
35  
Download from Www.Somanuals.com. All Manuals Search And Download.  
To list all the parameters supported by the cedriver, type ndd /dev/ce.  
(See TABLE 4-1 through TABLE 4-11 for parameter descriptions.)  
# ndd /dev/ce  
name to get/set ? ?  
?
(read only)  
instance  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
(read and write)  
adv_autoneg_cap  
adv_1000fdx_cap  
adv_1000hdx_cap  
adv_100T4_cap  
adv_100fdx_cap  
adv_100hdx_cap  
adv_10fdx_cap  
adv_10hdx_cap  
adv_asmpause_cap  
adv_pause_cap  
link_master  
use_int_xcvr  
enable_ipg0  
ipg0  
ipg1  
ipg2  
rx_intr_pkts  
rx_intr_time  
red_dv4to6k  
red_dv6to8k  
red_dv8to10k  
red_dv10to12k  
tx_dma_weight  
rx_dma_weight  
infinite_burst  
disable_64bit  
name to get/set ?  
#
Setting the Autonegotiation Mode  
By default, autonegotiation is set to on. This means that the adapter communicates  
with its link partner to determine a compatible network speed, duplex mode, and  
flow control capability.  
36  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
To Disable Autonegotiation Mode  
If your network equipment does not support autonegotiation, or if you want to  
specify your network speed, you can set autonegotiation to offon the cedevice.  
1. Set the following driver parameters to the values that are described in the  
documentation that shipped with your link partner (for example, a switch):  
adv_1000fdx_cap  
adv_1000hdx_cap  
adv_100fdx_cap  
adv_100hdx_cap  
adv_10fdx_cap  
adv_10hdx_cap  
adv_asmpause_cap  
adv_pause_cap  
See TABLE 4-2 for the descriptions and possible values of these parameters.  
2. Set the adv_autoneg_capparameter to 0.  
# ndd -set /dev/ce adv_autoneg_cap 0  
When you change any nddlink parameter, a message similar to the following  
appears:  
xcvr addr:0x00 - link up 1000 Mbps half duplex  
Setting Parameters Using the ce.confFile  
You can also specify the driver parameter properties on a per-device basis by  
creating a ce.conffile in the /kernel/drvdirectory. Use a ce.conffile when  
you need to set a particular parameter for a device in the system. The parameters  
you set are read and write parameters that are listed in “Driver Parameter Values  
and Definitions” on page 26.  
The man pages for prtconf(1M) and driver.conf(4) include additional details.  
The next procedure shows an example of setting parameters in a ce.conffile.  
Chapter 4  
Configuring Driver Parameters  
37  
Download from Www.Somanuals.com. All Manuals Search And Download.  
To Set Driver Parameters Using a ce.confFile  
1. Obtain the hardware path names for the cedevices in the device tree.  
Typically, the path names and the associated instance numbers are in the  
/etc/path_to_instfile.  
# grep ce /etc/path_to_inst  
"/pci108e;abba;/pci@4,4000/network@0" 2 "ce"  
"/pci108e;abba;/pci@6,2000/network@0" 1 "ce"  
"/pci108e;abba;/pci@4,2000/network@0" 0 "ce"  
In the previous example:  
The first part within the double quotes specifies the hardware node name in  
the device tree.  
The second number is the instance number (shown in bold italics).  
The last part in double quotes is the driver name.  
In the device path name, the last component after the last /character and before  
the @character is the device name.  
The path name before the last component is the parent name.  
The comma separated numbers after the @character at the end represent the  
device and function numbers, which are together referred to as unit-address.  
To identify a PCI device unambiguously in the ce.conffile, use the name, parent  
name, and the unit-address for the device. Refer to the pci(4) man page for more  
information about the PCI device specification.  
In the first line of the previous example:  
Name = pci108e,abba  
Parent name = /pci@4,4000  
Unit-address = 4  
In the second line in the previous example:  
Name = pci108e,abba  
Parent name = /pci@6,2000  
Unit-address = 4  
In the third line in the previous example:  
Name = pci108e,abba  
Parent name = /pci@4,2000  
Unit-address = 4  
2. Set the parameters for the above devices in the /kernel/drv/ce.conffile.  
38  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
In the following example, the adv_autoneg_capand adv_1000fdx_cap  
parameters are set for all Sun GigaSwift Ethernet devices. (See the  
driver.conf(4)man page for more information.)  
adv_autoneg_cap=0 adv_1000fdx_cap=0  
In the following example, the adv_autoneg_capand adv_1000fdx_cap  
parameters are set for a single instance of the Sun GigaSwift Ethernet device.  
name=pci108e,abba parent=pci@4,4000 unit address+4 adv_autoneg_cap=0  
adv_1000fdx_cap=0;  
3. Save the ce.conffile.  
4. Save and close all files and programs, and exit the windowing system.  
5. Shut down and reboot the system.  
GigaSwift Ethernet Driver Operating  
Statistics  
These statistics are part of the statistics presented by the netstat -kcommand.  
TABLE 4-10 describes the read-only Media Independent Interface (MII) capabilities.  
These parameters define the capabilities of the hardware. The Gigabit Media  
Independent Interface (GMII) supports all of the following capabilities.  
TABLE 4-10 Read-Only ceDevice Capabilities  
Parameter  
Description (Local interface Capabilities)  
cap_autoneg  
0 = Not capable of autonegotiation  
1 = Autonegotiation capable  
cap_1000fdx  
cap_1000hdx  
Local interface full-duplex capability  
0 = Not 1000 Mbit/ sec full-duplex capable  
1 = 1000 Mbit/ sec full-duplex capable  
Local interface half-duplex capability  
0 = Not 1000 Mbit/ sec half-duplex capable  
1 = 1000 Mbit/ sec half-duplex capable  
Chapter 4  
Configuring Driver Parameters  
39  
Download from Www.Somanuals.com. All Manuals Search And Download.  
TABLE 4-10 Read-Only ceDevice Capabilities (Continued)  
Parameter  
Description (Local interface Capabilities)  
cap_100fdx  
Local interface full-duplex capability  
0 = Not 100 Mbit/ sec full-duplex capable  
1 = 100 Mbit/ sec full-duplex capable  
cap_100hdx  
cap_10fdx  
Local interface half-duplex capability  
0 = Not 100 Mbit/ sec half-duplex capable  
1 = 100 Mbit/ sec half-duplex capable  
Local interface full-duplex capability  
0 = Not 10 Mbit/ sec full-duplex capable  
1 = 10 Mbit/ sec full-duplex capable  
cap_10hdx  
Local interface half-duplex capability  
0 = Not 10 Mbit/ sec half-duplex capable  
1 = 10 Mbit/ sec half-duplex capable  
cap_asm_pause  
cap_pause  
Local interface flow control capability  
0 = Not asymmetric pause capable  
1 = Asymmetric pause (from the local device) capable  
Local interface flow control capability  
0 = Not Symmetric pause capable  
1 = Symmetric pause capable  
Reporting the Link Partner Capabilities  
TABLE 4-11 describes the read-only link partner capabilities.  
TABLE 4-11 Read-Only Link Partner Capabilities  
Parameter  
Description  
lp_cap_autoneg  
0 = No autonegotiation  
1 = Autonegotiation  
lp_cap_1000fdx  
lp_cap_1000hdx  
lp_cap_100fdx  
lp_cap_100hdx  
lp_cap_10fdx  
0 = No 1000 Mbit/ sec full-duplex transmission  
1 = 1000 Mbit/ sec full-duplex  
0 = No 1000 Mbit/ sec half-duplex transmission  
1 = 1000 Mbit/ sec half-duplex  
0 = No 100 Mbit/ sec full-duplex transmission  
1 = 100 Mbit/ sec full-duplex  
0 = No 100 Mbit/ sec half-duplex transmission  
1 = 1000 Mbit/ sec half-duplex  
0 = No 10 Mbit/ sec full-duplex transmission  
1 = 10 Mbit/ sec full-duplex  
40  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
TABLE 4-11 Read-Only Link Partner Capabilities (Continued)  
Parameter  
Description  
lp_cap_10hdx  
0 = No 10 Mbit/ sec half-duplex transmission  
1 = 10 Mbit/ sec half-duplex  
lp_cap_asm_pause  
lp_cap_pause  
0 = Not asymmetric pause capable  
1 = Asymmetric pause towards link partner capability  
0 = Not symmetric pause capable  
1 = Symmetric pause capable  
If the link partner is not capable of autonegotiation (when lp_autoneg_capis 0),  
the remaining information described in TABLE 4-11 is not relevant and the parameter  
value = 0.  
If the link partner is capable of autonegotiation (when lp_autoneg_capis 1), then  
the speed and mode information is displayed when you use autonegotiation and the  
link partner capabilities.  
TABLE 4-12 describes the netstat -k transmit and receive parameters:  
TABLE 4-12 Transmit and Receive Parameters  
Parameter  
Description  
Number of Physical layer re-initializations every time you change  
link parameters using NDD this increments.  
xcvr_inits  
rev_id  
Revision ID of the GigaSwift Ethernet device useful for recognition  
of device being used in the field.  
xcvr_addr  
xcvr_id  
GMII/ MII Physical layer device address for management interface.  
GMII/ MII Physical layer device Identification Decimal copy of MII  
registers 2 and 3.  
lb_mode  
Copy of the Loopback mode the device is in, if any.  
qos_mode  
When zero, the TX queues operate in a simple round robin  
queueing scheme, based on TCP/ UDP destination port number. If  
set the TX queues operate in a scheme designed to provide VLAN  
priorities.  
tx_starts  
Number of times that the driver attempted to transmit a packet.  
tx_dma_bind_fail Number of times a page table entry was not available to allow the  
driver to map the kernel memory to device accessible memory for  
transmission.  
tx_queue0  
Number of packets queued for transmission on the first hardware  
transmit queue.  
Chapter 4  
Configuring Driver Parameters  
41  
Download from Www.Somanuals.com. All Manuals Search And Download.  
TABLE 4-12 Transmit and Receive Parameters  
Parameter  
Description  
tx_queue1  
Number of packets queued for transmission on the second  
hardware transmit queue.  
tx_queue2  
tx_queue3  
Number of packets queued for Transmission on the third hardware  
transmit queue.  
Number of packets queued for Transmission on the fourth  
hardware transmit queue.  
tx_max_pend  
rx_hdr_pkts  
rx_mtu_pkts  
Maximum number of transmits pending on any of the four queues.  
Number of packets received that were less than 256 bytes.  
Number of packets received that were greater than 256 bytes and  
less than 1514 bytes.  
rx_split_pkts  
rx_no_comp_wb  
Number of packets that were split across two pages.  
Number of times the hardware cannot post completion entries for  
received data.  
rx_no_buf  
Number of times the hardware cannot receive data because there is  
no more receive buffer space.  
rx_new_pages  
Number of pages that got replaced during reception.  
rx_new_hdr_pgs  
Number of pages that were filled with packets less than 256 bytes  
that got replaced during reception.  
rx_new_mtu_pgs  
rx_new_nxt_pgs  
rx_hdr_drops  
Number of pages that were filled with packets greater than 256  
bytes and less than 1514 that got replaced during reception.  
Number of pages that contained packets that were split across  
pages that got replaced during reception.  
Number of times a whole page of packets less than 256 bytes was  
dropped because the driver was unable to map a new one to replace  
it.  
rx_mtu_drops  
Number of times a whole page of packets greater than 256 bytes  
and less than 1514 was dropped because the driver was unable to  
map a new one to replace it.  
rx_nxt_drops  
rx_rel_flow  
Number of times a page with a split packet was dropped because  
the driver was unable to map a new one to replace it.  
Number of times the driver was told to release a flow.  
42  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
To Check Link Partner Settings  
As superuser, type the netstat -kcommand:  
# netstat -k ce0  
ce0:  
ipackets 0 ipackets64 0 ierrors 0 opackets 0 opackets64 0  
oerrors 0 collisions 0 rbytes 0 rbytes64 0 obytes 0 obytes64 0  
multircv 0 multixmt 0 brdcstrcv 0 brdcstxmt 0 norcvbuf 0  
noxmtbuf 0 first_collision 0 excessive_collisions 0 late_collisions 0  
peak_attempts 0 length_err 0 alignment_err 0 crc_err 0 code_violations 0  
ifspeed 0 rev_id 1 xcvr_inits 1 xcvr_inuse 3 xcvr_addr 0  
xcvr_id 0 cap_autoneg 1 cap_1000fdx 1 cap_1000hdx 0 cap_100T4 0  
cap_100fdx 0 cap_100hdx 0 cap_10fdx 0 cap_10hdx 0 cap_asmpause 0  
cap_pause 1 lp_cap_autoneg 0 lp_cap_1000fdx 0 lp_cap_1000hdx 0  
lp_cap_100T4 0 lp_cap_100fdx 0 lp_cap_100hdx 0 lp_cap_10fdx 0  
lp_cap_10hdx 0 lp_cap_asmpause 0 lp_cap_pause 0 link_T4 0  
link_speed 0 link_duplex 0 link_asmpause 0 link_pause 0  
link_up 0 lb_mode 0 qos_mode 0 tx_inits 0 tx_starts 0 tx_nocanput 0  
tx_msgdup_fail 0 tx_allocb_fail 0 tx_no_desc 0 tx_dma_bind_fail 0  
tx_uflo 0 tx_queue0 0 tx_queue1 0 tx_queue2 0 tx_queue3 0  
tx_max_pend 0 rx_inits 0 rx_hdr_pkts 0 rx_mtu_pkts 0 rx_split_pkts 0  
rx_no_buf 0 rx_no_comp_wb 0 rx_ov_flow 0 rx_len_mm 0 rx_bad_descs 0  
rx_nocanput 0 rx_msgdup_fail 0 rx_allocb_fail 0 rx_new_pages 0  
rx_new_hdr_pgs 0 rx_new_mtu_pgs 0 rx_new_nxt_pgs 0 rx_hdr_drops 0  
rx_mtu_drops 0 rx_nxt_drops 0 rx_rel_flow 0 rx_pkts_dropped 0  
pci_err 0 pci_rta_err 0 pci_rma_err 0 pci_parity_err 0 pci_bad_ack_err 0  
pci_drto_err 0 ipackets_cpu00 0 ipackets_cpu01 0 ipackets_cpu02 0  
ipackets_cpu03 0  
Chapter 4  
Configuring Driver Parameters  
43  
Download from Www.Somanuals.com. All Manuals Search And Download.  
44  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER  
5
Configuring VLANs  
This chapter explains VLANs in detail and provides configuration instructions and  
examples.  
VLANs: Virtual Local Area Networks (VLANs) are commonly used to split up  
groups of network users into manageable broadcast domains, to create logical  
segmentation of workgroups, and to enforce security policies among each logical  
segment. With multiple VLANs on an adapter, a server with a single adapter can  
have a logical presence on multiple IP subnets. By default, 512 VLANs can be  
defined for each VLAN-aware adapter on your server. However, this number can  
be increased by changing the system parameters. VLANs are currently supported  
for gigabit mode only.  
If your network does not require multiple VLANs, you can use the default  
configuration, in which case no further configuration is necessary.  
Note – If you did not install the VLAN packages when you installed the driver, you  
must unconfiguration all ce networking interfaces and unload the driver before you  
can configure VLAN.  
An Overview of VLANs  
VLANs allow 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.  
45  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Although VLANs are commonly used to create individual broadcast domains and/  
or separate IP subnets, it is sometimes useful for a server to have a presence on more  
than one VLAN simultaneously. Several Sun products support multiple VLANs on a  
per port or per interface basis, allowing very flexible network configurations.  
FIGURE 5-1 shows an example network that uses VLANs  
.
VLAN 1  
VLAN 2  
VLAN 3  
Main Server  
Adapter  
Gigabit/Tagged  
(All VLANs)  
Accounting  
Server  
(VLAN 3)  
1
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
9
10/100 Base  
-
TX  
Gigabit Ethernet  
Shared Media Segment  
Software  
PC 1  
(VLAN 2)  
Software  
PC 2  
(VLAN 2)  
Engineering  
PC 3  
(VLAN 1)  
Accounting  
PC 4  
(VLAN 3)  
Engineering/  
Software PC 5  
Adapter  
Gigabit/Tagged  
(VLAN 1 & 2)  
FIGURE 5-1 Example of Servers Supporting Multiple VLANs with Tagging Adapters  
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  
represents an engineering group.  
VLAN 2 includes the Main Server, Clients 1 and 2 via shared media segment, and  
Client 5. This is a software development group.  
VLAN 3 includes the Main Server, the Accounting Server and Client 4. This is an  
accounting group.  
46  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
The Main Server is a high-use server that needs to be accessed from all VLANs  
and IP subnets. The server has an Sun GigabitEthernet adapter installed. All three  
IP subnets are accessed via the single physical adapter interface. The server is  
attached to one of the SunSwitchs Gigabit Ethernet ports, which is configured for  
VLANs 1, 2, and 3. Both the adapter and the connected SunSwitch port have  
tagging turned on. Because of the tagging VLAN capabilities of both devices, the  
sever is able to communicate on all three IP subnets in this network, but continues  
to maintain broadcast separation between all of them.  
The Accounting Server is available to VLAN 3 only. It 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. They belong to VLAN 2 only, and 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, and can communicate only with the Main Server  
and Client 5. Tagging is not enabled on Client 3s switch port.  
Client 4 is a member of VLAN 3, and can communicate only with the servers.  
Tagging is not enabled on Client 4s switch port.  
Client 5 is a member of both VLANs 1 and 2, and has a Sun GigabitEthernet  
adapter installed. It is connected to switch port 10. Both the adapter and the  
switch port are configured for VLANs 1 and 2 and have tagging enabled.  
VLAN tagging is only required to be enabled on switch ports that create trunk links  
to other VLAN-aware Ethernet switches, or on ports connected to tag-capable end-  
stations, such as servers or workstations with VLAN-aware adapters.  
Configuring VLANs  
VLANs can be created 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 (ce0, ce1, ce2  
and so on), 512 possible VLANs can be created. Because IP subnets are commonly  
used, its best to use IP subnets when setting up a VLAN network interface. This  
means that each VID assigned to a VLAN interface of a physical network interface  
will belong to different subnets.  
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 Tag Control Information (TCI). FIGURE 5-2  
shows the Ethernet Tag Header format.  
Chapter 5  
Configuring VLANs  
47  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Octet  
1
TPID (0x8100  
2
3
3 bits  
1
12 bytes  
bit  
4
User_priority  
VID  
CFI  
FIGURE 5-2 Ethernet Tag Header Format  
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, VLAN tagging for  
the switch port turned off.  
To Configure Static VLANs  
1. Create one hostname6.cenum file for each VLAN which will be configured for each  
adapter on the server, using the following naming format that includes both the  
VID and the physical point of attachment (PPA):  
VLAN logical PPA = <1000 * VID> + <Device PPA>  
ce123000 = 1000*123 + ce  
This format limits the maximum number of PPAs (instances) you can configure to  
1000 in the /etc/path_to_instfile.  
For example, on a server with the Sun GigabitEthernet/ P 3.0 adapter having an  
instance of 0, that belongs to a member of two VLANs, with VID 123 and 224, you  
would use ce123000and ce224000, respectively, as the two VLAN PPAs.  
48  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
2. Use the ifconfig(1M)to configure a VLAN virtual device, for example:  
# ifconfig ce123000 plumb up  
# ifconfig ce224000 plumb up  
The output of ifconfig -aon a system having VLAN devices ce123000and  
ce224000:  
# ifconfig -a  
lo0: flags=1000849<UP,LOOPBACK,RUNNING,MULTICAST,IPv4> mtu 8232 index 1  
inet 127.0.0.1 netmask ff000000  
hme0: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 2  
inet 129.144.131.91 netmask ffffff00 broadcast 129.144.131.255  
ether 8:0:20:a4:4f:b8  
ce123000: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 3  
inet 199.199.123.3 netmask ffffff00 broadcast 199.199.123.255  
ether 8:0:20:a4:4f:b8  
ce124000: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 4  
inet 199.199.124.3 netmask ffffff00 broadcast 199.199.124.255  
ether 8:0:20:a4:4f:b8  
3. On the switch, set VLAN tagging and set VLAN ports to coincide with the VLANs  
youve set up on the server. Using the examples in Step 2, you would set up VLAN  
ports 123 and 224 on the switch.  
Refer to the documentation that came with your switch for specific instructions for  
setting VLAN tagging and ports.  
Chapter 5  
Configuring VLANs  
49  
Download from Www.Somanuals.com. All Manuals Search And Download.  
50  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
APPENDIX  
A
Specifications  
This appendix lists the specifications for the Sun GigaSwift Ethernet adapter. It  
contains the following sections:  
“Connectors” on page 51  
“Performance Specifications” on page 52  
“Physical Characteristics” on page 52  
“Power Requirements” on page 52  
Connectors  
FIGURE A-1 shows the connector for the Sun GigaSwift Ethernet UTP adapter.  
FIGURE A-1 Sun GigaSwift Ethernet UTP Adapter Connector  
Table A-2 lists the characteristics of the Cat-5 Connector used by the Sun GigaSwift  
Ethernet UTP adapter.  
TABLE A-1 Cat-5 Connector Link Characteristics  
Description  
Operating range  
Up 100 meters  
51  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Performance Specifications  
TABLE A-2 Performance Specifications  
Feature  
Specification  
PCI clock  
33/ 66 MHz max  
up to 64-byte bursts  
32/ 64 -bit  
PCI data burst transfer rate  
PCI data/ address width  
PCI modes  
Master/ slave  
1 GBit/ s, 850 nm  
1000 Mbps (full duplex)  
Physical Characteristics  
TABLE A-3 Physical Characteristics  
Dimension  
Length  
Width  
Measurement  
6.8 inches  
4.2 inches  
Power Requirements  
TABLE A-4 Power Requirements  
Specification  
Measurement  
Maximum power consumption  
Voltage  
14 watts  
3.3V and 5V  
52  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
APPENDIX  
B
Diagnostic Software and  
Troubleshooting Issues  
This appendix provides an overview of the SunVTS diagnostic application and  
instructions for testing the adapter using the onboard FCode self-test. There is also a  
section outlining some common troubleshooting issues. This appendix contains the  
following sections:  
“SunVTS Diagnostic Software” on page 53  
“Using the OpenBoot PROM FCode Self-Test” on page 54  
Troubleshooting Issues” on page 56  
SunVTS Diagnostic Software  
The SunVTS software executes multiple diagnostic hardware tests from a single user  
interface and is used to verify the configuration and functionality of most hardware  
controllers and devices. The SunVTS software operates primarily from a graphical  
user interface, enabling test parameters to be set quickly and easily while a  
diagnostic test operation is being performed.  
The nettestdiagnostic checks all the networking interfaces on a system, including  
the Sun GigaSwift Ethernet adapter. Refer to the SunVTS Users Guide for more  
information on how to run the nettestdiagnostic test.  
Note – To use the nettestdiagnostic, you must have the SunVTS software  
installed on your system. Refer to the Solaris Sun Hardware Platform Guide, which was  
shipped with the Solaris Supplement CD, for instructions on how to install the  
SunVTS software.  
53  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Using the OpenBoot PROM FCode Self-  
Test  
The following tests are available to help identify problems with the adapter if the  
system does not boot.  
You can invoke the FCode self-test diagnostics by using the OpenBoot user interface  
testor test-allcommands. If you encounter an error while running diagnostics,  
appropriate messages will be displayed. Refer to the appropriate OpenBoot Command  
Reference Manual for more information on the testand test-allcommands.  
The FCode self-test exercises most functionality sub-section by sub-section and  
ensures the following:  
Connectivity during adapter card installation  
Verification that all components required for a system boot are functional  
Running the Ethernet FCode Self-Test Diagnostic  
To run the Ethernet diagnostics, you must first bring the system to a stop at the  
OpenBoot prompt after issuing a reset. If you do not reset the system, the diagnostic  
tests might cause the system to hang.  
For more information about the OpenBoot commands in this section, refer to the  
appropriate OpenBoot Command Reference Manual.  
1. Shut down the system.  
Use the standard shutdown procedures described in the Solaris Handbook for Sun  
Peripherals.  
2. At the okprompt, set the auto-boot?configuration variable to false.  
ok setenv auto-boot? false  
3. Reset the system.  
ok reset-all  
54  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
4. Type show-netsto display the list of devices.  
You should see a list of devices, similar to the example below, specific to the adapter:  
ok show-nets  
a) /pci@1f,0/pci@1/network@4  
b) /pci@1f,0/pci@1,1/network@1,1  
q) NO SELECTION  
Enter Selection, q to quit:  
5. Type the following to run the self-test using the testcommand:  
ok test device path  
The following tests are run when the testcommand is executed:  
ceregister test  
serdes internal loopback test  
link up/ down test  
If the testpasses, you see these messages:  
ok test /pci@1f,0/pci@1/network@4  
ce register test --- succeeded.  
Internal loopback test -- succeeded.  
Link is -- up  
If the card is not connected to a network, you see the following messages:  
ok test /pci@1f,0/pci@1/network@4  
ce register test --- succeeded.  
Internal loopback test -- succeeded.  
Link is -- down  
ok  
6. For more robust test results, set the diag-switch?to trueand reissue the tests  
as shown in Step 5 above.  
ok setenv diag-switch? true  
Appendix B  
Diagnostic Software and Troubleshooting Issues  
55  
Download from Www.Somanuals.com. All Manuals Search And Download.  
7. After testing the adapter, type the following to return the OpenBoot PROM to  
standard operating mode:  
ok setenv diag-switch? false  
8. Set the auto-boot?configuration parameter to true.  
ok setenv auto-boot? true  
9. Reset and reboot the system.  
Refer to the appropriate OpenBoot Command Reference Manual for more information.  
Troubleshooting Issues  
Known Incompatibilities with Pre-IEEE 802.3z  
Network Switches  
You might experience interoperability issues when using the Sun GigaSwift Ethernet  
adapter with the SunSwitch switch, the Alteon ACE 110 switch, or other pre- or non-  
IEEE 802.3z standard compliant network equipment. If you experience difficulties  
with noncompliant equipment, set the adapter and switch autonegotiation  
properties to offand try to configure the interface manually.  
To Set Autonegotiation to offfor a SunSwitch  
or an Alteon ACE 110 Switch  
You can set autonegotiation to offfor SunSwitch and Alteon ACE 110 switches  
using those switches’ configuration program (cgf). Refer to your switch  
documentation for instructions on how to access and use the cgfprogram.  
The following procedure describes how to turn autonegotiation off for one  
SunSwitch port.  
56  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
1. Establish a connection to the switch using either a serial connection or a Telnet  
connection.  
Refer to the SunSwitch 1.1 Installation and Configuration Guide (805-3743-10) for more  
information. After connecting to the switch, the Main menu prompt (Main#) is  
displayed.  
2. At the Main#prompt, type cfgto display the Configuration menu and prompt  
(Configuration#).  
>> Main# cfg  
[Configuration Menu]  
sys - System-wide parameter menu  
port - Port configuration menu  
ip  
- IP addressing menu  
vlan - VLAN configuration menu  
stp - Spanning Tree menu  
snmp - SNMP menu  
setup - Step by step configuration set up  
dump - Dump current configuration to script file  
>> Configuration#  
3. Type the following to disable autonegotiation on a GigaSwift Ethernet port.  
Replace portnumber with the Ethernet port used by the adapter.  
>> Configuration# /port portnumber/auto off  
4. Type the following to apply and save your changes.  
>> Configuration# apply  
>> Configuration# save  
Refer to the switch documentation for further configuration instructions.  
To Set Autonegotiation to offfor Other  
Noncompliant Network Equipment  
If your network equipment does not support autonegotiation, you can set  
autonegotiation to offon the GigaSwift Ethernet (ce) device.  
Appendix B  
Diagnostic Software and Troubleshooting Issues  
57  
Download from Www.Somanuals.com. All Manuals Search And Download.  
1. Set the following GigaSwift Ethernet driver parameters to values according to the  
documentation that shipped with your switch:  
adv_1000fdx_cap  
adv_1000hdx_cap  
adv_pauseTX  
adv_pauseRX.  
2. Set the adv_autoneg_capparameter to 0.  
Note – See Chapter 4 for the default values of these parameters and for instructions  
on how to set these parameters.  
58  
Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Index  
SYMBOLS  
E
.properties command, 11  
editing the network host files, 17  
.properties file, 11  
/ etc/ hostname.cenumber file, 18  
F
FCode selftest diagnostics, 54  
files and directories on the CD-ROM, 6  
flow control keywords, 28  
A
assigning an IP address, 18  
autonegotiation  
setting  
disabling, 36  
H
hardware and software requirements, 3  
C
CAT-5 twisted-pair cable, 9  
I
ce driver parameter, status, and descriptions, 26  
configuring device driver parameters, 25  
configuring the driver parameters, 25  
configuring the network host files, 17  
configuring VLANs, 47  
ifconfig -a, 49  
ifconfig command, 18  
installing driver software, 5  
installing the adapter with DR, 14  
installing the adapter without DR, 8  
installing the Solaris operating environment over  
the network, 21  
D
device properties, 11  
diagnostic support, 4  
diskless clients, 19  
L
link partner, 25  
Dynamic Reconfiguration, 8  
dynamic reconfiguration, 5  
Dynamic Reconfiguration (DR), 14  
link partner settings  
checking, 43  
Index  
59  
Download from Www.Somanuals.com. All Manuals Search And Download.  
local-mac-address property, 11, 12  
V
verify the installation, 9  
virtual device, 49  
VLAN ID, 47  
M
VLAN naming format, 48  
VLANs, 45  
MAC address, 12  
mac-address property  
to set, 12  
Media Access Control (MAC), 12  
N
ndd utility, 34  
nettest diagnostic, 53  
NVRAM configuration, 12  
O
operational mode parameters, 27  
P
parameter values  
how to modify and display, 34  
parameters and settings, 26  
R
random early detection register, 31  
receive interrupt blanking values, 26, 31  
S
setting ce driver parameters  
using ndd  
using ce.conf, 33  
standard Ethernet frame sizes, 3  
standards and protocols, 3  
SunVTS diagnostic application, 53  
60 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • February 2001  
Download from Www.Somanuals.com. All Manuals Search And Download.  

Sentry Industries Thermometer Sentry 20 User Manual
Sharp All in One Printer MX M182 User Manual
SMSC Home Theater Server COM20020 User Manual
Sony Automobile Battery Charger XA DC1 User Manual
Sony Cassette Player XR F5100EE User Manual
Sony Microphone UWP C1 UWP C2 UWP C3 User Manual
Sony Network Card MRWFC1 User Manual
Sony Portable CD Player NW S202 User Manual
Sony Video Eyeware TMR BR100 User Manual
StreamLight Stereo System MS2015 User Manual