Search

Chapter 8. Block Storage (cinder) Parameters

download PDF

You can modify the cinder service with block storage parameters.

ParameterDescription

ApacheCertificateKeySize

Override the private key size used when creating the certificate for this service.

ApacheTimeout

The timeout in seconds for Apache, which defines duration Apache waits for I/O operations. The default value is 90.

AuthCloudName

Entry in clouds.yaml to use for authentication.

CephClusterFSID

The Ceph cluster FSID. Must be a UUID.

CephClusterName

The Ceph cluster name. The default value is ceph.

CephConfigPath

The path where the Ceph Cluster configuration files are stored on the host. The default value is /var/lib/tripleo-config/ceph.

CephExternalMultiConfig

List of maps describing extra overrides which will be applied when configuring extra external Ceph clusters. If this list is non-empty, ceph-ansible will run an extra count(list) times using the same parameters as the first run except each parameter within each map will override the defaults. If the following were used, the second run would configure the overcloud to also use the ceph2 cluster with all the previous parameters except /etc/ceph/ceph2.conf would have a mon_host entry containing the value of external_cluster_mon_ips below, and not the default CephExternalMonHost. Subsequent ceph-ansible runs are restricted to just ceph clients. CephExternalMultiConfig may not be used to deploy additional internal Ceph clusters within one OpenStack Orchestration (heat) stack. The map for each list should contain not tripleo-heat-template parameters but ceph-ansible parameters. - cluster: ceph2 fsid: e2cba068-5f14-4b0f-b047-acf375c0004a external_cluster_mon_ips: 172.18.0.5,172.18.0.6,172.18.0.7 keys: - name: "client.openstack" caps: mgr: "allow *" mon: "profile rbd" osd: "osd: profile rbd pool=volumes, profile rbd pool=backups, profile rbd pool=vms, profile rbd pool=images" key: "AQCwmeRcAAAAABAA6SQU/bGqFjlfLro5KxrB1Q==" mode: "0600" dashboard_enabled: false.

CertificateKeySize

Specifies the private key size used when creating the certificate. The default value is 2048.

CinderApiWsgiTimeout

The number of seconds until a OpenStack Block Storage (cinder) API WSGI connection times out. The default value is 60.

CinderBackupOptVolumes

List of optional volumes to be mounted.

CinderCronDbPurgeAge

Cron to purge database entries marked as deleted and older than $age - Age. The default value is 30.

CinderCronDbPurgeDestination

Cron to purge database entries marked as deleted and older than $age - Log destination. The default value is /var/log/cinder/cinder-rowsflush.log.

CinderCronDbPurgeHour

Cron to purge database entries marked as deleted and older than $age - Hour. The default value is 0.

CinderCronDbPurgeMaxDelay

Cron to purge database entries marked as deleted and older than $age - Max Delay. The default value is 3600.

CinderCronDbPurgeMinute

Cron to purge database entries marked as deleted and older than $age - Minute. The default value is 1.

CinderCronDbPurgeMonth

Cron to purge database entries marked as deleted and older than $age - Month. The default value is *.

CinderCronDbPurgeMonthday

Cron to purge database entries marked as deleted and older than $age - Month Day. The default value is *.

CinderCronDbPurgeUser

Cron to purge database entries marked as deleted and older than $age - User. The default value is cinder.

CinderCronDbPurgeWeekday

Cron to purge database entries marked as deleted and older than $age - Week Day. The default value is *.

CinderDefaultVolumeType

The name of the OpenStack Block Storage (cinder) default volume type. The default value is tripleo.

CinderEnableDBPurge

Whether to create cron job for purging soft deleted rows in OpenStack Block Storage (cinder) database. The default value is true.

CinderEnableIscsiBackend

Whether to enable or not the Iscsi backend for OpenStack Block Storage (cinder). The default value is true.

CinderEnableNfsBackend

Whether to enable or not the NFS backend for OpenStack Block Storage (cinder). The default value is false.

CinderEnableRbdBackend

Whether to enable or not the Rbd backend for OpenStack Block Storage (cinder). The default value is false.

CinderEtcdLocalConnect

When running OpenStack Block Storage (cinder) A/A, whether to connect to Etcd via the local IP for the Etcd network. If set to true, the ip on the local node will be used. If set to false, the VIP on the Etcd network will be used instead. Defaults to false. The default value is false.

CinderImageConversionNfsOptions

NFS mount options when using an NFS share for the OpenStack Block Storage (cinder) image conversion directory. The default value is _netdev,bg,intr,context=system_u:object_r:container_file_t:s0.

CinderImageConversionNfsShare

When set, the NFS share to be used for the OpenStack Block Storage (cinder) image conversion directory.

CinderISCSIAvailabilityZone

The availability zone of the Iscsi OpenStack Block Storage (cinder) backend. When set, it overrides the default CinderStorageAvailabilityZone.

CinderISCSIHelper

The iSCSI helper to use with cinder. The default value is lioadm.

CinderISCSIProtocol

Whether to use TCP (iscsi) or iSER RDMA (iser) for iSCSI. The default value is iscsi.

CinderLVMLoopDeviceSize

The size of the loopback file used by the cinder LVM driver. The default value is 10280.

CinderNasSecureFileOperations

Controls whether security enhanced NFS file operations are enabled. Valid values are auto, true or false. Effective when CinderEnableNfsBackend is true. The default value is false.

CinderNasSecureFilePermissions

Controls whether security enhanced NFS file permissions are enabled. Valid values are auto, true or false. Effective when CinderEnableNfsBackend is true. The default value is false.

CinderNfsAvailabilityZone

The availability zone of the NFS OpenStack Block Storage (cinder) backend. When set, it overrides the default CinderStorageAvailabilityZone.

CinderNfsMountOptions

Mount options for NFS mounts used by OpenStack Block Storage (cinder) NFS backend. Effective when CinderEnableNfsBackend is true. The default value is context=system_u:object_r:container_file_t:s0.

CinderNfsServers

NFS servers used by OpenStack Block Storage (cinder) NFS backend. Effective when CinderEnableNfsBackend is true.

CinderNfsSnapshotSupport

Whether to enable support for snapshots in the NFS driver. Effective when CinderEnableNfsBackend is true. The default value is false.

CinderPassword

The password for the cinder service and database account.

CinderRbdAvailabilityZone

The availability zone of the RBD OpenStack Block Storage (cinder) backend. When set, it overrides the default CinderStorageAvailabilityZone.

CinderRbdBackendName

A list of OpenStack Block Storage (cinder) RBD backend names. The default value is tripleo_ceph.

CinderRbdExtraPools

List of extra Ceph pools for use with RBD backends for OpenStack Block Storage (cinder). An extra OpenStack Block Storage (cinder) RBD backend driver is created for each pool in the list. This is in addition to the standard RBD backend driver associated with the CinderRbdPoolName.

CinderRbdFlattenVolumeFromSnapshot

Whether RBD volumes created from a snapshot should be flattened in order to remove a dependency on the snapshot. The default value is false.

CinderRbdMultiConfig

Dictionary of settings when configuring multiple RBD backends. The hash key is the backend name, and the value is a dictionary of parameter values unique to that backend. The following parameters are required, and must match the corresponding value defined in CephExternalMultiConfig. CephClusterName (must match the CephExternalMultiConfig entry’s cluster) CephClusterFSID (must match the CephExternalMultiConfig entry’s fsid) The following parameters are optional, and override the corresponding parameter’s default value. CephClientUserName CinderRbdPoolName CinderRbdExtraPools CinderRbdAvailabilityZone CinderRbdFlattenVolumeFromSnapshot.

CinderRbdPoolName

The Ceph pool to use for cinder volumes. The default value is volumes.

CinderRpcResponseTimeout

Cinder’s RPC response timeout, in seconds. The default value is 60.

CinderStorageAvailabilityZone

The OpenStack Block Storage (cinder) service’s storage availability zone. The default value is nova.

CinderVolumeCluster

The cluster name used for deploying the cinder-volume service in an active-active (A/A) configuration. This configuration requires the OpenStack Block Storage (cinder) backend drivers support A/A, and the cinder-volume service not be managed by pacemaker. If these criteria are not met then the cluster name must be left blank.

CinderVolumeOptEnvVars

Hash of optional environment variables.

CinderVolumeOptVolumes

List of optional volumes to be mounted.

CinderWorkers

Set the number of workers for the block storage service. Note that more workers creates a larger number of processes on systems, which results in excess memory consumption. It is recommended to choose a suitable non-default value on systems with high CPU core counts. 0 sets to the OpenStack internal default, which is equal to the number of CPU cores on the node. The default value is equal to the number of vCPU cores on the physical node.

ClusterCommonTag

When set to false, a pacemaker service is configured to use a floating tag for its container image name, e.g. REGISTRY/NAMESPACE/IMAGENAME:pcmklatest. When set to true, the service uses a floating prefix as well, e.g. cluster.common.tag/IMAGENAME:pcmklatest. The default value is false.

ClusterFullTag

When set to true, the pacemaker service uses a fully constant tag for its container image name, e.g. cluster.common.tag/SERVICENAME:pcmklatest. The default value is false.

DockerCinderVolumeUlimit

Ulimit for OpenStack Block Storage (cinder) Volume Container. The default value is ['nofile=131072'].

EnableEtcdInternalTLS

Controls whether etcd and the cinder-volume service use TLS for cinder’s lock manager, even when the rest of the internal API network is using TLS. The default value is true.

EnableSQLAlchemyCollectd

Set to true to enable the SQLAlchemy-collectd server plugin. The default value is false.

MemcacheUseAdvancedPool

Use the advanced (eventlet safe) memcached client pool. The default value is true.

MultipathdEnable

Whether to enable the multipath daemon. The default value is false.

NotificationDriver

Driver or drivers to handle sending notifications. The default value is noop.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.