ReleaseNotes1507

Differences between revisions 1 and 63 (spanning 62 versions)
Revision 1 as of 2014-04-16 09:48:06
Size: 4522
Editor: james-page
Comment:
Revision 63 as of 2015-08-03 13:12:15
Size: 4658
Editor: corey.bryant
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== General Charm Updates == ## page was copied from ServerTeam/OpenStackCharms/ReleaseNotes1504
## page was copied from ServerTeam/OpenStackCharms/ReleaseNotes1501
<<TableOfContents>>
Line 3: Line 5:
=== Icehouse support for 12.04 and 14.04 === == Summary ==
Line 5: Line 7:
All OpenStack charms now support deployment of OpenStack 2014.1 (Icehouse) on Ubuntu 12.04 LTS and Ubuntu 14.04 LTS; this support includes the following charms:
 
The 15.04 OpenStack Charm release includes updates for the following charms:

 * ceilometer
 * ceilometer-agent
 * ceph
 * ceph-radosgw
 * cinder
 * cinder-ceph
 * glance
 * hacluster
 * heat
Line 8: Line 19:
 * neutron-api
 * neutron-openvswitch
 * nova-cloud-controller
 * nova-compute
 * openstack-dashboard
 * quantum-gateway
 * rabbitmq-server
 * swift-proxy
 * swift-storage
 * percona-cluster

== Upgrading ==

=== General ===

To upgrade an existing deployment to the latest charm version simply use the 'upgrade-charm' command, e.g.:

{{{
juju upgrade-charm cinder
}}}

=== Neutron Gateway ===

The quantum-gateway charm has been renamed 'neutron-gateway' for the 15.07 charm release; to upgrade existing quantum-gateway charm deployments please use:

{{{
juju upgrade-charm --switch cs:trusty/neutron-gateway quantum-gateway
}}}

This will switch the deployment of the quantum-gateway charm to the new charm name.

== New Charm Features ==

=== Improved HA deployment support ===

The !OpenStack charms have been updated to use a new feature of Juju called 'leadership-election'; this allows a charm to discover early in its life cycle whether its a) going to have peers and b) the leader of those peers. With this feature, the charms support deployment of HA configuration in a single shot, removing the requirement to deploy charms and relations sequentially or in phases.

'''NOTE:''' Use of this feature requires Juju >= 1.24.

'''NOTE:''' Backwards compatibility with earlier Juju versions not supporting leadership election is maintained, but deploying HA configurations in a single shot is not supported in this configuration.

=== Deployment from source ===

'''EXPERIMENTAL FEATURE'''

The following charms now have support for deploying OpenStack directly from git repositories:
Line 9: Line 67:
 * keystone
Line 12: Line 71:
 * quantum-gateway
 * swift-proxy
 * swift-storage
 * ceilometer
 * ceilometer-agent
 * heat
 * neutron-api
 * neutron-gateway
 * neutron-openvswitch
 * openstack-dashboard
Line 19: Line 76:
To deploy OpenStack Icehouse on Ubuntu 12.04, use the 'openstack-origin' configuration option, for example: This feature is enabled by using the new 'openstack-origin-git' configuration option; this can be used to configure a minimal or expanded list of repositories to collate and install - see the README in each charm for specific details.
Line 21: Line 78:
{{{
cat > config.yaml << EOF
nova-cloud-controller:
  openstack-origin: cloud:precise-icehouse
EOF
juju deploy --config config.yaml nova-cloud-controller
}}}
For this release, shallow git clones are performed on all repositories, and full isolation of services deployed from source is maintained in Python virtual environments.
Line 29: Line 80:
OpenStack Icehouse is provided as the default OpenStack release on Ubuntu 14.04 so no additional configuration is required in 14.04 deployments. == Deprecation Notices ==
Line 31: Line 82:
=== Active/Active and SSL RabbitMQ === === 15.10 - MySQL HA with Ceph ===
Line 33: Line 84:
All OpenStack charms now feature support for use with the rabbitmq-server charm configured in native active/active HA mode. To deploy RabbitMQ in this mode: The original HA implementation of OpenStack used the MySQL charm in-conjunction with Ceph to provide a traditional active/passive shared block device HA mysql option.
Line 35: Line 86:
{{{
juju deploy rabbitmq-server
juju add-unit -n 1 rabbitmq-server
}}}
Percona XtraDB Cluster, as provided by the percona-cluster charm, provides an active/active MySQL configuration with no requirement for a shared block device.
Line 40: Line 88:
Charms should be related to the rabbitmq-server charm as before: Users of the original MySQL HA option should migrate to a Percona XtraDB Cluster deployment between now and the 15.10 charm release, where support for MySQL with Ceph will be removed.
Line 42: Line 90:
{{{
juju add-relation cinder rabbitmq-server
}}}
=== 15.10 - hacluster - default transport ===
Line 46: Line 92:
The rabbitmq-server charm also now supports use of SSL connections, for example: For the 15.04 charm release, the hacluster charm will continue to use multicast as its default transport option for cluster communications.
Line 48: Line 94:
{{{
juju set rabbitmq-server ssl=only
}}}
Unicast is generally more universally usable across all Juju providers - we'll be switching the default for 15.10 including automatic migration and re-configuration of existing multicast clusters. Instructions will also be provided for users who wish to continue to use the multicast transport option.
Line 52: Line 96:
This will force all RabbitMQ connections to operate over SSL. Options for the ssl config flag include: '''NOTE: Originally planned for 15.07 release, deferred to 15.10'''
Line 54: Line 98:
 * 'only': configure RabbitMQ server over a SSL port only.
 * 'off': configure RabbitMQ server over a non-SSL port only.
 * 'both': configure RabbitMQ server with SSL and non-SSL ports.
=== 15.10 - nova-cloud-controller and neutron-api charms ===
Line 58: Line 100:
'''NOTE''': This feature is not yet compatible with RabbitMQ server in native Active/Active HA mode. Management of neutron configuration and services will be removed from any nova-* charms for the 15.10 charm release.
Line 60: Line 102:
=== SSL MySQL === This means that the neutron-api principle charm needs to be deployed to run the neutron-server service and if openvswitch is being used then neutron-openvswitch subordinate charm needs to deployed and attached to the nova-compute charm. This is a fully supported migration path for existing deployments not using these charms.
Line 62: Line 104:
TBC The nova-compute charm now has an option called 'manage-neutron-plugin-legacy-mode'. The default value for this option is True but as of 15.10 this will switch to False which will disable the management of neutron services by default.
Line 64: Line 106:
=== PostgreSQL === == Bugs Fixed ==
Line 66: Line 108:
Support for use of PostgreSQL as the database for OpenStack components has been added to the OpenStack charms. This feature can be used by deploying the postgresql charm and relating services to it - for example:

{{{
juju deploy postgresql
juju add-relation cinder postgresql:db
}}}

The nova-cloud-controller charm requires access to two databases (neutron and nova), so the procedure is slightly different:

{{{
juju add-relation nova-cloud-controller:pgsql-nova-db postgresql:db
juju add-relation nova-cloud-controller:pgsql-neutron-db postgresql:db
}}}

'''NOTE''': Its not possible to switch an existing MySQL deployment to PostgreSQL - the charms will error and fail-safe if you try todo this.

=== Upgrading 12.04 deployments to Icehouse ===

'''WARNING''': Upgrading an OpenStack deployment is always a non-trivial process. The OpenStack charms automate alot of the process, however always plan and test your upgrade prior to upgrading production OpenStack environments.

Existing Havana and Grizzly deployments of OpenStack on Ubuntu 12.04 can be upgraded to Icehouse by issuing:

{{{
juju upgrade-charm <charm-name>
juju set <charm-name> openstack-origin=cloud:precise-icehouse
}}}

for each OpenStack charm in your deployment. Services which cannot be upgraded directly from Grizzly->Icehouse will be stepped automatically through the Havana release first.

== New Charm Features ==

=== Neutron - Modular Layer 2 plugin ===

The nova-cloud-controller, nova-compute and quantum-gateway charms will deploy the Modular Layer 2 (ml2) plugin, using the Open vSwitch L2 driver and GRE tunnelling, by default for Icehouse.

Existing Havana deployments using the older Open vSwitch (ovs) plugin will be automatically migrated to the ml2 plugin on upgrade.

=== Neutron - Enabled Extensions ===

The following extensions/drivers have been enabled for Icehouse deployments:

 * Metering
 * Load Balancing as-a Service - using the default haproxy implementation.
 * Firewall as-a Service - using the default iptables implementation
 * VPN as-a Service - using OpenSwan IPSec VPN.

=== Swift - default middleware ===

The following middleware has been added to the default swift-proxy pipeline for OpenStack Icehouse:

 * gatekeeper
 * staticweb
 * bulk
 * slo - static large objects
 * dlo - dynamic large objects
 * tempurl
 * formpost
 * container-quotas
 * account-quotas
 * container_sync

In addition, container versioning has also been enabled in the swift-storage charm.

For more details on these features, please refer to the [[http://docs.openstack.org/developer/swift/middleware.html|upstream documentation]].
For the full list of bugs resolved for the 15.07 release please refer to https://launchpad.net/charms/+milestone/15.07

Summary

The 15.04 OpenStack Charm release includes updates for the following charms:

  • ceilometer
  • ceilometer-agent
  • ceph
  • ceph-radosgw
  • cinder
  • cinder-ceph
  • glance
  • hacluster
  • heat
  • keystone
  • neutron-api
  • neutron-openvswitch
  • nova-cloud-controller
  • nova-compute
  • openstack-dashboard
  • quantum-gateway
  • rabbitmq-server
  • swift-proxy
  • swift-storage
  • percona-cluster

Upgrading

General

To upgrade an existing deployment to the latest charm version simply use the 'upgrade-charm' command, e.g.:

juju upgrade-charm cinder

Neutron Gateway

The quantum-gateway charm has been renamed 'neutron-gateway' for the 15.07 charm release; to upgrade existing quantum-gateway charm deployments please use:

juju upgrade-charm --switch cs:trusty/neutron-gateway quantum-gateway

This will switch the deployment of the quantum-gateway charm to the new charm name.

New Charm Features

Improved HA deployment support

The OpenStack charms have been updated to use a new feature of Juju called 'leadership-election'; this allows a charm to discover early in its life cycle whether its a) going to have peers and b) the leader of those peers. With this feature, the charms support deployment of HA configuration in a single shot, removing the requirement to deploy charms and relations sequentially or in phases.

NOTE: Use of this feature requires Juju >= 1.24.

NOTE: Backwards compatibility with earlier Juju versions not supporting leadership election is maintained, but deploying HA configurations in a single shot is not supported in this configuration.

Deployment from source

EXPERIMENTAL FEATURE

The following charms now have support for deploying OpenStack directly from git repositories:

  • cinder
  • keystone
  • glance
  • nova-cloud-controller
  • nova-compute
  • neutron-api
  • neutron-gateway
  • neutron-openvswitch
  • openstack-dashboard

This feature is enabled by using the new 'openstack-origin-git' configuration option; this can be used to configure a minimal or expanded list of repositories to collate and install - see the README in each charm for specific details.

For this release, shallow git clones are performed on all repositories, and full isolation of services deployed from source is maintained in Python virtual environments.

Deprecation Notices

15.10 - MySQL HA with Ceph

The original HA implementation of OpenStack used the MySQL charm in-conjunction with Ceph to provide a traditional active/passive shared block device HA mysql option.

Percona XtraDB Cluster, as provided by the percona-cluster charm, provides an active/active MySQL configuration with no requirement for a shared block device.

Users of the original MySQL HA option should migrate to a Percona XtraDB Cluster deployment between now and the 15.10 charm release, where support for MySQL with Ceph will be removed.

15.10 - hacluster - default transport

For the 15.04 charm release, the hacluster charm will continue to use multicast as its default transport option for cluster communications.

Unicast is generally more universally usable across all Juju providers - we'll be switching the default for 15.10 including automatic migration and re-configuration of existing multicast clusters. Instructions will also be provided for users who wish to continue to use the multicast transport option.

NOTE: Originally planned for 15.07 release, deferred to 15.10

15.10 - nova-cloud-controller and neutron-api charms

Management of neutron configuration and services will be removed from any nova-* charms for the 15.10 charm release.

This means that the neutron-api principle charm needs to be deployed to run the neutron-server service and if openvswitch is being used then neutron-openvswitch subordinate charm needs to deployed and attached to the nova-compute charm. This is a fully supported migration path for existing deployments not using these charms.

The nova-compute charm now has an option called 'manage-neutron-plugin-legacy-mode'. The default value for this option is True but as of 15.10 this will switch to False which will disable the management of neutron services by default.

Bugs Fixed

For the full list of bugs resolved for the 15.07 release please refer to https://launchpad.net/charms/+milestone/15.07

OpenStack/OpenStackCharms/ReleaseNotes1507 (last edited 2016-06-20 13:04:30 by james-page)