110 lines
2.7 KiB
ReStructuredText
110 lines
2.7 KiB
ReStructuredText
=============
|
|
glance-manage
|
|
=============
|
|
|
|
-------------------------
|
|
Glance Management Utility
|
|
-------------------------
|
|
|
|
:Author: glance@lists.launchpad.net
|
|
:Date: 2016-10-6
|
|
:Copyright: OpenStack Foundation
|
|
:Version: 13.0.0
|
|
:Manual section: 1
|
|
:Manual group: cloud computing
|
|
|
|
SYNOPSIS
|
|
========
|
|
|
|
glance-manage [options]
|
|
|
|
DESCRIPTION
|
|
===========
|
|
|
|
glance-manage is a utility for managing and configuring a Glance installation.
|
|
One important use of glance-manage is to setup the database. To do this run::
|
|
|
|
glance-manage db_sync
|
|
|
|
Note: glance-manage commands can be run either like this::
|
|
|
|
glance-manage db sync
|
|
|
|
or with the db commands concatenated, like this::
|
|
|
|
glance-manage db_sync
|
|
|
|
|
|
|
|
COMMANDS
|
|
========
|
|
|
|
**db**
|
|
This is the prefix for the commands below when used with a space
|
|
rather than a _. For example "db version".
|
|
|
|
**db_version**
|
|
This will print the current migration level of a glance database.
|
|
|
|
**db_upgrade <VERSION>**
|
|
This will take an existing database and upgrade it to the
|
|
specified VERSION.
|
|
|
|
**db_version_control**
|
|
Place the database under migration control.
|
|
|
|
**db_sync <VERSION>**
|
|
Place an existing database under migration control and upgrade it to
|
|
the specified VERSION.
|
|
|
|
**db_expand**
|
|
Run this command to expand the database as the first step of a rolling
|
|
upgrade process.
|
|
|
|
**db_migrate**
|
|
Run this command to migrate the database as the second step of a
|
|
rolling upgrade process.
|
|
|
|
**db_contract**
|
|
Run this command to contract the database as the last step of a rolling
|
|
upgrade process.
|
|
|
|
**db_export_metadefs [PATH | PREFIX]**
|
|
Export the metadata definitions into json format. By default the
|
|
definitions are exported to /etc/glance/metadefs directory.
|
|
**Note: this command will overwrite existing files in the supplied or
|
|
default path.**
|
|
|
|
**db_load_metadefs [PATH]**
|
|
Load the metadata definitions into glance database. By default the
|
|
definitions are imported from /etc/glance/metadefs directory.
|
|
|
|
**db_unload_metadefs**
|
|
Unload the metadata definitions. Clears the contents of all the glance
|
|
db tables including metadef_namespace_resource_types, metadef_tags,
|
|
metadef_objects, metadef_resource_types, metadef_namespaces and
|
|
metadef_properties.
|
|
|
|
OPTIONS
|
|
=======
|
|
|
|
**General Options**
|
|
|
|
.. include:: general_options.rst
|
|
|
|
.. include:: footer.rst
|
|
|
|
CONFIGURATION
|
|
=============
|
|
|
|
The following paths are searched for a ``glance-manage.conf`` file in the
|
|
following order:
|
|
|
|
* ``~/.glance``
|
|
* ``~/``
|
|
* ``/etc/glance``
|
|
* ``/etc``
|
|
|
|
All options set in ``glance-manage.conf`` override those set in
|
|
``glance-registry.conf`` and ``glance-api.conf``.
|