You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@carbondata.apache.org by ch...@apache.org on 2017/02/04 02:38:04 UTC
[05/35] incubator-carbondata-site git commit: Updated website for
CarbonData release 1.0.0
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/installation-guide.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/installation-guide.html b/src/main/webapp/docs/latest/installation-guide.html
index 7e23c48..168f895 100644
--- a/src/main/webapp/docs/latest/installation-guide.html
+++ b/src/main/webapp/docs/latest/installation-guide.html
@@ -15,231 +15,316 @@
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
---><h1>Installation Guide</h1><p>This tutorial guides you through the installation and configuration of CarbonData in the following two modes :</p>
+--><h1>Installation Guide</h1><p>This tutorial guides you through the installation and configuration
+ of CarbonData in the following two modes :</p>
<ul>
- <li><a href="#installing-and-configuring-carbondata-on-standalone-spark-cluster">Installing and Configuring CarbonData on Standalone Spark Cluster</a></li>
- <li><a href="#installing-and-configuring-carbondata-on-spark-on-yarn-cluster">Installing and Configuring CarbonData on ?Spark on YARN? Cluster</a></li>
+ <li><a href="#installing-spark-cluster">Installing and
+ Configuring CarbonData on Standalone Spark Cluster</a></li>
+ <li><a href="#installing-yarn-cluster">Installing and
+ Configuring CarbonData on "Spark on YARN" Cluster</a></li>
</ul><p>followed by :</p>
<ul>
- <li><a href="#query-execution-using-carbondata-thrift-server">Query Execution using CarbonData Thrift Server</a></li>
-</ul><h2>Installing and Configuring CarbonData on Standalone Spark Cluster</h2><h3>Prerequisites</h3>
+ <li><a href="#query-execution">Query Execution using CarbonData
+ Thrift Server</a></li>
+</ul><h2 id="installing-spark-cluster">Installing and Configuring CarbonData on Standalone Spark Cluster</h2><h3>
+ Prerequisites</h3>
<ul>
- <li><p>Hadoop HDFS and Yarn should be installed and running.</p></li>
- <li><p>Spark should be installed and running on all the cluster nodes.</p></li>
- <li><p>CarbonData user should have permission to access HDFS.</p></li>
+ <li><p>Hadoop HDFS and Yarn should be installed and running.</p></li>
+ <li><p>Spark should be installed and running on all the cluster nodes.</p></li>
+ <li><p>CarbonData user should have permission to access HDFS.</p></li>
</ul><h3>Procedure</h3>
<ul>
- <li><p><a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Building+CarbonData+And+IDE+Configuration">Build the CarbonData</a> project and get the assembly jar from "./assembly/target/scala-2.10/carbondata_xxx.jar" and put in the <code>"<SPARK_HOME>/carbonlib"</code> folder.</p><p>NOTE: Create the carbonlib folder if it does not exists inside <code>"<SPARK_HOME>"</code> path.</p></li>
- <li><p>Add the carbonlib folder path in the Spark classpath. (Edit <code>"<SPARK_HOME>/conf/spark-env.sh"</code> file and modify the value of SPARK_CLASSPATH by appending <code>"<SPARK_HOME>/carbonlib/*"</code> to the existing value)</p></li>
- <li><p>Copy the carbon.properties.template to <code>"<SPARK_HOME>/conf/carbon.properties"</code> folder from "./conf/" of CarbonData repository.</p></li>
- <li><p>Copy the "carbonplugins" folder to <code>"<SPARK_HOME>/carbonlib"</code> folder from "./processing/" folder of CarbonData repository.</p><p>NOTE: carbonplugins will contain .kettle folder.</p></li>
- <li><p>In Spark node, configure the properties mentioned in the following table in <code>"<SPARK_HOME>/conf/spark-defaults.conf"</code> file.</p></li>
+ <li><p><a
+ href="https://github.com/apache/incubator-carbondata/blob/master/build/README.md" target="_blank">Build
+ the CarbonData</a> project and get the assembly jar from
+ "./assembly/target/scala-2.10/carbondata_xxx.jar" and put in the <code>"<SPARK_HOME>/carbonlib"</code>
+ folder.</p>
+ <p>NOTE: Create the carbonlib folder if it does not exists inside <code>"<SPARK_HOME>"</code>
+ path.</p></li>
+ <li><p>Add the carbonlib folder path in the Spark classpath. (Edit <code>"<SPARK_HOME>/conf/spark-env.sh"</code>
+ file and modify the value of SPARK_CLASSPATH by appending <br/><code>"<SPARK_HOME>/carbonlib/*"</code>
+ to the existing value)</p></li>
+ <li><p>Copy the carbon.properties.template to <code>"<SPARK_HOME>/conf/carbon.properties"</code>
+ folder from "./conf/" of CarbonData repository.</p></li>
+ <li><p>Copy the "carbonplugins" folder to <code>"<SPARK_HOME>/carbonlib"</code>
+ folder from "./processing/" folder of CarbonData repository.</p>
+ <p>NOTE: carbonplugins will contain .kettle folder.</p></li>
+ <li><p>In Spark node, configure the properties mentioned in the following table in <code>"<SPARK_HOME>/conf/spark-defaults.conf"</code>
+ file.</p></li>
</ul>
<table class="table table-striped table-bordered">
- <thead>
+ <thead>
<tr>
- <th>Property </th>
- <th>Description </th>
- <th>Value </th>
+ <th>Property</th>
+ <th>Description</th>
+ <th>Value</th>
</tr>
- </thead>
- <tbody>
+ </thead>
+ <tbody>
<tr>
- <td>carbon.kettle.home </td>
- <td>Path that will be used by CarbonData internally to create graph for loading the data </td>
- <td>$SPARK_HOME /carbonlib/carbonplugins </td>
+ <td>carbon.kettle.home</td>
+ <td>Path that will be used by CarbonData internally to create graph for loading the data
+ </td>
+ <td>$SPARK_HOME /carbonlib/carbonplugins</td>
</tr>
<tr>
- <td>spark.driver.extraJavaOptions </td>
- <td>A string of extra JVM options to pass to the driver. For instance, GC settings or other logging. </td>
- <td>-Dcarbon.properties.filepath=$SPARK_HOME/conf/carbon.properties </td>
+ <td>spark.driver.extraJavaOptions</td>
+ <td>A string of extra JVM options to pass to the driver. For instance, GC settings or other
+ logging.
+ </td>
+ <td>-Dcarbon.properties.filepath=$SPARK_HOME/conf/carbon.properties</td>
</tr>
<tr>
- <td>spark.executor.extraJavaOptions </td>
- <td>A string of extra JVM options to pass to executors. For instance, GC settings or other logging. NOTE: You can enter multiple values separated by space. </td>
- <td>-Dcarbon.properties.filepath=$SPARK_HOME/conf/carbon.properties </td>
+ <td>spark.executor.extraJavaOptions</td>
+ <td>A string of extra JVM options to pass to executors. For instance, GC settings or other
+ logging. NOTE: You can enter multiple values separated by space.
+ </td>
+ <td>-Dcarbon.properties.filepath=$SPARK_HOME/conf/carbon.properties</td>
</tr>
- </tbody>
+ </tbody>
</table>
<ul>
- <li>Add the following properties in <code>"<SPARK_HOME>/conf/" carbon.properties</code>:</li>
+ <li>Add the following properties in <code>"<SPARK_HOME>/conf/"
+ carbon.properties</code>:
+ </li>
</ul>
<table class="table table-striped table-bordered">
- <thead>
+ <thead>
<tr>
- <th>Property </th>
- <th>Required </th>
- <th>Description </th>
- <th>Example </th>
- <th>Remark </th>
+ <th>Property</th>
+ <th>Required</th>
+ <th>Description</th>
+ <th>Example</th>
+ <th>Remark</th>
</tr>
- </thead>
- <tbody>
+ </thead>
+ <tbody>
<tr>
- <td>carbon.storelocation </td>
- <td>NO </td>
- <td>Location where data CarbonData will create the store and write the data in its own format. </td>
- <td>hdfs://HOSTNAME:PORT/Opt/CarbonStore </td>
- <td>Propose to set HDFS directory </td>
+ <td>carbon.storelocation</td>
+ <td>NO</td>
+ <td>Location where data CarbonData will create the store and write the data in its own
+ format.
+ </td>
+ <td>hdfs://HOSTNAME:PORT/Opt/CarbonStore</td>
+ <td>Propose to set HDFS directory</td>
</tr>
<tr>
- <td>carbon.kettle.home </td>
- <td>YES </td>
- <td>Path that will be used by CarbonData internally to create graph for loading the data. </td>
- <td>$SPARK_HOME/carbonlib/carbonplugins </td>
- <td> </td>
+ <td>carbon.kettle.home</td>
+ <td>YES</td>
+ <td>Path that will be used by CarbonData internally to create graph for loading the data.
+ </td>
+ <td>$SPARK_HOME/carbonlib/carbonplugins</td>
+ <td></td>
</tr>
- </tbody>
+ </tbody>
</table>
<ul>
- <li>Verify the installation. For example:</li>
+ <li>Verify the installation. For example:</li>
</ul><p><code>
- ./spark-shell --master spark://HOSTNAME:PORT --total-executor-cores 2
- --executor-memory 2G
-</code></p><p>NOTE: Make sure you have permissions for CarbonData JARs and files through which driver and executor will start.</p><p>To get started with CarbonData : <a href="quick-start-guide.html">Quick Start</a> , <a href="ddl-operation-on-carbondata.html">DDL Operations on CarbonData</a></p><h2>Installing and Configuring CarbonData on "Spark on YARN" Cluster</h2><p>This section provides the procedure to install CarbonData on "Spark on YARN" cluster.</p><h3>Prerequisites</h3>
+ ./spark-shell --master spark://HOSTNAME:PORT --total-executor-cores 2
+ --executor-memory 2G
+</code></p><p>NOTE: Make sure you have permissions for CarbonData JARs and files through which
+ driver and executor will start.</p><p>To get started with CarbonData : <a
+ href="mainpage.html?page=quickStart">Quick Start</a> , <a href="mainpage.html?page=ddl">DDL
+ Operations on CarbonData</a></p>
+ <h2 id="installing-yarn-cluster">Installing and Configuring CarbonData on "Spark on YARN"
+ Cluster</h2><p>This section provides the procedure to install CarbonData on "Spark on YARN"
+ cluster.</p><h3>Prerequisites</h3>
<ul>
- <li>Hadoop HDFS and Yarn should be installed and running.</li>
- <li>Spark should be installed and running in all the clients.</li>
- <li>CarbonData user should have permission to access HDFS.</li>
-</ul><h3>Procedure</h3><p>The following steps are only for Driver Nodes. (Driver nodes are the one which starts the spark context.)</p>
+ <li>Hadoop HDFS and Yarn should be installed and running.</li>
+ <li>Spark should be installed and running in all the clients.</li>
+ <li>CarbonData user should have permission to access HDFS.</li>
+</ul><h3>Procedure</h3><p>The following steps are only for Driver Nodes. (Driver nodes are the one
+ which starts the spark context.)</p>
<ul>
- <li><p><a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Building+CarbonData+And+IDE+Configuration">Build the CarbonData</a> project and get the assembly jar from "./assembly/target/scala-2.10/carbondata_xxx.jar" and put in the <code>"<SPARK_HOME>/carbonlib"</code> folder.</p><p>NOTE: Create the carbonlib folder if it does not exists inside <code>"<SPARK_HOME>"</code> path.</p></li>
- <li><p>Copy "carbonplugins" folder to <code>"<SPARK_HOME>/carbonlib"</code> folder from "./processing/" folder of CarbonData repository. carbonplugins will contain .kettle folder.</p></li>
- <li><p>Copy the "carbon.properties.template" to <code>"<SPARK_HOME>/conf/carbon.properties"</code> folder from conf folder of CarbonData repository.</p></li>
- <li>Modify the parameters in "spark-default.conf" located in the <code>"<SPARK_HOME>/conf</code>"</li>
+ <li><p><a
+ href="https://github.com/apache/incubator-carbondata/blob/master/build/README.md" target="_blank">Build
+ the CarbonData</a> project and get the assembly jar from
+ "./assembly/target/scala-2.10/carbondata_xxx.jar" and put in the <code>"<SPARK_HOME>/carbonlib"</code>
+ folder.</p>
+ <p>NOTE: Create the carbonlib folder if it does not exists inside <code>"<SPARK_HOME>"</code>
+ path.</p></li>
+ <li><p>Copy "carbonplugins" folder to <code>"<SPARK_HOME>/carbonlib"</code>
+ folder from "./processing/" folder of CarbonData repository. carbonplugins will contain
+ .kettle folder.</p></li>
+ <li><p>Copy the "carbon.properties.template" to <code>"<SPARK_HOME>/conf/carbon.properties"</code>
+ folder from conf folder of CarbonData repository.</p></li>
+ <li>Modify the parameters in "spark-default.conf" located in the <code>"<SPARK_HOME>/conf</code>"
+ </li>
</ul>
<table class="table table-striped table-bordered">
- <thead>
+ <thead>
<tr>
- <th>Property </th>
- <th>Description </th>
- <th>Value </th>
+ <th>Property</th>
+ <th>Description</th>
+ <th>Value</th>
</tr>
- </thead>
- <tbody>
+ </thead>
+ <tbody>
<tr>
- <td>spark.master </td>
- <td>Set this value to run the Spark in yarn cluster mode. </td>
- <td>Set "yarn-client" to run the Spark in yarn cluster mode. </td>
+ <td>spark.master</td>
+ <td>Set this value to run the Spark in yarn cluster mode.</td>
+ <td>Set "yarn-client" to run the Spark in yarn cluster mode.</td>
</tr>
<tr>
- <td>spark.yarn.dist.files </td>
- <td>Comma-separated list of files to be placed in the working directory of each executor. </td>
- <td><code>"<YOUR_SPARK_HOME_PATH>"/conf/carbon.properties</code> </td>
+ <td>spark.yarn.dist.files</td>
+ <td>Comma-separated list of files to be placed in the working directory of each executor.
+ </td>
+ <td><code>"<YOUR_SPARK_HOME_PATH>"/conf/carbon.properties</code></td>
</tr>
<tr>
- <td>spark.yarn.dist.archives </td>
- <td>Comma-separated list of archives to be extracted into the working directory of each executor. </td>
- <td><code>"<YOUR_SPARK_HOME_PATH>"/carbonlib/carbondata_xxx.jar</code> </td>
+ <td>spark.yarn.dist.archives</td>
+ <td>Comma-separated list of archives to be extracted into the working directory of each
+ executor.
+ </td>
+ <td><code>"<YOUR_SPARK_HOME_PATH>"/carbonlib/carbondata_xxx.jar</code></td>
</tr>
<tr>
- <td>spark.executor.extraJavaOptions </td>
- <td>A string of extra JVM options to pass to executors. For instance NOTE: You can enter multiple values separated by space. </td>
- <td><code>-Dcarbon.properties.filepath="<YOUR_SPARK_HOME_PATH>"/conf/carbon.properties</code> </td>
+ <td>spark.executor.extraJavaOptions</td>
+ <td>A string of extra JVM options to pass to executors. For instance NOTE: You can enter
+ multiple values separated by space.
+ </td>
+ <td><code>-Dcarbon.properties.filepath="<YOUR_SPARK_HOME_PATH>"/conf/carbon.properties</code>
+ </td>
</tr>
<tr>
- <td>spark.executor.extraClassPath </td>
- <td>Extra classpath entries to prepend to the classpath of executors. NOTE: If SPARK_CLASSPATH is defined in spark-env.sh, then comment it and append the values in below parameter spark.driver.extraClassPath </td>
- <td><code>"<YOUR_SPARK_HOME_PATH>"/carbonlib/carbonlib/carbondata_xxx.jar</code> </td>
+ <td>spark.executor.extraClassPath</td>
+ <td>Extra classpath entries to prepend to the classpath of executors. NOTE: If
+ SPARK_CLASSPATH is defined in spark-env.sh, then comment it and append the values in
+ below parameter spark.driver.extraClassPath
+ </td>
+ <td><code>
+ "<YOUR_SPARK_HOME_PATH>"/carbonlib/carbonlib/carbondata_xxx.jar</code>
+ </td>
</tr>
<tr>
- <td>spark.driver.extraClassPath </td>
- <td>Extra classpath entries to prepend to the classpath of the driver. NOTE: If SPARK_CLASSPATH is defined in spark-env.sh, then comment it and append the value in below parameter spark.driver.extraClassPath. </td>
- <td><code>"<YOUR_SPARK_HOME_PATH>"/carbonlib/carbonlib/carbondata_xxx.jar</code> </td>
+ <td>spark.driver.extraClassPath</td>
+ <td>Extra classpath entries to prepend to the classpath of the driver. NOTE: If
+ SPARK_CLASSPATH is defined in spark-env.sh, then comment it and append the value in
+ below parameter spark.driver.extraClassPath.
+ </td>
+ <td><code>
+ "<YOUR_SPARK_HOME_PATH>"/carbonlib/carbonlib/carbondata_xxx.jar</code>
+ </td>
</tr>
<tr>
- <td>spark.driver.extraJavaOptions </td>
- <td>A string of extra JVM options to pass to the driver. For instance, GC settings or other logging. </td>
- <td><code>-Dcarbon.properties.filepath="<YOUR_SPARK_HOME_PATH>"/conf/carbon.properties</code> </td>
+ <td>spark.driver.extraJavaOptions</td>
+ <td>A string of extra JVM options to pass to the driver. For instance, GC settings or other
+ logging.
+ </td>
+ <td><code>-Dcarbon.properties.filepath="<YOUR_SPARK_HOME_PATH>"/conf/carbon.properties</code>
+ </td>
</tr>
<tr>
- <td>carbon.kettle.home </td>
- <td>Path that will be used by CarbonData internally to create graph for loading the data. </td>
- <td><code>"<YOUR_SPARK_HOME_PATH>"/carbonlib/carbonplugins</code> </td>
+ <td>carbon.kettle.home</td>
+ <td>Path that will be used by CarbonData internally to create graph for loading the data.
+ </td>
+ <td><code>"<YOUR_SPARK_HOME_PATH>"/carbonlib/carbonplugins</code></td>
</tr>
- </tbody>
+ </tbody>
</table>
<ul>
- <li>Add the following properties in <code><SPARK_HOME>/conf/ carbon.properties</code>:</li>
+ <li>Add the following properties in <code><SPARK_HOME>/conf/ carbon.properties</code>:
+ </li>
</ul>
<table class="table table-striped table-bordered">
- <thead>
+ <thead>
<tr>
- <th>Property </th>
- <th>Required </th>
- <th>Description </th>
- <th>Example </th>
- <th>Default Value </th>
+ <th>Property</th>
+ <th>Required</th>
+ <th>Description</th>
+ <th>Example</th>
+ <th>Default Value</th>
</tr>
- </thead>
- <tbody>
+ </thead>
+ <tbody>
<tr>
- <td>carbon.storelocation </td>
- <td>NO </td>
- <td>Location where CarbonData will create the store and write the data in its own format. </td>
- <td>hdfs://HOSTNAME:PORT/Opt/CarbonStore </td>
- <td>Propose to set HDFS directory</td>
+ <td>carbon.storelocation</td>
+ <td>NO</td>
+ <td>Location where CarbonData will create the store and write the data in its own format.
+ </td>
+ <td>hdfs://HOSTNAME:PORT/Opt/CarbonStore</td>
+ <td>Propose to set HDFS directory</td>
</tr>
<tr>
- <td>carbon.kettle.home </td>
- <td>YES </td>
- <td>Path that will be used by CarbonData internally to create graph for loading the data. </td>
- <td>$SPARK_HOME/carbonlib/carbonplugins </td>
- <td> </td>
+ <td>carbon.kettle.home</td>
+ <td>YES</td>
+ <td>Path that will be used by CarbonData internally to create graph for loading the data.
+ </td>
+ <td>$SPARK_HOME/carbonlib/carbonplugins</td>
+ <td></td>
</tr>
- </tbody>
+ </tbody>
</table>
<ul>
- <li>Verify the installation.</li>
+ <li>Verify the installation.</li>
</ul><p><code>
- ./bin/spark-shell --master yarn-client --driver-memory 1g
- --executor-cores 2 --executor-memory 2G
-</code> NOTE: Make sure you have permissions for CarbonData JARs and files through which driver and executor will start.</p><p>Getting started with CarbonData : <a href="quick-start-guide.html">Quick Start</a> , <a href="ddl-operation-on-carbondata.html">DDL Operations on CarbonData</a></p><h2>Query Execution Using CarbonData Thrift Server</h2><h3>Starting CarbonData Thrift Server</h3><p>a. cd <code><SPARK_HOME></code></p><p>b. Run the following command to start the CarbonData thrift server.</p><p><code>
-./bin/spark-submit --conf spark.sql.hive.thriftServer.singleSession=true
---class org.apache.carbondata.spark.thriftserver.CarbonThriftServer
-$SPARK_HOME/carbonlib/$CARBON_ASSEMBLY_JAR <carbon_store_path>
+ ./bin/spark-shell --master yarn-client --driver-memory 1g
+ --executor-cores 2 --executor-memory 2G
+</code> NOTE: Make sure you have permissions for CarbonData JARs and files through which driver and
+ executor will start.</p><p>Getting started with CarbonData :<a
+ href="mainpage.html?page=quickStart">Quick Start</a> , <a href="mainpage.html?page=ddl">DDL Operations on CarbonData</a></p>
+
+<h2 id="query-execution">
+ Query Execution Using CarbonData Thrift Server</h2><h3>Starting CarbonData Thrift Server</h3><p>
+ a. cd <code><SPARK_HOME></code></p><p>b. Run the following command to start the CarbonData
+ thrift server.</p><p><code>
+ ./bin/spark-submit --conf spark.sql.hive.thriftServer.singleSession=true
+ --class org.apache.carbondata.spark.thriftserver.CarbonThriftServer
+ $SPARK_HOME/carbonlib/$CARBON_ASSEMBLY_JAR <carbon_store_path>
</code></p>
<table class="table table-striped table-bordered">
- <thead>
+ <thead>
<tr>
- <th>Parameter </th>
- <th>Description </th>
- <th>Example </th>
+ <th>Parameter</th>
+ <th>Description</th>
+ <th>Example</th>
</tr>
- </thead>
- <tbody>
+ </thead>
+ <tbody>
<tr>
- <td>CARBON_ASSEMBLY_JAR </td>
- <td>CarbonData assembly jar name present in the <code>"<SPARK_HOME>"/carbonlib/</code> folder. </td>
- <td>carbondata_2.10-0.1.0-incubating-SNAPSHOT-shade-hadoop2.7.2.jar </td>
+ <td>CARBON_ASSEMBLY_JAR</td>
+ <td>CarbonData assembly jar name present in the <code>"<SPARK_HOME>"/carbonlib/</code>
+ folder.
+ </td>
+ <td>carbondata_2.10-0.1.0-incubating-SNAPSHOT-shade-hadoop2.7.2.jar</td>
</tr>
<tr>
- <td>carbon_store_path </td>
- <td>This is a parameter to the CarbonThriftServer class. This a HDFS path where CarbonData files will be kept. Strongly Recommended to put same as carbon.storelocation parameter of carbon.properties. </td>
- <td><code>hdfs//<host_name>:54310/user/hive/warehouse/carbon.store</code> </td>
+ <td>carbon_store_path</td>
+ <td>This is a parameter to the CarbonThriftServer class. This a HDFS path where CarbonData
+ files will be kept. Strongly Recommended to put same as carbon.storelocation parameter
+ of carbon.properties.
+ </td>
+ <td><code>hdfs//<host_name>:54310/user/hive/warehouse/carbon.store</code></td>
</tr>
- </tbody>
+ </tbody>
</table><h3>Examples</h3>
<ul>
- <li>Start with default memory and executors</li>
-</ul><p><code>
-./bin/spark-submit --conf spark.sql.hive.thriftServer.singleSession=true
---class org.apache.carbondata.spark.thriftserver.CarbonThriftServer
-$SPARK_HOME/carbonlib
-/carbondata_2.10-0.1.0-incubating-SNAPSHOT-shade-hadoop2.7.2.jar
-hdfs://hacluster/user/hive/warehouse/carbon.store
-</code></p>
+ <li>Start with default memory and executors</li>
+</ul><p><pre><code>
+ ./bin/spark-submit --conf spark.sql.hive.thriftServer.singleSession=true
+ --class org.apache.carbondata.spark.thriftserver.CarbonThriftServer
+ $SPARK_HOME/carbonlib
+ /carbondata_2.10-0.1.0-incubating-SNAPSHOT-shade-hadoop2.7.2.jar
+ hdfs://hacluster/user/hive/warehouse/carbon.store
+</code></pre></p>
<ul>
- <li>Start with Fixed executors and resources</li>
-</ul><p><code>
-./bin/spark-submit --conf spark.sql.hive.thriftServer.singleSession=true
---class org.apache.carbondata.spark.thriftserver.CarbonThriftServer
---num-executors 3 --driver-memory 20g --executor-memory 250g
---executor-cores 32
-/srv/OSCON/BigData/HACluster/install/spark/sparkJdbc/lib
-/carbondata_2.10-0.1.0-incubating-SNAPSHOT-shade-hadoop2.7.2.jar
-hdfs://hacluster/user/hive/warehouse/carbon.store
-</code></p><h3>Connecting to CarbonData Thrift Server Using Beeline</h3><p>``` cd <SPARK_HOME> ./bin/beeline jdbc:hive2://<thrftserver_host>:port</p>
-<pre><code> Example
- ./bin/beeline jdbc:hive2://10.10.10.10:10000
-</code></pre><p>```</p>
\ No newline at end of file
+ <li>Start with Fixed executors and resources</li>
+</ul><p><pre><code>
+ ./bin/spark-submit --conf spark.sql.hive.thriftServer.singleSession=true
+ --class org.apache.carbondata.spark.thriftserver.CarbonThriftServer
+ --num-executors 3 --driver-memory 20g --executor-memory 250g
+ --executor-cores 32
+ /srv/OSCON/BigData/HACluster/install/spark/sparkJdbc/lib
+ /carbondata_2.10-0.1.0-incubating-SNAPSHOT-shade-hadoop2.7.2.jar
+ hdfs://hacluster/user/hive/warehouse/carbon.store
+</code></pre></p><h3>Connecting to CarbonData Thrift Server Using Beeline</h3>
+<p>
+<pre><code>
+ cd SPARK_HOME
+ ./bin/beeline jdbc:hive2://thriftserver_host:port
+
+ Example:
+ ./bin/beeline jdbc:hive2://10.10.10.10:10000
+</code></pre>
+</p>
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/mainpage.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/mainpage.html b/src/main/webapp/docs/latest/mainpage.html
index 6cc23ab..b85e1b2 100644
--- a/src/main/webapp/docs/latest/mainpage.html
+++ b/src/main/webapp/docs/latest/mainpage.html
@@ -1,154 +1,144 @@
-<!DOCTYPE html>
-<html lang="en">
- <head>
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <link href='../../images/favicon.ico' rel='shortcut icon' type='image/x-icon'>
- <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
- <title>CarbonData</title>
-<style>
-
-</style>
- <!-- Bootstrap -->
-
- <link rel="stylesheet" href="../../css/bootstrap.min.css">
- <link href="../../css/style.css" rel="stylesheet">
- <link href="../../css/print.css" rel="stylesheet" >
- <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
- <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
- <!--[if lt IE 9]>
- <script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
- <script src="https://oss.maxcdn.scom/respond/1.4.2/respond.min.js"></script>
- <![endif]-->
- <script src="../../js/jquery.min.js"></script>
- <script src="../../js/bootstrap.min.js"></script>
-
-
-
- </head>
- <body>
- <header>
- <nav class="navbar navbar-default navbar-custom cd-navbar-wrapper" >
- <div class="container">
- <div class="navbar-header">
- <button aria-controls="navbar" aria-expanded="false" data-target="#navbar" data-toggle="collapse" class="navbar-toggle collapsed" type="button">
- <span class="sr-only">Toggle navigation</span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- <span class="icon-bar"></span>
- </button>
- <a href="../../index.html" class="logo">
- <img src="../../images/CarbonDataLogo.png" alt="CarbonData logo" title="CarbocnData logo" />
- </a>
- </div>
- <div class="navbar-collapse collapse cd_navcontnt" id="navbar">
- <ul class="nav navbar-nav navbar-right navlist-custom">
- <li><a href="../../index.html" class="hidden-xs"><i class="fa fa-home" aria-hidden="true"></i> </a></li>
- <li><a href="../../index.html" class="hidden-lg hidden-md hidden-sm">Home</a></li>
- <li class="dropdown">
- <a href="#" class="dropdown-toggle " data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false"> Download <span class="caret"></span></a>
- <ul class="dropdown-menu">
- <li><a href="https://www.apache.org/dyn/closer.lua/incubator/carbondata/0.2.0-incubating" target="_blank">Apache CarbonData 0.2.0</a></li>
- <li><a href="https://www.apache.org/dyn/closer.lua/incubator/carbondata/0.1.1-incubating" target="_blank">Apache CarbonData 0.1.1</a></li>
- <li><a href="https://www.apache.org/dyn/closer.lua/incubator/carbondata/0.1.0-incubating" target="_blank">Apache CarbonData 0.1.0</a></li>
- <li><a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Releases" target="_blank">Release Archive</a></li>
-
- </ul>
- </li>
-
- <li><a href="mainpage.html" class="">Documentation</a></li>
- <!--<li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Documentation <span class="caret"></span></a>
- <ul class="dropdown-menu">
- <li><a href="quickstartDoc.html">Quick Start</a></li>
- <li><a href="overDoc.html">Overview</a></li>
- <li><a href="installingcarbondataDoc.html">Installation Guide</a></li>
- <li><a href="configuringcarbondataDoc.html">Configuring CarbonData</a></li>
- <li><a href="usingcarbondataDoc.html">Using CarbonData</a></li>
- <li><a href="usefultipsDoc.html">Useful Tips</a></li>
- <li><a href="usecasesDoc.html">CarbonData Use Cases</a></li>
- <li><a href="troubleshootingDoc.html">Troubleshooting</a></li>
- <li><a href="faqDoc.html">FAQs</a></li>
- </ul>
-
- </li> -->
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Community <span class="caret"></span></a>
- <ul class="dropdown-menu">
- <li><a href="../../contributingDoc.html">Contributing to CarbonData</a></li>
- <li><a href="../../contributingDoc.html#Mailing_List">Mailing Lists</a></li>
- <li><a href="../../contributingDoc.html#Apache_Jira">Issue Tracker</a></li>
- <li><a href="../../contributingDoc.html#Committers">Project Committers</a></li>
- <li><a href="../../jenkins.html">Jenkins for Apache CarbonData</a></li>
- <li><a href="../../meetup.html">CarbonData Meetups </a></li>
- </ul>
- </li>
- <li class="dropdown">
- <a href="http://www.apache.org/" class="apache_link hidden-xs dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Apache</a>
- <ul class="dropdown-menu">
- <li><a href="http://www.apache.org/" target="_blank">Apache Homepage</a></li>
- <li><a href="http://www.apache.org/licenses/" target="_blank">License</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" target="_blank">Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" target="_blank">Thanks</a></li>
- </ul>
- </li>
-
- <li class="dropdown">
- <a href="http://www.apache.org/" class="hidden-lg hidden-md hidden-sm dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Apache</a>
- <ul class="dropdown-menu">
- <li><a href="http://www.apache.org/" target="_blank">Apache Homepage</a></li>
- <li><a href="http://www.apache.org/licenses/" target="_blank">License</a></li>
- <li><a href="http://www.apache.org/foundation/sponsorship.html" target="_blank">Sponsorship</a></li>
- <li><a href="http://www.apache.org/foundation/thanks.html" target="_blank">Thanks</a></li>
- </ul>
- </li>
-
- </ul>
- </div><!--/.nav-collapse -->
- </div>
- </nav>
- </header> <!-- end Header part -->
-
- <div class="fixed-padding"></div> <!-- top padding with fixde header -->
-
- <section><!-- Dashboard nav -->
- <div class="container-fluid container-fluid-full">
- <div class="row">
- <div class="col-sm-3 col-md-3 sidebar leftMainMenu">
- <div id="leftmenu" nama="leftmenu" onload="pageLoaded()"></div>
- </div>
- <div class="col-sm-9 col-sm-offset-3 col-md-9 col-md-offset-3 maindashboard">
- <div class="row">
- <section>
- <div style="padding:10px 15px;">
- <div class="doc-header">
- <img src="../../images/format/CarbonData_icon.png" alt="" class="logo-print" >
- <span>Version: 0.2.0 | Last Published: 21-11-2016</span>
- <i class="fa fa-print print-icon" aria-hidden="true" onclick="divPrint();"></i>
- </div>
- <div id="viewpage" name="viewpage"> </div>
- <div class="doc-footer">
- <a href="#top" class="scroll-top">Top</a>
- </div>
- </div>
- </section>
- </div>
- </div>
- </div>
- </div>
- </section><!-- End systemblock part -->
-
- <!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
-
- <script src="../../js/custom.js"></script>
- <script src="../../js/mdNavigation.js" type="text/javascript"></script>
-
- <script type="text/javascript">
- $("#leftmenu").load("table-of-content.html");
- </script>
-
-
-
- </body>
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <link href='../../images/favicon.ico' rel='shortcut icon' type='image/x-icon'>
+ <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
+ <title>CarbonData</title>
+<style>
+
+</style>
+ <!-- Bootstrap -->
+
+ <link rel="stylesheet" href="../../css/bootstrap.min.css">
+ <link href="../../css/style.css" rel="stylesheet">
+ <link href="../../css/print.css" rel="stylesheet" >
+ <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
+ <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
+ <script src="https://oss.maxcdn.scom/respond/1.4.2/respond.min.js"></script>
+ <![endif]-->
+ <script src="../../js/jquery.min.js"></script>
+ <script src="../../js/bootstrap.min.js"></script>
+
+
+
+ </head>
+ <body>
+ <header>
+ <nav class="navbar navbar-default navbar-custom cd-navbar-wrapper" >
+ <div class="container">
+ <div class="navbar-header">
+ <button aria-controls="navbar" aria-expanded="false" data-target="#navbar" data-toggle="collapse" class="navbar-toggle collapsed" type="button">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a href="../../index.html" class="logo">
+ <img src="../../images/CarbonDataLogo.png" alt="CarbonData logo" title="CarbocnData logo" />
+ </a>
+ </div>
+ <div class="navbar-collapse collapse cd_navcontnt" id="navbar">
+ <ul class="nav navbar-nav navbar-right navlist-custom">
+ <li><a href="../../index.html" class="hidden-xs"><i class="fa fa-home" aria-hidden="true"></i> </a></li>
+ <li><a href="../../index.html" class="hidden-lg hidden-md hidden-sm">Home</a></li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle " data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false"> Download <span class="caret"></span></a>
+ <ul class="dropdown-menu">
+ <li>
+ <a href="https://www.apache.org/dyn/closer.lua/incubator/carbondata/1.0.0-incubating"
+ target="_blank">Apache CarbonData 1.0.0</a></li>
+ <li>
+ <a href="https://www.apache.org/dyn/closer.lua/incubator/carbondata/0.2.0-incubating"
+ target="_blank">Apache CarbonData 0.2.0</a></li>
+ <li>
+ <a href="https://www.apache.org/dyn/closer.lua/incubator/carbondata/0.1.1-incubating"
+ target="_blank">Apache CarbonData 0.1.1</a></li>
+ <li>
+ <a href="https://www.apache.org/dyn/closer.lua/incubator/carbondata/0.1.0-incubating"
+ target="_blank">Apache CarbonData 0.1.0</a></li>
+ <li>
+ <a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Releases"
+ target="_blank">Release Archive</a></li>
+ </ul>
+ </li>
+
+ <li><a href="mainpage.html?page=userguide" class="">Documentation</a></li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Community <span class="caret"></span></a>
+ <ul class="dropdown-menu">
+ <li><a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Contributing+to+CarbonData" target="_blank">Contributing to CarbonData</a></li>
+ <li><a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Committers" target="_blank">Project Committers</a></li>
+ <li><a href="../../meetup.html">CarbonData Meetups </a></li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="http://www.apache.org/" class="apache_link hidden-xs dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Apache</a>
+ <ul class="dropdown-menu">
+ <li><a href="http://www.apache.org/" target="_blank">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/" target="_blank">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" target="_blank">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" target="_blank">Thanks</a></li>
+ </ul>
+ </li>
+
+ <li class="dropdown">
+ <a href="http://www.apache.org/" class="hidden-lg hidden-md hidden-sm dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Apache</a>
+ <ul class="dropdown-menu">
+ <li><a href="http://www.apache.org/" target="_blank">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/" target="_blank">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" target="_blank">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html" target="_blank">Thanks</a></li>
+ </ul>
+ </li>
+
+ </ul>
+ </div><!--/.nav-collapse -->
+ </div>
+ </nav>
+ </header> <!-- end Header part -->
+
+ <div class="fixed-padding"></div> <!-- top padding with fixde header -->
+
+ <section><!-- Dashboard nav -->
+ <div class="container-fluid q">
+ <div class="col-sm-12 col-md-12 maindashboard">
+ <div class="row">
+ <section>
+ <div style="padding:10px 15px;">
+ <div class="doc-header">
+ <div class="doc-toc">
+ <a href="mainpage.html?page=userguide" class="icon toc-icon"></a>
+ </div>
+ <img src="../../images/format/CarbonData_icon.png" alt="" class="logo-print" >
+ <span>Version: 1.0.0 | Published: 30-01-2017</span>
+ <i class="fa fa-print print-icon" aria-hidden="true" onclick="divPrint();"></i>
+ </div>
+ <div id="viewpage" name="viewpage"> </div>
+ <div class="doc-footer">
+ <a href="#top" class="scroll-top">Top</a>
+ </div>
+ </div>
+ </section>
+ </div>
+ </div>
+ </div>
+ </section><!-- End systemblock part -->
+
+ <!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
+
+ <script src="../../js/custom.js"></script>
+ <script src="../../js/mdNavigation.js" type="text/javascript"></script>
+
+ <script type="text/javascript">
+ <!-- $("#leftmenu").load("table-of-content.html");-->
+ </script>
+
+
+
+ </body>
</html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/overview-of-carbondata.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/overview-of-carbondata.html b/src/main/webapp/docs/latest/overview-of-carbondata.html
index ae7e62c..5f4aff3 100644
--- a/src/main/webapp/docs/latest/overview-of-carbondata.html
+++ b/src/main/webapp/docs/latest/overview-of-carbondata.html
@@ -15,13 +15,11 @@
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
---><h1>Overview</h1><p>This tutorial provides a detailed overview about :</p>
+-->
+<h1>Overview</h1><p>This tutorial provides a detailed overview about :</p>
<ul>
<li><a href="#introduction">Introduction</a></li>
- <li><a href="#carbondata-file-structure">CarbonData File Structure</a></li>
<li><a href="#features">Features</a></li>
- <li><a href="#data-types">Data Types</a></li>
- <li><a href="#interfaces">Interfaces</a></li>
</ul>
<div id="introduction"></div>
@@ -31,13 +29,7 @@
<li>Fast query on fast data.</li>
<li>Space efficiency.</li>
<li>General format available on Hadoop-ecosystem.</li>
- <div id="carbondata-file-structure"></div>
-</ul><h2>CarbonData File Structure</h2><p>CarbonData files contain groups of data called blocklets, along with all required information like schema, offsets and indices etc, in a file footer, co-located in HDFS.</p><p>The file footer can be read once to build the indices in memory, which can be utilized for optimizing the scans and processing for all subsequent queries.</p><p>Each blocklet in the file is further divided into chunks of data called data chunks. Each data chunk is organized either in columnar format or row format, and stores the data of either a single column or a set of columns. All blocklets in a file contain the same number and type of data chunks.</p><p><img src="../../../webapp/docs/latest/images/carbon_data_file_structure_new.png?raw=true" alt="CarbonData File Structure" /></p><p>Each data chunk contains multiple groups of data called as pages. There are three types of pages.</p>
-<ul>
- <li>Data Page: Contains the encoded data of a column/group of columns.</li>
- <li>Row ID Page (optional): Contains the row ID mappings used when the data page is stored as an inverted index.</li>
- <li>RLE Page (optional): Contains additional metadata used when the data page is RLE coded.</li>
-</ul><p><img src="../../../webapp/docs/latest/images/carbon_data_format_new.png?raw=true" alt="CarbonData File Format" /></p>
+</ul>
<div id="features"></div>
<h2>Features</h2><p>CarbonData file format is a columnar store in HDFS. It has many features that a modern columnar format has, such as splittable, compression schema, complex data type etc and CarbonData has following unique features:</p>
@@ -45,92 +37,15 @@
<li><p>Unique Data Organization: Though CarbonData stores data in Columnar format, it differs from traditional Columnar formats as the columns in each row-group(Data Block) is sorted independent of the other columns. Though this arrangement requires CarbonData to store the row-number mapping against each column value, it makes it possible to use binary search for faster filtering and since the values are sorted, same/similar values come together which yields better compression and offsets the storage overhead required by the row number mapping.</p></li>
<li><p>Advanced Push Down Optimizations: CarbonData pushes as much of query processing as possible close to the data to minimize the amount of data being read, processed, converted and transmitted/shuffled. Using projections and filters it reads only the required columns form the store and also reads only the rows that match the filter conditions provided in the query.</p></li>
<li><p>Multi Level Indexing: CarbonData uses multiple indices at various levels to enable faster search and speed up query processing.</p></li>
+ <li><p>Dictionary Encoding: Most databases and big data SQL data stores employ columnar encoding to achieve data compression by storing small integers numbers (surrogate value) instead of full string values. However, almost all existing databases and data stores divide the data into row groups containing anywhere from few thousand to a million rows and employ dictionary encoding only within each row group. Hence, the same column value can have different surrogate values in different row groups. So, while reading the data, conversion from surrogate value to actual value needs to be done immediately after the data is read from the disk. But CarbonData employs global surrogate key which means that a common dictionary is maintained for the full store on one machine/node. So CarbonData can perform all the query processing work such as grouping/aggregation, sorting etc on light weight surrogate values. The conversion from surrogate to actual values needs to be done only on the final res
ult. This procedure improves performance on two aspects. Conversion from surrogate values to actual values is done only for the final result rows which are much less than the actual rows read from the store. All query processing and computation such as grouping/aggregation, sorting, and so on is done on lightweight surrogate values which requires less memory and CPU time compared to actual values.</p></li>
+ <li><p>Deep Spark Integration: It has built-in spark integration for Spark 1.6.2, 2.1 and interfaces for Spark SQL, DataFrame API and query optimization. It supports bulk data ingestion and allows saving of spark dataframes as CarbonData files.</p></li>
+ <li><p>Update Delete Support: It supports batch updates like daily update scenarios for OLAP and Base+Delta file based design.</p></li>
+ <li><p>Bucketing : It is a technique that is used for uniform distribution of data across files in CarbonData. It enhances the performance of join queries. While loading the data, records are placed into buckets based on hashing algorithm. During the execution of join queries the records can be fetched from buckets with out need of shuffling.This feature is used to distribute/organize the table/partition data into multiple files placing similar records in same file.</p></li>
<li><p>Global Multi Dimensional Keys(MDK) based B+Tree Index for all non- measure columns: Aids in quickly locating the row groups(Data Blocks) that contain the data matching search/filter criteria.</p></li>
<li><p>Min-Max Index for all columns: Aids in quickly locating the row groups(Data Blocks) that contain the data matching search/filter criteria.</p></li>
<li><p>Data Block level Inverted Index for all columns: Aids in quickly locating the rows that contain the data matching search/filter criteria within a row group(Data Blocks).</p></li>
- <li><p>Dictionary Encoding: Most databases and big data SQL data stores employ columnar encoding to achieve data compression by storing small integers numbers (surrogate value) instead of full string values. However, almost all existing databases and data stores divide the data into row groups containing anywhere from few thousand to a million rows and employ dictionary encoding only within each row group. Hence, the same column value can have different surrogate values in different row groups. So, while reading the data, conversion from surrogate value to actual value needs to be done immediately after the data is read from the disk. But CarbonData employs global surrogate key which means that a common dictionary is maintained for the full store on one machine/node. So CarbonData can perform all the query processing work such as grouping/aggregation, sorting etc on light weight surrogate values. The conversion from surrogate to actual values needs to be done only on the final res
ult. This procedure improves performance on two aspects. Conversion from surrogate values to actual values is done only for the final result rows which are much less than the actual rows read from the store. All query processing and computation such as grouping/aggregation, sorting, and so on is done on lightweight surrogate values which requires less memory and CPU time compared to actual values.</p></li>
- <li><p>Deep Spark Integration: It has built-in spark integration for Spark 1.5, 1.6 and interfaces for Spark SQL, DataFrame API and query optimization. It supports bulk data ingestion and allows saving of spark dataframes as CarbonData files.</p></li>
- <li><p>Update Delete Support: It supports batch updates like daily update scenarios for OLAP and Base+Delta file based design.</p></li>
<li><p>Store data along with index: Significantly accelerates query performance and reduces the I/O scans and CPU resources, when there are filters in the query. CarbonData index consists of multiple levels of indices. A processing framework can leverage this index to reduce the task it needs to schedule and process. It can also do skip scan in more finer grain units (called blocklet) in task side scanning instead of scanning the whole file.</p></li>
<li><p>Operable encoded data: It supports efficient compression and global encoding schemes and can query on compressed/encoded data. The data can be converted just before returning the results to the users, which is "late materialized".</p></li>
<li><p>Column group: Allows multiple columns to form a column group that would be stored as row format. This reduces the row reconstruction cost at query time.</p></li>
<li><p>Support for various use cases with one single Data format: Examples are interactive OLAP-style query, Sequential Access (big scan) and Random Access (narrow scan).</p></li>
</ul>
-<div id="data-types"></div>
-
-<h2>Data Types</h2><h4>CarbonData supports the following data types:</h4>
-<ul>
- <li>Numeric Types</li>
- <li>SMALLINT</li>
- <li>INT/INTEGER</li>
- <li>BIGINT</li>
- <li>DOUBLE</li>
- <li>DECIMAL</li>
- <li><p>Date/Time Types</p></li>
- <li>TIMESTAMP</li>
- <li><p>String Types</p></li>
- <li>STRING</li>
- <li><p>Complex Types</p>
- <ul>
- <li>arrays: ARRAY<code><data_type></code></li>
- <li>structs: STRUCT<code><col_name : data_type COMMENT col_comment, ...></code></li>
- </ul></li>
-</ul>
-<div id="interfaces"></div>
-<h2>Interfaces</h2><h4>API</h4><p>CarbonData can be used in following scenarios:</p>
-<ul>
- <li>For MapReduce application user</li>
-</ul><p>This User API is provided by carbon-hadoop. In this scenario, user can process CarbonData files in his MapReduce application by choosing CarbonInput/OutputFormat, and is responsible for using it correctly. Currently only CarbonInputFormat is provided and OutputFormat will be provided soon.</p>
-<ul>
- <li>For Spark user</li>
-</ul><p>This User API is provided by Spark itself. There are two levels of APIs</p>
-<ul>
- <li><p><strong>CarbonData File</strong></p><p>Similar to parquet, json, or other data source in Spark, CarbonData can be used with data source API. For example (please refer to DataFrameAPIExample for more detail):</p></li>
-</ul><p>``` // User can create a DataFrame from any data source // or transformation. val df = ...</p>
-<pre><code> // Write data
- // User can write a DataFrame to a CarbonData file
- df.write
- .format("carbondata")
- .option("tableName", "carbontable")
- .mode(SaveMode.Overwrite)
- .save()
-
-
- // read CarbonData by data source API
- df = carbonContext.read
- .format("carbondata")
- .option("tableName", "carbontable")
- .load("/path")
-
- // User can then use DataFrame for analysis
- df.count
- SVMWithSGD.train(df, numIterations)
-
- // User can also register the DataFrame with a table name,
- // and use SQL for analysis
- df.registerTempTable("t1") // register temporary table
- // in SparkSQL catalog
- df.registerHiveTable("t2") // Or, use a implicit funtion
- // to register to Hive metastore
- sqlContext.sql("select count(*) from t1").show
-</code></pre><p>```</p>
-<ul>
- <li><p><strong>Managed CarbonData Table</strong></p><p>CarbonData has in built support for high level concept like Table, Database, and supports full data lifecycle management, instead of dealing with just files user can use CarbonData specific DDL to manipulate data in Table and Database level. Please refer <a href="https://github.com/HuaweiBigData/carbondata/wiki/Language-Manual:-DDL">DDL</a> and <a href="https://github.com/HuaweiBigData/carbondata/wiki/Language-Manual:-DML">DML</a>.</p></li>
-</ul><p><code>
- // Use SQL to manage table and query data
- create database db1;
- use database db1;
- show databases;
- create table tbl1 using org.apache.carbondata.spark;
- load data into table tlb1 path 'some_files';
- select count(*) from tbl1;
-</code></p>
-<ul>
- <li><p>For developer who want to integrate CarbonData into processing engines like spark, hive or flink, use API provided by carbon-hadoop and carbon-processing:</p>
- <ul>
- <li><strong>Query</strong> : Integrate carbon-hadoop with engine specific API, like spark data source API.</li>
- </ul>
- <ul>
- <li><strong>Data life cycle management</strong> : CarbonData provides utility functions in carbon-processing to manage data life cycle, like data loading, compact, retention, schema evolution. Developer can implement DDLs of their choice and leverage these utility function to do data life cycle management.</li>
- </ul></li>
-</ul>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/quick-start-guide.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/quick-start-guide.html b/src/main/webapp/docs/latest/quick-start-guide.html
index f17cf13..8402e55 100644
--- a/src/main/webapp/docs/latest/quick-start-guide.html
+++ b/src/main/webapp/docs/latest/quick-start-guide.html
@@ -15,89 +15,78 @@
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
---><h1>Quick Start</h1><p>This tutorial provides a quick introduction to using CarbonData.</p><h2>Getting started with Apache CarbonData</h2>
+--><h1>Quick Start</h1><p>This tutorial provides a quick introduction to using CarbonData.</p><h2>
+ Prerequisites</h2>
<ul>
- <li><a href="#installation">Installation</a></li>
- <li><a href="#prerequisites">Prerequisites</a></li>
- <li><a href="#interactive-analysis-with-spark-shell">Interactive Analysis with Spark Shell Version 2.1</a></li>
- <li>Basics</li>
- <li>Executing Queries
- <ul>
- <li>Creating a Table</li>
- <li>Loading Data to a Table</li>
- <li>Query Data from a Table</li>
- </ul></li>
- <li>Interactive Analysis with Spark Shell Version 1.6</li>
- <li>Basics</li>
- <li>Executing Queries
- <ul>
- <li>Creating a Table</li>
- <li>Loading Data to a Table</li>
- <li>Query Data from a Table</li>
- </ul></li>
- <li><a href="#building-carbondata">Building CarbonData</a></li>
-
-</ul>
-<div id="installation"></div>
-<h2>Installation</h2>
-<ul>
- <li>Download a released package of <a href="http://spark.apache.org/downloads.html">Spark 1.6.2 or 2.1.0</a>.</li>
- <li>Download and install <a href="http://thrift-tutorial.readthedocs.io/en/latest/installation.html">Apache Thrift 0.9.3</a>, make sure Thrift is added to system path.</li>
- <li>Download <a href="https://github.com/apache/incubator-carbondata">Apache CarbonData code</a> and build it. Please visit <a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Building+CarbonData+And+IDE+Configuration">Building CarbonData And IDE Configuration</a> for more information.</li>
-</ul>
-<div id="prerequisites"></div>
-<h2>Prerequisites</h2>
-<ul>
- <li>Create a sample.csv file using the following commands. The CSV file is required for loading data into CarbonData.</li>
+ <li><a href="https://github.com/apache/incubator-carbondata/blob/master/build" target="_blank">Installation and
+ building CarbonData</a>.
+ </li>
+ <li>Create a sample.csv file using the following commands. The CSV file is required for loading
+ data into CarbonData.
+ </li>
</ul><p><code>
-$ cd carbondata
-$ cat > sample.csv << EOF
- id,name,city,age
- 1,david,shenzhen,31
- 2,eason,shenzhen,27
- 3,jarry,wuhan,35
- EOF
-</code></p>
-<div id="interactive-analysis-with-spark-shell"></div>
-<h2>Interactive Analysis with Spark Shell</h2><h2>Version 2.1</h2><p>Apache Spark Shell provides a simple way to learn the API, as well as a powerful tool to analyze data interactively. Please visit <a href="http://spark.apache.org/docs/latest/">Apache Spark Documentation</a> for more details on Spark shell.</p><h4>Basics</h4><p>Start Spark shell by running the following command in the Spark directory:</p><p><code>
-./bin/spark-shell --jars <carbondata jar path>
-</code></p><p>In this shell, SparkSession is readily available as 'spark' and Spark context is readily available as 'sc'.</p><p>In order to create a CarbonSession we will have to configure it explicitly in the following manner :</p>
+ cd carbondata
+ cat > sample.csv << EOF
+ id,name,city,age
+ 1,david,shenzhen,31
+ 2,eason,shenzhen,27
+ 3,jarry,wuhan,35
+ EOF
+</code></p><h2>Interactive Analysis with Spark Shell Version 2.1</h2><p>Apache Spark Shell provides
+ a simple way to learn the API, as well as a powerful tool to analyze data interactively. Please
+ visit <a href="http://spark.apache.org/docs/latest/" target="_blank">Apache Spark Documentation</a> for more
+ details on Spark shell.</p><h4>Basics</h4><p>Start Spark shell by running the following command
+ in the Spark directory:</p><p><code>
+ ./bin/spark-shell --jars <carbondata assembly jar path>
+</code></p><p>In this shell, SparkSession is readily available as 'spark' and Spark context is
+ readily available as 'sc'.</p><p>In order to create a CarbonSession we will have to configure it
+ explicitly in the following manner :</p>
<ul>
- <li>Import the following :</li>
+ <li>Import the following :</li>
</ul><p><code>
-import org.apache.spark.sql.SparkSession
-import org.apache.spark.sql.CarbonSession._
+ import org.apache.spark.sql.SparkSession
+ import org.apache.spark.sql.CarbonSession._
</code></p>
<ul>
- <li>Create a CarbonSession :</li>
+ <li>Create a CarbonSession :</li>
</ul><p><code>
-val carbon = SparkSession.builder().config(sc.getConf).getOrCreateCarbonSession()
+ val carbon = SparkSession.builder().config(sc.getConf).getOrCreateCarbonSession()
</code></p><h4>Executing Queries</h4><h5>Creating a Table</h5><p><code>
-scala>carbon.sql("create table if not exists test_table
- (id string, name string, city string, age Int)
- STORED BY 'carbondata'")
+ scala>carbon.sql("CREATE TABLE IF NOT EXISTS test_table(id string, name string, city
+ string, age Int) STORED BY 'carbondata'")
</code></p><h5>Loading Data to a Table</h5><p><code>
-scala>carbon.sql(s"load data inpath '${new java.io.File("../carbondata/sample.csv").getCanonicalPath}' into table test_table")
-</code></p><h6>Query Data from a Table</h6><p>``` scala>spark.sql("select * from test_table").show</p><p>scala>spark.sql("select city, avg(age), sum(age) from test_table group by city").show ```</p><h2>Interactive Analysis with Spark Shell</h2><h2>Version 1.6</h2><h4>Basics</h4><p>Start Spark shell by running the following command in the Spark directory:</p><p><code>
-./bin/spark-shell --jars <carbondata jar path>
+ scala>carbon.sql("LOAD DATA INPATH 'sample.csv file path' INTO TABLE test_table")
+</code> NOTE:Please provide the real file path of sample.csv for the above script.</p><h6>Query Data
+ from a Table</h6><p><code>scala>carbon.sql("SELECT * FROM test_table").show()</code></p><p><code>scala>carbon.sql("SELECT
+ city, avg(age), sum(age) FROM test_table GROUP BY city").show()</code></p>
+<h2>Interactive Analysis with Spark Shell Version 1.6</h2>
+<h4>Basics</h4><p>Start Spark shell by running the following
+ command in the Spark directory:</p><p><code>
+ ./bin/spark-shell --jars <carbondata assembly jar path>
</code></p><p>NOTE: In this shell, SparkContext is readily available as sc.</p>
<ul>
- <li>In order to execute the Queries we need to import CarbonContext:</li>
+ <li>In order to execute the Queries we need to import CarbonContext:</li>
</ul><p><code>
-import org.apache.spark.sql.CarbonContext
+ import org.apache.spark.sql.CarbonContext
</code></p>
<ul>
- <li>Create an instance of CarbonContext in the following manner :</li>
+ <li>Create an instance of CarbonContext in the following manner :</li>
</ul><p><code>
-val cc = new CarbonContext(sc)
-</code></p><p>NOTE: By default store location is pointed to "../carbon.store", user can provide own store location to CarbonContext like new CarbonContext(sc, storeLocation).</p><h4>Executing Queries</h4><h5>Creating a Table</h5><p><code>
-scala>cc.sql("create table if not exists test_table (id string, name string, city string, age Int) STORED BY 'carbondata'")
-</code> To see the table created :</p><p><code>
-scala>cc.sql("show tables").show
+ val cc = new CarbonContext(sc)
+</code></p><p>NOTE: By default store location is pointed to "../carbon.store", user can provide own
+ store location to CarbonContext like new CarbonContext(sc, storeLocation).</p><h4>Executing
+ Queries</h4>
+<h5>Creating a Table</h5><p><code>
+ scala>cc.sql("CREATE TABLE IF NOT EXISTS test_table (id string, name string, city
+ string, age Int) STORED BY 'carbondata'")
+</code>
+</p>To see the table created :<p><code>
+ scala>cc.sql("SHOW TABLES").show()
</code></p><h5>Loading Data to a Table</h5><p><code>
-scala>cc.sql(s"load data inpath '${new java.io.File("../carbondata/sample.csv").getCanonicalPath}' into table test_table")
-</code></p><h5>Query Data from a Table</h5><p><code>
-scala>cc.sql("select * from test_table").show
-scala>cc.sql("select city, avg(age), sum(age) from test_table group by city").show
- <div id="building-carbondata"></div>
-</code></p><h2>Building CarbonData</h2><p>To get started, get CarbonData from the <a href="http://carbondata.incubator.apache.org/">downloads</a> section on the <a href="http://carbondata.incubator.apache.org.">http://carbondata.incubator.apache.org.</a> CarbonData uses Hadoop?s client libraries for HDFS and YARN and Spark's libraries. Downloads are pre-packaged for a handful of popular Spark versions.</p><p>If you?d like to build CarbonData from source, visit <a href="https://cwiki.apache.org/confluence/display/CARBONDATA/Building+CarbonData+And+IDE+Configuration">Building CarbonData And IDE Configuration</a>.</p>
\ No newline at end of file
+ scala>cc.sql("LOAD DATA INPATH 'sample.csv file path' INTO TABLE test_table")
+</code><br/>
+<p>NOTE:Please provide the real file path of sample.csv for the above script.</p><h5>Query
+ Data from a Table</h5><p><code>
+ scala>cc.sql("SELECT * FROM test_table").show()
+ scala>cc.sql("SELECT city, avg(age), sum(age) FROM test_table GROUP BY city").show()
+</code></p>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/supported-data-types-in-carbondata.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/supported-data-types-in-carbondata.html b/src/main/webapp/docs/latest/supported-data-types-in-carbondata.html
new file mode 100644
index 0000000..da7efb4
--- /dev/null
+++ b/src/main/webapp/docs/latest/supported-data-types-in-carbondata.html
@@ -0,0 +1,25 @@
+<h1>Data Types</h1><h4>CarbonData supports the following data types:</h4>
+<ul>
+ Numeric Types
+ <li>SMALLINT</li>
+ <li>INT/INTEGER</li>
+ <li>BIGINT</li>
+ <li>DOUBLE</li>
+ <li>DECIMAL</li>
+</ul>
+<ul>
+ Date/Time Types
+ <li>DATE</li>
+ <li>TIMESTAMP</li>
+</ul>
+
+<ul>
+ String Types
+ <li>STRING</li>
+</ul>
+<ul>
+ Complex Types
+ <li>arrays: ARRAY<code><data_type></code></li>
+ <li>structs: STRUCT<code><col_name : data_type COMMENT col_comment, ...></code></li>
+</ul>
+
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/table-of-content.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/table-of-content.html b/src/main/webapp/docs/latest/table-of-content.html
deleted file mode 100644
index e87c649..0000000
--- a/src/main/webapp/docs/latest/table-of-content.html
+++ /dev/null
@@ -1,60 +0,0 @@
-<!DOCTYPE html><html><head><meta charset="utf-8"><title>Untitled Document.md</title><style>
-
-</style></head><body id="preview">
-
-<h1><a id="Table_of_Contents_1"></a>Table of Contents</h1>
-<ul>
-<li><a href="#" id="quick-start-guide">Quick Start</a>
-<ul>
-<li><a href="mainpage.html#getting-started-with-carbondata" id="getting_started">Getting started with Apache CarbonData</a></li>
-</ul>
-</li>
-<li><a href="#" id="user-guide-toc">User Guide</a>
-<ul>
-<li><a href="#" id="overview-of-carbondata">Overview</a>
-<ul>
-<li><a href="mainpage.html#Introduction_11" id="introduction">Introduction</a></li>
-<li><a href="mainpage.html#file-format" id="file_format">CarbonData File Structure</a></li>
-<li><a href="mainpage.html#Features_40" id="features">Features</a></li>
-<li><a href="mainpage.html#data-types" id="data_types">Data Types</a></li>
-<li><a href="mainpage.html#packaging-interfaces" id="interfaces">Interfaces</a></li>
-</ul>
-</li>
-<li><a href="#" id="installation-guide">Installation Guide</a>
-<ul>
-<li><a href="mainpage.html#spark-cluster" id="spark_cluster">Installing and Configuring CarbonData on Standalone Spark Cluster</a></li>
-<li><a href="mainpage.html#yarn-cluster" id="yarn_cluster">Installing and Configuring CarbonData on \u201cSpark on YARN\u201d Cluster</a></li>
-</ul>
-</li>
-<li><a href="#" id="configuration-parameters">Configuring CarbonData</a>
-<ul>
-<li><a href="mainpage.html#system-configuration" id="system_configuration">System Configuration</a></li>
-<li><a href="mainpage.html#performance-configuration" id="performance_configuration">Performance Configuration</a></li>
-<li><a href="mainpage.html#miscellaneous-configuration" id="miscellaneous_configuration"> Miscellaneous Configuration</a></li>
-<li><a href="mainpage.html#spark-configuration" id="spark_configuration">Spark Configuration</a></li>
-</ul>
-</li>
-<li><a href="#" id="using-carbondata">Using CarbonData</a>
-<ul>
-<li><a href="#" id="data-management">Data Management</a></li>
-<li><a href="#" id="ddl-operation-on-carbondata">DDL Operations on CarbonData</a></li>
-<li><a href="#" id="dml-operation-on-carbondata">DML Operations on CarbonData</a></li>
-</ul>
-</li>
-</ul>
-</li>
-<li><a href="#" id="useful-tips-on-carbondata">Useful Tips</a>
-<ul>
-<li><a href="mainpage.html#suggestions-to-create-carbondata-tables" id="suggestion_create">Suggestion to create CarbonData Table</a></li>
-<li><a href="mainpage.html#configurations-for-optimizing-carbondata-performance" id="configurations_optimizing">Configurations for Optimizing CarbonData Performance</a></li>
-</ul>
-</li>
-<li><a href="#" id="use-cases-of-carbondata">CarbonData Use Cases</a></li>
-<li><a href="#" id="troubleshooting">Troubleshooting</a></li>
-<li><a href="#" id="faq">FAQs</a></li>
-</ul>
-
-
-<script src="../../js/mdNavigation.js"></script>
-
-</body></html>
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/troubleshooting.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/troubleshooting.html b/src/main/webapp/docs/latest/troubleshooting.html
index 995e0f0..a3fb1a5 100644
--- a/src/main/webapp/docs/latest/troubleshooting.html
+++ b/src/main/webapp/docs/latest/troubleshooting.html
@@ -15,8 +15,116 @@
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
---><h1>Troubleshooting</h1><p>This tutorial is designed to provide troubleshooting for end users and developers who are building, deploying, and using CarbonData.</p><h3>General Prevention and Best Practices</h3>
-<ul>
- <li><p>When trying to create a table with a single numeric column, table creation fails: One column that can be considered as dimension is mandatory for table creation.</p></li>
- <li><p>"Files locked for updation" when same table is accessed from two or more instances: Remove metastore_db from the examples folder.</p></li>
-</ul>
\ No newline at end of file
+--><h1>Troubleshooting</h1><p>This tutorial is designed to provide troubleshooting for end users and
+ developers who are building, deploying, and using CarbonData.</p><h2>Failed to load thrift
+ libraries</h2><p><strong>Symptom</strong></p><p>Thrift throws following exception :</p><p><code>
+ thrift: error while loading shared libraries:
+ libthriftc.so.0: cannot open shared object file: No such file or directory
+</code></p><p><strong>Possible Cause</strong></p><p>The complete path to the directory containing
+ the libraries is not configured correctly.</p><p><strong>Procedure</strong></p><p>Follow the
+ steps below to ensure loading of libraries appropriately :</p>
+<ol>
+ <li><p>For ubuntu you have to add a custom.conf file to /etc/ld.so.conf.d For example,</p>
+ <p><code>
+ sudo gedit /etc/ld.so.conf.d/randomLibs.conf
+ </code></p>
+ <p>Inside this file you are supposed to configure the complete path to the directory that
+ contains all the libraries that you wish to add to the system, let us say
+ /home/ubuntu/localLibs</p></li>
+ <li><p>To ensure your library location ,check for existence of libthrift.so</p></li>
+ <li><p>Save and run the following command to update the system with this libs.</p>
+ <p><code>
+ sudo ldconfig
+ </code></p>
+ <p>Note : Remember to add only the path to the directory, not the full path for that file,
+ all the libraries inside that path will be automatically indexed.</p></li>
+</ol><h2>Failed to launch the Spark Shell</h2><p><strong>Symptom</strong></p><p>The shell prompts
+ the following error :</p><p><code>
+ org.apache.spark.sql.CarbonContext$$anon$$apache$spark$sql$catalyst$analysis
+ $OverrideCatalog$_setter_$org$apache$spark$sql$catalyst$analysis
+ $OverrideCatalog$$overrides_$e
+</code></p><p><strong>Possible Cause</strong></p><p>The Spark Version and the selected Spark Profile
+ do not match.</p><p><strong>Procedure</strong></p>
+<ol>
+ <li><p>Ensure your spark version and selected profile for spark are correct.</p></li>
+ <li><p>Use the following command :</p>
+ <p><code>
+ "mvn -Pspark-2.1 -Dspark.version {yourSparkVersion} clean package"
+ </code></p>
+ <p>Note : Refrain from using "mvn clean package" without specifying the profile.</p></li>
+</ol><h2>Failed to execute load query on cluster.</h2><p><strong>Symptom</strong></p><p>Load query
+ failed with the following exception:</p><p><code>
+ Dictionary file is locked for updation.
+</code></p><p><strong>Possible Cause</strong></p><p>The carbon.properties file is not identical in
+ all the nodes of the cluster.</p><p><strong>Procedure</strong></p><p>Follow the steps to ensure
+ the carbon.properties file is consistent across all the nodes:</p>
+<ol>
+ <li><p>Copy the carbon.properties file from the master node to all the other nodes in the
+ cluster. For example, you can use ssh to copy this file to all the nodes.</p></li>
+ <li><p>For the changes to take effect, restart the Spark cluster.</p></li>
+</ol><h2>Failed to execute insert query on cluster.</h2><p><strong>Symptom</strong></p><p>Load query
+ failed with the following exception:</p><p><code>
+ Dictionary file is locked for updation.
+</code></p><p><strong>Possible Cause</strong></p><p>The carbon.properties file is not identical in
+ all the nodes of the cluster.</p><p><strong>Procedure</strong></p><p>Follow the steps to ensure
+ the carbon.properties file is consistent across all the nodes:</p>
+<ol>
+ <li><p>Copy the carbon.properties file from the master node to all the other nodes in the
+ cluster. For example, you can use scp to copy this file to all the nodes.</p></li>
+ <li><p>For the changes to take effect, restart the Spark cluster.</p></li>
+</ol><h2>Failed to connect to hiveuser with thrift</h2><p><strong>Symptom</strong></p><p>We get the
+ following exception :</p><p><code>
+ Cannot connect to hiveuser.
+</code></p><p><strong>Possible Cause</strong></p><p>The external process does not have permission to
+ access.</p><p><strong>Procedure</strong></p><p>Ensure that the Hiveuser in mysql must allow its
+ access to the external processes.</p><h2>Failure to read the metastore db during table
+ creation.</h2><p><strong>Symptom</strong></p><p>We get the following exception on trying to
+ connect :</p><p><code>
+ Cannot read the metastore db
+</code></p><p><strong>Possible Cause</strong></p><p>The metastore db is dysfunctional.</p><p>
+ <strong>Procedure</strong></p><p>Remove the metastore db from the carbon.metastore in the Spark
+ Directory.</p><h2>Failed to load data on the cluster</h2><p><strong>Symptom</strong></p><p>Data
+ loading fails with the following exception :</p><p><code>
+ Data Load failure exeception
+</code></p><p><strong>Possible Cause</strong></p><p>The following issue can cause the failure :</p>
+<ol>
+ <li><p>The core-site.xml, hive-site.xml, yarn-site and carbon.properties are not consistent
+ across all nodes of the cluster.</p></li>
+ <li><p>Path to hdfs ddl is not configured correctly in the carbon.properties.</p></li>
+</ol><p><strong>Procedure</strong></p><p>Follow the steps to ensure the following configuration
+ files are consistent across all the nodes:</p>
+<ol>
+ <li><p>Copy the core-site.xml, hive-site.xml, yarn-site,carbon.properties files from the master
+ node to all the other nodes in the cluster. For example, you can use scp to copy this file
+ to all the nodes.</p>
+ <p>Note : Set the path to hdfs ddl in carbon.properties in the master node.</p></li>
+ <li><p>For the changes to take effect, restart the Spark cluster.</p></li>
+</ol><h2>Failed to insert data on the cluster</h2><p><strong>Symptom</strong></p><p>Insertion fails
+ with the following exception :</p><p><code>
+ Data Load failure exeception
+</code></p><p><strong>Possible Cause</strong></p><p>The following issue can cause the failure :</p>
+<ol>
+ <li><p>The core-site.xml, hive-site.xml, yarn-site and carbon.properties are not consistent
+ across all nodes of the cluster.</p></li>
+ <li><p>Path to hdfs ddl is not configured correctly in the carbon.properties.</p></li>
+</ol><p><strong>Procedure</strong></p><p>Follow the steps to ensure the following configuration
+ files are consistent across all the nodes:</p>
+<ol>
+ <li><p>Copy the core-site.xml, hive-site.xml, yarn-site,carbon.properties files from the master
+ node to all the other nodes in the cluster. For example, you can use scp to copy this file
+ to all the nodes.</p>
+ <p>Note : Set the path to hdfs ddl in carbon.properties in the master node.</p></li>
+ <li><p>For the changes to take effect, restart the Spark cluster.</p></li>
+</ol><h2>Failed to execute Concurrent Operations(Load,Insert,Update) on table by multiple
+ workers.</h2><p><strong>Symptom</strong></p><p>Execution fails with the following exception
+ :</p><p><code>
+ Table is locked for updation.
+</code></p><p><strong>Possible Cause</strong></p><p>Concurrency not supported.</p><p><strong>Procedure</strong>
+</p><p>Worker must wait for the query execution to complete and the table to release the lock for
+ another query execution to succeed..</p><h2>Failed to create a table with a single numeric
+ column.</h2><p><strong>Symptom</strong></p><p>Execution fails with the following exception :</p>
+<p><code>
+ Table creation fails.
+</code></p><p><strong>Possible Cause</strong></p><p>Behavior not supported.</p><p>
+ <strong>Procedure</strong></p><p>A single column that can be considered as dimension is
+ mandatory for table creation.</p>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/use-cases-of-carbondata.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/use-cases-of-carbondata.html b/src/main/webapp/docs/latest/use-cases-of-carbondata.html
deleted file mode 100644
index 62659d3..0000000
--- a/src/main/webapp/docs/latest/use-cases-of-carbondata.html
+++ /dev/null
@@ -1,49 +0,0 @@
-<!--
- Licensed to the Apache Software Foundation (ASF) under one
- or more contributor license agreements. See the NOTICE file
- distributed with this work for additional information
- regarding copyright ownership. The ASF licenses this file
- to you under the Apache License, Version 2.0 (the
- "License"); you may not use this file except in compliance
- with the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing,
- software distributed under the License is distributed on an
- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- KIND, either express or implied. See the License for the
- specific language governing permissions and limitations
- under the License.
---><h1>CarbonData Use Cases</h1><p>This tutorial discusses about the problems that CarbonData addresses. It shall take you through the identified top use cases of CarbonData.</p><h2>Introduction</h2><p>For big data interactive analysis scenarios, many customers expect sub-second response to query TB-PB level data on general hardware clusters with just a few nodes.</p><p>In the current big data ecosystem, there are few columnar storage formats such as ORC and Parquet that are designed for SQL on Big Data. Apache Hive?s ORC format is a columnar storage format with basic indexing capability. However, ORC cannot meet the sub-second query response expectation on TB level data, as it performs only stride level dictionary encoding and all analytical operations such as filtering and aggregation is done on the actual data. Apache Parquet is a columnar storage format that can improve performance in comparison to ORC due to its more efficient storage organization. Though Parquet can provide qu
ery response on TB level data in a few seconds, it is still far from the sub-second expectation of interactive analysis users. Cloudera Kudu can effectively solve some query performance issues, but kudu is not hadoop native, can?t seamlessly integrate historic HDFS data into new kudu system.</p><p>However, CarbonData uses specially engineered optimizations targeted to improve performance of analytical queries which can include filters, aggregation and distinct counts, the required data to be stored in an indexed, well organized, read-optimized format, CarbonData?s query performance can achieve sub-second response.</p><h2>Motivation: Single Format to provide Low Latency Response for all Use Cases</h2><p>The main motivation behind CarbonData is to provide a single storage format for all the usecases of querying big data on Hadoop. Thus CarbonData is able to cover all use-cases into a single storage format.</p><p><img src="../../../webapp/docs/latest/images/carbon_data_motivation.png?r
aw=true" alt="Motivation" /></p><h2>Use Cases</h2><h3>Sequential Access</h3>
-<ul>
- <li>Supports queries that select only a few columns with a group by clause but do not contain any filters. This results in full scan over the complete store for the selected columns.</li>
-</ul><p><img src="../../../webapp/docs/latest/images/carbon_data_full_scan.png?raw=true" alt="Sequential_Scan" /></p><p><strong>Scenario</strong></p>
-<ul>
- <li>ETL jobs</li>
- <li>Log Analysis</li>
-</ul><h3>Random Access</h3>
-<ul>
- <li>Supports Point Query. These are queries used from operational applications and usually select all or most of the columns and involves a large number of filters which reduce the result to a small size. Such queries generally do not involve any aggregation or group by clause.
- <ul>
- <li>Row-key query(like HBase)</li>
- <li>Narrow Scan</li>
- <li>Requires second/sub-second level low latency</li>
- </ul></li>
-</ul><p><img src="../../../webapp/docs/latest/images/carbon_data_random_scan.png?raw=true" alt="random_access" /></p><p><strong>Scenario</strong></p>
-<ul>
- <li>Operational Query</li>
- <li>User Profiling</li>
-</ul><h3>Olap Style Query</h3>
-<ul>
- <li>Supports Interactive data analysis for any dimensions. These are queries which are typically fired from Interactive Analysis tools. Such queries often select a few columns and involves filters and group by on a column or a grouping expression. It also supports queries that :
- <ul>
- <li>Involves aggregation/join</li>
- <li>Roll-up,Drill-down,Slicing and Dicing</li>
- <li>Low-latency ad-hoc query</li>
- </ul></li>
-</ul><p><img src="../../../webapp/docs/latest/images/carbon_data_olap_scan.png?raw=true" alt="Olap_style_query" /></p><p><strong>Scenario</strong></p>
-<ul>
- <li>Dash-board reporting</li>
- <li>Fraud & Ad-hoc Analysis</li>
-</ul>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-carbondata-site/blob/0d4cdb1c/src/main/webapp/docs/latest/useful-tips-on-carbondata.html
----------------------------------------------------------------------
diff --git a/src/main/webapp/docs/latest/useful-tips-on-carbondata.html b/src/main/webapp/docs/latest/useful-tips-on-carbondata.html
index 73c6e0d..f4f9cc0 100644
--- a/src/main/webapp/docs/latest/useful-tips-on-carbondata.html
+++ b/src/main/webapp/docs/latest/useful-tips-on-carbondata.html
@@ -17,9 +17,9 @@
under the License.
--><h1>Useful Tips</h1><p>This tutorial guides you to create CarbonData Tables and optimize performance. The following sections will elaborate on the above topics :</p>
<ul>
- <li><a href="#suggestions-to-create-carbondata-table">Suggestions to create CarbonData Table</a></li>
- <li><a href="#configurations-for-optimizing-carbondata-performance">Configurations For Optimizing CarbonData Performance</a></li>
-</ul><h2>Suggestions to Create CarbonData Table</h2><p>Recently CarbonData was used to analyze performance of Telecommunication field. The results of the analysis for table creation with dimensions ranging from 10 thousand to 10 billion rows and 100 to 300 columns have been summarized below. </p><p>The following table describes some of the columns from the table used.</p><p><strong>Table Column Description</strong></p>
+ <li><a href="#carbondata-table">Suggestions to create CarbonData Table</a></li>
+ <li><a href="#carbondata-performance">Configurations For Optimizing CarbonData Performance</a></li>
+</ul><h2 id="carbondata-table">Suggestions to Create CarbonData Table</h2><p>Recently CarbonData was used to analyze performance of Telecommunication field. The results of the analysis for table creation with dimensions ranging from 10 thousand to 10 billion rows and 100 to 300 columns have been summarized below. </p><p>The following table describes some of the columns from the table used.</p><p><strong>Table Column Description</strong></p>
<table class="table table-striped table-bordered">
<thead>
<tr>
@@ -143,7 +143,8 @@
</code></p>
<ul>
<li><strong>Avoid adding high cardinality columns to dictionary</strong></li>
-</ul><p>If the system has low memory configuration, then it is suggested to exclude high cardinality columns from the dictionary to enhance load performance. Creation of dictionary for high cardinality columns at time of load will degrade load performance due to excessive memory usage. </p><p>By default CarbonData determines the cardinality at the first data load and allows for dictionary creation only if the cardinality is less than 1 million.</p><h2>Configurations for Optimizing CarbonData Performance</h2><p>Recently we did some performance POC on CarbonData for Finance and telecommunication Field. It involved detailed queries and aggregation scenarios. After the completion of POC, some of the configurations impacting the performance have been identified and tabulated below :</p>
+</ul><p>If the system has low memory configuration, then it is suggested to exclude high cardinality columns from the dictionary to enhance load performance. Creation of dictionary for high cardinality columns at time of load will degrade load performance due to excessive memory usage. </p><p>By default CarbonData determines the cardinality at the first data load and allows for dictionary creation only if the cardinality is less than 1 million.</p>
+<h2 id="carbondata-performance">Configurations for Optimizing CarbonData Performance</h2><p>Recently we did some performance POC on CarbonData for Finance and telecommunication Field. It involved detailed queries and aggregation scenarios. After the completion of POC, some of the configurations impacting the performance have been identified and tabulated below :</p>
<table class="table table-striped table-bordered">
<thead>
<tr>