Overview of the list dump commands CLI commands Attributes of the -filtervalue argument

You can use the list dumps command to return a list of dumps in the appropriate directory.

The dumps in the SAN Volume Controller are contained in the following directory structure:

Software upgrade packages are contained in the /home/admin/upgrade directory. These directories exist on every node in the cluster.

Configuration dump: Dumps contained in the /dumps/configs directory are dumps of the cluster configuration data. A configuration dump is created by using the svctask dumpconfig command. This will dump the configuration of the cluster, including all object details, to the /dumps/configs directory. If no filename prefix is supplied, the default config_ will be used. The full, default file name, will be config_NNNNNN_YYMMDD_HHMMSS (where NNNNNN is the node front panel name). If the command is used with the -prefix option, then the value entered for the -prefix will be used instead of config. The command to list all dumps in the /dumps/configs directory is svcinfo lsconfigdumps.

Error or event dump: Dumps contained in the /dumps/elogs directory are dumps of the contents of the error and event log at the time that the dump was taken. An error or event log dump is created by using the svctask dumperrlog command. This will dump the contents of the error or event log to the /dumps/elogs directory. If no filename prefix is supplied, the default errlog_ will be used. The full, default file name, will be errlog_NNNNNN_YYMMDD_HHMMSS (where NNNNNN is the node front panel name). If the command is used with the -prefix option, then the value entered for the -prefix will be used instead of errlog. The command to list all dumps in the /dumps/elogs directory is svcinfo lserrlogdumps.

Featurization log dump: Dumps contained in the /dumps/feature directory are dumps of the featurization log. A featurization log dump is created by using the svctask dumpinternallog command. This will dump the contents of the featurization log to the /dumps/feature directory to a file called feature.txt. Only one of these files exists, so every time the svctask dumpinternallog command is run, this file is overwritten. The command to list all dumps in the /dumps/feature directory is svcinfo lsfeaturedumps.

I/O statistics dump: Dumps contained in the /dumps/iostats directory are dumps of the I/O statistics for disks on the cluster. An I/O statistics dump is created by using the svctask startstats command. As part of this command, you can specify a time interval at which you want the statistics to be written to the file (the default is 15 minutes). Every time the time interval is encountered, the I/O statistics that have been collected this far are written to a file in the /dumps/iostats directory. The file names used for storing I/O statistics dumps are m_stats_NNNNNN_YYMMDD_HHMMSS, Nm_stats_NNNNNN_YYMMDD_HHMMSS, or v_stats_NNNNNN_YYMMDD_HHMMSS (where NNNNNN is the node front panel name), depending on if the statistics are for MDisks or VDisks. The command to list all dumps in the /dumps/iostats directory is svcinfo lsiostatsdumps.

I/O trace dump: Dumps contained in the /dumps/iotrace directory are dumps of I/O trace data. The type of data that is traced depends on the options specified by the svctask settrace command. The collection of the I/O trace data is started by using the svctask starttrace command. The I/O trace data collection is stopped when the svctask stoptrace command is used. It is when the trace is stopped that the data is written to the file. The file name will be <prefix>_NNNNNN_YYMMDD_HHMMSS (where NNNNNN is the node front panel name, and <prefix> is the value entered by the user for the -filename parameter in the svctask settrace command.) The command to list all dumps in the /dumps/iotrace directory is svcinfo lsiotracedumps.

Application abends dump: Dumps contained in the /dumps directory are dumps resulting from application abends. Such dumps will be written to the /dumps directory. The default file names are dump.NNNNNN.YYMMDD.HHMMSS (where NNNNNN is the node front panel name). In addition to the dump file, it is possible that there may be some trace files written to this directory. These will be named NNNNNN.trc.

The command to list all dumps in the /dumps directory is svcinfo lssvcdumps.

The final option available in the list dumps command series is the svcinfo lssoftwaredumps command. This command will list the contents of the /home/admin/upgrade directory. Any files in this directory will have been copied there at the time that you wanted to perform a software upgrade.

All of the list dumps commands can accept a node identifier as input. If this identifier is not specified then the list of files on the current configuration node will be displayed. If the node identifier is specified, then the list of files on that node will be displayed.

Because files can only be copied off of the current configuration node (using secure copy), you can issue the svctask cpdumps command to copy the files off of a non-configuration node to the current configuration node.

(C) Copyright International Business Machines Corporation 2003, 2004