Add upgrade instructions for icehouse to juno

[Anne Gentle]

Upgrade instructions are in a chapter in the Operations Guide, http://github.com/openstack/operations-guide.

These are supposed to be tested instructions for Ubuntu 14.04.1.

Upgrading from IceHouse to Juno on Ubuntu 14.04.1.

-----
1- Stop all OpenStack services on each node, right before running the
upgrade procedure;

 service keystone stop
 cd /etc/init/; for i in $(ls neutron-* | cut -d \. -f 1 | xargs);
do sudo service $i stop; done

 cd /etc/init/; for i in $(ls nova-* | cut -d \. -f 1 | xargs);
do sudo service $i stop; done
 cd /etc/init/; for i in $(ls glance-* | cut -d \. -f 1 | xargs);
do sudo service $i stop; done
 cd /etc/init/; for i in $(ls cinder-* | cut -d \. -f 1 | xargs);
do sudo service $i stop; done
 cd /etc/init/; for i in $(ls heat-* | cut -d \. -f 1 | xargs);
do sudo service $i stop; done
 ...

2- Run this: "curl
-sÂ
https://raw.githubusercontent.com/tmartinx/openstack-guides/master/Juno/controller/etc/apt/sources.list.d/ubuntu-cloud-archive-juno-trusty.listÂ
>
/etc/apt/sources.list.d/ubuntu-cloud-archive-juno-trusty.list"

3- Then: "apt-get install
ubuntu-cloud-keyring python-software-properties ; apt-get update";

4- Upgrade to Juno with: "apt-get dist-upgrade";

 During the upgrade procedure, `dpkg` will ask you to replace some
configuration files, you'll need to chose to keep the files untouched
(n), or to upgrade to the latest version (y).

 I prefer to keep with my `nova.conf` (and with my `ml2_conf.ini`),
since it is very customized. Right after the upgrade, I updated
`nova.conf` file according to `doc.openstack.org/juno`
<http://doc.openstack.org/juno`>.

 Upgrade the following files: neutron.conf, keystone.conf,
glance-registry.conf, glance-api.conf, glance-scrubber.conf,
/etc/openstack-dashboard/local_settings.py, heat.conf...

 Also, keep your ml2_conf.ini (update it later by comparing
`ml2_conf.ini.dpkg-dist`).

5- Repeat step 1, stop all services again (their confs are wrong /
empty / from factory);

6- Manually compare and update all the configuration files that was
upgraded by `dpkg` on step 4, like this:

 cd /etc/keystone
 diff -Nru keystone.conf.dpkg-old keystone.conf | vim -

 Where "keystone.conf.dpkg-old" is your previous "keystone.conf".
Lines starting with "minus -", was removed by new "keystone.conf",
lines starting with "plus +" was added by it. So, you might want to
restore mostly of your customized settings. Like for example:

 admin_token
 bind_host = ::
 connection # [database]

 Save new "keystone.conf" with your custom settings from
"keystone.conf.dpkg-old"...

 Run:

 "rm /var/lib/keystone/keystone.db"
 "su -s /bin/sh -c "keystone-manage db_sync" keystone";
 "service keystone restart"
 "keystone tenant-list"

7- Repeat step 6 for each configuration file... Remember to run
`diff -Nru ... ...` to compare each new config file with its
`backup.conf.dpkg-old` and before running "db_sync" to starting the
services again (for each service you might have), plus a reboot in the
end to make sure everything is working as expected. Pay attention to
your `ml2_conf.ini`, you'll want to enable `ipset`, compare yours with
`ml2_conf.ini.dpkg-dist`. Review your Cinder confs!

8- Enjoy OpenStack Juno!

Note: When updating Neutron Server, you'll need to run:

 neutron-db-manage --config-file
/etc/neutron/neutron.conf --config-file
/etc/neutron/plugins/ml2/ml2_conf.ini stamp icehouse

 ...Before:

 su -s /bin/sh -c "neutron-db-manage
--config-file /etc/neutron/neutron.conf
--config-file /etc/neutron/plugins/ml2/ml2_conf.ini upgrade juno" neutron
-----

[Matt Kassawara (ionosphere80)]

I'm building a couple of Icehouse environments to test the upgrade process.

[Matt Kassawara (ionosphere80)]

I successfully upgraded the following services from Icehouse to Juno on Ubuntu 14.04 with active VMs:

Keystone
Glance
Nova
Neutron
Horizon
Cinder
Heat
Ceilometer

The procedure mostly follows the existing Havana to Icehouse procedure.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/144660

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/144660
Committed: https://git.openstack.org/cgit/openstack/operations-guide/commit/?id=ae8d4b91c2f60d427bdde57acc3f1b769cca393f
Submitter: Jenkins
Branch: master

commit ae8d4b91c2f60d427bdde57acc3f1b769cca393f
Author: Matthew Kassawara <email address hidden>
Date: Wed Dec 31 14:07:21 2014 -0600

    Added content for upgrading Icehouse to Juno

    I added content for upgrading Icehouse to Juno. This patch also
    attempts to address the following issues:

    1) Verify the neutron database version prior to updating it.
    2) Reduce content duplication by removing syntax specific to
       certain Linux distributions. For example, operators
       performing upgrades should know which services to restart
       and how to restart them.

    Change-Id: If14712e69f72fc72a19fd9c057401152559fd351
    Closes-Bug: #1391328
    Partial-Bug: #1337399