[ 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