startmetadatacheck

Starts the utility that performs a consistency check on the metadata for the entire system or a set of filesets, generates messages in the cluster log, and optionally repairs inconsistencies in the metadata.

Read syntax diagramSkip visual syntax diagram
>>-startmetadatacheck--+--------+--+---------+--+----------+---->
                       +- -?----+  '- -quiet-'  '- -repair-'
                       +- -h----+
                       '- -help-'

>--+------------------------+--+---------------------+---------->
   '- -scope--+-all-------+-'  '- -type--+-all-----+-'
              +-content---+              +-fileset-+
              '-structure-'              '-system--'

>--+-----------------------------+-----------------------------><
   |            .-,------------. |
   |            V              | |
   '- -fileset----fileset_name-+-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–quiet
Turns off confirmation message for this command.
–repair
Repairs inconsistencies in the metadata and reports the changes in the cluster log. If not specified, repairs are not made.
Note: In some cases, manual intervention might be needed to repair the metadata that requires you to take the cluster offline.
–scope all | content | structure
Specifies the scope of the metadata check. You can specify one of the following values:
all
Checks both the metadata content and structure. This is the default value.
content
Checks only the metadata content.
structure
Checks only the metadata structure.
–type all | fileset | system
Specifies the type of metadata to check. You can specify one of the following values:
all
Checks both the system and fileset metadata. This is the default value.
fileset
Checks only the fileset metadata.
system
Checks only the system metadata.
–fileset fileset_name
Specifies the names of one or more filesets to check, separated by a comma but no spaces. (Do not include a space after the comma.) If not specified, all filesets are checked.
Note: You must specify the –type fileset parameter with this parameter to perform a check on a limited set of filesets. You cannot use this parameter with the –type all or –type system parameters.

Prerequisites

You must have Administrator privileges to use all parameters in this command. Users with Backup privileges are not allowed to use the –repair parameter.

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

This command is useful when you suspect inconsistencies in the metadata or after a major restoration of the system.

The metadata checker validates metadata and, if the –repair parameter is specified, it also repairs inconsistencies. Check the messages that it generates in the cluster log to determine if there has been a loss of data. You might need to recover lost data from backup or recreate it by reissuing administrative commands.

The metadata checker prints an informational message in the cluster log when it starts and completes, and for each fileset that it processes. It also prints an error or severe message for each problem that it encounters. When the –repair parameter is specified, it also prints an error message as it repairs inconsistencies. The command line interface issues either a successful repair or integrity lost message, which indicates that the repair was not successful. Even with a report of a successful repair, you should check the log messages because data recovery or issuing administrative commands might still be necessary.

Note: The metadata checker places lost objects in the lost+found directory.
Note: When the metadata checker repairs an object in a FlashCopy® image, the image is placed in an incomplete state.
Note: The metadata checker uses space temporarily in each fileset.

Example

Check the system-metadata structure The following example checks the system-metadata structure and makes necessary repairs:
sfscli> startmetadatacheck -repair -scope structure -type system
Are you sure you want to start a metadata check process? [y/n] Y

Parent topic: Administrative commands

Related reference
builddrscript
lsdrfile
mkdrfile
rmdrfile
stopmetadatacheck

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.