Version:

User Guide

/ kadalu-storage / latest / volumes/

Kadalu Storage Volumes

Create a Kadalu Storage Volume with Storage units from multiple Storage nodes.

[root@server1 ~]# kadalu volume create DEV/vol1 server1.example.com:/exports/vol1/s1
Volume vol1 created successfully
ID: 02b6a3a4-e704-47ee-bb05-e541a561a921

Where

  • DEV is Pool name

  • vol1 is the Volume name

  • server1.example.com is the node from which the Storage unit will be exported.

  • /exports/vol/s1 is the mounted path of Storage Unit.

Automatically create the Pool and add nodes to Pool that are specified in the Volume create request by adding --auto-create-pool and --auto-add-nodes.

[root@server1 ~]# kadalu volume create DEV/vol1 \
    server1.example.com:/exports/vol1/s1 \
    --auto-create-pool --auto-add-nodes
Volume vol1 created successfully
ID: 02b6a3a4-e704-47ee-bb05-e541a561a921

Create a Replicated or Mirrored Volume

[root@server1 ~]# kadalu volume create DEV/vol1 \
    replica server1.example.com:/exports/vol1/s1 \
            server2.example.com:/exports/vol1/s2 \
            server3.example.com:/exports/vol1/s3
Volume vol1 created successfully
ID: 02b6a3a4-e704-47ee-bb05-e541a561a921

Using mirror is also supported

[root@server1 ~]# kadalu volume create DEV/vol1 \
    mirror server1.example.com:/exports/vol1/s1 \
           server2.example.com:/exports/vol1/s2 \
           server3.example.com:/exports/vol1/s3
Volume vol1 created successfully
ID: 02b6a3a4-e704-47ee-bb05-e541a561a921

Alternatively, GlusterFS syntax is also supported

[root@server1 ~]# kadalu volume create DEV/vol1 replica 3 \
    server1.example.com:/exports/vol1/s1 \
    server2.example.com:/exports/vol1/s2 \
    server3.example.com:/exports/vol1/s3
Volume vol1 created successfully
ID: 02b6a3a4-e704-47ee-bb05-e541a561a921
  • By default, volumes are started on create. Use --no-start to override this behavior.

  • If the Storage unit path is not a mounted directory then use --allow-root-partition option (Not yet implemented). This is not an optimal setup since the Kadalu Volume can fill up the root partition or other applications can fill up Kadalu Volume.

  • To import a Volume, Use --volume-id option to set the Same Volume ID to the imported Volume (Not yet implemented).

    [root@server1 ~]# kadalu volume create DEV/vol1 \
        server1.example.com:/exports/vol1/s1 \
       --volume-id=02b6a3a4-e704-47ee-bb05-e541a561a921
  • To reuse a Storage unit directory that was part of other Volume earlier, use --reuse-storage-unit (Not yet implemented, only applicable if the Storage unit directory is empty).

  • To allow using Replicate/Mirrored/Disperse Storage units from same node, use --from-same-node. This is not an optimal setup since it does not provide high availability for the distribute group if one node goes down (Not yet implemented).

Ports for the Storage Unit are assigned automatically (49252 to 49452) while creating the Volume. Restarting the Volume will not change the Ports of the Storage units. The Volume info command will show the assigned ports. It is also possible to manually specify the Port while creating the Volume.

[root@server1 ~]# kadalu volume create DEV/vol1 \
    mirror server1.example.com:4501:/exports/vol1/s1 \
           server2.example.com:4501:/exports/vol1/s2 \
           server3.example.com:4501:/exports/vol1/s3
Volume vol1 created successfully
ID: 02b6a3a4-e704-47ee-bb05-e541a561a921
© 2022 Kadalu Software Private Limited. All Rights Reserved.