Chapter 18 Sun GigabitEthernet Test (gemtest)

The gemtest provides functional test coverage of the Sun GigabitEthernet SBus and PCI bus Adapters. It runs in loopback (external/internal) mode and must be selected mutually exclusive with the nettest. The gemtest provides better fault isolation as compared to nettest.

No network configuration is necessary, however, you must have the GigabitEthernet card and the ge device driver installed and a loopback connector in place before running gemtest.

The gemtest uses DLPI RAW mode to talk to the device driver. For the purpose of this test, a packet is defined as an Ethernet header followed by the Ethernet data payload (refer to IEEE 802.3z). The test generates and sends out the desired number of packets (a tunable parameter) and expects to receive the same number of packets through the loopback interface, external or internal. If an error occurs (for example, packet mismatch or timeout), an error message indicating the type of error, its probable cause(s) and recommended action(s) is displayed on the SunVTS console.The data sent out is generated by a random number generator, and put into a data buffer. Each time the packet sent is selected from a different starting point of the data buffer, so that any two consecutively transmitted packets will not be the same.

---

Note -

Do NOT run nettest and gemtest at the same time.

---

---

Note -

To run gemtest, you must have a loopback connector connected to the Sun GigabitEthernet card. gemtest cannot run if the network interface is connected to a live network, however the link must be up. A loopback connector provides the network interface driver the necessary link for testing, while maintaining isolation from a live network. The loopback connector is required for both the internal and external tests.

---

gemtest Options

Figure 18-1 gemtest Option Menu

Refer to Table 18-1 for test parameter descriptions.

Table 18-1 gemtest Options

gemtest Options	Description
Configuration	Specifies the Port Address, Host ID and Domain Name of the system under test.
Total Packets	Specifies the total number of the packets to send.The default number of packet is 1000.
Packet size	Determines the size (in bytes) of the packets to betransmitted. 60 <= packet size <= 1514. The default packet size is 1000 bytes
Loopback	Determines the external and internal loopback mode. The default setting is internal loopback mode.
Print_Warning	Enables or disable the printing of warningmessages. The default setting is Disable
Processor Affinity	Binds the test to a specific processor. If no processor is specified, the test migrates between processors. This option is only available on multiprocessor systems.

gemtest Test Modes

The gemtest can only be run in Functional test mode. It is assumed that the host is not connected to the network through the intended test device(s).

gemtest Command Line Syntax

/opt/SUNWvts/bin/gemtest standard_arguments -o dev=device,tpkts=n,pksz=pkt_size,lb=Internal ,warn=Disable

Table 18-2 gemtest Command Line Syntax

Argument	Explanation
dev=device_name	Specifies the device to test such as ge0
tpkts=n	[1..100000], count of packets to loopback
pksz=pkt_size	[60 ... 1514], packet size in bytes
lb=Internal	select internal (or external) loopback mode
warn=Disable	enable or disable printing of warning messages

---

Note -

64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to "32-Bit and 64-Bit Tests".

---

gemtest Error Messages

Table 18-3 gemtest Error Messages

	Error Message	Probable Cause(s)	Recommended Action
6000	Timed out for receiving pkt number	Card and/or driver not configured properly.	Configure driver or reseat card. Check loopback connector. If the problem persists, contact your authorized Sun service Provider.
6001	system error	System may have run out of memory.	Reduce the number of processes currently running or increase system memory.
6002	Data mismatch between transmitted and received pkt data	Link loss,CRC error,Alignment Error.	If the frequency of errors is large, replace the card and/or contact your authorized Sun service Provider.
8000	errmsg for device	Card not present	Check for card.
8001	Memory allocation failure	System ran out of memory.	Reduce the number of processes currently running. Increase system memory.
8002	No card found	No card found.	Install card.
8003	Failed to get the link up	Loopback connector not connected.	Faulty loopback connector. Check it an replace it if necessary. If problem persists, contact your authorized Sun service Provider
8004	Transmit failed error	STREAMS was unable to accept more data, perhaps due to insufficient STREAMS memory resources.	Reduce the system load.
8005	Receive failed, error for pkt number		Try again, if the problem persists, then it is a system error. Contact your authorized Sun service provider.
8006	DLPI error for device string	Wrong Instance number X specified in geX	Specify correct instance number.