D.18 Volume Creation Using Command

PRIMECLUSTER Global Disk Services Configuration and Administration Guide 4.1 (Linux)

D.18 Volume Creation Using Command

In this section, operation outline of volume creation is explained. Please use as a reference when configuring the environment. For details, see the Command Reference.

For the order of mirroring system disks, see "USAGE EXAMPLES" in "sdxroot - Root file system mirroring definition and cancellation."

For PRIMECLUSTER Systems
In order to define the configuration of GDS objects such as classes and volumes, PRIMECLUSTER resources must be registered in advance. For details about registering resources, see "Shared Disk Unit Resource Registration."

(1) Creating a mirror volume

The following example shows the procedures for creating a volume by mirroring physical disks named sda and sdb.

1) Registering disks to class

Example) Registering physical disks sda and sdb with local class "Class1", and name these disks Disk1 and Disk2.

# sdxdisk -M -a type=local -c Class1 -d sda=Disk1,sdb=Disk2

When registering disks with a shared class, it is necessary to use the -a option to specify the scope attribute. See an example below.

# sdxdisk -M -c Class1 -a type=shared,scope=node1:node2 -d sda=Disk1,sdb=Disk2

2) Connecting the disks to a mirror group

Connect the disks to a mirror group. When the specified mirror group does not exist, it will be created automatically.

Example) Connecting "Disk1" and "Disk2" to mirror group "Group1."

# sdxdisk -C -c Class1 -g Group1 -d Disk1,Disk2

3) Creating a mirror volume

Create a volume within the mirror group.

Example) Creating a volume of 1,000 blocks within mirror group "Group1", and assigning a volume name "Volume1."

# sdxvolume -M -c Class1 -g Group1 -v Volume1 -s 1000

After returning from the command, synchronization copying will automatically begin.

4) Confirming the completion of procedure

Confirm that the synchronization copying is complete.

Example) Confirming synchronization copying of volume "Volume1" is complete.

# sdxinfo -S -o Volume1

OBJ    CLASS   GROUP   DISK    VOLUME  STATUS
------ ------- ------- ------- ------- --------
slice  Class1   Group1  Disk1   Volume1 ACTIVE
slice  Class1   Group1  Disk2   Volume1 COPY

If all the displayed slices' STATUS fields are "ACTIVE", synchronization copying is complete.

If the synchronization copying is still in progress, "COPY" will be displayed in the STATUS field.

Using the -e long option, you can check the progress of the synchronization copying.

For details, see "sdxinfo - Display object configuration and status information."

(2) Creating a single volume

The following example shows the procedures for creating a single volume using a physical disk named sda.

1) Registering a disk to class

Example) Registering physical disk sda to shared class "Class1", which is shared on node1 and node2, and assigning the name "Disk1."

# sdxdisk -M -c Class1 -a type=shared,scope=node1:node2 -d sda=Disk1:single

2) Creating a single volume

Create a volume within the single disk.

Example) Creating a volume of 1,000 blocks within single disk "Disk 1", and assigning a volume name "Volume1."

# sdxvolume -M -c Class1 -d Disk1 -v Volume1 -s 1000

(3) Creating a large-capacity volume (using concatenation)

The following example shows the procedures for creating a volume by concatenating physical disks named sda and sdb.

1) Registering disks to class

Example) Registering physical disks sda and sdb with shared class "Class1", which is shared on node1 and node2, and naming those disks Disk1 and Disk2.

# sdxdisk -M -c Class1 -a type=shared,scope=node1:node2 -d sda=Disk1,sdb=Disk2

2) Connecting the disks to a concatenation group

Connect the disks to a concatenation group. When the specified concatenation group does not exist, it will be created automatically.

Example) Connecting "Disk1" and "Disk2" to concatenation group "Group1."

# sdxdisk -C -c Class1 -g Group1 -d Disk1,Disk2 -a type=concat

3) Creating a large-capacity volume

Create a volume within the concatenation group.

Example) Creating a volume of 1,000,000,000 blocks within concatenation group "Group1", and assigning a volume name "Volume1."

# sdxvolume -M -c Class1 -g Group1 -v Volume1 -s 1000000000 -a pslice=off

(4) Creating a stripe volume

The following example shows the procedures for creating a volume by striping physical disks named sda and sdb.

1) Registering disks to class

Example) Registering physical disks sda and sdb with shared class "Class1", which is shared on node1 and node2, and naming those disks Disk1 and Disk2.

# sdxdisk -M -c Class1 -a type=shared,scope=node1:node2 -d sda=Disk1,sdb=Disk2

2) Connecting the disks to a stripe group

Connect the disks to a stripe group. When the stripe group does not exist, it will be created automatically.

Example) Connecting "Disk1" and "Disk2" to stripe group "Group1."

# sdxdisk -C -c Class1 -g Group1 -d Disk1,Disk2 -a type=stripe,width=32

3) Creating a stripe volume

Create a volume within the stripe disk.

Example) Creating a volume of 1,000 blocks within stripe group "Group1", and assigning a volume name "Volume1."

# sdxvolume -M -c Class1 -g Group1 -v Volume1 -s 1000 -a pslice=off

(5) Creating a mirror volume (Combining striping and mirroring)

The following example shows the procedures for creating a volume by constructing stripe groups with physical disks sda and sdb and other physical disks sdc and sdd respectively and then mirroring the two stripe groups.

1) Registering disks to class

Example) Registering physical disks sda, sdb, sdc and sdd to shared class "Class1", which is shared on node1 and node2, and assigning the names "Disk1", "Disk2", "Disk3" and "Disk4" respectively.

# sdxdisk -M -c Class1 -a type=shared,scope=node1:node2 \
-d sda=Disk1,sdb=Disk2,sdc=Disk3,sdd=Disk4

2) Connecting the disks to a stripe group

Connect the disks to a stripe group. When the stripe group does not exist, it will be created automatically.

Example) Connecting "Disk1" and "Disk2" to stripe group "Group1."

# sdxdisk -C -c Class1 -g Group1 -d Disk1,Disk2 -a type=stripe,width=32

Connecting Disk3 and Disk4 to stripe group Group2.

# sdxdisk -C -c Class1 -g Group2 -d Disk3,Disk4 -a type=stripe,width=32

3) Connecting the stripe groups to a mirror group

Connect the stripe groups to a mirror group. When the specified mirror group does not exist, it will be created automatically.

Example) Connecting the stripe group "Group1" and "Group2" to mirror group "Group3."

# sdxgroup -C -c Class1 -h Group3 -l Group1,Group2 -a type=mirror

The "-a type=mirror" option is omissible.

4) Creating a mirror volume

Create a volume within the highest level mirror group.

Example) Creating a volume of 1,000 blocks within mirror group "Group3", and assigning a volume name "Volume1."

# sdxvolume -M -c Class1 -g Group3 -v Volume1 -s 1000 -a pslice=off

After returning from the command, synchronization copying will automatically begin.

5) Confirming the completion of procedure

Confirm that the synchronization copying is complete.

Example) Confirming synchronization copying of volume "Volume1" is complete.

# sdxinfo -S -o Volume1

OBJ    CLASS   GROUP   DISK    VOLUME  STATUS
------ ------- ------- ------- ------- --------
slice  Class1  Group3  Group1  Volume1 ACTIVE
slice  Class1  Group3  Group2  Volume1 COPY

If the all the displayed slices' STATUS fields are "ACTIVE", synchronization copying is complete.

If the synchronization copying is still in progress, "COPY" will be displayed in the STATUS field.

Using the -e long option, you can check the progress of the synchronization copying.

For details, see "sdxinfo - Display object configuration and status information."

Contents