Chapter 4. Upgrading from Red Hat OpenStack 2.0 (Folsom) Preview to Red Hat OpenStack 2.1 (Folsom)

Users who installed Red Hat OpenStack 2.0 (Folsom) Preview after the release of the generally available version of Red Hat Enterprise Linux 6.4 may follow this procedure to upgrade their systems to Red Hat OpenStack 2.1 (Folsom).
This procedure must be followed on each system in the Red Hat OpenStack environment.

Important

Upgrading from Red Hat OpenStack 2.0 (Folsom) Preview to Red Hat OpenStack 2.1 (Folsom) is not formally supported at this time. This results from the fact that Red Hat OpenStack 2.0 (Folsom) Preview was originally released on the beta version of Red Hat Enterprise Linux 6.4 while Red Hat OpenStack 2.1 (Folsom) requires the generally available version of Red Hat Enterprise Linux 6.4.
Upgrading from beta releases of Red Hat Enterprise Linux to generally available release of Red Hat Enterprise Linux are not supported at this time.
Further details on the support status of systems upgraded from beta releases of Red Hat Enterprise Linux to generally available releases is available in this knowledge base article:

Procedure 4.1. Upgrading from Red Hat OpenStack 2.0 (Folsom) Preview to Red Hat OpenStack 2.1 (Folsom)

  1. Stop all OpenStack services that are currently active on the system.
    1. Use the openstack-status command to identify active OpenStack services.
      $ sudo openstack-status
      == Nova services ==
      openstack-nova-api           active
      openstack-nova-cert          active
      openstack-nova-compute       inactive
      openstack-nova-network       active
      openstack-nova-scheduler     active
      openstack-nova-volume        inactive (disabled on boot)
      == Glance services ==
      openstack-glance-api         active
      openstack-glance-registry    active
      == Keystone service ==
      openstack-keystone           active
      == Horizon service ==
      openstack-dashboard          active
      == Cinder services ==
      openstack-cinder-api         active
      openstack-cinder-scheduler   active
      openstack-cinder-volume      inactive
      == Support services ==
      httpd:                        active
      libvirtd:                     active
      tgtd:                         active
      qpidd:                        active
      memcached:                    active
      == Keystone users ==
      Warning keystonerc not sourced
      

      Note

      When the openstack-status command is run while Keystone environment variables are set additional information will be displayed. This information is not required to complete this procedure.
    2. Use the service command to stop each active service that has a name that starts with openstack.
      $ sudo service openstack-COMPONENT stop
  2. Use the subscription-manager command to verify that the system has subscriptions that provide both Red Hat Enterprise Linux Server and Red Hat OpenStack entitlements.
    $ sudo subscription-manager list --consumed
    +-------------------------------------------+
       Consumed Subscriptions
    +-------------------------------------------+
    
    Subscription Name:      Red Hat OpenStack
    Provides:               Red Hat OpenStack
                            Red Hat Enterprise Linux Server
    SKU:                    SER0406
    Contract:               3169240
    Account:                901578
    Serial Number:          1667264867340998574
    Active:                 True
    Quantity Used:          1
    Service Level:          None
    Service Type:           None
    Starts:                 08/12/2012
    Ends:                   08/12/2013
    If the Red Hat Enterprise Linux Server and Red Hat OpenStack entitlements are not shown then follow the steps shown in Section 2.2, “Configuring Software Repositories” to subscribe the system to them.
  3. Use the yum-config-manager command to ensure that the system does not have the Red Hat Enterprise Linux 6 beta repositories enabled.
    $ sudo yum-config-manager --disable rhel-6-server-beta-rpms
    Loaded plugins: product-id
    ========== repo: rhel-6-server-beta-rpms ==========
    [rhel-6-server-beta-rpms]
    bandwidth = 0
    base_persistdir = /var/lib/yum/repos/x86_64/6Server
    baseurl = https://cdn.redhat.com/content/beta/rhel/server/6/6Server/x86_64/os
    cache = 0
    cachedir = /var/cache/yum/x86_64/6Server/rhel-6-server-beta-rpms
    cost = 1000
    enabled = False
    ...

    Note

    Yum treats the values False and 0 as equivalent. As a result the output on your system may instead contain this string:
    enabled = 0
  4. Use the yum-config-manager command to ensure that the system has the Red Hat Enterprise Linux 6 repositories enabled.
    $ sudo yum-config-manager --enable rhel-6-server-rpms
    Loaded plugins: product-id
    ========== repo: rhel-6-server-rpms ==========
    [rhel-6-server-rpms]
    bandwidth = 0
    base_persistdir = /var/lib/yum/repos/x86_64/6Server
    baseurl = https://cdn.redhat.com/content/dist/rhel/server/6/6Server/x86_64/os
    cache = 0
    cachedir = /var/cache/yum/x86_64/6Server/rhel-6-server-rpms
    cost = 1000
    enabled = True
    ...

    Note

    Yum treats the values True and 1 as equivalent. As a result the output on your system may instead contain this string:
    enabled = 1
  5. Use the yum-config-manager command to ensure that the system has the Red Hat OpenStack 2.1 (Folsom) software repositories enabled.
    $ sudo yum-config-manager --enable rhel-server-ost-6-folsom-rpms
    Loaded plugins: product-id
    ========== repo: rhel-server-ost-6-folsom-rpms ==========
    [rhel-server-ost-6-folsom-rpms]
    bandwidth = 0
    base_persistdir = /var/lib/yum/repos/x86_64/6Server
    baseurl = https://cdn.redhat.com/content/dist/rhel/server/6/6Server/x86_64/openstack/folsom/os
    cache = 0
    cachedir = /var/cache/yum/x86_64/6Server/rhel-server-ost-6-folsom-rpms
    cost = 1000
    enabled = True
    ...
  6. Use the yum command to ensure that your system has the most up to date versions of all Red Hat Enterprise Linux and Red Hat OpenStack packages.
    $ sudo yum update -y
  7. When updating packages Yum attempts to also update their configuration files. In some cases when performing this task Yum finds a conflict which it is unable to resolve. In these cases Yum chooses one of the following actions depending on the options specified by the package for deploying its configuration files:
    • Creates a copy of the original configuration file from before the update commenced in a file with the suffix .rpmsave.
      Any user defined configuration values found in the .rpmsave file must be manually merged into the base configuration file.
    • Creates a copy of the new configuration file from after the update in a file with the suffix .rpmnew.
      Any package defined configuration values found in the .rpmnew file must be manually merged into the base configuration file.
    Use the find command to identify any instances where the update identified conflicting changes to configuration files.
    $ sudo find /etc/ -name '*.rpm?*'
    Use the diff command to compare each file to the base configuration file. Then manually merge the conflicting changes from the .rpmsave and .rpmnew files into the base configuration file.
  8. Use the service command to start all OpenStack services that were stopped in preparation for the upgrade.
    $ sudo service openstack-COMPONENT start
You have successfully upgraded your environment to Red Hat OpenStack 2.1 (Folsom).