1.. 2 Warning: Do not edit this file. It is automatically generated from the 3 software project's code and your changes will be overwritten. 4 5 The tool to generate this file lives in openstack-doc-tools repository. 6 7 Please make any changes needed in the code, then run the 8 autogenerate-config-doc tool from the openstack-doc-tools repository, or 9 ask for help on the documentation mailing list, IRC channel or meeting. 10 11.. _cinder-common: 12 13.. list-table:: Description of common configuration options 14 :header-rows: 1 15 :class: config-ref-table 16 17 * - Configuration option = Default value 18 - Description 19 * - **[DEFAULT]** 20 - 21 * - ``allow_availability_zone_fallback`` = ``False`` 22 - (Boolean) If the requested Cinder availability zone is unavailable, fall back to the value of default_availability_zone, then storage_availability_zone, instead of failing. 23 * - ``chap`` = ``disabled`` 24 - (String) CHAP authentication mode, effective only for iscsi (disabled|enabled) 25 * - ``chap_password`` = 26 - (String) Password for specified CHAP account name. 27 * - ``chap_username`` = 28 - (String) CHAP user name. 29 * - ``chiscsi_conf`` = ``/etc/chelsio-iscsi/chiscsi.conf`` 30 - (String) Chiscsi (CXT) global defaults configuration file 31 * - ``cinder_internal_tenant_project_id`` = ``None`` 32 - (String) ID of the project which will be used as the Cinder internal tenant. 33 * - ``cinder_internal_tenant_user_id`` = ``None`` 34 - (String) ID of the user to be used in volume operations as the Cinder internal tenant. 35 * - ``cluster`` = ``None`` 36 - (String) Name of this cluster. Used to group volume hosts that share the same backend configurations to work in HA Active-Active mode. Active-Active is not yet supported. 37 * - ``compute_api_class`` = ``cinder.compute.nova.API`` 38 - (String) The full class name of the compute API class to use 39 * - ``connection_type`` = ``iscsi`` 40 - (String) Connection type to the IBM Storage Array 41 * - ``consistencygroup_api_class`` = ``cinder.consistencygroup.api.API`` 42 - (String) The full class name of the consistencygroup API class 43 * - ``default_availability_zone`` = ``None`` 44 - (String) Default availability zone for new volumes. If not set, the storage_availability_zone option value is used as the default for new volumes. 45 * - ``default_group_type`` = ``None`` 46 - (String) Default group type to use 47 * - ``default_volume_type`` = ``None`` 48 - (String) Default volume type to use 49 * - ``driver_client_cert`` = ``None`` 50 - (String) The path to the client certificate for verification, if the driver supports it. 51 * - ``driver_client_cert_key`` = ``None`` 52 - (String) The path to the client certificate key for verification, if the driver supports it. 53 * - ``driver_data_namespace`` = ``None`` 54 - (String) Namespace for driver private data values to be saved in. 55 * - ``driver_ssl_cert_path`` = ``None`` 56 - (String) Can be used to specify a non default path to a CA_BUNDLE file or directory with certificates of trusted CAs, which will be used to validate the backend 57 * - ``driver_ssl_cert_verify`` = ``False`` 58 - (Boolean) If set to True the http client will validate the SSL certificate of the backend endpoint. 59 * - ``enable_force_upload`` = ``False`` 60 - (Boolean) Enables the Force option on upload_to_image. This enables running upload_volume on in-use volumes for backends that support it. 61 * - ``enable_new_services`` = ``True`` 62 - (Boolean) Services to be added to the available pool on create 63 * - ``enable_unsupported_driver`` = ``False`` 64 - (Boolean) Set this to True when you want to allow an unsupported driver to start. Drivers that haven't maintained a working CI system and testing are marked as unsupported until CI is working again. This also marks a driver as deprecated and may be removed in the next release. 65 * - ``end_time`` = ``None`` 66 - (String) If this option is specified then the end time specified is used instead of the end time of the last completed audit period. 67 * - ``enforce_multipath_for_image_xfer`` = ``False`` 68 - (Boolean) 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. 69 * - ``executor_thread_pool_size`` = ``64`` 70 - (Integer) Size of executor thread pool. 71 * - ``fatal_exception_format_errors`` = ``False`` 72 - (Boolean) Make exception message format errors fatal. 73 * - ``group_api_class`` = ``cinder.group.api.API`` 74 - (String) The full class name of the group API class 75 * - ``host`` = ``localhost`` 76 - (String) Name of this node. This can be an opaque identifier. It is not necessarily a host name, FQDN, or IP address. 77 * - ``iet_conf`` = ``/etc/iet/ietd.conf`` 78 - (String) IET configuration file 79 * - ``iscsi_secondary_ip_addresses`` = 80 - (List) The list of secondary IP addresses of the iSCSI daemon 81 * - ``max_over_subscription_ratio`` = ``20.0`` 82 - (Floating point) 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. The ratio has to be a minimum of 1.0. 83 * - ``monkey_patch`` = ``False`` 84 - (Boolean) Enable monkey patching 85 * - ``monkey_patch_modules`` = 86 - (List) List of modules/decorators to monkey patch 87 * - ``my_ip`` = ``10.0.0.1`` 88 - (String) IP address of this host 89 * - ``no_snapshot_gb_quota`` = ``False`` 90 - (Boolean) Whether snapshots count against gigabyte quota 91 * - ``num_shell_tries`` = ``3`` 92 - (Integer) Number of times to attempt to run flakey shell commands 93 * - ``os_privileged_user_auth_url`` = ``None`` 94 - (URI) Auth URL associated with the OpenStack privileged account. 95 * - ``os_privileged_user_name`` = ``None`` 96 - (String) OpenStack privileged account username. Used for requests to other services (such as Nova) that require an account with special rights. 97 * - ``os_privileged_user_password`` = ``None`` 98 - (String) Password associated with the OpenStack privileged account. 99 * - ``os_privileged_user_tenant`` = ``None`` 100 - (String) Tenant name associated with the OpenStack privileged account. 101 * - ``periodic_fuzzy_delay`` = ``60`` 102 - (Integer) Range, in seconds, to randomly delay when starting the periodic task scheduler to reduce stampeding. (Disable by setting to 0) 103 * - ``periodic_interval`` = ``60`` 104 - (Integer) Interval, in seconds, between running periodic tasks 105 * - ``replication_device`` = ``None`` 106 - (Unknown) Multi opt of dictionaries to represent a replication target device. This option may be specified multiple times in a single config section to specify multiple replication target devices. Each entry takes the standard dict config form: replication_device = target_device_id:<required>,key1:value1,key2:value2... 107 * - ``report_discard_supported`` = ``False`` 108 - (Boolean) Report to clients of Cinder that the backend supports discard (aka. trim/unmap). This will not actually change the behavior of the backend or the client directly, it will only notify that it can be used. 109 * - ``report_interval`` = ``10`` 110 - (Integer) Interval, in seconds, between nodes reporting state to datastore 111 * - ``reserved_percentage`` = ``0`` 112 - (Integer) The percentage of backend capacity is reserved 113 * - ``rootwrap_config`` = ``/etc/cinder/rootwrap.conf`` 114 - (String) Path to the rootwrap configuration file to use for running commands as root 115 * - ``send_actions`` = ``False`` 116 - (Boolean) Send the volume and snapshot create and delete notifications generated in the specified period. 117 * - ``service_down_time`` = ``60`` 118 - (Integer) Maximum time since last check-in for a service to be considered up 119 * - ``ssh_hosts_key_file`` = ``$state_path/ssh_known_hosts`` 120 - (String) File containing SSH host keys for the systems with which Cinder needs to communicate. OPTIONAL: Default=$state_path/ssh_known_hosts 121 * - ``start_time`` = ``None`` 122 - (String) If this option is specified then the start time specified is used instead of the start time of the last completed audit period. 123 * - ``state_path`` = ``/var/lib/cinder`` 124 - (String) Top-level directory for maintaining cinder's state 125 * - ``storage_availability_zone`` = ``nova`` 126 - (String) Availability zone of this node 127 * - ``storage_protocol`` = ``iscsi`` 128 - (String) Protocol for transferring data between host and storage back-end. 129 * - ``strict_ssh_host_key_policy`` = ``False`` 130 - (Boolean) 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 131 * - ``suppress_requests_ssl_warnings`` = ``False`` 132 - (Boolean) Suppress requests library SSL certificate warnings. 133 * - ``tcp_keepalive`` = ``True`` 134 - (Boolean) Sets the value of TCP_KEEPALIVE (True/False) for each server socket. 135 * - ``tcp_keepalive_count`` = ``None`` 136 - (Integer) Sets the value of TCP_KEEPCNT for each server socket. Not supported on OS X. 137 * - ``tcp_keepalive_interval`` = ``None`` 138 - (Integer) Sets the value of TCP_KEEPINTVL in seconds for each server socket. Not supported on OS X. 139 * - ``until_refresh`` = ``0`` 140 - (Integer) Count of reservations until usage is refreshed 141 * - ``use_chap_auth`` = ``False`` 142 - (Boolean) Option to enable/disable CHAP authentication for targets. 143 * - ``use_forwarded_for`` = ``False`` 144 - (Boolean) Treat X-Forwarded-For as the canonical remote address. Only enable this if you have a sanitizing proxy. 145 * - **[healthcheck]** 146 - 147 * - ``backends`` = 148 - (List) Additional backends that can perform health checks and report that information back as part of a request. 149 * - ``detailed`` = ``False`` 150 - (Boolean) Show more detailed information as part of the response 151 * - ``disable_by_file_path`` = ``None`` 152 - (String) Check the presence of a file to determine if an application is running on a port. Used by DisableByFileHealthcheck plugin. 153 * - ``disable_by_file_paths`` = 154 - (List) Check the presence of a file based on a port to determine if an application is running on a port. Expects a "port:path" list of strings. Used by DisableByFilesPortsHealthcheck plugin. 155 * - ``path`` = ``/healthcheck`` 156 - (String) DEPRECATED: The path to respond to healtcheck requests on. 157 * - **[key_manager]** 158 - 159 * - ``backend`` = ``barbican`` 160 - (String) The full class name of the key manager API class 161 * - ``fixed_key`` = ``None`` 162 - (String) Fixed key returned by key manager, specified in hex 163