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