Bug 1930886

Summary:

Update help/man pcs to include clone id as an option in 'pcs resource unclone' parameters

Product:

Red Hat Enterprise Linux 8

Reporter:

Nina Hostakova <nhostako>

Component:

pcs

Assignee:

Tomas Jelinek <tojeline>

Status:

CLOSED ERRATA

QA Contact:

cluster-qe <cluster-qe>

Severity:

low

Docs Contact:

Priority:

low

Version:

8.4

CC:

cfeist, cluster-maint, idevat, kmalyjur, mlisik, mpospisi, omular, tojeline

Target Milestone:

Keywords:

EasyFix, Triaged

Target Release:

8.5

Flags:

pm-rhel: mirror+

Hardware:

Unspecified

OS:

Unspecified

Whiteboard:

Fixed In Version:

pcs-0.10.8-2.el8

Doc Type:

No Doc Update

Doc Text:

This is just a fix in pcs built-in documentation. Similar fix is planned to be included in HA Add-on documentation in 8.4 time frame.

Story Points:

---

Clone Of:

Environment:

Last Closed:

2021-11-09 17:34:53 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:

Attachments:

Description	Flags
proposed fix	none

Description Nina Hostakova 2021-02-19 17:20:04 UTC

Description of problem:
As it is possible to use clone id to "unclone" cloned resources, it might be useful (especially for a custom clone id which now can be set) to mention it in pcs help/man.

Version-Release number of selected component (if applicable):
pcs-0.10.8-1.el8

Actual results:
pcs help and man states:
pcs resource unclone <resource id | group id> [--wait[=n]]

Expected results:
pcs resource unclone <clone id | resource id | group id> [--wait[=n]]

Comment 2 Tomas Jelinek 2021-05-31 12:43:07 UTC

Created attachment 1788309 [details]
proposed fix

Test:

Check pcs help and man page for 'pcs resource unclone' command.

Comment 3 Miroslav Lisik 2021-06-14 14:23:58 UTC

Test:

[root@r8-node-01 ~]# rpm -q pcs
pcs-0.10.8-2.el8.x86_64

[root@r8-node-01 ~]# pcs resource unclone --help

Usage: pcs resource unclone...
    unclone <clone id | resource id | group id> [--wait[=n]]
        Remove the specified clone or the clone which contains the specified
        group or resource (the resource or group will not be removed). If
        --wait is specified, pcs will wait up to 'n' seconds for the operation
        to finish (including stopping clone instances if appropriate) and then
        return 0 on success or 1 on error. If 'n' is not specified it defaults
        to 60 minutes.


From a man page:
       unclone <clone id | resource id | group id> [--wait[=n]]
              Remove  the  specified clone or the clone which contains
              the specified group or resource (the resource  or  group
              will  not  be removed). If --wait is specified, pcs will
              wait up to 'n'  seconds  for  the  operation  to  finish
              (including  stopping clone instances if appropriate) and
              then return 0 on success or 1 on error. If  'n'  is  not
              specified it defaults to 60 minutes.

Comment 10 errata-xmlrpc 2021-11-09 17:34:53 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (Low: pcs security, bug fix, and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHSA-2021:4142