Bug 1446307

Summary:	Incorrect pcs resource cleanup command in controller replacement docs
Product:	Red Hat OpenStack	Reporter:	Ben Nemec <bnemec>
Component:	documentation	Assignee:	Dan Macpherson <dmacpher>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	8.0 (Liberty)	CC:	bnemec, dmacpher, mburns, 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:	2017-05-18 08:04:52 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 Ben Nemec 2017-04-27 16:04:28 UTC

Description of problem: In https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/8/html/director_installation_and_usage/sect-replacing_controller_nodes points 16 and 17 of section 9.4.3 there is a command listed to clean up the resources on a specific node.  This did not work for me when I ran it.  The provided command is "sudo pcs resource cleanup galera overcloud-controller-3", but that syntax only generated a usage message.  It appears the command needs to be "sudo pcs resource cleanup galera --node overcloud-controller-3" (with the addition of --node being the only change).


Version-Release number of selected component (if applicable): RHEL OSP 8


How reproducible: Always


Steps to Reproduce:
1. Deploy overcloud
2. Attempt to run resource cleanup command on one of the nodes

Actual results: Usage error message from pcs


Expected results: Specified resource on specified node cleaned up


Additional info: Note that I see the same command in the 9 docs.  It appears to have been fixed in the 10 version however.

Comment 2 Dan Macpherson 2017-05-01 18:53:36 UTC

Hi Ben,

This should be fixed on the OSP8 and OSP9 versions. Here's the relevant section in the OSP8 version:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/8/html/director_installation_and_usage/sect-replacing_controller_nodes#sect-Replacing_Controller_Nodes-Manual_Intervention

How does it look now?

Comment 3 Ben Nemec 2017-05-01 21:17:37 UTC

The galera command looks right, but the keystone one is still the old form: sudo pcs resource cleanup openstack-keystone-clone overcloud-controller-3

I probably should have been more explicit about the two separate commands.  Sorry about that.

Comment 4 Dan Macpherson 2017-05-03 03:56:11 UTC

Hi Ben,

I've pushed a new version with the corrected command for keystone. I think I've got everything, but just wanted to check before I close the BZ -- Did I miss anything else?

Comment 5 Ben Nemec 2017-05-05 20:06:22 UTC

I think it got added in the wrong place for keystone:

sudo pcs resource cleanup --node openstack-keystone-clone overcloud-controller-3

should be

sudo pcs resource cleanup openstack-keystone-clone --node overcloud-controller-3

Comment 6 Dan Macpherson 2017-05-08 01:12:40 UTC

Arg, you're right. I misplaced it for the OSP8 version. Have pushed a commit and it should be fixed now:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/8/html/director_installation_and_usage/sect-replacing_controller_nodes#sect-Replacing_Controller_Nodes-Manual_Intervention

How does it look now?

Comment 7 Ben Nemec 2017-05-08 15:36:23 UTC

Looks good to me now, thanks.