disk fail [-i] [-f] disk_name
disk maint start [-t test_list] [-c cycle_count] [-f] [-i] -d disk_list
disk maint abort disk_list
disk maint list
disk maint status [-v] [ disk_list]
disk reassign {-o old_name | -s old_sysid} [-n new_name] [-d new_sysid]
disk remove disk_name
disk replace start [-f] disk_name spare_disk_name
disk replace stop disk_name
disk sanitize start [-p pattern1|-r [-p pattern2|-r [-p pattern3|-r]]] [-c number_of_cycles] disk_list
disk sanitize abort disk_list
disk sanitize status [ disk_list]
disk sanitize release disk_list
disk scrub start
disk scrub stop
disk show [ -o ownername | -s sysid | -u | -n | -v | -a ]
disk swap
disk unswap
disk upgrade_ownership
disk zero spares
The disk scrub command causes the filer to scan disks for media errors. If a media error is found, the filer tries to fix it by reconstructing the data from parity and rewriting the data. Both commands report status messages when the operation is initiated and return completion status when an operation has completed.
The filer's ``hot swap'' capability allows removal or addition of disks to the system with minimal interruption to file system activity. Before you physically remove or add a SCSI disk, use the disk swap command to stall I/O activity. After you removed or added the disk, file system activity automatically continues. If you should type the disk swap command accidentally, or you choose not to swap a disk at this time, use disk unswap to cancel the swap operation and continue service.
If you want to remove or add a fibre channel disk, there is no need to enter the disk swap command.
Before you swap or remove a disk, it is a good idea to run syconfig -r to verify which disks are where.
The disk zero spares command zeroes out all non-zeroed RAID spare disks. The command runs in the background and can take much time to complete, possibly hours, depending on the number of disks to be zeroed and the capacity of each disk. Having zeroed spare disks available helps avoid delay in creating or extending an aggregate. Spare disks that are in the process of zeroing are still eligible for use as creation, extension, or reconsruct disks. After invoking the command, the aggr status -s command can be used to verify the status of the spare disk zeroing.
The disk assign, disk reassign, disk upgrade_ownership, and disk show commands are used on systems with softwarebased disk ownership to assign, reassign, upgrade ownership of, and display disks.
The disk sanitize start, disk sanitize abort, and disk sanitize status commands are used to start, abort, and obtain status of the disk sanitization process. This process runs in the background and sanitizes the disk by writing the entire disk with each of the defined patterns. The set of all pattern writes defines a cycle; both pattern and cycle count parameters can be specified by the user. Depending on the capacity of the disk and the number of patterns and cycles defined, this process can take several hours to complete. When the process has completed, the disk is in the sanitized state. The disk sanitize release command allows the user to return a sanitized disk to the spare pool.
The disk maint start, disk maint abort, and disk maint status commands are used to start, abort, and obtain status of the disk maintenance test process from the command line. This test process can be invoked by the user through this command or invoked automatically by the system when it encounters a disk that is returning non-fatal errors. The goal of disk maintenance is to either correct the errors or remove the disk from the system. The disk maintenance command executes either a set of predefined tests defined for the disk type or the user specified tests. Depending on the capacity of the disk and the number of tests and cycles defined, this process can take several hours to complete.
Used to assign ownership of a disk to the specified system. Only used on systems with software-based disk ownership. The disk_name or all or -n count option is required. The keyword all will cause all unassigned disks to be assigned. The -n count option will cause the number of unassigned disks specified by count to be assigned. The pool value can be either 0 or 1. If the disks are unowned and are being assigned to a non-local filer either the ownername and/or sysid parameters need to be specified to identify the filer. To make an owned disk unowned, use the `-s unowned' option. The -c option is only valid for Gateway Filers. It can be used to specify the checksum type for the LUN. The -f option needs to be specified if the filer already owns the disk.
disk fail [-i] [-f] disk_name
Force a file system disk to be failed. disk fail
is used to remove a file system disk that may be
logging excessive errors and requires replacement.
If disk fail is used without options, the disk will first be marked as ``prefailed''. If an appropriate spare is available, it will be selected for Rapid RAID Recovery. In that process, the prefailed disk will be copied to the spare. At the end of the copy process, the prefailed disk is removed from the RAID configuration. The filer will spin that disk down, so that it can be removed from the shelf. (disk swap must be used when physically removing SCSI disks.)
The disk being removed is marked as ``broken'', so that if it remains in the disk shelf, it will not be used by the filer as a spare disk. If the disk is moved to another filer, that filer will use it as a spare. This is not a recommended course of action, as the reason that the disk was failed may have been because it needed to be replaced.
Option -i can be used to avoid Rapid RAID Recovery and remove the disk from the RAID configuration immediately. Note that when a file system disk has been removed in this manner, the RAID group to which the disk belongs will enter degraded mode (meaning a disk is missing from the RAID group). If a suitable spare disk is available, the contents of the disk being removed will be reconstructed onto that spare disk.
If used without options, disk fail issues a warning and waits for confirmation before proceeding. Option -f can be used to skip the warning and force execution of the command without confirmation.
disk maint start
[-t test_list] [-c cycle_count] [-f] [-i] -d
disk_list
Used to start the Maintenance Center tests on the disks listed. The -t option defines the tests that are to be run. The available tests are displayed using the disk maint list command. If no tests are specified, the default set of tests for the particular disk type are run. The -c option specifies the number of cycles of the test set to run. The default is 1 cycle.
If a filesystem disk is selected and the -i option is not specified, the disk will first be marked as pending. If an appropriate spare is available, it will be selected for Rapid RAID Recovery. In that process, the disk will be copied to the spare. At the end of the copy process, the disk is removed from the RAID configuration and begins Maintenance Center testing. The -i option avoids Rapid RAID Recovery and removes the disk immediately from the RAID configuration to start Maintenance Center testing. Note that when a filesystem disk has been removed in this manner, the RAID group to which the disk belongs will enter degraded mode (meaning a disk is missing from the RAID group). If a suitable spare disk is available, the contents of the disk being removed will be reconstructed onto that spare disk.
If used without the -f option on filesystem disks, disk maint start issues a warning and waits for confirmation before proceeding. The -f option can be used to skip the warning and force execution of the command without confirmation.
The testing may be aborted with the disk maint abort command.
disk maint abort disk_list
Used to terminate the maintenance testing process for the specified disks. If the testing was started by the user, the disk will be returned to the spare pool provided that the tests have passed. If any tests have failed, the disk will be failed.
disk maint status [-v] [ disk_list]
Return the percent of the testing that has completed for either the specifed list of disks or for all of the testing disks. The -v option returns an expanded list of the test status.
disk maint list
List the tests that are available.
disk reassign {-o old_name | -s old_sysid}
[-n new_name]
[-d new_sysid]
Used to reassign all disks currently owned by the filer with ownername and/or sysid. This command would typically be used in Maintenance mode after the system id changes as a result of a nvram card swap. Only used on systems with software-based disk ownership.
disk remove disk_name
Remove the specified spare disk from the RAID configuration, spinning the disk down when removal is complete. You can use disk remove to remove a spare disk so that it can be used by another filer (as a replacement for a failed disk or to expand file system space).
disk replace start [-f] [-m] disk_name spare_disk_name
This command uses Rapid RAID Recovery to copy data from the specified file system disk to the specified spare disk. At the end of that process, roles of disks are reversed. The spare disk will replace the file system disk in the RAID group and the file system disk will become a spare. The option -f can be used to skip the confirmation. The option -m allows mixing disks with different characteristics. It allows using the target disk with rotational speed that does not match that of the majority of disks in the aggregate. It also allows using the target disk from the opposite spare pool.
disk replace stop disk_name
This command can be used to abort disk replace, or to prevent it if copying did not start.
disk sanitize start
[-p pattern|-r [-p pattern|-r [-p pattern|-r]]]
[-c cycles] disk_list
Used to start the sanitization process on the disks listed. The -p option defines the byte pattern(s) and the number of write passes in each cycle. The -r option may be used to generate a write of random data, instead of a defined byte pattern. If no patterns are specified, the default is 3 using pattern 0x55 on the first pass, 0xaa on the second, and 0x3c on the third. The -c option specifies the number of cycles of pattern writes. The default is 1 cycle.
All sanitization process information is written to the log file at /etc/sanitization.log. The serial numbers of all sanitized disks are written to /etc/sanitized_disks.
disk sanitize abort disk_list
Used to terminate the sanitization process for the specified disks. If the disk is in the format stage, the process will be aborted when the format is complete. A message will be displayed when the format is complete and when an abort is complete.
disk sanitize status [ disk_list]
Return the percent of the process that has completed for either the specifed list of disks or for all of the currently sanitizing disks.
disk sanitize release disk_list
Modifies the state of the disk(s) from sanitized to spare, and returns disk(s) to the spare pool.
disk scrub start
Start a RAID scrubbing operation on all RAID groups. The raid.scrub.enable option is ignored; scrubbing will be started regardless of the setting of that option (the option is applicable only to scrubbing that gets started periodically by the system).
disk scrub stop
Stop a RAID scrubbing operation.
disk show [ -o ownername | -s sysid | -n | -v | -a]
Used to display information about the ownership of the disks. -o lists all disks owned by the filer with the name <ownername>. -s lists all disks owned by the filer with the serial number <sysid>. -n lists all unassigned disks. -v lists all disks. -a lists all assigned disks. Only used on systems with software-based disk ownership.
disk swap
Applies to SCSI disks only. It stalls all I/O on the filer to allow a disk to be physically added or removed from a disk shelf. Typically, this command would be used to allow removal of a failed disk, or of a file system or spare disk that was prepared for removal using the disk fail or disk remove command. Once a disk is physically added or removed from a disk shelf, system I/O will automatically continue.
NOTE: It is important to issue the disk swap command only when you have a disk that you want to physically remove or add to a disk shelf, because all I/O will stall until a disk is added or removed from the shelf.
disk unswap
Undo a disk swap command, cancel the swap operation and continue service.
disk upgrade_ownership
Used to upgrade disks from the old ownership model to the new software-based disk ownership. Only available in Maintenance mode. Only used on systems with software-based disk ownership.
disk zero spares
Zero all non-zeroed RAID spare disks.