Bug 1446307 - Incorrect pcs resource cleanup command in controller replacement docs
Summary: Incorrect pcs resource cleanup command in controller replacement docs
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 8.0 (Liberty)
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Dan Macpherson
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-04-27 16:04 UTC by Ben Nemec
Modified: 2017-05-18 08:04 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-05-18 08:04:52 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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.


Note You need to log in before you can comment on or make changes to this bug.