Provided by: nova-common_2012.1-0ubuntu2_all bug


       nova-manage - Cloud controller fabric



       Date   2012-04-05

              OpenStack LLC


       Manual section

       Manual group
              cloud computing

          nova-manage <category> <action> [<args>]

       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

       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

       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 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 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 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 <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 Flavor
       nova-manage flavor list
          Outputs a list of all active flavors to the screen.

       nova-manage flavor list --all
          Outputs a list of all flavors (active and inactive) to the screen.

       nova-manage flavor create <name> <memory> <vCPU>  <local_storage>  <flavorID>  <(optional)
       swap> <(optional) RXTX Quota> <(optional) RXTX Cap>

          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)

       nova-manage flavor delete <name>
          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.

       nova-manage flavor delete <name> --purge
          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.

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

       The nova-manage.conf file contains configuration information in the form of python-gflags.

       · OpenStack Nova

       · OpenStack Swift

       · Nova is sourced in Launchpad so you can view current bugs at OpenStack Nova




       2010-present, OpenStack, LLC