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, repair corrupted metadata without any interference from client activity.

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 no new files can be opened or created while in this state.

You would put the cluster in this state to produce a metadata consistent LUN-based backup, which is faster and less disruptive than a fully quiescent backup. The user data is not necessarily consistent, so the application must either be able to tolerate inconsistent data or perform its own recovery.

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 quiescent state.

Parent topic: Administrative commands

Related tasks
Backing up using the LUN method
Changing active cluster states

Related reference
chadvclusterconfig
chclusterconfig
resumecluster
startcluster
statcluster
stopcluster
upgradecluster

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2