Browse code

Merge "Docs for devstack MacVTap agent setup"

Jenkins authored on 2016/06/15 17:58:13
Showing 1 changed files
... ...
@@ -361,6 +361,8 @@ the compute service ``nova-compute``.
361 361
 DevStack Configuration
362 362
 ----------------------
363 363
 
364
+.. _ovs-provider-network-controller:
365
+
364 366
 The following is a snippet of the DevStack configuration on the
365 367
 controller node.
366 368
 
... ...
@@ -549,3 +551,101 @@ setup, with small modifications for the interface mappings.
549 549
     LB_PHYSICAL_INTERFACE=eth0
550 550
     PUBLIC_PHYSICAL_NETWORK=default
551 551
     LB_INTERFACE_MAPPINGS=default:eth0
552
+
553
+Using MacVTap instead of Open vSwitch
554
+------------------------------------------
555
+
556
+Security groups are not supported by the MacVTap agent. Due to that, devstack
557
+configures the NoopFirewall driver on the compute node.
558
+
559
+MacVTap agent does not support l3, dhcp and metadata agent. Due to that you can
560
+chose between the following deployment scenarios:
561
+
562
+Single node with provider networks using config drive and external l3, dhcp
563
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
564
+This scenario applies, if l3 and dhcp services are provided externally, or if
565
+you do not require them.
566
+
567
+
568
+::
569
+
570
+    [[local|localrc]]
571
+    HOST_IP=10.0.0.2
572
+    SERVICE_HOST=10.0.0.2
573
+    MYSQL_HOST=10.0.0.2
574
+    RABBIT_HOST=10.0.0.2
575
+    ADMIN_PASSWORD=secret
576
+    MYSQL_PASSWORD=secret
577
+    RABBIT_PASSWORD=secret
578
+    SERVICE_PASSWORD=secret
579
+
580
+    Q_ML2_PLUGIN_MECHANISM_DRIVERS=macvtap
581
+    Q_USE_PROVIDER_NETWORKING=True
582
+
583
+    #Enable Neutron services
584
+    disable_service n-net
585
+    enable_plugin neutron git://git.openstack.org/openstack/neutron
586
+    ENABLED_SERVICES+=,q-agt,q-svc
587
+
588
+    ## MacVTap agent options
589
+    Q_AGENT=macvtap
590
+    PHYSICAL_NETWORK=default
591
+
592
+    FIXED_RANGE="203.0.113.0/24"
593
+    NETWORK_GATEWAY=203.0.113.1
594
+    PROVIDER_SUBNET_NAME="provider_net"
595
+    PROVIDER_NETWORK_TYPE="vlan"
596
+    SEGMENTATION_ID=2010
597
+
598
+    [[post-config|/$Q_PLUGIN_CONF_FILE]]
599
+    [macvtap]
600
+    physical_interface_mappings = $PHYSICAL_NETWORK:eth1
601
+
602
+    [[post-config|$NOVA_CONF]]
603
+    force_config_drive = True
604
+
605
+
606
+Multi node with MacVTap compute node
607
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
608
+This scenario applies, if you require OpenStack provided l3, dhcp or metadata
609
+services. Those are hosted on a separate controller and network node, running
610
+some other l2 agent technology (in this example Open vSwitch). This node needs
611
+to be configured for VLAN tenant networks.
612
+
613
+For OVS, a similar configuration like described in the
614
+:ref:`OVS Provider Network <ovs-provider-network-controller>` section can be
615
+used. Just add the the following line to this local.conf, which also loads
616
+the MacVTap mechanism driver:
617
+
618
+::
619
+
620
+    [[local|localrc]]
621
+    ...
622
+    Q_ML2_PLUGIN_MECHANISM_DRIVERS=openvswitch,linuxbridge,macvtap
623
+    ...
624
+
625
+For the MacVTap compute node, use this local.conf:
626
+
627
+::
628
+
629
+    HOST_IP=10.0.0.3
630
+    SERVICE_HOST=10.0.0.2
631
+    MYSQL_HOST=10.0.0.2
632
+    RABBIT_HOST=10.0.0.2
633
+    ADMIN_PASSWORD=secret
634
+    MYSQL_PASSWORD=secret
635
+    RABBIT_PASSWORD=secret
636
+    SERVICE_PASSWORD=secret
637
+
638
+    # Services that a compute node runs
639
+    disable_all_services
640
+    enable_plugin neutron git://git.openstack.org/openstack/neutron
641
+    ENABLED_SERVICES+=n-cpu,q-agt
642
+
643
+    ## MacVTap agent options
644
+    Q_AGENT=macvtap
645
+    PHYSICAL_NETWORK=default
646
+
647
+    [[post-config|/$Q_PLUGIN_CONF_FILE]]
648
+    [macvtap]
649
+    physical_interface_mappings = $PHYSICAL_NETWORK:eth1