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¶
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
Invoke gdeploy and run the file using:
$ gdeploy -c set_options_vol.conf
To verify if these options are indeed set on the volume, run the following command:
$ gluster vol info
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
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
Invoke gdeploy and run the following command:$ gdeploy -c reset_options_vol.conf
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.