test

Sun Quad FastEthernet PCI Adapter Release Notes

Known Problems With the Installation and User's Guide

Configuring the Host Files

Note -

"Configuring the Host Files" on page 11 of the Sun Quad FastEthernet PCI Adapter Installation and User's Guide contains inaccurate qfe interface numbers and hostname.qfe<num> file names. The corrected section is shown below.

After installing the Sun Quad FastEthernet driver software, you must create a hostname.qfe<num> file for the adapter's Ethernet interfaces. You must also create both an IP address and a host name for its Ethernet interfaces in the /etc/hosts file.

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

    # 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 PCI Adapter installed in slot 2. For clarity, the instance numbers are bold.

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

    If you wanted to use all of the adapter interfaces in Step 1, you would need to create four files:

    Table 1-4 /etc/hostname.qfe<num> Files

    Filename 

    Instance Number 

    Adapter Ethernet Channel 

    /etc/hostname.qfe0

    0 

    0 

    /etc/hostname.qfe1

    1 

    1 

    /etc/hostname.qfe2

    2 

    2 

    /etc/hostname.qfe3

    3 

    3 

    Guidelines for hostname.qfe<num> Files:

    • Do not create /etc/hostname.qfe<num> files for Sun Quad FastEthernet PCI Adapter channels 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 and should be entered in the /etc/hosts file.

    • The host name should be different from any other host name of any other interface, for example: /etc/hostname.hme0 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 PCI Adapter (zardoz-11, zardoz-12, zardoz-13, and zardoz-14). 

    # cat /etc/hostname.hme0
zardoz
# cat /etc/hostname.qfe0
zardoz-11
# cat /etc/hostname.qfe1
zardoz-12
# cat /etc/hostname.qfe2
zardoz-13
# cat /etc/hostname.qfe3
zardoz-14

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

    Using the example in Step 1, 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-12
129.144.13.67 zardoz-13
129.144.14.30 zardoz-14

  4. Reboot your system.

Booting a Diskless Client System

Note -

This section should be appended to Chapter 3 of the Sun Quad FastEthernet PCI Adapter Installation and User's Guide.

In order to boot a diskless client with a local Sun Quad FastEthernet PCI Adapter interface (qfe), the following tasks must be performed on the boot server.

  1. Go to your client's root partition by typing the following: 

    # cd /export/root/<client name>/etc

  2. Search the name_to_major file for Quad FastEthernet (qfe) entries. 

    # grep qfe name_to_major

    If this file already has a Quad FastEthernet (qfe) entry, skip to Step 4.

  3. If the name_to_major file does not contain a Quad FastEthernet (qfe) entry, use a text editor to add an entry for the Sun Quad FastEthernet PCI Adapter device (qfe).

    If the major device number for the last file entry is n, use n+1 for the qfe channel major device number. As shown in the example below, if the last entry for the major device number is 108, use 109 for the qfe device. 

    . . .
llcl 107
audiocs 108
qfe 109

  4. Check the driver_aliases file for the pci_pci line required by the adapter. 

    # grep 'pci_pci "pci1011,25"' driver_aliases

    If this line already exists in the driver_aliases file, you can skip to Step 6. Otherwise, you will need to add this line to the file before installing the adapter.

  5. Using a text editor, add the following line to the end of the driver_aliases file. 

    pci_pci "pci1011,25"

  6. Check the driver_aliases file for the qfe line required by the adapter. 

    # grep 'qfe SUNW,qfe' driver_aliases

    If this line already exists in the driver_aliases file, you can skip to Step 8. Otherwise, you will need to add this line to the file before installing the adapter.

  7. Using a text editor, add the following line to the end of the driver_aliases file. 

    qfe SUNW,qfe

  8. Create the following symbolic link. 

    # ln -s <archive_of_arch>/devices/pseudo/clone@0:qfe <archive_of_arch>/dev/qfe

  9. Insert and mount the Sun Quad FastEthernet 2.1 CD-ROM.

    • If your system is running Volume Manager, it should automatically mount the CD-ROM to the /cdrom/sun_quadfast_2_1 directory.

    • If your system is not running Volume Manager, mount the CD-ROM as follows: 

      # mkdir -p /cdrom/sun_quadfast_2_1
# mount -F hsfs -r /dev/dsk/c0t6d0s2 /cdrom/sun_quadfast_2_1

  10. Copy the qfe driver from the CD-ROM to the client's root partition.

    In the steps below, replace DIR with the directory where the Solaris software is located on the client system.

    1. For Solaris 2.5.1 operating systems, type: 

      # cp /cdrom/sun_quadfast_2_1/Sol_2.5.1+/SUNWqfed/reloc/kernel/drv/qfe \ 
DIR/export/exec/kvm/<archive_of_arch>/kernel/drv

    2. For the Solaris 2.6 operating system, type: 

      # cp /cdrom/sun_quadfast_2_1/Sol_2.6/SUNWqfed/reloc/kernel/drv/qfe \ 
DIR/export/exec/kvm/<archive_of_arch>/kernel/drv

  11. Unmount and eject the CD-ROM as follows: 

    # cd /
# umount /cdrom
# eject cdrom

  12. Create a hostname.qfe<num> file for the client in the /etc directory of the client's root partition.

    See "Configuring the Host Files" for more information.

  13. Reboot your system.

Updating the Solaris Archive to Use the qfe Interface

Note -

This section should be appended to Chapter 3 of the Sun Quad FastEthernet PCI Adapter Installation and User's Guide.

This section is only applicable if you are installing the Solaris operating environment on a net-install client system over the Quad FastEthernet (qfe) interface.

Note -

The Solaris CD-ROM cannot be used to perform a net-install since it is a read-only medium. Therefore, the Solaris CD image archive is required so you can update certain software files.

  1. Determine the directory where the CD image is located on the boot server.

    For example, if the Solaris software is located within a directory named DIR, change to the /etc directory of the client's root partition by typing: 

    # cd DIR/export/exec/kvm/<archive_of_arch>/etc

  2. Search the name_to_major file for Quad FastEthernet (qfe) entries. 

    # grep qfe name_to_major
qfe 119

    If this file already has a Quad FastEthernet (qfe) entry, skip to Step 4.

  3. If the name_to_major file does not contain a FastEthernet (qfe) entry, use a text editor to add an entry for the Sun Quad FastEthernet PCI Adapter device (qfe).

    If the major device number for the last file entry is n then use n+1 for the qfe channel major device number. As shown in the example below, if the last entry for the major device number is 108, use 109 for the qfe device. 

    . . .
audiocs 108
qfe 109

  4. Check the driver_aliases file for the pci_pci line required by the adapter. 

    # grep 'pci_pci "pci1011,25"' driver_aliases

    If this line already exists in the driver_aliases file, you can skip to Step 6. Otherwise, you will need to add this line to the file before installing the adapter.

  5. Using a text editor, add the following line to the end of the driver_aliases file. 

    pci_pci "pci1011,25"

  6. Check the driver_aliases file for the qfe line required by the adapter. 

    # grep 'qfe SUNW,qfe' driver_aliases

    If this line already exists in the driver_aliases file, you can skip to Step 8. Otherwise, you will need to add this line to the file before installing the adapter.

  7. Using a text editor, add the following line to the end of the driver_aliases file. 

    qfe SUNW,qfe

  8. Create the following symbolic link. 

    # ln -s <archive_of_arch>/devices/pseudo/clone@0:qfe <archive_of_arch>/dev/qfe

  9. Insert and mount the Sun Quad FastEthernet 2.1 CD-ROM.

    • If your system is running Volume Manager, it should automatically mount the CD-ROM to the /cdrom/sun_quadfast_2_1 directory.

    • If your system is not running Volume Manager, mount the CD-ROM as follows: 

      # mkdir -p /cdrom/sun_quadfast_2_1
# mount -F hsfs -r /dev/dsk/c0t6d0s2 /cdrom/sun_quadfast_2_1

  10. Copy the qfe driver from the CD-ROM to the client's root partition.

    In the steps below, replace DIR with the directory where the Solaris CD image is located on the boot server system.

    1. For Solaris 2.5.1 operating systems, type: 

      # cp /cdrom/sun_quadfast_2_1/Sol_2.5.1+/SUNWqfed/reloc/kernel/drv/qfe \ 
DIR/export/exec/kvm/<archive_of_arch>/kernel/drv

    2. For the Solaris 2.6 operating system, type: 

      # cp /cdrom/sun_quadfast_2_1/Sol_2.6/SUNWqfed/reloc/kernel/drv/qfe \ 
DIR/export/exec/kvm/<archive_of_arch>/kernel/drv

  11. Unmount and eject the CD-ROM as follows: 

    # cd /
# umount /cdrom
# eject cdrom

  12. On the client system, perform the tasks listed in the section "Booting a Diskless Client System".

  13. Complete the Solaris client installation.

    Refer to your Solaris documentation for detailed instructions.

  14. Install the software drivers from the Sun Quad FastEthernet 2.1 CD-ROM.

    See the cd insert for more information.

  15. Reboot the system.