Jump to: navigation, search

Difference between revisions of "NeutronDevstack"

Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 +
== Basic Setup ==
 +
 
In order to use Quantum with devstack (http://devstack.org) you'll need to add "quantum" and "q-svc" to ENABLED_SERVICES in your localrc.  See this page for more details on localrc settings: http://devstack.org/stack.sh.html.
 
In order to use Quantum with devstack (http://devstack.org) you'll need to add "quantum" and "q-svc" to ENABLED_SERVICES in your localrc.  See this page for more details on localrc settings: http://devstack.org/stack.sh.html.
  
Line 13: Line 15:
  
 
Then run stack.sh as normal.
 
Then run stack.sh as normal.
 +
 +
== Multi-Node Setup ==
 +
 +
A more interesting setup involves running multiple compute nodes, with Quantum networks connecting VMs on different compute nodes. 
  
 
We have a review for running Quantum on multiple nodes: https://review.openstack.org/#/c/7001/
 
We have a review for running Quantum on multiple nodes: https://review.openstack.org/#/c/7001/
  
You should run at least one "controller node", which includes at least:  
+
You should run at least one "controller node", which should have a stackrc that includes at least:  
  
  
Line 25: Line 31:
  
  
You can then run many compute nodes, which include:  
+
You likely want to change your localrc to run a scheduler that will balance VMs across hosts:
 +
 
 +
 
 +
<pre><nowiki>
 +
SCHEDULER=nova.scheduler.simple.SimpleScheduler
 +
</nowiki></pre>
 +
 
 +
 
 +
You can then run many compute nodes, each of which should have a stackrc which includes:  
  
  
Line 34: Line 48:
  
  
'''Note:''' the need to include 'g-api' here seems to be a bug.  Without it, nova-compute dies because it can't import the glance.common library.  
+
Each compute node also needs to have a modified localrc to point to the "controller" for services that are only run once per deployment:
 +
 
 +
 
 +
<pre><nowiki>
 +
SERVICE_HOST=[IP of controller node]
 +
MYSQL_HOST=$SERVICE_HOST
 +
RABBIT_HOST=$SERVICE_HOST
 +
</nowiki></pre>
 +
 
 +
 
 +
'''Note:''' the need to include 'g-api' here seems to be a bug.  Without it, nova-compute dies because it can't import the glance.common library. This process does not actually need to be running on this host, we just need a way to make sure the glance.common library is installed.
 +
 
 +
== Running with Melange ==
  
 
To enable melange in devstack add "melange" and "m-svc" to the ENABLED_SERVICES (melange requires quantum to be enabled as well).
 
To enable melange in devstack add "melange" and "m-svc" to the ENABLED_SERVICES (melange requires quantum to be enabled as well).

Revision as of 15:34, 7 May 2012

Basic Setup

In order to use Quantum with devstack (http://devstack.org) you'll need to add "quantum" and "q-svc" to ENABLED_SERVICES in your localrc. See this page for more details on localrc settings: http://devstack.org/stack.sh.html.

If you want to enable the openvswitch plugin, you'll have to set Q_PLUGIN to "openvswitch" and also add "q-agt" to ENABLED_SERVICES in order to start the openvswitch quantum agent (also in your localrc).

For example:

ENABLED_SERVICES="g-api,g-reg,key,n-api,n-cpu,n-net,n-sch,n-vnc,horizon,mysql,rabbit,openstackx,q-svc,quantum,q-agt"
Q_PLUGIN=openvswitch


Then run stack.sh as normal.

Multi-Node Setup

A more interesting setup involves running multiple compute nodes, with Quantum networks connecting VMs on different compute nodes.

We have a review for running Quantum on multiple nodes: https://review.openstack.org/#/c/7001/

You should run at least one "controller node", which should have a stackrc that includes at least:


ENABLED_SERVICES="quantum,q-svc,[insert other centralized services here]"
Q_PLUGIN=openvswitch


You likely want to change your localrc to run a scheduler that will balance VMs across hosts:


SCHEDULER=nova.scheduler.simple.SimpleScheduler


You can then run many compute nodes, each of which should have a stackrc which includes:


ENABLED_SERVICES="quantum,q-agt,n-cpu,g-api"
Q_PLUGIN=openvswitch


Each compute node also needs to have a modified localrc to point to the "controller" for services that are only run once per deployment:


SERVICE_HOST=[IP of controller node]
MYSQL_HOST=$SERVICE_HOST
RABBIT_HOST=$SERVICE_HOST


Note: the need to include 'g-api' here seems to be a bug. Without it, nova-compute dies because it can't import the glance.common library. This process does not actually need to be running on this host, we just need a way to make sure the glance.common library is installed.

Running with Melange

To enable melange in devstack add "melange" and "m-svc" to the ENABLED_SERVICES (melange requires quantum to be enabled as well).

For example:

ENABLED_SERVICES=g-api,g-reg,key,n-api,n-cpu,n-net,n-sch,n-novnc,n-xvnc,n-cauth,horizon,mysql,rabbit,openstackx,q-svc,q-agt,m-svc,quantum,melange