xenial (1) glance-manage.1.gz

NAME

       glance-manage - Glance Management Utility

GLANCE MANAGEMENT UTILITY

       Author glance@lists.launchpad.net

       Date   2014-01-16

       Copyright
              OpenStack LLC

       Version
              2014.1

       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_downgrade <VERSION>
                 This will take an existing database and downgrade it to the specified VERSION.

          db_version_control
                 Place the database under migration control.

          db_sync <VERSION> <CURRENT_VERSION>
                 Place a database under migration control and upgrade, creating it first if necessary.

          db_export_metadefs
                 Export  the  metadata  definitions into json format. By default the definitions are exported to
                 /etc/glance/metadefs directory.

          db_load_metadefs
                 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

              -h, --help
                     Show the help message and exit

              --version
                     Print the version number and exit

              -v, --verbose
                     Print more verbose output

              --noverbose
                     Disable verbose output

              -d, --debug
                     Print debugging output (set logging level to DEBUG instead of default WARNING level)

              --nodebug
                     Disable debugging output

              --use-syslog
                     Use syslog for logging

              --nouse-syslog
                     Disable the use of syslog for logging

              --syslog-log-facility SYSLOG_LOG_FACILITY
                     syslog facility to receive log lines

              --config-dir DIR
                     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.

              --config-file PATH
                     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.

              --log-config-append PATH --log-config PATH
                     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 depcrecated.

              --log-format FORMAT
                     A  logging.Formatter  log  message  format  string  which  may  use  any  of  the available
                     logging.LogRecord attributes. Default: None

              --log-date-format DATE_FORMAT
                     Format string for %(asctime)s in log records. Default: None

              --log-file PATH, --logfile PATH
                     (Optional) Name of log file to output to. If not set, logging will go to stdout.

              --log-dir LOG_DIR, --logdir LOG_DIR
                     (Optional) The directory to keep log files in (will be prepended to --log-file)

          --sql_connection=CONN_STRING
                 A proper SQLAlchemy connection string as described here

   SEE ALSO
       • OpenStack Glance

   BUGS
       • Glance bugs are tracked in Launchpad so you can view current bugs at OpenStack Glance

   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.

AUTHOR

       OpenStack

COPYRIGHT

       2010-2014, OpenStack Foundation.