[ 
https://issues.apache.org/jira/browse/HIVE-3039?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13284602#comment-13284602
 ] 

Lefty Leverenz commented on HIVE-3039:
--------------------------------------

bq. For HiveConfiguration instead of listing all the configuration, its better 
to auto-generate them from hive-default.xml.template

"[Configuration 
Properties|https://cwiki.apache.org/confluence/display/Hive/Configuration+Properties]";
 in the Language Manual contains almost all the parameters from 
_hive-default.xml.template_ and their descriptions, tidied up and partly 
reorganized.  Carl Steinbach added it to the wiki two months ago.  I found six 
parameters in the file that aren't in the wiki, and four parameters in the wiki 
that aren't in the file. 

"[Hive 
Configuration|https://cwiki.apache.org/confluence/display/Hive/AdminManual+Configuration]";
 in the Administration Manual has some overlap with _hive-default.xml.template_ 
but also documents other parameters.  Here's a breakdown by section: 

* "Hive Configuration Variables" - 7 of 20 parameters are not in 
_hive-default.xml.template_ ({{hive.exec.script.wrapper, hive.exec.plan, 
hive.querylog.location, hive.exec.submitviachild, hive.jar.path, 
hive.aux.jars.path, hive.partition.pruning}}) 

* "Hive MetaStore Configuration Variables" - 2 of 18 parameters not in 
_hive-default.xml.template_ ({{org.jpox.autoCreateSchema, 
org.jpox.fixedDatastore}})

* "Hive Configuration Variables used to interact with Hadoop" - 6 of 7 
parameters not in _hive-default.xml.template_ but presumably they're documented 
in other projects ({{hadoop.bin.path, hadoop.config.dir, fs.default.name, 
map.input.file, mapred.job.tracker, mapred.job.name}})

* "Hive Variables used to pass run time information" - 7 parameters, none of 
them in _hive-default.xml.template_ ({{hive.session.id, hive.query.string, 
hive.query.planid, hive.jobname.length, hive.table.name, hive.partition.name, 
hive.alias}}) 

So should the admin & language "Configuration" docs be merged? 

                
> Move Hive admin documentation from wiki to version control
> ----------------------------------------------------------
>
>                 Key: HIVE-3039
>                 URL: https://issues.apache.org/jira/browse/HIVE-3039
>             Project: Hive
>          Issue Type: Task
>          Components: Documentation
>            Reporter: Lefty Leverenz
>            Assignee: Lefty Leverenz
>              Labels: documentation
>         Attachments: HIVE-3039.1.patch
>
>
> Move the Hive administrator documentation from the wiki to version control.  
> The wiki doc set for administrators currently has nine html files that need 
> to be converted to xml:
> Installing Hive
> Configuring Hive
> Setting up Metastore
> Setting up Hive Web Interface
> Setting up Thrift Hive Server
> Setting up Hive JDBC Server
> Setting up Hive ODBC Server
> Hive on Amazon Web Services
> Hive on Amazon ElasticMapReduce

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Reply via email to