topology

Monitors and performs diagnostics on the topology of the Backend SAS Interconnect of an Oracle FS System.

SYNOPSIS

topology { [‑download | ‑generateTraffic | ‑list | ‑modify ] | [ ‑usage | ‑help ] }

DESCRIPTION

The Controllers in the Oracle FS System are connected in a peer-to-peer clustered configuration. In the cluster, each Controller node connects to a partner Controller node and to Drive Enclosure strings. If there are three or less Drive Enclosures in a string, the Controller connects to the first Drive Enclosure and to the last Drive Enclosure in the string. If there are more than three Drive Enclosures in the string, the Controller connects to the first Drive Enclosure and the third Drive Enclosure in the string. The topology command monitors and performs diagnostics on the following components that make up the Backend SAS Interconnect topology:

The Serial Attached SCSI (SAS) connectors on the Drive Enclosures
The SAS HBA cards on the Controllers
The SAS ports on the SAS HBA cards
The SAS cabling

Note: The topology of the Backend SAS Interconnect changes when a Controller fails over to its partner. The system sends system alerts and issues events to notify you of these changes. You can also run the topology ‑list command or run the topology ‑download ‑topoMap command to monitor the changes that the system makes to the topology.

SUBCOMMANDS

‑download: Saves the topology configuration information and related logs to the designated location.
‑generateTraffic: Generates SAS messages from the specified Controller to the partner Controller and from the specified Controller to the Drive Enclosures. This command is used for testing purposes.
‑list: Returns the configuration information and statistics for the Backend SAS Interconnect and returns the results of any diagnostic tests that the system performed.
‑modify: Changes the operational state of the topology of the Backend SAS Interconnect.

EXAMPLE

Task

For diagnostic purposes, Oracle Customer Support instructs you to generate a burst of traffic from a Controller to the partner Controller and to all of the Drive Enclosures that are connected to the Controller.

Parameters

The fully qualified name of the Controller: /⁠CONTROLLER-01
The number of bytes to generate: 32

$ fscli topology ‑generateTraffic ‑controller /⁠CONTROLLER-01 ‑numberBytes 32