You are viewing a plain text version of this content. The canonical link for it is here.
Posted to hcatalog-commits@incubator.apache.org by to...@apache.org on 2011/11/02 23:19:29 UTC

svn commit: r1196855 - in /incubator/hcatalog/trunk: CHANGES.txt src/docs/src/documentation/content/xdocs/install.xml src/docs/src/documentation/content/xdocs/rpminstall.xml

Author: toffer
Date: Wed Nov  2 23:19:29 2011
New Revision: 1196855

URL: http://svn.apache.org/viewvc?rev=1196855&view=rev
Log:
HCATALOG-107 Better documentation for hive.metastore.warehouse.dir config (chandec via toffer)

Modified:
    incubator/hcatalog/trunk/CHANGES.txt
    incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml
    incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/rpminstall.xml

Modified: incubator/hcatalog/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/incubator/hcatalog/trunk/CHANGES.txt?rev=1196855&r1=1196854&r2=1196855&view=diff
==============================================================================
--- incubator/hcatalog/trunk/CHANGES.txt (original)
+++ incubator/hcatalog/trunk/CHANGES.txt Wed Nov  2 23:19:29 2011
@@ -110,6 +110,8 @@ Release 0.2.0 - Unreleased
     (Krishna Kumar via macyang)
     
   IMPROVEMENTS
+    HCAT-107. Better documentation for "hive.metastore.warehouse.dir" config (chandec via toffer) 
+
     HCAT-66. HCatalog 0.2.0 Documentation (chandec via hashutosh)
 
     HCAT-54. Javadoc is not being built as part of HCatalog docs (hashutosh) 

Modified: incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml
URL: http://svn.apache.org/viewvc/incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml?rev=1196855&r1=1196854&r2=1196855&view=diff
==============================================================================
--- incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml (original)
+++ incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/install.xml Wed Nov  2 23:19:29 2011
@@ -19,7 +19,7 @@
 
 <document>
   <header>
-    <title>Installing HCatalog</title>
+    <title>Source Installation</title>
   </header>
   <body>
 
@@ -130,8 +130,11 @@
         </tr>
         <tr>
             <td>hive.metastore.warehouse.dir</td>
-            <td>The directory you want to use for the default database in your
-            installation</td>
+            <td>The directory can be a URI or an absolute file path. If it is an absolute file path, it will be resolved to a URI by the metastore:
+            <p>-- If default hdfs was specified in core-site.xml, path resolves to HDFS location. </p>
+            <p>-- Otherwise, path is resolved as local file: URI.</p>
+            <p>This setting becomes effective when creating new tables (takes precedence over default DBS.DB_LOCATION_URI at time of table creation).</p>
+            </td>
         </tr>
         <tr>
             <td>hive.metastore.uris</td>
@@ -193,7 +196,7 @@
   </section>
 
   <section>
-    <title>Client Install</title>
+    <title>Client Installation</title>
 
     <p>Select a <em>root</em> directory for your installation of HCatalog client.
     We recommend <code>/usr/local/hcat</code>.  If necessary, create the directory.</p>
@@ -217,8 +220,11 @@
         </tr>
         <tr>
             <td>hive.metastore.warehouse.dir</td>
-            <td>The directory you want to use for the default database in your
-            installation</td>
+            <td>The directory can be a URI or an absolute file path. If it is an absolute file path, it will be resolved to a URI by the metastore:
+            <p>-- If default hdfs was specified in core-site.xml, path resolves to HDFS location. </p>
+            <p>-- Otherwise, path is resolved as local file: URI.</p>
+            <p>This setting becomes effective when creating new tables (takes precedence over default DBS.DB_LOCATION_URI at time of table creation).</p>
+            </td>
         </tr>
         <tr>
             <td>hive.metastore.uris</td>

Modified: incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/rpminstall.xml
URL: http://svn.apache.org/viewvc/incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/rpminstall.xml?rev=1196855&r1=1196854&r2=1196855&view=diff
==============================================================================
--- incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/rpminstall.xml (original)
+++ incubator/hcatalog/trunk/src/docs/src/documentation/content/xdocs/rpminstall.xml Wed Nov  2 23:19:29 2011
@@ -19,7 +19,7 @@
 
 <document>
   <header>
-    <title>Installing HCatalog</title>
+    <title>RPM Installation</title>
   </header>
   <body>
 
@@ -107,8 +107,11 @@
         </tr>
         <tr>
             <td>hive.metastore.warehouse.dir</td>
-            <td>The directory you want to use for the default database in your
-            installation</td>
+            <td>The directory can be a URI or an absolute file path. If it is an absolute file path, it will be resolved to a URI by the metastore:
+            <p>-- If default hdfs was specified in core-site.xml, path resolves to HDFS location. </p>
+            <p>-- Otherwise, path is resolved as local file: URI.</p>
+            <p>This setting becomes effective when creating new tables (takes precedence over default DBS.DB_LOCATION_URI at time of table creation).</p>
+            </td>
         </tr>
         <tr>
             <td>hive.metastore.uris</td>
@@ -161,7 +164,7 @@
   </section>
 
   <section>
-    <title>Client Install</title>
+    <title>Client Installation</title>
 
     <p><code>rpm -ivh hcatalog-</code><em>version</em><code>.rpm</code></p>
 
@@ -179,8 +182,11 @@
         </tr>
         <tr>
             <td>hive.metastore.warehouse.dir</td>
-            <td>The directory you want to use for the default database in your
-            installation</td>
+            <td>The directory can be a URI or an absolute file path. If it is an absolute file path, it will be resolved to a URI by the metastore:
+            <p>-- If default hdfs was specified in core-site.xml, path resolves to HDFS location. </p>
+            <p>-- Otherwise, path is resolved as local file: URI.</p>
+            <p>This setting becomes effective when creating new tables (takes precedence over default DBS.DB_LOCATION_URI at time of table creation).</p>
+            </td>
         </tr>
         <tr>
             <td>hive.metastore.uris</td>