Manual Pages
Table of Contents
na_disk - RAID disk configuration control commands
disk assign {<disk_name> | all | [-T <storage type>] -n
<count> | auto } [-p <pool>] [-o <ownername>] [-s
{<sysid>|unowned}] [-c {block|zoned}] [-f]
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 [-w] <disk_name>
disk replace start [-f] [-m] <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 fail command forces a file system disk to fail.
The disk reassign command is used in maintenance mode to
reassign disks after the nvram card has been swapped. The
disk remove command unloads a spare disk so that you can
physically remove the disk from the filer. The disk
replace command can be used to replace a file system disk
with a more appropriate spare disk.
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 and disk show commands are available only
on systems with software-based disk ownership, and are
used to assign, or display disk ownership.
The disk upgrade_ownership command is available only from
maintenance mode, and is used to change the disk ownership
model.
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.
disk assign {<disk_name> | all | [-T <storage type>] -n
<count> | auto }
[-p <pool>]
[-o <ownername>]
[-s {<sysid>|unowned}]
[-c {block|zoned}] [-f]
Used to assign ownership of a disk to the specified
system. Available only on systems with softwarebased
disk ownership. The disk_name or all or [-T
<storage_type>] -n count or auto 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. If the -T {ATA | BSAS
EATA | FCAL | LUN | SAS | SATA | SCSI | XATA
XSAS} option is specified along with the -n count
option only disks with the specified type are
selected up to count. The auto option will cause
any disks eligible for auto-assignment to be immediately
assigned, irregardless of the setting of
the disk.auto_assign option. Unowned disks which
are on loops where only 1 filer owns the disks and
the pool information is the same will 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. 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.
To make an owned disk unowned, use the `-s unowned'
option. The local node should own this disk. Use -f
option if the disk is not owned by the local node
and may result in data corruption if the current
owner of the disk is up.
disk fail [-i] [-f] <disk_name>
Force a file system disk to be failed. The disk
fail command 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 disks. This command can only be
used in maintenance mode after a nvram card swap.
Available only on systems with software-based disk
ownership.
disk remove [-w] <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). The option -w is valid for
gateway filer only and can be used to wipe out the
label of the removing spare disk.
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 <pat_tern>|-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. Available only on systems with software-based
disk ownership. -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.
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
which are being upgraded to use software-based
disk ownership.
disk zero spares
Zero all non-zeroed RAID spare disks.
na_aggr(1) na_sysconfig(1), na_vol(1)
Table of Contents