Table Of Contents

Previous topic

Running Nova

Next topic

Euca2ools

This Page

Psst... hey. You're reading the latest content, but it might be out of sync with code. You can read Nova 2011.1 docs or all OpenStack docs too.

The nova-manage command

Introduction

The nova-manage command is used to perform many essential functions for administration and ongoing maintenance of nova, such as user creation, vpn management, and much more.

The standard pattern for executing a nova-manage command is: nova-manage <category> <command> [<args>]

For example, to obtain a list of all projects: nova-manage project list

Run without arguments to see a list of available command categories: nova-manage

Categories are user, project, role, 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 user

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

Nova Db

nova-manage db version

Print the current database version.

nova-manage db sync

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>.

nova-manage user create <username>

Create a normal user with the name <username>.

nova-manage user delete <username>

Delete the user with the name <username>.

nova-manage user exports <username>

Outputs a list of access key and secret keys for user to the screen

nova-manage user list

Outputs a list of all the user names to the screen.

nova-manage user modify <accesskey> <secretkey> <admin?T/F>

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.

nova-manage project create <projectname>

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).

nova-manage project delete <projectname>

Delete a nova project with the name <projectname>.

nova-manage project environment <projectname> <username>

Exports environment variables for the named project to a file named novarc.

nova-manage project list

Outputs a list of all the projects to the screen.

nova-manage project quota <projectname>

Outputs the size and specs of the project’s instances including gigabytes, instances, floating IPs, volumes, and cores.

nova-manage project remove <projectname>

Deletes the project with the name <projectname>.

nova-manage project zipfile

Compresses all related files for a created project into a zip file nova.zip.

Nova Role

nova-manage role <action> [<argument>] 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: admin, itsec, projectmanager, 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 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 VPN

nova-manage vpn list

Displays a list of projects, their IP prot 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 <host> <ip_range>

Creates floating IP addresses for the named host by the given range.

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.

Concept: Flags

python-gflags

Concept: Plugins

  • Managers/Drivers: utils.import_object from string flag
  • virt/connections: conditional loading from string flag
  • db: LazyPluggable via string flag
  • auth_manager: utils.import_class based on string flag
  • Volumes: moving to pluggable driver instead of manager
  • Network: pluggable managers
  • Compute: same driver used, but pluggable at connection

Concept: IPC/RPC

Rabbit!

Concept: Fakes

  • auth
  • ldap

Concept: Scheduler

  • simple
  • random

Concept: Security Groups

Security groups

Concept: Certificate Authority

Nova does a small amount of certificate management. These certificates are used for project vpns and decrypting bundled images.

Concept: Images

  • launching
  • bundling