This is an automated email from the ASF dual-hosted git repository.

sunithabeeram pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-pinot.git


The following commit(s) were added to refs/heads/master by this push:
     new 205ec50  Update managing pinot doc (#3991)
205ec50 is described below

commit 205ec5059cdf07dffc44355660642412bdbf3db5
Author: Jialiang Li <j...@linkedin.com>
AuthorDate: Wed Mar 20 11:09:24 2019 -0700

    Update managing pinot doc (#3991)
---
 docs/management_api.rst | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/docs/management_api.rst b/docs/management_api.rst
index e3f3c9d..9468bd1 100644
--- a/docs/management_api.rst
+++ b/docs/management_api.rst
@@ -26,7 +26,7 @@ Pinot Management Console
 ------------------------
 
 There is a REST API which allows management of tables, tenants, segments and 
schemas. It can be accessed by going to
-``http://[controller host]/help`` which offers a web UI to do these tasks, as 
well as document the REST API. The below
+``http://[controller_host]/help`` which offers a web UI to do these tasks, as 
well as document the REST API. The below
 is the screenshot of the console.
 
   .. figure:: img/pinot-console.png
@@ -43,17 +43,16 @@ To rebalance segments of a table across servers:
 pinot-admin.sh
 --------------
 
-It can be used instead of the ``pinot-admin.sh`` commands to automate the 
creation of tables and tenants. The script
-can be generated by running ``mvn install package -DskipTests -Pbin-dist`` in 
the directory
-in which you checked out Pinot.
+``pinot-admin.sh`` is another way of managing Pinot cluster. This script can 
be generated by running
+``mvn install package -DskipTests -Pbin-dist`` in the directory in which you 
checked out Pinot.
 
 For example, to create a pinot segment:
 
 .. code-block:: none
 
-  $ 
./pinot-distribution/target/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/bin/pinot-admin.sh
 CreateSegment -dataDir /Users/jlli/Desktop/test/ -format CSV -outDir 
/Users/jlli/Desktop/test2/ -tableName baseballStats -segmentName 
baseballStats_data -overwrite -schemaFile 
./pinot-distribution/target/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/sample_data/baseballStats_schema.json
-  Executing command: CreateSegment  -generatorConfigFile null -dataDir 
/Users/jlli/Desktop/test/ -format CSV -outDir /Users/jlli/Desktop/test2/ 
-overwrite true -tableName baseballStats -segmentName baseballStats_data 
-timeColumnName null -schemaFile 
./pinot-distribution/target/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/sample_data/baseballStats_schema.json
 -readerConfigFile null -enableStarTreeIndex false -starTreeIndexSpecFile null 
-hllSize 9 - [...]
-  Accepted files: [/Users/jlli/Desktop/test/baseballStats_data.csv]
+  $ 
./pinot-distribution/target/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/bin/pinot-admin.sh
 CreateSegment -dataDir /Users/host1/Desktop/test/ -format CSV -outDir 
/Users/host1/Desktop/test2/ -tableName baseballStats -segmentName 
baseballStats_data -overwrite -schemaFile 
./pinot-distribution/target/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/sample_data/baseballStats_schema.json
+  Executing command: CreateSegment  -generatorConfigFile null -dataDir 
/Users/host1/Desktop/test/ -format CSV -outDir /Users/host1/Desktop/test2/ 
-overwrite true -tableName baseballStats -segmentName baseballStats_data 
-timeColumnName null -schemaFile 
./pinot-distribution/target/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/sample_data/baseballStats_schema.json
 -readerConfigFile null -enableStarTreeIndex false -starTreeIndexSpecFile null 
-hllSize 9 [...]
+  Accepted files: [/Users/host1/Desktop/test/baseballStats_data.csv]
   Finished building StatsCollector!
   Collected stats for 97889 documents
   Created dictionary for INT column: homeRuns with cardinality: 67, range: 0 
to 73
@@ -84,9 +83,9 @@ For example, to create a pinot segment:
   Start building IndexCreator!
   Finished records indexing in IndexCreator!
   Finished segment seal!
-  Converting segment: /Users/jlli/Desktop/test2/baseballStats_data_0 to v3 
format
-  v3 segment location for segment: baseballStats_data_0 is 
/Users/jlli/Desktop/test2/baseballStats_data_0/v3
-  Deleting files in v1 segment directory: 
/Users/jlli/Desktop/test2/baseballStats_data_0
+  Converting segment: /Users/host1/Desktop/test2/baseballStats_data_0 to v3 
format
+  v3 segment location for segment: baseballStats_data_0 is 
/Users/host1/Desktop/test2/baseballStats_data_0/v3
+  Deleting files in v1 segment directory: 
/Users/host1/Desktop/test2/baseballStats_data_0
   Driver, record read time : 369
   Driver, stats collector time : 0
   Driver, indexing time : 373
@@ -95,5 +94,5 @@ To query a table:
 
 .. code-block:: none
 
-  $ 
./pinot-distribution/target/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/bin/pinot-admin.sh
 PostQuery -brokerPort 8000 -query "select count(*) from baseballStats" 
./pinot-distribution/target/apache-pinot-incubaExecuting command: PostQuery 
-brokerHost 172.25.118.138 -brokerPort 8000 -query select count(*) from 
baseballStats
+  $ 
./pinot-distribution/target/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/apache-pinot-incubating-0.1.0-SNAPSHOT-bin/bin/pinot-admin.sh
 PostQuery -query "select count(*) from baseballStats" 
./pinot-distribution/target/apache-pinot-incubaExecuting command: PostQuery 
-brokerHost [broker_host] -brokerPort [broker_port] -query select count(*) from 
baseballStats
   Result: 
{"aggregationResults":[{"function":"count_star","value":"97889"}],"exceptions":[],"numServersQueried":1,"numServersResponded":1,"numSegmentsQueried":1,"numSegmentsProcessed":1,"numSegmentsMatched":1,"numDocsScanned":97889,"numEntriesScannedInFilter":0,"numEntriesScannedPostFilter":0,"numGroupsLimitReached":false,"totalDocs":97889,"timeUsedMs":107,"segmentStatistics":[],"traceInfo":{}}


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@pinot.apache.org
For additional commands, e-mail: commits-h...@pinot.apache.org

Reply via email to