.\" Man page generated from reStructuredText.
.
.TH "GLANCE-MANAGE" "1" "February 21, 2019" "" "glance"
.SH NAME
glance-manage \- Glance Management Utility
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH GLANCE MANAGEMENT UTILITY
.INDENT 0.0
.TP
.B Author
OpenStack Glance Project Team
.TP
.B Contact
\fI\%glance@lists.launchpad.net\fP
.TP
.B Date
2018\-02\-28
.TP
.B Copyright
OpenStack Foundation
.TP
.B Version
16.0.0
.TP
.B Manual section
1
.TP
.B Manual group
cloud computing
.UNINDENT
.SS SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
glance\-manage [options]
.ft P
.fi
.UNINDENT
.UNINDENT
.SS DESCRIPTION
.sp
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:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
glance\-manage db_sync
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Note: glance\-manage commands can be run either like this:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
glance\-manage db sync
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
or with the db commands concatenated, like this:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
glance\-manage db_sync
.ft P
.fi
.UNINDENT
.UNINDENT
.SS COMMANDS
.INDENT 0.0
.TP
.B \fBdb\fP
This is the prefix for the commands below when used with a space
rather than a _. For example "db version".
.TP
.B \fBdb_version\fP
This will print the current migration level of a glance database.
.TP
.B \fBdb_upgrade [VERSION]\fP
This will take an existing database and upgrade it to the
specified VERSION.
.TP
.B \fBdb_version_control\fP
Place the database under migration control.
.TP
.B \fBdb_sync [VERSION]\fP
Place an existing database under migration control and upgrade it to
the specified VERSION.
.TP
.B \fBdb_expand\fP
Run this command to expand the database as the first step of a rolling
upgrade process.
.TP
.B \fBdb_migrate\fP
Run this command to migrate the database as the second step of a
rolling upgrade process.
.TP
.B \fBdb_contract\fP
Run this command to contract the database as the last step of a rolling
upgrade process.
.TP
.B \fBdb_export_metadefs [PATH | PREFIX]\fP
Export the metadata definitions into json format. By default the
definitions are exported to /etc/glance/metadefs directory.
\fBNote: this command will overwrite existing files in the supplied or
default path.\fP
.TP
.B \fBdb_load_metadefs [PATH]\fP
Load the metadata definitions into glance database. By default the
definitions are imported from /etc/glance/metadefs directory.
.TP
.B \fBdb_unload_metadefs\fP
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.
.UNINDENT
.SS OPTIONS
.sp
\fBGeneral Options\fP
.INDENT 0.0
.TP
.B \fB\-h, \-\-help\fP
Show the help message and exit
.TP
.B \fB\-\-version\fP
Print the version number and exit
.TP
.B \fB\-v, \-\-verbose\fP
Print more verbose output
.TP
.B \fB\-\-noverbose\fP
Disable verbose output
.TP
.B \fB\-d, \-\-debug\fP
Print debugging output (set logging level to DEBUG instead of
default WARNING level)
.TP
.B \fB\-\-nodebug\fP
Disable debugging output
.TP
.B \fB\-\-use\-syslog\fP
Use syslog for logging
.TP
.B \fB\-\-nouse\-syslog\fP
Disable the use of syslog for logging
.TP
.B \fB\-\-syslog\-log\-facility SYSLOG_LOG_FACILITY\fP
syslog facility to receive log lines
.TP
.B \fB\-\-config\-dir DIR\fP
Path to a config directory to pull *.conf files from. This
file set is sorted, to provide a predictable parse order
if individual options are over\-ridden. The set is parsed after
the file(s) specified via previous \-\-config\-file, arguments hence
over\-ridden options in the directory take precedence. This means
that configuration from files in a specified config\-dir will
always take precedence over configuration from files specified
by \-\-config\-file, regardless to argument order.
.TP
.B \fB\-\-config\-file PATH\fP
Path to a config file to use. Multiple config files can be
specified by using this flag multiple times, for example,
\-\-config\-file <file1> \-\-config\-file <file2>. Values in latter
files take precedence.
.TP
.B \fB\-\-log\-config\-append PATH\fP \fB\-\-log\-config PATH\fP
The name of logging configuration file. It does not
disable existing loggers, but just appends specified
logging configuration to any other existing logging
options. Please see the Python logging module documentation
for details on logging configuration files. The log\-config
name for this option is deprecated.
.TP
.B \fB\-\-log\-format FORMAT\fP
A logging.Formatter log message format string which may use any
of the available logging.LogRecord attributes. Default: None
.TP
.B \fB\-\-log\-date\-format DATE_FORMAT\fP
Format string for %(asctime)s in log records. Default: None
.TP
.B \fB\-\-log\-file PATH, \-\-logfile PATH\fP
(Optional) Name of log file to output to. If not set, logging
will go to stdout.
.TP
.B \fB\-\-log\-dir LOG_DIR, \-\-logdir LOG_DIR\fP
(Optional) The directory to keep log files in (will be prepended
to \-\-log\-file)
.UNINDENT
.SS SEE ALSO
.INDENT 0.0
.IP \(bu 2
\fI\%OpenStack Glance\fP
.UNINDENT
.SS BUGS
.INDENT 0.0
.IP \(bu 2
Glance bugs are tracked in Launchpad so you can view current bugs at \fI\%OpenStack Glance\fP
.UNINDENT
.SS CONFIGURATION
.sp
The following paths are searched for a \fBglance\-manage.conf\fP file in the
following order:
.INDENT 0.0
.IP \(bu 2
\fB~/.glance\fP
.IP \(bu 2
\fB~/\fP
.IP \(bu 2
\fB/etc/glance\fP
.IP \(bu 2
\fB/etc\fP
.UNINDENT
.sp
All options set in \fBglance\-manage.conf\fP override those set in
\fBglance\-registry.conf\fP and \fBglance\-api.conf\fP\&.
.SH AUTHOR
OpenStack
.SH COPYRIGHT
2010-present, OpenStack Foundation.
.\" Generated by docutils manpage writer.
.