← Back to branch summary

~ubuntu-cloud-archive/ubuntu/precise/nova/trunk

« back to all changes in this revision

Viewing changes to doc/source/runnova/managing.networks.rst

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2012-05-24 13:12:53 UTC
  • mfrom: (1.1.55)
  • Revision ID: package-import@ubuntu.com-20120524131253-ommql08fg1en06ut
Tags: 2012.2~f1-0ubuntu1
https://launchpad.net/bugs/907197
* New upstream release.
* Prepare for quantal:
  - Dropped debian/patches/upstream/0006-Use-project_id-in-ec2.cloud._format_image.patch
  - Dropped debian/patches/upstream/0005-Populate-image-properties-with-project_id-again.patch
  - Dropped debian/patches/upstream/0004-Fixed-bug-962840-added-a-test-case.patch
  - Dropped debian/patches/upstream/0003-Allow-unprivileged-RADOS-users-to-access-rbd-volumes.patch
  - Dropped debian/patches/upstream/0002-Stop-libvirt-test-from-deleting-instances-dir.patch
  - Dropped debian/patches/upstream/0001-fix-bug-where-nova-ignores-glance-host-in-imageref.patch 
  - Dropped debian/patches/0001-fix-useexisting-deprecation-warnings.patch
* debian/control: Add python-keystone as a dependency. (LP: #907197)
* debian/patches/kombu_tests_timeout.patch: Refreshed.
* debian/nova.conf, debian/nova-common.postinst: Convert to new ini
  file configuration
* debian/patches/nova-manage_flagfile_location.patch: Refreshed

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/source/runnova/managing.networks.rst
1
 
..
2
 
      Copyright 2010-2011 United States Government as represented by the
3
 
      Administrator of the National Aeronautics and Space Administration.
4
 
      Overview Sections Copyright 2010-2011 Citrix
5
 
      All Rights Reserved.
6
 
 
7
 
      Licensed under the Apache License, Version 2.0 (the "License"); you may
8
 
      not use this file except in compliance with the License. You may obtain
9
 
      a copy of the License at
10
 
 
11
 
          http://www.apache.org/licenses/LICENSE-2.0
12
 
 
13
 
      Unless required by applicable law or agreed to in writing, software
14
 
      distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
15
 
      WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
16
 
      License for the specific language governing permissions and limitations
17
 
      under the License.
18
 
 
19
 
Networking Overview
20
 
===================
21
 
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.
22
 
 
23
 
Nova Network Strategies
24
 
-----------------------
25
 
 
26
 
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.
27
 
 
28
 
Read more about Nova network strategies here:
29
 
 
30
 
.. toctree::
31
 
   :maxdepth: 1
32
 
 
33
 
   network.flat.rst
34
 
   network.vlan.rst
35
 
 
36
 
 
37
 
Network Management Commands
38
 
---------------------------
39
 
 
40
 
.. todo::
41
 
 
42
 
   Reformat command line app instructions for ``nova-manage`` using
43
 
   ``:command:``, ``:option:``, and ``.. program::``. (bug-947261)
44
 
 
45
 
Admins and Network Administrators can use the 'nova-manage' command to manage network resources:
46
 
 
47
 
VPN Management
48
 
~~~~~~~~~~~~~~
49
 
 
50
 
* vpn list: Print a listing of the VPNs for all projects.
51
 
    * arguments: none
52
 
* vpn run: Start the VPN for a given project.
53
 
    * arguments: project
54
 
* vpn spawn: Run all VPNs.
55
 
    * arguments: none
56
 
 
57
 
 
58
 
Floating IP Management
59
 
~~~~~~~~~~~~~~~~~~~~~~
60
 
 
61
 
* floating create: Creates floating ips for host by range
62
 
    * arguments: host ip_range
63
 
* floating delete: Deletes floating ips by range
64
 
    * arguments: range
65
 
* floating list: Prints a listing of all floating ips
66
 
    * arguments: none
67
 
 
68
 
Network Management
69
 
~~~~~~~~~~~~~~~~~~
70
 
 
71
 
* network create: Creates fixed ips for host by range
72
 
    * arguments: [fixed_range=FLAG], [num_networks=FLAG],
73
 
                 [network_size=FLAG], [vlan_start=FLAG],
74
 
                 [vpn_start=FLAG]
75
 
 
76
 
* network modify: Associate/disassociate network with project and/or host.
77
 
 
78
 
  * :option:`--fixed_range=\<IP range\>` - Specify the network to modify by
79
 
    IP range.  Required.
80
 
  * :option:`--project=\<project name\>` - Project name to associate.
81
 
    Optional.
82
 
  * :option:`--host=\<host\>` - Host to associate.  Optional.
83
 
  * :option:`--disassociate-project` - Disassociate network from project.
84
 
    Optional, mutually exclusive with :option:`--project`.
85
 
  * :option:`--disassociate-host` - Disassociate host from project.
86
 
    Optional, mutually exclusive with :option:`--host`.
87
 
 
88
 
* network delete: Deletes a network.  Precisely one of :option:`--fixed_range`
89
 
  or :option:`--uuid` must be specified.
90
 
 
91
 
  * :option:`--fixed_range=\<IP range\>` - Specify the network by range.
92
 
  * :option:`--uuid=\<UUID\>` - Specify the network by UUID.