Bug 1417910

Summary: Describe advanced fields of Remote EXecution job
Product: Red Hat Satellite Reporter: Pavel Moravec <pmoravec>
Component: Docs Managing HostsAssignee: Sergei Petrosian <spetrosi>
Status: CLOSED CURRENTRELEASE QA Contact: Russell Dickenson <rdickens>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.2.8CC: adahms, jhutar, psuriset
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-09-07 10:00:37 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 Pavel Moravec 2017-01-31 12:13:15 UTC 
Document URL: (nowhere)


Section Number and Name: (nowhere so far)


Describe the issue: 
When invoking a job via REX, one can specify advanced fields like "Concurrency level" and "Life span". Setting these have nontrivial impact to the way how individual sub-tasks are managed/maintained/created. The few words hint in WebUI is insufficient to describe this.


Suggestions for improvement: 
Please provide bigger description of setting either value, what the default value is and what the default behaviour is. I do not insist on having it in our documentation, either way works well for me:

- in documentation (where is usage of REX described at all?)
- in WebUI (i.e. in pup-up help similar to "Explanation" link on "Type of query"; this might be the best, in case the description is short enough
- in KCS (that I can write down, based on input from devels)


Additional information:
Comment 1 Andrew Dahms 2017-09-06 01:06:15 UTC 
Assigning to Sergei for review.

Sergei - the Host Configuration Guide already contains some text on this, but we can add some additional detail based on the description of 'Concurrency Level' and 'Time span' in the following -

https://www.theforeman.org/plugins/foreman_remote_execution/0.3/index.html

The updates need to be made to the 'Executing Jobs' section.
Comment 5 Sergei Petrosian 2017-09-07 10:00:37 UTC 
The changes are now live on the customer portal. 

Thank you
Comment 6 Andrew Dahms 2018-01-15 01:21:07 UTC 
Updating the component and doc type.