Files
nova/doc/source/runnova/managing.networks.rst
Ewan Mellor 4cbf0984f9 Bug #916312: nova-manage network modify --network flag is inconsistent.
Change nova-manage network modify --network to --fixed_range, to match
nova-manage network delete.

Also document both.

Change-Id: I3c03a33e9e3576393252d771eb4ce3353a7f2eaa
2012-01-24 13:41:42 -08:00

3.7 KiB

Networking Overview

In Nova, users organize their cloud resources in projects. A Nova project consists of a number of VM instances created by a user. For each VM instance, Nova assigns to it a private IP address. (Currently, Nova only supports Linux bridge networking that allows the virtual interfaces to connect to the outside network through the physical interface. Other virtual network technologies, such as Open vSwitch, could be supported in the future.) The Network Controller provides virtual networks to enable compute servers to interact with each other and with the public network.

Nova Network Strategies

Currently, Nova supports three kinds of networks, implemented in three "Network Manager" types respectively: Flat Network Manager, Flat DHCP Network Manager, and VLAN Network Manager. The three kinds of networks can co-exist in a cloud system. However, the scheduler for selecting the type of network for a given project is not yet implemented. Here is a brief description of each of the different network strategies, with a focus on the VLAN Manager in a separate section.

Read more about Nova network strategies here:

network.flat.rst network.vlan.rst

Network Management Commands

Admins and Network Administrators can use the 'nova-manage' command to manage network resources:

VPN Management

  • vpn list: Print a listing of the VPNs for all projects.
    • arguments: none
  • vpn run: Start the VPN for a given project.
    • arguments: project
  • vpn spawn: Run all VPNs.
    • arguments: none

Floating IP Management

  • floating create: Creates floating ips for host by range
    • arguments: host ip_range
  • floating delete: Deletes floating ips by range
    • arguments: range
  • floating list: Prints a listing of all floating ips
    • arguments: none

Network Management

  • network create: Creates fixed ips for host by range
    • arguments: [fixed_range=FLAG], [num_networks=FLAG],

      [network_size=FLAG], [vlan_start=FLAG], [vpn_start=FLAG]

  • network modify: Associate/disassociate network with project and/or host.
    • --fixed_range=\<IP range\> - Specify the network to modify by IP range. Required.
    • --project=\<project name\> - Project name to associate. Optional.
    • --host=\<host\> - Host to associate. Optional.
    • --disassociate-project - Disassociate network from project. Optional, mutually exclusive with --project.
    • --disassociate-host - Disassociate host from project. Optional, mutually exclusive with --host.
  • network delete: Deletes a network. Precisely one of --fixed_range or --uuid must be specified.
    • --fixed_range=\<IP range\> - Specify the network by range.
    • --uuid=\<UUID\> - Specify the network by UUID.