Index  |  Top  -  Up Data ONTAP 8.2

storage disk assign

Assign ownership of a disk to a system

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The storage disk assign command is used to assign ownership of an unowned disk or array LUN to a specific node. You can also use this command to change the ownership of a disk or an array LUN to another node. You can designate disk ownership by specifying disk names, array LUN names, wildcards, or all (for all disks or array LUNs visible to the node). For disks, you can also set up disk ownership autoassignment. You can also assign disks to a particular pool.

Parameters

{  [-disk <disk path name>] - Disk Path

This specifies the disk or array LUN that is to be assigned. Disk names take one of the following forms:

The same disk or array LUN can have multiple names, depending on how the disk or array LUN is connected. For example, a disk known to a node named alpha as alpha:1a.19 can be known to a node named beta as beta:0b.37. All names are listed in the output of queries and are equally valid. To determine the unique identity of a disk or an array LUN, run a detailed query and look for the universal unique identifier (UUID) or serial number of the disk or array LUN.

A subset of disks or array LUNs can be assigned using the wildcard character (*) in the -disk parameter. Either the -owner or the -sysid parameter must be specified with the -disk parameter. Do not use the -node parameter with the -disk parameter.

|  -all [true] - Assign All Disks

This optional parameter causes all visible unowned disks or array LUNs to be assigned to the node specified in the -node parameter. The -node parameter must be specified with the -all parameter. Do not use the -owner or the -sysid parameter with the -all parameter.

|  [-type | -T {ATA | BSAS | FCAL | FSAS | LUN | MSATA | SAS | SATA | SSD}] - Storage Type

This optional parameter assigns ownership of a specific type of disk or array LUN (or a set of disks/array LUNs) to a node. The -count parameter must be specified with the -type parameter.

   -count | -n <integer> - Disk Count

This optional parameter assigns ownership of a number of disks or array LUNs specified in the -count parameter, to a node.

|  -auto [true]  } - Auto Assign

This optional parameter causes all visible disks eligible for autoassignment to be immediately assigned to the node specified in the -node parameter, irregardless of the setting of the disk.auto_assign option. Only unowned disks on loops or stacks owned wholly by that system and which have the same pool information will be assigned. The -node parameter must be specified with the -auto parameter. Do not use the -owner or the -sysid parameter with the -auto parameter. When possible, use -auto parameter rather than -all parameter to conform to disk ownership best practices. The -auto parameter is ignored for array LUNs.

[-pool | -p <integer>] - Pool

This optional parameter specifies the pool to which a disk must be assigned. It can take values of Pool0 or Pool1.

[-owner | -o <nodename>] - Owner Name

This optional parameter specifies the node to which the disk or array LUN has to be assigned.

[-sysid | -s <nvramid>] - New Owner ID

This optional parameter specifies the serial number (NVRAM ID) of the node to which the disk or array LUN has to be assigned.

[-checksum | -c {block|zoned}] - Checksum Compatibility

This optional parameter is used to specify the checksum type for a disk or an array LUN. The possible values are block or zoned. Data ONTAP 8.1.1 supports a new checksum scheme called advanced zoned checksum (AZCS). Existing zoned checksum aggregates are still supported. A newly created aggregate with zoned checksum array LUNs is assigned AZCS checksum type. AZCS checksum type provides more functionality than the "version 1" zoned checksum type which has been supported in previous Data ONTAP releases. Zoned checksum spare array LUNs added to an existing zoned checksum aggregate continue to be zoned checksum. Zoned checksum spare array LUNs added to an AZCS checksum type aggregate use the AZCS checksum scheme for managing checksums. For some disks (e.g. FCAL, SSD, SAS disks), the checksum type cannot be modified. For more information on modifying the checksum type, refer to the "Physical Storage Management Guide".

[-force | -f [true]] - Force Flag

This optional parameter forces the assignment of ownership of an already owned disk to a node. This parameter could also be used to assign an array LUN with a redundancy error, for example, if the array LUN is available on only one path. For a disk which is part of a live aggregate, even specification of the -force parameter would not force the assignment, since it would be catastrophic.

[-node | -N <nodename>] - Node Name (For Auto Assign)

This optional parameter is used with either the -auto or the -all parameter. If used with the -auto parameter, all disks which are visible to the node specified in the -node parameter and which are eligible for autoassignment would be assigned to it. If used with the -all parameter, all unowned disks or array LUNs visible to the node would be assigned to it.

Examples

The following example assigns ownership of an unowned disk named node0:1a.16 to a node named node1:
cluster1::> storage disk assign -disk node0:1a.16 -owner node1
    
The following example assigns all unowned disks or array LUNs visible to a node named node1 to itself:
cluster1::> storage disk assign -all -node node1
    
The following example autoassigns all unowned disks (eligible for autoassignment) visible to a node named node1 to itself:
cluster1::> storage disk assign -auto -node node1
    
The following two examples show the working of the -force parameter with a spare disk that is already owned by another system:
cluster1::> storage disk assign -disk node0:1a.16 -owner node1
    Error: command failed: Failed to assign disks. Reason: Disk 1a.16 is
    already owned.
    
cluster1::> storage disk assign -disk node0:1a.16 -owner node1 -force
    Success.
    
The following example assigns ownership of the set of unowned disks connected to <host_adapter> 1a of a node named node0, to a node named node1:
cluster1::> storage disk assign -disk node0:1a.* -owner node1
    

Index  |  Top  -  Up Data ONTAP 8.2

Copyright © 1994-2015 NetApp, Inc. Legal Information