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:22:55 UTC

svn commit: r1196858 - in /incubator/hcatalog/branches/branch-0.2: 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:22:55 2011
New Revision: 1196858

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

Modified:
    incubator/hcatalog/branches/branch-0.2/CHANGES.txt
    incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/install.xml
    incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/rpminstall.xml

Modified: incubator/hcatalog/branches/branch-0.2/CHANGES.txt
URL: http://svn.apache.org/viewvc/incubator/hcatalog/branches/branch-0.2/CHANGES.txt?rev=1196858&r1=1196857&r2=1196858&view=diff
==============================================================================
--- incubator/hcatalog/branches/branch-0.2/CHANGES.txt (original)
+++ incubator/hcatalog/branches/branch-0.2/CHANGES.txt Wed Nov  2 23:22:55 2011
@@ -77,6 +77,8 @@ Release 0.2.0 - Sept-2011
   OPTIMIZATIONS
 
   BUG FIXES
+    HCAT-107. Better documentation for "hive.metastore.warehouse.dir" config (chandec via toffer)    
+    
     HCAT-148. Meaningful error message on failure to resolve topic name for partition event (thw via hashutosh)    
 
     HCAT-103. Update documentation after rpm changes per HCATALOG-63 (khorgath via hashutosh)    

Modified: incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/install.xml
URL: http://svn.apache.org/viewvc/incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/install.xml?rev=1196858&r1=1196857&r2=1196858&view=diff
==============================================================================
--- incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/install.xml (original)
+++ incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/install.xml Wed Nov  2 23:22:55 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/branches/branch-0.2/src/docs/src/documentation/content/xdocs/rpminstall.xml
URL: http://svn.apache.org/viewvc/incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/rpminstall.xml?rev=1196858&r1=1196857&r2=1196858&view=diff
==============================================================================
--- incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/rpminstall.xml (original)
+++ incubator/hcatalog/branches/branch-0.2/src/docs/src/documentation/content/xdocs/rpminstall.xml Wed Nov  2 23:22:55 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>