Sun Microsystems GigaSwift Ethernet Adapter - Manuals

vi Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Configuring Driver Parameters 87 Configuring VLANs 87 C. Specifications 89 Connectors 89 Performance Specifications 91 Physical Characteristics 91 Power Requirements 91 D. Diagnostic Software and Troubleshooting Issues 93 ...

vii Figures FIGURE 1-1 Sun GigaSwift Ethernet MMF Adapter 2 FIGURE 1-2 Sun GigaSwift Ethernet UTP Adapter 3 FIGURE 5-2 Ethernet Tag Header Format 66 FIGURE C-1 Sun GigaSwift Ethernet MMF Adapter Connector 89 FIGURE C-2 Sun GigaSwift Ethernet UTP Adapter Connector 90

ix Tables TABLE 1-1 Front Panel Display LEDs for the MMF Adapter 2 TABLE 1-2 Front Panel Display LEDs for the UTP Adapter 3 TABLE 3-1 Device Link Parameters 33 TABLE 3-2 link-clock Capabilities for Link Up 34 TABLE 4-1 ce Driver Parameter, Status, and Descriptions 38 TABLE 4-2 Operational Mode Param...

xi Declaration of Conformity Compliance Model Number: GCS Product Family Name: Sun GigaSwift Copper Ethernet PCI Adapter Card (X4050A) EMCUSA - FCC Class AThis equipment complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:1) This equipment may not cause harmf...

vii 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 Sta...

ix BSMI Class A Notice The following statement is applicable to products shipped to Taiwan and marked as Class A on the product compliancelabel. Graphic showing the BSMI Class A Notice for products shipped to Taiwan. GOST-R Certification Mark Graphic showing the GOST-R Certification Mark.

xix Preface The Sun GigaSwift Ethernet Adapter Installation and User’s Guide provides installationinstructions for both the Sun GigaSwift Ethernet UTP adapter and the Sun GigaSwiftEthernet MMF adapter. This manual also describes how to configure the driversoftware. These instructions are designed fo...

xx Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Appendix C lists the specifications for the Sun GigaSwift Ethernet adapter. Appendix D provides an overview of the SunVTS diagnostic application andinstructions for testing the adapter using the onboard FCode selftest. The...

Preface xxi Shell Prompts Related Documentation Accessing Sun Documentation You can view, print, or purchase a broad selection of Sun documentation, includinglocalized versions, at: http://www.sun.com/documentation Shell Prompt C shell machine_name % C shell superuser machine_name # Bourne shell and...

xxii Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Third-Party Web Sites Sun is not responsible for the availability of third-party web sites mentioned in thisdocument. Sun does not endorse and is not responsible or liable for any content,advertising, products, or other ...

1 C H A P T E R 1 Sun GigaSwift Ethernet AdapterOverview This chapter provides a description of the Sun GigaSwift Ethernet UTP and MMFadapter hardware and software. This chapter includes the following sections: ■ “Hardware Overview” on page 1 ■ “Hardware and Software Requirements” on page 4 ■ “Patch...

2 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 FIGURE 1-1 Sun GigaSwift Ethernet MMF Adapter LED Displays on the MMF Adapter Four LEDs are displayed on the front panel of Sun GigaSwift Ethernet MMF adapter.They are labeled on the front panel as shown in TABLE 1-1 . Sun ...

Chapter 1 Sun GigaSwift Ethernet Adapter Overview 3 FIGURE 1-2 Sun GigaSwift Ethernet UTP Adapter LED Displays on the UTP Adapter Two LEDs are displayed on the front panel of the Sun GigaSwift Ethernet UTPadapter. They are labeled on the front panel as shown in TABLE 1-2 . TABLE 1-2 Front Panel Disp...

4 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Hardware and Software Requirements Before using the Sun GigaSwift Ethernet adapter, make sure your system meets thefollowing hardware and software requirements: Sun Enterprise 3000, 4000, 5000, and 6000 series systems using...

Chapter 1 Sun GigaSwift Ethernet Adapter Overview 5 The Solaris 8 2/02 release includes Patch-ID Number 111883-05. Subsequent versionsof the Solaris operating system may include the correct version. Following are the current driver patch versions (at the time this document wascreated): ■ Patch-ID Nu...

7 C H A P T E R 2 Installing the Adapter This chapter describes how to install the adapter in your system and verify that ithas been installed correctly. It then describes how to install the driver software usingthe automated script. Finally, this chapter describes how to edit the network hostfiles ...

8 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Note – Dynamic reconfiguration (DR) is a system-specific feature. If you have a Sun Enterprise system that supports DR, refer to the Sun Enterprise DynamicReconfiguration User’s Guide and your system’s documentation for fur...

Chapter 2 Installing the Adapter 9 Caution – Do not use excessive force when installing the adapter into the PCI slot. You might damage the adapter ’s PCI connector. If the adapter does not seat properlywhen you apply even pressure, remove the adapter and carefully reinstall it. 9. Secure the adapte...

10 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 2. List the network devices on your system. You should see the full path name of the network devices, similar to the example below. In this example, the network@0 and the network@1 devices are the Sun GigaSwift Ethernet ad...

Chapter 2 Installing the Adapter 11 4. View the .properties file for a list of device properties. The . properties command displays the specific information about the installed adapter. If you are using the Sun GigaSwift Ethernet MMF adapter, your output willbe similar to the following. ok cd /pci@8...

Chapter 2 Installing the Adapter 13 Note – If you are going to set the local-mac-address? variable, note the local MAC address of your device at this time. See “Setting the local-mac-address? Variable” on page 13 for more information. 5. Type the following when you finish looking at the .properties ...

14 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 1. List the network devices on your system. 2. Set the Sun GigaSwift Ethernet adapter device to be your default boot device. Note that the command shown in this example sets your boot device to be port 0 onthe network port...

Chapter 2 Installing the Adapter 15 ▼ To Install the Software Using the InstallationScript 1. At the system console, become superuser (root). 2. Insert the Sun GigaSwift Ethernet Adapter CD into a CD-ROM drive that is connected to your system. ■ If your system is running Sun Enterprise Volume Manage...

16 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 4. Execute the installation script: The script displays a menu of products: 5. Select 2, the Sun GigaSwift Ethernet adapter, and answer the questions, if required, in the installation script. Note – After the installation ...

Chapter 2 Installing the Adapter 17 Example 2: All Requirements Met on Solaris 9 x86 Systems Following is an example of an installation script output if the driver and patchrequirements are met on Solaris 9 x86 systems: *** Checking for correct version of GigaSwift Ethernet Driver Packages... *** Ch...

18 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Example 3: Updates Required The following is an example of an installation script output, if the packages arefound and need updating by patching. Note – The following two examples are from a SPARC system. The line, “GigaSw...

20 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Example 4: Packages Missing Following is an example of an installation script output if the package(s) are notfound: CODE EXAMPLE 2-4 Script Output When Packages Are Not Found Product Installation 1 - Dual Gigabit Ethernet...

Chapter 2 Installing the Adapter 21 Verifying the Software Installation Unless you have the latest version of the driver software installed, the green LEDson the adapter will not go on. If you are using a SPARC system, be sure that youhave version 1.136 or later installed. Installation of <SUNWce...

22 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 ● Use the modinfo command to verify that you have the current driver (v1.136 or later) installed. If you type grep CE , using uppercase letters, you will get only the specific driver information: If you type grep ce , usin...

Chapter 2 Installing the Adapter 23 1. At the command line, use the grep command to search the /etc/path_to_inst file for ce interfaces. In the example above, the device instance is from a Sun GigaSwift Ethernet adapter.For clarity, the instance number is in bold italics. 2. Use the ifconfig command...

25 C H A P T E R 3 Network Configuration This chapter describes how to edit the network host files after the adapter has beeninstalled on your system. This chapter contains the following sections: ■ “Configuring the Network Host Files” on page 25 ■ “Setting Up a GigaSwift Ethernet Network on a Diskl...

26 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Use the ifconfig command to assign an IP address to the network interface. Type the following at the command line, replacing ip-address with the adapter ’s IPaddress: Refer to the ifconfig (1M) man page and the Solaris doc...

Chapter 3 Network Configuration 27 Setting Up a GigaSwift EthernetNetwork on a Diskless Client System Before you can boot and operate a diskless client system across a gigabit Ethernetnetwork, you must first install the GigaSwift Ethernet software packages into theroot directory of the diskless clie...

28 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 4. Eject the Sun GigaSwift Ethernet Driver CD from the CD-ROM drive. 5. Create a hostname.ce number file in the diskless client’s root directory. You will need to create an /export/root/ client-name /etc/hostname.ce number...

Chapter 3 Network Configuration 29 ▼ To Install the Solaris Operating System Over aGigaSwift Ethernet Network 1. Prepare the install server and client system to install the Solaris Operating System over the network. The Solaris Advanced Installation Guide describes how to create the install server a...

30 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 4. On the install server, install the GigaSwift Ethernet software to the client’s root directory, as determined in Step 2. Replace root-directory with the location of the client’s root directory. Note – If the commands abo...

Chapter 3 Network Configuration 31 8. At the ok prompt, boot the client system using the full device path of the Gigabit Ethernet device. The following examples show the options available: ■ Booting in autonegotiated mode: ■ Booting in autonegotiated verbose mode at 1000 Mbps half-duplex: Note – lin...

32 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 10. After installing the Solaris Operating System, install the Sun GigaSwift Ethernet software on the client system. The software installed in Step 4 was required to boot the client system over theGigaSwift Ethernet interf...

Chapter 3 Network Configuration 33 the device and its link partner. Attempting to link-up with autonegotiation disabledrequires knowledge of the current capabilities at which both the device and its linkpartner are configured. The structure of the boot net command line that includes device parameter...

Chapter 3 Network Configuration 35 Note – The link partner must be configured as link-clock slave. To attempt to autonegotiate the link while advertising 1000 Mbps full- and half-duplex, and link-clock auto capability to the link partner: Note – Link partner must autonegotiate in order to link-up at...

37 C H A P T E R 4 Configuring Driver Parameters This chapter describes how to configure the driver parameters used by the SunGigaSwift Ethernet adapter. This chapter contains the following sections: ■ “GigaSwift Ethernet Driver Parameter Values and Definitions” on page 38 ■ “Setting ce Driver Param...

40 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Note – If a parameter ’s initial setting is 0, it cannot be changed. If you try to change the setting, it will revert back to 0. If all these parameters are set to 1, autonegotiation uses the highest speed possible. Ifall ...

Chapter 4 Configuring Driver Parameters 41 Gigabit Link Clock Mastership Controls The concept of link clock mastership was introduced with gigabit twisted-pairtechnology. One side of the link is the master that provides the link clock and theother side is the slave that uses the link clock. Once thi...

Chapter 4 Configuring Driver Parameters 43 Interrupt Parameters TABLE 4-7 describes the receive interrupt blanking values. Random Early Drop Parameters TABLE 4-8 describes the RX random early detection 8-bit vectors, which allow you to enable random early drop (RED) thresholds. When received packets...

Chapter 4 Configuring Driver Parameters 45 Jumbo Frames The variable accept-jumbo enables the driver to instruct the upper layers that the driver is operating in Jumbo-frame mode. Note – Jumbo-frame mode is not supported in systems running Solaris 9 x86 software. In the Solaris 8 Operating System, a...

46 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Refer to the documentation that came with your switch for exact commands toconfigure jumbo frames support. Jumbo Frames With Trunking 1.3 When using jumbo frames with Trunking 1.3, you must explicitly enable jumboframes on...

Chapter 4 Configuring Driver Parameters 47 To set parameters so they remain in effect after you reboot the system, create a /platform/sun4u/kernel/drv/ce.conf file and add parameter values to this file when you need to set a particular parameter for a device in the system. Setting Parameters Using t...

48 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 In noninteractive mode, you invoke the utility to execute a specific command. Oncethe command is executed, you exit the utility. In interactive mode, you can use theutility to get or set more than one parameter value. Refe...

Chapter 4 Configuring Driver Parameters 49 ● To list all the parameters supported by the ce driver, type ? . See TABLE 4-1 through TABLE 4-12 for parameter descriptions. Setting the Autonegotiation Mode By default, autonegotiation is set to on . This means that the adapter communicates with its link...

50 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 ▼ To Disable Autonegotiation Mode If your network equipment does not support autonegotiation, or if you want tospecify your network speed, you can set autonegotiation to off on the ce device. Note – Disabling autonegotiati...

Chapter 4 Configuring Driver Parameters 51 Note – Configuring the parameters by putting ndd commands in rcX.d scripts is not supported. 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.conf file. ● To acc...

52 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 ■ The path name before the last component is the parent name. ■ The number after the final @ character within quotes is the unit-address. To identify a PCI device unambiguously in the ce.conf file, use the name, parent nam...

Chapter 4 Configuring Driver Parameters 53 Then you had to get the link status: Starting in the Solaris 9 Operating System, this method of determining the linkstatus is discouraged, and in some cases, it is removed completely as a driverfeature. The new improved approach moves all read-only paramete...

54 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 GigaSwift Ethernet Driver OperatingStatistics These statistics are part of the statistics presented by the netstat -k command. TABLE 4-11 describes the read-only Media Independent Interface (MII) capabilities. These parame...

Chapter 4 Configuring Driver Parameters 55 Reporting the Link Partner Capabilities TABLE 4-12 describes the read-only link partner capabilities. cap_10hdx Local interface half-duplex capability0 = Not 10 Mbit/sec half-duplex capable1 = 10 Mbit/sec half-duplex capable cap_asm_pause Local interface fl...

58 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 ▼ To Check Link Partner Settings ● If you are running the Solaris 8 Operating System, type the netstat -k command as superuser: ● If you are running the Solaris 9 Operating System, type the kstat command as superuser: # ne...

Chapter 4 Configuring Driver Parameters 61 ▼ To Discover Link Partner Capabilities ● Use the kstat command to discover link partner capabilities. tx_dma_hdr_bind_fail 0 tx_dma_pld_bind_fail 0 tx_dvma_pkts 0 tx_hdr_pkts 0 tx_inits 0 tx_max_desc 0 tx_max_pend 0 tx_msgdup_fail 0 tx_no_desc 0 tx_nocanpu...

62 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 ▼ To Discover Link Settings ● Use the kstat command to discover link settings. Configuration Checking The jumbo frame configuration checking occurs at Layer 2 or Layer 3, depending onthe configuration method. Layer 2 Confi...

63 C H A P T E R 5 Configuring VLANs This chapter explains VLANs in detail and provides configuration instructions andexamples. VLANs: Virtual Local Area Networks (VLANs) are commonly used to split upgroups of network users into manageable broadcast domains, to create logicalsegmentation of workgrou...

66 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Configuring VLANs VLANs can be created according to various criteria, but each VLAN must beassigned a VLAN tag or VLAN ID (VID). The VID is a 12-bit identifier between 1and 4094 that identifies a unique VLAN. For each netw...

Chapter 5 Configuring VLANs 67 ▼ To Configure Static VLANs 1. Create one hostname6.ce number file for each VLAN that will be configured for each adapter on the server. Use the following naming format that includes both the VID and the physical pointof attachment (PPA): VLAN logical PPA = 1000 * VID ...

69 A P P E N D I X A Installing the Software Manually This appendix describes how to install the driver software manually. It contains thefollowing sections: ■ “Installing the Driver Software Manually” on page 69 ■ “Verifying Patches” on page 74 Installing the Driver Software Manually The Sun GigaSw...

Appendix A Installing the Software Manually 71 Note – If you intend to use VLAN, you must install VLAN packages when you install the software packages. 3. Determine if the ce and vlan drivers are installed on the system: ■ If you are using a Solaris SPARC system: ■ If you are using a Solaris x86 sys...

72 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 ■ If nothing is reported back on SUNWced or SUNWcedx , then proceed to Step 4 and select SUNWcea , SUNWceax , SUNWced.u , SUNWcedx.u , SUNWcedu , and SUNWcem (if present). ■ If nothing is reported back for SUNWvld or SUNWv...

Appendix A Installing the Software Manually 73 ■ If your system is running Solaris 9 x86 software type the following: A menu similar to the following displays: 5. Select the packages you want to install: ■ Press Return or type all to accept the default and install all packages (if neither the GigaSw...

74 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Verifying Patches Verify whether your system has the needed patches for your version of the SolarisOperating System to ensure that you do not need to add patches. Note – If patches meet the requirements, nothing needs to b...

Appendix A Installing the Software Manually 75 ■ To verify patches for the Solaris 8 Operating System, type the following: The patch version should be -24 or greater. ■ To verify patches for the Solaris 9 SPARC Operating System, type the following: The patch version should be -17 or greater. ■ To ve...

76 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 ■ If your system is running Solaris 9 x86 software type the following: ▼ To Install a Sun VLAN Utility Patch Note – The VLAN Utility is only supported in Solaris 8 and Solaris 9 software. 1. Determine the version of the So...

Appendix B Using the Sun GigaSwift Ethernet Driver in Solaris 9 x86 Operating Systems 81 ■ Energy Star® support Features Not Currently Supported The following features are not currently supported for the Sun GigaSwift Ethernet driver software in the Solaris 9 x86 Operating System. ■ Dynamic reconfig...

82 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 2. Insert the Sun GigaSwift Ethernet Adapter CD into a CD-ROM drive that is connected to your system. ■ If your system is running Sun Enterprise Volume Manager, it shouldautomatically mount the CD-ROM to the /cdrom/cdrom0 ...

Appendix B Using the Sun GigaSwift Ethernet Driver in Solaris 9 x86 Operating Systems 83 Note – After the installation script runs, you see a summary of the software package or patch that was installed. You can also find a log of the installation in /var/tmp . The log file information is displayed w...

84 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Installing the Software Manually ▼ To Install the Software Manually 1. Become superuser. 2. Insert the Sun GigaSwift Ethernet Adapter CD into a CD-ROM drive that is connected to your system. ■ If your system is running Sun...

86 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 3. Determine if the ce and vlan drivers are installed on the system: 4. Install the software packages by typing the following at the command line: A menu similar to the following displays: 5. Select the packages you want t...

Appendix B Using the Sun GigaSwift Ethernet Driver in Solaris 9 x86 Operating Systems 87 Verifying the Software Installation After you have run the automated installation script, check to be sure you have thecurrent version of the driver installed. ● Use the modinfo command to verify that you have t...

89 A P P E N D I X C Specifications This appendix lists the specifications for the Sun GigaSwift Ethernet adapter. Itcontains the following sections: ■ “Connectors” on page 89 ■ “Performance Specifications” on page 91 ■ “Physical Characteristics” on page 91 ■ “Power Requirements” on page 91 Connecto...

Appendix C Specifications 91 Performance Specifications Physical Characteristics Power Requirements TABLE C-3 Performance Sepcifications Feature Specification PCI clock 33/66 MHz max PCI data burst transfer rate up to 64-byte bursts PCI data/address width 32/64 -bit PCI modes Master/slave 1 GBit/s, ...

93 A P P E N D I X D Diagnostic Software andTroubleshooting Issues This appendix provides an overview of the SunVTS diagnostic application andinstructions for testing the adapter using the onboard FCode self-test. There is also asection outlining some common troubleshooting issues. This appendix con...

94 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Refer to the SunVTS documentation (listed in TABLE D-1 ) for instructions on how to run and monitor the nettest diagnostic. These SunVTS documents are available on the Solaris on Sun Hardware Collection, which is provided ...

Appendix D Diagnostic Software and Troubleshooting Issues 95 Using the OpenBoot PROM FCode Self-Test The Sun GigaSwift Ethernet adapter’s self-test verifies the correct operation of theadapter and identifies any hardware problems with the adapter. The self-test is asuite of tests that reside in the ...

96 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 3. At the ok prompt, set the auto-boot? configuration variable to false. 4. Set the diag-switch? parameter to true in order to see the diagnostic power-on self-test (POST) messages. 5. Reset the system to activate these pa...

98 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 8. After testing the adapter, type the following commands to return the OpenBoot PROM to the standard operating mode. 9. At the ok prompt, reset the auto-boot? configuration variable to true. 10. Reset and reboot the syste...

Appendix D Diagnostic Software and Troubleshooting Issues 99 The following procedure describes how to turn autonegotiation off for oneSunSwitch port. 1. Establish a connection to the switch using either a serial connection or a Telnet connection. Refer to the SunSwitch 1.1 Installation and Configura...

100 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 ▼ To Set Autonegotiation to off for Other Noncompliant Network Equipment If your network equipment does not support autonegotiation, you can setautonegotiation to off on the GigaSwift Ethernet ( ce ) device. 1. Set the fo...

Appendix D Diagnostic Software and Troubleshooting Issues 101 Nonspecific Issues TABLE D-2 describes the problems you may encounter in using the GigaSwift Ethernet adapter as well as a solution for them: TABLE D-2 Troubleshooting the GigaSwift Ethernet Adapter Problem Description Solution prtdiag do...

102 Sun GigaSwift Ethernet Adapter Installation and User’s Guide • August 2004 Problem With DR Attach on SunEnterprise Platforms DR attach does not configure ce interfaces on Sun Enterprise 10000 platforms running the Solaris 2.6 Operating System. To add DR support for ce interfaces onsuch systems, ...

103 Index SYMBOLS /etc/hostname.cenumber file, 23, 26 A assigning an IP address, 23, 26autonegotiation setting disabling, 49 C ce driver parameter, status, and descriptions, 38configuring device driver parameters, 37configuring the driver parameters, 37configuring the network host files, 22, 25confi...