disk fail disk_name
disk reassign {-o old_name | -s old_sysid} [-n new_name] [-d new_sysid]
disk remove disk_name
disk sanitize start [-p pattern1[-p pattern2[-p pat_tern3]]] [-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 | -n | -v | -a ]
disk swap
disk unswap
disk upgrade_ownership
disk zero spares
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's 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, reconstructing, or extending a volume. After invoking the command, the vol status -s command can be used to verify the status of the spare disk zeroing.
The disk assign, disk upgrade_ownership, disk reassign, and disk show commands are used on systems with softwarebased disk ownership to assign, reassign, 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.
disk fail disk_name
removes the specified file system disk from the
RAID configuration, spinning the disk down when
removal is complete. disk fail is used to remove a
file system disk that may be logging excessive
errors and requires replacement.
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 spare disk at least as large as the disk being removed is available, the contents of the disk being removed will be reconstructed onto that spare disk.
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.
disk reassign {-o old_name | -s old_sysid}
[-n new_name] [-d new_sysid]
is 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
removes 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 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 sanitize start [-p pattern[-p pattern[-p pattern]]] [-c cycles] disk_list is 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. 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
is 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]
returns 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
starts 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
stops a RAID scrubbing operation.
disk unswap
undoes a disk swap command, cancels the swap operation
and continues service.
disk upgrade_ownership
is 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 show [ -o ownername | -s sysid | -n | -v | -a] is used to display information about the ownership of the disks. -o will list all disks owned by the filer with the name <ownername>. -s will list all disks owned by the filer with the serial number <sysid>. -n will list all unassigned disks. -v will list all disks. -a will list all assigned disks. Only used on systems with software-based disk ownership.
disk zero spares
zeroes all non-zeroed RAID spare disks.