How to Perform an Upgrade from Havana to Icehouse—Red Hat Enterprise Linux and Derivatives

Disable Compute file injection:

Icehouse disables file injection by default per the release notes.

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

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

[libvirt]
...
libvirt_inject_partition = -2

Convert from OVS to 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.

We recommend keeping 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 openstack-keystone stop
# keystone-manage token_flush
# keystone-manage db_sync
# service openstack-keystone start

OpenStack Image Service:

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

Use the MySQL client to run 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 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 Qpid message broker keys to the [DEFAULT] section.

[DEFAULT]
...
rpc_backend = qpid
qpid_hostname = controller

Stop services, upgrade the database, and start services:

# service openstack-glance-api stop
# service openstack-glance-registry stop
# glance-manage db_sync
# service openstack-glance-api start
# service openstack-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.openstack.common.rpc.impl_qpid to qpid.

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 openstacknova-api stop
# service openstack-nova-scheduler stop
# service openstack-nova-conductor stop
# service openstack-nova-cert stop
# service openstack-nova-consoleauth stop
# service openstack-nova-novncproxy stop
# nova-manage db sync
# service openstack-nova-api start
# service openstack-nova-scheduler start
# service openstack-nova-conductor start
# service openstack-nova-cert start
# service openstack-nova-consoleauth start
# service openstack-nova-novncproxy start

OpenStack Networking:

Install the ML2 plug-in package:

# yum install openstack-neutron-ml2

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.

Change the /etc/neutron/plugin.ini symbolic link to reference /etc/neutron/plugins/ml2/ml2_conf.ini.

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 openstack-cinder-api stop
# service openstack-cinder-volume stop
# service openstack-cinder-scheduler stop
# cinder-manage db sync
# service openstack-cinder-api start
# service openstack-cinder-volume start
# service openstack-cinder-scheduler start

Dashboard:

Update the configuration for compatibility with Icehouse.

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

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

Restart Dashboard services.

# service httpd restart