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

Bug 1235997

Summary: [Docs] [Director] Support heat templates w/o tuskar when runnng package update
Product: Red Hat OpenStack Reporter: Jan Provaznik <jprovazn>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: DirectorCC: adahms, calfonso, jprovazn, jslagle, mburns, nbarcet, rhel-osp-director-maint, yeylon, zbitter
Target Milestone: gaKeywords: Documentation, Triaged
Target Release: Director   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-01-04 01:40:38 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 Jan Provaznik 2015-06-26 10:07:06 UTC
Description of problem:
UCLI "overcloud deploy" command supports using heat templates directly instead of using tuskar. There is not this option for "overcloud update stack" command (tuskar is used).

Comment 3 chris alfonso 2015-06-26 17:39:28 UTC
We need to document the workaround using heat directly.

Comment 4 Andrew Dahms 2015-06-29 04:35:09 UTC
Assigning to Dan for review.

Comment 5 Dan Macpherson 2015-06-30 04:03:21 UTC
Would the workaround be something as simple as:

$ heat stack-update -f <template_file> overcloud

Or is there more to it?

Comment 7 Jan Provaznik 2015-07-09 13:44:26 UTC
For simplest pkg update w/o rolling updates (updating machines one by one), doing:
$ heat stack-update -f <template_file> overcloud -P UpdateIdentifier=timestamp

should work. But "openstack overcloud stack update" updates nodes sequentially - it sets breakpoints on each of node and user removes them during update. Doing this manually is possible too because heat CLI supports setting/removing/polling breakpoints, but it would more complicated, worflow looks like this:

$ heat stack-update -f <template_file> overcloud -P UpdateIdentifier=timestamp -f env_file_with_breakpoints
$ poll if stack-update reached breakpoint
$ remove a breakpoint
$ iterate above 2 steps

I did not test these manual steps (testing this and make doc for it would take more time).

Comment 8 Jan Provaznik 2015-07-13 13:26:10 UTC
Midstream doc patch is here: https://review.gerrithub.io/239621

Comment 10 Zane Bitter 2015-07-13 15:25:15 UTC
It seems to me that having users manually drive the workflow by manipulating breakpoints is untenable as a solution. The workflow is designed to prevent e.g. downtime for the controller; it's incredibly difficult to describe and even harder for a user to get right.

If we're supporting a --use-tripleo-heat-templates option to "openstack overcloud deploy" then IMHO we also need to add a similar option for all commands, such as "openstack overcloud update stack".

Comment 11 Jan Provaznik 2015-07-20 12:09:46 UTC
"overcloud stack update" command was improved to work with heat templates directly:
https://bugzilla.redhat.com/show_bug.cgi?id=1242967

Documentation patch which describes running pkg update both with and without tuskar is here:
https://review.gerrithub.io/239621

Comment 13 Andrew Dahms 2015-08-16 02:45:29 UTC
Looks good to me; moving to VERIFIED.

Comment 14 Andrew Dahms 2016-01-04 01:40:38 UTC
This content is now live on the Customer Portal; closing.