How to Perform an Upgrade from Havana to Icehouse—Ubuntu

Disable Compute file injection:

Icehouse disables file injection by default per the Icehouse Release Notes.

If you plan to deploy Icehouse in stages, you must disable file injection on all compute nodes that remain on Havana.

Edit the /etc/nova/nova-compute.conf file:

[libvirt]
...
libvirt_inject_partition = -2

Convert from the OVS plug-in to the ML2 plug-in:

You must convert the configuration for your environment contained in the /etc/neutron/neutron.conf and /etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini files from OVS to ML2. For example, the OpenStack Installation Guide covers ML2 plug-in configuration using GRE tunnels.

Keep the OVS plug-in packages and configuration files until you verify the upgrade.

OpenStack Identity:

Update the configuration file for compatibility with Icehouse.

Edit the /etc/keystone/keystone.conf file:

Add the [database] section.

Move the connection key from the [sql] section to the [database] section.

Stop services, upgrade the database, and start services.

# service keystone stop
# keystone-manage token_flush
# keystone-manage db_sync
# service keystone start

OpenStack Image Service:

Before upgrading the Image Service database, you must convert the character set for each table to UTF-8.

Use the MySQL client to execute the following commands:

# mysql -u root -p
mysql> SET foreign_key_checks = 0;
mysql> ALTER TABLE glance.image_locations CONVERT TO CHARACTER SET 'utf8';
mysql> ALTER TABLE glance.image_members CONVERT TO CHARACTER SET 'utf8';
mysql> ALTER TABLE glance.image_properties CONVERT TO CHARACTER SET 'utf8';
mysql> ALTER TABLE glance.image_tags CONVERT TO CHARACTER SET 'utf8';
mysql> ALTER TABLE glance.images CONVERT TO CHARACTER SET 'utf8';
mysql> ALTER TABLE glance.migrate_version CONVERT TO CHARACTER SET 'utf8';
mysql> SET foreign_key_checks = 1;
mysql> exit

	Note
	Your environment might contain different or additional tables that you must also convert to UTF-8 by using similar commands.

Update the configuration for compatibility with Icehouse.

Edit the /etc/glance/glance-api.conf and /etc/glance/glance-registry.conf files:

Add the [database] section.

Rename the sql_connection key to connection and move it to the [database] section.

Edit the /etc/glance/glance-api.conf file:

Add RabbitMQ message broker keys to the [DEFAULT] section.

Replace RABBIT_PASS with the password you chose for the guest account in RabbitMQ.

[DEFAULT]
...
rpc_backend = rabbit
rabbit_host = controller
rabbit_password = RABBIT_PASS

Stop services, upgrade the database, and start services:

# service glance-api stop
# service glance-registry stop
# glance-manage db_sync
# service glance-api start
# service glance-registry start

OpenStack Compute:

Update the configuration for compatibility with Icehouse.

Edit the /etc/nova/nova.conf file:

Change the rpc_backend key from nova.rpc.impl_kombu to rabbit.

Edit the /etc/nova/api-paste.ini file:

Comment out or remove any keys in the [filter:authtoken] section beneath the paste.filter_factory = keystoneclient.middleware.auth_token:filter_factory statement.

Stop services, upgrade the database, and start services.

# service nova-api stop
# service nova-scheduler stop
# service nova-conductor stop
# service nova-cert stop
# service nova-consoleauth stop
# service nova-novncproxy stop
# nova-manage db sync
# service nova-api start
# service nova-scheduler start
# service nova-conductor start
# service nova-cert start
# service nova-consoleauth start
# service nova-novncproxy start

OpenStack Networking:

Populate the /etc/neutron/plugins/ml2/ml2_conf.ini file with the equivalent configuration for your environment. Do not edit the /etc/neutron/neutron.conf file until after the conversion steps.

Stop services, upgrade the database, and perform the conversion from OVS to ML2.

Replace NEUTRON_DBPASS with the password you chose for the database.

	Warning
	We highly recommend that you perform a database backup prior to executing the following commands as the conversion script cannot roll back.

# service neutron-server stop
# neutron-db-manage --config-file /etc/neutron/neutron.conf \
  --config-file /etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini stamp havana
# neutron-db-manage --config-file /etc/neutron/neutron.conf \
  --config-file /etc/neutron/plugins/ml2/ml2_conf.ini upgrade icehouse
# python -m neutron.db.migration.migrate_to_ml2 openvswitch \
  mysql://neutron:NEUTRON_DBPASS@controller/neutron

Edit the /etc/neutron/neutron.conf file to use the ML2 plug-in and enable network change notifications:

Replace SERVICE_TENANT_ID with the service tenant identifier (id) in the Identity service and NOVA_PASS with the password you chose for the nova user in the Identity service.

[DEFAULT]
...
core_plugin = ml2
service_plugins = router
...
notify_nova_on_port_status_changes = True
notify_nova_on_port_data_changes = True
nova_url = http://controller:8774/v2
nova_admin_username = nova
nova_admin_tenant_id = SERVICE_TENANT_ID
nova_admin_password = NOVA_PASS
nova_admin_auth_url = http://controller:35357/v2.0

Start Networking services.

# service neutron-server start

OpenStack Block Storage:

Stop services, upgrade the database, and start services.

# service cinder-api stop
# service cinder-volume stop
# service cinder-scheduler stop
# cinder-manage db sync
# service cinder-api start
# service cinder-volume start
# service cinder-scheduler start

Dashboard:

Update the configuration for compatibility with Icehouse.

Edit the /etc/openstack-dashboard/local_settings.py file:

Change the OPENSTACK_KEYSTONE_DEFAULT_ROLE key from "Member" to "_member_".

Restart Dashboard services.

# service apache2 restart