ReleaseNotes1507

Differences between revisions 1 and 27 (spanning 26 versions)
Revision 1 as of 2014-04-16 09:48:06
Size: 4522
Editor: james-page
Comment:
Revision 27 as of 2015-04-20 08:50:38
Size: 7547
Editor: james-page
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
== General Charm Updates == ## page was copied from ServerTeam/OpenStackCharms/ReleaseNotes1501
<<TableOfContents>>
Line 3: Line 4:
=== Icehouse support for 12.04 and 14.04 === == Summary ==
Line 5: Line 6:
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.01 OpenStack Charm release includes updates for the following charms:

 * ceilometer
 * ceilometer-agent
 * ceph
 * ceph-radosgw
 * cinder
 * cinder-ceph
 * glance
 * hacluster
 * heat
Line 8: Line 18:
 * cinder
 * glance
 * neutron-api
 * neutron-openvswitch
Line 12: Line 22:
 * openstack-dashboard
Line 13: Line 24:
 * rabbitmq-server
Line 15: Line 27:
 * ceilometer
 * ceilometer-agent
 * heat
Line 19: Line 28:
To deploy OpenStack Icehouse on Ubuntu 12.04, use the 'openstack-origin' configuration option, for example:

{{{
cat > config.yaml << EOF
nova-cloud-controller:
  openstack-origin: cloud:precise-icehouse
EOF
juju deploy --config config.yaml nova-cloud-controller
}}}

OpenStack Icehouse is provided as the default OpenStack release on Ubuntu 14.04 so no additional configuration is required in 14.04 deployments.

=== Active/Active and SSL RabbitMQ ===

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:

{{{
juju deploy rabbitmq-server
juju add-unit -n 1 rabbitmq-server
}}}

Charms should be related to the rabbitmq-server charm as before:

{{{
juju add-relation cinder rabbitmq-server
}}}

The rabbitmq-server charm also now supports use of SSL connections, for example:

{{{
juju set rabbitmq-server ssl=only
}}}

This will force all RabbitMQ connections to operate over SSL. Options for the ssl config flag include:

 * '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.

'''NOTE''': This feature is not yet compatible with RabbitMQ server in native Active/Active HA mode.

=== SSL MySQL ===

TBC

=== PostgreSQL ===

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.
This release has mainly been focussed on bug fixing, however some new features have been introduced.
Line 97: Line 32:
=== Neutron - Modular Layer 2 plugin === === Clustering ===
Line 99: Line 34:
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. The trusty hacluster charm now supports running in multicast (default) and unicast modes, supporting use of this charm in environments where multicast UDP is not supported. To enable this feature:
Line 101: Line 36:
Existing Havana deployments using the older Open vSwitch (ovs) plugin will be automatically migrated to the ml2 plugin on upgrade. {{{
juju set hacluster corosync_transport=unicast
}}}
Line 103: Line 40:
=== Neutron - Enabled Extensions === At this point in time the previous node entries for the multicast cluster have to be removed manually - to complete this action, do the following on one of the members of the cluster:
Line 105: Line 42:
The following extensions/drivers have been enabled for Icehouse deployments: {{{
sudo crm node list
}}}
Line 107: Line 46:
 * 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.
New unicast nodes will start at 1001; the original multicast node entries should be deleted using:
Line 112: Line 48:
=== Swift - default middleware === {{{
sudo crm configure
 > delete <id>
}}}
Line 114: Line 53:
The following middleware has been added to the default swift-proxy pipeline for OpenStack Icehouse: The trusty hacluster charm now supports a new ‘debug’ configuration option to increase the verbosity of logging from corosync and pacemaker.
Line 116: Line 55:
 * gatekeeper
 * staticweb
 * bulk
 * slo - static large objects
 * dlo - dynamic large objects
 * tempurl
 * formpost
 * container-quotas
 * account-quotas
 * container_sync
The trusty hacluster charm also includes a number of fixes to improve the way that quorum is handled by corosync and pacemaker.
Line 127: Line 57:
In addition, container versioning has also been enabled in the swift-storage charm. === Ceph ===
Line 129: Line 59:
For more details on these features, please refer to the [[http://docs.openstack.org/developer/swift/middleware.html|upstream documentation]]. The ceph and ceph-osd charms now support setting sysctl options via charm configuration and provide a sensible default for the ‘kernel.pid_max’ sysctl option. This should support faster recovery in the event of a major outage in a Ceph deployment.

For charm authors, the ceph charm now has a Ceph broker API. This allows Ceph clients to request Ceph cluster actions e.g. create a new pool, via a new api as opposed to performing them on the client side. This will facilitate easily adding new functionality with reduced code impact while reducing the burden on the client to have to elect a leader to perform such actions, avoiding code duplication.

=== Ceph RADOS Gateway ===

The ceph-radosgw charm can now be deployed in a clustered configuration using a VIP as the object storage endpoint in conjunction with the hacluster charm:

{{{
juju deploy cs:trusty/hacluster hacluster-radosgw
juju deploy -n3 cs:trusty/ceph-radosgw
juju set ceph-radosgw vip=10.5.100.10
juju add-relation ceph-radosgw hacluster-radosgw
}}}

The ceph-radosgw charm now also supports using an embedded web container option provided natively by Ceph:

{{{
juju set ceph-radosgw use-embedded-webserver=true
}}}

This avoids using Apache2 and mod_fastcgi, which lacks support for chuck transfer encoding and 100-continue as provided in the Ubuntu archive.

=== Keystone ===

The keystone charm contains a number of improvements to support use of SSL endpoints in highly available deployments.

For charm authors, the keystone charm now has an additional ‘identity-notifications’ relation type; this relation is used by keystone to notify other charms when entries in the keystone service catalog change, and was introduced to support use with Ceilometer.

=== Glance ===

The glance charm now supports use of custom end-user provided configuration flags via the ‘config-flags’ charm option.

=== Ceilometer ===

The ceilometer charm can now be deployed in a clustered configuration using a VIP as the endpoint in conjunction with the hacluster charm:

{{{
juju deploy cs:trusty/hacluster hacluster-ceilometer
juju deploy -n3 cs:trusty/ceilometer
juju set ceilometer vip=10.5.100.20
juju add-relation ceilometer hacluster-ceilometer
}}}

The ceilometer charm now requires to relations to the keystone charm, to support both service catalog registration of the Ceilometer endpoint and notifications to changes to the service catalog:

{{{
juju add-relation ceilometer keystone:identity-service
juju add-relation ceilometer keystone:identity-notifications
}}}

NOTE: relation endpoint types must now be specified to avoid ambiguity.

=== Neutron ===

The quantum-gateway charm now has a fast failover option of neutron resources when multiple gateway units are used with the hacluster charm:

{{{
juju deploy cs:trusty/hacluster hacluster-ngateway
juju deploy -n3 cs:trusty/quantum-gateway neutron-gateway
juju set neutron-gateway ha-legacy-mode=True
juju add-relation neutron-gateway hacluster-ngateway
}}}

NOTE: This feature has been introduced to support a level of resilience in Icehouse based deployments. Future charm work will include enablement of native Neutron support for router HA for later OpenStack releases.

The neutron charms now also support VLAN and flat networking in additional to GRE and VXLAN for tenant networks.

The quantum-gateway charm now also supports setting sysctl options via charm configuration inline with the ceph and nova-compute charms - see the ‘sysctl’ configuration option for details.

=== Swift ===

The swift-proxy charm now automatically rebalances rings on scale out of swift-storage services, allowing swift deployments to be managed more directly using Juju.

The swift-proxy charm also includes configuration options to set the minimum period between ring rebalancing and an option to completely disable rebalancing - this should be used when adding a number of new swift-storage service units to a deployment, to avoid re-balancing as every new set of storage is added to the swift deployment.

=== Nova ===

The nova-cloud-controller charm can now use memcache to store tokens for instance console access, supporting use of instance consoles in HA configuration via the OpenStack dashboard:

{{{
juju deploy -n3 cs:trusty/memcached
juju deploy -n3 cs:trusty/nova-cloud-controller
juju add-relation nova-cloud-controller memcached
}}}

The nova-cloud-controller charm now includes a ‘nova-alchemy-flags’ to allow Nova database configuration options to be directly tuned by charm users.

The nova-compute charm now has support for different storage backends; specifically it now supports local disk (default), Ceph RBD or LVM backends:

{{{
juju set nova-compute libvirt-image-backend=rbd
juju set nova-compute rbd-pool=nova
juju set nova-compute ceph-osd-replication-count=3
juju add-relation ceph nova-compute
}}}

The nova-compute charm now supports configuring disk cachemodes, allowing configuration of Nova disk usage options - see the ‘disk-cachemodes’ configuration option in the nova-compute charm and the upstream documentation about this feature.

The nova-compute charm now also supports setting sysctl options via charm configuration inline with the ceph and quantum-gateway charms - see the ‘sysctl’ configuration option for details.

=== OpenStack Dashboard ===

The openstack-dashboard charm now has improved support for use with multi-region clouds.

=== RabbitMQ ===

The rabbitmq-server charm now supports deployment in IPv6 only networks:

{{{
juju set rabbitmq-server prefer-ipv6=true
}}}

and use of a specific network for access to the message broker - see the ‘access-network’ configuration option for more details.

== Bugs Fixed ==

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

Summary

The 15.01 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

This release has mainly been focussed on bug fixing, however some new features have been introduced.

New Charm Features

Clustering

The trusty hacluster charm now supports running in multicast (default) and unicast modes, supporting use of this charm in environments where multicast UDP is not supported. To enable this feature:

juju set hacluster corosync_transport=unicast

At this point in time the previous node entries for the multicast cluster have to be removed manually - to complete this action, do the following on one of the members of the cluster:

sudo crm node list

New unicast nodes will start at 1001; the original multicast node entries should be deleted using:

sudo crm configure
 >     delete <id>

The trusty hacluster charm now supports a new ‘debug’ configuration option to increase the verbosity of logging from corosync and pacemaker.

The trusty hacluster charm also includes a number of fixes to improve the way that quorum is handled by corosync and pacemaker.

Ceph

The ceph and ceph-osd charms now support setting sysctl options via charm configuration and provide a sensible default for the ‘kernel.pid_max’ sysctl option. This should support faster recovery in the event of a major outage in a Ceph deployment.

For charm authors, the ceph charm now has a Ceph broker API. This allows Ceph clients to request Ceph cluster actions e.g. create a new pool, via a new api as opposed to performing them on the client side. This will facilitate easily adding new functionality with reduced code impact while reducing the burden on the client to have to elect a leader to perform such actions, avoiding code duplication.

Ceph RADOS Gateway

The ceph-radosgw charm can now be deployed in a clustered configuration using a VIP as the object storage endpoint in conjunction with the hacluster charm:

juju deploy cs:trusty/hacluster hacluster-radosgw
juju deploy -n3 cs:trusty/ceph-radosgw
juju set ceph-radosgw vip=10.5.100.10
juju add-relation ceph-radosgw hacluster-radosgw

The ceph-radosgw charm now also supports using an embedded web container option provided natively by Ceph:

juju set ceph-radosgw use-embedded-webserver=true

This avoids using Apache2 and mod_fastcgi, which lacks support for chuck transfer encoding and 100-continue as provided in the Ubuntu archive.

Keystone

The keystone charm contains a number of improvements to support use of SSL endpoints in highly available deployments.

For charm authors, the keystone charm now has an additional ‘identity-notifications’ relation type; this relation is used by keystone to notify other charms when entries in the keystone service catalog change, and was introduced to support use with Ceilometer.

Glance

The glance charm now supports use of custom end-user provided configuration flags via the ‘config-flags’ charm option.

Ceilometer

The ceilometer charm can now be deployed in a clustered configuration using a VIP as the endpoint in conjunction with the hacluster charm:

juju deploy cs:trusty/hacluster hacluster-ceilometer
juju deploy -n3 cs:trusty/ceilometer
juju set ceilometer vip=10.5.100.20
juju add-relation ceilometer hacluster-ceilometer

The ceilometer charm now requires to relations to the keystone charm, to support both service catalog registration of the Ceilometer endpoint and notifications to changes to the service catalog:

juju add-relation ceilometer keystone:identity-service
juju add-relation ceilometer keystone:identity-notifications

NOTE: relation endpoint types must now be specified to avoid ambiguity.

Neutron

The quantum-gateway charm now has a fast failover option of neutron resources when multiple gateway units are used with the hacluster charm:

juju deploy cs:trusty/hacluster hacluster-ngateway
juju deploy -n3 cs:trusty/quantum-gateway neutron-gateway
juju set neutron-gateway ha-legacy-mode=True
juju add-relation neutron-gateway hacluster-ngateway

NOTE: This feature has been introduced to support a level of resilience in Icehouse based deployments. Future charm work will include enablement of native Neutron support for router HA for later OpenStack releases.

The neutron charms now also support VLAN and flat networking in additional to GRE and VXLAN for tenant networks.

The quantum-gateway charm now also supports setting sysctl options via charm configuration inline with the ceph and nova-compute charms - see the ‘sysctl’ configuration option for details.

Swift

The swift-proxy charm now automatically rebalances rings on scale out of swift-storage services, allowing swift deployments to be managed more directly using Juju.

The swift-proxy charm also includes configuration options to set the minimum period between ring rebalancing and an option to completely disable rebalancing - this should be used when adding a number of new swift-storage service units to a deployment, to avoid re-balancing as every new set of storage is added to the swift deployment.

Nova

The nova-cloud-controller charm can now use memcache to store tokens for instance console access, supporting use of instance consoles in HA configuration via the OpenStack dashboard:

juju deploy -n3 cs:trusty/memcached
juju deploy -n3 cs:trusty/nova-cloud-controller
juju add-relation nova-cloud-controller memcached

The nova-cloud-controller charm now includes a ‘nova-alchemy-flags’ to allow Nova database configuration options to be directly tuned by charm users.

The nova-compute charm now has support for different storage backends; specifically it now supports local disk (default), Ceph RBD or LVM backends:

juju set nova-compute libvirt-image-backend=rbd
juju set nova-compute rbd-pool=nova
juju set nova-compute ceph-osd-replication-count=3
juju add-relation ceph nova-compute 

The nova-compute charm now supports configuring disk cachemodes, allowing configuration of Nova disk usage options - see the ‘disk-cachemodes’ configuration option in the nova-compute charm and the upstream documentation about this feature.

The nova-compute charm now also supports setting sysctl options via charm configuration inline with the ceph and quantum-gateway charms - see the ‘sysctl’ configuration option for details.

OpenStack Dashboard

The openstack-dashboard charm now has improved support for use with multi-region clouds.

RabbitMQ

The rabbitmq-server charm now supports deployment in IPv6 only networks:

juju set rabbitmq-server prefer-ipv6=true

and use of a specific network for access to the message broker - see the ‘access-network’ configuration option for more details.

Bugs Fixed

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

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