A Technical Architects Diary

Tag: disk

disk

by on Jul.07, 2009, under 7-mode Manual Pages

Table of Contents

NAME

disk – RAID disk configuration control commands

SYNOPSIS

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] <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

DESCRIPTION

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.

USAGE

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 | 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 0×55 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.

SEE ALSO

aggr sysconfig , vol


Table of Contents









Leave a Comment :, , , , more...

disk

by on Mar.03, 2009, under Maintenance Mode Commands

This is useful primarily for changing ownership when you move disks around between systems (disk assign / disk reassign / disk remove_ownership)

 *> disk
usage: disk <options>
Options are:
        unfail [ -s ] <disk_name>   – unfail a disk
        power_cycle [ -f ] { [-d <disk_list>] | [ -c <channel_name> [ -s <shelf_number> ] ] } – power-cycle one or more disks
        assign {<disk_name> | all | -n <count> | auto} [-p <pool>] [-o <ownername>] [-s <sysid>] [-c block|zoned] [-f] – assign a disk to a filer or all unowned disks by specifying “all”  or <count> number of unowned disks
        show [-o <ownername> | -s <sysid> | -n | -v | -a]  – lists disks and owners
        reassign {-o <old_name> | -s <old_sysid>} [-n <new_name>] [-d <new_sysid>] – reassign disks from old filer
        remove_ownership [<disk_name> | all | -s <sysid>] [-f] – revert/remove disk ownership
        upgrade_ownership           – upgrade disks to new ownership scheme
        checksum {<disk_name> | all} [-c block | zoned]

*> disk show -v
Local System ID: 84197978

  DISK       OWNER                  POOL   SERIAL NUMBER
———— ————-          —–  ————-
0b.18                  (84197978)   Pool0  3HX2NLV9000075048S18
0b.16                  (84197978)   Pool0  3HX2NYFW00007502E16L
0b.17                  (84197978)   Pool0  3HX2NYNY00007504JERY
0b.19                  (84197978)   Pool0  3HX2NW4H000075048SEU
0b.20                  (84197978)   Pool0  3HX2P9KZ000075049G0X

*> disk_list
     DISK    CHAN  VENDOR   PRODUCT ID       REV  SERIAL#              HW (BLOCKS   BPS) DQ
———— —– ——– —————- —- ——————– — ————– –
0b.20        FC:A  NETAPP   X271_S15K3036F15 NA08 3HX2P9KZ000075049G0X ff   70197546 520  N
0b.19        FC:A  NETAPP   X271_S15K3036F15 NA08 3HX2NW4H000075048SEU ff  70197546 520  N
0b.18        FC:A  NETAPP   X271_S15K3036F15 NA08 3HX2NLV9000075048S18 ff   70197546 520  N
0b.17        FC:A  NETAPP   X271_S15K3036F15 NA08 3HX2NYNY00007504JERY ff   70197546 520  N
0b.16        FC:A  NETAPP   X271_S15K3036F15 NA08 3HX2NYFW00007502E16L ff   70197546 520  N

Leave a Comment :, , , more...

Looking for something?

Use the form below to search the site:

Still not finding what you're looking for? Drop a comment on a post or contact us so we can take care of it!