New, updated and deprecated options for cinder
New options
Option = default value (Type) Help string
allocated_capacity_weight_multiplier = -1.0 (FloatOpt) Multiplier used for weighing volume capacity. Negative numbers mean to stack vs spread.
backup_metadata_version = 1 (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.
cinder_emc_config_file = /etc/cinder/cinder_emc_config.xml (StrOpt) use this file for cinder emc plugin config data
default_timeout = 20 (IntOpt) Default Time Out For CLI operations in minutes
extra_capabilities = {} (StrOpt) User defined capabilities, a JSON formatted string specifying key/value pairs.
gpfs_storage_pool = None (StrOpt) Specifies the storage pool that volumes are assigned to. By default, the system storage pool is used.
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
kombu_reconnect_delay = 1.0 (FloatOpt) How long to wait before reconnecting in response to an AMQP consumer cancel notification.
log_config_append = None (StrOpt) The name of logging configuration file. It does not disable existing loggers, but just appends specified logging configuration to any other existing logging options. Please see the Python logging module documentation for details on logging configuration files.
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).
max_luns_per_storage_group = 256 (IntOpt) Default max number of LUNs in a storage group
msa_vdisk = OpenStack (StrOpt) The VDisk to use for volume creation.
nas_ip = (StrOpt) IP address or Hostname of NAS system.
nas_login = admin (StrOpt) User name to connect to NAS system.
nas_password = (StrOpt) Password to connect to NAS system.
nas_private_key = (StrOpt) Filename of private key to use for SSH authentication.
nas_ssh_port = 22 (IntOpt) SSH port to use to connect to NAS system.
naviseccli_path = (StrOpt) Naviseccli Path
netapp_controller_ips = None (StrOpt) This option is only utilized when the storage family is configured to eseries. This option is used to restrict provisioning to the specified controllers. Specify the value of this option to be a comma separated list of controller hostnames or IP addresses to be used for provisioning.
netapp_copyoffload_tool_path = None (StrOpt) This option specifies the path of the NetApp copy offload tool binary. Ensure that the binary has execute permissions set which allow the effective user of the cinder-volume process to execute the file.
netapp_sa_password = None (StrOpt) Password for the NetApp E-Series storage array.
netapp_storage_pools = None (StrOpt) This option is used to restrict provisioning to the specified storage pools. Only dynamic disk pools are currently supported. Specify the value of this option to be a comma separated list of disk pool names to be used for provisioning.
netapp_webservice_path = /devmgr/v2 (StrOpt) This option is used to specify the path to the E-Series proxy application on a proxy server. The value is combined with the value of the netapp_transport_type, netapp_server_hostname, and netapp_server_port options to create the URL used by the driver to connect to the proxy application.
nexenta_nms_cache_volroot = True (BoolOpt) If set True cache NexentaStor appliance volroot option value.
nexenta_rrmgr_compression = 0 (IntOpt) Enable stream compression, level 1..9. 1 - gives best speed; 9 - gives best compression.
nexenta_rrmgr_connections = 2 (IntOpt) Number of TCP connections.
nexenta_rrmgr_tcp_buf_size = 4096 (IntOpt) TCP Buffer size in KiloBytes.
osapi_volume_workers = None (IntOpt) Number of workers for OpenStack Volume API service
password = None (StrOpt) Password for Redis server (optional).
port = 6379 (IntOpt) Use this port to connect to redis host.
rabbit_login_method = AMQPLAIN (StrOpt) the RabbitMQ login method
storage_vnx_pool_name = None (StrOpt) ISCSI pool name
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.
use_syslog_rfc_format = False (BoolOpt) (Optional) Use syslog rfc5424 format for logging. If enabled, will add APP-NAME (RFC5424) before the MSG part of the syslog message. The old format without APP-NAME is deprecated in I, and will be removed in J.
vmware_api_retry_count = 10 (IntOpt) Number of times VMware ESX/VC server API must be retried upon connection related issues.
vmware_host_ip = None (StrOpt) IP address for connecting to VMware ESX/VC server.
vmware_host_password = None (StrOpt) Password for authenticating with VMware ESX/VC server.
vmware_host_username = None (StrOpt) Username for authenticating with VMware ESX/VC server.
vmware_host_version = None (StrOpt) Optional string specifying the VMware VC server version. The driver attempts to retrieve the version from VMware VC server. Set this configuration only if you want to override the VC server version.
vmware_image_transfer_timeout_secs = 7200 (IntOpt) Timeout in seconds for VMDK volume transfer between Cinder and Glance.
vmware_max_objects_retrieval = 100 (IntOpt) Max number of objects to be retrieved per batch. Query results will be obtained in batches from the server and not in one shot. Server may still limit the count to something less than the configured value.
vmware_task_poll_interval = 5 (IntOpt) The interval (in seconds) for polling remote tasks invoked on VMware ESX/VC server.
vmware_volume_folder = cinder-volumes (StrOpt) Name for the folder in the VC datacenter that will contain cinder volumes.
vmware_wsdl_location = None (StrOpt) Optional VIM service WSDL Location e.g http://<server>/vimService.wsdl. Optional over-ride to default location for bug work-arounds.
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.
xiv_chap = disabled (StrOpt) CHAP authentication mode, effective only for iscsi (disabled|enabled)
zoning_mode = none (StrOpt) FC Zoning mode configured
BRCD_FABRIC_EXAMPLE/fc_fabric_address = (StrOpt) Management IP of fabric
BRCD_FABRIC_EXAMPLE/fc_fabric_password = (StrOpt) Password for user
BRCD_FABRIC_EXAMPLE/fc_fabric_port = 22 (IntOpt) Connecting port
BRCD_FABRIC_EXAMPLE/fc_fabric_user = (StrOpt) Fabric user ID
BRCD_FABRIC_EXAMPLE/principal_switch_wwn = None (StrOpt) Principal switch WWN of the fabric
BRCD_FABRIC_EXAMPLE/zone_activate = True (BoolOpt) overridden zoning activation state
BRCD_FABRIC_EXAMPLE/zone_name_prefix = None (StrOpt) overridden zone name prefix
BRCD_FABRIC_EXAMPLE/zoning_policy = initiator-target (StrOpt) overridden zoning policy
fc-zone-manager/brcd_sb_connector = cinder.zonemanager.drivers.brocade.brcd_fc_zone_client_cli.BrcdFCZoneClientCLI (StrOpt) Southbound connector for zoning operation
fc-zone-manager/fc_fabric_names = None (StrOpt) Comma separated list of fibre channel fabric names. This list of names is used to retrieve other SAN credentials for connecting to each SAN fabric
fc-zone-manager/fc_san_lookup_service = cinder.zonemanager.drivers.brocade.brcd_fc_san_lookup_service.BrcdFCSanLookupService (StrOpt) FC San Lookup Service
fc-zone-manager/zone_driver = cinder.zonemanager.drivers.brocade.brcd_fc_zone_driver.BrcdFCZoneDriver (StrOpt) FC Zone Driver responsible for zone management
fc-zone-manager/zoning_policy = initiator-target (StrOpt) Zoning policy configured by user
matchmaker_ring/ringfile = /etc/oslo/matchmaker_ring.json (StrOpt) Matchmaker ring file (JSON).
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
New default values
Option Previous default value New default value
default_log_levels amqplib=WARN, sqlalchemy=WARN, boto=WARN, suds=INFO, keystone=INFO, eventlet.wsgi.server=WARN amqp=WARN, amqplib=WARN, boto=WARN, qpid=WARN, sqlalchemy=WARN, suds=INFO, oslo.messaging=INFO, iso8601=WARN, requests.packages.urllib3.connectionpool=WARN
logging_context_format_string %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [%(request_id)s %(user)s %(tenant)s] %(instance)s%(message)s %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [%(request_id)s %(user_identity)s] %(instance)s%(message)s
rpc_zmq_matchmaker cinder.openstack.common.rpc.matchmaker.MatchMakerLocalhost oslo.messaging._drivers.matchmaker.MatchMakerLocalhost
sf_account_prefix ol.local.net None
state_path $pybasedir /var/lib/cinder
Deprecated options
Deprecated option New Option
pybasedir state_path
matchmaker_ringfile matchmaker_ring/ringfile
log_config log_config_append
rpc_notifier2/topics notification_topics
db_backend database/backend