Diagnostic Software

A P P E N D I X B

Diagnostic Software

This appendix provides an overview of the SunVTS diagnostic application and instructions for updating the SunVTS software to recognize the adapter. This appendix contains the following sections:

SunVTS Diagnostic Software

Updating SunVTS to Recognize the Adapter

Using the SunVTS netlbtest

SunVTS Diagnostic Software

The SunVTS software executes multiple diagnostic hardware tests from a single user interface and is used to verify the configuration and functionality of most hardware controllers and devices. The SunVTS software operates primarily from a graphical user interface, enabling test parameters to be set quickly and easily while a diagnostic test operation is being performed.

Note - SunVTS diagnostic software is not currently available for Solaris x86 Operating Systems.

The SunVTS nettest diagnostic can be used to test all of the networking interfaces on the system, including the interfaces on the adapter.

To use the nettest diagnostic, you must have the SunVTS software installed on your system. Refer to your Solaris documentation for installation instructions.

Refer to the SunVTS documentation (listed in TABLE B-1) for instructions on how to run and monitor the nettest diagnostic. These SunVTS documents are available online at the following URL:

http://www.sun.com/products-n-solutions/hardware/docs/Software /system_administration/tools/testing_valid/sunvts/index.html

Select the document for the Solaris release on your system.

TABLE B-1 SunVTS Documentation
Title	Description
SunVTS User’s Guide	Describes the SunVTS diagnostic environment
SunVTS Test Reference Manual	Describes each SunVTS test (including the `nettest`) and describes the various test options and command-line arguments
SunVTS Quick Reference	Provides an overview of the user interface

Updating SunVTS to Recognize the Adapter

Current versions of SunVTS do not recognize the Sun 10-Gigabit Ethernet PCI-X adapter. You will need to update the SunVTS configuration.

To Update SunVTS to Recognize the Adapter

1. Plug in a loopback cable.

2. Ensure that the SunVTS software and either the ixge (SPARC) OR ixgb (x86/x64) are installed on your system.

3. For SPARC platforms only, add the following lines to the /opt/SUNWvts/lib/conf/netlbtest.conf and /opt/SUNWvts/lib/conf/nettest.conf files:

ixge    ixge    10GbE

4. For x86 or x64 platforms only, add the following lines to the /opt/SUNWvts/lib/conf/netlbtest.conf and /opt/SUNWvts/lib/conf/nettest.conf files:

ixgb    ixgb    10GbE

Using the SunVTS `netlbtest`

You must have the Ethernet card and the device driver installed, a loopback connector in place, and Intervention mode enabled before running netlbtest. netlbtest cannot run if the network interface is connected to a live network, and requires that the Ethernet device be configured offline before running the test. Use the ifconfig(1M) command to bring the Ethernet device down before running netlbtest.

To Use the `netlbtest`

1. Ensure that the SunVTS software and the ixge driver are installed on your system.

2. Plug in a loopback cable.

3. For SPARC platforms only, unplumb the interface from the system, using the ifconfig command:

# ifconfig ixgeinstance down 
# ifconfig ixgeinstance unplumb

Where instance is the instance number of the interface.

Refer to SunVTS documentation for instructions on how to run netlbtest.

4. For x86 or x64 platforms only, unplumb the interface from the system, using the ifconfig command:

# ifconfig ixgbinstance down 
# ifconfig ixgbinstance unplumb