RETIRED, Calico provides Layer 3 Virtual Networking for Highly Scalable Data Centers

Go to file

Emma Gordon 9507daa4f4 Add user guide, test plan and test report docs Change-Id: I906a14709b61f7fe216d4a7a5ea8aee8f64711e9		2015-09-07 12:30:43 +01:00
deployment_scripts	Post Fuel deployment, remove default OpenStack network configuration which doesn't work with Calico.	2015-07-29 15:37:49 +01:00
doc	Add user guide, test plan and test report docs	2015-09-07 12:30:43 +01:00
repositories	Create Calico plugin for Fuel 6.1	2015-05-20 14:42:38 +01:00
specs	Update link to Calico code on GitHub for Calico repo move	2015-07-29 15:37:58 +01:00
.gitreview	Added .gitreview	2015-04-27 12:43:44 +00:00
LICENSE	Remove copyright line from license file	2015-07-07 18:13:48 +01:00
README.md	Update README with instructions for downloading certified plugin from Fuel Plugin Catalog	2015-08-11 13:56:32 +01:00
environment_config.yaml	Create Calico plugin for Fuel 6.1	2015-05-20 14:42:38 +01:00
metadata.yaml	Create Calico plugin for Fuel 6.1	2015-05-20 14:42:38 +01:00
pre_build_hook	Create Calico plugin for Fuel 6.1	2015-05-20 14:42:38 +01:00
tasks.yaml	Post Fuel deployment, remove default OpenStack network configuration which doesn't work with Calico.	2015-07-29 15:37:49 +01:00

README.md

Calico plugin for Mirantis Fuel

Calico provides seamless, scalable, secure Layer 3 Virtual Networking for your Mirantis OpenStack Deployment.

By replacing OpenStack’s native networking model, Calico targets deployments where the vast majority of workloads only require L3 connectivity, providing efficient, easy to troubleshoot networking, without the complexity and inefficiency of overlay networking models. Calico does not require any additional nodes or Calico specific management – it just works, and gets out of your way!

Limitations:

In the current release, Calico requires a deployment with a single OpenStack controller. This limitation will be lifted in future releases.

Compatible versions:

Mirantis Fuel 6.1

To obtain the plugin:

The Calico plugin can be downloaded from the Fuel Plugin Catalog.

Alternatively, to build the plugin:

Install the fuel plugin builder, fpb:

  easy_install pip

  pip install fuel-plugin-builder

Clone the calico plugin repository and run the plugin builder:

  git clone https://github.com/stackforge/fuel-plugin-calico

  cd fuel-plugin-calico/

  fpb --build .

Check that the file calico-fuel-plugin-1.0-1.0.0-0.noarch.rpm was created.

To install the plugin:

Prepare a clean fuel master node.

Copy the plugin onto the fuel master node:

  scp calico-fuel-plugin-1.0-1.0.0-0.noarch.rpm root@<Fuel_Master_Node_IP>:/tmp

Install the plugin on the fuel master node:

  cd /tmp

  fuel plugins --install calico-fuel-plugin-1.0-1.0.0-0.noarch.rpm

Check the plugin was installed:
```
  fuel plugins --list
```

User Guide

To deploy a cluster with the Calico plugin, use the Fuel web UI to deploy an OpenStack cluster in the usual way, with the following guidelines:

Create a new OpenStack environment, selecting:

Juno on Ubuntu Trusty

"Neutron with VLAN segmentation" as the networking setup
Under the settings tab, make sure the following options are checked:

"Assign public network to all nodes"

"Use Calico Virtual Networking"
Under the network tab, configure the 'Public' settings (leaving all of the other sections with their default values). For example (exact values will depend on your setup):
- IP Range: 172.18.203.60 - 172.18.203.69
  - CIDR: 172.18.203.0/24
  - Use VLAN tagging: No
  - Gateway: 172.18.203.1
- Floating IP range: 172.18.203.70 - 172.18.203.79
Add nodes (for meaningful testing, you will need at least two compute nodes in addition to the controller). Note that, in this release of Calico, only a single controller node is supported.
Deploy changes

README.md Unescape Escape