Cisco Openstack 2012.2.3

This release contains all upstream patches for OpenStack core components as of the 2012.2.3 release. Client libraries have been updated to newer versions and tested as well. This release also features an updated Nagios module, Puppet automation bugfixes, log cleanup, and a switch to .deb packaging for Puppet modules.

Getting the Source and Installing the Release
--------------------------------------------------------------
Information about how to install Cisco OpenStack Edition - Folsom can be found here:

http://docwiki.cisco.com/wiki/OpenStack:Folsom-Multinode

Note that the instructions provided will install the latest stable maintenance patches for Folsom, which may be newer than those in the 2012.2.3 maintenance release. If you need to specifically install the versions of the packages released in 2012.2.3 even though newer maintenance updates are available, you can modify your apt configuration to point to our 2012.2.3 snapshot repository. Execute these steps:

1.) Edit /etc/apt/sources.list.d/cisco-openstack-mirror_folsom.list and change the following lines:

deb ftp://ftpeng.cisco.com/openstack/cisco folsom main
deb-src ftp://ftpeng.cisco.com/openstack/cisco folsom main

to:

deb ftp://ftpeng.cisco.com/openstack/cisco folsom/snapshots/2012.2.3 main
deb-src ftp://ftpeng.cisco.com/openstack/cisco folsom/snapshots/2012.2.3 main

2.) Run "apt-get update" as root or via sudo.

3.) To ensure changes are propagated by Puppet, modify /etc/puppet/manifests/core.pp on your build node. Change line 28 (https://github.com/CiscoSystems/folsom-manifests/blob/2012.2.3/manifests/core.pp#L28) to read "folsom/snaphots/2012.2.3" instead of "folsom".

Note that you may also choose to run bleeding-edge (and not fully vetted) code by using "folsom-proposed" in place of "folsom/snapshots/2012.2.3" in the above instructions. This is recommended only for developers who expect things to be broken occasionally and is strongly discouraged for production environments.

The source code for this release has been posted to GitHub. Look for the "2012.2.3" tag in the repositories listed here:

https://github.com/CiscoSystems/

Limitations:
----------------
We do not support HA, Swift, Cinder, or incubated projects in this release although relevant repositories are available for customers to experiment with on their own.

Simple Network Model:
---------------------------------
Cisco OpenStack Edition uses Quantum to provide networking services. A number of network models are possible with appropriate modifications to the Puppet manifests supplied here. Cisco has tested a simple network model that can serve as a starting point for COE users. The simple network model uses a single "control" node on which most OpenStack control services are run and multiple compute nodes. Network segmentation is provided by Open vSwitch via GRE tunneling. Two physically or logically (VLAN) separated IP networks with an external router or layer-3 switch that provides connectivity between these two networks are deployed: one to provide connectivity for OpenStack API endpoints, Open vSwitch (OVS) GRE endpoints, and OpenStack/UCS management. The second network is used by OVS as the physical bridge interface and by Quantum as the public network. More information can be found in our installation instructions here:

http://docwiki.cisco.com/wiki/OpenStack:Folsom-Multinode