ReleaseNotes1507

Differences between revisions 11 and 14 (spanning 3 versions)
Revision 11 as of 2014-04-16 16:39:18
Size: 6082
Editor: adam-collard
Comment: s/todo/to do/
Revision 14 as of 2014-10-23 19:25:47
Size: 4859
Editor: james-page
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was copied from TrustyTahr/ReleaseNotes/OpenStackCharms
Line 4: Line 5:
=== Icehouse support for 12.04 and 14.04 === === OpenStack Juno support for 14.04 and 14.10 ===
Line 6: 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: All !OpenStack charms now support deployment of !OpenStack 2014.2 (Juno) on Ubuntu 14.04 LTS and Ubuntu 14.10; this support includes the following charms:
Line 19: Line 20:
 * neutron-api
 * neutron-openvswitch
 * nova-cell
Line 20: Line 24:
To deploy !OpenStack Icehouse on Ubuntu 12.04, use the 'openstack-origin' configuration option, for example: To deploy !OpenStack Juno on Ubuntu 14.04, use the 'openstack-origin' configuration option, for example:
Line 25: Line 29:
  openstack-origin: cloud:precise-icehouse   openstack-origin: cloud:trusty-juno
Line 30: Line 34:
!OpenStack Icehouse is provided as the default !OpenStack release on Ubuntu 14.04 so no additional configuration is required in 14.04 deployments. !OpenStack Juno is provided as the default !OpenStack release on Ubuntu 14.10 so no additional configuration is required in 14.10 deployments.
Line 32: Line 36:
=== 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.

=== Active/Active MySQL ===

Ubuntu 14.04 includes the first distribution release of Percona XtraDB Cluster 5.5, a MySQL alternative that supports active/active clustering using the Galera wsrep synchronous replication extensions. This can be deployed as a drop-in replace for the mysql charm in an Ubuntu 14.04 !OpenStack deployment:

{{{
juju deploy --config config.yaml cs:~openstack-charmers/trusty/percona-cluster
juju add-unit -n 2 percona-cluster
juju deploy hacluster pxc-hacluster
juju add-relation pxc-hacluster percona-cluster
juju add-relation cinder percona-cluster
}}}

For full details of how to deploy the percona-cluster charm, please refer to its [[https://jujucharms.com/sidebar/search/~openstack-charmers/trusty/percona-cluster/?text=percona-cluster#readme|README]].

=== 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 to do this.

=== Upgrading 12.04 deployments to Icehouse ===
=== Upgrading 14.04 deployments to Juno ===
Line 97: Line 40:
Existing Havana and Grizzly deployments of !OpenStack on Ubuntu 12.04 can be upgraded to Icehouse by issuing: Existing Icehouse deployments of !OpenStack on Ubuntu 14.04 can be upgraded to Juno by issuing:
Line 101: Line 44:
juju set <charm-name> openstack-origin=cloud:precise-icehouse juju set <charm-name> openstack-origin=cloud:trusty-juno
Line 104: Line 47:
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. for each !OpenStack charm in your deployment.
Line 108: Line 51:
=== Neutron - modular layer 2 plugin === === Network Segregation Configuration ===
Line 110: Line 53:
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 following !OpenStack charms feature support for use of multiple networks for separation of traffic; specifically:
Line 112: Line 55:
Existing Havana deployments using the older Open vSwitch (ovs) plugin will be automatically migrated to the ml2 plugin on upgrade.  * os-data-network: Data network for tenant network traffic supporting instances
 * os-admin-network: Admin network - used for Admin endpoint binding and registration in keystone
 * os-public-network: Public network - used for Public endpoint binding and registration in keystone
 * os-internal-network: Internal network - used for internal communication between OpenStack services and for Internal endpoint registration in keystone
Line 114: Line 60:
=== Neutron - enabled extensions === in addition the Ceph charms (ceph-osd, ceph) support splitting 'public' access traffic from 'cluster' admin and re-sync traffic, via the ceph-public-network and ceph-cluster-network configuration options.
Line 116: Line 62:
The following extensions/drivers have been enabled for Icehouse deployments: All network configuration options should be provided in standard CIDR format - for example 10.20.0.0/16.
Line 118: Line 64:
 * 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.
=== Neutron ===
Line 123: Line 66:
=== Swift - default middleware === The Neutron support in the !OpenStack charms has been refactored into two new charms:
Line 125: Line 68:
The following middleware has been added to the default swift-proxy pipeline for !OpenStack Icehouse:  * neutron-api: Supporting API and central control operations.
 * neutron-openvswitch: Supporting deployment of the Neutron ML2 plugin with Open vSwitch on nova-compute nodes.
Line 127: Line 71:
 * 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]].

=== Cinder - multiple backend support ===

The cinder charm has been extended to support use with multiple storage backends, allowing a single cinder deployment to manage multiple types of block storage.

The first implementation of this charm feature is a refactoring of the ceph integration into a new cinder-ceph backend:
These charms can be introduced into an existing !OpenStack deployment:
Line 149: Line 74:
juju deploy cinder
juju deploy -n 3 ceph
juju deploy cinder-ceph
juju add-relation cinder-ceph ceph
juju add-relation cinder cinder-ceph
juju deploy neutron-api
juju deploy neutron-openvswitch
juju add-relation neutron-api mysql
juju add-relation neutron-api keystone
juju add-relation neutron-api rabbitmq-server
juju add-relation neutron-api quantum-gateway
juju add-relation neutron-api neutron-openvswitch
juju add-relation neutron-api nova-cloud-controller
juju add-relation neutron-openvswitch rabbitmq-server
Line 156: Line 85:
Note that the cinder charm retains its existing ceph support as well. Use of these two new charms also allows split of message brokers so that Nova and Neutron can use separate RabbitMQ deployments.
Line 158: Line 87:
Support for new storage backends is anticipated as a result of activity in Canonical's OIL programme for !OpenStack interoperability testing. === Nova Cells ===

The Nova charms now support deployment in Nova Cell configurations using the new nova-cell charm; See the nova-cell charm for details of how this works and how to use in a !OpenStack deployment. A complete guide to this feature with example juju-deployer configurations will be posted soon.

=== hacluster charm ===

The hacluster charm has gone through some significant refactoring to support changing configuration options post deployment, supporting upgrades of existing single network, clustered deployments to multi-network clustered deployments.

This charm also now support direct configuration of the corosync bindiface and port in preference over any configuration provided from the principle charm its deployed with. Configuration of these options via the principle charm will be removed during the 15.04 cycle, users need to migrate to using the direct configuration options prior to the next stable release alongside 15.04.

=== worker configuration ===

Where appropriate, the !OpenStack charms will automatically configure appropriate worker values for API and RPC processes to optimize use of available CPU resources on deployed units. By default, this is set at twice the number of cores - however it can be tweaked using the worker-multiplier option provided by supporting charms:

{{{
juju set neutron-api worker-multiplier=4
}}}

the above example increases the default #cores x 2 to #cores x 4.

General Charm Updates

OpenStack Juno support for 14.04 and 14.10

All OpenStack charms now support deployment of OpenStack 2014.2 (Juno) on Ubuntu 14.04 LTS and Ubuntu 14.10; this support includes the following charms:

  • keystone
  • cinder
  • glance
  • nova-cloud-controller
  • nova-compute
  • quantum-gateway
  • swift-proxy
  • swift-storage
  • ceilometer
  • ceilometer-agent
  • heat
  • neutron-api
  • neutron-openvswitch
  • nova-cell

To deploy OpenStack Juno on Ubuntu 14.04, use the 'openstack-origin' configuration option, for example:

cat > config.yaml << EOF
nova-cloud-controller:
  openstack-origin: cloud:trusty-juno
EOF
juju deploy --config config.yaml nova-cloud-controller

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

Upgrading 14.04 deployments to Juno

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 Icehouse deployments of OpenStack on Ubuntu 14.04 can be upgraded to Juno by issuing:

juju upgrade-charm <charm-name>
juju set <charm-name> openstack-origin=cloud:trusty-juno

for each OpenStack charm in your deployment.

New Charm Features

Network Segregation Configuration

The following OpenStack charms feature support for use of multiple networks for separation of traffic; specifically:

  • os-data-network: Data network for tenant network traffic supporting instances
  • os-admin-network: Admin network - used for Admin endpoint binding and registration in keystone
  • os-public-network: Public network - used for Public endpoint binding and registration in keystone
  • os-internal-network: Internal network - used for internal communication between OpenStack services and for Internal endpoint registration in keystone

in addition the Ceph charms (ceph-osd, ceph) support splitting 'public' access traffic from 'cluster' admin and re-sync traffic, via the ceph-public-network and ceph-cluster-network configuration options.

All network configuration options should be provided in standard CIDR format - for example 10.20.0.0/16.

Neutron

The Neutron support in the OpenStack charms has been refactored into two new charms:

  • neutron-api: Supporting API and central control operations.
  • neutron-openvswitch: Supporting deployment of the Neutron ML2 plugin with Open vSwitch on nova-compute nodes.

These charms can be introduced into an existing OpenStack deployment:

juju deploy neutron-api
juju deploy neutron-openvswitch
juju add-relation neutron-api mysql
juju add-relation neutron-api keystone
juju add-relation neutron-api rabbitmq-server
juju add-relation neutron-api quantum-gateway
juju add-relation neutron-api neutron-openvswitch
juju add-relation neutron-api nova-cloud-controller
juju add-relation neutron-openvswitch rabbitmq-server

Use of these two new charms also allows split of message brokers so that Nova and Neutron can use separate RabbitMQ deployments.

Nova Cells

The Nova charms now support deployment in Nova Cell configurations using the new nova-cell charm; See the nova-cell charm for details of how this works and how to use in a OpenStack deployment. A complete guide to this feature with example juju-deployer configurations will be posted soon.

hacluster charm

The hacluster charm has gone through some significant refactoring to support changing configuration options post deployment, supporting upgrades of existing single network, clustered deployments to multi-network clustered deployments.

This charm also now support direct configuration of the corosync bindiface and port in preference over any configuration provided from the principle charm its deployed with. Configuration of these options via the principle charm will be removed during the 15.04 cycle, users need to migrate to using the direct configuration options prior to the next stable release alongside 15.04.

worker configuration

Where appropriate, the OpenStack charms will automatically configure appropriate worker values for API and RPC processes to optimize use of available CPU resources on deployed units. By default, this is set at twice the number of cores - however it can be tweaked using the worker-multiplier option provided by supporting charms:

juju set neutron-api worker-multiplier=4

the above example increases the default #cores x 2 to #cores x 4.

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