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.

GLOBAL OPTIONS

help

Displays command usage and additional help about the command.

usage

Returns a summary of the subcommands that are available for this command.

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