PRIMECLUSTER Global Disk Services Configuration and Administration Guide 4.1 (Solaris(TM) Operating System)

D.7 sdxattr - Set objects attributes

SYNOPSIS

sdxattr -C -c class -a attribute=value[,attribute=value,...]

sdxattr -D -c class -d disk -a attribute=value[,attribute=value]

sdxattr -G -c class -g group -a attribute=value[,attribute=value]

sdxattr -S -c class -s slice -a attribute=value[,attribute=value]

sdxattr -V -c class -v volume -a attribute=value[,attribute=value,...]

 

DESCRIPTION

Use sdxattr to change attribute values of objects (excluding shadow objects) on the current node.
You must be superuser to use this command.

 

PRIMARY OPTIONS

Primary options are used to specify the category of the object whose attributes are to be set.

 

-C

Class

Set the attributes of the class specified by class.

 

-D

Disk

Set the attributes of the disk specified by disk.
The class indicates the class name with which disk is registered.
If disk is connected to a group, or if there is a volume within disk, it will result in an error, and the change in attribute will not be executed.

 

-G

Group

Set the attributes of the group specified by group.

The class indicates the class name to which group belongs.
When group is connected to another group, this option will result in an error and you cannot change the attribute. Also, this option will result in an error if there are one or more activated volumes within the group. Stop all volumes before executing this command.

 

-S

Slice

Set the attributes of the slice specified by slice.
The class indicates the class name to which the slice belongs.

 

-V

Volume

Set the attributes of the volume specified by volume.
The class indicates the class name to which the volume belongs.

 

SUB OPTIONS

Sub options are as follows:

-a attribute=value[,attribute=value,...] (when using -C)

Sets the attribute attribute of the class to be value.

The attribute indicates the attribute name, and the value indicates the attribute value.
Always separate attribute and value with an equal (=) sign.
Specifiers should be combined using a comma (,) as the delimiter.
You can use the following attribute and value pairs in any combination.

When attempting to set multiple attributes, if any of them result in an error, no attributes are set.

type=local or type=shared

Sets the class type attribute.

When there is an activated volume within class, you can change the type attribute from "local" to "shared," but not vice versa. In order to change it from "shared" to "local," you must execute the command after first stopping all volumes.

You cannot change it from "root" to "local" or "shared", or vice versa. Changing the type of a class fails if the class is a shared class that includes a disk of which physical scope includes 1 node, or that includes a switch group.

local

Sets the type attribute to "local."

Objects within "local" type class can only be used by current node.

For the scope attribute, current node's node identifier will be automatically set.

shared

Sets the type attribute to "shared."

By combining this with the scope attribute, objects in the class can be shared among multiple nodes including the current node.

scope=node:node:...

For a "shared" type class, changes the nodes which share the class.

When there is an activated volume within class, you can add new nodes, but you cannot remove a node that has already been included in the scope. In order to remove a node, you must execute the command after first stopping all volumes.

If the node settings are not all complete, this will result in an error.

The node indicates a node identifier that is defined by PRIMECLUSTER.

For scope, you can indicate up to sixteen nodes.

Changing the scope of a class fails if the class is a shared class that includes a disk of which physical scope is 1 node, or that includes a switch group.

hs=on or hs=off

It sets the operation of the hot spare.

You can make changes regardless to whether there is an activated volume within class.

on

Enables the hot spare.

off

Disables the hot spare. Spare disk automatic connection is restricted.

hsmode=exbox or hsmode=bybox

Changes the spare disk selection mode for automatic connection by hot spare.

This operation is available regardless whether or not there are active volumes within class.

exbox

Changes the spare disk selection method to the external mode.
If an I/O error occurs in a disk of a disk array unit, this method selects a spare disk that belongs to a different disk case from that of the failed disk. If an I/O error occurs in a disk irrelevant to a disk array unit (such as an internal disk), it selects a spare disk that is connected to a different controller from that of the failed disk. When no applicable unconnected spare disk is found there, a spare disk that belongs to the same disk case or is connected to the same controller as that of the disk with the I/O error, is selected.

bybox

Changes the spare disk selection mode to the internal mode.
If an I/O error occurs in a disk of a disk array unit, this method selects a spare disk that belongs to the same disk case as that of the failed disk. If an I/O error occurs in a disk irrelevant to a disk array unit (such as an internal disk), it selects a spare disk that is connected to the same controller as that of the failed disk. When no applicable unconnected spare disk is found there, spare disk automatic connection is restrained.

name=classname

Sets the class name to classname.

When there is an activated volume within class, it results in an error. First, you must stop all volumes.

When changing a class name through this operation, the paths of special files for volumes are also changed, so you must update the files in which the paths are described, such as /etc/vfstab.

/dev/sfdsk/classname/[r]dsk/volume_name

 

-a attribute=value[,attribute=value] (when using -D)

Sets the attribute attribute of the disk to be value.

The attribute indicates the attribute name, and the value indicates the attribute value.
Always separate attribute and value with an equal (=) sign.
Specifiers should be combined using a comma (,) as the delimiter.

You can use the following attribute and value pairs in any combination.

When attempting to set multiple attributes, if any of them result in an error, no attributes are set.

type=keep, type=single, type=spare or type=undef

Sets the SDX disk type attribute. If disk is not connected to part of nodes included in the scope of class, or if a switch group exists in class, changing the type attribute of disk fails.

keep

Sets the type attribute to "keep."

Hereinafter, this disk will be regarded as a keep disk, and its format and data will remain when connected to a group.

You can not change a single disk to keep disk.

single

Sets the type attribute to "single."

Single volume may be created within disk thereafter. You cannot change a keep disk to a single disk.

spare

Sets the type attribute to "spare."

The disk will be used as a spare disk thereafter.
When the available size of disk is smaller than the available size of the smallest mirror group within class, a warning message notifying that the hot spare function may not be available will be sent to standard error output.

undef

Sets the type attribute to "undef."

Hereinafter, this disk will be regarded as an undefined disk, which use is not yet determined.

name=diskname

Sets the name of a disk to diskname.

 

-a attribute=value[,attribute=value] (when using -G)

Sets the attribute attribute of the group to be value.
The attribute indicates the attribute name, and the value indicates the attribute value.

Always separate attribute and value with an equal (=) sign. To set multiple attributes, specify sets of these specifiers in comma-delimited format.

Specify any of the following sets into attribute and value.

When multiple attributes are specified, the entire process is canceled in the event of an error in part of the processes.

name=groupname

Sets the name of the group to groupname.

actdisk=disk

Changes the active disk of the switch group specified by group to disk.

 

-a attribute=value (when using -S)

Sets the attribute attribute of the detached slice to be value.
Both attribute values become invalid at the point when the slice is assembled with the volume using the -R option.

The attribute indicates the attribute name, and the value indicates the attribute value.

Always separate attribute and value with an equal (=) sign.
Specifiers should be combined using a comma (,) as the delimiter.

You can use the following attribute and value pairs in any combination.

When attempting to set multiple attributes, if any of them result in an error, no attributes are set.

jrm=off

Turns the slice's just resynchronization mechanism mode to "off".
It could be turned "off" regardless to the slice status.

To set the jrm to "on," attach the slice to the volume and then detach it again.

mode=rw or mode=ro

Changes the access mode of current node for slice.
It will result in an error when slice is activated. Execute after stopping it.

rw

Sets access mode for read and write.

ro

Sets access mode for read only.
Opening a read-only volume in write mode will result in an error.

 

-a attribute=value[,attribute=value,...] (when using -V)

Sets the attribute attribute of the volume to be value.
The attribute indicates the attribute name, and the value indicates the attribute value.

Always separate attribute and value with an equal (=) sign.
Specifiers should be combined using comma (,) as the delimiter.

You can use the following attribute and value pairs in any combination.

When attempting to set multiple attributes, if any of them result in an error, no attributes are set.

jrm=on or jrm=off

Turn the JRM mode "on" or "off".

You can make changes regardless to whether volume is activated or not.

If volume belongs to a group other than a mirror group, this command results in an error.

on

JRM is "on".

off

JRM is "off".

lock=on or lock=off

Changes the lock mode of current node for volume.
You can make changes regardless to whether volume is activated or not.

If class is the root class, this command results in an error.

on

The volume is locked from activating thereafter.

off

The volume is not locked from activating thereafter.

mode=rw or mode=ro

Changes the access mode of current node for volume.

When volume is activated, it results in an error. First, you must stop the volume.

rw

Sets access mode for read and write.

ro

Sets access mode for read only.
Opening a read-only volume in write mode will result in an error.

name=volumename

Sets the name of the volume to volumename.
It will result in an error when volume is activated. Execute after stopping volume.

pjrm=off

The parted proxy volume's just resynchronization mechanism mode for rejoining or restoring is turned "off".
This can be changed regardless of whether volume is active or inactive.
This attribute value becomes invalid as volume is rejoined to the master volume with the Rejoin or RejoinRestore option of the sdxproxy command.
The value cannot be set to "on". To turn "on", the volume must be rejoined to the master volume once and then be parted again.

pslice=on or pslice=off

Turns the physical slice attribute value to be "on" or "off", respectively.
If volume is activated, to avoid an error, stop volume before indicating this option. This option will also result in an error if there is a detached slice within volume. In such case, attach the slice before indicating this option.

on

The physical slice attribute value of volume is set to be "on".
Among the slices consisting volume, any slice on a single disk, and any slices on disks that are directly connected to a mirror group will be registered to the VTOC.

You cannot change this option to "on" when volume belongs to a group that cannot create a physical slice (stripe group, concatenation group, or a mirror group whose only directly-connecting group is a lower level group), or when there is a maximum number (six) of volumes with its physical slice attribute set to "on" within the same group or single disk.

off

The physical slice attribute value of volume is set to be "off".
If class is the root type, the value cannot be changed to "off."

 

-c class

The class indicates the class name to which the object belongs, or is to be changed, where object is the target of the change.

 

-d disk

The disk indicates the disk name that is the target of the change.

 

-g group

The group indicates the group name that is the target of the change.

 

-s slice

The slice indicates the slice name that is the target of the change.

Slice name should be specified in disk.volume format.

 

-v volume

The volume indicates the volume name that is the target of the change.

 

RETURNED VALUE

Upon successful completion, a value of 0 is returned.
Otherwise, a non-zero value is returned.