ReleaseNotes1507
|
Size: 4522
Comment:
|
Size: 4722
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' command, e.g.: {{{ juju upgrade 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 --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: |
| * neutron-api | |
| Line 13: | Line 73: |
| * swift-proxy * swift-storage * ceilometer * ceilometer-agent * heat |
* neutron-openvswitch |
| Line 19: | Line 75: |
| 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 77: |
| {{{ cat > config.yaml << EOF nova-cloud-controller: openstack-origin: cloud:precise-icehouse EOF juju deploy --config config.yaml nova-cloud-controller }}} |
Further deploy from source enablement is expected during the 15.07 charm development cycle. |
| Line 29: | Line 79: |
| OpenStack Icehouse is provided as the default OpenStack release on Ubuntu 14.04 so no additional configuration is required in 14.04 deployments. | '''NOTE''': Current support extends to deployment of Icehouse and Juno from source repositories; Kilo support is not yet complete but will be delivered as a stable update between now and the 15.07 charm release. |
| Line 31: | Line 81: |
| === Active/Active and SSL RabbitMQ === | |
| Line 33: | Line 82: |
| 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: | == Deprecation Notices == |
| Line 35: | Line 84: |
| {{{ juju deploy rabbitmq-server juju add-unit -n 1 rabbitmq-server }}} |
=== MySQL HA with Ceph === |
| Line 40: | Line 86: |
| Charms should be related to the rabbitmq-server charm as before: | 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 42: | Line 88: |
| {{{ juju add-relation cinder 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 46: | Line 90: |
| The rabbitmq-server charm also now supports use of SSL connections, for example: | 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 48: | Line 92: |
| {{{ juju set rabbitmq-server ssl=only }}} |
=== hacluster - default transport === |
| Line 52: | Line 94: |
| 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''' |
| Line 54: | Line 96: |
| * '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. |
For the 15.04 charm release, the hacluster charm will continue to use multicast as its default transport option for cluster communications. |
| Line 58: | Line 98: |
| '''NOTE''': This feature is not yet compatible with RabbitMQ server in native Active/Active HA mode. | 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 60: | Line 100: |
| === SSL MySQL === | === nova-cloud-controller and neutron-api charms === |
| Line 62: | Line 102: |
| TBC | Management of neutron configuration and services will be removed from any nova-* charms for the 15.10 charm release. |
| Line 64: | Line 104: |
| === PostgreSQL === | 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 66: | Line 106: |
| 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: | 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 68: | Line 108: |
| {{{ juju deploy postgresql juju add-relation cinder postgresql:db }}} |
== Bugs Fixed == |
| Line 73: | Line 110: |
| 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 |
Contents
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' command, e.g.:
juju upgrade 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 --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
- quantum-gateway
- neutron-openvswitch
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.
Further deploy from source enablement is expected during the 15.07 charm development cycle.
NOTE: Current support extends to deployment of Icehouse and Juno from source repositories; Kilo support is not yet complete but will be delivered as a stable update between now and the 15.07 charm release.
Deprecation Notices
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.
hacluster - default transport
NOTE: Originally planned for 15.07 release, deferred
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.
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)