cleardumps

Use the cleardumps command to clear (or delete) the various dump directories on a specified node or node canister.

Syntax

Read syntax diagramSkip visual syntax diagram cleardumps -prefix directory_or_file_filter nodecanister_name

Parameters

-prefix directory_or_file_filter
(Required) Specifies the directory, files, or both to be cleared. If a directory is specified, with no file filter, all relevant dump or log files in that directory are cleared. You can use the following directory arguments (filters):
  • /dumps (clears all files in all subdirectories)
  • /dumps/cimom
  • /dumps/cloud
  • /dumps/configs
  • /dumps/elogs
  • /dumps/feature
  • /dumps/iostats
  • /dumps/iotrace
  • /dumps/mdisk
  • /home/admin/upgrade
In addition to the directory, you can specify a filter file. For example, if you specify /dumps/elogs/*.txt, all files in the /dumps/elogs directory that end in .txt are cleared.
Note: The following rules apply to the use of wildcards when using the CLI:
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard.
  • With a wildcard, you must use double quotation marks (" ") around the filter entry, such as in the following entry:
    >cleardumps -prefix "/dumps/elogs/*.txt"
canister_id
(Optional) Specifies the canister to be cleared.

If you specify no canister to be cleared, the command executes on the configuration node rather than the canister whose ID is provided.

That optional parameter is just a number 1 or 2 (canister 1 or canister 2).

Description

This command deletes all the files that match the directory/file_filter argument on the specified node or node canister. If no node is specified, the configuration node is cleared.

You can clear all the dumps directories by specifying /dumps as the directory variable.

You can clear all the files in a single directory by specifying one of the directory variables.

You can list the contents of these directories on the given node or node canister by using the lsxxxxdumps commands.

You can use this command to clear specific files in a given directory by specifying a directory or file name. You can use the wildcard character as part of the file name.
Note: To preserve the configuration and trace files, any files that match the following wildcard patterns are not cleared:
  • *svc.config*
  • *.trc
  • *.trc.old

An invocation example

cleardumps -prefix /dumps/configs

The resulting output:

No feedback