Change Default Volume Type for Block Storage
Problem
How to set a default volume type in PCD per project.
- A request to delete the currently configured
default_volume_type
type will fail. (Manual volume-type deletion is possible, but won't work if the value is set as a configuration option.) - If the
default_volume_type_
is misconfigured with the value referring to a non-existent volume-type, requests that rely on the default volume-type (a volume-create request without specifying the volume-type) will result in a HTTP 500 response.
Environment
- Private Cloud Director Virtualization - v2025.4 and Higher
- Private Cloud Director Kubernetes – v2025.4 and Higher
- Self-Hosted Private Cloud Director Virtualization - v2025.4 and Higher
- Self-Hosted Private Cloud Director Kubernetes - v2025.4 and Higher
- Component - Block Storage
Cause
- The
default_volume_type
configuration option is required to have a value. The default value is__DEFAULT__
. - There must always be at least one volume-type defined in a Cinder installation. The type-delete call enforces this.
Procedure
A new volume creation request without explicitly specifying the volume type (explicit or in the source), Cinder will look for the default volume type specified in the Database for the specific project and use it; if there isn’t one, it will continue using the default type from cinder.conf
.
- Use the below cinder commands to set, unset or list the default volume type per project.
Cinder binary needs to be downloaded and installed on the machine from which you are running the command, as the OpenStack client won't work to set/unset the volume type.
# To set default volume type per project
$ cinder default-type-set <PROJECT_UUID> <TYPE_NAME>
# To unset default volume type per project
$ cinder default-type-unset <PROJECT_UUID>
# To list default volume type per project
$ cinder default-type-list [--project <PROJECT_UUID>]
- To set a default volume type in
cinder.conf
.
- Edit the file
/opt/pf9/etc/pf9-cindervolume-base/conf.d/cinder.conf
to add the below in the[DEFAULT]
section:
$ vim /opt/pf9/etc/pf9-cindervolume-base/conf.d/cinder.conf
[DEFAULT]
#Add below to existing values
default_volume_type = <VOLUME_TYPE_NAME>
- Restart Block Storage (cinder) service on the host
$ systemctl restart pf9-cindervolume-base
Validation
Create a new volume in the project without specifying the volume type, and the new volume should be created in the default volume configured at project level. Verify the same using below:
$ openstack volume show <VOLUME_UUID> -c type