Set/unset volume options on an existing volume

Often, we are required to customize our volume for different use cases. Setting those options enhances performance and prepares the volume for our desired task. In order to do so, we set different options on the volume using the ‘key’ parameter in our configuration file.

This tutorial will take you through just that. It’s intended to show you how you can set different volume options on an existing Gluster volume. (To create a Gluster volume, please refer to 1x3-gluster-volume or 2x2-gluster-volume).

Setting the options on an existing volume

Step 1:

Create an empty file and give it any arbitrary name. For the purpose of this demonstration, let’s call our file set_options_vol.conf. Add the following lines to your newly created config file:

# The config file sets configuration options for the already existing volume.

# A volume can be created and its volume options can be set at the time of creation.

# The volume section takes key value pairs. The number of keys should match
# the number of values.

# 'action' option specifies what action id to be performed in the volume.
# The choices are: [create, delete, add-brick, remove-brick, rebalance,
# set].

[volume]
action=set
volname=10.70.42.190:sample_volume
key=cluster.nufa,performance.cache-size,cluster.data-self-heal-algorithm
value=on,256MB,full

Step 2:

Invoke gdeploy and run the file using:

$ gdeploy -c set_options_vol.conf
_images/running_gdeploy.png

Step 3:

To verify if these options are indeed set on the volume, run the following command:

$ gluster vol info
_images/verify_volume_options.png

We can see that those options have been set on the volume.

Resetting the options on the existing volume

What if you want to reset or unset some options that you no longer require? There is no unset option per se, but you can set them back to different values to unset them. This configuration will show you how to do it. Change the values in the value parameter and the rest of it will be taken care of by gdeploy based on the config file.

Step 1:

Let’s call your reset configuration file reset_options_vol.conf. Add the following lines to reset _options_vol.conf:

# This config resets options for the volume

[volume]
action=set
volname=10.70.42.190:sample_volume
key=cluster.nufa,features.lock-heal
value=off,off

Step 2:

Invoke gdeploy and run the following command:

$ gdeploy -c reset_options_vol.conf

Step 3:

To verify if options have been reset, run the following command:

$ gluster vol info

You’ll see that the desired settings have been applied on the volume.