MidoNet 5.4 Integration with RHOSP 10 (Newton) on RHEL 7

This guide covers the basic steps for the integration of MidoNet 5.4 into a RHOSP 10 deployment using RHEL 7, assuming basic knowledge about RHOSP 10 and its composable services.

Limitations

This installer has the following limitations:

• Only one MidoNet Gateway can be deployed at a time. If you need more gateway nodes in your deployment these should be configured manually.
• Only one floating IP network can be created at a time with the installer. The installer creates an initial floating IP network. If more than one of these networks are required, this should be done manually afterwards.

Initial configuration

Follow the RHOSP 10 documentation until you have an Undercloud installed. Stop at the Obtaining Images for Overcloud Nodes section. We're going to build our own images with the necessary components to run MidoNet.

Building the base images

NOTE: This step is just temporary. Later on Midokura will host a series of base images ready to be consumed.

Download a RHEL 7.3 cloud image and place them inside a folder. Let's assume the working directory will be /home/stack/custom-images/.

Then export these variables (filling in the necessary values) in order to be able to build the image . If you're using Red Hat Satellite, set the REG_SAT_URL REG_SAT_URL and REG_ORG environment variables as described in the TripleO documentation instead.

# Base variables
export DIB_LOCAL_IMAGE=YOUR_RHEL_IMAGE_PATH
export ELEMENTS_PATH="/home/stack/custom-images/tripleo-puppet-elements/elements:/usr/share/instack-undercloud:/usr/share/tripleo-image-elements:/usr/bin/../share/diskimage-builder/elements"
export DIB_NO_TMPFS=1

# RH Openstack subscription details
export REG_METHOD=portal
export REG_USER="YOUR_USERNAME"
export REG_PASSWORD="YOUR_PASSWORD"
export REG_POOL_ID="YOUR_POOL_ID"
export REG_REPOS="rhel-7-server-rpms rhel-7-server-optional-rpms rhel-7-server-extras-rpms \
    rhel-ha-for-rhel-7-server-rpms rhel-7-server-openstack-10-rpms \
    rhel-7-server-rhceph-2-tools-rpms rhel-7-server-rhceph-2-mon-rpms"

# MidoNet specific variables
export DIB_MIDONET_stage=stable
export DIB_MIDONET_version="5.4"
export DIB_MIDONET_openstack_version=newton

As you can see above, we will be installing MidoNet 5.4 from its stable branch, for the Newton release. Then clone these two repositories from the MidoNet GitHub organization (while the patches are being reviewed upstream) and place them inside /home/stack/custom-images/. Then checkout the stable/newton_midonet branch, as it's the branch that contains all changes.

• tripleo-puppet-elements
• tripleo-heat-templates

To see a full list of the DIB_MIDONET environment variables that can be set check the file at /home/stack/custom-images/tripleo-puppet-elements/elements/overcloud-network-midonet/environment.d/02-midonet-envs.bash.

Finally, proceed to build the base image with the following command:

openstack overcloud image build --type overcloud-full --elements-path $ELEMENTS_PATH --builder-extra-args overcloud-network-midonet

If for whatever reason the process of building the image fails, refer to the TripleO documentation on the topic.

Upload the images

Just as you would normally do following the RHOSP documentation, unpack the IPA base images at /usr/share/rhosp-director-images/ironic-python-agent-*.tar inside /home/stack/custom-images/. Finally upload these images using:

openstack overcloud image upload

Configure MidoNet composable services

What services does MidoNet define?

The MidoNet Heat templates define the following composable services:

How do these services have to be distributed amongst roles?

Distribute these services as you need to on the nodes you are planning on deploying. These services and more are defined in the file roles_data.yaml, inside the previously cloned tripleo-heat-templates folder.

• midonet_agent should be present in the controller, computes and gateway.
• midonet_cluster should be placed in the controller role (but doesn't have to).
• midonet_config is configured through the environment file (see below). No need to instantiate this service manually in roles_data.yaml.
• midonet_gateway should be configured in a separate gateway node or in any other (as long as there's only 1).
• midonet_nsdb can be placed in a dedicated role or placed along any other.

Set environment variables

Now that the images have been built and uploaded successfully it's time to prepare the MidoNet deployment. Depending on the type of uplink that needs to be set up (BGP or static) you will need to define a certain set of variables. It is recommended to set these in an environment file.

Whether you are configuring a static or a BGP uplink these base variables need to be defined:

As the service midonet_config configures the edge router and sets up a basic set of networks and subnets, these variables too have to be defined:

Further customization of the deployment can be done through the use of additional parameters. All these parameters are described with detail inside the files puppet/services/network/midonet*.yaml, inside the tripleo-heat-templates folder.

Also these resources need to be mapped accordingly (check how this is done by seeing the environments/neutron-midonet.yaml inside the tripleo-heat-templates folder).

Fake static uplink

In order to set up a static uplink you can set the values just as they are set in the table above, or check the file environments/neutron-midonet.yaml inside the tripleo-heat-templates folder. Only one more parameter needs to be set:

For more information on setting up a fake static uplink check the MidoNet documentation.

BGP uplink

Setting up a BGP uplink requires setting four additional environment variables. For a real-life example please check environments/neutron-midonet-bgp.yaml inside the tripleo-heat-templates folder.

For more information on setting up a BGP uplink please check the MidoNet documentation.

Configure a nameserver

Before actually deploying the overcloud let's assign a DNS server to the network on which these nodes will be deployed:

neutron subnet-list
neutron subnet-update [subnet-uuid] --dns-nameserver [nameserver-ip]

Deploy the overcloud

Now just as you would normally do, deploy the overcloud with the following command:

openstack overcloud deploy --templates /home/stack/custom-images/tripleo-heat-templates -e [your_environment_file]