Liberty -  Liberty -  Liberty -  Liberty -  Liberty -  Liberty -  Liberty -  Liberty - 

 Additional options

These options can also be set in the cinder.conf file.

Table 2.62. Description of API configuration options
Configuration option = Default value Description
[DEFAULT]
api_paste_config = api-paste.ini (StrOpt) File name for the paste.deploy config for cinder-api
api_rate_limit = True (BoolOpt) Enables or disables rate limit of the API.
az_cache_duration = 3600 (IntOpt) Cache volume availability zones in memory for the provided duration in seconds
backend_host = None (StrOpt) Backend override of host value.
default_timeout = 525600 (IntOpt) Default timeout for CLI operations in minutes. For example, LUN migration is a typical long running operation, which depends on the LUN size and the load of the array. An upper bound in the specific deployment can be set to avoid unnecessary long wait. By default, it is 365 days long.
enable_v1_api = True (BoolOpt) DEPRECATED: Deploy v1 of the Cinder API.
enable_v2_api = True (BoolOpt) Deploy v2 of the Cinder API.
extra_capabilities = {} (StrOpt) User defined capabilities, a JSON formatted string specifying key/value pairs. The key/value pairs can be used by the CapabilitiesFilter to select between backends when requests specify volume types. For example, specifying a service level or the geographical location of a backend, then creating a volume type to allow the user to select by these different properties.
ignore_pool_full_threshold = False (BoolOpt) Force LUN creation even if the full threshold of pool is reached.
management_ips = (StrOpt) List of Management IP addresses (separated by commas)
max_header_line = 16384 (IntOpt) Maximum line size of message headers to be accepted. max_header_line may need to be increased when using large tokens (typically those generated by the Keystone v3 API with big service catalogs).
osapi_max_limit = 1000 (IntOpt) The maximum number of items that a collection resource returns in a single response
osapi_max_request_body_size = 114688 (IntOpt) Max size for body of a request
osapi_volume_base_URL = None (StrOpt) Base URL that will be presented to users in links to the OpenStack Volume API
osapi_volume_ext_list = (ListOpt) Specify list of extensions to load when using osapi_volume_extension option with cinder.api.contrib.select_extensions
osapi_volume_extension = ['cinder.api.contrib.standard_extensions'] (MultiStrOpt) osapi volume extension to load
osapi_volume_listen = 0.0.0.0 (StrOpt) IP address on which OpenStack Volume API listens
osapi_volume_listen_port = 8776 (IntOpt) Port on which OpenStack Volume API listens
osapi_volume_workers = None (IntOpt) Number of workers for OpenStack Volume API service. The default is equal to the number of CPUs available.
password = (StrOpt) Password for Redis server (optional).
per_volume_size_limit = -1 (IntOpt) Max size allowed per volume, in gigabytes
port = 6379 (IntOpt) Use this port to connect to redis host.
public_endpoint = None (StrOpt) Public url to use for versions endpoint. The default is None, which will use the request's host_url attribute to populate the URL base. If Cinder is operating behind a proxy, you will want to change this to represent the proxy's URL.
query_volume_filters = name, status, metadata, availability_zone (ListOpt) Volume filter options which non-admin user could use to query volumes. Default values are: ['name', 'status', 'metadata', 'availability_zone']
transfer_api_class = cinder.transfer.api.API (StrOpt) The full class name of the volume transfer API class
volume_api_class = cinder.volume.api.API (StrOpt) The full class name of the volume API class to use
volume_name_template = volume-%s (StrOpt) Template string to be used to generate volume names
volume_number_multiplier = -1.0 (FloatOpt) Multiplier used for weighing volume number. Negative numbers mean to spread vs stack.
volume_transfer_key_length = 16 (IntOpt) The number of characters in the autogenerated auth key.
volume_transfer_salt_length = 8 (IntOpt) The number of characters in the salt.
[oslo_middleware]
max_request_body_size = 114688 (IntOpt) The maximum body size for each request, in bytes.
secure_proxy_ssl_header = X-Forwarded-Proto (StrOpt) The HTTP Header that will be used to determine what the original request protocol scheme was, even if it was hidden by an SSL termination proxy.
[oslo_policy]
policy_default_rule = default (StrOpt) Default rule. Enforced when a requested rule is not found.
policy_dirs = ['policy.d'] (MultiStrOpt) Directories where policy configuration files are stored. They can be relative to any directory in the search path defined by the config_dir option, or absolute paths. The file defined by policy_file must exist for these directories to be searched. Missing or empty directories are ignored.
policy_file = policy.json (StrOpt) The JSON file that defines policies.
[oslo_versionedobjects]
fatal_exception_format_errors = False (BoolOpt) Make exception message format errors fatal

Table 2.63. Description of AMQP configuration options
Configuration option = Default value Description
[DEFAULT]
control_exchange = openstack (StrOpt) The default exchange under which topics are scoped. May be overridden by an exchange name specified in the transport_url option.
notification_driver = [] (MultiStrOpt) The Drivers(s) to handle sending notifications. Possible values are messaging, messagingv2, routing, log, test, noop
notification_topics = notifications (ListOpt) AMQP topic used for OpenStack notifications.
transport_url = None (StrOpt) A URL representing the messaging driver to use and its full configuration. If not set, we fall back to the rpc_backend option and driver specific configuration.

Table 2.64. Description of authorization configuration options
Configuration option = Default value Description
[DEFAULT]
auth_strategy = keystone (StrOpt) The strategy to use for auth. Supports noauth, keystone, and deprecated.

Table 2.65. Description of authorization token configuration options
Configuration option = Default value Description
[keystone_authtoken]
admin_password = None (StrOpt) Service user password.
admin_tenant_name = admin (StrOpt) Service tenant name.
admin_token = None (StrOpt) This option is deprecated and may be removed in a future release. Single shared secret with the Keystone configuration used for bootstrapping a Keystone installation, or otherwise bypassing the normal authentication process. This option should not be used, use `admin_user` and `admin_password` instead.
admin_user = None (StrOpt) Service username.
auth_admin_prefix = (StrOpt) Prefix to prepend at the beginning of the path. Deprecated, use identity_uri.
auth_host = 127.0.0.1 (StrOpt) Host providing the admin Identity API endpoint. Deprecated, use identity_uri.
auth_plugin = None (StrOpt) Name of the plugin to load
auth_port = 35357 (IntOpt) Port of the admin Identity API endpoint. Deprecated, use identity_uri.
auth_protocol = https (StrOpt) Protocol of the admin Identity API endpoint (http or https). Deprecated, use identity_uri.
auth_section = None (StrOpt) Config Section from which to load plugin specific options
auth_uri = None (StrOpt) Complete public Identity API endpoint.
auth_version = None (StrOpt) API version of the admin Identity API endpoint.
cache = None (StrOpt) Env key for the swift cache.
cafile = None (StrOpt) A PEM encoded Certificate Authority to use when verifying HTTPs connections. Defaults to system CAs.
certfile = None (StrOpt) Required if identity server requires client certificate
check_revocations_for_cached = False (BoolOpt) If true, the revocation list will be checked for cached tokens. This requires that PKI tokens are configured on the identity server.
delay_auth_decision = False (BoolOpt) Do not handle authorization requests within the middleware, but delegate the authorization decision to downstream WSGI components.
enforce_token_bind = permissive (StrOpt) Used to control the use and type of token binding. Can be set to: "disabled" to not check token binding. "permissive" (default) to validate binding information if the bind type is of a form known to the server and ignore it if not. "strict" like "permissive" but if the bind type is unknown the token will be rejected. "required" any form of token binding is needed to be allowed. Finally the name of a binding method that must be present in tokens.
hash_algorithms = md5 (ListOpt) Hash algorithms to use for hashing PKI tokens. This may be a single algorithm or multiple. The algorithms are those supported by Python standard hashlib.new(). The hashes will be tried in the order given, so put the preferred one first for performance. The result of the first hash will be stored in the cache. This will typically be set to multiple values only while migrating from a less secure algorithm to a more secure one. Once all the old tokens are expired this option should be set to a single value for better performance.
http_connect_timeout = None (IntOpt) Request timeout value for communicating with Identity API server.
http_request_max_retries = 3 (IntOpt) How many times are we trying to reconnect when communicating with Identity API Server.
identity_uri = None (StrOpt) Complete admin Identity API endpoint. This should specify the unversioned root endpoint e.g. https://localhost:35357/
include_service_catalog = True (BoolOpt) (Optional) Indicate whether to set the X-Service-Catalog header. If False, middleware will not ask for service catalog on token validation and will not set the X-Service-Catalog header.
insecure = False (BoolOpt) Verify HTTPS connections.
keyfile = None (StrOpt) Required if identity server requires client certificate
memcache_pool_conn_get_timeout = 10 (IntOpt) (Optional) Number of seconds that an operation will wait to get a memcached client connection from the pool.
memcache_pool_dead_retry = 300 (IntOpt) (Optional) Number of seconds memcached server is considered dead before it is tried again.
memcache_pool_maxsize = 10 (IntOpt) (Optional) Maximum total number of open connections to every memcached server.
memcache_pool_socket_timeout = 3 (IntOpt) (Optional) Socket timeout in seconds for communicating with a memcached server.
memcache_pool_unused_timeout = 60 (IntOpt) (Optional) Number of seconds a connection to memcached is held unused in the pool before it is closed.
memcache_secret_key = None (StrOpt) (Optional, mandatory if memcache_security_strategy is defined) This string is used for key derivation.
memcache_security_strategy = None (StrOpt) (Optional) If defined, indicate whether token data should be authenticated or authenticated and encrypted. Acceptable values are MAC or ENCRYPT. If MAC, token data is authenticated (with HMAC) in the cache. If ENCRYPT, token data is encrypted and authenticated in the cache. If the value is not one of these options or empty, auth_token will raise an exception on initialization.
memcache_use_advanced_pool = False (BoolOpt) (Optional) Use the advanced (eventlet safe) memcached client pool. The advanced pool will only work under python 2.x.
region_name = None (StrOpt) The region in which the identity server can be found.
revocation_cache_time = 10 (IntOpt) Determines the frequency at which the list of revoked tokens is retrieved from the Identity service (in seconds). A high number of revocation events combined with a low cache duration may significantly reduce performance.
signing_dir = None (StrOpt) Directory used to cache files related to PKI tokens.
token_cache_time = 300 (IntOpt) In order to prevent excessive effort spent validating tokens, the middleware caches previously-seen tokens for a configurable duration (in seconds). Set to -1 to disable caching completely.

Table 2.66. Description of backups configuration options
Configuration option = Default value Description
[DEFAULT]
backup_api_class = cinder.backup.api.API (StrOpt) The full class name of the volume backup API class
backup_compression_algorithm = zlib (StrOpt) Compression algorithm (None to disable)
backup_driver = cinder.backup.drivers.swift (StrOpt) Driver to use for backups.
backup_manager = cinder.backup.manager.BackupManager (StrOpt) Full class name for the Manager for volume backup
backup_metadata_version = 2 (IntOpt) Backup metadata version to be used when backing up volume metadata. If this number is bumped, make sure the service doing the restore supports the new version.
backup_name_template = backup-%s (StrOpt) Template string to be used to generate backup names
backup_object_number_per_notification = 10 (IntOpt) The number of chunks or objects, for which one Ceilometer notification will be sent
backup_posix_path = $state_path/backup (StrOpt) Path specifying where to store backups.
backup_service_inithost_offload = False (BoolOpt) Offload pending backup delete during backup service startup.
backup_timer_interval = 120 (IntOpt) Interval, in seconds, between two progress notifications reporting the backup status
backup_topic = cinder-backup (StrOpt) The topic that volume backup nodes listen on
snapshot_name_template = snapshot-%s (StrOpt) Template string to be used to generate snapshot names
snapshot_same_host = True (BoolOpt) Create volume from snapshot at the host where snapshot resides

Table 2.67. Description of block device configuration options
Configuration option = Default value Description
[DEFAULT]
available_devices = (ListOpt) List of all available devices

Table 2.68. Description of CA and SSL configuration options
Configuration option = Default value Description
[DEFAULT]
ssl_ca_file = None (StrOpt) CA certificate file to use to verify connecting clients
ssl_cert_file = None (StrOpt) Certificate file to use when starting the server securely
ssl_key_file = None (StrOpt) Private key file to use when starting the server securely

Table 2.69. Description of CloudByte volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
cb_account_name = None (StrOpt) CloudByte storage specific account name. This maps to a project name in OpenStack.
cb_add_qosgroup = {'latency': '15', 'iops': '10', 'graceallowed': 'false', 'iopscontrol': 'true', 'memlimit': '0', 'throughput': '0', 'tpcontrol': 'false', 'networkspeed': '0'} (DictOpt) These values will be used for CloudByte storage's addQos API call.
cb_apikey = None (StrOpt) Driver will use this API key to authenticate against the CloudByte storage's management interface.
cb_auth_group = None (StrOpt) This corresponds to the discovery authentication group in CloudByte storage. Chap users are added to this group. Driver uses the first user found for this group. Default value is None.
cb_confirm_volume_create_retries = 3 (IntOpt) Will confirm a successful volume creation in CloudByte storage by making this many number of attempts.
cb_confirm_volume_create_retry_interval = 5 (IntOpt) A retry value in seconds. Will be used by the driver to check if volume creation was successful in CloudByte storage.
cb_confirm_volume_delete_retries = 3 (IntOpt) Will confirm a successful volume deletion in CloudByte storage by making this many number of attempts.
cb_confirm_volume_delete_retry_interval = 5 (IntOpt) A retry value in seconds. Will be used by the driver to check if volume deletion was successful in CloudByte storage.
cb_create_volume = {'compression': 'off', 'deduplication': 'off', 'blocklength': '512B', 'sync': 'always', 'protocoltype': 'ISCSI', 'recordsize': '16k'} (DictOpt) These values will be used for CloudByte storage's createVolume API call.
cb_tsm_name = None (StrOpt) This corresponds to the name of Tenant Storage Machine (TSM) in CloudByte storage. A volume will be created in this TSM.

Table 2.70. Description of common configuration options
Configuration option = Default value Description
[DEFAULT]
allow_availability_zone_fallback = False (BoolOpt) If the requested Cinder availability zone is unavailable, fall back to the value of default_availability_zone, then storage_availability_zone, instead of failing.
chap_password = (StrOpt) Password for specified CHAP account name.
chap_username = (StrOpt) CHAP user name.
chiscsi_conf = /etc/chelsio-iscsi/chiscsi.conf (StrOpt) Chiscsi (CXT) global defaults configuration file
cinder_internal_tenant_project_id = None (StrOpt) ID of the project which will be used as the Cinder internal tenant.
cinder_internal_tenant_user_id = None (StrOpt) ID of the user to be used in volume operations as the Cinder internal tenant.
client_socket_timeout = 900 (IntOpt) Timeout for client connections' socket operations. If an incoming connection is idle for this number of seconds it will be closed. A value of '0' means wait forever.
compute_api_class = cinder.compute.nova.API (StrOpt) The full class name of the compute API class to use
consistencygroup_api_class = cinder.consistencygroup.api.API (StrOpt) The full class name of the consistencygroup API class
default_availability_zone = None (StrOpt) Default availability zone for new volumes. If not set, the storage_availability_zone option value is used as the default for new volumes.
default_volume_type = None (StrOpt) Default volume type to use
driver_data_namespace = None (StrOpt) Namespace for driver private data values to be saved in.
driver_ssl_cert_verify = False (BoolOpt) If set to True the http client will validate the SSL certificate of the backend endpoint.
enable_force_upload = False (BoolOpt) Enables the Force option on upload_to_image. This enables running upload_volume on in-use volumes for backends that support it.
enable_new_services = True (BoolOpt) Services to be added to the available pool on create
end_time = None (StrOpt) If this option is specified then the end time specified is used instead of the end time of the last completed audit period.
enforce_multipath_for_image_xfer = False (BoolOpt) If this is set to True, attachment of volumes for image transfer will be aborted when multipathd is not running. Otherwise, it will fallback to single path.
executor_thread_pool_size = 64 (IntOpt) Size of executor thread pool.
host = localhost (StrOpt) Name of this node. This can be an opaque identifier. It is not necessarily a host name, FQDN, or IP address.
iet_conf = /etc/iet/ietd.conf (StrOpt) IET configuration file
iscsi_secondary_ip_addresses = (ListOpt) The list of secondary IP addresses of the iSCSI daemon
managed_replication_target = True (BoolOpt) There are two types of target configurations managed (replicate to another configured backend) or unmanaged (replicate to a device not managed by Cinder).
max_over_subscription_ratio = 20.0 (FloatOpt) Float representation of the over subscription ratio when thin provisioning is involved. Default ratio is 20.0, meaning provisioned capacity can be 20 times of the total physical capacity. If the ratio is 10.5, it means provisioned capacity can be 10.5 times of the total physical capacity. A ratio of 1.0 means provisioned capacity cannot exceed the total physical capacity. A ratio lower than 1.0 will be ignored and the default value will be used instead.
memcached_servers = None (ListOpt) Memcached servers or None for in process cache.
monkey_patch = False (BoolOpt) Enable monkey patching
monkey_patch_modules = (ListOpt) List of modules/decorators to monkey patch
my_ip = 10.0.0.1 (StrOpt) IP address of this host
no_snapshot_gb_quota = False (BoolOpt) Whether snapshots count against gigabyte quota
num_shell_tries = 3 (IntOpt) Number of times to attempt to run flakey shell commands
os_privileged_user_auth_url = None (StrOpt) Auth URL associated with the OpenStack privileged account.
os_privileged_user_name = None (StrOpt) OpenStack privileged account username. Used for requests to other services (such as Nova) that require an account with special rights.
os_privileged_user_password = None (StrOpt) Password associated with the OpenStack privileged account.
os_privileged_user_tenant = None (StrOpt) Tenant name associated with the OpenStack privileged account.
periodic_fuzzy_delay = 60 (IntOpt) Range, in seconds, to randomly delay when starting the periodic task scheduler to reduce stampeding. (Disable by setting to 0)
periodic_interval = 60 (IntOpt) Interval, in seconds, between running periodic tasks
replication_api_class = cinder.replication.api.API (StrOpt) The full class name of the volume replication API class
replication_devices = None (ListOpt) List of k/v pairs representing a replication target for this backend device. For unmanaged the format is: {'key-1'='val1' 'key-2'='val2'...},{...} and for managed devices its simply a list of valid configured backend_names that the driver supports replicating to: backend-a,bakcend-b...
report_interval = 10 (IntOpt) Interval, in seconds, between nodes reporting state to datastore
request_timeout = 300 (IntOpt) Global backend request timeout, in seconds
reserved_percentage = 0 (IntOpt) The percentage of backend capacity is reserved
rootwrap_config = /etc/cinder/rootwrap.conf (StrOpt) Path to the rootwrap configuration file to use for running commands as root
send_actions = False (BoolOpt) Send the volume and snapshot create and delete notifications generated in the specified period.
service_down_time = 60 (IntOpt) Maximum time since last check-in for a service to be considered up
sqlite_clean_db = clean.sqlite (StrOpt) File name of clean sqlite db
ssh_hosts_key_file = $state_path/ssh_known_hosts (StrOpt) File containing SSH host keys for the systems with which Cinder needs to communicate. OPTIONAL: Default=$state_path/ssh_known_hosts
start_time = None (StrOpt) If this option is specified then the start time specified is used instead of the start time of the last completed audit period.
state_path = /var/lib/cinder (StrOpt) Top-level directory for maintaining cinder's state
storage_availability_zone = nova (StrOpt) Availability zone of this node
strict_ssh_host_key_policy = False (BoolOpt) Option to enable strict host key checking. When set to "True" Cinder will only connect to systems with a host key present in the configured "ssh_hosts_key_file". When set to "False" the host key will be saved upon first connection and used for subsequent connections. Default=False
tcp_keepalive = True (BoolOpt) Sets the value of TCP_KEEPALIVE (True/False) for each server socket.
tcp_keepalive_count = None (IntOpt) Sets the value of TCP_KEEPCNT for each server socket. Not supported on OS X.
tcp_keepalive_interval = None (IntOpt) Sets the value of TCP_KEEPINTVL in seconds for each server socket. Not supported on OS X.
tcp_keepidle = 600 (IntOpt) Sets the value of TCP_KEEPIDLE in seconds for each server socket. Not supported on OS X.
until_refresh = 0 (IntOpt) Count of reservations until usage is refreshed
use_chap_auth = False (BoolOpt) Option to enable/disable CHAP authentication for targets.
use_forwarded_for = False (BoolOpt) Treat X-Forwarded-For as the canonical remote address. Only enable this if you have a sanitizing proxy.
watch_log_file = False (BoolOpt) (Optional) Uses logging handler designed to watch file system. When log file is moved or removed this handler will open a new log file with specified path instantaneously. It makes sense only if log-file option is specified and Linux platform is used. This option is ignored if log_config_append is set.
wsgi_keep_alive = True (BoolOpt) If False, closes the client socket connection explicitly. Setting it to True to maintain backward compatibility. Recommended setting is set it to False.
[keystone_authtoken]
memcached_servers = None (ListOpt) Optionally specify a list of memcached server(s) to use for caching. If left undefined, tokens will instead be cached in-process.

Table 2.71. Description of Compute configuration options
Configuration option = Default value Description
[DEFAULT]
nova_api_insecure = False (BoolOpt) Allow to perform insecure SSL requests to nova
nova_ca_certificates_file = None (StrOpt) Location of ca certificates file to use for nova client requests.
nova_catalog_admin_info = compute:Compute Service:adminURL (StrOpt) Same as nova_catalog_info, but for admin endpoint.
nova_catalog_info = compute:Compute Service:publicURL (StrOpt) Match this value when searching for nova in the service catalog. Format is: separated values of the form: <service_type>:<service_name>:<endpoint_type>
nova_endpoint_admin_template = None (StrOpt) Same as nova_endpoint_template, but for admin endpoint.
nova_endpoint_template = None (StrOpt) Override service catalog lookup with template for nova endpoint e.g. http://localhost:8774/v2/%(project_id)s
os_region_name = None (StrOpt) Region name of this node

Table 2.72. Description of CORS configuration options
Configuration option = Default value Description
[cors]
allow_credentials = True (BoolOpt) Indicate that the actual request can include user credentials
allow_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which header field names may be used during the actual request.
allow_methods = GET, POST, PUT, DELETE, OPTIONS (ListOpt) Indicate which methods can be used during the actual request.
allowed_origin = None (StrOpt) Indicate whether this resource may be shared with the domain received in the requests "origin" header.
expose_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which headers are safe to expose to the API. Defaults to HTTP Simple Headers.
max_age = 3600 (IntOpt) Maximum cache age of CORS preflight requests.
[cors.subdomain]
allow_credentials = True (BoolOpt) Indicate that the actual request can include user credentials
allow_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which header field names may be used during the actual request.
allow_methods = GET, POST, PUT, DELETE, OPTIONS (ListOpt) Indicate which methods can be used during the actual request.
allowed_origin = None (StrOpt) Indicate whether this resource may be shared with the domain received in the requests "origin" header.
expose_headers = Content-Type, Cache-Control, Content-Language, Expires, Last-Modified, Pragma (ListOpt) Indicate which headers are safe to expose to the API. Defaults to HTTP Simple Headers.
max_age = 3600 (IntOpt) Maximum cache age of CORS preflight requests.

Table 2.73. Description of database configuration options
Configuration option = Default value Description
[DEFAULT]
db_driver = cinder.db (StrOpt) Driver to use for database access
[database]
backend = sqlalchemy (StrOpt) The back end to use for the database.
connection = None (StrOpt) The SQLAlchemy connection string to use to connect to the database.
connection_debug = 0 (IntOpt) Verbosity of SQL debugging information: 0=None, 100=Everything.
connection_trace = False (BoolOpt) Add Python stack traces to SQL as comment strings.
db_inc_retry_interval = True (BoolOpt) If True, increases the interval between retries of a database operation up to db_max_retry_interval.
db_max_retries = 20 (IntOpt) Maximum retries in case of connection error or deadlock error before error is raised. Set to -1 to specify an infinite retry count.
db_max_retry_interval = 10 (IntOpt) If db_inc_retry_interval is set, the maximum seconds between retries of a database operation.
db_retry_interval = 1 (IntOpt) Seconds between retries of a database transaction.
idle_timeout = 3600 (IntOpt) Timeout before idle SQL connections are reaped.
max_overflow = None (IntOpt) If set, use this value for max_overflow with SQLAlchemy.
max_pool_size = None (IntOpt) Maximum number of SQL connections to keep open in a pool.
max_retries = 10 (IntOpt) Maximum number of database connection retries during startup. Set to -1 to specify an infinite retry count.
min_pool_size = 1 (IntOpt) Minimum number of SQL connections to keep open in a pool.
mysql_sql_mode = TRADITIONAL (StrOpt) The SQL mode to be used for MySQL sessions. This option, including the default, overrides any server-set SQL mode. To use whatever SQL mode is set by the server configuration, set this to no value. Example: mysql_sql_mode=
pool_timeout = None (IntOpt) If set, use this value for pool_timeout with SQLAlchemy.
retry_interval = 10 (IntOpt) Interval between retries of opening a SQL connection.
slave_connection = None (StrOpt) The SQLAlchemy connection string to use to connect to the slave database.
sqlite_db = oslo.sqlite (StrOpt) The file name to use with SQLite.
sqlite_synchronous = True (BoolOpt) If True, SQLite uses synchronous mode.
use_db_reconnect = False (BoolOpt) Enable the experimental use of database reconnect on connection lost.
use_tpool = False (BoolOpt) Enable the experimental use of thread pooling for all DB API calls

Table 2.74. Description of logging configuration options
Configuration option = Default value Description
[DEFAULT]
trace_flags = None (ListOpt) List of options that control which trace info is written to the DEBUG log level to assist developers. Valid values are method and api.

Table 2.75. Description of DRBD configuration options
Configuration option = Default value Description
[DEFAULT]
drbdmanage_redundancy = 1 (StrOpt) Number of nodes that should replicate the data.

Table 2.76. Description of EMC configuration options
Configuration option = Default value Description
[DEFAULT]
check_max_pool_luns_threshold = False (BoolOpt) Report free_capacity_gb as 0 when the limit to maximum number of pool LUNs is reached. By default, the value is False.
cinder_emc_config_file = /etc/cinder/cinder_emc_config.xml (StrOpt) use this file for cinder emc plugin config data
destroy_empty_storage_group = False (BoolOpt) To destroy storage group when the last LUN is removed from it. By default, the value is False.
force_delete_lun_in_storagegroup = False (BoolOpt) Delete a LUN even if it is in Storage Groups.
initiator_auto_deregistration = False (BoolOpt) Automatically deregister initiators after the related storage group is destroyed. By default, the value is False.
initiator_auto_registration = False (BoolOpt) Automatically register initiators. By default, the value is False.
io_port_list = * (StrOpt) Comma separated iSCSI or FC ports to be used in Nova or Cinder.
iscsi_initiators = (StrOpt) Mapping between hostname and its iSCSI initiator IP addresses.
max_luns_per_storage_group = 255 (IntOpt) Default max number of LUNs in a storage group. By default, the value is 255.
naviseccli_path = (StrOpt) Naviseccli Path.
storage_vnx_authentication_type = global (StrOpt) VNX authentication scope type.
storage_vnx_pool_names = None (StrOpt) Comma-separated list of storage pool names to be used.
storage_vnx_security_file_dir = None (StrOpt) Directory path that contains the VNX security file. Make sure the security file is generated first.
xtremio_array_busy_retry_count = 5 (IntOpt) Number of retries in case array is busy
xtremio_array_busy_retry_interval = 5 (IntOpt) Interval between retries in case array is busy
xtremio_cluster_name = (StrOpt) XMS cluster id in multi-cluster environment

Table 2.77. Description of IBM FlashSystem volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
flashsystem_connection_protocol = FC (StrOpt) Connection protocol should be FC. (Default is FC.)
flashsystem_iscsi_portid = 0 (IntOpt) Default iSCSI Port ID of FlashSystem. (Default port is 0.)
flashsystem_multihostmap_enabled = True (BoolOpt) Allows vdisk to multi host mapping. (Default is True)
flashsystem_multipath_enabled = False (BoolOpt) Connect with multipath (FC only).(Default is false.)

Table 2.78. Description of HGST volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
hgst_net = Net 1 (IPv4) (StrOpt) Space network name to use for data transfer
hgst_redundancy = 0 (StrOpt) Should spaces be redundantly stored (1/0)
hgst_space_group = disk (StrOpt) Group to own created spaces
hgst_space_mode = 0600 (StrOpt) UNIX mode for created spaces
hgst_space_user = root (StrOpt) User to own created spaces
hgst_storage_servers = os:gbd0 (StrOpt) Comma separated list of Space storage servers:devices. ex: os1_stor:gbd0,os2_stor:gbd0

Table 2.79. Description of HP LeftHand/StoreVirtual driver configuration options
Configuration option = Default value Description
[DEFAULT]
hplefthand_api_url = None (StrOpt) HP LeftHand WSAPI Server Url like https://<LeftHand ip>:8081/lhos
hplefthand_clustername = None (StrOpt) HP LeftHand cluster name
hplefthand_debug = False (BoolOpt) Enable HTTP debugging to LeftHand
hplefthand_iscsi_chap_enabled = False (BoolOpt) Configure CHAP authentication for iSCSI connections (Default: Disabled)
hplefthand_password = None (StrOpt) HP LeftHand Super user password
hplefthand_username = None (StrOpt) HP LeftHand Super user username

Table 2.80. Description of HP XP volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
hpxp_async_copy_check_interval = 10 (IntOpt) Interval to check copy asynchronously
hpxp_compute_target_ports = None (ListOpt) Target port names of compute node for host group or iSCSI target
hpxp_copy_check_interval = 3 (IntOpt) Interval to check copy
hpxp_copy_speed = 3 (IntOpt) Copy speed of storage system
hpxp_default_copy_method = FULL (StrOpt) Default copy method of storage system. There are two valid values: "FULL" specifies that a full copy; "THIN" specifies that a thin copy. Default value is "FULL"
hpxp_group_request = False (BoolOpt) Request for creating host group or iSCSI target
hpxp_horcm_add_conf = True (BoolOpt) Add to HORCM configuration
hpxp_horcm_name_only_discovery = False (BoolOpt) Only discover a specific name of host group or iSCSI target
hpxp_horcm_numbers = 200, 201 (ListOpt) Instance numbers for HORCM
hpxp_horcm_resource_name = meta_resource (StrOpt) Resource group name of storage system for HORCM
hpxp_horcm_user = None (StrOpt) Username of storage system for HORCM
hpxp_ldev_range = None (StrOpt) Logical device range of storage system
hpxp_pool = None (StrOpt) Pool of storage system
hpxp_storage_cli = None (StrOpt) Type of storage command line interface
hpxp_storage_id = None (StrOpt) ID of storage system
hpxp_target_ports = None (ListOpt) Target port names for host group or iSCSI target
hpxp_thin_pool = None (StrOpt) Thin pool of storage system
hpxp_zoning_request = False (BoolOpt) Request for FC Zone creating host group

Table 2.81. Description of Huawei storage driver configuration options
Configuration option = Default value Description
[DEFAULT]
cinder_huawei_conf_file = /etc/cinder/cinder_huawei_conf.xml (StrOpt) The configuration file for the Cinder Huawei driver.

Table 2.82. Description of images configuration options
Configuration option = Default value Description
[DEFAULT]
allowed_direct_url_schemes = (ListOpt) A list of url schemes that can be downloaded directly via the direct_url. Currently supported schemes: [file].
glance_api_insecure = False (BoolOpt) Allow to perform insecure SSL (https) requests to glance
glance_api_servers = $glance_host:$glance_port (ListOpt) A list of the glance API servers available to cinder ([hostname|ip]:port)
glance_api_ssl_compression = False (BoolOpt) Enables or disables negotiation of SSL layer compression. In some cases disabling compression can improve data throughput, such as when high network bandwidth is available and you use compressed image formats like qcow2.
glance_api_version = 1 (IntOpt) Version of the glance API to use
glance_ca_certificates_file = None (StrOpt) Location of ca certificates file to use for glance client requests.
glance_core_properties = checksum, container_format, disk_format, image_name, image_id, min_disk, min_ram, name, size (ListOpt) Default core properties of image
glance_host = $my_ip (StrOpt) Default glance host name or IP
glance_num_retries = 0 (IntOpt) Number retries when downloading an image from glance
glance_port = 9292 (IntOpt) Default glance port
glance_request_timeout = None (IntOpt) http/https timeout value for glance operations. If no value (None) is supplied here, the glanceclient default value is used.
image_conversion_dir = $state_path/conversion (StrOpt) Directory used for temporary storage during image conversion
image_upload_use_cinder_backend = False (BoolOpt) If set to True, upload-to-image in raw format will create a cloned volume and register its location to the image service, instead of uploading the volume content. The cinder backend and locations support must be enabled in the image service, and glance_api_version must be set to 2.
image_upload_use_internal_tenant = False (BoolOpt) If set to True, the image volume created by upload-to-image will be placed in the internal tenant. Otherwise, the image volume is created in the current context's tenant.
image_volume_cache_enabled = False (BoolOpt) Enable the image volume cache for this backend.
image_volume_cache_max_count = 0 (IntOpt) Max number of entries allowed in the image volume cache. 0 => unlimited.
image_volume_cache_max_size_gb = 0 (IntOpt) Max size of the image volume cache for this backend in GB. 0 => unlimited.
use_multipath_for_image_xfer = False (BoolOpt) Do we attach/detach volumes in cinder using multipath for volume to image and image to volume transfers?

Table 2.83. Description of Infortrend volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
infortrend_cli_max_retries = 5 (IntOpt) Maximum retry time for cli. Default is 5.
infortrend_cli_path = /opt/bin/Infortrend/raidcmd_ESDS10.jar (StrOpt) The Infortrend CLI absolute path. By default, it is at /opt/bin/Infortrend/raidcmd_ESDS10.jar
infortrend_cli_timeout = 30 (IntOpt) Default timeout for CLI copy operations in minutes. Support: migrate volume, create cloned volume and create volume from snapshot. By Default, it is 30 minutes.
infortrend_pools_name = (StrOpt) Infortrend raid pool name list. It is separated with comma.
infortrend_provisioning = full (StrOpt) Let the volume use specific provisioning. By default, it is the full provisioning. The supported options are full or thin.
infortrend_slots_a_channels_id = 0,1,2,3,4,5,6,7 (StrOpt) Infortrend raid channel ID list on Slot A for OpenStack usage. It is separated with comma. By default, it is the channel 0~7.
infortrend_slots_b_channels_id = 0,1,2,3,4,5,6,7 (StrOpt) Infortrend raid channel ID list on Slot B for OpenStack usage. It is separated with comma. By default, it is the channel 0~7.
infortrend_tiering = 0 (StrOpt) Let the volume use specific tiering level. By default, it is the level 0. The supported levels are 0,2,3,4.

Table 2.84. Description of key manager configuration options
Configuration option = Default value Description
[keymgr]
api_class = cinder.keymgr.conf_key_mgr.ConfKeyManager (StrOpt) The full class name of the key manager API class
encryption_api_url = http://localhost:9311/v1 (StrOpt) Url for encryption service.
encryption_auth_url = http://localhost:5000/v3 (StrOpt) Authentication url for encryption service.
fixed_key = None (StrOpt) Fixed key returned by key manager, specified in hex

Table 2.85. Description of logging configuration options
Configuration option = Default value Description
[DEFAULT]
debug = False (BoolOpt) Print debugging output (set logging level to DEBUG instead of default INFO level).
default_log_levels = amqp=WARN, amqplib=WARN, boto=WARN, qpid=WARN, sqlalchemy=WARN, suds=INFO, oslo.messaging=INFO, iso8601=WARN, requests.packages.urllib3.connectionpool=WARN, urllib3.connectionpool=WARN, websocket=WARN, requests.packages.urllib3.util.retry=WARN, urllib3.util.retry=WARN, keystonemiddleware=WARN, routes.middleware=WARN, stevedore=WARN, taskflow=WARN (ListOpt) List of logger=LEVEL pairs. This option is ignored if log_config_append is set.
fatal_deprecations = False (BoolOpt) Enables or disables fatal status of deprecations.
fatal_exception_format_errors = False (BoolOpt) Make exception message format errors fatal.
instance_format = "[instance: %(uuid)s] " (StrOpt) The format for an instance that is passed with the log message.
instance_uuid_format = "[instance: %(uuid)s] " (StrOpt) The format for an instance UUID that is passed with the log message.
log_config_append = None (StrOpt) The name of a logging configuration file. This file is appended to any existing logging configuration files. For details about logging configuration files, see the Python logging module documentation. Note that when logging configuration files are used then all logging configuration is set in the configuration file and other logging configuration options are ignored (for example, log_format).
log_date_format = %Y-%m-%d %H:%M:%S (StrOpt) Format string for %%(asctime)s in log records. Default: %(default)s . This option is ignored if log_config_append is set.
log_dir = None (StrOpt) (Optional) The base directory used for relative --log-file paths. This option is ignored if log_config_append is set.
log_file = None (StrOpt) (Optional) Name of log file to output to. If no default is set, logging will go to stdout. This option is ignored if log_config_append is set.
log_format = None (StrOpt) DEPRECATED. A logging.Formatter log message format string which may use any of the available logging.LogRecord attributes. This option is deprecated. Please use logging_context_format_string and logging_default_format_string instead. This option is ignored if log_config_append is set.
logging_context_format_string = %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [%(request_id)s %(user_identity)s] %(instance)s%(message)s (StrOpt) Format string to use for log messages with context.
logging_debug_format_suffix = %(funcName)s %(pathname)s:%(lineno)d (StrOpt) Data to append to log format when level is DEBUG.
logging_default_format_string = %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [-] %(instance)s%(message)s (StrOpt) Format string to use for log messages without context.
logging_exception_prefix = %(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s (StrOpt) Prefix each line of exception output with this format.
publish_errors = False (BoolOpt) Enables or disables publication of error events.
syslog_log_facility = LOG_USER (StrOpt) Syslog facility to receive log lines. This option is ignored if log_config_append is set.
use_stderr = True (BoolOpt) Log output to standard error. This option is ignored if log_config_append is set.
use_syslog = False (BoolOpt) Use syslog for logging. Existing syslog format is DEPRECATED and will be changed later to honor RFC5424. This option is ignored if log_config_append is set.
use_syslog_rfc_format = True (BoolOpt) (Optional) Enables or disables syslog rfc5424 format for logging. If enabled, prefixes the MSG part of the syslog message with APP-NAME (RFC5424). The format without the APP-NAME is deprecated in Kilo, and will be removed in Mitaka, along with this option. This option is ignored if log_config_append is set.
verbose = True (BoolOpt) If set to false, will disable INFO logging level, making WARNING the default.

Table 2.86. Description of Open vStorage driver configuration options
Configuration option = Default value Description
[DEFAULT]
vpool_name = (StrOpt) Vpool to use for volumes - backend is defined by vpool not by us.

Table 2.87. Description of profiler configuration options
Configuration option = Default value Description
[profiler]
profiler_enabled = False (BoolOpt) If False fully disable profiling feature.
trace_sqlalchemy = False (BoolOpt) If False doesn't trace SQL requests.

Table 2.88. Description of Pure Storage driver configuration options
Configuration option = Default value Description
[DEFAULT]
pure_api_token = None (StrOpt) REST API authorization token.

Table 2.89. Description of Qpid configuration options
Configuration option = Default value Description
[oslo_messaging_qpid]
amqp_auto_delete = False (BoolOpt) Auto-delete queues in AMQP.
amqp_durable_queues = False (BoolOpt) Use durable queues in AMQP.
qpid_heartbeat = 60 (IntOpt) Seconds between connection keepalive heartbeats.
qpid_hostname = localhost (StrOpt) Qpid broker hostname.
qpid_hosts = $qpid_hostname:$qpid_port (ListOpt) Qpid HA cluster host:port pairs.
qpid_password = (StrOpt) Password for Qpid connection.
qpid_port = 5672 (IntOpt) Qpid broker port.
qpid_protocol = tcp (StrOpt) Transport to use, either 'tcp' or 'ssl'.
qpid_receiver_capacity = 1 (IntOpt) The number of prefetched messages held by receiver.
qpid_sasl_mechanisms = (StrOpt) Space separated list of SASL mechanisms to use for auth.
qpid_tcp_nodelay = True (BoolOpt) Whether to disable the Nagle algorithm.
qpid_topology_version = 1 (IntOpt) The qpid topology version to use. Version 1 is what was originally used by impl_qpid. Version 2 includes some backwards-incompatible changes that allow broker federation to work. Users should update to version 2 when they are able to take everything down, as it requires a clean break.
qpid_username = (StrOpt) Username for Qpid connection.
send_single_reply = False (BoolOpt) Send a single AMQP reply to call message. The current behaviour since oslo-incubator is to send two AMQP replies - first one with the payload, a second one to ensure the other have finish to send the payload. We are going to remove it in the N release, but we must keep backward compatible at the same time. This option provides such compatibility - it defaults to False in Liberty and can be turned on for early adopters with a new installations or for testing. Please note, that this option will be removed in the Mitaka release.

Table 2.90. Description of Quobyte USP volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
quobyte_client_cfg = None (StrOpt) Path to a Quobyte Client configuration file.
quobyte_mount_point_base = $state_path/mnt (StrOpt) Base dir containing the mount point for the Quobyte volume.
quobyte_qcow2_volumes = True (BoolOpt) Create volumes as QCOW2 files rather than raw files.
quobyte_sparsed_volumes = True (BoolOpt) Create volumes as sparse files which take no space. If set to False, volume is created as regular file.In such case volume creation takes a lot of time.
quobyte_volume_url = None (StrOpt) URL to the Quobyte volume e.g., quobyte://<DIR host>/<volume name>

Table 2.91. Description of quota configuration options
Configuration option = Default value Description
[DEFAULT]
max_age = 0 (IntOpt) Number of seconds between subsequent usage refreshes
quota_backup_gigabytes = 1000 (IntOpt) Total amount of storage, in gigabytes, allowed for backups per project
quota_backups = 10 (IntOpt) Number of volume backups allowed per project
quota_consistencygroups = 10 (IntOpt) Number of consistencygroups allowed per project
quota_driver = cinder.quota.DbQuotaDriver (StrOpt) Default driver to use for quota checks
quota_gigabytes = 1000 (IntOpt) Total amount of storage, in gigabytes, allowed for volumes and snapshots per project
quota_snapshots = 10 (IntOpt) Number of volume snapshots allowed per project
quota_volumes = 10 (IntOpt) Number of volumes allowed per project
reservation_expire = 86400 (IntOpt) Number of seconds until a reservation expires
use_default_quota_class = True (BoolOpt) Enables or disables use of default quota class with default quota.

Table 2.92. Description of RabbitMQ configuration options
Configuration option = Default value Description
[oslo_messaging_rabbit]
amqp_auto_delete = False (BoolOpt) Auto-delete queues in AMQP.
amqp_durable_queues = False (BoolOpt) Use durable queues in AMQP.
fake_rabbit = False (BoolOpt) Deprecated, use rpc_backend=kombu+memory or rpc_backend=fake
heartbeat_rate = 2 (IntOpt) How often times during the heartbeat_timeout_threshold we check the heartbeat.
heartbeat_timeout_threshold = 60 (IntOpt) Number of seconds after which the Rabbit broker is considered down if heartbeat's keep-alive fails (0 disable the heartbeat). EXPERIMENTAL
kombu_reconnect_delay = 1.0 (FloatOpt) How long to wait before reconnecting in response to an AMQP consumer cancel notification.
kombu_reconnect_timeout = 60 (IntOpt) How long to wait before considering a reconnect attempt to have failed. This value should not be longer than rpc_response_timeout.
kombu_ssl_ca_certs = (StrOpt) SSL certification authority file (valid only if SSL enabled).
kombu_ssl_certfile = (StrOpt) SSL cert file (valid only if SSL enabled).
kombu_ssl_keyfile = (StrOpt) SSL key file (valid only if SSL enabled).
kombu_ssl_version = (StrOpt) SSL version to use (valid only if SSL enabled). Valid values are TLSv1 and SSLv23. SSLv2, SSLv3, TLSv1_1, and TLSv1_2 may be available on some distributions.
rabbit_ha_queues = False (BoolOpt) Use HA queues in RabbitMQ (x-ha-policy: all). If you change this option, you must wipe the RabbitMQ database.
rabbit_host = localhost (StrOpt) The RabbitMQ broker address where a single node is used.
rabbit_hosts = $rabbit_host:$rabbit_port (ListOpt) RabbitMQ HA cluster host:port pairs.
rabbit_login_method = AMQPLAIN (StrOpt) The RabbitMQ login method.
rabbit_max_retries = 0 (IntOpt) Maximum number of RabbitMQ connection retries. Default is 0 (infinite retry count).
rabbit_password = guest (StrOpt) The RabbitMQ password.
rabbit_port = 5672 (IntOpt) The RabbitMQ broker port where a single node is used.
rabbit_retry_backoff = 2 (IntOpt) How long to backoff for between retries when connecting to RabbitMQ.
rabbit_retry_interval = 1 (IntOpt) How frequently to retry connecting with RabbitMQ.
rabbit_use_ssl = False (BoolOpt) Connect over SSL for RabbitMQ.
rabbit_userid = guest (StrOpt) The RabbitMQ userid.
rabbit_virtual_host = / (StrOpt) The RabbitMQ virtual host.
send_single_reply = False (BoolOpt) Send a single AMQP reply to call message. The current behaviour since oslo-incubator is to send two AMQP replies - first one with the payload, a second one to ensure the other have finish to send the payload. We are going to remove it in the N release, but we must keep backward compatible at the same time. This option provides such compatibility - it defaults to False in Liberty and can be turned on for early adopters with a new installations or for testing. Please note, that this option will be removed in the Mitaka release.

Table 2.93. Description of Redis configuration options
Configuration option = Default value Description
[matchmaker_redis]
host = 127.0.0.1 (StrOpt) Host to locate redis.
password = (StrOpt) Password for Redis server (optional).
port = 6379 (IntOpt) Use this port to connect to redis host.

Table 2.94. Description of RPC configuration options
Configuration option = Default value Description
[DEFAULT]
rpc_backend = rabbit (StrOpt) The messaging driver to use, defaults to rabbit. Other drivers include qpid and zmq.
rpc_cast_timeout = 30 (IntOpt) Seconds to wait before a cast expires (TTL). Only supported by impl_zmq.
rpc_conn_pool_size = 30 (IntOpt) Size of RPC connection pool.
rpc_poll_timeout = 1 (IntOpt) The default number of seconds that poll should wait. Poll raises timeout exception when timeout expired.
rpc_response_timeout = 60 (IntOpt) Seconds to wait for a response from a call.
volume_topic = cinder-volume (StrOpt) The topic that volume nodes listen on
[oslo_concurrency]
disable_process_locking = False (BoolOpt) Enables or disables inter-process locks.
lock_path = None (StrOpt) Directory to use for lock files. For security, the specified directory should only be writable by the user running the processes that need locking. Defaults to environment variable OSLO_LOCK_PATH. If external locks are used, a lock path must be set.
[oslo_messaging_amqp]
allow_insecure_clients = False (BoolOpt) Accept clients using either SSL or plain TCP
broadcast_prefix = broadcast (StrOpt) address prefix used when broadcasting to all servers
container_name = None (StrOpt) Name for the AMQP container
group_request_prefix = unicast (StrOpt) address prefix when sending to any server in group
idle_timeout = 0 (IntOpt) Timeout for inactive connections (in seconds)
password = (StrOpt) Password for message broker authentication
sasl_config_dir = (StrOpt) Path to directory that contains the SASL configuration
sasl_config_name = (StrOpt) Name of configuration file (without .conf suffix)
sasl_mechanisms = (StrOpt) Space separated list of acceptable SASL mechanisms
server_request_prefix = exclusive (StrOpt) address prefix used when sending to a specific server
ssl_ca_file = (StrOpt) CA certificate PEM file to verify server certificate
ssl_cert_file = (StrOpt) Identifying certificate PEM file to present to clients
ssl_key_file = (StrOpt) Private key PEM file used to sign cert_file certificate
ssl_key_password = None (StrOpt) Password for decrypting ssl_key_file (if encrypted)
trace = False (BoolOpt) Debug: dump AMQP frames to stdout
username = (StrOpt) User name for message broker authentication

Table 2.95. Description of SAN configuration options
Configuration option = Default value Description
[DEFAULT]
san_clustername = (StrOpt) Cluster name to use for creating volumes
san_ip = (StrOpt) IP address of SAN controller
san_is_local = False (BoolOpt) Execute commands locally instead of over SSH; use if the volume service is running on the SAN device
san_login = admin (StrOpt) Username for SAN controller
san_password = (StrOpt) Password for SAN controller
san_private_key = (StrOpt) Filename of private key to use for SSH authentication
san_secondary_ip = None (StrOpt) VNX secondary SP IP Address.
san_ssh_port = 22 (IntOpt) SSH port to use with SAN
san_thin_provision = True (BoolOpt) Use thin provisioning for SAN volumes?
ssh_conn_timeout = 30 (IntOpt) SSH connection timeout in seconds
ssh_max_pool_conn = 5 (IntOpt) Maximum ssh connections in the pool
ssh_min_pool_conn = 1 (IntOpt) Minimum ssh connections in the pool

Table 2.96. Description of scheduler configuration options
Configuration option = Default value Description
[DEFAULT]
filter_function = None (StrOpt) String representation for an equation that will be used to filter hosts. Only used when the driver filter is set to be used by the Cinder scheduler.
goodness_function = None (StrOpt) String representation for an equation that will be used to determine the goodness of a host. Only used when using the goodness weigher is set to be used by the Cinder scheduler.
scheduler_default_filters = AvailabilityZoneFilter, CapacityFilter, CapabilitiesFilter (ListOpt) Which filter class names to use for filtering hosts when not specified in the request.
scheduler_default_weighers = CapacityWeigher (ListOpt) Which weigher class names to use for weighing hosts.
scheduler_driver = cinder.scheduler.filter_scheduler.FilterScheduler (StrOpt) Default scheduler driver to use
scheduler_host_manager = cinder.scheduler.host_manager.HostManager (StrOpt) The scheduler host manager class to use
scheduler_json_config_location = (StrOpt) Absolute path to scheduler configuration JSON file.
scheduler_manager = cinder.scheduler.manager.SchedulerManager (StrOpt) Full class name for the Manager for scheduler
scheduler_max_attempts = 3 (IntOpt) Maximum number of attempts to schedule an volume
scheduler_topic = cinder-scheduler (StrOpt) The topic that scheduler nodes listen on

Table 2.97. Description of SCST volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
scst_target_driver = iscsi (StrOpt) SCST target implementation can choose from multiple SCST target drivers.
scst_target_iqn_name = None (StrOpt) Certain ISCSI targets have predefined target names, SCST target driver uses this name.

Table 2.98. Description of Scality REST Block storage driver configuration options
Configuration option = Default value Description
[DEFAULT]
srb_base_urls = None (StrOpt) Comma-separated list of REST servers IP to connect to. (eg http://IP1/,http://IP2:81/path

Table 2.99. Description of storage configuration options
Configuration option = Default value Description
[DEFAULT]
allocated_capacity_weight_multiplier = -1.0 (FloatOpt) Multiplier used for weighing volume capacity. Negative numbers mean to stack vs spread.
capacity_weight_multiplier = 1.0 (FloatOpt) Multiplier used for weighing volume capacity. Negative numbers mean to stack vs spread.
enabled_backends = None (ListOpt) A list of backend names to use. These backend names should be backed by a unique [CONFIG] group with its options
iscsi_helper = tgtadm (StrOpt) iSCSI target user-land tool to use. tgtadm is default, use lioadm for LIO iSCSI support, scstadmin for SCST target support, iseradm for the ISER protocol, ietadm for iSCSI Enterprise Target, iscsictl for Chelsio iSCSI Target or fake for testing.
iscsi_iotype = fileio (StrOpt) Sets the behavior of the iSCSI target to either perform blockio or fileio optionally, auto can be set and Cinder will autodetect type of backing device
iscsi_ip_address = $my_ip (StrOpt) The IP address that the iSCSI daemon is listening on
iscsi_port = 3260 (IntOpt) The port that the iSCSI daemon is listening on
iscsi_protocol = iscsi (StrOpt) Determines the iSCSI protocol for new iSCSI volumes, created with tgtadm or lioadm target helpers. In order to enable RDMA, this parameter should be set with the value "iser". The supported iSCSI protocol values are "iscsi" and "iser".
iscsi_target_flags = (StrOpt) Sets the target-specific flags for the iSCSI target. Only used for tgtadm to specify backing device flags using bsoflags option. The specified string is passed as is to the underlying tool.
iscsi_target_prefix = iqn.2010-10.org.openstack: (StrOpt) Prefix for iSCSI volumes
iscsi_write_cache = on (StrOpt) Sets the behavior of the iSCSI target to either perform write-back(on) or write-through(off). This parameter is valid if iscsi_helper is set to tgtadm or iseradm.
iser_helper = tgtadm (StrOpt) The name of the iSER target user-land tool to use
iser_ip_address = $my_ip (StrOpt) The IP address that the iSER daemon is listening on
iser_port = 3260 (IntOpt) The port that the iSER daemon is listening on
iser_target_prefix = iqn.2010-10.org.openstack: (StrOpt) Prefix for iSER volumes
migration_create_volume_timeout_secs = 300 (IntOpt) Timeout for creating the volume to migrate to when performing volume migration (seconds)
num_iser_scan_tries = 3 (IntOpt) The maximum number of times to rescan iSER targetto find volume
num_volume_device_scan_tries = 3 (IntOpt) The maximum number of times to rescan targets to find volume
volume_backend_name = None (StrOpt) The backend name for a given driver implementation
volume_clear = zero (StrOpt) Method used to wipe old volumes
volume_clear_ionice = None (StrOpt) The flag to pass to ionice to alter the i/o priority of the process used to zero a volume after deletion, for example "-c3" for idle only priority.
volume_clear_size = 0 (IntOpt) Size in MiB to wipe at start of old volumes. 0 => all
volume_copy_blkio_cgroup_name = cinder-volume-copy (StrOpt) The blkio cgroup name to be used to limit bandwidth of volume copy
volume_copy_bps_limit = 0 (IntOpt) The upper limit of bandwidth of volume copy. 0 => unlimited
volume_dd_blocksize = 1M (StrOpt) The default block size used when copying/clearing volumes
volume_driver = cinder.volume.drivers.lvm.LVMVolumeDriver (StrOpt) Driver to use for volume creation
volume_manager = cinder.volume.manager.VolumeManager (StrOpt) Full class name for the Manager for volume
volume_service_inithost_offload = False (BoolOpt) Offload pending volume delete during volume service startup
volume_usage_audit_period = month (StrOpt) Time period for which to generate volume usages. The options are hour, day, month, or year.
volumes_dir = $state_path/volumes (StrOpt) Volume configuration file storage directory

Table 2.100. Description of StorPool volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
storpool_replication = 3 (IntOpt) The default StorPool chain replication value. Used when creating a volume with no specified type if storpool_template is not set. Also used for calculating the apparent free space reported in the stats.
storpool_template = None (StrOpt) The StorPool template for volumes with no type.

Table 2.101. Description of VidZapper Storage volume driver configuration options
Configuration option = Default value Description
[DEFAULT]
vzstorage_mount_options = None (ListOpt) Mount options passed to the vzstorage client. See section of the pstorage-mount man page for details.
vzstorage_mount_point_base = $state_path/mnt (StrOpt) Base dir containing mount points for vzstorage shares.
vzstorage_shares_config = /etc/cinder/vzstorage_shares (StrOpt) File with the list of available vzstorage shares.
vzstorage_sparsed_volumes = True (BoolOpt) Create volumes as sparsed files which take no space rather than regular files when using raw format, in which case volume creation takes lot of time.
vzstorage_used_ratio = 0.95 (FloatOpt) Percent of ACTUAL usage of the underlying volume before no new volumes can be allocated to the volume destination.

Table 2.102. Description of ZeroMQ configuration options
Configuration option = Default value Description
[DEFAULT]
rpc_zmq_all_req_rep = True (BoolOpt) Use REQ/REP pattern for all methods CALL/CAST/FANOUT.
rpc_zmq_bind_address = * (StrOpt) ZeroMQ bind address. Should be a wildcard (*), an ethernet interface, or IP. The "host" option should point or resolve to this address.
rpc_zmq_concurrency = eventlet (StrOpt) Type of concurrency used. Either "native" or "eventlet"
rpc_zmq_contexts = 1 (IntOpt) Number of ZeroMQ contexts, defaults to 1.
rpc_zmq_host = localhost (StrOpt) Name of this node. Must be a valid hostname, FQDN, or IP address. Must match "host" option, if running Nova.
rpc_zmq_ipc_dir = /var/run/openstack (StrOpt) Directory for holding IPC sockets.
rpc_zmq_matchmaker = redis (StrOpt) MatchMaker driver.
rpc_zmq_topic_backlog = None (IntOpt) Maximum number of ingress messages to locally buffer per topic. Default is unlimited.
zmq_use_broker = True (BoolOpt) Shows whether zmq-messaging uses broker or not.

Table 2.103. Description of zones configuration options
Configuration option = Default value Description
[DEFAULT]
cloned_volume_same_az = True (BoolOpt) Ensure that the new volumes are the same AZ as snapshot or source volume

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page

loading table of contents...