Add upgrade instructions for icehouse to juno
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
openstack-manuals |
Fix Released
|
High
|
Matt Kassawara |
Bug Description
Upgrade instructions are in a chapter in the Operations Guide, http://
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:/
>
/etc/apt/
3- Then: "apt-get install
ubuntu-
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.
<http://
 Upgrade the following files: neutron.conf, keystone.conf,
glance-
/etc/openstack-
 Also, keep your ml2_conf.ini (update it later by comparing
`ml2_conf.
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.
 Where "keystone.
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.
 Run:
 "rm /var/lib/
 "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.
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.
8- Enjoy OpenStack Juno!
Note: When updating Neutron Server, you'll need to run:
 neutron-db-manage --config-file
/etc/neutron/
/etc/neutron/
 ...Before:
 su -s /bin/sh -c "neutron-db-manage
--config-file /etc/neutron/
--config-file /etc/neutron/
-----
Changed in openstack-manuals: | |
assignee: | nobody → Abhishek Kumar (yaduabhi) |
tags: | removed: low-hanging-fruit |
Changed in openstack-manuals: | |
milestone: | none → kilo |
importance: | Medium → High |
I'm building a couple of Icehouse environments to test the upgrade process.