table of contents
other versions
- wheezy 2012.1.1-18
- jessie 2014.1.3-11
- jessie-backports 2:13.1.0-2~bpo8+1
- testing 2:14.0.0-4
- unstable 2:14.0.0-4
NOVA-MANAGE(1) | nova | NOVA-MANAGE(1) |
NAME¶
nova-manage - Cloud controller fabricCONTROL AND MANAGE CLOUD COMPUTER INSTANCES AND IMAGES¶
- Author
- openstack@lists.launchpad.net
- Date
- 2012-04-05
- Copyright
- OpenStack LLC
- 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 nova users, nova projects, nova roles, 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>]Nova Db¶
nova-manage db versionPrint the current database version.
Sync the database up to the most recent
version. This is the standard way to create the db as well.
Nova User¶
nova-manage user admin <username>Create an admin user with the name
<username>.
Create a normal user with the name
<username>.
Delete the user with the name
<username>.
Outputs a list of access key and secret keys
for user to the screen
Outputs a list of all the user names to the
screen.
Updates the indicated user keys, indicating
with T or F if the user is an admin user. Leave any argument blank if you do
not want to update it.
Nova Project¶
nova-manage project add <projectname>Add a nova project with the name
<projectname> to the database.
Create a new nova project with the name
<projectname> (you still need to do nova-manage project add
<projectname> to add it to the database).
Delete a nova project with the name
<projectname>.
Exports environment variables for the named
project to a file named novarc.
Outputs a list of all the projects to the
screen.
Outputs the size and specs of the project's
instances including gigabytes, instances, floating IPs, volumes, and
cores.
Deletes the project with the name
<projectname>.
Compresses all related files for a created
project into a zip file nova.zip.
Nova Role¶
nova-manage role add <username> <rolename> <(optional) projectname>Add a user to either a global or project-based
role with the indicated <rolename> assigned to the named user. Role
names can be one of the following five roles: cloudadmin, itsec, sysadmin,
netadmin, developer. If you add the project name as the last argument then the
role is assigned just for that project, otherwise the user is assigned the
named role for all projects.
- nova-manage role has <username> <projectname>
- Checks the user or project and responds with True if the user has a global role with a particular project.
- nova-manage role remove <username> <rolename>
- Remove the indicated role from the user.
Nova Logs¶
nova-manage logs errorsDisplays nova errors from log files.
Displays nova alerts from syslog.
Nova Shell¶
nova-manage shell bpythonStarts a new bpython shell.
Starts a new ipython shell.
Starts a new python shell.
Starts a new shell using python.
Runs the named script from the specified path
with flags set.
Nova VPN¶
nova-manage vpn listDisplays a list of projects, their IP prot
numbers, and what state they're in.
Starts the VPN for the named project.
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.
Deletes floating IP addresses in the range
given.
Displays a list of all floating IP
addresses.
Nova Flavor¶
nova-manage flavor listOutputs a list of all active flavors to the
screen.
Outputs a list of all flavors (active and
inactive) to the screen.
- creates a flavor with the following positional arguments:
- •
- memory (expressed in megabytes)
- •
- vcpu(s) (integer)
- •
- local storage (expressed in gigabytes)
- •
- flavorid (unique integer)
- •
- swap space (expressed in megabytes, defaults to zero, optional)
- •
- RXTX quotas (expressed in gigabytes, defaults to zero, optional)
- •
- RXTX cap (expressed in gigabytes, defaults to zero, optional)
Delete the flavor with the name <name>.
This marks the flavor as inactive and cannot be launched. However, the record
stays in the database for archival and billing purposes.
Purges the flavor with the name <name>.
This removes this flavor from the database.
Nova Instance_type¶
The instance_type command is provided as an alias for the flavor command. All the same subcommands and arguments from nova-manage flavor can be used.Nova Images¶
nova-manage image image_register <path> <owner>Registers an image with the image
service.
Registers a kernel with the image
service.
Registers a ramdisk with the image
service.
Registers an image kernel and ramdisk with the
image service.
Converts all images in directory from the old
(Bexar) format to the new format.
Nova VM¶
- nova-manage vm list [host]
- Show a list of all instances. Accepts optional hostname (to show only instances on specific host).
- nova-manage live-migration <ec2_id> <destination host name>
- Live migrate instance from current host to destination host. Requires instance id (which comes from euca-describe-instance) and destination host name (which can be found from nova-manage service list).
FILES¶
The nova-manage.conf file contains configuration information in the form of python-gflags.SEE ALSO¶
- •
- OpenStack Nova
- •
- OpenStack Swift
BUGS¶
- •
- Nova is sourced in Launchpad so you can view current bugs at OpenStack Nova
AUTHOR¶
OpenStackCOPYRIGHT¶
2010-present, OpenStack, LLCApril 10, 2013 | 2012.1.2 |