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

D.4 sdxvolume - Volume operations

SYNOPSIS

sdxvolume -F -c class [-v volume,... ]
[-e { allnodes|node=node[:node:...]}]

sdxvolume -M -c class {-g group|-d disk} -v volume -s size
[-a attribute=value[,attribute=value]][-e delay=msec]

sdxvolume -N -c class [-v volume,...]
[-e [allnodes|node=node [:node:...]],delay=msec, mode=val,nosync, unlock]

sdxvolume -R -c class -v volume

sdxvolume -S -c class -v volume -s size

 

DESCRIPTION

Use sdxvolume to perform operations on volume objects (excluding shadow volumes) specified by volume.
You must be superuser to use this command.

 

PRIMARY OPTIONS

You can use either of the following options.

 

-F

oFfline

Stops one or more volumes specified by volume,... If the -v option is omitted, all volumes within the class are taken offline. Offline volumes cannot be accessed.

If synchronization copying of volume is in process, it cannot be stopped. You can stop the synchronization copying using the sdxcopy -C command.

The stopped volume will be activated when the node is rebooted. (Except for when the volume is locked.) Attempting this operation while volume is in use results in an error.

 

-M

Make

Creates a volume specified by volume, within the highest level group specified by group, or within a single disk specified by disk. The size indicates the number of blocks on volume, class indicates the class name associated with the group or disk.

If class is the root class, a maximum of 6 volumes with their physical slice attribute set to "on" can be created within the same group.

If class is a local class or a shared class, the same group or disk can contain a maximum of 6 volumes with their physical slice attribute set to "on." A maximum of 1024 volumes can be created in total, including the volumes with physical slice attribute set to "off." When -a pslice=value option is omitted, volumes with physical slice attribute set to "on," will be created. However, note that you cannot create a volume with physical slice attribute set to "on," if group is either stripe group, concatenation group, or a mirror group where its only directly-connected object is a lower level group. In such case, you must indicate the -a pslice=off option, and set the physical slice attribute to "off."

After volume creation is complete, the volumes are started on a node where the command was executed and become accessible through the following special files.

/dev/sfdsk/class/rdsk/volume
/dev/sfdsk/class/dsk/volume

If group is a mirror group, the system will automatically execute a synchronization copying upon returning from the sdxvolume command.

The features of volumes created when group is mirror group, stripe group and switch group are explained below.

- When group is a mirror group

To ensure data availability, GDS restricts the mirroring on a single piece of disk unit. In the case of mirror groups, a mirror volume that consists of mirror-multiplexing equal to the number of connected disks or lower level groups is created (maximum of eight). When only one disk or one lower level group is connected, the volume created within that mirror group will not be mirrored.
If the last block number of the volume that is created within a mirror group is larger than the available size of any of the spare disks registered with class, a warning message is sent to standard error output informing you that the hot spare feature is disabled.

- When group is a stripe group

In a stripe group, stripe volumes with columns equal to the number of connected disk or lower level groups are created. When only one disk or lower level group is connected, volume cannot be created.

- When group is a switch group

In a switch group, switch volumes with redundancy equivalent to the number of connected disks (a maximum of 2) are created. If only one disk is connected, an active disk switch cannot be performed.

If the active disk is not connected to a node where the command was executed, the volumes are not started. To use the created switch volumes, perform an active disk switch with the sdxattr -G command, or move to a node to which the active disk is connected, and then start the volumes with the sdxvolume -N command.

 

-N

oNline

Activates one or more volumes specified by volume,.... If the -v option is omitted, all volumes within class are activated.

Activated volumes can be accessed.

If there is a slice in TEMP status on the volume, an warning message is sent to standard error output.

If volume is a mirror volume, the system will determine whether synchronization has been lost upon returning from the sdxvolume command and automatically execute a synchronization copying as needed (except for when -e nosync is specified).

If volume is a switch volume, it cannot be started on nodes to which the active disk is not connected.

If volume belongs to the highest level concatenation group to which lower level switch groups are connected, it also cannot be started on nodes to which the active disk of volume is not connected.

 

-R

Remove

Removes the volume specified by volume and releases the disk area used in the group or the single disk.

If the specified volume is active, this command results in an error.

Be aware that any data stored on volume will be lost.

 

-S

reSize

Expands the size of a volume specified by volume to size blocks.
class indicates the name of a class to which volume belongs.

volume must be a volume that belongs to any one of:

• A single disk

• A mirror group that consists of only one disk

• A mirror group that consists of only one lower level group

The size can be expanded even when the volume is active.
The first block of volume is not changed. If any area of a volume other than volume exists in the area of size blocks after the first block of volume, it results in an error.

SUB OPTIONS

Sub options are as follows:

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

Use this to set an attribute for the volume.
The attribute indicates the attribute name, and the value indicates the attribute value. Always separate attribute and value with an equal (=) sign.
When indicating multiple attributes, specifiers should be combined using commas(,) as the delimiter.
You can indicate the following combination to attribute and value.
If multiple attributes are specified and an error results because of any part of them, the entire process is canceled.

jrm=on or jrm=off (default is on)

Sets the volume's JRM mode.
If a group other than a mirror group is specified in the -g option, this command results in an error.

on

JRM is "on".

off

JRM is "off".

pslice=on or pslice=off (default is on)

Sets the physical slice attribute value of volume.
When using -g option to indicate a group in which a physical slice cannot be created (i.e. stripe group, concatenation group, or mirror group where the only object directly connected to mirror group is lower level group), this option cannot be set to "on."
If class is the root type, this option cannot be set to "off."

on

Physical slice attribute value is set to "on".
Among slices composing the volume, the slices within the single disk, the disks that are connected to the switch group or the disks that are directly connected to the mirror group are registered to the VTOC, and physical slices are created.

off

Physical slice attribute value is set to "off".
None of the slices consisting the volume is registered to the VTOC, and physical slice will not be created. When physical slice attribute is set to "off", the slice cannot be detached.

 

-c class

The class indicates the class name to which the volume that is the target of the operation belongs, or the class name in which the volume is to be created.

 

-d disk (when using -M)

The disk indicates the single disk name in which the single volume will be created.

 

-e allnodes (when using -F,-N)

Stops or activates the volume on all nodes included in the scope of class.

Stopped nodes are ignored. class must be a shared class.

When neither this option nor -e node=node [:node:...] option is specified, volume is stopped or started only on the self-node.

 

-e delay=msec (when using -M,-N)

If synchronization is not maintained when creating or activating a mirror volume, synchronization copying will take place automatically (except for when -e nosync is specified). This option delays the issuing of the input/output request to the disk at the time of copying by milliseconds specified by msec , allowing adjustment for the effect on the application accessing the volume. The value is set to 0 by default. Values from 0 to 1000 may be specified for msec.

If mirror group is not specified with group, this option is ignored.

 

-e mode=val (when using -N)

Specifies the access mode for one or more volumes that will be activated.

val indicates either of the following options.

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.

Although volume will be activated in the access mode specified by val, the access mode attribute for volume will remain unchanged. Access mode specified by val ("Current Access Mode") is valid only while the volume is activated, and will become invalid once the volume is stopped. When the volume is restarted, it will start in the mode set by access mode attribute ("Default Access Mode"), except for when the access mode is specified at the time of restart.

In order to start a volume that is already activated on the current node in a different access mode, you must first stop the volume.

 

-e node=node[:node,....](when using -F,-N)

Stops or activates the volume on one or more specified nodes.

Stopped nodes are ignored. You must specify the node identifier of the node to stop or activate the volume to node. If a node not included in the scope of class is specified, the volume is not stopped or activated on any node. class must be a shared class.

If this option and the -e allnodes are both omitted, the volume is stopped or activated only on the current node.

 

-e nosync (when using -N)

Disables automatic synchronization copying after activating a mirror volume.
If mirror group is not specified with group, this option is ignored.


Volumes that are activated using this option will not be mirrored.
In order to configure a mirroring environment, you must perform synchronization copying with the sdxcopy -B command.

 

-e unlock (when using -N)

The volume will be activated regardless to whether or not it is locked. Lock mode will not be changed unless you change it with the stxattr -V command.

 

-g group (when using -M)

The group indicates the group name in which the volume will be created.

 

-s size (when using -M)

Specifies the size of the volume being created, in blocks (base 10).

One block is 512 bytes.
When group indicates stripe group, the size of volume created will be size rounded up to a common multiple of stripe width multiplied by stripe columns and cylinder size. In other cases, the size of volume created will be size rounded up to the integer multiple of cylinder size.

 

-s size (when using -S)

Specifies the number of blocks (decimal number) to which the size of the specified volume is expanded. One block is 512 bytes.

The size of the expanded volume will be the size rounded up to the integer multiple of the cylinder size.

 

-v volume (when using -M,-R)

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

 

-v volume,... (when using -F,-N)

The volume,... indicates one or more volume names that is the target of the operation. To indicate multiple volumes, separate each volume name with a comma (,) as the delimiter.

 

RETURNED VALUE

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