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

Bug 1074300

Summary: engine-manage-domains man page clarifications
Product: [Retired] oVirt Reporter: Moti Asayag <masayag>
Component: ovirt-engine-configAssignee: Martin Perina <mperina>
Status: CLOSED NOTABUG QA Contact: Pavel Stehlik <pstehlik>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 3.4CC: acathrow, gklein, iheim, masayag, mperina, yeylon
Target Milestone: ---Keywords: Documentation, ManPageChange
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: infra
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-03-11 10:23:10 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
oVirt 3.4 RC engine-manage-domains man page none

Description Moti Asayag 2014-03-09 14:12:08 UTC
Description of problem:

Generally, there is a great complexity in the usage description of the command, too many combinations the user can provide which are scattered over the various arguments.

The following should be fixed in the engine-manage-domains man page:

1. Examples:
             -action=add -domain=example.com --user=admin --provider=IPA --passwordFile=/tmp/.pwd
                 Add  a  domain  called  example.com,  using  user  admin  with ldap server type IPA and read the password from
       /tmp/.pwd.

The arguments --user, --provider and --passwordFile should be replaced with -user, -provider and -passwordFile respectively.

2. changePasswordMsg - doesn't appear in the man page (appears only via --help)

Comment 1 Martin Perina 2014-03-09 20:00:09 UTC
Created attachment 872465 [details]
oVirt 3.4 RC engine-manage-domains man page

Comment 2 Martin Perina 2014-03-09 20:03:12 UTC
Moti, did you look at engine-manage-domains man page for correct version? Please see attachment 872465 [details], this is how it looks for oVirt 3.4 RC. I just verified it again and I cannot see any of above issues on current man page.

Comment 3 Moti Asayag 2014-03-11 10:23:10 UTC
(In reply to Martin Perina from comment #2)
> Moti, did you look at engine-manage-domains man page for correct version?
> Please see attachment 872465 [details], this is how it looks for oVirt 3.4
> RC. I just verified it again and I cannot see any of above issues on current
> man page.

Seems the version installed on the test-day vm was outdated:

[root@localhost bin]# rpm -qf /usr/bin/engine-manage-domains
ovirt-engine-tools-3.4.0-0.7.beta2.el6.noarch

Closing this bug.