SYNOPSIS
sdxslice -F -c class -s slice,...
sdxslice -M -c class -d disk -v volume [-a attribute=value[,attribute=value]]
sdxslice -N -c class -s slice,...
sdxslice -R -c class {-d disk -v volume|-s slice} [-e delay=msec,waitsync]
sdxslice -T -c class -s slice,...
DESCRIPTION
Use sdxslice to perform operations on slice objects (excluding shadow slices).
You must be superuser to use this command.
PRIMARY OPTIONS
You can use one of the following options.
oFfline
Stops the slice or slices specified by slice,.... Offline slices cannot be accessed. The slice indicates the mirror slice name detached from the mirror volume using -M option.
The class indicates the class name to which slice belongs.
Attempting this command while slice is in use results in an error.
Note
In the case of a shared class, even offline slices will be activated upon reboot.
Make
Temporarily detaches one of the mirror slices used in a copy of a mirror volume specified by volume with mirroring multiplicity of two and higher, which is a part of the disk specified by disk. The class indicates the class name to which volume belongs.
Only when the physical slice attribute value of volume is "on", you can detach the slice. When the physical slice attribute is set to "off", you must turn it to "on" using the sdxattr -V command before executing this command.
Once detached, a special file is placed on the system. The path name is given below.
/dev/sfdsk/class/rdsk/disk.volume
/dev/sfdsk/class/dsk/disk.volume
Users can access the slice with this special file. You can use this slice to create a data backup of volume.
If class is a shared class, only the node that detached the slice can access the slice. Other nodes sharing the class cannot access it. If you need to access from other nodes, you can take over the access right with the -T option.
A slice can be detached even though the volume is active. You must ensure the integrity of backup data at the file-system layer or database layer. If you are handling the volume as the file-system, for instance, there will be situations where you must regain integrity using the fsck command.
Note
Be aware that as long as a slice is not attached using the -R option, the degree of mirror multiplexing stays reduced.
oNline
Activates the slice or slices specified by slice,... Activated slices can be accessed.
The slice indicates the mirror slice name detached from the mirror volume using -M option.
The class indicates the class name to which slice belongs.
Remove
Reassembles the slice as part of the volume, where the slice is specified by slice or combination of disk and volume.
The disk and volume combination or slice indicates the mirror slice name disconnected from the mirror volume using -M option.
The class indicates the class name to which the slice belongs.
After (when using -e waitsync option, before) returning from the sdxslice command, the slice is automatically reassembled with the volume. If the volume is active at this time, a synchronization copy is executed.
Attempting this command while the slice is in use results in an error.
Takeover
Takes over the slice or slices specified by slice from another node. When the takeover is complete, the slice will stop on the original node and be activated on the current node, allowing operation to the slice on the current node.
When a slice is attached to the volume after executing this command, the entire block will be copied regardless to the setting of JRM mode.
This option is valid only for shared class.
The slice indicates the mirror slice name disconnected from the mirror volume using -M option.
The class indicates the class name to which slice belongs.
Attempting this command while the slice is in use results in an error.
SUB OPTIONS
Sub options are as follows:
Sets the attribute attribute of the slice to be value.
Both attribute values become invalid at the point when the slice is assembled with the volume.
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.
If multiple attributes are specified and an error results because of any part of them, the entire process is canceled.
Sets the slice's JRM mode.
JRM is on.
JRM is off.
Sets the slice access mode.
Sets access mode for read and write.
Sets access mode for read only. Opening a read-only slice in write mode will result in an error.
The class indicates the class name to which the slice belongs.
The disk indicates the disk name to which the slice belongs, where slice is the target of the operation.
This option delays the issuing of the input/output request to the disk at the time of synchronization copying of the slice detached from volume, by milliseconds specified by msec.
Always separate delay and msec with an equal (=) sign.
This option allows you to adjust the influence on the application accessing the volume.
The value is set to 0 by default.
Values from 0 to 1000 may be specified for msec.
When synchronization copying is executed, returns the command after the copying process is complete.
The slice indicates slice that is the target of operation.
Slice name should be indicated in disk.volume format.
The slice indicates one or more slice names that are the target of the operation. To indicate multiple slices, separate each slice name with a comma (,) as the delimiter. slice which can be specified is up to 400.
Slice name should be indicated in disk.volume format.
Specifies the name of volume comprising the slice that is the target of the operation.
RETURNED VALUE
Upon successful completion, a value of 0 is returned.
Otherwise, a non-zero value is returned.