Bug 1303512

Summary:	[Docs] [Upgrade] Address feedback on the upgrade documentation
Product:	Red Hat OpenStack	Reporter:	Andrew Dahms <adahms>
Component:	documentation	Assignee:	Deepti Navale <dnavale>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Radek Bíba <rbiba>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	7.0 (Kilo)	CC:	yeylon
Target Milestone:	async	Keywords:	Documentation, ZStream
Target Release:	7.0 (Kilo)
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-04-13 04:51:00 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Andrew Dahms 2016-02-01 07:02:21 UTC

The following items must be addressed in Section 4.1 of Upgrading OpenStack:

* In Step 2.2, there is no database for Swift, and the openstack-db command
  does not work. This step must be confirmed.

* In Step 2.9, add a step to upgrade *\python-django\* as well.

* In Step 2.9, confirm why the second yum upgrade command is necessary after
  having run the first yum upgrade command. If unnecessary, remove.

* In Step 2.9, there is no database for Horizon, and the openstack-db command
  does not work. This step must be confirmed.

* In Step 2.9, the command 'openstack-service start horizon' command does not
  work. Confirm whether this is the correct command.

Comment 1 Andrew Dahms 2016-02-09 05:43:54 UTC

Assigning to Deepti for review.

Comment 2 Deepti Navale 2016-02-16 23:33:21 UTC

Hey Andrew, 

I've confirmed the following from Lars and updated based on his response as follows: 

> * In Step 2.2, there is no database for Swift, and the openstack-db command
>   does not work. This step must be confirmed.

the documented upgrade process boils down to:

- Stop things.
- Upgrade packages.
- Start things.

So commented out the db update command.

> 
> * In Step 2.9, add a step to upgrade *\python-django\* as well.

Included the python-django package for update command.

> 
> * In Step 2.9, confirm why the second yum upgrade command is necessary after
>   having run the first yum upgrade command. If unnecessary, remove.

This is necessary when performing a service-by-service upgrade,
because in this situation there is no initial "yum upgrade" of all
packages.

> 
> * In Step 2.9, there is no database for Horizon, and the openstack-db command
>   does not work. This step must be confirmed.

Removed db update command.

> 
> * In Step 2.9, the command 'openstack-service start horizon' command does not
>   work. Confirm whether this is the correct command.

Replaced the 'openstack-service start horizon' with 'systemctl restart httpd' command.

Comment 4 Deepti Navale 2016-02-24 06:49:15 UTC

Content updated and published - https://access.redhat.com/documentation/en/red-hat-enterprise-linux-openstack-platform/version-7/upgrading-openstack/#section_upgrade-one-by-one-non-HA

Comment 5 Andrew Dahms 2016-04-13 04:51:00 UTC

This content is now live on the Customer Portal.

Closing.