This adds a --strict option that can be passed in when calling the nova-manage cell_v2 discover_hosts command. When this option is used, the command will only return success if a new host has been found. In any other case it is considered a failure. Closes-Bug: #1692982 Change-Id: I942af11a3987e1edce67423c66931ad9ece65587
10 KiB
nova-manage
control and manage cloud computer instances
- Author
- 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 themap_cell0
orsimple_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.
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 themap_cell_and_hosts
command if you are upgrading from a cells v1 environment, and thesimple_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
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
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 Quota
nova-manage quota refresh
Refresh the quota usage for a project or user.
Nova Project
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). Users of the
quota_usage_refresh
subcommand should instead use nova-manage
quota refresh <nova-manage-quota>
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>]
Refresh the quota usages for the project/user so that the usage record matches the actual used. If a key is not specified then all quota usages relevant to the project/user are refreshed.
The
nova-manage quota refresh <nova-manage-quota>
command performs the same actions and is not deprecated. That command should be used instead.
SEE ALSO
BUGS
- Nova bugs are managed at Launchpad Bugs : Nova