[OOZIE-3339] Enhance proxy job submission documentation

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: docs
• Assignee: Unassigned
• Reporter: Andras Salamon
• Created: 10/Sep/18 09:23
• Updated: 15/Feb/22 14:35

Description

The documentation should make it clear that the proxy job submission methods can only be used for simple job submissions (e.g. no support for credentials) and the documentation should  suggest an alternative if someone wants a more complex workflow.

The documentation (and the examples) also shows that it's possible to specify user.name during proxy job submission. It is not true anymore (see OOZIE-3370), so this has to be fixed. The documentation even lists this property as required, it should be tested what happens if we omit the property.

Relevant parts of the documentation:

• https://oozie.apache.org/docs/5.1.0/WebServicesAPI.html#Proxy_MapReduce_Job_Submission
• https://oozie.apache.org/docs/5.1.0/WebServicesAPI.html#Proxy_Pig_Job_Submission
• https://oozie.apache.org/docs/5.1.0/WebServicesAPI.html#Proxy_Hive_Job_Submission
• https://oozie.apache.org/docs/5.1.0/WebServicesAPI.html#Proxy_Sqoop_Job_Submission

 

Issue Links

• is blocked by: OOZIE-2734 [docs] Switch from TWiki to Markdown