Red Hat Enterprise Linux OpenStack Platform 4 Release Notes Release Notes for Red Hat Enterprise Linux OpenStack Platform 4 (Havana) 11 Nov 2014 Red Hat Engineering Content Services
Red Hat Enterprise Linux OpenStack Platform 4 Release Notes Release Notes for Red Hat Enterprise Linux OpenStack Platform 4 (Havana) 11 No v 20 14 Red Hat Engineering Co ntent Services
Legal Notice Co pyright © 20 13-20 14 Red Hat, Inc. This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n-ShareAlike 3.0 Unpo rted License. If yo u distribute this do cument, o r a mo dified versio n o f it, yo u must pro vide attributio n to Red Hat, Inc. and pro vide a link to the o riginal. If the do cument is mo dified, all Red Hat trademarks must be remo ved.
T able of Cont ent s T able of Contents .Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. . . . . . . . . . 1. Do c ument Co nventio ns 2 1.1. Typ o g rap hic Co nventio ns 2 1.2. Pull-q uo te Co nventio ns 3 1.3. No tes and Warning s 4 2 . G etting Help and G iving Feed b ac k 4 2 .1. Do Yo u Need Help ? 4 2 .2. We Need Feed b ac k! 5 . .hapt C . . . .er . .1. ..
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Preface 1. Document Convent ions This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. 1.1. T ypographic Convent ions Four typographic conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows.
Preface C haracter T abl e. D ouble-click this highlighted character to place it in the T ext to co py field and then click the C o py button. Now switch back to your document and choose Ed it → Past e from the g ed it menu bar. The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in proportional bold and all distinguishable by context.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es before, " "so cannot be deassigned\n", __func__); r = -EINVAL; goto out; } kvm_deassign_device(kvm, match); kvm_free_assigned_device(kvm, match); o ut: mutex_unlock(& kvm->lock); return r; } 1.3. Not es and Warnings Finally, we use three visual styles to draw attention to information that might otherwise be overlooked. Note Notes are tips, shortcuts or alternative approaches to the task at hand.
Preface Red Hat also hosts a large number of electronic mailing lists for discussion of Red Hat software and technology. You can find a list of publicly available mailing lists at https://www.redhat.com/mailman/listinfo. Click on the name of any mailing list to subscribe to that list or to access the list archives. 2.2.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Chapter 1. Product Introduction Red Hat Enterprise Linux OpenStack Platform provides the foundation to build a private or public Infrastructure-as-a-Service (IaaS) cloud on top of Red Hat Enterprise Linux. It offers a massively scalable, fault-tolerant platform for the development of cloud-enabled workloads.
Chapt er 1 . Product Int roduct ion Note Red Hat Enterprise Linux OpenStack Platform uses components from other Red Hat products. Specific information pertaining to the support of these components is available at: https://access.redhat.com/site/support/policy/updates/openstack/platform/ To evaluate Red Hat Enterprise Linux OpenStack Platform, sign up at: http://www.redhat.com/openstack/.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Content D elivery Network (CD N) channels can be: Enabled with the subscri pti o n-manag er repo s --enabl e= [repo name] command. D isabled with the subscri pti o n-manag er repo s --d i sabl e= [repo name] command. T ab le 1.1. R eq u ired C h an n els C h an n el R ep o sit o ry N ame Red Hat OpenStack 4.0 (RPMS) rhel -6 -server-o penstack-4 . 0 rpms rhel -6 -server-rpms Red Hat Enterprise Linux 6 Server (RPMS) T ab le 1.2.
Chapt er 1 . Product Int roduct ion 1.3.3. Package Not es The Red Hat Common for RHEL Server (v6) channel is recommended for use if creating custom Red Hat Enterprise Linux guest images that require cloud-init. # subscri pti o n-manag er repo s \ --enabl e= rhel -6 -server-rh-co mmo n-rpms 1.4 .
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform The following documents are included in the documentation suite: T ab le 1.6 .
Chapt er 2 . Release Not es Chapter 2. Release Notes These release notes highlight technology preview items, recommended practices, known issues, and deprecated functionality to be taken into consideration when deploying this release of Red Hat OpenStack. Notes for updates released during the support lifecycle of this Red Hat OpenStack release will appear in the advisory text associated with each update or the Red Hat Enterprise Linux OpenStack Platform Technical Notes.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es directly accessible. This enhancement adds the concept of download plug-ins. Protocol modules enable Compute to analyse the URL scheme and load the corresponding plugin. The instance is able to directly download the image without routing through Image Service first. The download is reverted to Image Service if any failures occur in the process. B Z #89 0514 Dashboard now makes it simpler to soft reboot multiple instances concurrently.
Chapt er 2 . Release Not es Packstack now automatically configures Block Storage for GlusterFS when a full 'ip:/volume/name' remote GlusterFS volume path is provided. Consequently, Block Storage is configured to use GlusterFS instead of the local LVM. Prior to this enhancement, manual configuration of Block Storage for GlusterFS would have been required after Packstack installation. B Z #9 19 816 The Image Service CLI now displays a progress bar for image upload and download activity.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es B Z #9 759 4 3 This update enables Compute to snapshot a GlusterFS volume on behalf of Block Storage. The snapshot operation is initiated by the user through Block Storage, using the same method as other volume types. Consequently, Block Storage involves Compute to complete aspects of the snapshot process. B Z #9 76 272 With this update, Dashboard users are automatically logged out of a period of inactivity.
Chapt er 2 . Release Not es With this update, live migration of VMs is now supported between hosts in the same cell. Users are able to live migrate VMs between hosts when using a cells-based deployment. B Z #9 76 4 59 As a new feature, the MAC addresses associated with an instance's allocated IP addresses are now returned as part of the instance information. This feature allows the relevant MAC addresses to be more readily available.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Support for PCI passthrough has been added to Compute, exposing a host's physical PCI devices directly to an instance. Consequently, instances can be given access to a host's physical PCI devices. B Z #9 78519 Volumes attached to a specific instance can now be listed using the new API extension 'os-extended-volumes'. Previously, all volumes had to be iterated to identify those attached to a specific instance.
Chapt er 2 . Release Not es displaying user quotas. The quota allowance of a user cannot exceed the total granted to the tenant. Show user quotas: nova quota-show --tenant --user Update/Create user quotas: nova quota-update --user B Z #9 7854 3 A feature has been added to propagate the hostname information to OpenStack Networking when allocating the network.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es It does that by reading the metadata information from an external path, configurable through a configuration parameter `filesystem_store_metadata_file` in glance-api.conf B Z #9 79 14 2 Glance works as a registry for images. Each record is considered an immutable resource that holds information about the image it represents. In previous versions only one location could be associated with one record.
Chapt er 2 . Release Not es B Z #9 854 57 With this release, Red Hat Enterprise Linux OpenStack Platform supports resizing a volume, using the extend_volume parameter. This would add an API call to specifically extend the size of an existing volume that is currently in an available state. B Z #9 854 58 Red Hat OpenStack now allows the transfer of ownership of Block Storage Volumes, by providing a mechanism to let another tenant take ownership of a volume.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es An article on token binding and configuration can be found here: https://github.com/openstack/keystone/blob/master/doc/source/confi guration.rst#token-binding B Z #9 86 09 9 The following changes in configuration have been made as part of moving to the oslo library, and affect all OpenStack Networking (Neutron) plugins. - the 'DATABASE' section in the plugin-specific ini files has been deprecated in favor of a 'database' section in neutron.
Chapt er 2 . Release Not es triggered. Result: New ceilometer-alarm-evaluator and ceilometer-alarmnotifier services are provided. B Z #9 86 381 Feature: Partitioning of alarm evaluation over a horizontally scaled out dynamic pool of workers. Reason: This enhancement allows the evaluation workload to scale up to encompass many alarms, and also avoids a singleton evaluator becoming a single point of failure. Result: The alarm.evaluation_service configuration option may be set to ceilometer.alarm.service.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es * reduce the security risk of invoking commands via rootwrap. This update merges these rootwrap features into the OpenStack Networking service. B Z #9 86 500 With this update, you can now specify protocol numbers when defining security group rules. In some cases, this feature makes the creation of security group rules more convenient. The OpenStack Networking service still supports the use of protocol names as normal.
Chapt er 2 . Release Not es The Orchestration service now accepts existing Keystone tokens, which Heat can use to interact with the underlying services. By default, python-heatclient now creates a token on your behalf, which is then passed to the Heat API. Alternatively, you can specify an existing token via the '--os-auth-token' option. Token support in Heat allows enhanced security over simple username/password authentication.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Consequently, qpid messages and mysql queries are hardened against snooping even on the internal network. SSL implementation in Dashboard assists with protecting user credentials sent from browser sessions. B Z #100136 9 When setting up a Django application such as Horizon, there are common issues. It is recommended to set up service horizon via SSL.
Chapt er 2 . Release Not es This has been fixed so that the CONFIG_NEUTRON_L2_PLUGIN parameter accepts the value "ml2", and CONFIG_NEUTRON_ML2_* parameters have been introduced to enable OpenStack Networking to work with the ML2 plugin. B Z #1019 780 Packstack will now (optionally) install and configure OpenStack Networking LBaaS agent and plugin.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es The Compute service periodically checks for instances that have been deleted in the database but remain running on a compute node. The action to take when such instances are identified is determined by the value of the "running_deleted_instance_action" configuration key in the OpenStack Compute (/etc/nova/nova.conf) file. The default value of the "running_deleted_instance_action" configuration key has been changed to "reap".
Chapt er 2 . Release Not es subscription_manager_username subscription_manager_password subscription_manager_repos = comma separated list of repositories to enable B Z #104 3580 A new feature in OpenStack Orchestration in this release is the addition of the heat-templates upstream repository and tools. This provides example templates for both WordPress and OpenShift on OpenStack.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es your environment. 2. Run the puppet agent to get the MySQL cluster up and verify that the cluster was set up with no errors. 3. Run the puppet agent again to create the OpenStack databases and users. Note the above does not set up any fencing configuration. In a production environment fencing is critical: you can either use pacemaker commands to setup fencing, or update the default HA mysql puppet manifests.
Chapt er 2 . Release Not es mysql_virtual_ip. * mysql_clu_member_addrs: the IP addresses (as a space-separated list) internal to the cluster that pacemaker communicates on. So, if you are going to have a cluster of 3 members, the three IP addresses of the cluster members are listed here. NOTE: these IP's must already be configured and active on the cluster-hosts-to-be before they are added to this Host Group (i.e., this Host Group does not set up these IP's for you).
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es B Z #1056 058 The default behavior most customers expect for small to medium installations is to run cinder-volume on the controller node. Packstack does this but a Foreman deployment only allows a dedicated storage backend backed by iSCSI or Red Hat Storage. With this update, you can deploy cinder-volume on the Compute or OpenStack Networking controller node, if cinder_backend_iscsi is set to false.
Chapt er 2 . Release Not es performance and security. The previous default of writing zeros over deleted volumes took a significant amount of time, and may not be needed. One can now set a global configuration setting to clear only part of a volume (to remove encryption keys for example), or to disable clearing completely. Additionally a new 'shred' capability is available to overwrite with random data instead of zeros.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es B Z #106 8885 Feature: optionally create a keystonerc file on the controller node. Reason: This saves the user some effort in that they do not need to manually set some environment variables to be able to use the CLI services on a controller. Result: Create /root/keystonerc_admin if the user sets the controller parameter keystonerc=true.
Chapt er 2 . Release Not es from purpleidea. This module replaces the initial puppet module, which was temporary and offered only basic features for setting up simple Red Hat Storage clusters and clients. B Z #1076 205 Feature: Makes any service optional to be installed in the HA All-In-One-Controllers. Reason: Not all users want to deploy all services. Whether that means they are installed elsewhere of just not used at all, this allows either option.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es file on the system it deploys the keystone service on. * ceilometer, cinder, glance, heat, heat_cfn, nova, swift = all true/false, set true if you want a keystone endpoint created for the service. B Z #1083781 Feature: Added Image service as one of the services managed by the new HA-all-in-one controller. Result: HA All In One Controller host group can be deployed including the Glance component.
Chapt er 2 . Release Not es in vSphere, which meant that renaming a virtual machine would make it inaccessible to Compute. However, administrators may want to organise virtual machines in vSphere according to their own conventions. With this change, administrators can now safely rename a vSphere virtual machine created by Compute. Compute now uses other metadata to look up the virtual machine, so it will continue to work. B Z #1086 9 34 Feature: Added Dashboard to HA All In One Controller host group.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es * ovs_bridge_mappings = [], a mapping between the name of the VLAN range defined above (ovs_vlan_ranges) and the bridge name that was defined above (ovs_bridge_uplinks) * ovs_tunnel_iface = '', name of interface to use for tunneling * ovs_tunnel_network = '', network as seen by puppet to use for tunneling (determines ip or nic for you, value like 192.168.2.
Chapt er 2 . Release Not es B Z #109 5752 Previously, the version of Orchestration (heat) in Red Hat Enterprise Linux OpenStack Platform 4 did not include the "host_routes" property of the OS::Neutron::Subnet resource that was added in later releases of Orchestration. This change adds support for this property, which allows host routes to be specified for a subnet. 2.2. T echnology Preview The items listed in this section are provided as Technology Previews.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es provides the Red Hat Enterprise Linux OpenStack Platform Installer with an improved user interface and integrated functionality for easier deployment of OpenStack. Staypuft is provided by the following packages: foreman-installer-staypuft-0.0.13-2.el6ost.noarch.rpm ruby193-rubygem-staypuft-0.0.16-1.el6ost.noarch.rpm ruby193-rubygem-staypuft-doc-0.0.16-1.el6ost.noarch.rpm 2.3.
Chapt er 2 . Release Not es Block Storage configurations previously using the setting: volume_driver=cinder.volume.drivers.lvm.ThinLVMVolumeDriver Should migrate to settings: volume_driver=cinder.volume.drivers.lvm.LVMISCSIDriver lvm_type=lvm The ThinLVMVolumeDriver alias for the volume driver will be removed in a future release. B Z #10086 6 8 The OpenStack Image service allows images to be shared between projects.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Enterprise OpenStack Networking highly available templates. Also includes a security update to the 'yum' repo files. The 'yum' repo file is updated to use sslverify, gpgcheck, and https. B Z #11024 6 8 Some packages in the Red Hat OpenStack software repositories conflict with packages provided by the Extra Packages for Enterprise Linux (EPEL) software repositories.
Chapt er 2 . Release Not es --Attach those Block Storage volumes to a Compute instance via QEMU Gluster Blockdriver libgfapi. --Create snapshots of a Block Storage volume that is attached to a Compute instance via libgfapi when using the GlusterFS plugin.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es plugin. The ML2 plugin can be used in manual configurations, or by deploying initially with the Open vSwitch plugin using PackStack, and then converting the installation to use ML2. This last method is described on the RDO pages at http://openstack.redhat.com/Modular_Layer_2_%28ML2%29_Plugin B Z #1017281 Foreman does not support deployment of the ML2 Networking plug-in.
Chapt er 2 . Release Not es Workaround: You must change the password right after openstackforeman-installer finishes (the installer prints a link to a page where the password can be changed). This replaces the password with an new (hidden) one, and anyone attempting to use the displayed password will not have access.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es B Z #105104 7 When you shut down a neutron-l3-agent (or it dies) and you start another neutron-l3-agent in a different node, OpenStack Networking will not reschedule virtual routers from an L3 agent to the second one. The routing or metadata remain tied to the initial L3 agent ID. As a result, you cannot have an HA environment when you have several nodes with L3 agents, with different IDs either in Active/Active or Active/Passive states.
Chapt er 2 . Release Not es This has been fixed by first checking whether the tables exist. As a result, the upgrade from version 3 to version 4 succeeds even if LoadBalancerPlugin is in use. There are three known issues when upgrading version 3 to version 4 with LoadBalancer. They will be fixed in a future release. 1) Issue one is with respect to re-creating table 'vips'. This will be fixed in a future release.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es B Z #11024 81 Glance does not fully support a graceful restart yet. Hence, image transfers that are still in progress will be lost when Glance services are restarted. This will occur when updating the openstack-glance package. The workaround to avoid losing images is to wait for image transfers that are in progress to complete, before updating the openstack-glance package or restarting Glance services.
Chapt er 2 . Release Not es In a future release of RHOS, this requirement may be removed; the Release Notes will be updated when it is safe to use NFS shared storage for the Compute instance store without enabling the noac or lookupcache=none option. B Z #114 86 9 5 When using GlusterFS as a Block Storage back-end, set glusterfs_qcow2_volumes=True in /etc/cinder/cinder.conf of the openstack-cinder-volume host before volumes are created. 2.5.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Chapter 3. Upgrading 3.1. Upgrade Overview Warning Red Hat does not support: Upgrading any Beta release of Red Hat Enterprise Linux OpenStack Platform to any supported release (for example, 3 or 4). Upgrading Compute Networking (nova-networking) to OpenStack Networking (neutron) in Red Hat Enterprise Linux OpenStack Platform 4.
Chapt er 3. Upgrading Met h o d D escrip t io n Service by Service This method allows you to upgrade one service at a time. Pro s: Rather than a single large service outage, you are able to stage outages to specific services. For example, you could have the Identity service running at the Havana release while Compute runs at the Grizzly release. You can schedule potentially longer upgrades, such as the Compute service upgrade in a large environment, separately from upgrades that take less time.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Note If you are upgrading from an older version of Grizzly, which required Red Hat Enterprise Linux 6.4, you will also need to upgrade to Red Hat Enterprise Linux 6.6 (required by Havana). Upgrading from to RHEL 6.6 will require you to reboot both controller and Compute nodes to get the newer kernel running. Currently, there is no way to update a kernel without rebooting the base operating system.
Chapt er 3. Upgrading Service C o mman Identity (keystone) On the Identity service host, run: # keysto ne-manag e d b_sync Block Storage (cinder) On the Block Storage service host, run: # ci nd er-manag e d b sync Object Storage (swift) Image Service (glance) Object Storage does not require an explicit schema upgrade.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es d. If you are running D jango 1.5 (or later), you must ensure that there is a correctly configured ALLO WED _HO ST S setting in your l o cal _setti ng s file. ALLO WED _HO ST S contains a list of host names that can be used to contact your D ashboard service: If people will be accessing the D ashboard service using " http://dashboard.example.com" , you would set: ALLOWED_HOSTS=['dashboard.example.
Chapt er 3. Upgrading Stopping Stopping Stopping Stopping Stopping openstack-nova-api: [ OK ] openstack-nova-cert: [ OK ] openstack-nova-conductor: [ OK ] openstack-nova-consoleauth: [ OK ] openstack-nova-scheduler: [ OK ] 2. Upgrade the packages that provide the service, using: # yum upgrade \*serviceName*\ For example, for the Compute service, use: # yum upgrade \*nova\* 3.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es Service N o t es 1.Identity (keystone) Because the Identity service in Grizzly never purged expired tokens, it is possible that your token table has a large number of expired entries. This can dramatically increase the time it takes to complete the database schema upgrade.
Chapt er 3. Upgrading Service N o t es 5.OpenStack Warn in g :This can only be done if you are using 'quantum' networking in your Networking Grizzly environment.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es 2. Restart the Compute service (which otherwise will encounter errors due to the upgrade of the Image client package): # service openstack-nova-compute restart 3. If this results in a new kernel being installed on your systems, you will probably want to schedule a reboot at some point in the future in order to activate the kernel. 3.4 .
Chapt er 3. Upgrading o penstack-no va-sched ul er On any system acting as one of your Compute servers, install the following: o penstack-no va-co mmo n o penstack-no va-co mpute pytho n-neutro n o penstack-neutro n pytho n-neutro ncl i ent pytho n-no vacl i ent pytho n-no va o penstack-neutro n-o penvswi tch bri d g e-uti l s 2. Create a new Compute database. The new Havana Compute environment requires a distinct database from the one your existing Grizzly Compute environment is using.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es no vncpro xy_base_url vncserver_l i sten Change the message topics used by Compute when communicating via the AMQP server: Add the following to the [D EFAULT ] section: cert_topic=cert_havana compute_topic=compute_havana console_topic=console_havana consoleauth_topic=consoleauth_havana notifications_topic=notifications_havana scheduler_topic=scheduler_havana Add the following to the [co nd ucto r] section (you will probably have to add this s
Chapt er 3. Upgrading # no va-manag e servi ce l i st Which should result in one no va-co mpute entry for each Havana Compute node, as well as the following entries: no va-co nd ucto r no va-co nso l eauth no va-cert no va-sched ul er 6. Register your new controller with the Identity service in a separate region (register Identity service endpoints): a.
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es The command should result in a listing of your new Havana Compute hosts. For example: # no va --o s-reg i o n-name Havana ho st-l i st +-------------------------------------------+---------------+----------+ | host_name | service | zone | +-------------------------------------------+---------------+----------+ | rdo-havana-nova-api-net0.default.virt | cert | internal | | rdo-havana-nova-api-net0.default.
Revision Hist ory Revision History R evisio n 4 .1- 37 T u e N o v 11 2014 D o n D o min g o BZ #1148695: added workaround for Known Issue on GlusterFS volume creation. R evisio n 4 .1- 36 Wed O ct 22 2014 D o n D o min g o Final version for Red Hat Enterprise Linux OpenStack Platform maintenance release 4.0.5. R evisio n 4 .1- 34 T u e Ju n 03 2014 D o n D o min g o BZ #1063334 - OpenStack Telemetry HA Mode is now available as Technology Preview. R evisio n 4 .
Red Hat Ent erprise Linux O penSt ack Plat form 4 Release Not es R evisio n 4 .1- 4 T u e D ec 17 2013 Su mmer Lo n g BZ #988031 - Updated Upgrading instructions; removed older neutron info. R evisio n 4 .1- 3 Mo n D ec 16 2013 B ru ce R eeler BZ #1031855 - Updated link to list of updates for version 4. Other minor edits. R evisio n 4 .1- 2 Su n D ec 15 2013 Su mmer Lo n g BZ #988031 - Included detailed upgrade instructions. BZ #989729 - Included upgrade instructions for quantum -> neutron. R evisio n 4 .
