Sun Microsystems Network Card SunFastEthernet Adapte User Manual

SunFastEthernet Adapter User Guide  
Sun Microsystems Computer Corporation  
2550 Garcia Avenue  
Mountain View, CA 94043  
U.S.A.  
Part No.: 801-6109-11  
Revision A, November 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Contents  
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  
xi  
1. Introducing the SunFastEthernet Adapter Card . . . . . . . . . . . 1-1  
2. Installing the SunFastEthernet SBus Card . . . . . . . . . . . . . . . . 2-1  
2.1 Card Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1  
2.2 Testing the SunFastEthernet Adapter Card Before Booting the  
System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2  
2.3 Booting From SunFastEthernet Devices . . . . . . . . . . . . . . 2-6  
2.4 Relocating a SunFastEthernet Card (Solaris 2.x Only). . . 2-7  
3. Installing SunFastEthernet Software Using Solaris 1.x . . . . . 3-1  
3.1 Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2  
3.2 Preparing for Software Installation . . . . . . . . . . . . . . . . . . 3-2  
3.3 Installing from CD-ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3  
3.3.1 Access to Remote CD-ROM . . . . . . . . . . . . . . . . . . . 3-3  
3.3.2 Using cdm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3  
3.3.3 Mounting the CD-ROM . . . . . . . . . . . . . . . . . . . . . . . 3-4  
3.3.4 Install Script Using cdm . . . . . . . . . . . . . . . . . . . . . . . 3-4  
iii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3.3.5 SunFastEthernet Directories . . . . . . . . . . . . . . . . . . . 3-15  
3.3.6 Installation Verification . . . . . . . . . . . . . . . . . . . . . . . 3-15  
3.4 Setting Up Diskless Clients . . . . . . . . . . . . . . . . . . . . . . . . . 3-16  
3.4.1 Setting Up to Write to the Servers / usr Partition . 3-16  
3.4.2 Building a New Kernel. . . . . . . . . . . . . . . . . . . . . . . . 3-16  
4. Installing SunFastEthernet Software Using Solaris 2.x . . . . . 4-1  
4.1 Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1  
4.2 Solaris 2.3 Hardware: 5/ 94 Software Requirements . . . . 4-2  
4.2.1 Mandatory Patch Requirements . . . . . . . . . . . . . . . . 4-2  
4.2.2 Disk Capacity Considerations . . . . . . . . . . . . . . . . . . 4-2  
4.2.3 Adding SUNWbmac Using pkgadd Command . . . 4-3  
4.2.4 Host File Configuration . . . . . . . . . . . . . . . . . . . . . . . 4-4  
4.3 Solaris 2.3 Hardware: 8/ 94 Software Requirements . . . . 4-5  
4.3.1 Net-Install Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6  
4.3.2 Diskless Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7  
4.4 Solaris 2.4 Hardware: 11/ 94 Software Requirements. . . . 4-8  
5. Network Linkups/Speed Selection . . . . . . . . . . . . . . . . . . . . . . 5-1  
5.1 Network Link Ups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1  
5.1.1 10/ 100Mbps Link Up Using RJ45 Connector . . . . . 5-1  
5.1.2 10/ 100Mbps Link Up Using MII interface Connector 5-2  
5.1.3 Link Integrity Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2  
5.2 Speed Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3  
A. Interface Signals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1  
B. SunFastEthernet Adapter Card Specifications . . . . . . . . . . . . . B-1  
iv  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
B.1 Performance Specifications . . . . . . . . . . . . . . . . . . . . . . . . . B-1  
B.2 Power Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2  
B.3 Physical Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2  
B.4 Environmental Specifications . . . . . . . . . . . . . . . . . . . . . . . B-3  
C. Running Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1  
C.1 Selftest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1  
C.1.1 Selftest Description . . . . . . . . . . . . . . . . . . . . . . . . . . . C-4  
C.1.2 Debug using Selftest . . . . . . . . . . . . . . . . . . . . . . . . . . C-6  
C.2 Sundiag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-6  
C.2.1 Editing .usertest File . . . . . . . . . . . . . . . . . . . . . . . . . . C-6  
C.2.2 The Sundiag Window . . . . . . . . . . . . . . . . . . . . . . . . . C-7  
C.2.3 Starting the Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-8  
D. Solaris 2.x Driver Performance Tuning . . . . . . . . . . . . . . . . . . . D-1  
E. Console Messages (Solaris 1.x Only) . . . . . . . . . . . . . . . . . . . . E-1  
Contents  
v
Download from Www.Somanuals.com. All Manuals Search And Download.  
vi  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Figures  
Figure 1-1  
Figure 1-2  
Figure 2-1  
Figure C-1  
SunFastEhernet Adapter Card Components. . . . . . . . . . . . . . .  
SunFastEthernet Block Diagram . . . . . . . . . . . . . . . . . . . . . . . . .  
Handling the SunFastEthernet Adapter Card . . . . . . . . . . . . . .  
Sundiag Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  
1-3  
1-4  
2-1  
C-8  
vii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
viii  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Tables  
Table 1-1  
Table 3-1  
Table 3-2  
Table 4-1  
Table 4-2  
Table 4-3  
Table A-1  
Table A-2  
Organization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  
Solaris 1.x Platform Architecture with Systems . . . . . . . . . . . .  
1-1  
3-2  
/ export/ exec/ sun4/ BQE Subdirectories . . . . . . . . . . . . . . . . . 3-15  
Solaris 2.x Platform Archtecture with Systems Supported . . .  
Solaris 2.3 Hardware: 5/ 94 CD . . . . . . . . . . . . . . . . . . . . . . . . . .  
Solaris 2.3 Hardware: 8/ 94 CD . . . . . . . . . . . . . . . . . . . . . . . . . .  
4-2  
4-3  
4-6  
SBus Interface Signals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1  
SunFastEthernet Adapter Media Independent Interface Signals  
(Ultra DB40) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3  
Table B-1  
Table B-2  
Table B-3  
Table B-4  
Table D-1  
Performance Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  
Power Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  
Overall Physical Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . .  
Environmental Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . .  
B-1  
B-2  
B-2  
B-3  
Buffer Default Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1  
ix  
Download from Www.Somanuals.com. All Manuals Search And Download.  
x
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Preface  
This manual provides information about the SunFastEthernet Adapter card.  
Document Organization  
The information in this manual is presented in six chapters and four  
appendixes. Manual arrangement is as follows:  
Chapter 1: “Introducing the SunFastEthernet Adapter Card” describes the  
features of the SunFastEthernet Adapter card and provides hardware  
requirements.  
Chapter 2: “Installing the SunFastEthernet SBus Card” provides card  
installation, testing and relocation procedures.  
Chapter 3: “Installing SunFastEthernet Software using Solaris 1.x”  
provides instructions for software installation via CD-ROM using CDmanager  
or cdm program, instructions on bringing up the interface using loadable  
drivers as well as instructions on building a new kernel for diskless clients.  
Chapter 4: “Installing SunFastEthernet Software using Solaris 2.x”  
provides instructions on installing software using pkgadd command. Includes  
net-install and diskless client procedures.  
Chapter 5: “Network Linkups/Speed Selection” applicable to Solaris 1.x and  
2.x software versions. Provides network linkup and speed selection  
procedures.  
xi  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Appendix A: “Interface Signals” provides pinout data.  
Appendix B: “SunFastEthernet Adapter Card Specifications” provides  
information on performance and power specifications, physical dimensions,  
and environmental specifications.  
Appendix C: “Running Diagnostics” explains how to run diagnostic tests that  
verify the SunFastEthernet Adapter card is working correctly in the system.  
Appendix D: “Solaris 2.x Driver Performance Tuning” explains how to tune  
the SunFastEthernet Adapter card for performance.  
Appendix E: “Console Messages (Solaris 1.x Only)” provides a listing of  
Solaris 1.x console message together with explanation and/ or workarounds.  
When You Need Help with UNIX Commands  
This manual may not include specific software commands or procedures.  
Instead, it names software tasks and refers you to operating system  
documentation or the handbook that was shipped with your new hardware.  
The type of information that you might need to use references for includes:  
Shutting down the system  
Booting the system  
Configuring devices  
Other basic software procedures  
See one or more of the following:  
Solaris 2.x Handbook for SMCC Peripherals contains Solaris 2.x software  
commands.  
On-line AnswerBook® for the complete set of documentation supporting the  
Solaris 2.x operating environment.  
Other software documentation that you received with your system.  
xii  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
What Typographic Changes and Symbols Mean  
Section Table P-1, “Typographic Conventions describes the typefaces and  
symbols used in this book.  
Table P-1 Typographic Conventions  
Typeface or  
Symbol  
Meaning  
Example  
AaBbCc123  
The names of commands, files,  
and directories; on-screen  
computer output  
Edit your.loginfile.  
Use ls -ato list all files.  
system% You have mail.  
AaBbCc123  
What you type, contrasted with  
on-screen computer output  
system% su  
Password:  
AaBbCc123  
Command-line placeholder:  
replace with a real name or  
value  
To delete a file, type rm filename.  
AaBbCc123  
Book titles, new words or terms, Read Chapter 6 in Users Guide.  
or words to be emphasized  
These are called class options.  
You must be root to do this.  
Code samples are included in boxes and may display the following:  
%
$
UNIX C shell prompt  
system%  
UNIX Bourne and Korn shell  
prompt  
UNIX Bourne and Korn shell  
prompt  
#
Superuser prompt, all shells  
Superuser prompt, all shells  
Preface  
xiii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
Notes, Cautions, and Warnings  
Warning – This equipment contains lethal voltage. Accidental contact can  
result in serious injury or death.  
Caution – Improper handling by unqualified personnel can cause serious  
damage to this equipment. Unqualified personnel who tamper with this  
equipment may be held liable for any resultant damage to the equipment.  
!
Individuals who remove any outer panels to access this equipment must  
observe all safety precautions and ensure compliance with skill level  
requirements, certification, and all applicable local and national laws.  
Procedures contained in this document must be performed by qualified  
service-trained maintenance providers.  
Note – Before you begin, carefully read each of the procedures in this manual.  
If you have not performed similar operations on comparable equipment, do  
not attempt to perform these procedures.  
xiv  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
IntroducingtheSunFastEthernet  
Adapter Card  
1
The information contained in this guide is organized as follows:  
Table 1-1 Organization  
Chapter/Appendi  
x
OS  
Material covered  
applicability  
Both 1.x and 2.x  
Both 1.x and 2.x  
1.x only  
1
Introduction to SunFastEthernet  
Installing SunFastEthernet SBus card  
Solaris 1.x software installation  
Solaris 2.x software installation  
Network Linkups/ Speed Selection  
Interface Signals  
2
3
4
2.x only  
5
Both 1.x and 2.x  
Both 1.x and 2.x  
6
A
B
C
D
SunFastEthernet Adapter Card Specifications Both 1.x and 2.x  
Running Diagnostics  
Both 1.x and 2.x  
2.x only  
Solaris 2.x Driver Performance Tuning  
Console Messages (Solaris 1.x Only)  
1.x 0nly  
1-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
1
The SunFastEthernet™ Adapter card is a dual mode high speed ethernet SBus  
card that can operate at either 10 or 100Mbps. The card provides the Media  
Access Control (MAC) function for either a 10 or 100Mbps CSMA/ CD protocol  
based network interface conforming to IEEE 802.3 and the Ethernet  
specification.  
1. Fully complies with the following standards:  
a. ANSI/ IEEE std 802.3 CSMA/ CD MAC layer specification  
i. Supports 10Base-T (twisted-pair) Ethernet. AUI (thicknet) and Coax  
(thinnet) can be supported via external third-party adapter boxes  
ii. 10/ 100 Mbit per second transfer rate  
b. SBus specification, Rev B.0  
i. Single-wide SBus card  
ii. Fully operational across all SBus clock ranges (12.5 - 25 Mhz)  
iii. Supports parity  
iv. Supports 16/ 32/ 64 byte burst  
c. Fast Ethernet Alliance 100Base-X media specification  
d. Fast Ethernet Alliance Reconciliation Sublayer and Media Independent  
Interface specifications  
1-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
1
SBUS  
QEC  
SRAM  
SRAM  
MACH  
IO  
EPROM  
BigMAC  
RX  
Buf  
TXFMR  
MACH  
Xtal  
Relay  
Relay  
MACH  
Choke  
Choke  
TXFMRs  
Twister  
PDR  
PDT  
RJ45  
ULTRA DB40  
Figure 1-1 SunFastEhernet Adapter Card Components  
Introducing the SunFastEthernet Adapter Card  
1-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
1
SBus  
QEC ASIC  
Local bus  
Buffer  
memory  
EPROM  
XCVR  
management  
register  
RX  
buffer  
BigMAC ASIC  
TX  
buffer  
BabyBAC  
Transceiver  
MII Interface  
Ultra DB40  
RJ45  
Hub  
External transceiver  
Figure 1-2 SunFastEthernet Block Diagram  
1-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
1
The SunFastEthernet Adapter card is supported on most SBus based Sun-4c,  
Sun-4m, and Sun-4d system architectures that run under the Solaris®  
environment or other compatible operating systems.  
To utilize the SunFastEthernet Adapter card, the system also needs to contain  
OpenBoot™ PROM (OBP) level 2.3 or later. Verify your OBP version by typing  
the banner command at the ok prompt. If the OBP version is earlier than 2.3  
then the OBP must be upgraded.  
An on-board FCode PROM provides configuration support that identifies the  
SunFastEthernet Adapter card to the system and contains selftest routines.  
Introducing the SunFastEthernet Adapter Card  
1-5  
Download from Www.Somanuals.com. All Manuals Search And Download.  
1
1-6  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
InstallingtheSunFastEthernet  
SBusCard  
2
2.1 Card Installation  
1. Remove the SunFastEthernet Adapter card from the antistatic bag and  
spread the bag on a firm surface to provide a protective mat.  
Figure 2-1 Handling the SunFastEthernet Adapter Card  
2. Place the card, component side up, on the bag.  
hardware installation or service manual for your system.  
Note – If a SunFastEthernet card is installed in a slot and you later change the  
location of the card, then you must perform the procedure indicated in  
Section 2.4, “Relocating a SunFastEthernet Card (Solaris 2.x Only)”.  
4. Following card installation, connect to a network.  
2-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
2
Use the onboard transceiver RJ45 connector for Category 5, data grade  
UTP wiring (100M maximum).  
The external transceiver MII Interface connector can be used for  
Category 5, data grade UTP or for other wiring types (dependent upon  
the transceiver type). For example: Category 3 voice grade (UTP), fiber  
optic, STP, etc.  
5. Verify SunFastEthernet installation by testing the card as indicated in the  
following section.  
2.2 Testing the SunFastEthernet Adapter Card Before Booting the System  
Note – To utilize the SunFastEthernet Adapter card, the system needs to  
contain OpenBoot™ PROM (OBP) level 2.3 or later.  
After the SunFastEthernet Adapter card is installed, and before booting the  
system, verify installation by performing the following procedure:  
1. Power on the system and when the banner appears press the L1-A key to  
get to the ok prompt.  
2-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
2
2. Use show-devsto find out SBus card information.  
The show-devscommand used by itself shows the entire device tree. The  
example below shows information for a SPARCserver™ 1000 system with  
only one system board (board 0) and a SunFastEthernet channel installed in  
slot 1.  
<#0> ok show-devs  
/io-unit@f,e0200000/sbi@0,0/qec@1,20000  
/io-unit@f,e0200000/sbi@0,0/lebuffer@3,40000  
/io-unit@f,e0200000/sbi@0,0/dma@3,81000  
/io-unit@f,e0200000/sbi@0,0/lebuffer@0,40000  
/io-unit@f,e0200000/sbi@0,0/dma@0,81000  
/io-unit@f,e0200000/sbi@0,0/qec@1,20000/be@0,0  
/io-unit@f,e0200000/sbi@0,0/lebuffer@3,40000/le@3,60000  
/io-unit@f,e0200000/sbi@0,0/dma@3,81000/esp@3,80000  
/io-unit@f,e0200000/sbi@0,0/dma@3,81000/esp@3,80000/st  
/io-unit@f,e0200000/sbi@0,0/dma@3,81000/esp@3,80000/sd  
/io-unit@f,e0200000/sbi@0,0/lebuffer@0,40000/le@0,60000  
/io-unit@f,e0200000/sbi@0,0/dma@0,81000/esp@0,80000  
/io-unit@f,e0200000/sbi@0,0/dma@0,81000/esp@0,80000/st  
/io-unit@f,e0200000/sbi@0,0/dma@0,81000/esp@0,80000/sd  
<#0> ok  
3. Set the diag-switch to true.  
At the okprompt type:  
ok setenv diag-switch? true  
Note – If the diag switch is not set to true reduced tests are run.  
Note – The SunFastEthernet card must be connected to an active network if the  
watch commands are to provide packet data.  
4. Use a watchcommand, either watch-net-all(OpenBoot PROM 2.6 or  
above) or watch-net(OpenBoot PROM 2.3 to 2.5), to watch net activity  
or watch incoming network packets.  
Installing the SunFastEthernet SBus Card  
2-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
2
Note – To find out the OpenBoot PROM revision level on your system, type  
.versionat the <#0> okprompt.  
a. If the system has OpenBoot PROM 2.6 or above, use watch-net-all.  
This example shows output when a be channel is connected to a 10Mbps  
network.  
Note – Activity may also be displayed for the le0 interface if it is connected.  
<#0> ok watch-net-all  
/io-unit@f,e0200000/sbi@0,0/qec@1,20000/be@0,0  
Qe register test -- succeeded.  
Internal loopback test -- succeeded.  
Transceiver check -- 100 mbps Link Down, 10 mbps Link Up, passed.  
Tx/Rx enable/disable test--succeeded  
Frame counter test--succeeded  
Address detection test--succeeded  
Address hash test--succeeded  
Looking for Ethernet packets.  
‘.’ is a good packet. ‘X’ is a bad packet.  
Type any key to stop.  
...............................................................  
...............................................................  
.................................  
<#0> ok  
2-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
2
b. If the system has OpenBoot PROM 2.3 to 2.5, use the watch-net  
command.  
<#0> ok watch-net  
Qe register test -- succeeded.  
Internal loopback test -- succeeded.  
Transceiver check -- 100 mbps Link Down, 10 mbps Link Up, passed.  
Tx/Rx enable/disable test--succeeded  
Frame counter test--succeeded  
Address detection test--succeeded  
Address hash test--succeeded  
Looking for Ethernet packets.  
‘.’ is a good packet. ‘X’ is a bad packet.  
Type any key to stop.  
...............................................................  
...............................................................  
.................................  
<#0> ok  
5. Set the diag-switch to false.  
At the okprompt type:  
ok setenv diag-switch? false  
Installing the SunFastEthernet SBus Card  
2-5  
Download from Www.Somanuals.com. All Manuals Search And Download.  
2
2.3 Booting From SunFastEthernet Devices  
To get information about valid SunFastEthernet device path names for your  
machine use the show-devs command as shown in the following example:  
<#0> ok show-devs  
/io-unit@f,e0200000/sbi@0,0/qec@1,20000  
/io-unit@f,e0200000/sbi@0,0/lebuffer@3,40000  
/io-unit@f,e0200000/sbi@0,0/dma@3,81000  
/io-unit@f,e0200000/sbi@0,0/lebuffer@0,40000  
/io-unit@f,e0200000/sbi@0,0/dma@0,81000  
/io-unit@f,e0200000/sbi@0,0/qec@1,20000/be@0,0  
/io-unit@f,e0200000/sbi@0,0/lebuffer@3,40000/le@3,60000  
/io-unit@f,e0200000/sbi@0,0/dma@3,81000/esp@3,80000  
/io-unit@f,e0200000/sbi@0,0/dma@3,81000/esp@3,80000/st  
/io-unit@f,e0200000/sbi@0,0/dma@3,81000/esp@3,80000/sd  
/io-unit@f,e0200000/sbi@0,0/lebuffer@0,40000/le@0,60000  
/io-unit@f,e0200000/sbi@0,0/dma@0,81000/esp@0,80000  
/io-unit@f,e0200000/sbi@0,0/dma@0,81000/esp@0,80000/st  
/io-unit@f,e0200000/sbi@0,0/dma@0,81000/esp@0,80000/sd  
<#0> ok  
Look for the be node in the device paths. For the preceding example, the device  
boot path for the SunFastEthernet channel would be:  
/ io-unit@f,e0200000/ sbi@0,0/ qec@1,20000/ be@0,0  
Note – Servers must be setup prior to booting as indicated in the following  
step. Refer to Chapter 3 for Solaris 1.x and Chapter 4 for Solaris 2.x.  
To boot from the OPB ok prompt, type boot and then the device path. In this  
example, board 0, slot 1:  
<#0> ok boot /io-unit@f,e0200000/sbi@0,0/qec@1,20000/be@0,0  
2-6  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
2
2.4 Relocating a SunFastEthernet Card (Solaris 2.x Only)  
If a SunFastEthernet card is installed in an sbus slot and you later change the  
location of the card, then you must perform the following procedure or the  
driver will not be recognized within the system:  
1. Use the pkgrm command to remove the driver SUNWbmac as shown in  
the following example:  
# pkgrm SUNWbmac  
2. Edit the file(s) /etc/path_to_inst and /etc/name_to_major by removing any  
references to the be channel that you are changing from.  
For example:  
# grep be /etc/path_to_inst  
/io-unit@f,e0200000/sbi@0,0/[email protected]/be@0,0  
and:  
# grep be /etc/name_to_major  
be 111  
In both the above examples, the results of the grep command for the  
3. Move the SunFastEthernet card to the new slot location and then reboot  
the system.  
4. Add the SUNWbmac package using the pkgadd command as indicated in  
Section 4.2.3, “Adding SUNWbmac Using pkgadd Command”.  
Installing the SunFastEthernet SBus Card  
2-7  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
2
2-8  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
InstallingSunFastEthernet  
SoftwareUsingSolaris1.x  
3
The Solaris 1 software version of the SunFastEthernet driver is supported on  
Solaris 1.1 (SunOS 4.1.3) and later releases. To utilize the SunFastEthernet  
Adapter card, the system also needs to contain OpenBoot™ PROM (OBP) level  
2.3 or later. There is no restriction on the number of SunFastEthernet SBus  
cards that can be installed in one system. The name of the SunFastEthernet  
interface is “be”.  
Note – Be sure and read the README file on the CD-ROM for late breaking  
information.  
SunFastEthernet SBus Card”), you can install the software which is located on  
CD-ROM part number 704-4885-10.  
If you will be running the software on a diskless workstation, install the  
product software on the boot server for that diskless machine, see Section 3.4,  
“Setting Up Diskless Clients,” on page 3-16. The Section 3.3, “Installing from  
CD-ROM“, covers installation from a CD-ROM.  
Note – The SunFastEthernet interface will not function in a network that uses  
Ethernet trailers.  
3-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
3.1 Hardware Requirements  
Table 3-1 lists systems supported under the Solaris 1.x software versions for  
Sun -4m architectures:  
Note – The SunFastEthernet is not supported on the SBus Expansion  
Subsystem under Solaris 1.x.  
Table 3-1 Solaris 1.x Platform Architecture with Systems  
Platform Architecture  
System Type  
Sun-4m  
SPARCserver 630MP  
SPARCserver 670MP  
SPARCserver 690MP  
SPARCclassic  
SPARCstation 5  
SPARCstation 10  
SPARCstation 20  
SPARCstation LX  
3.2 Preparing for Software Installation  
Before loading the SunFastEthernet software:  
Ensure that the system is running SunOS Version 4.1.3 or later. Use the  
uname command with the -r argument to determine your SunOS version as  
shown in the following example:  
hostname % uname -r  
Verify that the /export/exec directory contains a symbolic link from  
/export/exec/sun4 to the /usr directory on your machine. The link allows the  
script to place the SunFastEthernet files in your /usr rather than your / (root)  
partition.  
3-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
3
To confirm the existence of the link in the /export/exec directory, use the  
commands shown in the following example:  
hostname # cd /export/exec  
hostname # ls -l sun4  
lrwxrwxrwx l root 4 Apr 9 03:27 sun4 -> /usr  
The example response from command ls -l shows that the sun4 and /usr  
directories are symbolically linked. If the link does not exist, create one while  
still in the directory /export/exec, by entering the ln -s command as shown in the  
following example:  
hostname # ln -s /usr sun4  
You need approximately 500kbytes of free space in the destination partition.  
You can check the amount of free space by using the df command in the  
directory /export/exec/sun4.  
3.3 Installing from CD-ROM  
3.3.1 Access to Remote CD-ROM  
If the CD-ROM player that you are using for software installation is attached to  
a remote machine, refer to your SunOS installation guide for remote CD-ROM  
access and proceed with the installation procedures that follow.  
3.3.2 Using cdm  
When installing the SunFastEthernet software from a CD-ROM, you can use  
the cdm program. The cdm program has a command-line interface that allows  
you to install applications directly onto a machine that does not have a bit-  
mapped display. The following text presents instructions for cdm.  
Installing SunFastEthernet Software Using Solaris 1.x  
3-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
3
3.3.3 Mounting the CD-ROM  
1. Mount the CD-ROM from either a local or remote machine. For example,  
for a local machine enter the following:  
hostname # mkdir /cdrom  
hostname # mount -r /dev/sr0 /cdrom  
For a remote machine enter the following:  
hostname # mkdir /cdrom  
hostname # mount -r <remote machine>: /cdrom /cdrom  
2. After successfully mounting the CD-ROM filesystem, change directories  
to /cdrom as follows:  
hostname # cd /cdrom  
3.3.4 Install Script Using cdm  
3. Enter ./cdm at a shell prompt. You will then see the following display:  
----->>>>>CDM<<<<<-----  
1. Select Application  
2. Show Current Application  
3. Install Application  
4. Display Application Text File  
5. Print Application Text File  
6. List Applications  
7. List Categories  
8. Change Current Category  
9. Change current Directory  
10. Show Program Environment  
Please enter a number or q to quit:  
3-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
4. Enter 1 to select an application.  
You will then see the following display:  
Applications available:  
1. SBus Quad Ethernet Controller Driver  
2. SunFastEthernet Driver  
Please enter a number or q to quit:  
5. Enter 2 to select SunFastEthernet.  
You will then see the following display:  
* “SunFastEthernet” Driver selected as new application.  
----->>>>>CDM<<<<<-----  
1. Select Application  
2. Show Current Application  
3. Install Application  
4. Display Application Text File  
5. Print Application Text File  
6. List Applications  
7. List Categories  
8. Change Current Category  
9. Change current Directory  
10. Show Program Environment  
Please enter a number or q to quit:  
6. Enter 3 to initiate the installation.  
You will then see the following display:  
Begin installation now?  
7. Enter y to begin installation.  
You will then see the following display:  
Installing SunFastEthernet Software Using Solaris 1.x  
3-5  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
3-6  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
Executing installation file...  
The following product will be installed:  
Product Name:  
1.1 FCS SunFastEthernet and  
SBus Quad Ethernet Controller Driver  
Sun Platforms:  
Media type/format:  
Part Number:  
Sun-4m SUNBIN  
CD-ROM (UFS file system format) 1 of 1  
258-4882  
Compatible with the Solaris(R) 1.1, 1.1.1, and 1.1.2 releases  
Copyright 1994 Sun Microsystems, Inc. All Rights Reserved  
Printed in the United States of America.  
2550 Garcia Avenue, Mountain View, California, 94043-1100 U.S.A.  
This product and related documentation is protected by copyright  
and distributed under licenses restricting its use, copying,  
distribution and decompilation. No part of this product or  
related documentation may be reproduced in any form by any means  
without prior written authorization of Sun and its licensors, if  
any.  
Portions of this product may be derived from the UNIX(R) and  
Berkeley 4.3 BSD systems, licensed from UNIX Systems  
Laboratories, Inc. and the University of California,  
respectively. Third party font software in this product is  
protected by copyright and licensed from Sun's Font Suppliers.  
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the  
Government is subject to restrictions as set forth in  
subparagraph (c)(1)(ii) of the Rights in Technical Data and  
Computer Software  
clause at DFARS 52.227-7013 (Oct. 1988) and FAR 52.227-19(c)  
The OPEN LOOK(R) and Sun(R) Graphical User Interfaces were  
developed by Sun Microsystems, Inc. for its users and licensees.  
Sun acknowledges the pioneering efforts of Xerox(R) in  
researching and developing the concept of visual or graphical  
user interfaces for the computer industry. Sun holds a non-  
exclusive license from Xerox to the Xerox Graphical User  
Interface, which license also covers Sun's licensees who  
implement OPEN LOOK GUIs and otherwise comply with Sun's written  
license agreements.  
Installing SunFastEthernet Software Using Solaris 1.x  
3-7  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
The X Window System is a product of the Massachusetts Institute  
of Technology.  
Sun, Sun Microsystems, the Sun Logo, Solaris, SunOS, ONC, NFS,  
OpenWindows, DeskSet, AnswerBook, SunLink, SunView, SunDiag,  
NeWS, OpenBoot, OpenFonts, SunInstall, SunNet, ToolTalk, X11/NeWS  
and XView are trademarks or registered trademarks of Sun  
Microsystems, Inc. UNIX is a registered trademark of Novell,  
Inc. in the United States and other countries. X/Open Company,  
Ltd. is the exclusive licensor of such trademark. PostScript is  
a trademark of Adobe Systems, Inc. which may be registered in some  
jurisdictions. All other product names mentioned herein are the  
trademarks of their respective owners.  
All SPARC trademarks, including the SCD Compliant Logo, are  
trademarks or registered trademarks of SPARC International, Inc.  
SPARCstation, SPARCserver, SPARCengine, SPARCworks and  
SPARCompiler are licensed exclusively to Sun Microsystems, Inc.  
Products bearing SPARC trademarks are based upon an architecture  
developed by Sun Microsystems, Inc.  
8. The script will then query: Do you want to continue [y| n]?  
Enter y to continue. You will then see the following display:  
extract_unbundled : Extracting Installation Scripts  
extract_unbundled : Begin Install Script Execution  
Invoking /usr/tmp/unbundled/install_BQE; log file is  
/usr/tmp/unbundled/1.0_BQE.log  
3-8  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
9. The script will then query: Do you want to see a description of this  
installation script [y| n]?  
Follow by entering n. You will then see the following display:  
Install the SunFastEthernet driver.  
Installation should take approximately 2 minutes.  
Here is the Current Free Disk space:  
Filesystem  
/dev/sd1a  
/dev/sd1g  
/dev/sd1d  
/dev/sd1e  
/dev/sd1h  
/dev/sd1f  
kbytes  
30807  
185351 162989  
276263  
used avail capacity Mounted on  
3854 23873  
3827  
3725 244912  
45959 16401 24963  
14%  
98%  
1%  
/
/usr  
/export  
/export/swap  
/home  
40%  
323735  
37863  
10 291352  
131 33946  
0%  
0%  
/var  
This software requires 500 kbytes of disk space  
10. The script will then query: Do you want to continue [y| n]?  
Installing SunFastEthernet Software Using Solaris 1.x  
3-9  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
Follow by entering y. You will then see the following display:  
The destination directory for SunFastEthernet is: /export/exec  
a sun4/BQE/install/install_bqe 25 blocks  
a sun4/BQE/install/deinstall_bqe 8 blocks  
a sun4/BQE/usr/bin/be_speed 208 blocks  
a sun4/BQE/usr/man/man4/be.4s 17 blocks  
a sun4/BQE/usr/man/man4/qe.4s 16 blocks  
a sun4/BQE/usr/man/man4/qec.4s 6 blocks  
a sun4/BQE/4.1.3/sys/sunif/if_bmac.h 19 blocks  
a sun4/BQE/4.1.3/sys/sunif/if_bqe.h 15 blocks  
a sun4/BQE/4.1.3/sys/sunif/if_mace.h 17 blocks  
a sun4/BQE/4.1.3/sys/sunif/if_qec.h 28 blocks  
a sun4/BQE/4.1.3/sys/sun4m/OBJ/if_bqe.o 57 blocks  
a sun4/BQE/4.1.3/sys/sun4m/OBJ/if_qec.o 9 blocks  
a sun4/BQE/4.1.3_U1/sys/sunif/if_bmac.h 19 blocks  
a sun4/BQE/4.1.3_U1/sys/sunif/if_bqe.h 15 blocks  
a sun4/BQE/4.1.3_U1/sys/sunif/if_mace.h 17 blocks  
a sun4/BQE/4.1.3_U1/sys/sunif/if_qec.h 28 blocks  
a sun4/BQE/4.1.3_U1/sys/sun4m/OBJ/if_bqe.o 58 blocks  
a sun4/BQE/4.1.3_U1/sys/sun4m/OBJ/if_qec.o 9 blocks  
Software successfully extracted.  
4.1.3_U1  
Note – The install script assumes you have assigned the hostname for the  
SunFastEthernet. For example, if you want to call the SunFastEthernet system5,  
then system5 should exist in the /etc/hosts file or NIS hosts maps (if you are  
running NIS), otherwise the script exits, and you will have to restart cdm  
again.  
11. The script will then query:  
What host name do you wish to use for be0 [Dont Configure]:  
Respond by typing the assigned hostname. If there is more than one  
hardware device installed the script will then query: What host name do you  
wish to use for be1 [Don’t Configure]:, and so on until the script has prompted  
3-10  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
you for a hostname for every SunFastEthernet hardware device installed.  
Once all devices have been given a hostname, you will then see the  
following display:  
The current official hostname is: (current official hostname)  
Do you wish to change the official hostname? (y|n) [n]:  
12. The default is n, if you want to change the official hostname respond by  
entering y.  
Once the hostname is changed or the default n is selected, you will then see  
the following display:  
This script is designed to continue the SunFastEthernet  
installation by:  
Creating a System Config File based on a source Config File  
Changing protections on various files  
Running sys_install  
Modifying the system config file  
Configuring and building the new kernel  
Setting up the new Kernel image for booting  
FOLLOW THE STEPS IN THE MANUAL *PRIOR* TO REBOOTING!  
Then you must halt the system and reboot using the new  
kernel.  
13. The script will then query: Do you wish to continue with this script (y/n)  
[y]:  
Enter y to continue. The script will then query:  
Source System Config File [GENERIC]:  
If you want to change the source system config file from the default  
[GENERIC} then enter the change now, otherwise press RETURN to accept  
the default.  
Installing SunFastEthernet Software Using Solaris 1.x  
3-11  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
You will then see the following prompt:  
New System Config File [BQE]:  
3-12  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
If you want to change the new system config file from the default [BQE], then  
enter the new file name now or press RETURN to accept the default.  
You will then see the following display:  
File protection on files and BQE adjusted ....  
Doing a “make depend”  
/etc/config BQE run successfully ....  
Issuing make ...  
cc -sparc -c -O -Dsun4m -DGENERIC -DSUN4M_35 -DSUN4M_50 -  
DSUN4M_690 -DWINSVJ -DVDDRV -DASYNCHIO -DLWP -DVFSSTATS -DRFS -  
DCRYPT -DTCPDEBUG -DIPCSHMEM -DIPCSEMAPHORE -DIPCMESSAGE -  
DSYSAUDIT -DSYSACCT -DPCFS -DHSFS -DTMPFS -DTFS -DLOFS -  
DNFSSERVER -DNFSCLIENT -DUFS -DQUOTA -DINET -DMULTIPROCESSOR -  
DKERNEL -I. -I.. -I../.. ../../netinet/in_proto.c  
cc -sparc -c -O -Dsun4m -DGENERIC -DSUN4M_35 -DSUN4M_50 -  
DSUN4M_690 -DWINSVJ -DVDDRV -DASYNCHIO -DLWP -DVFSSTATS -DRFS -  
DCRYPT -DTCPDEBUG -DIPCSHMEM -DIPCSEMAPHORE -DIPCMESSAGE -  
DSYSAUDIT -DSYSACCT -DPCFS -DHSFS -DTMPFS -DTFS -DLOFS -  
DNFSSERVER -DNFSCLIENT -DUFS -DQUOTA -DINET -DMULTIPROCESSOR -  
DKERNEL -I. -I.. -I../.. ../../netinet/tcp_debug.c  
cc -sparc -c -g -Dsun4m -DGENERIC -DSUN4M_35 -DSUN4M_50 -  
DSUN4M_690 -DWINSVJ -DVDDRV -DASYNCHIO -DLWP -DVFSSTATS -DRFS -  
DCRYPT -DTCPDEBUG -DIPCSHMEM -DIPCSEMAPHORE -DIPCMESSAGE -  
DSYSAUDIT -DSYSACCT -DPCFS -DHSFS -DTMPFS -DTFS -DLOFS -  
DNFSSERVER -DNFSCLIENT -DUFS -DQUOTA -DINET -DMULTIPROCESSOR -  
DKERNEL -I. -I.. -I../.. ../../os/init_dbx.c  
cc -sparc -c -O -Dsun4m -DGENERIC -DSUN4M_35 -DSUN4M_50 -  
DSUN4M_690 -DWINSVJ -DVDDRV -DASYNCHIO -DLWP -DVFSSTATS -DRFS -  
DCRYPT -DTCPDEBUG -DIPCSHMEM -DIPCSEMAPHORE -DIPCMESSAGE -  
DSYSAUDIT -DSYSACCT -DPCFS -DHSFS -DTMPFS -DTFS  
(deleted for brevity)  
loading vmunix  
rearranging symbols  
text  
data  
bss  
dec  
hex  
1531904 463064 215088 2210056 21b908  
’make’ ran successfully ....  
Installing SunFastEthernet Software Using Solaris 1.x  
3-13  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
Followed by:  
***************************************************************  
The SunFastEthernet has been successfully installed.  
To use the new kernel, do the following:  
# mv vmunix vmunix.org  
# mv vmunix.bqe vmunix  
# /etc/reboot  
***************************************************************  
Note – If there are problems with the preceding procedure (moving vmunix /  
rebooting), then you need to boot the old vmunix which is vmunix.org in the  
above example. Thus, type: boot vmunix.org.  
The install script will then return you to cdm and the following display:  
----->>>>> CDM <<<<<-----  
1. Select Application  
2. Show Current Application  
3. Install Application  
4. Display Application Text File  
5. Print Application Text File  
6. List Applications  
7. List Categories  
8. Change Current Category  
9. Change Current Directory  
10. Show Program Environment  
Please enter a number or q to quit: q  
3-14  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
3.3.5 SunFastEthernet Directories  
The following table lists the major subdirectories of the directory that receives  
SunFastEthernet files, /export/exec/sun4/BQE. Note that /export/exec/sun4 is a  
symbolic link to /usr.  
Table 3-2 / export/ exec/ sun4/ BQE Subdirectories  
Subdirectory  
Description  
4.1.3/ sys  
Kernel and system configuration files  
4.1.3_u1/ sys  
install  
Product specific installation scripts  
Utilities  
usr/ bin  
usr/ man  
Product manual pages  
3.3.6 Installation Verification  
Note – The SunFastEthernet interface will not function in a network that uses  
network trailers.  
Use the netstat (8c) utility to check for be<num> interfaces. For example:  
hostname # netstat -ia  
Name  
leo  
beo  
be1*  
leo  
Mtu Net/Dest  
1500 mtnview-en avon  
4428 mtnview-en avon-bf0 184858  
4428 mtnview-en avon-bf1 0  
1536 loopback  
Address  
Ipkts  
197315  
Ierrs  
Opkts  
160609  
177808  
Oerrs Collis Queue  
0
0
0
0
0
0
3
0
0
0
0
0
0
0
0
localhost 11418  
11418  
0
0
An asterick (*) following an interface name, such as be1 as shown in the  
previous example, indicates that the interface is down, that is, you have not  
used ifconfig to bring the interface up.  
Installing SunFastEthernet Software Using Solaris 1.x  
3-15  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
You can also use ifconfig to check on a particular interface, for example:  
hostname # ifconfig be0  
be0: flags=63<UP,DROADCAST,NOTRAILERS,RUNNING>  
inet <IP_address> netmask <netmask> broadcast <address>  
The string <UP,BROADCAST,NOTRAILERS,RUNNING> indicates that the  
SunFastEthernet interface is correctly installed and configured.  
3.4 Setting Up Diskless Clients  
This section tells you how to set up a server so that you can boot and run  
diskless client workstations over the SunFastEthernet. This setup includes  
building a kernel that supports the SunFastEthernet interface.  
3.4.1 Setting Up to Write to the Servers /usr Partition  
If your server exports /usr read-only to the diskless client, then you need to  
refer to the “System Administrators Guide” for the servers operating system, to  
find out how to export the /usr filesystem read/ write to the diskless client.  
3.4.2 Building a New Kernel  
The following instructions are a supplement to the instructions in Chapter 8,  
“Administering Workstations”, in the SunOS manual, “System and Network  
Administration”.  
You can use the script install_bqe on the client machine to configure a new  
kernel containing a linkable driver for the SunFastEthernet. Depending upon  
the size of the kernel on which you are basing the new kernel, you need about  
2MB of free space in your root partition.You can use the install script to build a  
new kernel for each client individually. Follow the directions in Section 3.3,  
“Installing from CD-ROM”.  
If you have a lot of diskless clients, installing the clients one by one may not be  
practical. You can build the kernels manually by following the steps below. SYS  
is assumed to be the directory where you build kernels for you diskless client,  
use whatever path is right for you in place of SYS.  
3-16  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
3
If you are on a SunOS 4.1.3 machine use 4.1.3 in place of OSVER, for releases  
later than SunOS 4.1.3 use 4.1.3_U1 in place of OSVER. Enter the following  
commands:  
# cp /usr/BQE/OSVER/sys/sunif/* SYS/sunif  
# cp /usr/BQE/OSVER/sys/sun4m/OBJ/* SYS/sun4m/OBJ  
# cp SYS/sun4m/conf/files SYS/sun4m/conf/files.prebqe  
Add the following lines to SYS/ sun4m/ conf/ files:  
#
# SunFastEthernet and SBus Quad Ethernet Controller  
#
sunif/if_qec.c  
sunif/if_bqe.c  
optional qec  
optional bqe  
Add the following lines to the configuration file that you use for building  
diskless client kernels:  
#
# SunFastEthernet and SBus Quad Ethernet Controller  
#
device-driver  
device-driver  
qec  
bqe  
Now use the config command to rebuild the system configuration files for the  
diskless client. You can now copy the new kernel over to the diskless clients.  
You need to remember to add the SunFastEthernet interface names to /etc/hosts  
for each diskless client, and add the names of all the new interfaces to NIS if  
you are using it. The name of the SunFastEthernet interface will become the  
official hostname for the diskless clients. If you do not want this to happen,  
then use the SunFastEthernet install script to do an install on one machine and  
copy the changes made to /etc/rc.boot to the other diskless clients.  
Installing SunFastEthernet Software Using Solaris 1.x  
3-17  
Download from Www.Somanuals.com. All Manuals Search And Download.  
3
3-18  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
InstallingSunFastEthernet  
SoftwareUsingSolaris2.x  
4
This chapter describes SunFastEthernet installation requirements for Solaris 2.x  
software versions only.  
The SunFastEthernet Adapter card is supported on most SBus based Sun-4c,  
Sun-4m, and Sun-4d system architectures that run under the Solaris®  
environment — or other compatible operating systems. To utilize the  
SunFastEthernet Adapter card, the system also needs to contain OpenBoot™  
PROM (OBP) level 2.3 or later. An on-board FCode PROM provides  
configuration support that identifies the SunFastEthernet Adapter card to the  
system and contains selftest routines.  
Note – The SunFastEthernet interface will not function in a network that uses  
Ethernet trailers.  
4.1 Hardware Requirements  
Table 4-1 lists systems supported under the Solaris 2.x software versions for  
Sun-4c, -4d, and -4m architectures:  
Note – The SunFastEthernet is not supported on the SBus Expansion  
Subsystem under Solaris 2.x.  
4-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
4
Table 4-1 Solaris 2.x Platform Archtecture with Systems Supported  
Platform Architecture System Type  
Sun-4c  
SPARCstation 2  
SPARCstation IPX  
Sun-4d  
Sun-4m  
SPARCserver 1000 SPARCcenter 2000  
SPARCserver 630MP  
SPARCserver 670MP  
SPARCserver 690MP  
SPARCclassic  
SPARCstation 5  
SPARCstation 10  
SPARCstation 20  
SPARCstation LX  
4.2 Solaris 2.3 Hardware: 5/94 Software Requirements  
Solaris 2.3 Hardware: 5/ 94 is the first Solaris 2 release supporting the  
SunFastEthernet. The driver for the SunFastEthernet is installed from the  
package SUNWbmac. You will find this package on the Solaris 2.3 Hardware:  
5/ 94 CD. Follow the installation instructions that come with the CD.  
4.2.1 Mandatory Patch Requirements  
Patch ID number 101820-01 is required for a SunFastEthernet Adapter when  
used with Solaris 2.3 Hardware: 5/ 94 only. Contact your local Sun provider.  
4.2.2 Disk Capacity Considerations  
The Solaris 2.3 Hardware: 5/ 94 software is shipped on a single CD. The Solaris  
CD software for this distribution is divided into four software packages or  
clusters (see following table). The driver for the SunFastEthernet card is  
bundled on the Entire Distribution plus OEM Support cluster which  
4-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
4
automatically installs SUNWbmac. If disk space is a concern, and you choose  
to install another cluster, use the pkgadd command to add the SunFastEthernet  
driver as described in the following procedure:  
Table 4-2 Solaris 2.3 Hardware: 5/ 94 CD  
Cluster  
Size  
298.80 MByte  
298.1 MByte  
125.37 MByte  
59.88 MByte  
Entire Distribution plus OEM Support  
Entire Distribution  
End User System Support  
Core System Support  
4.2.3 Adding SUNWbmac Using pkgadd Command  
1. Verify that SUNWbmac is not already installed by typing the following at  
the prompt:  
# pkginfo | grep SUNWbmac  
If no information is displayed then it is not installed.  
2. Ensure that the Solaris CD is mounted (refer to your software manuals for  
detailed information on the use of the CD).  
When the CD is started Solaris_2.3 is automatically mounted on the default  
path (/ cdrom) as shown in the following example:  
# cd /cdrom/sol_2_3_hw594_sparc/s0/Solaris_2.3  
3. Use the pkgadd command to install the SunFastEthernet driver as follows:  
# pkgadd -d ‘pwd‘ SUNWbmac  
Installing SunFastEthernet Software Using Solaris 2.x  
4-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
4
4. Verify that the driver is installed as follows:  
# pkginfo | grep SUNWbmac  
system  
SUNWbmac  
SunFastEthernet Device  
5. Once you verify that the driver has been installed, proceed to the  
following section, “Host File Configuration”.  
4.2.4 Host File Configuration  
Complete the host file configuration before you install the SunFastEthernet  
Adapter card. By creating and configuring the system files before installing the  
card, you will have to reboot your system only once.  
To prepare your system for the SunFastEthernet Adapter card:  
1. Create an appropriate /etc/hostname.be<num> file where <num> refers to  
the number of each SunFastEthernet channel you plan to use. For  
example, use channel be0 for the first card; use channel be1 for a second  
card.  
Do not create /etc/hostname.be<num> files for SunFastEthernet channels you  
plan to leave unused. The /etc/hostname.be<num> file must contain the host  
name for the appropriate network interface.  
The hostname should have an IP address and should be entered in /etc/hosts.  
The hostname should be different from any other hostname of any other  
interface, for example: /etc/hostname.le0 and /etc/hostname.be0 cannot share  
the same hostname.  
Following is an example of the /etc/hostname.be<num> files required for a  
machine called zardoz that will be known as zardoz-11 and zardoz-12 on the  
nets connected to the be0 and be1 Ethernet interfaces.  
zardoz# cat /etc/hostname.be0  
zardoz-11  
zardoz# cat /etc/hostname.be1  
zardoz-12  
4-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
4
2. Create an appropriate entry in the /etc/hosts file for each active be channel.  
Using the example in step 1, you will have:  
zardoz# cat /etc/hosts  
#
# Internet host table  
#
127.0.0.1  
localhost  
129.144.10.57 zardoz loghost  
129.144.11.83 zardoz-11  
129.144.12.41 zardoz-12  
Once /etc/hostname.be<num> files and /etc/hostsfiles are created/ updated:  
3. Halt the system using the shutdown -i0 command.  
4. Once the system has been halted, proceed to Chapter 2, “Installing the  
SunFastEthernet SBus Card”.  
4.3 Solaris 2.3 Hardware: 8/94 Software Requirements  
Solaris 2.3 Hardware: 8/ 94 is the second Solaris 2 release supporting the  
SunFastEthernet. The driver for the SunFastEthernet is installed from the  
package SUNWbmac. You will find this package on the Solaris 2.3 Hardware:  
8/ 94 CD. Follow the installation instructions that come with the CD.  
software for this distribution is divided into five software packages or clusters  
(see following table). The driver for the SunFastEthernet Adapter  
(SUNWbmac) is bundled on the “Entire Distribution plus OEM Support” cluster  
which automatically installs the driver SUNWbmac. In this instance you  
SunFastEthernet Adapter Card Before Booting the System”.  
For the “Entire Distribution”, “Programmer” and ”End User Support” clusters, the  
driver is installed only if SunFastEthernet Adapter hardware is installed in the  
system If this is the case (hardware already installed) then proceed to Chapter  
2, Section 2.2, “Testing the SunFastEthernet Adapter Card Before Booting the  
System.  
Installing SunFastEthernet Software Using Solaris 2.x  
4-5  
Download from Www.Somanuals.com. All Manuals Search And Download.  
4
Table 4-3 Solaris 2.3 Hardware: 8/ 94 CD  
Cluster  
Size  
298.80 MByte  
298.1 MByte  
Entire Distribution plus OEM Support  
Entire Distribution  
Programmer  
220Mbyte  
125.37 MByte  
59.88 MByte  
End User System Support  
If SunFastEthernet hardware was not installed when the Solaris 2.3 Hardware:  
8/ 94 software distribution was installed using one of the last four clusters,  
then the driver is not automatically installed via suninstall, instead, the driver  
must be installed using the pkgadd command. Refer to Section 4.2.3, “Adding  
SUNWbmac Using pkgadd Command,” on page 4-3“.  
4.3.1 Net-Install Servers  
Note – The Solaris CD cannot be used to do a net-install (read only), thus the  
following section is applicable only when the Solaris CD image is archived to a  
disk.  
To allow net-install over the be interface the be minor-device- number must be  
added to your particular architectures name_to_major file. To determine the be  
minor-device-number proceed as follows:  
1. Determine the directory where the Solaris CD image is loaded.  
For example, if the Solaris software is located within a directory named DIR,  
then type the following:  
# cd DIR/export/exec/kvm  
2. Use the ls command to list the directory contents.  
Different directories for supported architectures will be listed.  
4-6  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
4
3. Use the cd command and go to the directory containing your particular  
architecture.  
4. Type the following line to get a listing for the minor device number for  
the be0 device:  
# ls -l devices/pseudo/clone@0:be  
The resultant listing will have the following format:  
crw-rw-rw 1 root sys 11,<minor-device number> <date>  
/devices/pseudo/clone@0:be  
5. For the above example the minor-device-number should be added to the  
etc/name_to_major file as follows:  
be <minor-device-number>  
4.3.2 Diskless Clients  
For support of diskless client booting do the following:  
1. Go to your clients root partition and use your favorite editor to add an  
entry for the be device to your clients name_to_major file as follows:  
# cd /export/root/<client name>/etc  
2. Edit the name_to_major file by adding an entry for the be device.  
If the major device number for the last file entry is “n” then use ” n+1” for  
the be channel major device number. As shown in the example, if the last  
entry is qe 104 then use be 105.  
qec 103  
qe 104  
be 105  
Installing SunFastEthernet Software Using Solaris 2.x  
4-7  
Download from Www.Somanuals.com. All Manuals Search And Download.  
4
3. Copy be driver to clients root partition as follows:  
# cd /export/root/<client name>/kernel/drv  
then:  
# cp /kernel/drv/be .  
4.4 Solaris 2.4 Hardware: 11/94 Software Requirements  
Note – The patch described in the following paragraph is mandatory for  
Solaris 2.4.  
You can find the Solaris 2.4 software for the SunFastEthernet adapter card on  
the Solaris 2.4 Hardware: 11/ 94 Software CD. In addition, you must also install  
patch ID # 102001-03 located on the SMCC Updates CD. Refer to the patch  
README file for instructions on installing the patch.  
4-8  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
NetworkLinkups/SpeedSelection  
5
The information presented in this chapter is applicable to both Solaris 1.x and  
2.x software versions.  
5.1 Network Link Ups  
5.1.1 10/100Mbps Link Up Using RJ45 Connector  
If your SunFastEthernet channel is connected to a 10 or 100Mbps network  
through the RJ45 connector you will receive a Link Up message whenever you  
boot the system or disconnect and then reconnect to the network.  
For 10Mbps the message is:  
# be<num>: Using Onboard Transceiver  
10 Mbits/sec Link Up  
For 100Mbps the message is:  
# be<num>: Using Onboard Transceiver  
100 Mbits/sec Link Up  
5-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
5
Note – If you do not see a “10 or 100Mbits/ sec Link Up” message, then the  
link is down and the probable cause could be a disconnected cable, transceiver  
or hub.  
5.1.2 10/100Mbps Link Up Using MII interface Connector  
If your SunFastEthernet channel is connected to a 10 or 100 Mbps network  
through the MII interface connector you will receive a Link Up message  
whenever you boot the system or disconnect and then reconnect to the  
network.  
For 10Mbps the message is:  
# be<num>: Using External Transceiver  
10 Mbits/sec Link Up  
For 100Mbps the message is:  
# be<num>: Using External Transceiver  
100 Mbits/sec Link Up  
Note – If you do not see a “10 or 100Mbits/sec Link Upmessage, then the link  
is down and the probable cause could be a disconnected cable, transceiver or  
hub.  
5.1.3 Link Integrity Test  
The link integrity test feature is always enabled on SunFastEthernet cards. The  
link integrity test feature is a requirement of the IEEE 10Base-T standard. The  
purpose of the test feature is to enable a 10Base-T node to detect a link failure.  
The standard requires that on a periodic basis, each station on the net transmit  
link pulses whenever it is not transmitting valid packets. Sampling the link  
pulses, the receiver will assume that the network connection (link) is intact and  
assumes a link pass state.  
5-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
5
5.2 Speed Selection  
If you receive the following messages after connecting to a 10 or 100Mbps  
network then more than likely the external hub and the SunFastEthernet are  
out of sync. In these instances speed selection may be done manually using the  
be_speed utility as indicated in the procedure that follows:  
# be<num>: 100 Mbps Link Up  
Link Down  
10 Mbps Link Up  
Link Down  
This utility is available in the directory / usr/ sbin only if patch ID 101820-01 is  
installed. This patch is mandatory for the Solaris 2.3 Hardware: 5/ 94 release;  
for the Solaris 2.x Hardware: 8/ 94 release the patch is needed only if the  
be_speed utility is required.  
To use the utility for Solaris 1.x, type the following at the prompt:  
# /usr/bin/be_speed be<num> <arguments>  
To use the utility for Solaris 2.x, type the following at the prompt:  
# /usr/sbin/be_speed be<num> <arguments>  
Wherein <num> is the SunFastEthernet Adapter card number and the  
arguments are:  
auto (automatic speed selection)  
100 (forces 100 Mbps mode)  
10 (forces 10 Mbps mode)  
If no arguments are selected then the current mode (auto or forced) and speed  
(10 or 100Mbps) of the interface will be printed.  
Network Linkups/Speed Selection  
5-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
5
5-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
InterfaceSignals  
A
Table A-1 lists SBus interface signals and their corresponding pin numbers.  
Table A-1 SBus Interface Signals  
Pin No. Description Pin No. Description Pin No. Description  
1
GND  
16  
17  
18  
19  
20  
21  
22  
23  
24  
25  
26  
27  
28  
29  
30  
INT (4)*  
D (19)  
31  
32  
33  
34  
35  
36  
37  
38  
39  
40  
41  
42  
43  
44  
45  
PA (4)  
2
BR*  
LERR*  
PA (6)  
3
SEL*  
D (21)  
4
INT (1)*  
D (0)  
D (23)  
PA (8)  
5
INT (5)*  
D (25)  
PA (10)  
ACK (0)*  
PA (12)  
PA (14)  
PA (16)  
ACK (1)*  
PA (18)  
PA (20)  
PA (22)  
ACK (2)*  
PA (24)  
6
D (2)  
7
D (4)  
D (27)  
8
INT (2)*  
D (6)  
D (29)  
9
INT (6)*  
D (31)  
10  
11  
12  
13  
14  
15  
D (8)  
D (10)  
INT (3)*  
D (12)  
D (14)  
D (16)  
SIZ (0)  
SIZ (2)  
INT (7)*  
PA (0)  
PA (2)  
A-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
A
Table A-1 SBus Interface Signals (Continued)  
Pin No. Description Pin No. Description Pin No. Description  
46  
47  
48  
49  
50  
51  
52  
53  
54  
55  
56  
57  
58  
59  
60  
61  
62  
PA (26)  
DP  
63  
64  
65  
66  
67  
68  
69  
70  
71  
72  
73  
74  
75  
76  
77  
78  
79  
D (17)  
+5V  
80  
81  
82  
83  
84  
85  
86  
87  
88  
89  
90  
91  
92  
93  
94  
95  
96  
+5V  
PA (7)  
PA (9)  
PA (11)  
GND  
-12V  
CLK  
D (18)  
D (20)  
D (22)  
GND  
BG*  
AS*  
PA (13)  
PA (15)  
PA (17)  
+5V  
GND  
D (1)  
D (3)  
D (5)  
+5V  
D (24)  
D (26)  
DA (28)  
+5V  
PA (19)  
PA (21)  
PA (23)  
GND  
D (30)  
SIZ (1)  
RD  
D (7)  
D (9)  
D (11)  
GND  
D (13)  
D (15)  
GND  
PA (25)  
PA (27)  
RST*  
PA (1)  
PA (3)  
PA (5)  
+12V  
A-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
A
Table A-2 lists SunFastEthernet Adapter Media Independent Interface signals  
and their corresponding pin numbers.  
Table A-2 SunFastEthernet Adapter Media Independent Interface Signals (Ultra DB40)  
Pin Number  
Description  
+5V  
Pin Number  
Description  
+5V  
1
21  
22  
23  
24  
25  
26  
27  
28  
29  
30  
31  
32  
33  
34  
35  
36  
37  
38  
39  
40  
2
MDIO  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
GND  
+5V  
3
MDC  
4
RXD<3>  
RXD<2>  
RXD<1>  
RXD<0>  
RX_DV  
RX_CLK  
RX_ER  
TX_ER  
TX_CLK  
TX_EN  
TXD<0>  
TXD<1>  
TXD<2>  
TXD<3>  
COL  
5
6
7
8
9
10  
11  
12  
13  
14  
15  
16  
17  
18  
19  
20  
CRS  
+5V  
Interface Signals  
A-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
A
A-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
SunFastEthernet Adapter Card  
Specifications  
B
B.1 Performance Specifications  
Table B-1 Performance Specifications  
Feature  
Specification  
SBus Clock  
12.5MHz to 25MHz  
12.5Mbytes/ sec  
10/ 100Mbps  
Max SBus Burst Transfer Rate  
Max Ethernet Transfer Rate  
SBus Data/ Address Lines  
SBus Modes  
D <31:0>/ PA <18:0>  
Master/ Slave  
Capacitance per SBus Signal Line 20 pF  
SBus Parity  
Yes  
SBus Version  
SBus Burst Sizes  
Conforms to IEEE 1496  
16/ 32/ 64  
B-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
B
B.2 Power Specifications  
Table B-2 Power Specifications  
Specification  
Power Dissipation  
Voltage Tolerance  
Ripple  
Measurement  
9.5 Watt max.  
+/ - 5%  
100 mV  
5V, 2.0 Amps  
Operational Current  
B.3 Physical Dimensions  
Table B-3 Overall Physical Dimensions  
Dimension  
Length  
Measurement  
5.78 in. (147.70 mm)  
Width  
3.3 in. (83.82 mm)  
5.52 oz. (158g)  
Weight  
B-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
B
B.4 Environmental Specifications  
Note – Specifications shown are for Sun Fast Ethernet Adapter Card in  
SPARCstation 10.  
Table B-4 Environmental Specifications  
Condition  
Temperature  
Operating Specification  
Storage Specification  
0
0
0 to 40  
C
-40 to 75  
C
0
0
Relative Humidity  
5 to 85% RH, 40 C  
non-condensing  
95% RH, 40 C  
non-condensing  
Shock  
8 Gs, 11 msec  
25 G’s, 11 msec  
Vibration, peak acceleration .35 G’s, 5 - 500 Hz  
1.25 G’s, 5 - 500 Hz  
SunFastEthernet Adapter Card Specifications  
B-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
B
B-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
RunningDiagnostics  
C
Note – The SunFast Ethernet Adapter is not supported in Sundiag for Solaris  
1.x.  
The tests available for this device consist of a selftest and SunDiag.  
C.1 Selftest  
The SunFastEthernet selftest is a test that verifies correct operation of the SBus  
card. The selftest consists of a suite of tests that reside in the FCcode PROM on  
the card. The code is written in Forth programming language and can only be  
run under OBP version 2.3 or later.  
The SunFastEthernet Selftest does not automatically run after power on or  
reset, but can be invoked by the user as necessary to acquire status of the  
hardware.  
As a Sun SPARCstation machine is powered up, the following banner will  
appear. Check that the PROM version is 2.3 or later. If the system is set up to  
automatically boot, press key combination L1-A to stop it. If the system is not  
already at the ok prompt, select n for the new command mode to get to the ok  
prompt.  
C-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
SPARCstation 2, Type 4 keyboard  
Rom Rev 2.4, 16MB memory installed  
Ethernet address 8:0:20:8;42:7, Host ID 51000007  
Type b (boot), c (command), n (new command)  
>n  
ok  
To check that the system has a SunFastEthernet Adapt;er card installed and in  
which SBus slot, look for the be device in the following command:  
ok show-devs  
...  
/sbus@1,f8000000/qec@1,20000/be@0,0  
...  
ok  
To display the OBP set of environment variables, type the following command:  
ok printenv  
selftest-#megs  
1
...  
auto-boot?  
...  
fcode-debug  
true  
false  
...  
ok  
To change an OBP environment variable, for example auto-boot? to false, use the  
setenv command as follows, then type reset for the change to take effect:  
C-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
ok setenv auto-boot? false  
ok reset  
To browse the OBP device tree, use the cd command to get to a specific  
working directory, and words to find all the Forth words available in that  
directory:  
ok cd /sbus/qec@1,20000/be  
ok words  
read  
open  
ok  
write  
seek  
load  
reset selftest  
close  
To examine the definition of a word, use the see command as follows:  
ok see selftest  
: selftest  
(ffd988d0) (ffd98c28) (ffd99564) (ffd98c60) swap (ffd5fb9c)  
(ffd988d0)  
if  
(ffd995ec)  
else  
-1  
then  
;
ok  
For more information on using the OBP commands, refer to the Open Boot  
Command Reference manual, part no. 800-6076-11.  
Running Diagnostics  
C-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
C.1.1 Selftest Description  
The Selftest can be invoked from the ok prompt on a Sun machine that has OBP  
2.x or later as follows:  
1. Set the diag-switch to true.  
At the okprompt type:  
ok setenv diag-switch? true  
Note – If the diag switch is not set to true reduced tests are run.  
ok test /iommu/sbus/qec/be@0,0  
Qe register test--succeeded  
Internal loopback test--succeeded  
Transceiver check -- 100 mbps Link Down, 10 mbps Link Up, passed.  
Tx/Rx enable/disable test--succeeded  
Frame counter test--succeeded  
Address detection test--succeeded  
Address hash test--succeeded  
ok  
2. Set the diag-switch to false.  
At the okprompt type:  
ok setenv diag-switch? false  
As each test is executed, the resulting status of either pass or fail will be  
displayed. The tests will be run sequentially that will stop when any test  
encounters an error. A description of each test is given in the following  
sections.  
C-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
C.1.1.1 Register Test  
This test performs write, read, and compare on the QEC, bmac, and transceiver  
registers. The test will then issue a reset to make sure that the appropriate  
register contents are reset.  
C.1.1.2 Internal Loopback Test  
This test will check the internal loopback data path.  
C.1.1.3 Transceiver Test  
This test will check the onboard transceiver connection and the link status.  
C.1.1.4 Tx/Rx Enable/Disable Test  
This test will verify that the Tx and Rx state machines work properly when  
disabled or enabled.  
C.1.1.5 Frame Counter Test  
This test will verify the Rx Frame, Length Error, and FCS Error counters. The  
test will also verify the counter expiration status. Rx Frame can be tested by  
sending good packets, Length Error can be tested by sending packets with  
length exceeding max size, and FCS Error can be tested by sending packets  
without FCS.  
C.1.1.6 Address Detection Test  
This test will verify the broadcast addressing mode, promiscuous modes, and  
filter my own packet mode.  
C.1.1.7 Address Hash Test  
This test will verify the address hash table logic.  
Running Diagnostics  
C-5  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
C.1.2 Debug using Selftest  
For debuging under selftest refer to “Writing FCode Programs, Revision A,  
November 1993” (Sun Part Number 801-5123-10).  
C.2 Sundiag  
Sundiag is an on-line system exerciser that runs diagnostic hardware tests. It is  
used primarily with the OpenWindows software interface that enables you to  
quickly and easily set test parameters to run tests.  
Note – Sundiag does not probe for SunFastEthernet devices by default, for  
Sundiag to acknowledge a beX channel the .usertest file must be edited before  
bringing up Sundiag as described in the following section.  
C.2.1 Editing .usertest File  
1. Login as superuser and then type the following:  
zardoz# cd /opt/SUNWdiag/bin  
2. Edit the file .usertest by adding the following line wherein the format is  
test label, test name, and command-line arguments.  
The example given is for a single be0 interface; for multiple channels add an  
additional line for each channel using be1, be2 etc.:  
be0, nettest, IF=be0 v  
Because testing the SunFastEthernet card is user defined, default options are  
not displayed in Sundiag. Test options for a beX channel can be defined in  
the .usertest file using the command nettest. Type the command nettest  
without arguements for a list of options, for example:  
zardoz# nettest  
Usage: nettest [TARGET=h1+h2...] [IF=interface] {TEST=0..7}  
N=nopkts} {P=pattern} [T=seconds]  
C-6  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
C.2.2 The Sundiag Window  
Note – The SunFast Ethernet Adapter is not supported in Sundiag for Solaris  
1.x.  
Note – Examples in this section show Sundiag running in the OPEN LOOK®  
environment. Sundiag run in the SunView™ environment will look different.  
To start Sundiag, cd to the Sundiag directory (/ opt/ SUNWdiag/ bin/ sundiag)  
and then type the sundiag command. After you enter the sundiagcommand,  
the Sundiag window is displayed on your screen, refer to Figure C-1. This  
window is the primary interface for running Sundiag. Refer to the Sundiag  
manual that came with your operating system for further details.  
The Sundiag window is divided into four small windows:  
The system status window at the upper-left of the screen displays the status  
of the tests.  
The performance monitor panel in the upper-middle of the screen displays  
the performance statistics for the system that is under test.  
The control panel is located at the right. The panel includes buttons,  
exclusive choice, toggle, and pop-up menus that allow you to select test  
parameters and options.  
The console window at the bottom-left displays test messages, and allows  
you, as a superuser, to use operating system commands.  
Running Diagnostics  
C-7  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
Figure C-1 Sundiag Window  
C.2.3 Starting the Test  
1. Review the information in the control panel, which identifies the devices  
that are available for testing.  
Click on the device that you want to test, in this case (USER 0) nettest.Your  
selection is confirmed with the display of a highlighted box next to the  
device name  
2. Click on the Start button.  
3. Watch the console window for messages.  
C-8  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
4. To interrupt a test or to stop after a test is completed, click on the Stop  
button.  
If no problems are identified during the testing, the SunFastEthernet card is  
ready for operation in your system. Click on the Quit button to exit Sundiag.  
Running Diagnostics  
C-9  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C
C-10  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Solaris2.xDriver Performance  
Tuning  
D
If your system is a server which serves clients with heavy traffic and you  
experience numerous RPC errors, you may fine tune your system for  
performance by changing the buffer default settings in the / etc/ system file as  
follows.  
Table D-1 depicts the buffer default settings; each buffer requiring 1.5 kbyte of  
memory.  
Table D-1 Buffer Default Settings  
Quantit  
Buffer  
y
Description  
benbufs  
berpending  
256  
32  
Number of free buffers for Tx and Rx  
Number of Rx descriptors  
Total number of buffers allocated  
288  
Go to the / etc/ system file and change the buffer default values to the  
recommended values as follows:  
# set be:benbufs=1024  
# set be:berpending=64  
Note – The maximum setting for berpending is 248  
D-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
D
D-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
ConsoleMessages(Solaris1.x  
Only)  
E
The SunFastEthernet software can output the messages listed below. Each  
message is accompanied by an explanation and/ or workaround.  
Some of the messages indicate normal operation of the product, while others  
indicate an error condition. In the latter category, certain messages indicate a  
transitory condition, while others indicate a condition fatal to the operation of  
the SunFastEthernet device.  
be<num>: Cannot find 100Mbit tcvr, using 10Mbit  
The device cannot find a 100 Mbps transceiver and is switching to 10 Mbps  
mode.  
be<num>: Cannot free unit -- still running  
An attempt was made to unload the driver when the interface was still up. Use  
ifconfig be<num> down to bring the interface down before unloading the driver.  
be<num>: Cannot reset  
Cannot reset the device. This is most likely due to a bad device.  
E-1  
Download from Www.Somanuals.com. All Manuals Search And Download.  
E
be<num>: No carrier-cable problem or hub link test disabled?  
The no carrier portion of this message indicates that the device may have lost  
the carrier detect signal. The driver has a test feature that verifies the Ethernet  
cable connection between the device and the Ethernet hub. In order for this  
feature to function correctly, the Ethernet hub must support the link test  
feature and it must be turned on in the hub. If the hub doesnt support the link  
test or if the link test is disabled in the hub, you will see this error message  
during the system boot.  
The cable problem or hub link test disabled portion of this message indicates  
possible cable problems. Check the cable, if no cable problem can be found  
then check for a link integrity mismatch. If there is a link integrity mismatch,  
you may enable the link test feature in your Ethernet hub (usually by turning a  
switch on), or you may disable the link test in your SPARC system.  
To enable/ disable the link test: at the OBPs ok prompt enter the OBP  
command help ethernet and then press RETURN to receive more information.  
be<num>: No transceiver found!  
The device did not find a transceiver. Check cabling and the transceiver.  
be<num>: SBus rx derror ack  
E-2  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
E
and  
be<num>: SBus tx derror ack  
The DMA engine encounted an error which indicates a potential hardware or  
driver problem.  
be<num>: SBus rx late error  
be<num>: SBus tx late error  
be<num>: SBus rx parity error  
and  
be<num>: SBus tx parity error  
The DMA engine encounted an error which typically indicates a hardware  
problem.  
be<num>: bechanstop: global reset failed  
be<num>: bechanstop: gec init failed  
and  
be<num>: bechanstop: TDMD did not clear  
These errors indicate a hardware failure. The device is most likely bad.  
Console Messages (Solaris 1.x Only)  
E-3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
E
be<num>: bqeallocthings: Not enough system memory  
The driver cannot allocate sufficient memory for resources. These messages  
occur when attempting to load the driver. You will be unable to load the driver  
until sufficient memory becomes free. Terminating unnecessary processes or  
unloading unused drivers are ways to free memory.  
be<num>: bqeallocthings: berpending and qerpending are too large  
The values for the berpending and qerpending combined are too large. This  
should not happen unless you try to adjust these values. Reduce the values  
until the driver will load.  
be<num>: bqeread: mbuf alloc failed  
There is a resource shortage in the operating system most likely due to the  
system being too busy. As a result, a received packet has been dropped. This  
condition should be transitory.  
be<num>: beinit failed: out of buffers  
The driver could not allocate enough receive buffers for the interface. The  
interface will not be usable.  
be<num>: beinit: unit not on the list  
and  
be<num>: bestart: unit not on the list  
An invalid device unit number was passed into the specified routine. This  
E-4  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
E
error is usually symptomatic of trouble elsewhere in the operating system.  
be<num>: map_regs for qec per-channel reg failed  
be<num>: map_regs for bmac reg failed  
be<num>: map_regs for bmac transceiver reg failed  
and  
be<num>: mb_nmapalloc for QMD and buffers failed  
The driver cannot allocate sufficient address space for resources. These  
messages occur when attempting to load the driver. You will be unable to load  
the driver until sufficient address space becomes free. Unloading unused  
drivers is one way to free up address space.  
be<num>: out of tmds - packet dropped  
The driver has run out of transmit message descriptors needed to queue a  
packet to the device and discarded the packet. This error usually indicates that  
the upper protocol layers are generating packets faster than the driver can  
transmit them on the Ethernet and is usually selfcorrecting.  
be<num>: pkt missed/drop error  
The device has dropped an incoming packet because it had no buffer space for  
it. This is most likely due to the driver being under a heavy networking load.  
Console Messages (Solaris 1.x Only)  
E-5  
Download from Www.Somanuals.com. All Manuals Search And Download.  
E
be<num>: rx crc error  
The driver has received a packet with an incorrect checksum field.  
be<num>: rx fifo overflow  
Indicates that the device receive FIFO has overflowed. This is most likely due  
to the system being under a heavy load.  
be<num>: rx framing/alignment error  
The driver has received a packet containing a noninteger multiple of eight bits  
and there was a CRC error.  
be<num>: rx late collision error  
A packet collision has occurred after the channels slot time has elapsed. This  
error usually indicates faulty hardware elsewhere on the net.  
be<num>: rx pkt buff error  
Indicates that the buffer posted to the device was smaller than the actual  
packet received. This error is usually symptomatic of trouble in the operating  
system or driver.  
be<num>: rxmac did not reset  
Cannot reset the receiver state machine. This is most likely due to a bad device  
be<num>: tx chained packet descriptor error  
The DMA engine encounted a packet that it did not own during the  
E-6  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
E
transmission of a chained packet. This indicates a problem in the driver. The  
device will reset itself and continue normal operation.  
be<num>: tx babble  
A packet larger than 1518 bytes was passed to the device. This indicates an  
error in the driver.  
be<num>: tx fifo underflow  
Indicates that the device transmit FIFO has underflowed. This is most likely  
due to the system being under a heavy load.  
be<num>: tx jabber  
Indicates that the device attempted to transmit for an excessive time period.  
This is most likely due to a bad device or transceiver.  
be<num>: tx late collision error  
A packet collision has occurred after the channels slot time has elapsed. This  
error usually indicates faulty hardware elsewhere on the net.  
be<num>: tx retry error  
The driver tried to retransmit the packet 16 times without any success. The  
packet is dropped. This could be caused by a bad cable, bad transceiver, or a  
very busy network.  
be<num>: txmac did not reset  
Cannot reset the transmitter state machine. This is most likely due to a bad  
Console Messages (Solaris 1.x Only)  
E-7  
Download from Www.Somanuals.com. All Manuals Search And Download.  
E
device.  
bqeattach: bad number of regs  
The SBus card has reported an invalid number of device registers. The device  
may be bad, or there may be a problem in the operating system or driver.  
bqeattach: driver has no parent  
The driver doesnt have a parent driver. This error is usually symptomatic of  
trouble elsewhere in the operating system.  
E-8  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Revision History  
Revision  
Dash  
Date  
Comments  
Included Solaris 1.x support.  
A
11  
November 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  
SunFastEthernet Adapter User GuideNovember 1994  
Download from Www.Somanuals.com. All Manuals Search And Download.  

Sharp Convection Oven R 963S User Manual
Shure Headphones SRH840 User Manual
Sony Carrying Case SJKP71 User Manual
Sony Car Satellite TV System STR DH720 User Manual
Sony Digital Camera TS DSC P41 01 User Manual
Sony Microcassette Recorder 4 156 541 831 User Manual
Sony Personal Computer PCV LX800 User Manual
Sony Speaker 1287 2374 User Manual
Sony Stereo Amplifier TA FB740R User Manual
Sylvania DVD Player DV220SL8 A User Manual