1c7f556d4f
This change moves existing files, updates a few of the cross-references and paths, and fixes some formatting. It is not meant to be the final word on how the main page looks or how the other files are organized, but it gets everything roughly into shape. If the glance team wants to make changes, please do those as follow-up patches This change depends on the spec and on a feature of pbr that allows us to move where the auto-generated class reference documentation ends up in the tree. Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454 Depends-On: I2bd5652bb59cbd9c939931ba2e7db1b37d2b30bb Change-Id: I9dde267793a5913acb5b1ec028cfb66bc5189783 Signed-off-by: Doug Hellmann <doug@doughellmann.com>
66 lines
2.0 KiB
ReStructuredText
66 lines
2.0 KiB
ReStructuredText
..
|
|
Copyright 2012 OpenStack Foundation
|
|
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.
|
|
|
|
Legacy Database Management
|
|
==========================
|
|
|
|
.. note::
|
|
This page applies only to Glance releases prior to Ocata. From Ocata
|
|
onward, please see :doc:`db`.
|
|
|
|
The default metadata driver for Glance uses sqlalchemy, which implies there
|
|
exists a backend database which must be managed. The ``glance-manage`` binary
|
|
provides a set of commands for making this easier.
|
|
|
|
The commands should be executed as a subcommand of 'db':
|
|
|
|
glance-manage db <cmd> <args>
|
|
|
|
|
|
Sync the Database
|
|
-----------------
|
|
|
|
glance-manage db sync <version> <current_version>
|
|
|
|
Place a database under migration control and upgrade, creating it first if necessary.
|
|
|
|
|
|
Determining the Database Version
|
|
--------------------------------
|
|
|
|
glance-manage db version
|
|
|
|
This will print the current migration level of a Glance database.
|
|
|
|
|
|
Upgrading an Existing Database
|
|
------------------------------
|
|
|
|
glance-manage db upgrade <VERSION>
|
|
|
|
This will take an existing database and upgrade it to the specified VERSION.
|
|
|
|
|
|
Downgrading an Existing Database
|
|
--------------------------------
|
|
|
|
Upgrades involve complex operations and can fail. Before attempting any
|
|
upgrade, you should make a full database backup of your production data. As of
|
|
Kilo, database downgrades are not supported, and the only method available to
|
|
get back to a prior database version is to restore from backup[1].
|
|
|
|
[1]: http://docs.openstack.org/ops-guide/ops-upgrades.html#perform-a-backup
|