upstream/oracle/userland-gate: comparison components/openstack/glance/files/glance-api.conf

equal deleted inserted replaced

-:4be1f488dda8
+:db0cec748ec0
 # in a request to add a new image to Glance? Known schemes are determined
 # by the known_stores option below.
 # Default: 'file'
 default_store = file
-# List of which store classes and store class locations are
-# currently known to glance at startup.
-# Existing but disabled stores:
-#      glance.store.rbd.Store,
-#      glance.store.s3.Store,
-#      glance.store.swift.Store,
-#      glance.store.sheepdog.Store,
-#      glance.store.cinder.Store,
-#known_stores = glance.store.filesystem.Store,
-#               glance.store.http.Store
 # Maximum image size (in bytes) that may be uploaded through the
 # Glance API server. Defaults to 1 TB.
 # WARNING: this value should only be increased after careful consideration
 # and must be set to a value under 8 EB (9223372036854775808).
 #image_size_cap = 1099511627776
 bind_host = 0.0.0.0
 # Port the bind the API server to
 bind_port = 9292
-# Log to this file. Make sure you do not set the same log
+# Log to this file. Make sure you do not set the same log file for both the API
-# file for both the API and registry servers!
+# and registry servers!
+#
+# If `log_file` is omitted and `use_syslog` is false, then log messages are
+# sent to stdout as a fallback.
 log_file = /var/log/glance/api.log
 # Backlog requests when creating socket
 backlog = 4096
 # API to use for accessing data. Default value points to sqlalchemy
 # package, it is also possible to use: glance.db.registry.api
 # data_api = glance.db.sqlalchemy.api
-# SQLAlchemy connection string for the reference implementation
+# The number of child process workers that will be
-# registry server. Any valid SQLAlchemy connection string is fine.
+# created to service API requests. The default will be
-# See: http://www.sqlalchemy.org/docs/05/reference/sqlalchemy/connections.html#sqlalchemy.create_engine
+# equal to the number of CPUs available. (integer value)
-sql_connection = sqlite:////var/lib/glance/glance.sqlite
-# Period in seconds after which SQLAlchemy should reestablish its connection
-# to the database.
-#
-# MySQL uses a default `wait_timeout` of 8 hours, after which it will drop
-# idle connections. This can result in 'MySQL Gone Away' exceptions. If you
-# notice this, you can lower this value to ensure that SQLAlchemy reconnects
-# before MySQL can drop the connection.
-sql_idle_timeout = 3600
-# Number of Glance API worker processes to start.
-# On machines with more than one CPU increasing this value
-# may improve performance (especially if using SSL with
-# compression turned on). It is typically recommended to set
-# this value to the number of CPUs present on your machine.
 workers = 1
+# 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_header_line = 16384
 # Role used to identify an authenticated user as administrator
 #admin_role = admin
 # Allow unauthenticated users to access the API with read-only
 # auth_token middleware.
 # The default value is false.
 #send_identity_headers = False
 # Supported values for the 'container_format' image attribute
-#container_formats=ami,ari,aki,bare,ovf,uar
+container_formats=ami,ari,aki,bare,ovf,ova,uar
 # Supported values for the 'disk_format' image attribute
-#disk_formats=ami,ari,aki,vhd,vmdk,raw,qcow2,vdi,iso,zfs
+disk_formats=ami,ari,aki,vhd,vmdk,raw,qcow2,vdi,iso,zfs
 # Directory to use for lock files. Default to a temp directory
 # (string value). This setting needs to be the same for both
 # glance-scrubber and glance-api.
 #lock_path=<None>
-#
 # Property Protections config file
-# This file contains the rules for property protections and the roles
+# This file contains the rules for property protections and the roles/policies
 # associated with it.
 # If this config value is not specified, by default, property protections
 # won't be enforced.
-# If a value is specified and the file is not found, then an
+# If a value is specified and the file is not found, then the glance-api
-# HTTPInternalServerError will be thrown.
+# service will not start.
 #property_protection_file =
-# Set a system wide quota for every user.  This value is the total number
+# Specify whether 'roles' or 'policies' are used in the
-# of bytes that a user can use across all storage systems.  A value of
+# property_protection_file.
-# 0 means unlimited.
+# The default value for property_protection_rule_format is 'roles'.
-#user_storage_quota = 0
+#property_protection_rule_format = roles
+# This value sets what strategy will be used to determine the image location
+# order. Currently two strategies are packaged with Glance 'location_order'
+# and 'store_type'.
+#location_strategy = location_order
 # ================= Syslog Options ============================
 # Send logs to syslog (/dev/log) instead of to file specified
 # by `log_file`
 # Enable DEBUG log messages from sqlalchemy which prints every database
 # query and response.
 # Default: False
 #sqlalchemy_debug = True
+# Pass the user's token through for API requests to the registry.
+# Default: True
+#use_user_token = True
+# If 'use_user_token' is not in effect then admin credentials
+# can be specified. Requests to the registry on behalf of
+# the API will use these credentials.
+# Admin user name
+#admin_user = None
+# Admin password
+#admin_password = None
+# Admin tenant name
+#admin_tenant_name = None
+# Keystone endpoint
+#auth_url = None
+# Keystone region
+#auth_region = None
+# Auth strategy
+#auth_strategy = keystone
 # ============ Notification System Options =====================
-# Notifications can be sent when images are create, updated or deleted.
+# Driver or drivers to handle sending notifications. Set to
-# There are three methods of sending notifications, logging (via the
+# 'messaging' to send notifications to a message queue.
-# log_file directive), rabbit (via a rabbitmq queue), qpid (via a Qpid
+# notification_driver = noop
-# message queue), or noop (no notifications sent, the default)
-notifier_strategy = noop
+# Default publisher_id for outgoing notifications.
+# default_publisher_id = image.localhost
+# Messaging driver used for 'messaging' notifications driver
+# rpc_backend = 'rabbit'
 # Configuration options if sending notifications via rabbitmq (these are
 # the defaults)
 rabbit_host = localhost
 rabbit_port = 5672
 qpid_heartbeat = 5
 # Set to 'ssl' to enable SSL
 qpid_protocol = tcp
 qpid_tcp_nodelay = True
+# ============ Delayed Delete Options =============================
+# Turn on/off delayed delete
+delayed_delete = False
+# Delayed delete time in seconds
+scrub_time = 43200
+# Directory that the scrubber will use to remind itself of what to delete
+# Make sure this is also set in glance-scrubber.conf
+scrubber_datadir = /var/lib/glance/scrubber
+# =============== Quota Options ==================================
+# The maximum number of image members allowed per image
+#image_member_quota = 128
+# The maximum number of image properties allowed per image
+#image_property_quota = 128
+# The maximum number of tags allowed per image
+#image_tag_quota = 128
+# The maximum number of locations allowed per image
+#image_location_quota = 10
+# Set a system wide quota for every user.  This value is the total number
+# of bytes that a user can use across all storage systems.  A value of
+# 0 means unlimited.
+#user_storage_quota = 0
+# =============== Image Cache Options =============================
+# Base directory that the Image Cache uses
+image_cache_dir = /var/lib/glance/image-cache/
+# =============== Database Options =================================
+[database]
+# The file name to use with SQLite (string value)
+#sqlite_db = oslo.sqlite
+# If True, SQLite uses synchronous mode (boolean value)
+#sqlite_synchronous = True
+# The backend to use for db (string value)
+# Deprecated group/name - [DEFAULT]/db_backend
+#backend = sqlalchemy
+# The SQLAlchemy connection string used to connect to the
+# database (string value)
+# Deprecated group/name - [DEFAULT]/sql_connection
+# Deprecated group/name - [DATABASE]/sql_connection
+# Deprecated group/name - [sql]/connection
+connection = mysql://%SERVICE_USER%:%SERVICE_PASSWORD%@localhost/glance
+# 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= (string
+# value)
+#mysql_sql_mode = TRADITIONAL
+# Timeout before idle sql connections are reaped (integer
+# value)
+# Deprecated group/name - [DEFAULT]/sql_idle_timeout
+# Deprecated group/name - [DATABASE]/sql_idle_timeout
+# Deprecated group/name - [sql]/idle_timeout
+#idle_timeout = 3600
+# Minimum number of SQL connections to keep open in a pool
+# (integer value)
+# Deprecated group/name - [DEFAULT]/sql_min_pool_size
+# Deprecated group/name - [DATABASE]/sql_min_pool_size
+#min_pool_size = 1
+# Maximum number of SQL connections to keep open in a pool
+# (integer value)
+# Deprecated group/name - [DEFAULT]/sql_max_pool_size
+# Deprecated group/name - [DATABASE]/sql_max_pool_size
+#max_pool_size = <None>
+# Maximum db connection retries during startup. (setting -1
+# implies an infinite retry count) (integer value)
+# Deprecated group/name - [DEFAULT]/sql_max_retries
+# Deprecated group/name - [DATABASE]/sql_max_retries
+#max_retries = 10
+# Interval between retries of opening a sql connection
+# (integer value)
+# Deprecated group/name - [DEFAULT]/sql_retry_interval
+# Deprecated group/name - [DATABASE]/reconnect_interval
+#retry_interval = 10
+# If set, use this value for max_overflow with sqlalchemy
+# (integer value)
+# Deprecated group/name - [DEFAULT]/sql_max_overflow
+# Deprecated group/name - [DATABASE]/sqlalchemy_max_overflow
+#max_overflow = <None>
+# Verbosity of SQL debugging information. 0=None,
+# 100=Everything (integer value)
+# Deprecated group/name - [DEFAULT]/sql_connection_debug
+#connection_debug = 0
+# Add python stack traces to SQL as comment strings (boolean
+# value)
+# Deprecated group/name - [DEFAULT]/sql_connection_trace
+#connection_trace = False
+# If set, use this value for pool_timeout with sqlalchemy
+# (integer value)
+# Deprecated group/name - [DATABASE]/sqlalchemy_pool_timeout
+#pool_timeout = <None>
+# Enable the experimental use of database reconnect on
+# connection lost (boolean value)
+#use_db_reconnect = False
+# seconds between db connection retries (integer value)
+#db_retry_interval = 1
+# Whether to increase interval between db connection retries,
+# up to db_max_retry_interval (boolean value)
+#db_inc_retry_interval = True
+# max seconds between db connection retries, if
+# db_inc_retry_interval is enabled (integer value)
+#db_max_retry_interval = 10
+# maximum db connection retries before error is raised.
+# (setting -1 implies an infinite retry count) (integer value)
+#db_max_retries = 20
+[keystone_authtoken]
+auth_uri = http://127.0.0.1:5000/v2.0/
+identity_uri = http://127.0.0.1:35357/
+admin_tenant_name = %SERVICE_TENANT_NAME%
+admin_user = %SERVICE_USER%
+admin_password = %SERVICE_PASSWORD%
+revocation_cache_time = 10
+signing_dir = /var/lib/glance/keystone-signing
+[paste_deploy]
+# Name of the paste configuration file that defines the available pipelines
+#config_file = glance-api-paste.ini
+# Partial name of a pipeline in your paste configuration file with the
+# service name removed. For example, if your paste section name is
+# [pipeline:glance-api-keystone], you would configure the flavor below
+# as 'keystone'.
+flavor=keystone
+[store_type_location_strategy]
+# The scheme list to use to get store preference order. The scheme must be
+# registered by one of the stores defined by the 'known_stores' config option.
+# This option will be applied when you using 'store_type' option as image
+# location strategy defined by the 'location_strategy' config option.
+#store_type_preference =
+[profiler]
+# If False fully disable profiling feature.
+#enabled = False
+# If False doesn't trace SQL requests.
+#trace_sqlalchemy = False
+[task]
+# ================= Glance Tasks Options ============================
+# Specifies how long (in hours) a task is supposed to live in the tasks DB
+# after succeeding or failing before getting soft-deleted.
+# The default value for task_time_to_live is 48 hours.
+# task_time_to_live = 48
+# Specifies which task executor to be used to run the task scripts.
+# The default value for task_executor is eventlet.
+# task_executor = eventlet
+# Specifies the maximum number of eventlet threads which can be spun up by
+# the eventlet based task executor to perform execution of Glance tasks.
+# eventlet_executor_pool_size = 1000
+[glance_store]
+# List of which store classes and store class locations are
+# currently known to glance at startup.
+# Existing but disabled stores:
+#      glance.store.rbd.Store,
+#      glance.store.s3.Store,
+#      glance.store.swift.Store,
+#      glance.store.sheepdog.Store,
+#      glance.store.cinder.Store,
+#      glance.store.gridfs.Store,
+#      glance.store.vmware_datastore.Store,
+#stores = glance.store.filesystem.Store,
+#         glance.store.http.Store
 # ============ Filesystem Store Options ========================
 # Directory that the Filesystem backend store
 # writes image data to
 filesystem_store_datadir = /var/lib/glance/images/
+# A list of directories where image data can be stored.
+# This option may be specified multiple times for specifying multiple store
+# directories. Either one of filesystem_store_datadirs or
+# filesystem_store_datadir option is required. A priority number may be given
+# after each directory entry, separated by a ":".
+# When adding an image, the highest priority directory will be selected, unless
+# there is not enough space available in cases where the image size is already
+# known. If no priority is given, it is assumed to be zero and the directory
+# will be considered for selection last. If multiple directories have the same
+# priority, then the one with the most free space available is selected.
+# If same store is specified multiple times then BadStoreConfiguration
+# exception will be raised.
+#filesystem_store_datadirs = /var/lib/glance/images/:1
 # A path to a JSON file that contains metadata describing the storage
 # system.  When show_multiple_locations is True the information in this
 # file will be returned with any location that is contained in this
 # store.
 # What size, in MB, should Glance start chunking image files
 # and do a large object manifest in Swift? By default, this is
 # the maximum object size in Swift, which is 5GB
 swift_store_large_object_size = 5120
+# swift_store_config_file = glance-swift.conf
+# This file contains references for each of the configured
+# Swift accounts/backing stores. If used, this option can prevent
+# credentials being stored in the database. Using Swift references
+# is disabled if this config is left blank.
+# The reference to the default Swift parameters to use for adding new images.
+# default_swift_reference = 'ref1'
 # When doing a large object manifest, what size, in MB, should
 # Glance write chunks to Swift? This amount of data is written
 # to a temporary disk buffer during the process of chunking
 # the image file, and the default is 200MB
 # Setting to 'False' may improve performance for images which are already
 # in a compressed format, eg qcow2. If set to True, enables SSL layer
 # compression (provided it is supported by the target swift proxy).
 #swift_store_ssl_compression = True
+# The number of times a Swift download will be retried before the
+# request fails
+#swift_store_retry_get_count = 0
+# Bypass SSL verification for Swift
+#swift_store_auth_insecure = False
 # ============ S3 Store Options =============================
 # Address where the S3 authentication service lives
 # Valid schemes are 'http://' and 'https://'
 # If no scheme specified,  default to 'http://'
 # subdomain or as the first token of the path. Amazon's S3 service will
 # accept it as the subdomain, but Swift's S3 middleware requires it be
 # in the path. Set this to 'path' or 'subdomain' - defaults to 'subdomain'.
 #s3_store_bucket_url_format = subdomain
+# Size, in MB, should S3 start chunking image files
+# and do a multipart upload in S3. The default is 100MB.
+#s3_store_large_object_size = 100
+# Multipart upload part size, in MB, should S3 use when uploading
+# parts. The size must be greater than or equal to
+# 5MB. The default is 10MB.
+#s3_store_large_object_chunk_size = 10
+# The number of thread pools to perform a multipart upload
+# in S3. The default is 10.
+#s3_store_thread_pools = 10
 # ============ RBD Store Options =============================
 # Ceph configuration file path
 # If using cephx authentication, this file should
 # include a reference to the right keyring
 # in a client.<USER> section
-rbd_store_ceph_conf = /etc/ceph/ceph.conf
+#rbd_store_ceph_conf = /etc/ceph/ceph.conf
 # RADOS user to authenticate as (only applicable if using cephx)
-rbd_store_user = glance
+# If <None>, a default will be chosen based on the client. section
+# in rbd_store_ceph_conf
+#rbd_store_user = <None>
 # RADOS pool in which images are stored
-rbd_store_pool = images
+#rbd_store_pool = images
-# Images will be chunked into objects of this size (in megabytes).
+# RADOS images will be chunked into objects of this size (in megabytes).
 # For best performance, this should be a power of two
-rbd_store_chunk_size = 8
+#rbd_store_chunk_size = 8
 # ============ Sheepdog Store Options =============================
 sheepdog_store_address = localhost
 #cinder_http_retries = 3
 # Allow to perform insecure SSL requests to cinder (boolean value)
 #cinder_api_insecure = False
-# ============ Delayed Delete Options =============================
+# ============ VMware Datastore Store Options =====================
-# Turn on/off delayed delete
+# ESX/ESXi or vCenter Server target system.
-delayed_delete = False
+# The server value can be an IP address or a DNS name
+# e.g. 127.0.0.1, 127.0.0.1:443, www.vmware-infra.com
-# Delayed delete time in seconds
+#vmware_server_host = <None>
-scrub_time = 43200
+# Server username (string value)
-# Directory that the scrubber will use to remind itself of what to delete
+#vmware_server_username = <None>
-# Make sure this is also set in glance-scrubber.conf
-scrubber_datadir = /var/lib/glance/scrubber
+# Server password (string value)
+#vmware_server_password = <None>
-# =============== Image Cache Options =============================
+# Inventory path to a datacenter (string value)
-# Base directory that the Image Cache uses
+# Value optional when vmware_server_ip is an ESX/ESXi host: if specified
-image_cache_dir = /var/lib/glance/image-cache/
+# should be `ha-datacenter`.
+#vmware_datacenter_path = <None>
-[keystone_authtoken]
-auth_uri = http://127.0.0.1:5000/v2.0
+# Datastore associated with the datacenter (string value)
-identity_uri = http://127.0.0.1:35357
+#vmware_datastore_name = <None>
-admin_tenant_name = %SERVICE_TENANT_NAME%
-admin_user = %SERVICE_USER%
+# The number of times we retry on failures
-admin_password = %SERVICE_PASSWORD%
+# e.g., socket error, etc (integer value)
-signing_dir = /var/lib/glance/keystone-signing
+#vmware_api_retry_count = 10
-[paste_deploy]
+# The interval used for polling remote tasks
-# Name of the paste configuration file that defines the available pipelines
+# invoked on VMware ESX/VC server in seconds (integer value)
-#config_file = glance-api-paste.ini
+#vmware_task_poll_interval = 5
-# Partial name of a pipeline in your paste configuration file with the
+# Absolute path of the folder containing the images in the datastore
-# service name removed. For example, if your paste section name is
+# (string value)
-# [pipeline:glance-api-keystone], you would configure the flavor below
+#vmware_store_image_dir = /openstack_glance
-# as 'keystone'.
-flavor = keystone
+# Allow to perform insecure SSL requests to the target system (boolean value)
+#vmware_api_insecure = False

branch	s11-update
changeset 4072	db0cec748ec0
parent 3178	77584387a894
child 4991	dba45c643059
child 6035	c9748fcc32de