glance/doc/source/cli/glancemanage.rst
Ian Wienand 0035ab2538 Revert "Remove all example configs for deprecated registry"
This reverts commit 2a28696de9.

Devstack still references a number of these files; revert until
devstack incorporates removal.

Change-Id: I1e90ceee1f87291668e447f180f37bb809763836
2020-02-14 14:30:44 +11:00

107 lines
2.5 KiB
ReStructuredText

=============
glance-manage
=============
-------------------------
Glance Management Utility
-------------------------
.. include:: header.txt
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.txt
.. include:: footer.txt
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``.