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

Bug 1081296

Summary: [Docs] [Change] [Admin] The syntax of the engine-manage-domains command has changed
Product: Red Hat Enterprise Virtualization Manager Reporter: Andrew Dahms <adahms>
Component: DocumentationAssignee: Andrew Dahms <adahms>
Status: CLOSED CURRENTRELEASE QA Contact:
Severity: medium Docs Contact:
Priority: medium    
Version: 3.4.0CC: acathrow, gklein, jentrena, yeylon
Target Milestone: ---Keywords: Reopened
Target Release: 3.5.0   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-02-15 23:42:59 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Andrew Dahms 2014-03-27 02:09:20 UTC
Description of problem:
There are some changes to the synatx of the engine-manage-domains command, such as the inclusion of a single hyphen between options such as configFile -> config-file, etc. A full review is required.

Version-Release number of selected component (if applicable):
3.4

How reproducible:
100%

Comment 1 Andrew Dahms 2014-04-14 11:54:29 UTC
Fixed in 7865, 8405, 8408, 8409.

Comment 2 Andrew Dahms 2014-04-28 00:33:33 UTC
Documentation Link
------------------------------
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html-single/Administration_Guide/index.html#Domain_Management_Tool

What Changed
------------------------------
The following topics were revised as outlined below.

Syntax for the Domain Management Tool [7865-631086]

The -add-permissions, --configFile, and --change-password-msg options were updated, the list of available directory services was updated, and other minor grammatical edits made to improve clarity.

Adding Domains to Configuration [8405-631087]

'-action=' was changed to simple 'add', and an additional hyphen was placed before the 'provider' and 'user' options in accordance with the syntax for Red Hat Enterprise Virtualization 3.4.

Validating Domain Configuration [8408-631088]

The word '-action=' was removed in accordance with the syntax for Red Hat Enterprise Virtualization 3.4.

Deleting a Domain from the Configuration [8407-631090]

The word '-action=' was removed in accordance with the syntax for Red Hat Enterprise Virtualization 3.4.

Listing Domains in Configuration [8409-631092]

Updated revision history: [30102-631094]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Administration_Guide-3.4-en-US-3.4-16

Moving to ON_QA.

Comment 3 Julie 2014-08-22 06:14:51 UTC
Verified in the current release.

Comment 4 Julio Entrena Perez 2014-09-19 14:31:38 UTC
Re-opening since it there are still references to the former syntax such as:

- https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html/Administration_Guide/Syntax_for_rhevm_manage_domains_Command.html

"""
19.2.2. Syntax for the Domain Management Tool
The usage syntax is:

engine-manage-domains -action=ACTION [options]
"""

Comment 6 Andrew Dahms 2014-10-08 01:18:12 UTC
Documentation Link
------------------------------
https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5/html-single/Administration_Guide/index.html#Syntax_for_rhevm_manage_domains_Command

What Changed
------------------------------
The following topic was revised to update the syntax of the main command example in the screen block, and to add three new command options - log-file, log-level, and log4j-config.

Syntax for the Domain Management Tool [7865-712293]

Updated the revision history: [34613-712299]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Administration_Guide-3.5-en-US-3.5-25

Moving to ON_QA.