Add DB Management docs

Fixes bug 909064

Change-Id: Ifd477b345dfb03efe8e8e5befa03a0cb2a3c3ce8
This commit is contained in:
Brian Waldon 2012-08-17 12:12:16 -04:00
parent 5eb7ac1d2e
commit 6089423427
2 changed files with 69 additions and 5 deletions

56
doc/source/db.rst Normal file
View File

@ -0,0 +1,56 @@
..
Copyright 2012 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.
Database Management
===================
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.
Initializing an Empty Database
------------------------------
glance-manage db_sync
This will take an empty database and create the necessary tables.
Determining the Database Version
--------------------------------
glance-manage db_version
This will print the version of a glance database.
Upgrading an Existing Database
------------------------------
glance-manage db_sync <VERSION>
This will take an existing database and upgrade it to the specified VERSION.
Downgrading an Existing Database
--------------------------------
glance-manage downgrade <VERSION>
This will downgrade an existing database from the current version to the
specified VERSION.

View File

@ -50,8 +50,8 @@ Concepts
statuses
formats
Using Glance
============
Managing Glance
===============
.. toctree::
:maxdepth: 1
@ -59,12 +59,20 @@ Using Glance
installing
controllingservers
configuring
db
policies
cache
authentication
Using Glance
============
.. toctree::
:maxdepth: 1
glance
glanceapi
client
authentication
policies
cache
Developer Docs
==============