openstack/nova
Code Issues Proposed changes
94638e353a
nova/doc/source/cli/nova-manage.rst
Dan Smith f2606322f7 Deprecate useless quota_usage_refresh from nova-manage 
Since we no longer use usage records, we don't need the nova-manage
command to sync usage records with actual resource consumption.

Co-Authored-By: melanie witt <melwittt@gmail.com>

Part of blueprint cells-count-resources-to-check-quota-in-api

Change-Id: I55f7a2b6e15eec6e6ec97be23903325ad22bd4d4
2017-07-19 19:33:23 +00:00

280 lines
10 KiB
ReStructuredText
Raw Blame History

===========
nova-manage
===========
-------------------------------------------
control and manage cloud computer instances
-------------------------------------------
:Author: openstack@lists.openstack.org
:Date: 2017-01-15
:Copyright: OpenStack Foundation
:Version: 15.0.0
:Manual section: 1
:Manual group: cloud computing
SYNOPSIS
========
nova-manage <category> <action> [<args>]
DESCRIPTION
===========
nova-manage controls cloud computing instances by managing shell selection, vpn connections, and floating IP address configuration. More information about OpenStack Nova is at https://docs.openstack.org/developer/nova.
OPTIONS
=======
The standard pattern for executing a nova-manage command is:
``nova-manage <category> <command> [<args>]``
Run without arguments to see a list of available command categories:
``nova-manage``
You can also run with a category argument such as user to see a list of all commands in that category:
``nova-manage db``
These sections describe the available categories and arguments for nova-manage.
Nova Database
~~~~~~~~~~~~~
``nova-manage db version``
Print the current main database version.
``nova-manage db sync [--version <version>] [--local_cell]``
Upgrade the main database schema up to the most recent version or
``--version`` if specified. By default, this command will also attempt to
upgrade the schema for the cell0 database if it is mapped (see the
``map_cell0`` or ``simple_cell_setup`` commands for more details on mapping
the cell0 database). If ``--local_cell`` is specified, then only the main
database in the current cell is upgraded. The local database connection is
determined by ``[database]/connection`` in the configuration file passed to
nova-manage.
``nova-manage db archive_deleted_rows [--max_rows <number>] [--verbose]``
Move deleted rows from production tables to shadow tables. Specifying
--verbose will print the results of the archive operation for any tables
that were changed.
``nova-manage db null_instance_uuid_scan [--delete]``
Lists and optionally deletes database records where instance_uuid is NULL.
Nova API Database
~~~~~~~~~~~~~~~~~
``nova-manage api_db version``
Print the current cells api database version.
``nova-manage api_db sync``
Sync the api cells database up to the most recent version. This is the standard way to create the db as well.
.. _man-page-cells-v2:
Nova Cells v2
~~~~~~~~~~~~~
``nova-manage cell_v2 simple_cell_setup [--transport-url <transport_url>]``
Setup a fresh cells v2 environment; this should not be used if you
currently have a cells v1 environment. Returns 0 if setup is completed
(or has already been done), 1 if no hosts are reporting (and cannot be
mapped), 1 if no transport url is provided for the cell message queue,
and 2 if run in a cells v1 environment.
``nova-manage cell_v2 map_cell0 [--database_connection <database_connection>]``
Create a cell mapping to the database connection for the cell0 database.
If a database_connection is not specified, it will use the one defined by
``[database]/connection`` in the configuration file passed to nova-manage.
The cell0 database is used for instances that have not been scheduled to
any cell. This generally applies to instances that have encountered an
error before they have been scheduled. Returns 0 if cell0 is created
successfully or already setup.
``nova-manage cell_v2 map_instances --cell_uuid <cell_uuid> [--max-count <max_count>]``
Map instances to the provided cell. Instances in the nova database will
be queried from oldest to newest and mapped to the provided cell. A
max_count can be set on the number of instance to map in a single run.
Repeated runs of the command will start from where the last run finished
so it is not necessary to increase max-count to finish. Returns 0 if all
instances have been mapped, and 1 if there are still instances to be
mapped.
``nova-manage cell_v2 map_cell_and_hosts [--name <cell_name>] [--transport-url <transport_url>] [--verbose]``
Create a cell mapping to the database connection and message queue
transport url, and map hosts to that cell. The database connection
comes from the ``[database]/connection`` defined in the configuration
file passed to nova-manage. If a transport_url is not specified, it will
use the one defined by ``[DEFAULT]/transport_url`` in the configuration
file. This command is idempotent (can be run multiple times), and the
verbose option will print out the resulting cell mapping uuid. Returns 0
on successful completion, and 1 if the transport url is missing.
``nova-manage cell_v2 verify_instance --uuid <instance_uuid> [--quiet]``
Verify instance mapping to a cell. This command is useful to determine if
the cells v2 environment is properly setup, specifically in terms of the
cell, host, and instance mapping records required. Returns 0 when the
instance is successfully mapped to a cell, 1 if the instance is not
mapped to a cell (see the ``map_instances`` command), and 2 if the cell
mapping is missing (see the ``map_cell_and_hosts`` command if you are
upgrading from a cells v1 environment, and the ``simple_cell_setup`` if
you are upgrading from a non-cells v1 environment).
``nova-manage cell_v2 create_cell [--name <cell_name>] [--transport-url <transport_url>] [--database_connection <database_connection>] [--verbose]``
Create a cell mapping to the database connection and message queue
transport url. If a database_connection is not specified, it will use
the one defined by ``[database]/connection`` in the configuration file
passed to nova-manage. If a transport_url is not specified, it will use
the one defined by ``[DEFAULT]/transport_url`` in the configuration file.
The verbose option will print out the resulting cell mapping uuid.
Returns 0 if the cell mapping was successfully created, 1 if the
transport url or database connection was missing, and 2 if a cell is
already using that transport url and database connection combination.
``nova-manage cell_v2 discover_hosts [--cell_uuid <cell_uuid>] [--verbose] [--strict]``
Searches cells, or a single cell, and maps found hosts. This command will
check the database for each cell (or a single one if passed in) and map
any hosts which are not currently mapped. If a host is already mapped
nothing will be done. You need to re-run this command each time you add
more compute hosts to a cell (otherwise the scheduler will never place
instances there and the API will not list the new hosts). If the strict
option is provided the command will only be considered successful if an
unmapped host is discovered (exit code 0). Any other case is considered a
failure (exit code 1).
``nova-manage cell_v2 list_cells [--verbose]``
Lists the v2 cells in the deployment. By default only the cell name and
uuid are shown. Use the --verbose option to see transport url and
database connection details.
``nova-manage cell_v2 delete_cell --cell_uuid <cell_uuid>``
Delete an empty cell by the given uuid. Returns 0 if the empty cell is
found and deleted successfully, 1 if a cell with that uuid could not be
found, 2 if host mappings were found for the cell (cell not empty), and
3 if there are instances mapped to the cell (cell not empty).
``nova-manage cell_v2 update_cell --cell_uuid <cell_uuid> [--name <cell_name>] [--transport-url <transport_url>] [--database_connection <database_connection>]``
Updates the properties of a cell by the given uuid. If a
database_connection is not specified, it will attempt to use the one
defined by ``[database]/connection`` in the configuration file. If a
transport_url is not specified, it will attempt to use the one defined
by ``[DEFAULT]/transport_url`` in the configuration file. If the cell
is not found by uuid, this command will return an exit code of 1. If
the properties cannot be set, this will return 2. Otherwise, the exit
code will be 0.
NOTE: Updating the transport_url or database_connection fields on
a running system will NOT result in all nodes immediately using the
new values. Use caution when changing these values.
Nova Logs
~~~~~~~~~
.. deprecated:: 16.0.0
This will be removed in 17.0.0 (Queens)
``nova-manage logs errors``
Displays nova errors from log files.
``nova-manage logs syslog <number>``
Displays nova alerts from syslog.
Nova Shell
~~~~~~~~~~
.. deprecated:: 16.0.0
This will be removed in 17.0.0 (Queens)
``nova-manage shell bpython``
Starts a new bpython shell.
``nova-manage shell ipython``
Starts a new ipython shell.
``nova-manage shell python``
Starts a new python shell.
``nova-manage shell run``
Starts a new shell using python.
``nova-manage shell script <path/scriptname>``
Runs the named script from the specified path with flags set.
.. _nova-manage-quota:
Nova Quota
~~~~~~~~~~
.. deprecated:: 16.0.0
This will be removed in 17.0.0 (Queens)
``nova-manage quota refresh``
This command has been deprecated and is now a no-op since quota usage is
counted from resources instead of being tracked separately.
Nova Project
~~~~~~~~~~~~
.. deprecated:: 16.0.0
Much of this information is available over the API, with the exception of
the ``quota_usage_refresh`` command. Operators should use the `API`_ for
all other operations.
This command group will be removed in 17.0.0 (Queens). The
``quota_usage_refresh`` subcommand has been deprecated and is now a no-op
since quota usage is counted from resources instead of being tracked
separately.
.. _API: https://developer.openstack.org/api-ref/compute/#quota-sets-os-quota-sets
``nova-manage project quota <project_id> [--user <user_id>] [--key <key>] [--value <value>]``
Create, update or display quotas for project/user. If a key is
not specified then the current usages are displayed.
``nova-manage project quota_usage_refresh <project_id> [--user <user_id>] [--key <key>]``
This command has been deprecated and is now a no-op since quota usage is
counted from resources instead of being tracked separately.
SEE ALSO
========
* `OpenStack Nova <https://docs.openstack.org/developer/nova>`__
BUGS
====
* Nova bugs are managed at Launchpad `Bugs : Nova <https://bugs.launchpad.net/nova>`__
View Git Blame Copy Permalink