nova/doc/source/man/nova-manage.rst

4.9 KiB

nova-manage

control and manage cloud computer instances and images

Author

openstack@lists.openstack.org

Date

2012-04-05

Copyright

OpenStack Foundation

Version

2012.1

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 http://nova.openstack.org.

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

Categories are project, shell, vpn, and floating. Detailed descriptions are below.

You can also run with a category argument such as user to see a list of all commands in that category: nova-manage floating

These sections describe the available categories and arguments for nova-manage.

Nova Db

nova-manage db version

Print the current main database version.

nova-manage db sync

Sync the main database up to the most recent version. This is the standard way to create the db as well.

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 ApiDb

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 Logs

nova-manage logs errors

Displays nova errors from log files.

nova-manage logs syslog <number>

Displays nova alerts from syslog.

Nova Shell

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 Project

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.

nova-manage project scrub <project-id>

Deletes data associated with project.

Nova VPN

nova-manage vpn list

Displays a list of projects, their IP port numbers, and what state they're in.

nova-manage vpn run <projectname>

Starts the VPN for the named project.

nova-manage vpn spawn

Runs all VPNs.

Nova Floating IPs

nova-manage floating create <ip_range> [--pool <pool>] [--interface <interface>]

Creates floating IP addresses for the given range, optionally specifying a floating pool and a network interface.

nova-manage floating delete <ip_range>

Deletes floating IP addresses in the range given.

nova-manage floating list

Displays a list of all floating IP addresses.

Nova Images

nova-manage image image_register <path> <owner>

Registers an image with the image service.

nova-manage image kernel_register <path> <owner>

Registers a kernel with the image service.

nova-manage image ramdisk_register <path> <owner>

Registers a ramdisk with the image service.

nova-manage image all_register <image_path> <kernel_path> <ramdisk_path> <owner>

Registers an image kernel and ramdisk with the image service.

nova-manage image convert <directory>

Converts all images in directory from the old (Bexar) format to the new format.

Nova VM

DEPRECATED Use the nova list command from python-novaclient instead. The vm subcommand will be removed in the 15.0.0 Ocata release.

nova-manage vm list [host]

Show a list of all instances. Accepts optional hostname (to show only instances on specific host).

SEE ALSO

BUGS