logo

Manual Pages


Table of Contents

NAME

fctest - test Fibre Channel environment

SYNOPSIS

fctest [ adapter ]

DESCRIPTION

Use the fctest command to test Fibre Channel adapters and disks on an appliance. This command provides a report of the integrity of your Fibre Channel environment. It is only available in maintenance mode, and takes about 5 minutes to complete.

If the adapter argument is missing, all Fibre Channel adapters and disks in the system are tested, otherwise only the specified adapter, and disks attached to it, are tested.

When finished, fctest prints out a report of the following values for each Fibre Channel adapter tested:

1. Number of times loss of synchronization was detected in that adapter's Fibre Channel loop.

2. Number of CRC errors found in Fibre Channel packets.

3. The total number of inbound and outbound frames seen by the adapter.

4. A "confidence factor" on a scale from 0 to 1 that indicates the health of your Fibre Channel system as computed by the test. A value of 1 indicates that no significant errors were found. Any value less than 1 indicates there are problems in the Fibre Channel loop that are likely to intefere with the normal operation of your appliance. For more information see the Easy Installation Instructions for your specific filer or your Fibre Channel Storage Shelf Guide.

If the confidence factor is reported as less than 1, please go through the troubleshooting checklist for Fibre Channel loop problems in the document "Easy Installation Instructions for Netapp Filers" and re-run the fctest command after making any suggested modifications to your Fibre Channel setup. If the problem persists, please call your Customer Support telephone number.

The actual arithmetic that is used to compute the confidence factor is as follows:

The number of Fibre Channel frame errors is obtained by adding the number of CRC and Synchronization errors, with each sync error weighted ten times as much as a CRC error. The number of errors is then divided by the total number of Fibre Channel frames (inbound + outbound). The quotient is subtracted from 1 to get the final answer.

C = 1 - (Crc + 10Sync)/F,

where C = the confidence factor, representing the integrity of your FC system.

Crc = number of CRC errors observed in the Fibre Channel frames.

Sync = number of Fibre Channel synchronization errors.

F = the total number of inbound and outbound frames seen by the adapter.

CLUSTER CONSIDERATIONS

In a clustered configuration, only disks on a filer's primary loop (the A loop) are tested.


Table of Contents