Using the upload Command

Related Topics

Use this command and its parameters to upload the following information from the storage subsystem to your storage management station:

For more information about Read Link Status statistics, saving a storage subsystem configuration, monitoring performance, or viewing events, see the Subsystem Management Window online help.

If you want to...

Use this command and parameters

upload a file containing Read Link Status statistics from the storage subsystem to the storage management station

Back to the top

Base Command and Required Parameters

Back to the top

upload storagesubsystem file=<"filename"> content=RLSCounts

where:

<"filename"> = is a valid filename, enclosed in double quotes

Important:

  • Double quotes are required to surround the filename.
  • The data is saved in a comma-delimited text file, regardless of the filename and extension used. For convenience, add the .csv extension (comma separated values format). Many popular spreadsheet packages open a file with a .csv extension and automatically place the data correctly into spreadsheet rows and columns without requiring additional user input.

Example

Back to the top

Command statement:

upload storagesubsystem file="rls.csv" content=RLSCounts

Execution results:

  • Read link status data is uploaded from the storage subsystem and placed in a comma-delimited text file, rls.csv, on the storage management station.
  • The data is displayed in drive channel, loop index order. For an explanation of the data and how to interpret it, see the Subsystem Management Window online help.

Note: To reset a Read Link Status baseline, you can use the set storagesubsystem RLSBaseline=currentTime command. See Using the set Command.

upload a file containing storage subsystem configuration data from the storage subsystem to the storage management station

Back to the top

Base Command and Required Parameters

Back to the top

upload storagesubsystem file=<"filename"> content=configuration

where:

<"filename"> = is a valid filename, enclosed in double quotes

Important:

  • Double quotes are required to surround the filename.
  • The resulting file is a script file that can be loaded into the Script Editor to configure a storage subsystem with an identical hardware configuration. For more information, see Loading a Storage Subsystem Configuration.
  • The Load Configuration option can filter on files with a .cfg extension. For convenience, you may want to use the .cfg filename extension.

Caution: Do not use this option if the storage subsystem is undergoing an operation that will change any logical configuration setting, such as:

  • Creating or deleting logical drives
  • Changing storage partition settings
  • Downloading controller firmware
  • Assigning or modifying global hot spares
  • Adding capacity (drives) to an array

Example

Back to the top

Command statement:

upload storagesubsystem file="kcconfig.cfg" content=configuration

Execution result: Storage Subsystem configuration data is uploaded from the storage subsystem and placed in a script file, kcconfig.cfg, on the storage management station.

upload a file containing storage subsystem performance data from the storage subsystem to the storage management station

Back to the top

Base Command and Required Parameters

Back to the top

upload storagesubsystem file=<"filename"> content=performanceStats

where:

<"filename"> = is a valid filename, enclosed in double quotes

Important:

  • Double quotes are required to surround the filename.
  • The data is saved in a comma-delimited text file, regardless of the filename and extension used. For convenience, add the .csv extension (comma separated values format). Many popular spreadsheet packages open a file with a .csv extension and automatically place the data correctly into spreadsheet rows and columns without requiring additional user input. You could also choose a .perf extension to distinguish performance data from other data files.
  • You can first use the set command to set the polling interval and number of capture iterations to save to the file. For more information, see Using the set Command.
    • The default polling interval of 10 seconds and one capture of data is used when you do not specify these parameters with the set command.
    • If you use the set command before the upload command in a script, the polling interval and number of iterations you specify remain in effect until you close the storage management software (end your session). Then, the default polling interval of 10 seconds and one iteration goes back into effect.
    • If you use the set command on the command line to specify a polling interval and the number of iterations, enter both the set command and the upload command in the same command string, separated by a semicolon and surrounded by quotes.
      • Command line example: -c "set performanceMonitor interval=5 iterations=5;upload storagesubsystem file="June10.csv" content=performanceStats;"

Examples

Back to the top

Command statement:

upload storagesubsystem file="June10.csv" content=performanceStats

Execution results:

  • Performance data is uploaded from the storage subsystem and placed in a comma-delimited text file, June10.csv, on the storage management station.
  • For an explanation of the data and how to interpret it, see the Subsystem Management Window online help.

Command statements:

set performanceMonitor interval=5 iterations=5;

upload storagesubsystem file="June10.csv" content=performanceStats;

Execution results:

  • Performance data is uploaded from the storage subsystem and placed in a comma-delimited text file, June10.csv, on the storage management station.
  • Data for each logical drive, each controller, and a total for both controllers is captured for five different five second intervals and displayed in the file.

upload a file containing all events from the storage subsystem to the storage management station

Back to the top

Base Command and Required Parameters

Back to the top

upload storagesubsystem file=<"filename"> content=allEvents

where:

<"filename"> = is a valid filename, enclosed in double quotes

Important:

  • Double quotes are required to surround the filename.
  • The data is saved in a comma-delimited text file, regardless of the filename and extension used. For convenience, add the .csv extension (comma separated values format). Many popular spreadsheet packages open a file with a .csv extension and automatically place the data correctly into spreadsheet rows and columns without requiring additional user input.

Example

Back to the top

Command statement:

upload storagesubsystem file="may16all.csv" content=allEvents

Execution results:

  • Event data is uploaded from the storage subsystem and placed in a comma-delimited text file, may16all.csv, on the storage management station.
  • The data is displayed in date/time order starting with the most recent event. For an explanation of the data and how to interpret it, see the Subsystem Management Window online help.

upload a file containing only critical events from the storage subsystem to the storage management station

Back to the top

Base Command and Required Parameters

Back to the top

upload storagesubsystem file=<"filename"> content=criticalEvents

where:

<"filename"> = is a valid filename, enclosed in double quotes

Important:

  • Double quotes are required to surround the filename.
  • The data is saved in a comma-delimited text file, regardless of the filename and extension used. For convenience, add the .csv extension (comma separated values format). Many popular spreadsheet packages open a file with a .csv extension and automatically place the data correctly into spreadsheet rows and columns without requiring additional user input.

Example

Back to the top

Command statement:

upload storagesubsystem file="may16critical.csv" content=criticalEvents

Execution results:

  • Read link status data is uploaded from the storage subsystem and placed in a comma-delimited text file, may16critical.csv, on the storage management station.
  • The data is displayed in date/time order starting with the most recent critical event. For an explanation of the data and how to interpret it, see the Subsystem Management Window online help.

upload a file containing controller state dump information from the storage subsystem to the storage management station

Back to the top

Base Command and Required Parameters

Back to the top

upload storagesubsystem file=<"filename"> content=stateDump

where:

<"filename"> = is a valid filename, enclosed in double quotes

Caution: This command can cause a storage subsystem to become unresponsive to both the host and the storage management station. Stop host application I/O to the storage subsystem before using this command.

Important: Double quotes are required to surround the filename.

Example

Back to the top

Command statement:

upload storagesubsystem file="may13.dmp" content=stateDump

Execution results:

  • Controller state data is uploaded from the storage subsystem and placed in a text file, may13.dmp, on the storage management station.
  • Technical Support will interpret the contents of this file and provide the appropriate diagnosis.

Related Topics

Using the set Command

Learn About the Script Editor

Using the Script Editor

Command Reference

Learn About the Command Line Interface

Using the Command Line Interface