topology ‑download

Saves the topology configuration information and related logs to the designated location.

SYNOPSIS

topology ‑download 
   ‑topoMap topomap‑file‑name

   [{‑sessionKey | ‑u admin‑user ‑oracleFS oracle‑fs‑system}]
   [{‑outputformat | ‑o} { text | xml }]
   [{‑timeout timeout‑in‑seconds | ‑verify | ‑usage | ‑example | ‑help}]

DESCRIPTION

The topology configuration is stored in an internal database, along with other related log files. The database, which is located on the master Controller, stores the current topology and up to three previous topology states. Use the topology ‑download command to download and to save the information to a file and a location of your choice. The file format is human-readable ASCII text. The output can be specified by full path and file name or just file name. If only a file name is specified, the file is saved to the FSCLI directory.

If problems occur during the file creation, the system creates a second file that lists the errors that are associated with the download. The file name will be the same as the db-logs-file-name value with Errors- prepended to that name. If a path is specified for the db-logs-file-name, the errors file is placed in that path. If a path is not specified, the errors file is placed in the FSCLI directory with the db-logs-file-name.

Note: Only administrators with primary administrator, admin1, admin2, or support roles are authorized to run this command.

OPTIONS

‑topoMap: Returns the topology configuration information that is stored in an internal database. The database, which is located on the master Controller, stores the current topology and up to three previous topology states. The database also stores all of the issues that are related to the hardware components (including the cabling) and all of the automated actions that were taken to resolve those issues.
Note: In cases where a topology change is at a very low level , the configuration information that is returned for one topology state can appear to be identical to another topology state.

The system empties and re-initializes the internal topology database when the master Controller is restarted or when a new master Controller is selected.

EXAMPLE

Task

To assist with a topology evaluation, Oracle Customer Support instructs you to download health and status information for the components that comprise the Backend SAS Interconnect.

Parameters

None

$ fscli topology ‑download ‑topoMap topology0905.txt