Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1538617

Summary: RFE - Document best practices and things to confirm before running an upgrade (or any stack update)
Product: Red Hat OpenStack Reporter: Marios Andreou <mandreou>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 13.0 (Queens)CC: ccamacho, dcadzow, dmacpher, jthomas, mandreou, psahoo, srevivo
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-06-28 09:10:19 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 Marios Andreou 2018-01-25 12:52:24 UTC
Filing this RFE as part of the discussion at BZ 1534204 
This is being filed as a docs bug but we will need input from various DFG (e.g. PIDONE, Compute, DF, Storage, Networking, ...?). 

The aim is to document best practices and things that an operator can set or confirm before starting an upgrade, though it would also apply to any stack update operation including the minor update and across all versions. Things like configuration of number of processes and threads for keystone for optimal performance, number of heat workers ( e.g. see discussion in https://access.redhat.com/support/cases/#/case/02002356?commentId=a0aA000000LMXDpIAP ). Other things like cluster state, ... and anything else other DFG might suggest.

Comment 1 Marios Andreou 2018-01-29 17:38:21 UTC
*** Bug 1534204 has been marked as a duplicate of this bug. ***

Comment 2 Carlos Camacho 2018-02-05 14:01:49 UTC

We will track the DB section of this RFE in to main sub BZs:

[Implementation] - DB purge prior to major version and Fast Forward Upgrade
https://bugzilla.redhat.com/show_bug.cgi?id=1542077

[Doc patch] - Guidance for db purge prior to major version and Fast Forward Upgrade 
https://bugzilla.redhat.com/show_bug.cgi?id=1535590

Comment 3 Dan Macpherson 2018-02-06 03:59:38 UTC
Currently working on this with Chris Fields:

https://docs.google.com/document/d/1ER2E75DFtydu4ZLKgnCt1nj24HVERKoeTbOe7DHP80c/edit#heading=h.3zzknn4911kh

Comment 4 Dan Macpherson 2018-02-06 04:04:49 UTC
Jon Thomas is also tracking these things on this spreadsheet:

https://docs.google.com/spreadsheets/d/123QjuUDQyLXVfit_Mght2mgDV28pE5g4KS66pweEAvw/edit#gid=0

Comment 5 Dan Macpherson 2018-08-10 06:36:40 UTC
I worked with Chris and Jon to implement a set of validation procedures for both the undercloud and overcloud. For example, these have been imcluded in the OSP13 FFFWD Upgrade guide:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/fast_forward_upgrades/assembly-preparing_for_openstack-platform_upgrade#validating_an_openstack_platform_10_undercloud

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/fast_forward_upgrades/assembly-preparing_for_openstack-platform_upgrade#validating_an_openstack_platform_10_overcloud

Marios, I think this issue has been resolved but want to check with you in case there's anything else we should add. What do you reckon?

Comment 6 Marios Andreou 2018-08-13 06:44:59 UTC
Thanks Dan that all looks great. I cc ccamacho UA of DFG:Upgrades so they can also discuss (I've moved to upstream ci) ... I think the next step is to try and automate those into the tripleo-validations so we can get the operator to just run that rather than the individual bash snippets (though there will likely be folks that prefer the latter anyway :) ) but that needs to be discussed and prioritized/tracked by upgrades folks

thanks

Comment 7 Dan Macpherson 2019-06-28 09:10:19 UTC
This appears to be resolved. Closing this BZ but feel free to reopen if further changes are required.

Comment 8 Red Hat Bugzilla 2023-09-15 00:06:16 UTC
The needinfo request[s] on this closed bug have been removed as they have been unresolved for 500 days