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.
Class
Set the attributes of the class specified by class.
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.
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.
Slice
Set the attributes of the slice specified by slice. The class indicates the class name to which the slice belongs.
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:
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.
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.
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.
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.
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.
The scope can specify a node group with 2 nodes or more and 16 nodes or less including self-node.
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.
It sets the operation of the hot spare.
You can make changes regardless to whether there is an activated volume within class.
Enables the hot spare.
Disables the hot spare. Spare disk automatic connection is restricted.
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.
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.
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.
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/rdsk/volume_name /dev/sfdsk/classname/dsk/volume_name
Change the operation of the I/O Response Time Assurance
The changes become active right away. It is not necessary to restart the system to activate the changes.
Enables the I/O Response Time Assurance.
An error occurs if a concat or stripe type group exists in class.
Disables the I/O function.
Indicates the I/O response time (sec).
The value is set to 23 by default.
Values from 6 to 100 may be specified for time.
When using the ETERNUS disk, it is recommended to set a value 33 or more. If a value smaller than 33 is set, the I/O may terminate by I/O Response Time Assurance Function before the path switches when an error of a single path of the multi-path occurs.
Note
If the following conditions are satisfied, it is recommended to set the time to 36 seconds or more.
- Use Emulex FC card.
- Use ETERNUS Multipath Driver. Or, use MPxIO with the Solaris 10 environment.
If the time is set below 36 seconds with the above environment, the I/O may terminate by I/O Response Time Assurance Function when error occurs to only one of the FC paths.
It sets the system panic mode of I/O Response Time Assurance Function.
System panic mode is a mode that sets whether the system has panicked when an I/O error occurred in all of the slices that configures the volume and when the class is closed.
The value is set to on by default. Set the value to on for cluster system.
on
Enables the system panic mode.
off
Disables the system panic mode.
Note
Systems with both mirror volume and single volume
In the system with mirror volume, it is recommended to set the system panic mode to disable for all the class with single volume.
When the system panic mode is set to enable for a class with single volume, the redundancy by mirroring has no effect, because the system will panic with just an occurrence of I/O error or I/O delay in only one storage unit.
Note
Using mirroring function of ZFS
In the ZFS mirror mode configuration, set the following to let the system panic when I/O error occurs on all of the volumes that configure ZFS storage pool and when the class is closed.
- Set the failmode property of ZFS storage pool to panic.
- Set the system panic mode of I/O Response Time Assurance Function to off.
When the system panic mode is set to on in a ZFS mirror mode configuration, since the system panics if an I/O error occurs on even one of the volumes making up the ZFS storage pool, the effect of the ZFS mirroring is lost.
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.
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.
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 cannot change a single disk to keep disk.
Sets the type attribute to "single."
Single volume may be created within disk thereafter. You cannot change a keep disk to a single disk.
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.
Sets the type attribute to "undef."
Hereinafter, this disk will be regarded as an undefined disk, which use is not yet determined.
Sets the name of a disk to diskname.
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.
Sets the name of the group to groupname.
Changes the active disk of the switch group specified by group to disk.
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.
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.
Changes the access mode of current node for slice.
It will result in an error when slice is activated. Execute after stopping it.
Sets access mode for read and write.
Sets access mode for read only. Opening a read-only volume in write mode will result in an error.
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.
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.
JRM is "on".
JRM is "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.
The volume is locked from activating thereafter.
The volume is not locked from activating thereafter.
Changes the access mode of current node for volume.
When volume is activated, it results in an error. First, you must stop the volume.
Sets access mode for read and write.
Sets access mode for read only.
Opening a read-only volume in write mode will result in an error.
Sets volume name to volumename.
When volume is active, it results in an error. First, you must stop the volume.
When changing a volume name through this operation, the paths of special files for the volume is also changed, so you must update the files in which the paths are described, such as /etc/vfstab.
/dev/sfdsk/class_name/rdsk/volumename /dev/sfdsk/class_name/dsk/volumename
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.
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.
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 disk label.
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.
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."
The class indicates the class name to which the object belongs, or is to be changed, where object is the target of the change.
The disk indicates the disk name that is the target of the change.
The group indicates the group name that is the target of the change.
The slice indicates the slice name that is the target of the change.
Slice name should be specified in disk.volume format.
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.
