drive_group

Manages the groups of drives that are configured to function together as a unit in the Drive Enclosures.

SYNOPSIS

drive_group { [ ‑acceptMisplacedDriveGroups | ‑delete | ‑forceDrivesOnline | ‑list | ‑modify | ‑restoreDriveGroup | ‑setPersistence | ‑verifyDataConsistency | ‑zeroUnallocatedSpace ] | [ | ‑usage | ‑help ] }

DESCRIPTION

When you physically add a new Drive Enclosure to the Oracle FS System, the system creates one or more drive groups. A new drive group can also be created when a set of drives is added to a Drive Enclosure that is partially populated. The Oracle FS System uses the following guidelines to determine whether to create a drive group from a group of new drives:

If the number of newly added drives reaches or exceeds the number that is required to create a drive group, the Oracle FS System automatically creates a drive group. The system marks the drives that are not included in the new drive group as NOT_USED.
If the number of the newly added drives is less than the number that is required to create a drive group, the Oracle FS System marks all of the new drives as NOT_USED.

Important! The spare drives that are NOT_USED are available to all of the drive groups in the Drive Enclosure. When one of the drives in a drive group is marked as CRITICAL, WARNING, or MISSING, the Oracle FS System places the drive group in a conservative mode. While the drive group is operating in a conservative mode, the Oracle FS System rebuilds the data that was stored on the FAULTED drive onto a drive that is marked as NOT_USED. During the rebuilding process, expect reduced performance and increased latency when accessing the data that is stored on the drive group. When the faulted drive is replaced, and the drive group recovery processes have completed, the drive that was previously allocated as a spare becomes part of the drive group. The Oracle FS System marks the replaced drive as NOT_USED.

When the Oracle FS System creates a new drive group, the system performs the following actions to prepare the drive group for provisioning:

The Oracle FS System assigns a fully qualified name (FQN) and a unique identifier (ID) to the drive group.
The system associates the physical slot numbers to the drives in the drive group. In the drive group, drives are referenced by slot numbers.

In addition to displaying configuration and status information, the drive_group command also performs the following recovery and maintenance operations:

Reassigns the persistence volume to another drive group
Brings replacement drives online
Restores a drive group that is running in conservative mode because one or more drives in the group are incorrectly marked as CRITICAL, WARNING, or MISSING
Verifies the consistency of the data that is stored on the drive group
Excludes the drive group from the assigned Storage Domain
Assigns the drive group to another Storage Domain
Removes the drive group from the Oracle FS System to prepare the system for physically removing the Drive Enclosure from the system

SUBCOMMANDS

‑acceptMisplacedDriveGroups: Accepts one or more drive groups that are misplaced.
‑delete: Removes one or more drive groups from the Oracle FS System.
‑forceDrivesOnline: Forces replaced drives online and forces the drives that were incorrectly marked as CRITICAL, WARNING, or MISSING to return to a NORMAL operational state.
‑list: Returns information about the drive groups, and, optionally, returns the health and status of each of the drives in the drive groups.
‑modify: Includes or excludes a drive group from a Storage Domain.
‑restoreDriveGroup: Brings online a drive group that is currently offline.
‑setPersistence: Designates a drive group to store the persistence data that is managed by the Controller.
‑verifyDataConsistency: Performs a data consistency check on the drive group.
‑zeroUnallocatedSpace: Forces a re-zeroing of all unallocated space on the specified drive group.

GLOBAL OPTIONS

‑help: Displays command usage and additional help about the command.
‑usage: Returns a summary of the subcommands that are available for this command.

EXAMPLE

Task

Display a list of drive groups with details about the drives that are in the drive group.

Parameters

None

$ fscli drive_group ‑list ‑details