[HIVE-5627] Document 'usehcatalog' parameter on WebHCat calls

• Type: Sub-task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 0.12.0
• Fix Version/s: 0.13.0
• Component/s: Documentation, WebHCat
• Assignee: Lefty Leverenz
• Reporter: Eugene Koifman
• Created: 23/Oct/13 19:06
• Updated: 11/Nov/13 03:05
• Resolved: 11/Nov/13 03:05

Description

The following REST calls in WebHCat:
1. mapreduce/jar
2. pig
now support an additional parameter 'usehcatalog'. This is a mechanism for the caller to tell WebHCat that the submitted job uses HCat, and thus needs to access the metastore, which requires additional steps for WebHCat to perform in a secure cluster.

The JavaDoc on corresponding methods in org.apache.hive.hcatalog.templeton.Server describe this parameter.

Additionally, if templeton.hive.archive, templeton.hive.home and templeton.hcat.home are defined in webhcat-site.xml (documented in webhcat-default.xml) then WebHCat will ship the Hive tar to the target node where the job actually runs. This means that Hive doesn't need to be installed on every node in the Hadoop cluster. (This part was added in HIVE-5547). This is independent of security, but improves manageability.

This should be added to the sections in https://cwiki.apache.org/confluence/display/Hive/WebHCat+Reference that correspond to these methods.

Issue Links

• is depended upon by: HIVE-5547 webhcat pig job submission should ship hive tar if -usehcatalog is specified