2011-02-04 18:59:52 -05:00
|
|
|
..
|
|
|
|
Copyright 2011 OpenStack, LLC
|
|
|
|
All Rights Reserved.
|
|
|
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
|
|
not use this file except in compliance with the License. You may obtain
|
|
|
|
a copy of the License at
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
License for the specific language governing permissions and limitations
|
|
|
|
under the License.
|
|
|
|
|
|
|
|
Configuring Glance
|
|
|
|
==================
|
|
|
|
|
2011-04-04 13:00:26 -04:00
|
|
|
In addition to this documentation page, you can check the
|
|
|
|
``etc/glance.conf.sample`` sample configuration file distributed with Glance
|
|
|
|
for an example configuration file with detailed comments on what each options
|
|
|
|
does.
|
|
|
|
|
|
|
|
Common Configuration Options in Glance
|
|
|
|
--------------------------------------
|
|
|
|
|
|
|
|
Glance has a few command-line options that are common to all Glance programs:
|
|
|
|
|
|
|
|
* ``--verbose``
|
|
|
|
|
|
|
|
Optional. Default: ``False``
|
|
|
|
|
|
|
|
Can be specified on the command line and in configuration files.
|
|
|
|
|
|
|
|
Turns on the INFO level in logging and prints more verbose command-line
|
|
|
|
interface printouts.
|
|
|
|
|
|
|
|
* ``--debug``
|
|
|
|
|
|
|
|
Optional. Default: ``False``
|
|
|
|
|
|
|
|
Can be specified on the command line and in configuration files.
|
|
|
|
|
|
|
|
Turns on the DEBUG level in logging.
|
|
|
|
|
|
|
|
* ``--config-file=PATH``
|
|
|
|
|
|
|
|
Optional. Default: ``None``
|
|
|
|
|
|
|
|
Specified on the command line only.
|
|
|
|
|
|
|
|
Takes a path to a configuration file to use when running the program. If this
|
|
|
|
CLI option is not specified, then we check to see if the first argument is a
|
|
|
|
file. If it is, then we try to use that as the configuration file. If there is
|
|
|
|
no file or there were no arguments, we search for a configuration file in the
|
|
|
|
following order:
|
|
|
|
|
|
|
|
- ./glance.conf
|
|
|
|
- ~/glance.conf
|
|
|
|
- ~/.glance/glance.conf
|
|
|
|
- /etc/glance/glance.conf
|
|
|
|
- /etc/glance.conf
|
2011-03-08 16:52:38 -05:00
|
|
|
|
|
|
|
Configuring Logging in Glance
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
There are a number of configuration options in Glance that control how Glance
|
2011-04-04 13:00:26 -04:00
|
|
|
servers log messages. The configuration options can be specified both on the
|
|
|
|
command line and in the ``glance.conf`` config file.
|
2011-03-08 16:52:38 -05:00
|
|
|
|
|
|
|
* ``--log-config=PATH``
|
|
|
|
|
|
|
|
Optional. Default: ``None``
|
|
|
|
|
|
|
|
Specified on the command line only.
|
|
|
|
|
|
|
|
Takes a path to a configuration file to use for configuring logging.
|
|
|
|
|
|
|
|
* ``--log-format``
|
|
|
|
|
2011-04-04 13:00:26 -04:00
|
|
|
`Because of a bug in the PasteDeploy package, this option is only available
|
|
|
|
on the command line.`
|
2011-03-08 16:52:38 -05:00
|
|
|
|
|
|
|
Optional. Default: ``%(asctime)s %(levelname)8s [%(name)s] %(message)s``
|
|
|
|
|
|
|
|
The format of the log records. See the
|
|
|
|
`logging module <http://docs.python.org/library/logging.html>`_ documentation for
|
|
|
|
more information on setting this format string.
|
|
|
|
|
|
|
|
* ``log_file`` (``--log-file`` when specified on the command line)
|
|
|
|
|
|
|
|
The filepath of the file to use for logging messages from Glance's servers. If
|
|
|
|
missing, the default is to output messages to ``stdout``, so if you are running
|
|
|
|
Glance servers in a daemon mode (using ``glance-control``) you should make
|
|
|
|
sure that the ``log_file`` option is set appropriately.
|
|
|
|
|
|
|
|
* ``log_dir`` (``--log-dir`` when specified on the command line)
|
|
|
|
|
|
|
|
The filepath of the directory to use for log files. If not specified (the default)
|
|
|
|
the ``log_file`` is used as an absolute filepath.
|
|
|
|
|
|
|
|
* ``log_date_format`` (``--log-date-format`` when specified from the command line)
|
|
|
|
|
|
|
|
The format string for timestamps in the log output.
|
|
|
|
|
|
|
|
Defaults to ``%Y-%m-%d %H:%M:%S``. See the
|
|
|
|
`logging module <http://docs.python.org/library/logging.html>`_ documentation for
|
|
|
|
more information on setting this format string.
|
2011-04-04 13:00:26 -04:00
|
|
|
|
|
|
|
Configuring Glance Storage Backends
|
|
|
|
-----------------------------------
|
|
|
|
|
|
|
|
There are a number of configuration options in Glance that control how Glance
|
|
|
|
stores disk images. These configuration options are specified in the
|
|
|
|
``glance.conf`` config file `in the section [app:glance-api]`.
|
|
|
|
|
|
|
|
* ``default_store=STORE``
|
|
|
|
|
|
|
|
Optional. Default: ``file``
|
|
|
|
|
|
|
|
Can only be specified in configuration files.
|
|
|
|
|
|
|
|
Sets the storage backend to use by default when storing images in Glance.
|
|
|
|
Available options for this option are (``file``, ``swift``, or ``s3``).
|
|
|
|
|
|
|
|
* ``filesystem_store_datadir=PATH``
|
|
|
|
|
|
|
|
Optional. Default: ``/var/lib/glance/images/``
|
|
|
|
|
|
|
|
Can only be specified in configuration files.
|
|
|
|
|
|
|
|
`This option is specific to the filesystem storage backend.`
|
|
|
|
|
|
|
|
Sets the path where the filesystem storage backend write disk images. Note that
|
|
|
|
the filesystem storage backend will attempt to create this directory if it does
|
|
|
|
not exist. Ensure that the user that ``glance-api`` runs under has write
|
|
|
|
permissions to this directory.
|
|
|
|
|
|
|
|
* ``swift_store_auth_address=URL``
|
|
|
|
|
|
|
|
Required when using the Swift storage backend.
|
|
|
|
|
|
|
|
Can only be specified in configuration files.
|
|
|
|
|
|
|
|
`This option is specific to the Swift storage backend.`
|
|
|
|
|
|
|
|
Sets the authentication URL supplied to Swift when making calls to its storage
|
|
|
|
system. For more information about the Swift authentication system, please
|
|
|
|
see the `Swift auth <http://swift.openstack.org/overview_auth.html>`_
|
|
|
|
documentation and the
|
|
|
|
`overview of Swift authentication <http://docs.openstack.org/openstack-object-storage/admin/content/ch02s02.html>`_.
|
|
|
|
|
|
|
|
* ``swift_store_user=USER``
|
|
|
|
|
|
|
|
Required when using the Swift storage backend.
|
|
|
|
|
|
|
|
Can only be specified in configuration files.
|
|
|
|
|
|
|
|
`This option is specific to the Swift storage backend.`
|
|
|
|
|
|
|
|
Sets the user to authenticate against the ``swift_store_auth_address`` with.
|
|
|
|
|
|
|
|
* ``swift_store_key=KEY``
|
|
|
|
|
|
|
|
Required when using the Swift storage backend.
|
|
|
|
|
|
|
|
Can only be specified in configuration files.
|
|
|
|
|
|
|
|
`This option is specific to the Swift storage backend.`
|
|
|
|
|
|
|
|
Sets the authentication key to authenticate against the
|
|
|
|
``swift_store_auth_address`` with for the user ``swift_store_user``.
|
|
|
|
|
|
|
|
* ``swift_store_container=CONTAINER``
|
|
|
|
|
|
|
|
Optional. Default: ``glance``
|
|
|
|
|
|
|
|
Can only be specified in configuration files.
|
|
|
|
|
|
|
|
`This option is specific to the Swift storage backend.`
|
|
|
|
|
|
|
|
Sets the name of the container to use for Glance images in Swift.
|
|
|
|
|
|
|
|
* ``swift_store_create_container_on_put``
|
|
|
|
|
|
|
|
Optional. Default: ``False``
|
|
|
|
|
|
|
|
Can only be specified in configuration files.
|
|
|
|
|
|
|
|
`This option is specific to the Swift storage backend.`
|
|
|
|
|
|
|
|
If true, Glance will attempt to create the container ``swift_store_container``
|
|
|
|
if it does not exist.
|
|
|
|
|
|
|
|
Configuring the Glance Registry
|
|
|
|
-------------------------------
|
|
|
|
|
|
|
|
Glance ships with a default, reference implementation registry server. There
|
|
|
|
are a number of configuration options in Glance that control how this registry
|
|
|
|
server operates. These configuration options are specified in the
|
|
|
|
``glance.conf`` config file `in the section [app:glance-registry]`.
|
|
|
|
|
|
|
|
* ``sql_connection=CONNECTION_STRING`` (``--sql-connection`` when specified
|
|
|
|
on command line)
|
|
|
|
|
|
|
|
Optional. Default: ``None``
|
|
|
|
|
|
|
|
Can be specified in configuration files. Can also be specified on the
|
|
|
|
command-line for the ``glance-manage`` program.
|
|
|
|
|
|
|
|
Sets the SQLAlchemy connection string to use when connecting to the registry
|
|
|
|
database. Please see the documentation for
|
|
|
|
`SQLAlchemy connection strings <http://www.sqlalchemy.org/docs/05/reference/sqlalchemy/connections.html>`_
|
|
|
|
online.
|
|
|
|
|
|
|
|
* ``sql_timeout=SECONDS``
|
|
|
|
on command line)
|
|
|
|
|
|
|
|
Optional. Default: ``3600``
|
|
|
|
|
|
|
|
Can only be specified in configuration files.
|
|
|
|
|
|
|
|
Sets the number of seconds after which SQLAlchemy should reconnect to the
|
|
|
|
datastore if no activity has been made on the connection.
|