quiescecluster

Changes the state of all metadata servers in the cluster to one of three quiescent states.

Read syntax diagramSkip visual syntax diagram
>>-quiescecluster--+----------+-- –state--+-full----+--------><
                   +- –?----+             +-offline-+
                   +- –h----+             '-part----'
                   '- –help-'

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.
–state
Specifies the state to which you want to change the cluster. You can specify one of these states:
full
Changes the state to fully quiescent. This parameter flushes all client caches and long-running processes, resulting in no activity on the metadata servers.

You would put the cluster in this state to produce self-consistent LUN-based backups for a known FlashCopy® image.

offline
Changes the state to offline. This parameter terminates all current client sessions and prevents new client sessions from being started, but allows all metadata server I/O to continue. The offline state is intended to be used as an administrative mode to, for example, reassign a fileset to another metadata server.

You would put the cluster in this state to restrict clients from accessing the cluster.

part
Changes the state to partly quiescent. This parameter prevents new client sessions from starting. Open files are still accessible, but not new files can be opened or created while in this state.

You would put the cluster in this state to produce dirty LUN-based backups without requiring clients and applications to stop, and to allow client applications that use direct I/O (such as database servers) to back up their data.

Prerequisites

You must have Operator or Administrator privileges to use the command.

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

Description

The quiescent states restrict activity on all metadata servers in the cluster. You would put the metadata servers in this state in preparation for backup tasks that require the client sessions, file I/O, client metadata, or system metadata to be inactive.

You can use the resumecluster command to return all the metadata servers in the cluster to the online state.

Example

Change the cluster state The following example changes the cluster state to fully quiescent:
sfscli> quiescecluster -state full
Cluster successfully in fully quiescent state.

Parent topic: Administrative commands

Related reference
chadvclusterconfig
chclusterconfig
resumecluster
startcluster
statcluster
stopcluster
upgradecluster

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