C H A P T E R

C H A P T E R 2

Installing and Configuring qfe Driver

This chapter includes information and instructions to install and configure the driver software used by the Sun Quad FastEthernet Device Driverdevice driver. Unless otherwise noted, all instructions apply to both the Sun Quad FastEthernet PCI adapter and the Sun Quad FastEthernet SBus adapter.

This chapter includes the following sections:

Installing the Driver Software

Configuring the Hostname File

Booting From the Network

Optional Post-Installation Procedures

Installing the Driver Software

The Solaris CD-ROM contains the software that must be installed in order to use the Sun Quad FastEthernet Device Driverdriver.

Note - Do not use the installation CD-ROM that shipped with your adapter. The software on the Solaris CD-ROM is more current and replaces previous versions of the driver.

Before using the SUNW,qfe device as your network interface, you will need to create and edit configuration files, as described in the next section.

Configuring the Hostname File

t To Configure the Hostname File

1. At the command line, use the grep command to search the /etc/path_to_inst file for qfe devices.

For a Sun Quad FastEthernet PCI adapter :

# grep qfe /etc/path_to_inst

"/pci@1f,2000/pci@2/SUNW,qfe@0,1" 0 "qfe" "/pci@1f,2000/pci@2/SUNW,qfe@1,1" 1 "qfe""/pci@1f,2000/pci@2/SUNW,qfe@2,1" 2 "qfe" "/pci@1f,2000/pci@2/SUNW,qfe@3,1" 3 "qfe"

In the example above, the four SUNW,qfe@x,1 instances are from a Sun Quad FastEthernet Device DriverPCI adapter installed in slot 2.

For a Sun Quad FastEthernet SBus adapter :

# grep qfe /etc/path_to_inst

"/sbus@1f,0 /SUNW,qfe@1,8c10000" 1 "qfe""/sbus@1f,0 /SUNW,qfe@1,8c00000" 0 "qfe""/sbus@1f,0 /SUNW,qfe@1,8c30000" 3 "qfe""/sbus@1f,0 /SUNW,qfe@1,8c20000" 2 "qfe"

In the example above, the four SUNW,qfe@1 instances are from a Sun Quad FastEthernet Device DriverSbus adapter installed in slot 1.

2. Create an /etc/hostname.qfe num file, where num is the instance number of each interface you plan to use.

If you want to use the network interface from the example in Step 1 , you will need to create four files:

File Name	Instance Number	Adapter Ethernet Network Interface
`/etc/hostname.qfe0`	0	0
/etc/hostname.qfe1	1	1
/etc/hostname.qfe2	2	2
/etc/hostname.qfe3	3	3

Do not create /etc/hostname.qfe num files for Sun Quad FastEthernet Device Driver network interfaces you plan to leave unused.
The /etc/hostname.qfe num file must contain the host name for the appropriate network interface.
The host name should have an IP address that will need to be entered in the
/etc/hosts file.
The host name should be different from the host name of any other interface, for example: /etc/hostname.qfe0 and /etc/hostname.qfe2 cannot share the same host name.

Using the instance examples in Step 1 , the following example shows the four
/etc/hostname.qfe num files required for a system called zardoz that has a Sun Quad FastEthernet Device Driver ( zardoz-11, zardoz-12, zardoz-13, and zardoz-14 ).

# cat /etc/hostname.qfe0zardoz# cat /etc/hostname.qfe0zardoz-11# cat /etc/hostname.qfe1zardoz-12# cat /etc/hostname.qfe2zardoz-13# cat /etc/hostname.qfe3zardoz-14

3. Create an appropriate entry in the /etc/hosts file for each active qfe network interface.

Using the previous example, you will have:

# 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-12129.144.13.67 zardoz-13129.144.14.30 zardoz-14

Note Note - The Internet Protocol, version 6 (IPv6), expands the capabilities of IPv4, which is the current version and the default. The Sun Quad FastEthernet Device Driverdevice driver included in this release of the Solaris operating environment supports both IPv4 and IPv6. IPv4 uses the /etc/hosts configuration file, but IPv6 uses a different configuration file. To transition to, manage, and implement IPv6, refer to the Solaris System Administration documentation.

4. Reboot your system.

Booting From the Network

To use a Sun Quad FastEthernet Device Driver interface as the boot device, perform the following tasks:

t To Boot From the Network

1. At the ok prompt type:

ok show-devs

The show-devs command lists the system devices. You should see the full path name of the qfe devices, similar to the following examples:

For Sun Quad FastEthernet PCI adapter:

/pci@1f,2000/pci@2/SUNW,qfe@0,1

/pci@1f,2000/pci@2/SUNW,qfe@1,1/pci@1f,2000/pci@2/SUNW,qfe@2,1/pci@1f,2000/pci@2/SUNW,qfe@3,1

For Sun Quad FastEthernet SBus adapter:

/sbus@1f,0 /SUNW,qfe@1,8c3000

/sbus@1f,0 /SUNW,qfe@1,8c2000/sbus@1f,0 /SUNW,qfe@1,8c1000/sbus@1f,0 /SUNW,qfe@1,8c0000

Note Note - Select only one of these qfe devices for booting.

2. At the ok prompt type:

ok boot full_path_name_of_the_qfe_device

For example:

ok boot /sbus@1f,0 /SUNW,qfe@1,8c3000

Optional Post-Installation Procedures

To customize the performance of the Sun Quad FastEthernet Device Driverdevice, perform the tasks in the following sections.

Setting Driver Parameters

The qfe device driver, which is loaded from the Solaris CD-ROM, controls the SUNW,qfe Ethernet devices. The device driver selects the link speed using the auto-negotiation protocol with the link partner. (See The Auto-Negotiation Protocol .)

You can manually set the qfe device driver parameters to customize each SUNW,qfe device in your system in one of three ways:

Set a parameter on a per-device basis by creating the qfe.conf file in the
/kernel/drv directory.

Use the ndd utility to temporarily change a parameter. This change is lost when you reboot the system.

Set the qfe driver parameters generally for all SUNW,qfe devices in the system by entering the parameter variables in the /etc/system file.

See Parameter Setting Options for more information.

Note Note - In the future, the /etc/system file will not be available. It is not compatible with dynamic reconfiguration.

t To Force Network Speed Between 10 Mbps and 100 Mbps

1. At the ok prompt, use the show-devs command to list the system devices.

You should see the full path names of the qfe devices, similar to the following examples:

For Sun Quad FastEthernet PCI adapter:

/pci@1f,2000/pci@2/SUNW,qfe@0,1

/pci@1f,2000/pci@2/SUNW,qfe@1,1

/pci@1f,2000/pci@2/SUNW,qfe@2,1

/pci@1f,2000/pci@2/SUNW,qfe@3,1

For Sun Quad FastEthernet SBus adapter:

/sbus@1f,0/SUNW,qfe@1,8c30000

/sbus@1f,0/SUNW,qfe@1,8c20000

/sbus@1f,0/SUNW,qfe@1,8c10000

/sbus@1f,0/SUNW,qfe@1,8c00000

2. Type:

ok nvedit

3. Type the following, pressing the Return key at the end of line 0:

0: probe-all install-console banner

1: apply transfer-speed=10 full_ path_name_of_a_qfe_device

Note Note - If you already have commands in NVRAM, append these lines to the end of the file.

4. Press Control-C after typing full_ path_name_of_a_ qfe _device .

Perform Steps 2 to 4 to set the network speed for each qfe network interface.

Note Note - In the preceding example, the speed is forced to 10 Mbps. To force the speed to 100 Mbps, replace 10 with 100.

5. At the ok prompt type:

ok nvstore

ok setenv use-nvramrc? true

6. Reboot your system.

See Setting Forced Mode for more information on forcing network speed.

local-mac-address Property

Each of the network interfaces of the Sun Quad FastEthernet Device Driver has been assigned a unique Media Access Control (MAC) address, which represents the 48-bit Ethernet address for that network interface. The OpenBoot trademark firmware reports this MAC address via the local-mac-address property in the device nodes corresponding to the network interfaces.

A system is not obligated to use this assigned MAC address if it has a systemwide MAC address. In such cases, the systemwide MAC address applies to all network interfaces on the system.

The device driver, or any other adapter utility, can use the network device's MAC address ( local-mac-address ) while configuring it. A network interface's MAC address can be used when booting over the network.

The mac-address property of the network device specifies the network address (systemwide or local-mac-address ) used for booting the system. To start using the MAC addresses assigned to the network interfaces of the Sun Quad FastEthernet Device Driver, set the NVRAM configuration variable local-mac-address? to true.

ok setenv local-mac-address? true

To Avoid Losing TCP/IP Parameter Changes

Add the parameter change to a run control script in the /etc/rc2.d directory, similar to the following example

#!/sbin/sh# Local kernel modifications#case "$1" in'start')	echo "Setting local kernel parameters...\c"	ndd -set /dev/tcp tcp_rexmit_interval_max 60000	echo ""	;;'stop')	echo "No kernel parameters changed."	;;*)	echo "Usage: $0 {start|stop}"	;;esacexit 0