Jump to: navigation, search

Difference between revisions of "NeutronDevstack"

(its a bad idea to replace the value of ENABLED_SERVICES as it will be replace the user added services. Also we should simple include the services which are necessary for Quantum.)
(→‎Basic Setup)
 
(60 intermediate revisions by 17 users not shown)
Line 1: Line 1:
−
__NOTOC__
 
−
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).
+
== Basic Setup ==
  
−
For example:
+
In order to use Neutron with devstack (http://devstack.org) a single node setup, you'll need the following settings in your local.conf (see [http://devstack.org/stack.sh.html  this page ] for more details on local.conf).
  
 
<pre><nowiki>
 
<pre><nowiki>
−
ENABLED_SERVICES="openstackx,q-svc,quantum,q-agt"
+
[[local|localrc]]
−
Q_PLUGIN=openvswitch
+
disable_service n-net
 +
enable_service q-svc
 +
enable_service q-agt
 +
enable_service q-dhcp
 +
enable_service q-l3
 +
enable_service q-meta
 +
# Optional, to enable tempest configuration as part of devstack
 +
enable_service tempest
 
</nowiki></pre>
 
</nowiki></pre>
  
Line 14: Line 19:
 
Then run stack.sh as normal.
 
Then run stack.sh as normal.
  
−
To enable melange in devstack add "melange" and "m-svc" to the ENABLED_SERVICES (melange requires quantum to be enabled as well).
+
If tempest has been successfully configured, a basic set of smoke tests can be run as follows:
 +
 
 +
<pre><nowiki>
 +
$ cd /opt/stack/tempest
 +
$ nosetests tempest/scenario/test_network_basic_ops.py
 +
</nowiki></pre>
 +
 
 +
 
 +
See the Neutron Admin Guide for details on interacting with Neutron: http://docs.openstack.org/trunk/openstack-network/admin/content/index.html
 +
 
 +
== XS/XCP Setup ==
 +
 
 +
See the following page for instructions on configuring Neutron (then called Quantum, which tells you how old the linked doc is) with OVS on XS/XCP: [[QuantumDevstackOvsXcp]]
 +
 
 +
== Multi-Node Setup ==
 +
 
 +
A more interesting setup involves running multiple compute nodes, with Neutron networks connecting VMs on different compute nodes.  
 +
 
 +
You should run at least one "controller node", which should have a localrc that includes at least:
  
−
For example:
 
  
 
<pre><nowiki>
 
<pre><nowiki>
−
ENABLED_SERVICES+="openstackx,q-svc,q-agt,m-svc,quantum,melange"
+
disable_service n-net
 +
enable_service q-svc
 +
enable_service q-agt
 +
enable_service q-dhcp
 +
enable_service q-l3
 +
enable_service q-meta
 +
enable_service neutron
 
</nowiki></pre>
 
</nowiki></pre>
 +
 +
 +
You can then run many compute nodes, each of which should have a localrc which includes the following, with the IP address of the above controller node:
 +
 +
 +
<pre><nowiki>
 +
ENABLED_SERVICES=n-cpu,rabbit,neutron,q-agt
 +
SERVICE_HOST=[IP of controller node]
 +
MYSQL_HOST=$SERVICE_HOST
 +
RABBIT_HOST=$SERVICE_HOST
 +
Q_HOST=$SERVICE_HOST
 +
</nowiki></pre>
 +
 +
 +
'''Note:''' the need to include 'rabbit' here seems to be a bug, which may have been fixed by the time you're reading this.If 'rabbit' is not specified, nova-compute also will try to connect to rabbit on localhost, not the "controller host".  See the following link for info on both issues: https://answers.launchpad.net/devstack/+question/197749

Latest revision as of 19:23, 21 August 2014

Basic Setup

In order to use Neutron with devstack (http://devstack.org) a single node setup, you'll need the following settings in your local.conf (see this page for more details on local.conf). 

[[local|localrc]]
disable_service n-net
enable_service q-svc
enable_service q-agt
enable_service q-dhcp
enable_service q-l3
enable_service q-meta
# Optional, to enable tempest configuration as part of devstack
enable_service tempest


Then run stack.sh as normal.

If tempest has been successfully configured, a basic set of smoke tests can be run as follows: 

$ cd /opt/stack/tempest
$ nosetests tempest/scenario/test_network_basic_ops.py


See the Neutron Admin Guide for details on interacting with Neutron: http://docs.openstack.org/trunk/openstack-network/admin/content/index.html

XS/XCP Setup

See the following page for instructions on configuring Neutron (then called Quantum, which tells you how old the linked doc is) with OVS on XS/XCP: QuantumDevstackOvsXcp

Multi-Node Setup

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

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


disable_service n-net
enable_service q-svc
enable_service q-agt
enable_service q-dhcp
enable_service q-l3
enable_service q-meta
enable_service neutron


You can then run many compute nodes, each of which should have a localrc which includes the following, with the IP address of the above controller node: 


ENABLED_SERVICES=n-cpu,rabbit,neutron,q-agt
SERVICE_HOST=[IP of controller node]
MYSQL_HOST=$SERVICE_HOST
RABBIT_HOST=$SERVICE_HOST
Q_HOST=$SERVICE_HOST


Note: the need to include 'rabbit' here seems to be a bug, which may have been fixed by the time you're reading this.If 'rabbit' is not specified, nova-compute also will try to connect to rabbit on localhost, not the "controller host". See the following link for info on both issues: https://answers.launchpad.net/devstack/+question/197749

Retrieved from "https://wiki.openstack.org/w/index.php?title=NeutronDevstack&oldid=61090"